`<group>` (Shape Group)

This element is used to collect shapes and groups so they can be positioned and transformed as a single unit. A group contains <group>, <shapetype>, <shape,> pre-defined shape - <arc>, <curve>, <image>, <line>, <oval>, <polyline>, <rect>, <roundrect> - and <lock> elements.

example:

<v:group id="saucer"
  style='position:relative;left:200;top:200;width:50;height:50'
  coordorigin="0,0" coordsize="6000,6000">
  <v:shape id="body"
    style='position:relative;left:234.75pt;top:208.875pt;
    width:235.25pt;height:128.875pt' coordsize="3765,2060"    path="m1285,251l1126,469,580,1009,,1285,25,1412,93,1547,194,1673,
    1017,2026,2312,2060,3209,1756,3765,1388,3278,680,3059,319,2976,,
    1285,251,1285,251xe"
    fillcolor="#bcbcd6" stroked="f">
    <v:path arrowok="t"/>
  </v:shape>
  <v:shape id="canopy"
    style='position:relative;left:314.625pt;top:140.5pt;
    width:104pt;height:102pt' coordsize="1663,1633"     path="m0,1355l177,1498,353,1582,840,1633,1378,1498,1663,1295,
    1545,456,1260,10,1025,,656,260,253,874,,1355,,1355xe"
    fillcolor="#99ebff" stroked="f">
    <v:path arrowok="t"/>
  </v:shape>
  <v:shape id="light1"
    style='position:relative;left:408.625pt;top:268.75pt;
    width:24.25pt;height:27.375pt' coordsize="388,437"
    path="m209,0l34,101,,302,125,437,329,327,388,152,209,,209,0xe"
    fillcolor="#fff27f" stroked="f">
    <v:path arrowok="t"/>
  </v:shape>
  <v:shape id="light2"
    style='position:relative;left:356.625pt;top:279.25pt;
    width:28.875pt;height:30pt' coordsize="462,479"
    path="m135,0l0,186,59,422,344,479,462,228,135,,135,0xe"
    fillcolor="#fff27f" stroked="f">
    <v:path arrowok="t"/>
  </v:shape>
  <v:shape id="light3"
    style='position:relative;left:302.625pt;top:274pt;
    width:23pt;height:23.625pt' coordsize="369,378"
    path="m0,59l226,,369,186,243,378,32,363,,59,,59xe"
    fillcolor="#fff27f" stroked="f">
    <v:path arrowok="t"/>
  </v:shape>
</v:group>

Parent Elements
`<background>` (§2.2.1); `<group>` (§6.1.2.7); `<object>` (§2.3.3.19); `<pict>` (§2.3.3.21); `<pict>` (§2.9.23)

Child Elements	Subclause
`<anchorlock>` (Anchor Location Is Locked)	§6.3.2.1
`<arc>` (Arc Segment)	§6.1.2.1
`<borderbottom>` (Bottom Border)	§6.3.2.2
`<borderleft>` (Left Border)	§6.3.2.3
`<borderright>` (Right Border)	§6.3.2.4
`<bordertop>` (Top Border)	§6.3.2.5
`<callout>` (Callout)	§6.2.2.2
`<ClientData>` (Attached Object Data)	§6.4.2.12
`<clippath>` (Shape Clipping Path)	§6.2.2.3
`<curve>` (Bezier Curve)	§6.1.2.3
`<diagram>` (VML Diagram)	§6.2.2.8
`<extrusion>` (3D Extrusion)	§6.2.2.10
`<fill>` (Shape Fill Properties)	§6.1.2.5
`<formulas>` (Set of Formulas)	§6.1.2.6
`<group>` (Shape Group)	§6.1.2.7
`<handles>` (Set of Handles)	§6.1.2.9
`<image>` (Image File)	§6.1.2.10
`<imagedata>` (Image Data)	§6.1.2.11
`<line>` (Line)	§6.1.2.12
`<lock>` (Shape Protections)	§6.2.2.17
`<oval>` (Oval)	§6.1.2.13
`<path>` (Shape Path)	§6.1.2.14
`<polyline>` (Multiple Path Line)	§6.1.2.15
`<rect>` (Rectangle)	§6.1.2.16
`<roundrect>` (Rounded Rectangle)	§6.1.2.17
`<shadow>` (Shadow Effect)	§6.1.2.18
`<shape>` (Shape Definition)	§6.1.2.19
`<shapetype>` (Shape Template)	§6.1.2.20
`<signatureline>` (Digital Signature Line)	§6.2.2.29
`<skew>` (Skew Transform)	§6.2.2.30
`<stroke>` (Line Stroke Settings)	§6.1.2.21
`<textbox>` (Text Box)	§6.1.2.22
`<textdata>` (VML Diagram Text)	§6.5.2.2
`<textpath>` (Text Layout Path)	§6.1.2.23
`<wrap>` (Text Wrapping)	§6.3.2.6

Attributes

Description

<allowincell> (Allow in Table Cell)

Namespace: urn:schemas-microsoft-com:office:office

Specifies whether a shape can be placed in a table. Default is false.

example:

<v:shape ... o:allowincell="true" ... >
</v:shape>

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

<allowoverlap> (Allow Shape Overlap)

Namespace: urn:schemas-microsoft-com:office:office

Specifies whether a shape can overlap another shape. Default is true. If false, the shape will shift left or right so as not to overlap another shape, similar to the behavior of the HTML float attribute.

example:

<v:shape ... o:allowoverlap="false" ... >
</v:shape>

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

<alt> (Alternate Text)

Specifies alternative text describing the graphical object. This text should provide a brief description of the shape for use by accessibility tools. Default is no value.

example:

<v:shape ... fillcolor="red" 
  alt="Red rectangle">
</v:shape>

The alt text describes the contents of a shape displaying an image:

<v:shape ... alt="Picture of a sunset">
</v:shape>

The possible values for this attribute are defined by the XML Schema string datatype.

<borderbottomcolor> (Bottom Border Color)

Namespace: urn:schemas-microsoft-com:office:office

Specifies the bottom border color of an inline shape. Default is no value.

example:

<v:shape ... o:borderbottomcolor="red" ... >
</v:shape>

The possible values for this attribute are defined by the XML Schema string datatype.

<borderleftcolor> (Border Left Color)

Namespace: urn:schemas-microsoft-com:office:office

Specifies the left border color of an inline shape. Default is no value.

example:

<v:shape ... o:borderleftcolor="red" ... >
</v:shape>

The possible values for this attribute are defined by the XML Schema string datatype.

<borderrightcolor> (Border Right Color)

Namespace: urn:schemas-microsoft-com:office:office

Specifies the right border color of an inline shape. Default is no value.

example:

<v:shape ... o:borderrightcolor="red" ... >
</v:shape>

The possible values for this attribute are defined by the XML Schema string datatype.

<bordertopcolor> (Border Top Color)

Namespace: urn:schemas-microsoft-com:office:office

Specifies the top border color of an inline shape. Default is no value.

example:

<v:shape ... o:bordertopcolor="red" ... >
</v:shape>

The possible values for this attribute are defined by the XML Schema string datatype.

<bullet> (Graphical Bullet)

Namespace: urn:schemas-microsoft-com:office:office

Specifies whether the shape is a graphical bullet. Default is false.

example:

<v:shape ... o:bullet="true" ... >
</v:shape>

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

<button> (Button Behavior Toggle)

Namespace: urn:schemas-microsoft-com:office:office

Specifies whether a shape will exhibit button press behavior on click. Default is false.

example:

<v:shape ... o:button="true" ... >
</v:shape>

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

<class> (CSS Reference)

Specifies a reference to the definition of a CSS style. Default is no value.

example:

...
.narrowstyle {width:50;height:100}
...
<v:shape ... class="narrowstyle"
  style="top:1;left:1">
</v:shape>

<v:shape ... style="top:1;left:1;
  width:50;height:100">
</v:shape>

The possible values for this attribute are defined by the XML Schema string datatype.

<coordorigin> (Coordinate Space Origin)

