LockWindowUpdate-Funktion (winuser.h)

Artikel
03/13/2024

Die LockWindowUpdate-Funktion deaktiviert oder aktiviert das Zeichnen im angegebenen Fenster. Nur ein Fenster kann gleichzeitig gesperrt werden.

Syntax

BOOL LockWindowUpdate(
  [in] HWND hWndLock
);

Parameter

[in] hWndLock

Das Fenster, in dem die Zeichnung deaktiviert wird. Wenn dieser Parameter NULL ist, ist das Zeichnen im gesperrten Fenster aktiviert.

Rückgabewert

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

Wenn die Funktion fehlschlägt, ist der Rückgabewert 0, was angibt, dass ein Fehler aufgetreten ist oder ein anderes Fenster bereits gesperrt war.

Hinweise

Der Zweck der LockWindowUpdate-Funktion besteht darin, das Ziehen/Ablegen von Feedback über ein Fenster zu ermöglichen, ohne das Fenster selbst zu stören. Die Absicht besteht darin, dass das Fenster gesperrt wird, wenn Feedback gezeichnet und nach Abschluss des Feedbacks entsperrt wird. LockWindowUpdate ist nicht für die allgemeine Unterdrückung der Fensterrotierung vorgesehen. Verwenden Sie die WM_SETREDRAW Meldung, um das Neuzeichnen eines bestimmten Fensters zu deaktivieren.

Wenn eine Anwendung mit einem gesperrten Fenster (oder einem gesperrten untergeordneten Fenster) die Funktion GetDC, GetDCEx oder BeginPaint aufruft, gibt die aufgerufene Funktion einen Gerätekontext mit einer sichtbaren Region zurück, die leer ist. Dies geschieht, bis die Anwendung das Fenster durch Aufrufen von LockWindowUpdate entsperrt und einen Wert von NULL für hWndLock angibt.

Wenn eine Anwendung versucht, innerhalb eines gesperrten Fensters zu zeichnen, zeichnet das System den Umfang des versuchten Vorgangs in einem umgebenden Rechteck auf. Wenn das Fenster entsperrt ist, ungültigt das System den Bereich innerhalb dieses umgebenden Rechtecks, sodass eine eventuelle WM_PAINT Nachricht an das zuvor gesperrte Fenster und seine untergeordneten Fenster gesendet wird. Wenn während des Sperrens der Fensteraktualisierungen keine Zeichnung aufgetreten ist, wird kein Bereich ungültig.

LockWindowUpdate macht das angegebene Fenster nicht unsichtbar und löscht das WS_VISIBLE Stilbits nicht.

Ein gesperrtes Fenster kann nicht verschoben werden.

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-2 (eingeführt in Windows 10, Version 10.0.10240)