GetBrushOrgEx-Funktion (wingdi.h)

Artikel
03/13/2024

Die GetBrushOrgEx-Funktion ruft den aktuellen Pinselursprung für den angegebenen Gerätekontext ab. Diese Funktion ersetzt die GetBrushOrg-Funktion .

Syntax

BOOL GetBrushOrgEx(
  [in]  HDC     hdc,
  [out] LPPOINT lppt
);

Parameter

[in] hdc

Ein Handle für den Gerätekontext.

[out] lppt

Ein Zeiger auf eine POINT-Struktur , die den Pinselursprung in Gerätekoordinaten empfängt.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.

Hinweise

Ein Pinsel ist eine Bitmap, die das System verwendet, um das Innere gefüllter Formen zu malen.

Der Pinselursprung besteht aus einer Reihe von Koordinaten mit Werten zwischen 0 und 7, die die Position eines Pixels in der Bitmap angeben. Die Standardkoordinaten des Pinselursprungs sind (0,0). Bei horizontalen Koordinaten entspricht der Wert 0 der äußersten linken Spalte von Pixeln. Der Wert 7 entspricht der spalte am weitesten rechts. Bei vertikalen Koordinaten entspricht der Wert 0 der obersten Pixelzeile; Der Wert 7 entspricht der untersten Zeile. Wenn das System den Pinsel am Anfang eines Malvorgangs positioniert, ordnet es den Ursprung des Pinsels der Position im Clientbereich des Fensters zu, die vom Pinselursprung angegeben wird. Wenn der Ursprung beispielsweise auf (2,3) festgelegt ist, ordnet das System den Ursprung des Pinsels (0,0) der Position (2,3) im Clientbereich des Fensters zu.

Wenn eine Anwendung einen Pinsel verwendet, um die Hintergründe eines übergeordneten und eines untergeordneten Fensters mit übereinstimmenden Farben zu füllen, muss möglicherweise der Pinselursprung nach dem Zeichnen des übergeordneten Fensters, aber vor dem Zeichnen des untergeordneten Fensters festgelegt werden.

Das System verfolgt automatisch den Ursprung aller Kontexte von fensterverwalteten Geräten nach und passt ihre Pinsel bei Bedarf an, um eine Ausrichtung von Mustern auf der Oberfläche beizubehalten.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wingdi.h (windows.h einschließen)
Bibliothek	Gdi32.lib
DLL	Gdi32.dll