MoveWindow-Funktion (winuser.h)

Artikel
03/13/2024

Ändert die Position und die Dimensionen des angegebenen Fensters. Bei einem Fenster auf oberster Ebene sind die Position und die Dimensionen relativ zur oberen linken Ecke des Bildschirms. Bei einem untergeordneten Fenster sind sie relativ zur oberen linken Ecke des Clientbereichs des übergeordneten Fensters.

Syntax

BOOL MoveWindow(
  [in] HWND hWnd,
  [in] int  X,
  [in] int  Y,
  [in] int  nWidth,
  [in] int  nHeight,
  [in] BOOL bRepaint
);

Parameter

[in] hWnd

Typ: HWND

Ein Handle für das Fenster.

[in] X

Typ: int

Die neue Position der linken Seite des Fensters.

[in] Y

Typ: int

Die neue Position des oberen Bereichs des Fensters.

[in] nWidth

Typ: int

Die neue Breite des Fensters.

[in] nHeight

Typ: int

Die neue Höhe des Fensters.

[in] bRepaint

Typ: BOOL

Gibt an, ob das Fenster neu gestrichen werden soll. Wenn dieser Parameter TRUE ist, empfängt das Fenster eine Meldung. Wenn der Parameter FALSE ist, erfolgt keine Neulackierung jeglicher Art. Dies gilt für den Clientbereich, den Nichtclientbereich (einschließlich Titelleiste und Bildlaufleisten) und alle Teile des übergeordneten Fensters, die durch das Verschieben eines untergeordneten Fensters aufgedeckt werden.

Rückgabewert

Typ: BOOL

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

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Wenn der bRepaint-ParameterTRUE ist, sendet das System die WM_PAINT Nachricht direkt nach dem Verschieben des Fensters an die Fensterprozedur (d. a. die MoveWindow-Funktion ruft die UpdateWindow-Funktion auf). Wenn bRepaintFALSE ist, muss die Anwendung alle Teile des Fensters und des übergeordneten Fensters, die neu gezeichnet werden müssen, explizit ungültig machen oder neu zeichnen.

MoveWindow sendet die nachrichten WM_WINDOWPOSCHANGING, WM_WINDOWPOSCHANGED, WM_MOVE, WM_SIZE und WM_NCCALCSIZE an das Fenster.

Beispiele

Ein Beispiel finden Sie unter Erstellen, Aufzählen und Größenanpassung untergeordneter Windows-Fenster.

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-window-l1-1-1 (eingeführt in Windows 8.1)