LOGPEN


typedef struct tagLOGPEN {
    unsigned short int  lopnStyle;
    POINT lopnWidth;
    unsigned long int  lopnColor;
    unsigned short int  lopnStyle2;
    unsigned long int  lopnhcmXform;
} LOGPEN;

Specifies a logical pen. Pens draw lines and borders.

lopnStyle

Pen style. GDI requires that drivers support at least the following pen styles:

Value

Meaning

LS_SOLID (0)

Draws solid lines.

LS_DASHED (1)

Draws dashed lines.

LS_DOTTED (2)

Draws dotted lines.

LS_DOTDASHED (3)

Draws lines with alternating dots and dashes.

LS_DASHDOTDOT (4)

Draws lines with a repeating pattern of a dash followed by two dots.

LS_NOLINE (5)

Nothing is drawn.

LS_INSIDEFRAME (6)

Creates a pen with which a line is drawn inside the frame of ellipses and rectangles. If the width of the pen is greater than 1 and the pen style is PS_INSIDEFRAME, the line is drawn inside the frame of all primitives except polygons and polylines; the pen is drawn with a logical (dithered) color if the pen color does not match an available RGB value. The PS_INSIDEFRAME style is identical to PS_SOLID if the pen width is less than or equal to 1.


lopnWidth

A POINT structure with an x member that contains the pen width in device units. A zero-width pen is drawn with the system's smallest width. Negative-width pens have no width and are NULL pens. The y member is ignored.

lopnColor

Color for the pen. Pen colors are specified as physical colors. For palette-capable devices, the value is a color index if the high byte is 0x0FFH.

lopnStyle2

Alternate pen style. May be one of the following:

Value

Meaning

LS_ENDCAP_FLAT (0x01)

End caps are flat.

LS_ENDCAP_ROUND (0x02)

End caps are round.

LS_ENDCAP_SQUARE (0x04)

End caps are square.

LS_JOIN_BEVEL (0x08)

Joins are beveled.

LS_JOIN_MITER (0x10)

Joins are mitered when they are within the current limit that the application set by the SetMiterLimit function. If it exceeds this limit, the join is beveled.

LS_JOIN_ROUND (0x20)

Joins are round.


lopnhcmXform

Transformation for image color matching.

See also EnumObj, POINT