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 = Nulo );

Valor de retorno

Nonzero, ou o identificador de uma caneta lógica, se bem-sucedida; caso contrário 0.

Parâmetros

nPenStyle

Especifica o estilo para a caneta. Para obter uma lista dos valores possíveis, consulte o parâmetro nPenStyle no Construtor CPen.

nWidth

Especifica a largura da caneta.

• Para a primeira versão do CreatePen, se esse valor for 0, a largura, em unidades de dispositivo é sempre 1 pixel, independentemente do modo de mapeamento.
  
  
• Para a segunda versão do CreatePen, se nPenStyle for PS_GEOMETRIC, a largura é dada em unidades lógicas. Se nPenStyle for PS_COSMETIC, a largura deve ser definida como 1.

crColor

Contém uma cor RGB para a caneta.

pLogBrush

Aponta para um estrutura LOGBRUSH . Se nPenStyle for PS_COSMETIC, o lbColor membro da estrutura de LOGBRUSH especifica a cor da caneta e a estrutura de LOGBRUSH o membro lbStyle deve ser definido como BS_SOLID. Se nPenStyle é PS_GEOMETRIC, todos os membros devem ser usados para especificar os atributos de pincel da caneta.

nStyleCount

Especifica o comprimento, em unidades de doubleword, da matriz lpStyle . Este valor deve ser zero se nPenStyle não é PS_USERSTYLE.

lpStyle

Aponta para uma matriz de valores doubleword. O primeiro valor especifica o comprimento do traço primeiro em um estilo definido pelo usuário, o segundo valor especifica o comprimento do primeiro espaço e assim por diante. Esse ponteiro deve ser NULL se nPenStyle não é PS_USERSTYLE.

Observações

A primeira versão do CreatePen Inicializa uma caneta com o estilo especificado, largura e cor. A caneta pode ser posteriormente selecionada como a caneta atual para qualquer contexto de dispositivo.

Canetas que tenham uma largura maior que 1 pixel devem sempre ter a PS_NULL, PS_SOLIDou PS_INSIDEFRAME estilo.

Se a caneta tiver o estilo PS_INSIDEFRAME e uma cor que não corresponde a uma cor na tabela de cores lógico, a caneta é desenhada com uma cor pontilhada. O estilo de caneta PS_SOLID não pode ser usado para criar uma caneta com uma cor pontilhada. O estilo de PS_INSIDEFRAME é idêntico ao PS_SOLID se a largura caneta é menor ou igual a 1.

A segunda versão do CreatePen Inicializa uma caneta cosmética ou geométrica lógica que tem o especificado, estilo, largura e atributos de pincel. A largura de uma caneta cosméticas é sempre 1; a largura de uma caneta geométrica é sempre especificada em unidades do mundo. Após um aplicativo cria uma caneta lógica, ele pode selecionar que caneta em um contexto dispositivo por chamado o CDC:: SelectObject função. Depois de uma caneta é selecionada em um contexto de dispositivo, ele pode ser usado para desenhar linhas e curvas.

• Se nPenStyle é PS_COSMETIC e PS_USERSTYLE, as entradas na lpStyle matriz especificar comprimentos dos traços e espaços em unidades de estilo. Uma unidade de estilo é definida pelo dispositivo em que a caneta é usada para desenhar uma linha.
  
  
• Se nPenStyle é PS_GEOMETRIC e PS_USERSTYLE, as entradas na lpStyle matriz especificar comprimentos dos traços e espaços em unidades lógicas.
  
  
• Se nPenStyle for PS_ALTERNATE, a unidade de estilo é ignorada e todos os outro pixel é definido.

Quando um aplicativo não requer mais uma caneta determinada, ele deve chamar a função de membro CGdiObject:: DeleteObject ou destruir o objeto CPen para que o recurso não está mais em uso. Um aplicativo não deve excluir uma caneta quando a caneta estiver selecionada em um contexto de dispositivo.

Visão geral de CPen |nbsp; Membros de classe | Gráfico de hierarquia

Co&nsulte tambémnbsp;CPen::CreatePenIndirect, CPen::CPen, CGdiObject:: DeleteObject, LOGBRUSH