Struttura EXTLOGPEN (wingdi.h)

La struttura EXTLOGPEN definisce gli attributi di stile, larghezza e pennello della penna per una penna estesa. Questa struttura viene utilizzata dalla funzione GetObject quando recupera una descrizione di una penna creata quando un'applicazione ha chiamato la funzione ExtCreatePen .

Sintassi

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

Members

elpPenStyle

Combinazione di tipo penna, stile, stile estremità finale e stile join. I valori di ogni categoria possono essere recuperati usando un operatore AND bit per bit con la maschera appropriata.

Il membro elpPenStyle mascherato con PS_TYPE_MASK ha uno dei valori di tipo penna seguenti.

Il membro elpPenStyle mascherato con PS_STYLE_MASK ha uno dei valori di stile della penna seguenti:

La categoria seguente si applica solo alle penne PS_GEOMETRIC. Il membro elpPenStyle mascherato con PS_ENDCAP_MASK ha uno dei valori di estremità finale seguenti.

La categoria seguente si applica solo alle penne PS_GEOMETRIC. Il membro elpPenStyle mascherato con PS_JOIN_MASK ha uno dei valori di join seguenti.

elpWidth

Larghezza della penna. Se il membro elpPenStyle è PS_GEOMETRIC, questo valore corrisponde alla larghezza della linea in unità logiche. In caso contrario, le linee sono cosmetiche e questo valore è 1, che indica una linea con una larghezza di un pixel.

elpBrushStyle

Stile pennello della penna. Il valore del membro elpBrushStyle può essere uno dei seguenti.

elpColor

Se elpBrushStyle è BS_SOLID o BS_HATCHED, elpColor specifica il colore in cui deve essere disegnata la penna. Per BS_HATCHED, le funzioni SetBkMode e SetBkColor determinano il colore di sfondo.

Se elpBrushStyle è BS_HOLLOW o BS_PATTERN, elpColor viene ignorato.

Se elpBrushStyle è BS_DIBPATTERN o BS_DIBPATTERNPT, la parola in ordine basso di elpColor specifica se il membro bmiColors della struttura BITMAPINFO contiene valori RGB espliciti o indici RGB nella tavolozza logica attualmente realizzata. Il valore elpColor deve essere uno dei seguenti.

La macro RGB viene utilizzata per generare una struttura COLORREF .

elpHatch

Se elpBrushStyle è BS_PATTERN, elpHatch è un handle per la bitmap che definisce il modello.

Se elpBrushStyle è BS_SOLID o BS_HOLLOW, elpHatch viene ignorato.

Se elpBrushStyle è BS_DIBPATTERN, il membro elpHatch è un handle per un DIB compresso. Per ottenere questo handle, un'applicazione chiama la funzione GlobalAlloc con GMEM_MOVEABLE (o LocalAlloc con LMEM_MOVEABLE) per allocare un blocco di memoria e quindi riempie la memoria con il diB compresso. Un DIB compresso è costituito da una struttura BITMAPINFO immediatamente seguita dalla matrice di byte che definiscono i pixel della bitmap.

Se elpBrushStyle è BS_DIBPATTERNPT, il membro elpHatch è un puntatore a un DIB compresso. Il puntatore deriva dal blocco di memoria creato da LocalAlloc con LMEM_FIXED impostato o da GlobalAlloc con GMEM_FIXED impostato oppure è il puntatore restituito da una chiamata come LocalLock (handle_to_the_dib). Un DIB compresso è costituito da una struttura BITMAPINFO immediatamente seguita dalla matrice di byte che definiscono i pixel della bitmap.

Se elpBrushStyle è BS_HATCHED, il membro elpHatch specifica l'orientamento delle linee utilizzate per creare il tratteggio. Può essere uno dei valori seguenti.

elpNumEntries

Numero di voci nella matrice di stile nel membro elpStyleEntry . Questo valore è zero se elpPenStyle non specifica PS_USERSTYLE.

elpStyleEntry[1]

Matrice di stile fornita dall'utente. La matrice viene specificata con una lunghezza finita, ma viene usata come se ripetuta per un periodo illimitato. La prima voce nella matrice specifica la lunghezza del primo trattino. La seconda voce specifica la lunghezza del primo gap. Successivamente, lunghezze di trattini e spazi alternati.

Se elpWidth specifica linee geometriche, le lunghezze sono in unità logiche. In caso contrario, le linee sono cosmetiche e lunghezze sono in unità di dispositivo.

Requisiti

Vedi anche

BITMAPINFO

COLORREF

ExtCreatePen

Getobject

Strutture della penna

Panoramica delle penne

RGB

SetBkColor

SetBkMode