CWnd::SetWindowPos

BOOL SetWindowPos ( const CWnd * pWndInsertAfter, int x, int y, int cx, int cy, UINT nFlags );

Wartość zwracany

Niezerowa, jeśli funkcja jest skuteczne; inny sposób 0.

Parametry

pWndInsertAfter

Identyfikuje obiekt CWnd , który będzie poprzedzać tego obiektu CWnd w porządku osi Z. Ten parametr może być wskaźnik do CWnd lub wskaźnik do jednej z następujących wartości:

w&ndBottomnbsp; Umieszcza okna na dole porządku osi Z. Jeśli ta CWnd jest okno, okna straci swój status wierzchu; system umieści okna w dolnej części wszystkich innych okien.
w&ndTopnbsp; Umieszcza okno w górnej części porządku osi z.
w&ndTopMostnbsp; Umieszcza okna przede wszystkim nontopmost systemu windows. Okno utrzymuje swoje stanowisko dotyczące wierzchu, nawet wtedy, gdy jest dezaktywowany.
wnd&NoTopMostnbsp; Zmiana okno na wierzch wszystkich okien nontopmost (oznacza to, że za wszystkich okien najwyższego). Ta flaga jest ignorowany, jeśli okno jest już nontopmost okno.
W sekcji "Uwagi" dla tej funkcji dla zasad dotyczących używania tego parametru.

Określa nowe położenie w lewej części okna.

Określa nowe położenie górnej części okna.

Określa nową szerokość okna.

Określa wysokość nowego okna.

nFlags

Określa zmiany rozmiaru i położenia opcje. Ten parametr może być kombinacją następujących:

SWP_DRAWFRAME Rysuje ramki (określone podczas tworzenia okna) wokół okna.
SWP_FRAMECHA&NGEDnbsp; Wysyła komunikat WM_NCCALCSIZE aby oknie, nawet jeśli nie jest przy zmianie rozmiaru okna. Jeśli ta flaga nie jest określony, WM_NCCALCSIZE jest wysyłana tylko wtedy, gdy zmienia się rozmiar okna.
SWP_HIDEWI&NDOWnbsp; Ukrywa okno.
SWP_&NOACTIVATEnbsp; Nie Uaktywnij okno. Jeśli ta flaga nie jest ustawiona, okno jest aktywowana i przeniósł się do górnej części położonej lub grupie nontopmost (w zależności od ustawienia parametru pWndInsertAfter ).
SWP_&NOCOPYBITSnbsp; Usuwa całą zawartość obszaru klienckiego. Jeśli ta flaga nie jest określony, ważne zawartość obszaru klienta są zapisywane i kopiowane do obszaru klienckiego po oknie jest wielkości i położenia.
SWP_&NOMOVEnbsp; Zachowuje bieżące położenie (ignoruje parametry x i y ).
SWP_&NOOWNERZORDERnbsp; Zmienia położenie okna właściciela w porządku osi z.
SWP_&NOREDRAWnbsp; Nie Przerysowuje zmiany. Jeśli ta flaga będzie ustawiona, nie odowieżenie wszelkiego rodzaju występuje. Odnosi się to do obszaru klienckiego, obszar nonclient (w tym paski tytułu i przewijania) oraz jakąkolwiek częścią okno nadrzędne bez przykrycia z okna przeniesiony. Jeśli ta flaga będzie ustawiona, wniosek musi wyraźnie unieważnia lub odświeżyć wszystkie części okna i okna nadrzędnego, które muszą zostać odświeżone.
SWP_&NOREPOSITIONnbsp; Takie same jak SWP_NOOWNERZORDER.
SWP_&NOSENDCHANGINGnbsp; Zapobiega odbieraniu wiadomości WM_WINDOWPOSCHANGING okna.
SWP_&NOSIZEnbsp; Zachowuje bieżący rozmiar (ignoruje parametry cx i cy ).
SWP_&NOZORDERnbsp; Zachowuje bieżący zamawiania (ignoruje pWndInsertAfter).
SWP_SHOWWI&NDOWnbsp; Wyświetla okno.

