CWnd::SetWindowPos

BOOLSetWindowPos (constCWnd *pWndInsertAfter,IntX,Inty,IntCx,Intcy,nFlagsUINT);

Rückgabewert

Ungleich NULL, wenn die Funktion erfolgreich ist; andernfalls 0.

Parameter

pWndInsertAfter

Bezeichnet das CWnd -Objekt, das diese CWnd -Objekt in der Z-Reihenfolge stehen wird. Dieser Parameter kann ein Zeiger auf ein CWnd oder ein Zeiger auf einen der folgenden Werte sein.:

• WndBottom&Nbsp;  Schaltet das Fenster am unteren Rand der Z-Reihenfolge. Wenn diese CWnd ein oberstes Fenster ist, verliert das Fenster obersten Status; Das System schaltet das Fenster am unteren Rand aller anderen Fenster.
  
  
• WndTop&Nbsp;  Schaltet das Fenster am oberen Rand der Z-Reihenfolge.
  
  
• WndTopMost&Nbsp;  Schaltet das Fenster vor allem nontopmost Windows. Das Fenster behält seine oberste Position, auch wenn es deaktiviert ist.
  
  
• Wnd&NoTopMostNbsp;  Verschiebt das Fenster an die Spitze aller nontopmost Fenster (d. h. hinter alle obersten Fenster). Dieses Flag hat keine Auswirkungen, wenn das Fenster bereits ein nontopmost Fenster ist.

  Finden Sie im Abschnitt "Hinweise" für diese Funktion für Regeln darüber, wie dieser Parameter verwendet wird.

x

Gibt die neue Position des linken Randes des Fensters.

y

Gibt die neue Position des oberen Rand des Fensters.

cx

Gibt die neue Breite des Fensters.

cy

Gibt die neue Höhe des Fensters.

nFlags

Größenänderung und Positionierung von Optionen gibt. Dieser Parameter kann eine Kombination der folgenden Optionen sein.:

• SWP_DRAWFRAME&Nbsp;  Zeichnet einen Rahmen (definiert als das Fenster erstellt wurde) um das Fenster.
  
  
• SWP_FRAMECHA&NGEDNbsp;  Sendet eine Nachricht WM_NCCALCSIZE zum Fenster, auch wenn die Fenstergröße nicht geändert wird. Wenn dieses Flag nicht angegeben ist, ist WM_NCCALCSIZE nur gesendet, wenn die Fenstergröße geändert wird.
  
  
• SWP_HIDEWI&NDOWNbsp;  Blendet das Fenster.
  
  
• SWP_&NOACTIVATENbsp;  Das Fenster wird nicht aktiviert werden. Wenn dieses Flag nicht festgelegt ist, wird das Fenster aktiviert und zog nach oben auf die oberste oder die nontopmost Gruppe (je nach Einstellung des Parameters pWndInsertAfter ).
  
  
• SWP_&NOCOPYBITSNbsp;  Löscht den gesamten Inhalt des Clientbereichs. Wenn dieses Flag nicht angegeben ist, sind die gültigen Inhalt des Clientbereichs gespeichert und zurück in den Clientbereich kopiert werden, nachdem das Fenster Größe oder neu positioniert ist.
  
  
• SWP_&NOMOVENbsp;  Behält die aktuelle Position (ignoriert die Parameter X und y ).
  
  
• SWP_&NOOWNERZORDERNbsp;  Das Besitzerfenster Position in der Z-Reihenfolge nicht geändert.
  
  
• SWP_&NOREDRAWNbsp;  Änderungen wird nicht neu gezeichnet. Wenn dieses Flag festgelegt ist, tritt keine Malerarbeiten jeglicher Art. Dies gilt für den Clientbereich Clientbereich (einschließlich die Titel und Scroll-Balken) und ein Teil des übergeordneten Fensters aufgrund eines verschobenen Fenster entdeckt. Wenn dieses Flag festgelegt ist, muss die Anwendung explizit ungültig erklärt oder neu zeichnen alle Teile des Fensters und übergeordneten Fensters, der neu gezeichnet werden muss.
  
  
• SWP_&NOREPOSITIONNbsp;  Identisch SWP_NOOWNERZORDER.
  
  
• SWP_&NOSENDCHANGINGNbsp;  Verhindert, dass das Fenster empfangen der Nachricht WM_WINDOWPOSCHANGING.
  
  
• SWP_&NOSIZENbsp;  Behält die aktuelle Größe (ignoriert die Cx und cy -Parameter).
  
  
• SWP_&NOZORDERNbsp;  Behält die aktuelle Bestellung (ignoriert pWndInsertAfter).
  
  
• SWP_SHOWWI&NDOWNbsp;  Zeigt das Fenster.

