TabStop class

Office 2013 and later

Tab Stop. When the object is serialized out as xml, its qualified name is a:tab.

Namespace:  DocumentFormat.OpenXml.Drawing
Assembly:  DocumentFormat.OpenXml (in DocumentFormat.OpenXml.dll)

public class TabStop : OpenXmlLeafElement

[ISO/IEC 29500-1 1st Edition]

tab (Tab Stop)

This element specifies a single tab stop to be used on a line of text when there are one or more tab characters present within the text. When there is more than one present than they should be utilized in increasing position order which is specified via the pos attribute.

[Example: Consider the DrawingML shown below.

<p:txBody>
  …  <a:p>
    <a:pPr …>
      <a:tabLst>
        <a:tab pos="2292350" algn="l"/>
        <a:tab pos="2627313" algn="l"/>
        <a:tab pos="2743200" algn="l"/>
        <a:tab pos="2974975" algn="l"/>
      </a:tabLst>
    </a:pPr>
    …    <a:t>Sample Text</a:t>
    …  </a:p
>
  …</p:txBody>

The paragraph within which this <a:tab> information resides has a total of 4 unique tab stops that should be listed in order of increasing position. Along with specifying the tab position each tab allows for the specifying of an alignment. end example]

Parent Elements

tabLst (§21.1.2.2.14)

Attributes

Description

algn (Tab Alignment)

Specifies the alignment that is to be applied to text using this tab stop. If this attribute is omitted then the application default for the generating application.

The possible values for this attribute are defined by the ST_TextTabAlignType simple type (§20.1.10.80).

pos (Tab Position)

Specifies the position of the tab stop relative to the left margin. If this attribute is omitted then the application default for tab stops is used.

The possible values for this attribute are defined by the ST_Coordinate32 simple type (§20.1.10.17).

[Note: The W3C XML Schema definition of this element’s content model (CT_TextTabStop) is located in §A.4.1. end note]

© ISO/IEC29500: 2008.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Show: