CPen::CreatePen

BOOL CreatePen ( int nPenStyle, int nWidth, COLORREF crColor );

BOOL CreatePen ( int nPenStyle, int nWidth, const LOGBRUSH * pLogBrush, int nStyleCount = 0, const DWORD * lpStyle = NULL );

Valor devuelto

NonZero o el mango de una pluma lógica, si es correcto; caso contrario 0.

Parámetros

nPenStyle

Especifica el estilo de la pluma. Para obtener una lista de valores posibles, consulte el parámetro nPenStyle en el constructor de CPen.

nWidth

Especifica el ancho del lápiz.

• Para la primera versión de CreatePen, 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 CreatePen, 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 un LOGBRUSH estructura. 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

La primera versión de CreatePen Inicializa una pluma con el estilo especificado, el ancho y el color. La pluma puede ser seleccionada posteriormente como la pluma actual para cualquier contexto de dispositivo.

Lápices que tengan un ancho superior a 1 píxel siempre deben tener estilo de la PS_NULL, PS_SOLIDo PS_INSIDEFRAME.

Si una pluma tiene el estilo PS_INSIDEFRAME y un color que no coincida con un color en la tabla de colores lógica, la plumilla se dibuja con un color interpolado. El estilo de pluma PS_SOLID no puede utilizarse para crear una pluma con un color interpolado. El estilo PS_INSIDEFRAME es idéntico a PS_SOLID si la anchura del lápiz es menor o igual a 1.

La segunda versión del CreatePen Inicializa una lógica pluma cosmética o geométrica que tiene el estilo, ancho y atributos de pincel. El ancho de un lápiz cosmético es siempre 1; el ancho de una pluma geométrica siempre se especifica en unidades de mundo. Después de una aplicación crea una pluma lógica, puede seleccionar ese lápiz en un contexto de dispositivo llamando a la CDC::SelectObject función. Después de selecciona una pluma en un contexto de dispositivo, puede utilizarse para dibujar líneas y curvas.

• Si nPenStyle es PS_COSMETIC y PS_USERSTYLE, las entradas de la matriz lpStyle especifican longitudes de guiones y espacios en unidades de estilo. Una unidad de estilo se define por el dispositivo en el que se utiliza el lápiz para dibujar una línea.
  
  
• Si nPenStyle es PS_GEOMETRIC y PS_USERSTYLE, las entradas de la matriz lpStyle especifican longitudes de guiones y espacios en unidades lógicas.
  
  
• Si nPenStyle es PS_ALTERNATE, se omite la unidad de estilo y se establece cada otros píxeles.

Cuando una aplicación ya no requiere un lápiz determinado, debe llamar a la función de miembro de CGdiObject::DeleteObject o destruir el objeto CPen el recurso ya no está en uso. Una aplicación no debe eliminar una pluma cuando el lápiz está seleccionado en un contexto de dispositivo.

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

Vea tambié&nnbsp;CPen::CreatePenIndirect, CPen::CPen, CGdiObject::DeleteObject, LOGBRUSH