LineStyleBvr Class

Creates an object that represents a linestyle behavior. The behavior defines the various line styles to use when drawing lines. These styles include the shape of the end of a line, the shape of joints between intersecting lines, the width of the line, and whether the line is drawn with a continuous stroke or as a sequence of dashes.

You use linestyle behaviors with the draw method of the Path2Bvr class.

For relevant fields from the Statics class, see Statics Fields Relevant to LineStyleBvr Objects.

LineStyleBvr Methods

color Determines the color of a LineStyleBvr object.

dash Creates a linestyle behavior that is the result of applying the given dashstyle behavior to the existing linestyle.

detail Creates a detail linestyle behavior from an existing linestyle.

end Creates a linestyle behavior that is the result of applying the given endstyle to the existing linestyle.

join Creates a linestyle behavior that is the result of applying the given joinstyle behavior to the existing linestyle.

lineAntialiasing Determines whether the line will be antialiased.

width Creates a linestyle behavior from an existing linestyle by setting the width of line to the given amount, expressed in points.

newUninitBvr Enables you to refer to a LineStyleBvr behavior before that behavior has been defined.

color

LineStyleBvr Class

Determines the color of a LineStyleBvr object. The default color is black.

Syntax

public LineStyleBvr color( ColorBvr color );

Parameters

color
ColorBvr object that sets the color of the line. The default color is black.

Return Value

Returns the LineStyleBvr object.

dash

LineStyleBvr Class

Creates a linestyle behavior that is the result of applying the given dashstyle behavior to the existing linestyle. By default, the dashstyle is solid.

Syntax

public LineStyleBvr dash( DashStyleBvr ds );

Parameters

ds
DashStyleBvr object that represents the dashstyle behavior to apply.

Return Value

Returns the LineStyleBvr object.

detail

LineStyleBvr Class

Creates a detail linestyle behavior from an existing linestyle. A detail linestyle is not changed by image scaling operations. By default, the detail linestyle is on. This means it is the default style and it has no width.

Syntax

public LineStyleBvr detail( );

Return Value

Returns the LineStyleBvr object.

Remarks

Any width or any endstyle or joinstyle behavior associated with the existing linestyle is discarded when creating the new line style.

end

LineStyleBvr Class

Creates a linestyle behavior that is the result of applying the given endstyle to the existing linestyle. By default, the endstyle is flat.

Syntax

public LineStyleBvr end( EndStyleBvr es );

Parameters

es
EndStyleBvr object that represents the endstyle behavior to apply.

Return Value

Returns the LineStyleBvr object.

join

LineStyleBvr Class

Creates a linestyle behavior that is the result of applying the given joinstyle behavior to the existing linestyle. By default, the joinstyle is beveled.

Syntax

public LineStyleBvr join( JoinStyleBvr js );

Parameters

js
JoinStyleBvr object that represents the joinstyle behavior to apply.

Return Value

Returns the LineStyleBvr object.

lineAntialiasing

LineStyleBvr Class

Determines whether the line will be antialiased.

Syntax

public LineStyleBvr lineAntialiasing( double antiAliasing );

Parameters

antiAliasing
A double value that specifies whether or not there will be antialiasing. A 0 (the default value) means there is no antialiasing and a 1 means there is.

Return Value

Returns the FontStyleBvr object.

width

LineStyleBvr Class

Creates a linestyle behavior from an existing linestyle by setting the width of line to the given amount, expressed in points. If the result is a line less than 1 pixel wide, the line will always be a detail line.

Syntax

public LineStyleBvr width( NumberBvr width );

Parameters

width
NumberBvr object that represents the width of the line, in points. This parameter can also be of type double.

Return Value

Returns the LineStyleBvr object.

Remarks

This attribute overrides detail.

newUninitBvr

LineStyleBvr Class

Enables you to refer to a LineStyleBvr behavior before that behavior has been defined. With this method you can create the behavior and use it in the definition of other behaviors, but not actually define its contents until some later point. (This is accomplished with the init method, which is available on all behaviors.) The system generates a run-time error if you initialize a non-uninitialized behavior, initialize an uninitialized behavior that has already been initialized, or run an initialized behavior that has not yet been initialized.

Syntax

public static LineStyleBvr newUninitBvr( );

Return Value

Returns the LineStyleBvr object.