SetBrushOrgEx-Funktion (wingdi.h)

Artikel
03/08/2023

Die SetBrushOrgEx-Funktion legt den Pinselursprung fest, den GDI dem nächsten Pinsel zuweist, den eine Anwendung im angegebenen Gerätekontext auswählt.

Syntax

BOOL SetBrushOrgEx(
  [in]  HDC     hdc,
  [in]  int     x,
  [in]  int     y,
  [out] LPPOINT lppt
);

Parameter

[in] hdc

Ein Handle für den Gerätekontext.

[in] x

Die x-Koordinate in Geräteeinheiten des neuen Pinselursprungs. Wenn dieser Wert größer als die Pinselbreite ist, wird sein Wert mithilfe des Modulusoperators (nXOrgmod brush width) reduziert.

[in] y

Die y-Koordinate in Geräteeinheiten des neuen Pinselursprungs. Wenn dieser Wert größer als die Pinselhöhe ist, wird sein Wert mithilfe des Modulusoperators (nYOrgmod Pinselhöhe) reduziert.

[out] lppt

Ein Zeiger auf eine POINT-Struktur , die den vorherigen Pinselursprung empfängt.

Dieser Parameter kann NULL sein, wenn der vorherige Pinselursprung nicht erforderlich ist.

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 die Innenräume gefüllter Formen zu malen.

Der Pinselursprung ist ein Koordinatenpaar, das die Position eines Pixels in der Bitmap angibt. Die Standardkoordinaten des Pinselursprungs sind (0,0). Bei horizontalen Koordinaten entspricht der Wert 0 der linken Spalte von Pixeln. die Breite entspricht der spalte am weitesten rechts. Bei vertikalen Koordinaten entspricht der Wert 0 der obersten Pixelzeile; die Höhe entspricht der unteren Zeile.

Das System verfolgt automatisch den Ursprung aller fensterseitig verwalteten Gerätekontexte nach und passt ihre Pinsel bei Bedarf an, um eine Ausrichtung von Mustern auf der Oberfläche beizubehalten. Der Pinselursprung, der mit diesem Aufruf festgelegt wird, ist relativ zur oberen linken Ecke des Clientbereichs.

Eine Anwendung sollte SetBrushOrgEx aufrufen, nachdem sie den Bitmap-Dehnungsmodus mithilfe von SetStretchBltMode auf HALFTONE festgelegt hat. Dies muss geschehen, um eine Fehlausrichtung der Bürste zu vermeiden.

Anforderungen


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 (einschließlich Windows.h)
Bibliothek	Gdi32.lib
DLL	Gdi32.dll