LOGPEN

This structure defines the style, width, and color of a pen. The CreatePenIndirect function uses the LOGPEN structure.

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 POINT structure that contains the pen width, in logical units. If the pointer member is NULL, the pen is one pixel wide on raster devices. The y ** member in the POINT structure for lopnWidth is not used.

• lopnColor
  Specifies the pen color.

Remarks

Windows CE does not support the following values for the lopnStyle member:

• 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

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

CreatePenIndirect, POINT, RGB

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.