Uwagi

Nazwać tę funkcję Państwa, aby zmienić rozmiar, położenie i porządek okien podręcznych i najwyższego poziomu podrzędnych,.

Windows są uporządkowane na ekranie zgodnie z ich kolejności Z; zostanie wyświetlone okno w górnej części porządek na wierzchu innych okien w kolejności.

Wszystkie współrzęd&ne dla okien podrzędnych są klienta współrzędnych (w stosunku do lewego górnego rogu obszaru klienckiego okno nadrzędne) .nbsp;

Okno mogą być przenoszone do góry porządek albo przez ustawienie parametru pWndInsert&After do amp; wndTopMost i zapewnienie, które flagi SWP_NOZORDER nie jest ustawiony lub przez ustawienie kolejności z okna, tak aby była ona powyżej wszelkich istniejących windows najwyższego. Gdy nontopmost okno jest najwyższy, jego własnością systemu windows są również najwyższej. Jego właścicieli nie są zmieniane.

Okno nie jest już n&ajwyższy, jeśli jest położenie do dołu (amp; wndBottom), porządek lub po dowolnego okna nontopmost. Gdy okno jest nontopmost, zostaną wykonane wszystkie jego właścicieli i jego własnością windows nontopmost systemu windows.

Jeżeli ani SWP_NOACTIVATE , ani SWP_NOZORDER nie określono (oznacza to, że gdy aplikacja żąda że okno jednocześnie aktywowane i umieszczone w określonym porządku osi Z), określona w pWndInsertAfter wartość jest używana tylko w następujących okolicznościach:

Ani amp; wndTopMost , ani & wndNoTopMost jest określony w parametrze pWndInsertAfter.
To okno nie jest oknem aktywnym.

Aplikacja nie może uaktywnić okna nieaktywnego bez również doprowadzania do góry porządku osi Z. Aplikacje można zmienić porządek aktywnego okna bez ograniczeń.

Nontopmost okno może własne okno, ale nie na odwrót. Wszystkie okna (na przykład okno dialogowe) posiadane przez okno jest dokonywane okno do zapewnienia wszystkich posiadanych windows pobytu powyżej ich właściciela.

Z wersjami systemu Windows 3.1 i później system windows można przeniósł się do górnej części porządek i tam zablokowane przez ustawienie ich style WS_EX_TOPMOST . Takie okno utrzymuje swoje stanowisko wierzchu nawet wtedy, gdy dezaktywowany. Na przykład wybierając polecenie WinHelp zawsze na wierzchu sprawia, że najwyższy okna pomocy, a następnie pozostaje widoczna po powrocie do aplikacji.

&Aby utworzyć okno, wywołanie SetWindowPos z parametrem pWndInsertAfter równa amp; wndTopMostlub ustawić styl WS_EX_TOPMOST , tworząc okno.

Jeśli porządek z&awiera wszystkie okna w stylu WS_EX_TOPMOST , okno przeniósł się z wartością amp; wndTopMost znajduje się u góry nontopmost okien, ale poniżej żadnych okien najwyższego. Jeżeli aplikacji uaktywnia okna nieaktywnego bez bitowego WS_EX_TOPMOST , okna są przenoszone powyżej nontopmost okien, ale poniżej żadnych okien najwyższego.

Jeśli SetWindowPos jest wywołany, kiedy parametr pWndInsert&After jest amp; wndBottom i CWnd jest okno, okna straci swój status najwyższej (WS_EX_TOPMOST jest wyczyszczone) i system umieszcza okna na dole porządku osi z.

Omówienie CWnd |nbsp; Klasa członków | Wykres hierarchii

Zobacz teżnbsp; :: DeferWindowPos, :: SetWindowPos

Index