Specifies the coordinate of the top left corner of the shape's coordinate space. This determines the position of the (0,0) coordinate space origin within the shape's bounding box. Default is "0,0", which places the (0,0) origin at the top left corner of the bounding box.

This affects shape properties that specify coordinate positions, such as the @path attribute. Thus a path can be defined against a generic (0,0) origin and the @coordorigin value translates the entire path within the shape's bounding space.

example:

<v:shape ... coordsize="200,200"
  coordorigin="-100,-100"
  path="m 0,0 l 0,50, 50,50, 50,0 x e">
</v:shape>

The possible values for this attribute are defined by the XML Schema string datatype.

<coordsize> (Coordinate Space Size)

Specifies the size of the shape's coordinate space in coordinate units. Default is "1000,1000".

The physical size of a coordinate unit length is determined by both the size of the coordinate space (@coordsize) and the size of the shape (@style width and height). The @coordsize attribute defines the number of horizontal and vertical subdivisions into which the shape's bounding box is divided. The combination of @coordsize and @style width/height effective scales the shape anisotropically.

example:

<v:shape ... coordsize="200,200"
  coordorigin="-100,-100"
  path="m 0,0 l 0,50, 50,50, 50,0 x e">
</v:shape>

The possible values for this attribute are defined by the XML Schema string datatype.

<dgmlayout> (Diagram Node Layout Identifier)

Namespace: urn:schemas-microsoft-com:office:office

Specifies the type of automatic layout to apply to the diagram node. This is only meaningful for organization charts. Valid values for organization charts are:

Value	Description
0	Top-down, centered layout.
1	Hanging, both sides layout.
2	Hanging, right side layout.
3	Hanging, left side layout.

example:

<v:shape ... dgmlayout="1">
</v:shape>

The possible values for this attribute are defined by the XML Schema integer datatype.

<dgmlayoutmru> (Diagram Node Recent Layout Identifier)

Namespace: urn:schemas-microsoft-com:office:office

Specifies the type of automatic layout most recently used on the child elements of the diagram node. This is only meaningful for organization charts. Valid values for organization charts are:

Value	Description
0	Top-down, centered layout.
1	Hanging, both sides layout.
2	Hanging, right side layout.
3	Hanging, left side layout.

example:

<v:shape ... dgmlayout="1">
</v:shape>

The possible values for this attribute are defined by the XML Schema integer datatype.

<dgmnodekind> (Diagram Node Identifier)

Namespace: urn:schemas-microsoft-com:office:office

Specifies an optional, application-specific parameter that is intended to be used by the application to tag different types of nodes in a diagram.

example:

<v:shape ... dgmnodekind="1">
</v:shape>

The possible values for this attribute are defined by the XML Schema integer datatype.

<doubleclicknotify> (Double-click Notification Toggle)

Namespace: urn:schemas-microsoft-com:office:office

Specifies that an event message is sent when a shape is double-clicked. Default is false.

example:

<v:shape ... o:doubleclicknotify="true" ... >
</v:shape>

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

<editas> (Group Diagram Type)

Specifies which diagram type the contained shapes represent. This is used in conjunction with the <diagram> element (§6.2.2.8). A value of canvas indicates that the group is a regular group of shapes and does not represent a diagram. Other values indicate that the <diagram> element and its children contain semantic information relevant to that type of diagram, which is represented by the shapes in the group.

