Package org.apache.poi.ddf

Class EscherSpgrRecord

java.lang.Object

org.apache.poi.ddf.EscherRecord

org.apache.poi.ddf.EscherSpgrRecord

All Implemented Interfaces:

Duplicatable, GenericRecord

public class EscherSpgrRecord
extends EscherRecord

The spgr record defines information about a shape group. Groups in escher are simply another form of shape that you can't physically see.

Field Summary

Fields

Modifier and Type	Field	Description
static short	RECORD_ID

Constructor Summary

Constructors

Constructor	Description
EscherSpgrRecord()
EscherSpgrRecord(EscherSpgrRecord other)

Method Summary

Modifier and Type	Method	Description
EscherSpgrRecord	copy()
int	fillFields(byte[] data, int offset, EscherRecordFactory recordFactory)	The contract of this method is to deserialize an escher record including its children.
Map<String,Supplier<?>>	getGenericProperties()
Enum	getGenericRecordType()
short	getRecordId()	Return the current record id.
String	getRecordName()	Subclasses should return the short name for this escher record.
int	getRecordSize()	Subclasses should effeciently return the number of bytes required to serialize the record.
int	getRectX1()	The starting top-left coordinate of child records.
int	getRectX2()	The bottom-right x coordinate of child records.
int	getRectY1()	The top-left coordinate of child records.
int	getRectY2()	The bottom-right y coordinate of child records.
int	serialize(int offset, byte[] data, EscherSerializationListener listener)	Serializes the record to an existing byte array.
void	setRectX1(int x1)	The top-left coordinate of child records.
void	setRectX2(int x2)	The bottom-right x coordinate of child records.
void	setRectY1(int y1)	The top-left y coordinate of child records.
void	setRectY2(int rectY2)	The bottom-right y coordinate of child records.

Methods inherited from class org.apache.poi.ddf.EscherRecord

display, fillFields, getChild, getChildRecords, getGenericChildren, getInstance, getOptions, getVersion, isContainerRecord, readHeader, readInstance, serialize, serialize, setChildRecords, setInstance, setOptions, setRecordId, setVersion, toString, toXml, toXml

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

RECORD_ID

public static final short RECORD_ID

Constructor Detail

EscherSpgrRecord

public EscherSpgrRecord()

EscherSpgrRecord

public EscherSpgrRecord(EscherSpgrRecord other)

Method Detail

fillFields

public int fillFields(byte[] data,
                      int offset,
                      EscherRecordFactory recordFactory)

Description copied from class: EscherRecord

The contract of this method is to deserialize an escher record including its children.

Specified by:

fillFields in class EscherRecord

Parameters:

data - The byte array containing the serialized escher records.

offset - The offset into the byte array.

recordFactory - A factory for creating new escher records.

Returns:

The number of bytes written.

serialize

public int serialize(int offset,
                     byte[] data,
                     EscherSerializationListener listener)

Description copied from class: EscherRecord

Serializes the record to an existing byte array.

Specified by:

serialize in class EscherRecord

Parameters:

offset - the offset within the byte array

data - the data array to serialize to

listener - a listener for begin and end serialization events. This is useful because the serialization is hierarchical/recursive and sometimes you need to be able break into that.

Returns:

the number of bytes written.

getRecordSize

public int getRecordSize()

Description copied from class: EscherRecord

Subclasses should effeciently return the number of bytes required to serialize the record.

Specified by:

getRecordSize in class EscherRecord

Returns:

number of bytes

getRecordId

public short getRecordId()

Description copied from class: EscherRecord

Return the current record id.

Overrides:

getRecordId in class EscherRecord

Returns:

The 16 bit record id.

getRecordName

public String getRecordName()

Description copied from class: EscherRecord

Subclasses should return the short name for this escher record.

Specified by:

getRecordName in class EscherRecord

Returns:

the short name for this escher record

getRectX1

public int getRectX1()

The starting top-left coordinate of child records.

Returns:

the top-left x coordinate

setRectX1

public void setRectX1(int x1)

The top-left coordinate of child records.

Parameters:

x1 - the top-left x coordinate

getRectY1

public int getRectY1()

The top-left coordinate of child records.

Returns:

the top-left y coordinate

setRectY1

public void setRectY1(int y1)

The top-left y coordinate of child records.

Parameters:

y1 - the top-left y coordinate

getRectX2

public int getRectX2()

The bottom-right x coordinate of child records.

Returns:

the bottom-right x coordinate

setRectX2

public void setRectX2(int x2)

The bottom-right x coordinate of child records.

Parameters:

x2 - the bottom-right x coordinate

getRectY2

public int getRectY2()

The bottom-right y coordinate of child records.

Returns:

the bottom-right y coordinate

setRectY2

public void setRectY2(int rectY2)

The bottom-right y coordinate of child records.

Parameters:

rectY2 - the bottom-right y coordinate

getGenericProperties

public Map<String,Supplier<?>> getGenericProperties()

Specified by:

getGenericProperties in interface GenericRecord

Overrides:

getGenericProperties in class EscherRecord

getGenericRecordType

public Enum getGenericRecordType()

copy

public EscherSpgrRecord copy()

Specified by:

copy in interface Duplicatable

Specified by:

copy in class EscherRecord

Returns:

a deep copy of the implementing class / instance