CPen::CPen

CPen( );

CPen ( int nPenStyle, int nWidth, COLORREF crColor );
tirar ( CResourceException );

CPen ( int nPenStyle, int nWidth, const LOGBRUSH * pLogBrush, int nStyleCount = 0, const DWORD * lpStyle = NULL );
tirar ( CResourceException );

Parámetros

nPenStyle

Especifica el estilo de pluma. Este parámetro en la primera versión del constructor puede ser uno de los siguientes valores:

• PS_SOLID   Crea una sólido pluma.
  
  
• PS_DASH   Crea una pluma discontinua. Válido sólo cuando el ancho del lápiz es 1 o menos, en dispositivo de unidades.
  
  
• PS_DOT   Crea una pluma puntos. Válido sólo cuando el ancho del lápiz es 1 o menos, en dispositivo de unidades.
  
  
• PS_DASHDOT   Crea una pluma con alternancia de guiones y puntos. Válido sólo cuando el ancho del lápiz es 1 o menos, en dispositivo de unidades.
  
  
• PS_DASHDOTDOT   Crea una pluma con alternancia de guiones y puntos dobles. Válido sólo cuando el ancho del lápiz es 1 o menos, en dispositivo de unidades.
  
  
• PS_&NULLnbsp;  Crea una pluma nula.
  
  
• PS_I&NSIDEFRAMEnbsp;  Crea un lápiz que dibuja una línea dentro del marco de formas cerradas producida por las funciones de salida de Windows GDI que especifican un rectángulo delimitador (por ejemplo, la elipse, rectángulo, RoundRect, circulary funciones de miembro de cuerda ). Cuando se utiliza este estilo con funciones de salida de GDI de Windows que no especifican un rectángulo delimitador (por ejemplo, la función de miembro de LineTo ), el área de dibujo del lápiz no está limitado por un marco.

  La segunda versión del constructor CPen especifica una combinación de tipo, estilo, tapa y combinación de atributos. Los valores de cada categoría deben combinarse utilizando el operador OR bit a bit (|). El tipo de plumilla puede ser uno de los siguientes valores:

• PS_GEOMETRIC   Crea una pluma geométrica.
  
  
• PS_COSMETIC   Crea una pluma cosmética.

  La segunda versión del constructor CPen agrega los siguientes estilos de pluma para nPenStyle:

• PS_ALTER&NATEnbsp;  Crea una pluma que establece cada píxel de otro. (Este estilo es aplicable sólo para lápices cosméticos).
  
  
• PS_USERSTYLE   Crea una pluma que utiliza una matriz de estilo proporcionada por el usuario.

  La tapa puede ser uno de los siguientes valores:

• PS_E&NDCAP_ROUNDnbsp;  Tapones son redondos.
  
  
• PS_E&NDCAP_SQUAREnbsp;  Tapones son cuadrados.
  
  
• PS_E&NDCAP_FLATnbsp;  Tapones son planas.

  La combinación puede ser uno de los siguientes valores:

• PS_JOI&N_BEVELnbsp;  Las combinaciones son biseladas.
  
  
• PS_JOI&N_MITERnbsp;  Las combinaciones son ángulo cuando están dentro del límite actual establecido por la :: SetMiterLimit función. Si la combinación supera este límite, se es biselado.
  
  
• PS_JOI&N_ROUNDnbsp;  Las combinaciones son redondas.

nWidth

Especifica el ancho del lápiz.

• Para la primera versión del constructor, si este valor es 0, el ancho en unidades de dispositivo siempre es 1 píxel, independientemente de la modalidad de asignación.
  
  
• Para la segunda versión del constructor, si nPenStyle es PS_GEOMETRIC, el ancho se da en unidades lógicas. Si nPenStyle es PS_COSMETIC, el ancho debe establecerse en 1.

crColor

Contiene un color RGB de la pluma.

pLogBrush

Apunta a una estructura LOGBRUSH . Si nPenStyle es PS_COSMETIC, el miembro lbColor de la estructura LOGBRUSH especifica el color de la pluma y el miembro lbStyle de la estructura LOGBRUSH debe establecerse en BS_SOLID. Si nPenStyle es PS_GEOMETRIC, todos los miembros deben utilizarse para especificar los atributos de pincel de la pluma.

nStyleCount

Especifica la longitud en unidades de doble-palabra, de la matriz de lpStyle . Este valor debe ser cero si nPenStyle no es PS_USERSTYLE.

lpStyle

Puntos en una matriz de valores doble-palabra. El primer valor especifica la longitud de la primer guión en un estilo definido por el usuario, el segundo valor especifica la longitud del primer espacio y así sucesivamente. Este puntero debe ser NULL si nPenStyle no es PS_USERSTYLE.

Observaciones

Si se utiliza el constructor sin argumentos, debe inicializar el objeto CPen resultante con las funciones de miembro de CreatePen, CreatePenIndirecto CreateStockObject . Si se utiliza el constructor que toma argumentos, ninguna inicialización adicional es necesario. El constructor con argumentos puede producir una excepción si se encuentran errores, mientras que el constructor sin argumentos siempre tendrá éxito.

Visión General de CPen |nbsp; Miembros de clase | Diagrama de jerarquía

Vea tambié&nnbsp;CPen::CreatePen, CPen::CreatePenIndirect, CGdiObject::CreateStockObject