Description
Sets the compound array for this
Pen
object.
Syntax
GpStatus WINGDIPAPI GdipSetPenCompoundArray(
GpPen *pen,
GDIPCONST REAL
*dash,
INT count
);
PowerBASIC Syntax
DECLARE FUNCTION GdipSetPenCompoundArray ( _
BYVAL pen AS
DWORD, _
BYREF dash AS
SINGLE, _
BYVAL count AS
LONG _
) AS LONG
Parameters
pen
[in] Pointer to the
Pen
object.
dash
[in] Pointer to an array of real numbers that
specifies the compound array. The elements in the array must be in
increasing order, not less than 0, and not greater than 1.
count
[in]
Positive even integer that specifies the number of elements in the dash array.
The integer must not be greater than the number of elements in the compound
array.
Remarks
Suppose
you want a pen to draw two parallel lines where the width
of the first line is 20 percent of the pen's width, the
width of the space that separates the two lines is 50
percent of the pen' s width, and the width of the second
line is 30 percent of the pen's width. Start by creating
a Pen object
and an array of real numbers. You can then set the compound array by passing
the array with the values 0.0, 0.2, 0.7, and 1.0 to the GdipSetCompoundArray function.
If
you set the alignment of a Pen object to PenAlignmentInset ,
you cannot use that pen to draw compound lines.
|