typedef struct tagLOGPEN { /* lgpn */
UINT lopnStyle;
POINT lopnWidth;
COLORREF lopnColor;
} LOGPEN;
The LOGPEN structure defines the style, width, and color of a pen, a drawing object used to draw lines and borders. The CreatePenIndirect function uses the LOGPEN structure.
lopnStyle
Specifies the pen type. This member can be one of the following values:
Value | Meaning |
PS_SOLID | Creates a solid pen. |
PS_DASH | Creates a dashed pen. (Valid only when the pen width is 1.) |
PS_DOT | Creates a dotted pen. (Valid only when the pen width is 1.) |
PS_DASHDOT | Creates a pen with alternating dashes and dots. (Valid only when the pen width is 1.) |
PS_DASHDOTDOT | Creates a pen with alternating dashes and double dots. (Valid only when the pen width is 1.) |
PS_NULL | Creates a null pen. |
PS_INSIDEFRAME | Creates a pen that draws a line inside the frame of closed shapes produced by graphics device interface (GDI) output functions that specify a bounding rectangle (for example, the Ellipse, Rectangle, RoundRect, Pie, and Chord functions). When this style is used with GDI output functions that do not specify a bounding rectangle (for example, the LineTo function), the drawing area of the pen is not limited by a frame. |
If a pen has the PS_INSIDEFRAME style and a color that does not match a color in the logical color table, the pen is drawn with a dithered color. The PS_SOLID pen style cannot be used to create a pen with a dithered color. The PS_INSIDEFRAME style is identical to PS_SOLID if the pen width is less than or equal to 1.
When the PS_INSIDEFRAME style is used with GDI objects produced by functions other than Ellipse, Rectangle, and RoundRect, the line may not be completely inside the specified frame.
lopnWidth
Specifies the pen width, in logical units. If the lopnWidth member is zero, the pen is one pixel wide on raster devices regardless of the current mapping mode.
lopnColor
Specifies the pen color.
The y value in the POINT structure for the lopnWidth member is not used.