[Example:

<v:group ... editas="orgchart">
</v:group>

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

<fillcolor> (Fill Color)

Specifies the color to use for the fill. Default is white. If the <fill> element (§6.1.2.5) is present, its @color attribute takes precedence. Colors are typically specified as either a named color, such as red, or six hexadecimal digits representing the red, green and blue values of the color, such as #00FF30. Full details are specified in the simple type description.

example:

<v:shape ... fillcolor="red" ... >
</v:shape>

This is equivalent to:

<v:shape ... fillcolor="#ff0000" ... >
</v:shape>

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

<filled> (Shape Fill Toggle)

Specifies whether the closed path will be filled. Default is true. This attribute is overridden by the fill @on attribute.

example:

<v:shape ... filled="f" 
  fillcolor="red" ...>
</v:shape>

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

<hr> (Horizontal Rule Toggle)

Namespace: urn:schemas-microsoft-com:office:office

Specifies that a shape is a horizontal rule. Default is false.

example:

<v:shape ... o:hr="true" ... >
</v:shape>

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

<hralign> (Horizontal Rule Alignment)

Namespace: urn:schemas-microsoft-com:office:office

Specifies the alignment of a horizontal rule. Default is left.

example:

<v:shape ... o:hralign="center" ... >
</v:shape>

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

<href> (Hyperlink Target)

Specifies a hyperlink URL target for the shape. Default is no value.

example:

<v:shape ... href="http://www.openxmlformats.org" ... >
</v:shape>

The possible values for this attribute are defined by the XML Schema string datatype.

<hrnoshade> (Horizontal Rule 3D Shading Toggle)

Namespace: urn:schemas-microsoft-com:office:office

Specifies that the horizontal rule does not have 3-D shading. Default is false.

example:

<v:shape ... o:hrnoshade="true" ... >
</v:shape>

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

<hrpct> (Horizontal Rule Length Percentage)

Namespace: urn:schemas-microsoft-com:office:office

Specifies the length of a horizontal rule as a percentage of page width. Default is 0.

example:

<v:shape ... o:hrpct="85" ... >
</v:shape>

The possible values for this attribute are defined by the XML Schema float datatype.

<hrstd> (Horizontal Rule Standard Display Toggle)

Namespace: urn:schemas-microsoft-com:office:office

Specifies whether a shape is displayed as a standard horizontal rule. Only applies if @hr is true. Default is false.

example:

<v:shape ... o:hrstd="true" ... >
</v:shape>

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

<id> (Unique Identifier)

Specifies a unique identifier that can be used to reference a VML object.

Default is no value.

example:

<v:shape ... id="myShape" ... >
</v:shape>

The possible values for this attribute are defined by the XML Schema string datatype.

<insetmode> (Text Inset Mode)

Namespace: urn:schemas-microsoft-com:office:office

Specifies whether the application calculates the internal text margin instead of using the @inset attribute. Default is custom. This attribute is only meaningful for text boxes.

example:

<v:shape ... o:insetmode="auto" ... >
</v:shape>

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

<oned> (Shape Handle Toggle)

Namespace: urn:schemas-microsoft-com:office:office

Specifies whether the extra handles of a shape are hidden. If true, hides all shape handles except the top left and bottom right; that is, the same handles that are used for a straight line segment. Default is false.

example:

<v:shape ... o:oned="true" ... >
</v:shape>

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

<print> (Print Toggle)

Specifies whether the shape will be printed. Default is true.

example:

<v:shape ... print="false" ... >
</v:shape>

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

<regroupid> (Regroup ID)

Namespace: urn:schemas-microsoft-com:office:office

Specifies a previous group for a shape. An ID number is used to identify groups of shapes that are no longer grouped. This allows shapes to be regrouped programmatically.

example:

<v:shape ... o:regroupid="040754" ... >
</v:shape>

The possible values for this attribute are defined by the XML Schema integer datatype.

<spid> (Optional String)

Namespace: urn:schemas-microsoft-com:office:office

Specifies an optional string that an application may use to Identify the particular shape. Default is no value.

The possible values for this attribute are defined by the XML Schema string datatype.

<style> (Shape Styling Properties)

Specifies the CSS2 styling properties of the shape. This uses the syntax described in the "Visual formatting model" of the Cascading Style Sheets, Level 2 specification, a Recommendation of the World Wide Web Consortium available here: http://www.w3.org/TR/REC-CSS2. Full descriptions of each property are not repeated here, but the VML treatment of each property is defined. Allowed properties include:

Property	Description
flip	Specifies that the orientation of a shape is flipped. Default is no value. Allowed values are: `x` - Flip along the y-axis, reversing the x-coordinates. `y` - Flip along the x-axis, reversing the y-coordinates. `xy` - Flip along both the y- and x-axis. `yx` - Flip along both the x- and y-axis.
height	Specifies the height of the containing block of the shape. Default is 0. It is specified in CSS units or, for elements in a group, in the coordinate system of the parent element. Allowed values are: `auto` - Default position of an element in the flow of the page. <units>- A number with an absolute units designator (cm, mm, in, pt, pc, or px) or a relative units designator (em or ex). If no units are given, pixels (px) is assumed. <percentage>- Value expressed as a percentage of the parent object's height.
left	Specifies the position of the left of the containing block of the shape relative to the element left of it in the flow of the page. Default is 0. It is specified in CSS units or, for elements in a group, in the coordinate system of the parent element. This property shall not be used for shapes anchored inline. Allowed values are: `auto` - Default position of an element in the flow of the page. <units> - A number with an absolute units designator (cm, mm, in, pt, pc, or px) or a relative units designator (em or ex). If no units are given, pixels (px) is assumed. <percentage>- Value expressed as a percentage of the parent object's width.
margin-bottom	Specifies the position of the bottom of the containing block of the shape relative to the shape anchor. Default is 0. It is specified in CSS units or, for elements in a group, in the coordinate system of the parent element. Allowed values are: `auto` - Default position of an element in the flow of the page. <units>- A number with an absolute units designator (cm, mm, in, pt, pc, or px) or a relative units designator (em or ex). If no units are given, pixels (px) is assumed. <percentage>- Value expressed as a percentage of the parent object's height.
margin-left	Specifies the position of the left of the containing block of the shape relative to the shape anchor. Default is 0. It is specified in CSS units or, for elements in a group, in the coordinate system of the parent element. Allowed values are: `auto` - Default position of an element in the flow of the page. <units>- A number with an absolute units designator (cm, mm, in, pt, pc, or px) or a relative units designator (em or ex). If no units are given, pixels (px) is assumed. <percentage>- Value expressed as a percentage of the parent object's width.
margin-right	Specifies the position of the right of the containing block of the shape relative to the shape anchor. Default is 0. It is specified in CSS units or, for elements in a group, in the coordinate system of the parent element. Allowed values are: `auto` - Default position of an element in the flow of the page. <units> - A number with an absolute units designator (cm, mm, in, pt, pc, or px) or a relative units designator (em or ex). If no units are given, pixels (px) is assumed. <percentage>- Value expressed as a percentage of the parent object's width.
margin-top	Specifies the position of the top of the containing block of the shape relative to the shape anchor. Default is 0. It is specified in CSS units or, for elements in a group, in the coordinate system of the parent element. Allowed values are: `auto` - Default position of an element in the flow of the page. <units>- A number with an absolute units designator (cm, mm, in, pt, pc, or px) or a relative units designator (em or ex). If no units are given, pixels (px) is assumed. <percentage>- Value expressed as a percentage of the parent object's height.
mso-position-horizontal	Specifies the horizontal positioning data for objects in WordprocessingML documents. Default is `absolute`. Allowed values are: `absolute` `left` `center` `right` `inside` `outside`
mso-position-horizontal-relative	Specifies relative horizontal position data for objects in WordprocessingML documents. This modifies the `mso-position-horizontal` property. Default is `text`. Allowed values are: `margin` `page` `text` `char`
mso-position-vertical	Specifies the vertical positioning data for objects in WordprocessingML documents. Default is `absolute`. Allowed values are: `absolute` `top` `center` `bottom` `inside` `outside`
mso-position-vertical-relative	Specifies relative vertical position data for objects in WordprocessingML documents. This modifies the `mso-position-vertical` property. Default is `text`. Allowed values are: `margin` `page` `text` `line`
mso-wrap-distance-bottom	Specifies the distance from the bottom of the shape to the text that wraps around it. Default is 0 pt. Note that this property is different from the CSS `margin` property, which changes the origin of the shape to include the margin areas. This property does not change the origin.
mso-wrap-distance-left	Specifies the distance from the left side of the shape to the text that wraps around it. Default is 0 pt. Note that this property is different from the CSS `margin` property, which changes the origin of the shape to include the margin areas. This property does not change the origin.
mso-wrap-distance-right	Specifies the distance from the right side of the shape to the text that wraps around it. Default is 0 pt. Note that this property is different from the CSS `margin` property, which changes the origin of the shape to include the margin areas. This property does not change the origin.
mso-wrap-distance-top	Specifies the distance from the top of the shape to the text that wraps around it. Default is 0 pt. Note that this property is different from the CSS `margin` property, which changes the origin of the shape to include the margin areas. This property does not change the origin.
mso-wrap-edited	Specifies whether the wrap coordinates were customized by the user. If the wrap coordinates are generated by an editor, this property is `true`; otherwise they were customized by a user. Default is `false`.
mso-wrap-style	Specifies the wrapping mode for text in shapes in WordprocessingML documents. Default is `square`. Allowed values are: `square` - Wraps text inside the shape in a square. `none` - Text does not wrap.
position	Specifies the type of positioning used to place an element. Default is `static`. When the element is contained inside a group, this property must be `absolute`. Allowed values are: `static` - The element is positioned according to the normal flow of the page. The `top` and `left` properties are ignored. If the object is anchored inline, this value is used. `absolute` - The element is positioned relative to the parent, using the `top` and `left` properties. `relative` - The element is positioned according to the normal flow of the page, but the `top` and `left` properties are used. The overlap of overlapping elements is governed by the `z-index` property.
rotation	Specifies the angle that a shape is rotated, in degrees. Default is 0. Positive angles are clockwise.
top	Specifies the position of the top of the containing block of the shape relative to the element above it in the flow of the page. Default is 0. It is specified in CSS units or, for elements in a group, in the coordinate system of the parent element. This property shall not be used for shapes anchored inline. Allowed values are: `auto` - Default position of an element in the flow of the page. <units>- A number with an absolute units designator (cm, mm, in, pt, pc, or px) or a relative units designator (em or ex). If no units are given, pixels (px) is assumed. <percentage>- Value expressed as a percentage of the parent object's height.
visibility	Specifies whether a shape is displayed. Only `inherit` and `hidden` are used; any other values are mapped to `inherit`. Default is `inherit`. Allowed values are: `hidden` - The shape is not visible, but is still part of the flow of the objects in the browser. Mouse events are not processed. `inherit` - The visibility state is inherited from the parent of the shape.
width	Specifies the width of the containing block of the shape. Default is 0. It is specified in CSS units or, for elements in a group, in the coordinate system of the parent element. Allowed values are: `auto` - Default position of an element in the flow of the page. <units>- A number with an absolute units designator (cm, mm, in, pt, pc, or px) or a relative units designator (em or ex). If no units are given, pixels (px) is assumed. <percentage>- Value expressed as a percentage of the parent object's width.
z-index	Specifies the display order of overlapping shapes. Default is 0. This property shall not be used for shapes anchored inline. Allowed values are: `auto` - Uses the order that the shapes appear in the page, bottom to top. <order>- A number that represents the stacking precedence. Shapes with higher numbers are placed on top of those with lower numbers. Negative numbers are allowed.

The following properties are only used by the <textbox> element (§6.1.2.22):

Property	Description
direction	Specifies the direction of the text in the textbox. Default is `ltr`. This property is superceded by the `mso-direction-alt` property if that is specified. Allowed values are: `ltr` - Test is displayed left-to-right. `rtl` - Test is displayed right-to-left.
layout-flow	Determines the flow of the text layout in a textbox. Default is `horizontal`. Allowed values are: `horizontal` - Text is displayed horizontally. `vertical` - Text is displayed vertically. `vertical-ideographic` - Ideographic text is displayed vertically. `horizontal-ideographic` - Ideographic text is displayed horizontally.
mso-direction-alt	Specifies an alternate direction for text in textboxes. Overrides the `direction` property. The only allowed value is `context`.
mso-fit-shape-to-text	Specifies whether the shape stretches to fit the text in the textbox. Default is `false`.
mso-fit-text-to-shape	Specifies whether the text stretches to fit the textbox. Default is `false`.
mso-layout-flow-alt	Specifies the alternate layout flow for text in textboxes. This property is used instead of `layout-flow` when the layout flow is from bottom to top for non-ideographic languages. Its only value is `bottom-to-top`.
mso-next-textbox	Specifies the ID of the next textbox in a series. Used to keep track of a set of linked textboxes. Default is no value.
mso-rotate	Specifies a specific rotation value for text in a textbox. Default is 0. Allowed values are: 0 90 180 -90
mso-text-scale	Specifies the scaling factor for fitting text to shapes. Default is 0. This property is only used if `mso-fit-text-to-shape` is `true`.
v-text-anchor	Specifies the vertical anchoring of text in a textbox. Default is `top`. The alignment of a text anchor only becomes evident if `mso-fit-text-to-shape` is `false`. This property is different from the `vertical-align` CSS property, which is used for ideographic languages. Allowed values are: `top` `middle` `bottom` `top-center` `middle-center` `bottom-center` `top-baseline` `bottom-baseline` `top-center-baseline` `bottom-center-baseline`

The following properties are only used by the <textpath> element (§6.1.2.23):

Property

Description

font

Specifies a compound value of font settings. Default is no value. The values are the same as those of the CSS font property. The order of definitions in the string is: font-style, font-variant, font-weight, font-size, line-height, font-family.

font-family

Specifies the family of the font. Default is no value. The values are the same as those of the CSS font-family property.

font-size

Specifies the size of the font. Default is no value. The font size is defined in points. The values are the same as those of the CSS font-size property.

font-style

Specifies the amount of slant for a font. Default is normal. The values are the same as those of the CSS font-style property. Allowed values are:

normal
italic
oblique - Treated the same as italic.

font-variant

Specifies the variant style of a font. Default is normal. The values are the same as those of the CSS font-variant property. Allowed values are:

normal
small-caps

font-weight

Specifies the thickness of the letters of the font. Default is normal. The values are the same as those of the CSS font-weight property. Allowed values are:

Value

Description

normal

lighter

100

200

300

400

Treated as non-bold.

bold

bolder

500

600

700

800

900

Treated as bold.

mso-text-shadow

Specifies whether a shadow is applied to the text on a text path. Default is false.

text-decoration

Specifies the style of text decoration. Default is none. The values are the same as those of the CSS text-decoration property. Allowed values are:

none
underline
overline
line-through
blink

v-rotate-letters

Specifies whether the letters of the text are rotated counterclockwise by 90 degrees. Default is false.

v-same-letter-heights

Specifies whether all letters will be the same height regardless of initial case. If true, the lowercase letters are stretched to the height of the uppercase letters. Default is false.

v-text-align

Specifies the alignment of text. Default is left. Allowed values are:

left
right
center
justify
letter-justify - Distributes the extra space between the letters.
stretch-justify - Stretches the letters to fill in the space.

v-text-kern

Specifies whether kerning is turned on. Default is false.

v-text-reverse

Specifies whether the layout order of rows is reversed. Default is false. This is used for vertical text layout.

v-text-spacing-mode

Specifies the mode for letter spacing. Default is tightening. This property determines whether space will be removed between each letter (tightening) or added between each letter (tracking). The amount of letter spacing change is defined by the v-text-spacing property. Allowed values are:

tightening
tracking

v-text-spacing

Specifies the amount of spacing for text in 100ths of single line spacing. Default is 100.

The <line> (§6.1.2.12), <polyline> (§6.1.2.15) and <curve> (§6.1.2.3) elements ignore the following properties:

top
left
width
height

The following properties are not inherited by an element that references a <shapetype> element (§6.1.2.20) via the @id attribute:

flip
height
left
margin-left
margin-top
position
rotation
top
visibility
width
z-index

The possible values for this attribute are defined by the XML Schema string datatype.

<tablelimits> (Table Row Height Limits)

Namespace: urn:schemas-microsoft-com:office:office

Specifies a list of minimum height values for each row in a table. Default is no value.

Used by PresentationML for native tables. This attribute is only useful when the table is made up of shapes that are grouped. When text is added to table cells, the row height may increase. The @tablelimits attribute stores the original row height so that if text is deleted, the row height will not fall below the original value.

example:

<v:shape ... o:tablelimits="30pt 20pt" ... >
</v:shape>

The possible values for this attribute are defined by the XML Schema string datatype.

<tableproperties> (Table Properties)

Namespace: urn:schemas-microsoft-com:office:office

Specifies a bitmask, represented as an integer, that determines table properties. Only the first three bits of this integer are used. Default is 0.

Used by PresentationML for native tables. This attribute is only useful when the table is made up of shapes that are grouped. Allowed values are:

Bit	Description
1	Set if the group of shapes is a table.
2	Set if the shape is a placeholder.
3	Set if the table text is bi-directional.

example:

<v:shape ... o:tableproperties="3" ... >
</v:shape>

The possible values for this attribute are defined by the XML Schema string datatype.

<target> (Hyperlink Display Target)

Specifies a frame or window that a URL is displayed in. Default is no value. Allowed values are:

Value	Description
<targetname>	String containing the name of the frame or window in which to load the document.
_blank	Specifies that the linked document is loaded into a new blank window. This window is not named.
_media	Specifies that the linked document is loaded into the Media Bar. Available in Microsoft® Internet Explorer 6 or later.
_parent	Specifies that the linked document is loaded into the immediate parent of the document containing the link.
_search	Specifies that the linked document is loaded into the browser's search pane. Available in Microsoft Internet Explorer 5 or greater.
_self	Specifies that the linked document is loaded into the window in which the link was clicked (the active window).
_top	Specifies that the linked document is loaded into the topmost window.

example:

<v:shape ...
  href="http://www.openxmlformats.org" 
  target="_self" ... >
</v:shape>

The possible values for this attribute are defined by the XML Schema string datatype.

<title> (Shape Title)

Specifies the text displayed when the mouse pointer moves over the shape. Default is no value.

example:

<v:shape ... title="tooltip" ... >
</v:shape>

The possible values for this attribute are defined by the XML Schema string datatype.

<userdrawn> (Exists In Master Slide)

Namespace: urn:schemas-microsoft-com:office:office

Specifies whether the user has added the shape to a master slide. Default is false. Used by PresentationML.

example:

<v:shape ... o:userdrawn="true" ... >
</v:shape>

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

<userhidden> (Hide Script Anchors)

Namespace: urn:schemas-microsoft-com:office:office

Specifies whether a script anchor is hidden. Default is false. If true, script anchors stay hidden even if the shape is otherwise visible. A script anchor is the visual representation of a script that when displayed in an application.

example:

<v:shape ... o:userhidden="true" ... >
</v:shape>

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

<wrapcoords> (Shape Bounding Polygon)

Specifies the bounding polygon that surrounds a shape. This is specified using a comma-delimited list of x and y coordinates: "x1,y1,x2,y2,x3,y3,..." This is used when text is tightly wrapped around a shape. Default is no value until the @mso-wrap-mode @style attribute is set to tight or through.

example:

<v:shape ... 
  wrapcoords="0,0 0,200, 200,200, 200,0" ... >
</v:shape>

The possible values for this attribute are defined by the XML Schema string datatype.

The following XML Schema fragment defines the contents of this element:

<complexType name="CT_Group">
	<choice maxOccurs="unbounded">
	<group ref="EG_ShapeElements"/>
	<element ref="group"/>
	<element ref="shape"/>
	<element ref="shapetype"/>
	<element ref="arc"/>
	<element ref="curve"/>
	<element ref="image"/>
	<element ref="line"/>
	<element ref="oval"/>
	<element ref="polyline"/>
	<element ref="rect"/>
	<element ref="roundrect"/>
	<element ref="o:diagram"/>
	</choice>
	<attributeGroup ref="AG_AllCoreAttributes"/>
	<attributeGroup ref="AG_Fill"/>
	<attribute name="editas" type="ST_EditAs" use="optional"/>
	<attribute ref="o:tableproperties"/>
	<attribute ref="o:tablelimits"/>
</complexType>

<group> (Shape Group)

`<group>` (Shape Group)