DashStyle Attribute

Internet Development Index

Specifies the dot and dash pattern for a stroke. Read/write VgLineDashStyle.

Applies To

Stroke

Tag Syntax

<v:element dashstyle="expression">

Script Syntax

element.dashstyle="expression"

expression=element.dashstyle

Remarks

Values include:

Solid (default)
ShortDash
ShortDot
ShortDashDot
ShortDashDotDot
Dot
Dash
LongDash
DashDot
LongDashDot
LongDashDotDot

The DashStyle attribute allows the user to specify a custom-defined dash pattern. This is done using a series of numbers. Dash styles are defined in terms of the length of the dash (the drawn part of the stroke) and the length of the space between the dashes. The lengths are relative to the line width: a length of "1" is equal to the line width. The EndCap style is applied to each dash, the arrow style is not. The string first defines the length of the dash then the length of the space. This may be repeated to form complex dash styles. The string should always contain a pair of numbers; if it contains an odd number of numbers the last may be disregarded.

The following table lists some typical values and a description of the intended effect. "0" implies a dot that should be fourfold symmetrical (with round end caps it should be a circle). If the line end cap is "flat," a viewer should choose a built-in operating system dash where possible (in other words. something that is fast to draw.). The following table shows some examples.

DashStyle	Description
"2 2"	Short-dashes. Each dash and the space between is twice the width of the line.
"0 2"	Dots. Space between is twice the width of the line.
"2 2 0 2"	Short dash dot.
"2 2 0 2 0 2"	Short dash dot dot.
"1 2"	Dot. Each dash is the width of the line, while each space is twice the width of the line.
"4 2"	Dash. Each dash is four times the width of the line while each space is twice the width of the line.
"8 2"	Long dash.
"4 2 1 2"	Dash dot.
"8 2 1 2"	Long dash dot.
"8 2 1 2 1 2"	Long dash dot dot.

VML Standard Attribute

Example

The shape has a dash style of alternating dashes and dots.

   <v:shape id="rect01"
   strokecolor="red" fillcolor="red"
   style="top:20;left:20;width:30;height:30"
   path="m 1,1 l 1,200,200,200, 200,1 x e">
   <v:stroke dashstyle="dashdot"/>
   </v:shape>