OfficeOpenXML.com
 

DrawingML Shapes

Text - Alignment, Tabs, Other

Alignment

Alignment of text within a paragraph in a shape is specified with the algn attribute on the <a:pPr> element for the paragraph. The most common values are:

Below is a sample shape with alignment on the first paragraph set to justified (algn="just").

<a:pPr algn="just">
<a:spcAft>
<a:spcPts val="1200"/>
</a:spcAft>
</a:pPr>

Shape with text - alignment

Font Alignment

Vertical alignment of words on a line is specified with the fontAlgn attribute on the <a:pPr> element for the paragraph. This is relevant when some words on a line are larger than others. In such a case, should the smaller words be positioned in the middle relative to the larger words, at the bottom or top? Possible values are:

Below is a sample with font alignment at the top (fontAlgn="t").

<a:pPr fontAlgn="t"/>

Shape with text - font alignment

Tabs

Custom tab stops can be specified for a paragraph within a shape with the <a:tabLst> child element of <a:pPr>. The <a:tabLst> can contain one or more tab stop definitions, each within a <a:tab>. Each such <a:tab> has a pos attribute specifying the stop relative to the left margin (either in EMUs or by a number immediately followed by a unit identifer), with each tab in the order increasing its pos value. Each <a:tab> may also have a algn attribute which specifies the alignment of text. Possible values are ctr, dec (the decimals are lined up, so right-aligned until the decimal and then left aligned after the decimal), l and r.

The default tab size can also be specified with the defTabSz attribute on <a:pPr>. Possible values are specified either in EMUs or as a number immediately followed by a unit identifier. Below is a shape with tabs between text, and the default size is set to 1 inch or 914400 EMUs.

<a:pPr defTabSz="914400"/>

Shape with text - tabs

Below is the same shape, but with custom tabs as follows.

<a:pPr>
<a:tabLst>
<a:tab pos="914400" algn="l"/>
<a:tab pos="1371600" algn="l"/>
<a:tab pos="1600200" algn="l"/>
<a:tab pos="1714500" algn="l"/>
<a:tabLst>
</a:pPr>

Shape with text - tabs

Word Breaks

A long Latin word by default can be broken and wrapped onto the next line without a hyphen. However, it is possible to prevent this behavior by specifying the latinLnBrk attribute on <a:pPr>. A value of false or 0 will prevent a line break in such a case. Below is first a sample with latinLnBrk="1".

Shape with text - latin line break

Below is the same shape and same paragraph, but with latinLnBrk="0".

Shape with text - latin line break

Hanging Punctuation

It is possible to prevent punctuation at the end of a run from being carried onto the next line by specifying the hangingPunct attribute on <a:pPr>. A value of true or 1 forces the punctuation to not be carried over and a value of false allows the punctuation to be carried to the next line. The default is false.