Estrutura EXTLOGPEN (wingdi.h)

A estrutura EXTLOGPEN define os atributos de estilo, largura e pincel da caneta para uma caneta estendida. Essa estrutura é usada pela função GetObject quando recupera uma descrição de uma caneta que foi criada quando um aplicativo chamou a função ExtCreatePen .

Sintaxe

typedef struct tagEXTLOGPEN {
  DWORD     elpPenStyle;
  DWORD     elpWidth;
  UINT      elpBrushStyle;
  COLORREF  elpColor;
  ULONG_PTR elpHatch;
  DWORD     elpNumEntries;
  DWORD     elpStyleEntry[1];
} EXTLOGPEN, *PEXTLOGPEN, *NPEXTLOGPEN, *LPEXTLOGPEN;

Membros

elpPenStyle

Uma combinação de tipo de caneta, estilo, estilo de tampa final e estilo de junção. Os valores de cada categoria podem ser recuperados usando um operador AND bit a bit com a máscara apropriada.

O membro elpPenStyle mascarado com PS_TYPE_MASK tem um dos seguintes valores de tipo de caneta.

O membro elpPenStyle mascarado com PS_STYLE_MASK tem um dos seguintes valores de estilos de caneta:

A categoria a seguir aplica-se somente a canetas PS_GEOMETRIC. O membro elpPenStyle mascarado com PS_ENDCAP_MASK tem um dos seguintes valores de limite final.

A categoria a seguir aplica-se somente a canetas PS_GEOMETRIC. O membro elpPenStyle mascarado com PS_JOIN_MASK tem um dos seguintes valores de junção.

elpWidth

A largura da caneta. Se o membro elpPenStyle for PS_GEOMETRIC, esse valor será a largura da linha em unidades lógicas. Caso contrário, as linhas são cosméticas e esse valor é 1, o que indica uma linha com uma largura de um pixel.

elpBrushStyle

O estilo de pincel da caneta. O valor do membro elpBrushStyle pode ser um dos seguintes.

elpColor

Se elpBrushStyle for BS_SOLID ou BS_HATCHED, elpColor especificará a cor na qual a caneta deve ser desenhada. Para BS_HATCHED, as funções SetBkMode e SetBkColor determinam a cor da tela de fundo.

Se elpBrushStyle for BS_HOLLOW ou BS_PATTERN, elpColor será ignorado.

Se elpBrushStyle for BS_DIBPATTERN ou BS_DIBPATTERNPT, a palavra de ordem baixa de elpColor especifica se o membro bmiColors da estrutura BITMAPINFO contém valores RGB explícitos ou índices na paleta lógica atualmente realizada. O valor elpColor deve ser um dos seguintes.

A macro RGB é usada para gerar uma estrutura COLORREF .

elpHatch

Se elpBrushStyle for BS_PATTERN, elpHatch será um identificador para o bitmap que define o padrão.

Se elpBrushStyle for BS_SOLID ou BS_HOLLOW, elpHatch será ignorado.

Se elpBrushStyle for BS_DIBPATTERN, o membro elpHatch será um identificador para um DIB empacotado. Para obter esse identificador, um aplicativo chama a função GlobalAlloc com GMEM_MOVEABLE (ou LocalAlloc com LMEM_MOVEABLE) para alocar um bloco de memória e preenche a memória com o DIB empacotado. Um DIB empacotado consiste em uma estrutura BITMAPINFO imediatamente seguida pela matriz de bytes que definem os pixels do bitmap.

Se elpBrushStyle for BS_DIBPATTERNPT, o membro elpHatch será um ponteiro para um DIB empacotado. O ponteiro deriva do bloco de memória criado por LocalAlloc com LMEM_FIXED definido ou por GlobalAlloc com GMEM_FIXED definido ou é o ponteiro retornado por uma chamada como LocalLock (handle_to_the_dib). Um DIB empacotado consiste em uma estrutura BITMAPINFO imediatamente seguida pela matriz de bytes que definem os pixels do bitmap.

Se elpBrushStyle for BS_HATCHED, o membro elpHatch especificará a orientação das linhas usadas para criar a hachura. Pode ser um dos seguintes valores.

elpNumEntries

O número de entradas na matriz de estilo no membro elpStyleEntry . Esse valor será zero se elpPenStyle não especificar PS_USERSTYLE.

elpStyleEntry[1]

Uma matriz de estilo fornecida pelo usuário. A matriz é especificada com um comprimento finito, mas é usada como se fosse repetida indefinidamente. A primeira entrada na matriz especifica o comprimento do primeiro traço. A segunda entrada especifica o comprimento da primeira lacuna. Depois disso, comprimentos de traços e lacunas são alternativos.

Se elpWidth especificar linhas geométricas, os comprimentos estarão em unidades lógicas. Caso contrário, as linhas são cosméticas e os comprimentos estão em unidades de dispositivo.

Requisitos

Confira também

BITMAPINFO

COLORREF

ExtCreatePen

Getobject

Estruturas de caneta

Visão geral das canetas

RGB

Setbkcolor

Setbkmode