MoveWindow-Funktion (winuser.h)
Ä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) |
Siehe auch
Konzept
Andere Ressourcen
Referenz