SetBrushOrgEx-Funktion (wingdi.h)
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.
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.
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 |