 Important: |
|---|
| This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
This structure defines the style, width, and color of a pen. The CreatePenIndirectfunction uses the LOGPENstructure.
typedef
struct
tagLOGPEN
{
UINT
lopnStyle
;
POINT
lopnWidth
;
COLORREF
lopnColor
;
}
LOGPEN;
Members
- lopnStyle
- Specifies the pen style, which is one of the following values.
Value Description PS_SOLID Pen is solid. PS_DASH Pen is dashed. PS_DOT Pen is dotted. PS_DASHDOT Pen has alternating dashes and dots. PS_DASHDOTDOT Pen has dashes and double dots. PS_NULL Pen is invisible. PS_INSIDEFRAME Pen is solid. When this pen is used in any graphics device interface (GDI) drawing function that takes a bounding rectangle, the dimensions of the figure are shrunk so that it fits entirely in the bounding rectangle, taking into account the width of the pen. This applies only to geometric pens. - lopnWidth
- Specifies the POINTstructure that contains the pen width, in logical units. If the pointermember is NULL, the pen is one pixel wide on raster devices. The y member in the POINTstructure for lopnWidthis not used.
- lopnColor
- Specifies the pen color.
Remarks
Windows CE does not support the following values for the lopnStylemember:
- PS_DOT
- PS_DASHDOT
- PS_DASHDOTDOT
- PS_INSIDEFRAME
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 GDI objects except polygons and polylines. If the pen color does not match an available red, green, blue (RGB) value, the pen is drawn with a logical (dithered) color. If the pen width is less than or equal to 1, the PS_INSIDEFRAME style is identical to the PS_SOLID style.
Requirements
Runs on Versions Defined in Include Link to Windows CE OS 1.0 and later Wingdi.h Note This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.
See Also