2.9.106 FTXBXS

The FTXBXS structure is used by PlcftxbxTxt and by PlcfHdrtxbxTxt to associate ranges of text from the Textboxes Document and the Header Textboxes Document, respectively, with shape objects. In addition to the actual textboxes, there are 1 or more extra FTXBXS structures that can be reused by the application when creating new actual textboxes. The last FTXBXS in the PLC MUST be a reusable structure rather than an actual textbox. Additional reusable FTXBXS structures can occur at any index in the PLC.


0


1


2


3


4


5


6


7


8


9

1
0


1


2


3


4


5


6


7


8


9

2
0


1


2


3


4


5


6


7


8


9

3
0


1

ftxbxsunion

...

fReusable

itxbxsDest

...

lid

...

txidUndo

...

ftxbxsunion (8 bytes): If fReusable is "true", ftxbxsunion is an FTXBXSReusable structure. Also, if this is the last FTXBXS structure in the PLC, ftxbxsunion is an FTXBXSReusable structure, regardless of the fReusable flag. Otherwise, ftxbxsunion is an FTXBXNonReusable structure.

fReusable (2 bytes): An integer that specifies whether this structure describes an actual textbox or an extra structure that is available for reuse by the application. fReusable MUST be either zero ("false"), or it MUST have the 0x0001 bit set. When nonzero ("true"), bits other than 0x0001 MUST be ignored.

When fReusable is zero, this FTXBXS structure describes an actual textbox. The bounding CPs in PlcftxbxTxt or PlcfHdrtxbxTxt MUST be more than one character position apart, except when this is the last FTXBXS structure in the PLC. In that case there is no restriction on the character range specified by the bounding CPs in PlcftxbxTxt or PlcfHdrtxbxTxt. Text within this CP range MUST be ignored.

When fReusable is nonzero, this FTXBXS structure describes a reusable spare textbox structure. The bounding CPs in PlcftxbxTxt or PlcfHdrtxbxTxt MUST be one character position apart. When this is the last FTXBXS structure in the PLC, fReusable MUST be ignored and treated as if it were set to 0x0001 for the purposes of ftxbxsunion and lid.

itxbxsDest (4 bytes): This field MUST be ignored.

lid (4 bytes): An integer that specifies which shape object the textbox text begins in. When fReusable is "true", lid MUST be zero and MUST be ignored.

When fReusable is "false", lid MUST match the OfficeArtFSP.spid shape identifier in an OfficeArtSpContainer structure as specified by [MS-ODRAW] section 2.2.14. Furthermore, the MSOPSText_lTxid property of the OfficeArtSpContainer, as specified in [MS-ODRAW] section 2.3.21.1, MUST be a 4-byte integer where the high 2 bytes divided by 0x10000 gives the 1-based index of this FTXBXS structure in its PLC, and where the low 2 bytes are 0x0000.

txidUndo (4 bytes): This value MUST be 0 and MUST be ignored.