2.2.8.5 Text Block

The text runs associated with a shape are rendered using a rectangular composition area called a text block. A text block specifies information related to the visual appearance of the text runs as a whole.

A text block uses a collection of Cell_Type elements contained under the ShapeSheet_Type element for a shape to specify position, transform, margin, alignment, direction, and background information for the text runs associated with the shape. A collection of Cell_Type elements that define how text is arranged in the composition area of a text block that is detailed in the following table.

Cell_Type element(s)

Description

TxtPinX, TxtPinY, TxtLocPinX, and TxtLocPinY

Specifies the text block coordinate system.

TxtAngle

Specifies the angle of counterclockwise rotation of the text block in the coordinate system of the shape it is associated with.

TxtWidth and TxtHeight

Specifies the width and height of the text block.

LeftMargin, RightMargin, TopMargin, and BottomMargin

Specifies the positioning of the text runs against the borders of the text block.

TextDirection

Specifies whether the text runs are rendered in an upright alignment with the top border of the text block or in an upright alignment with the right border of the text block within the text block coordinate system.

VerticalAlign

Specifies the vertical alignment of the text runs.

If the value of the TextDirection Cell_Type element structure is equal to zero, text runs are rendered starting from the top border, middle, or bottom border of the text block within the text block coordinate system. If the value of the TextDirection Cell_Type element structure is equal to one, text runs are rendered starting from the right border, center, or left border of the text block with the text block coordinate system.

TextBkgnd

Specifies the solid fill color property of the background of the text block.

TextBkgndTrans

Specifies the transparency level of the solid fill color property of the background of the text block.