CPen::CPen

CPen( );

CPen ( int nPenStyle, int nWidth, COLORREF crColor );
lançar ( CResourceException );

CPen ( int nPenStyle, int nWidth, const LOGBRUSH * pLogBrush, int nStyleCount = 0, const DWORD * lpStyle = Nulo );
lançar ( CResourceException );

Parâmetros

nPenStyle

Especifica o estilo caneta. Este parâmetro na primeira versão do Construtor pode ser uma dos seguinte valores:

• PS_SOLID   Cria uma caneta sólida.
  
  
• PS_DASH   Cria uma caneta tracejada. Válido somente quando a largura caneta é 1 ou menos, no dispositivo unidades.
  
  
• PS_DOT   Cria uma caneta com pontos. Válido somente quando a largura caneta é 1 ou menos, no dispositivo unidades.
  
  
• PS_DASHDOT   Cria uma caneta com a alternância de traços e pontos. Válido somente quando a largura caneta é 1 ou menos, no dispositivo unidades.
  
  
• PS_DASHDOTDOT   Cria uma caneta com a alternância de traços e pontos duplos. Válido somente quando a largura caneta é 1 ou menos, no dispositivo unidades.
  
  
• PS_&NULLnbsp;  Cria uma caneta nula.
  
  
• PS_I&NSIDEFRAMEnbsp;  Cria uma caneta que desenha uma linha dentro do quadro de formas fechadas produzidas pelas funções de saída GDI do Windows que especificar um retângulo delimitador (por exemplo, a elipse, retângulo, RoundRect, pizzae funções de membro de corda ). Quando esse estilo é usado com funções de saída GDI do Windows que não especificam um Retangular delimitador (por exemplo, a função de membro LineTo ), a área de desenho da caneta não é limitada por um quadro.

  A segunda versão do Construtor CPen especifica uma combinação de tipo, estilo, tampa e atributos de junção. Os valores de cada categoria devem ser combinados usando o operador bit a bit ou (|). O tipo de caneta pode ser uma dos seguinte valores:

• PS_GEOMETRIC   Cria uma caneta geométrica.
  
  
• PS_COSMETIC   Cria uma caneta cosméticas.

  A segunda versão do Construtor CPen adiciona os seguintes estilos de caneta para nPenStyle:

• PS_ALTER&NATEnbsp;  Cria uma caneta que define todos os outros pixels. (Esse estilo é aplicável somente para canetas cosméticas).
  
  
• PS_USERSTYLE   Cria uma caneta que usa uma matriz estilos fornecido pelo usuário.

  A tampa pode ser uma dos seguinte valores:

• PS_E&NDCAP_ROUNDnbsp;  Caps final são redondos.
  
  
• PS_E&NDCAP_SQUAREnbsp;  Caps final são quadrados.
  
  
• PS_E&NDCAP_FLATnbsp;  Caps final são planas.

  A junção pode ser uma dos seguinte valores:

• PS_JOI&N_BEVELnbsp;  As associações são biseladas.
  
  
• PS_JOI&N_MITERnbsp;  As associações são mitered quando estão no limite atual estabelecido :: SetMiterLimit função. Se a junção exceder esse limite, ele é chanfrado.
  
  
• PS_JOI&N_ROUNDnbsp;  As associações são redondas.

nWidth

Especifica a largura da caneta.

• Para a primeira versão do Construtor, 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 Construtor, 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

Pontos to a 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

Se você usar o construtor sem argumentos, você deve inicializar o objeto de CPen resultante com as funções de membro CreatePen, CreatePenIndirectou CreateStockObject . Se você usar o Construtor que leva argumentos, nenhuma inicialização adicional é necessária. O Construtor com argumentos pode lançar uma exceção se forem encontrados erros, enquanto o construtor sem argumentos sempre funcionará.

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

Co&nsulte tambémnbsp;CPen::CreatePen, CPen::CreatePenIndirect, CGdiObject::CreateStockObject