Package org.apache.poi.hssf.record
Class DConRefRecord
java.lang.Object
org.apache.poi.hssf.record.RecordBase
org.apache.poi.hssf.record.Record
org.apache.poi.hssf.record.StandardRecord
org.apache.poi.hssf.record.DConRefRecord
DConRef records specify a range in a workbook (internal or external) that serves as a data source
for pivot tables or data consolidation.
Represents a
DConRef Structure
[MS-XLS s.
2.4.86], and the contained DConFile structure
[MS-XLS s. 2.5.69]. This in turn contains a XLUnicodeStringNoCch
[MS-XLS s. 2.5.296].
_______________________________
| DConRef |
(bytes) +-+-+-+-+-+-+-+-+-+-+...+-+-+-+-+
| ref |cch| stFile | un|
+-+-+-+-+-+-+-+-+-+-+...+-+-+-+-+
|
_________|_____________________
|DConFile / XLUnicodeStringNoCch|
+-+-+-+-+-+-+-+-+-+-+-+...+-+-+-+
(bits) |h| reserved | rgb |
+-+-+-+-+-+-+-+-+-+-+-+...+-+-+-+
Where
DConFile.h = 0x00if the characters inrgbare single byte, andDConFile.h = 0x01if they are double byte.If they are double byte, then
- If it exists, the length of
DConRef.un = 2. Otherwise it is 1. - The length of
DConFile.rgb = (2 * DConRef.cch). Otherwise it is equal toDConRef.cch.
- If it exists, the length of
DConRef.rgbstarts with0x01if it is an external reference, and with0x02if it is a self-reference.
-
Field Summary
Fields -
Constructor Summary
ConstructorsConstructorDescriptionDConRefRecord(byte[] data) Read constructor.DConRefRecord(RecordInputStream inStream) Read Constructor. -
Method Summary
Modifier and TypeMethodDescriptionprotected intintintintintbyte[]getPath()shortgetSid()return the non static version of the id for this record.booleanChecks if the data source in this reference record is external to this sheet or internal.protected voidWrite the data content of this BIFF record.toString()get a string representation of the record (for biffview/debugging)Methods inherited from class org.apache.poi.hssf.record.StandardRecord
getRecordSize, serializeMethods inherited from class org.apache.poi.hssf.record.Record
clone, cloneViaReserialise, serialize
-
Field Details
-
sid
public static final short sidThe id of the record type,sid = 81- See Also:
-
-
Constructor Details
-
DConRefRecord
public DConRefRecord(byte[] data) Read constructor.- Parameters:
data- byte array containing a DConRef Record, including the header.
-
DConRefRecord
Read Constructor.- Parameters:
inStream- RecordInputStream containing a DConRefRecord structure.
-
-
Method Details
-
getDataSize
protected int getDataSize()- Specified by:
getDataSizein classStandardRecord
-
serialize
Description copied from class:StandardRecordWrite the data content of this BIFF record. The 'ushort sid' and 'ushort size' header fields have already been written by the superclass.The number of bytes written must equal the record size reported by
RecordBase.getRecordSize()} minus four ( record header consisting of a 'ushort sid' and 'ushort reclength' has already been written by their superclass).- Specified by:
serializein classStandardRecord- Parameters:
out- the output object
-
getSid
public short getSid()Description copied from class:Recordreturn the non static version of the id for this record. -
getFirstColumn
public int getFirstColumn()- Returns:
- The first column of the range.
-
getFirstRow
public int getFirstRow()- Returns:
- The first row of the range.
-
getLastColumn
public int getLastColumn()- Returns:
- The last column of the range.
-
getLastRow
public int getLastRow()- Returns:
- The last row of the range.
-
toString
Description copied from class:Recordget a string representation of the record (for biffview/debugging) -
getPath
public byte[] getPath()- Returns:
- raw path byte array.
-
getReadablePath
- Returns:
- the link's path, with the special characters stripped/replaced. May be null. See MS-XLS 2.5.277 (VirtualPath)
-
isExternalRef
public boolean isExternalRef()Checks if the data source in this reference record is external to this sheet or internal.- Returns:
- true iff this is an external reference.
-