[Table of Contents] [docx version]
VML Reference Material - VML
clippath (Shape Clipping Path)
This element specifies the path of the clipping polygon for the shape.
[Example:
<v:rect ... wrapcoords="-207 -433 -207 21925 21807 21925 21807 -433 -207 -433" o:clip="t" o:cliptowrap="t">
<o:clippath o:v="m-207,-433r,22358l21807,21925r,-22358l-207,-433xe"/>
</v:rect>
end example]
Parent Elements |
arc (§6.1.2.1); background (§2.2.1); curve (§6.1.2.3); group (§6.1.2.7); hdrShapeDefaults (§2.15.1.50); image (§6.1.2.10); line (§6.1.2.12); object (§2.3.3.19); oval (§6.1.2.13); pict (§2.3.3.21); pict (§2.9.23); polyline (§6.1.2.15); rect (§6.1.2.16); roundrect (§6.1.2.17); shape (§6.1.2.19); shapeDefaults (§2.15.1.79); shapetype (§6.1.2.20) |
Attributes |
Description | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
v (Path Definition) |
Specifies a string containing the commands that define the shape's path. This value consists of commands followed by zero or more parameters. Default is no value.
The following rules apply to path strings: • Commas or spaces delimit parameters for each command. Both "m 0,0" and "m0 0" are acceptable. • A parameter that is omitted using commas is treated as having a value of zero. Thus, "c 10,10,0,0,25,13" and "c 10,10,,,25,13" are equivalent. • Parameterized paths are also allowed. In this case, the shape must also have a formulas element (§6.1.2.6) with a list of formulas that are substituted into the path using the @ symbol followed by the number of the formula. The adj property of the shape contains the input parameters for these formulas. For example, "moveto @1@4". The evaluations of the formulas are substituted into the appropriate positions. Note that @ also serves as a delimiter.
The allowed commands are given below. An asterisk (*) indicates that the command is allowed to be repeated. For the qb command, the controlpoint parameter is also allowed to be repeated.
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_ClipPath">
<attribute name="v" type="xsd:string" use="required" form="qualified"/>
</complexType>