EXTLOGPEN-Struktur (wingdi.h)

Die EXTLOGPEN-Struktur definiert das Stiftformat, die Breite und die Pinselattribute für einen erweiterten Stift. Diese Struktur wird von der GetObject-Funktion verwendet, wenn sie eine Beschreibung eines Stifts abruft, der erstellt wurde, als eine Anwendung die ExtCreatePen-Funktion aufgerufen hat.

Syntax

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

Member

elpPenStyle

Eine Kombination aus Stifttyp, Stil, Endkappenformat und Verknüpfungsstil. Die Werte aus jeder Kategorie können mithilfe eines bitweisen AND-Operators mit der entsprechenden Maske abgerufen werden.

Das elpPenStyle-Element , das mit PS_TYPE_MASK maskiert ist, weist einen der folgenden Stifttypwerte auf.

Das elpPenStyle-Element , das mit PS_STYLE_MASK maskiert ist, verfügt über einen der folgenden Stiftformatvorlagenwerte:

Die folgende Kategorie gilt nur für PS_GEOMETRIC Stifte. Das elpPenStyle-Element , das mit PS_ENDCAP_MASK maskiert ist, weist einen der folgenden Endkappenwerte auf.

Die folgende Kategorie gilt nur für PS_GEOMETRIC Stifte. Das elpPenStyle-Element , das mit PS_JOIN_MASK maskiert ist, weist einen der folgenden Joinwerte auf.

elpWidth

Die Breite des Stifts. Wenn der elpPenStyle-Member PS_GEOMETRIC ist, ist dieser Wert die Breite der Linie in logischen Einheiten. Andernfalls sind die Linien kosmetisch, und dieser Wert ist 1, was eine Linie mit einer Breite von einem Pixel angibt.

elpBrushStyle

Der Pinselstil des Stifts. Der elpBrushStyle-Memberwert kann einer der folgenden Sein:

elpColor

Wenn elpBrushStyle BS_SOLID oder BS_HATCHED ist, gibt elpColor die Farbe an, in der der Stift gezeichnet werden soll. Für BS_HATCHED bestimmen die Funktionen SetBkMode und SetBkColor die Hintergrundfarbe.

Wenn elpBrushStyle BS_HOLLOW oder BS_PATTERN ist, wird elpColor ignoriert.

Wenn elpBrushStyle BS_DIBPATTERN oder BS_DIBPATTERNPT ist, gibt das Wort mit niedriger Ordnung von elpColor an, ob der bmiColors-Member der BITMAPINFO-Struktur explizite RGB-Werte oder Indizes in der aktuell realisierten logischen Palette enthält. Der elpColor-Wert muss einer der folgenden Werte sein.

Das RGB-Makro wird verwendet, um eine COLORREF-Struktur zu generieren.

elpHatch

Wenn elpBrushStyle BS_PATTERN ist, ist elpHatch ein Handle für die Bitmap, die das Muster definiert.

Wenn elpBrushStyle BS_SOLID oder BS_HOLLOW ist, wird elpHatch ignoriert.

Wenn elpBrushStyle BS_DIBPATTERN ist, ist der elpHatch-Member ein Handle für einen verpackten DIB. Um dieses Handle zu erhalten, ruft eine Anwendung die GlobalAlloc-Funktion mit GMEM_MOVEABLE (oder LocalAlloc mit LMEM_MOVEABLE) auf, um einen Speicherblock zuzuweisen, und füllt den Speicher dann mit dem gepackten DIB auf. Ein gepackter DIB besteht aus einer BITMAPINFO-Struktur , unmittelbar gefolgt von dem Bytearray, das die Pixel der Bitmap definiert.

Wenn elpBrushStyle BS_DIBPATTERNPT ist, ist der elpHatch-Member ein Zeiger auf einen gepackten DIB. Der Zeiger leitet sich von dem Speicherblock ab, der von LocalAlloc mit LMEM_FIXED oder von GlobalAlloc mit GMEM_FIXED Satz erstellt wurde, oder es handelt sich um den Zeiger, der von einem Aufruf wie LocalLock (handle_to_the_dib) zurückgegeben wird. Ein gepackter DIB besteht aus einer BITMAPINFO-Struktur unmittelbar gefolgt von dem Bytearray, das die Pixel der Bitmap definiert.

Wenn elpBrushStyle BS_HATCHED ist, gibt das elpHatch-Element die Ausrichtung der Linien an, die zum Erstellen der Luke verwendet werden. Dieses Argument einen der folgenden Werte annehmen.

elpNumEntries

Die Anzahl der Einträge im Formatarray im elpStyleEntry-Member . Dieser Wert ist 0, wenn elpPenStyle nicht PS_USERSTYLE angibt.

elpStyleEntry[1]

Ein vom Benutzer bereitgestelltes Formatarray. Das Array wird mit einer endlichen Länge angegeben, aber es wird so verwendet, als würde es unbegrenzt wiederholt. Der erste Eintrag im Array gibt die Länge des ersten Bindestrichs an. Der zweite Eintrag gibt die Länge der ersten Lücke an. Danach wechseln sich längen von Bindestrichen und Lücken ab.

Wenn elpWidth geometrische Linien angibt, werden die Längen in logischen Einheiten angegeben. Andernfalls sind die Linien kosmetisch, und die Längen befinden sich in Geräteeinheiten.

Anforderungen

Weitere Informationen

BITMAPINFO

COLORREF

ExtCreatePen

GetObject

Stiftstrukturen

Stiftübersicht

RGB

SetBkColor

SetBkMode