BeginPaint-Funktion (winuser.h)

Artikel
03/06/2024

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)