Bemerkungen

Rufen Sie diese Memberfunktion um die Größe, die Position und die Z-Reihenfolge von untergeordneten, Pop-up und Top-Level-Fenster ändern.

Windows werden auf dem Bildschirm entsprechend ihrer Z-Reihenfolge bestellt; Das Fenster am oberen Rand der Z-Reihenfolge über allen anderen Fenstern in der Reihenfolge angezeigt.

Alle Koordi&naten für untergeordnete Fenster sind Client Koordinaten (bezogen auf die obere linke Ecke des Clientbereichs des übergeordneten Fensters) .nbsp;

Ein Fenster kann verschoben werden, an die Spitze der Z-Reihenfolge entweder durch Festlegen des Parameters pWndInsert&After Amp; WndTopMost und die Gewährleistung, die der SWP_NOZORDER flag nicht festgelegt ist oder durch ein Fenster-Z-Reihenfolge festlegen, so dass es über alle vorhandenen oberste Fenster ist. Wenn ein nontopmost Fenster oberste erfolgt, werden auch zugehörigen Besitzfenster oberste gemacht. Die Besitzer werden nicht geändert.

Ein oberstes Fenster ist nicht mehr oberste, wenn es an der Unterseite (&Amp; WndBottom) der Z-Reihenfolge oder nach einem beliebigen nontopmost Fenster positioniert ist. Wenn ein oberstes Fenster nontopmost erfolgt, sind alle seine Besitzer und zugehörigen Besitzfenster auch nontopmost Windows gemacht.

Wenn weder SWP_NOACTIVATE noch SWP_NOZORDER angegeben ist (d. h., wenn die Anwendung anfordert, dass gleichzeitig ein Fenster aktiviert und in der angegebenen Z-Reihenfolge platziert werden), wird der im pWndInsertAfter angegebene Wert nur unter den folgenden Umständen verwendet.:

• Weder Amp; WndTopMost noch & WndNoTopMost ist im pWndInsertAfter -Parameter angegeben.
  
  
• Dieses Fenster ist nicht das aktive Fenster.

Eine Anwendung kann kein inaktives Fensters aktivieren, ohne dass es auch an der Spitze der Z-Reihenfolge. Anwendungen können die Z-Reihenfolge eines aktivierten Fensters ohne Einschränkungen ändern.

Ein nontopmost Fenster kann selbst ein oberstes Fenster, aber nicht umgekehrt. Alle Fenster (z. B. ein Dialogfeld) im Besitz von einem obersten Fenster ist selbst ein oberstes Fenster, um sicherzustellen, dass alle gehört, dass Windows über ihre Besitzer bleiben.

Mit Windows-Versionen 3.1 und höher werden Windows an den Anfang der Z-Reihenfolge verschoben und es durch ihre WS_EX_TOPMOST Stile festlegen gesperrt. Ein oberstes Fenster behält seine oberste Position selbst wenn deaktiviert. Z. B. Auswahl des Befehls WinHelp immer im Vordergrund macht das oberste Hilfefenster, und es dann bleibt sichtbar, wenn Sie zu einer Anwendung zurückkehren.

Um ein oberstes Fenster erstellen, rufen Sie SetWindowPos mit dem pWndInsert&After -Parameter gleich Amp; WndTopMost, oder legen Sie den WS_EX_TOPMOST -Stil, wenn Sie das Fenster erstellen.

Wenn die Z-Reihenfolge alle Fenster mit dem WS_EX_TOPMOST -Stil enthält, wird ein Fenster mit dem &Amp; WndTopMost Wert verschoben an der Spitze aller nontopmost Fenster, aber unten keine oberste Fenster platziert. Wenn eine Anwendung ein inaktives Fensters ohne das WS_EX_TOPMOST Bit aktiviert, wird das Fenster über alle nontopmost Fenster aber unter alle obersten Fenster verschoben.

Wenn SetWindowPos aufgerufen wird, wenn der pWndInsert&After -Parameter Amp; WndBottom ist CWnd ein oberstes Fenster ist, Fenster seinen obersten Status verliert (WS_EX_TOPMOST deaktiviert ist) und das System das Fenster am unteren Rand der Z-Reihenfolge schaltet.

CWnd Übersicht |nbsp; Member der Klasse | Hierarchiediagramm

Siehe auch&Nbsp; :: DeferWindowPos, :: SetWindowPos