BeginPaint-Funktion (winuser.h)
Die BeginPaint-Funktion bereitet das angegebene Fenster für das Malen vor und füllt eine PAINTSTRUCT-Struktur mit Informationen zum Malen.
Syntax
HDC BeginPaint(
[in] HWND hWnd,
[out] LPPAINTSTRUCT lpPaint
);
Parameter
[in] hWnd
Handle für das Fenster, das neu gestrichen werden soll.
[out] lpPaint
Zeiger auf die PAINTSTRUCT-Struktur , die Malinformationen empfängt.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert das Handle für einen Anzeigegerätekontext für das angegebene Fenster.
Wenn die Funktion fehlschlägt, ist der Rückgabewert NULL, was angibt, dass kein Anzeigegerätekontext verfügbar ist.
Hinweise
Die BeginPaint-Funktion legt den Abschneidebereich des Gerätekontexts automatisch so fest, dass jeder Bereich außerhalb des Updatebereichs ausgeschlossen wird. Der Updatebereich wird von der InvalidateRect - oder InvalidateRgn-Funktion und vom System nach der Größenanpassung, dem Verschieben, Erstellen, Scrollen oder einem anderen Vorgang festgelegt, der sich auf den Clientbereich auswirkt. Wenn der Updatebereich zum Löschen markiert ist, sendet BeginPaint eine WM_ERASEBKGND Nachricht an das Fenster.
Eine Anwendung sollte BeginPaint nur als Reaktion auf eine WM_PAINT-Nachricht aufrufen. Jeder Aufruf von BeginPaint muss einen entsprechenden Aufruf der EndPaint-Funktion aufweisen.
Wenn sich das Caret im zu zeichnenden Bereich befindet, blendet BeginPaint das Caret automatisch aus, um zu verhindern, dass es gelöscht wird.
Wenn die Klasse des Fensters über einen Hintergrundpinsel verfügt, verwendet BeginPaint diesen Pinsel, um den Hintergrund des Updatebereichs zu löschen, bevor er zurückgegeben wird.
DPI-Virtualisierung
Diese API ist nicht an der DPI-Virtualisierung beteiligt. Die zurückgegebene Ausgabe ist immer in Bezug auf physische Pixel.Beispiele
Ein Beispiel finden Sie unter Zeichnen im Clientbereich.
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 | winuser.h (einschließlich Windows.h) |
| Bibliothek | User32.lib |
| DLL | User32.dll |
| APIs | ext-ms-win-ntuser-draw-l1-1-0 (eingeführt in Windows 8) |