CWindow Klasa

Ta klasa udostępnia metody manipulowania oknem.

Składnia

class CWindow

Elementy członkowskie

Konstruktory publiczne

Metody publiczne

Operatory publiczne

Publiczne elementy członkowskie danych

Uwagi

CWindow Udostępnia podstawowe funkcje manipulowania oknem w atl. CWindow Wiele metod po prostu opakowuje jedną z funkcji interfejsu API Win32. Na przykład porównaj prototypy dla i CWindow::ShowWindow ShowWindow:

CWindow::ShowWindow wywołuje funkcję ShowWindow Win32, przekazując CWindow::m_hWnd jako pierwszy parametr. Każda CWindow metoda, która bezpośrednio opakowuje funkcję Win32, przekazuje m_hWnd element członkowski. W związku z CWindow tym większość dokumentacji odwołuje się do zestawu Windows SDK.

CWindow::m_hWndHWND program przechowuje okno, które identyfikuje okno. Obiekt HWND jest dołączony do obiektu, gdy:

• HWND Określ w CWindowkonstruktorze elementu .

• Wywołaj polecenie CWindow::Attach.

• Użyj polecenia CWindow's operator =.

• Utwórz lub podklasę okna przy użyciu jednej z następujących klas pochodnych z CWindowklasy :

CWindowImpl Umożliwia utworzenie nowego okna lub podklasy istniejącego okna.

CContainedWindow Implementuje okno zawarte w innym obiekcie. Możesz utworzyć nowe okno lub podklasę istniejącego okna.

CDialogImpl Umożliwia utworzenie modalnego lub moderowego okna dialogowego.

Aby uzyskać więcej informacji na temat okien, zobacz Windows i kolejne tematy w zestawie Windows SDK. Aby uzyskać więcej informacji na temat korzystania z okien w ATL, zobacz artykuł ATL Window Classes (Klasy okien ATL).

Wymagania

Nagłówek: atlwin.h

CWindow::ArrangeIconicWindows

Rozmieszcza wszystkie zminimalizowane okna podrzędne.

UINT ArrangeIconicWindows() throw();

Uwagi

Zobacz ArrangeIconicWindows w zestawie Windows SDK.

CWindow::Attach

Dołącza okno zidentyfikowane przez hWndNew obiekt CWindow .

void Attach(HWND hWndNew) throw();

Parametry

hWndNew
[in] Uchwyt do okna.

Przykład

//The following example attaches an HWND to the CWindow object
HWND hWnd  = ::GetDesktopWindow();
CWindow myWindow;
myWindow.Attach(hWnd);

CWindow::BeginPaint

Przygotowuje okno do malowania.

HDC BeginPaint(LPPAINTSTRUCT lpPaint) throw();

Uwagi

Zobacz BeginPaint w zestawie Windows SDK.

Przykład

//The following example attaches an HWND to the CWindow object
//and calls CWindow::BeginPaint() and CWindow::EndPaint() in the 
// WM_PAINT handler of a CWindowImpl-derived class
LRESULT CMyCtrl::OnPaint(UINT /*uMsg*/, WPARAM /*wParam*/, LPARAM /*lParam*/, 
   BOOL& /*bHandled*/)
{
   CWindow myWindow;
   myWindow.Attach(m_hWnd);
   PAINTSTRUCT ps;
   HDC hDC  = myWindow.BeginPaint(&ps);
   //Use the hDC as much as you want
   ::Rectangle(hDC, 0, 0, 50, 50);

   myWindow.EndPaint(&ps);

   return 0;
}

CWindow::BringWindowToTop

Przenosi okno w górnej części zamówienia Z.

BOOL BringWindowToTop() throw();

Uwagi

Zobacz BringWindowToTop w zestawie Windows SDK.

Przykład

//The following example attaches an HWND to the CWindow object and 
//calls CWindow::BringWindowToTop() to bring the window to the top 
//of the z-order.

CWindow myWindow;
myWindow.Attach(hWnd);
BOOL bOnTop = myWindow.BringWindowToTop();

//check if we could bring the window on top
if(bOnTop)
{
   //Do something
}

CWindow::CenterWindow

Wyśrodkuje okno względem danego okna.

BOOL CenterWindow(HWND hWndCenter = NULL) throw();

Parametry

hWndCenter
[in] Uchwyt do okna, w którym ma być wyśrodkować. Jeśli ten parametr to NULL (wartość domyślna), metoda zostanie ustawiona hWndCenter na okno nadrzędne okna, jeśli jest to okno podrzędne. W przeciwnym razie zostanie ustawione hWndCenter okno właściciela okna.

Wartość zwracana

TRUE jeśli okno zostało pomyślnie wyśrodkowane; w przeciwnym razie, FALSE.

Przykład

//The following example attaches various HWNDs to the CWindow objects 
//and calls CWindow::CenterWindow() for each of them

CWindow childWindow, popupWindow, overlappedWindow;

childWindow.Attach(hWndChild); //a window created with WS_CHILD style
childWindow.CenterWindow();    //This will center the child 
                               //window against its Parent window

popupWindow.Attach(hWndPopup); //a window created with WS_POPUP style
popupWindow.CenterWindow();    //This will center the popup window 
                               //against its Owner window

overlappedWindow.Attach(hWndOverlapped); //a window created with 
                                         //WS_OVERLAPPED style
overlappedWindow.CenterWindow(::GetDesktopWindow()); //This will center 
                       //the overlapped window against the DeskTop window

CWindow::ChangeClipboardChain

Usuwa okno z łańcucha osób przeglądających Schowek.

BOOL ChangeClipboardChain(HWND hWndNewNext) throw();

Uwagi

Zobacz ChangeClipboardChain w zestawie Windows SDK.

CWindow::CheckDlgButton

Zmienia stan sprawdzania określonego przycisku.

BOOL CheckDlgButton(int nIDButton, UINT nCheck) throw();

Uwagi

Zobacz CheckDlgButton w zestawie Windows SDK.

CWindow::CheckRadioButton

Sprawdza określony przycisk radiowy.

BOOL CheckRadioButton(
    int nIDFirstButton,
    int nIDLastButton,
    int nIDCheckButton) throw();

Uwagi

Zobacz CheckRadioButton w zestawie Windows SDK.

CWindow::ChildWindowFromPoint

Pobiera okno podrzędne zawierające określony punkt.

HWND ChildWindowFromPoint(POINT point) const throw();

Uwagi

Zobacz ChildWindowFromPoint w zestawie Windows SDK.

CWindow::ChildWindowFromPointEx

Pobiera określony typ okna podrzędnego zawierającego określony punkt.

HWND ChildWindowFromPoint(POINT point, UINT uFlags) const throw();

Uwagi

Zobacz ChildWindowFromPointEx w zestawie Windows SDK.

CWindow::ClientToScreen

Konwertuje współrzędne klienta na współrzędne ekranu.

BOOL ClientToScreen(LPPOINT lpPoint) const throw();
BOOL ClientToScreen(LPRECT lpRect) const throw();

Uwagi

Zobacz ClientToScreen w zestawie Windows SDK.

Druga wersja tej metody umożliwia konwertowanie współrzędnych RECT struktury.

CWindow::Create

Tworzy okno.

HWND Create(
    LPCTSTR lpstrWndClass,
    HWND hWndParent,
    _U_RECT rect = NULL,
    LPCTSTR szWindowName = NULL,
    DWORD dwStyle = 0,
    DWORD dwExStyle = 0,
    _U_MENUorID MenuOrID = 0U,
    LPVOID lpCreateParam = NULL) throw();

Parametry

lpstrWndClass
[in] Wskaźnik do klasy okna.

hWndParent
[in] Dojście do okna nadrzędnego lub właściciela.

rect
[in] Zmienna typu _U_RECT określająca położenie okna. Domyślna wartość to NULL. Gdy ten parametr ma NULLwartość , jest używana wartość CWindow::rcDefault .

szWindowName
[in] Określa nazwę okna. Domyślna wartość to NULL.

dwStyle
[in] Styl okna. Wartość domyślna to 0, co oznacza, że nie określono żadnego stylu. Aby uzyskać listę możliwych wartości, zobacz CreateWindow w zestawie Windows SDK.

dwExStyle
[in] Styl okna rozszerzonego. Wartość domyślna to 0, co oznacza, że nie określono stylu rozszerzonego. Aby uzyskać listę możliwych wartości, zobacz CreateWindowEx w zestawie Windows SDK.

MenuOrID
[in] Zmienna typu _U_MENUorID określająca uchwyt do menu lub identyfikatora okna. Domyślna wartość to 0U.

lpCreateParam
Wskaźnik do danych tworzenia okna zawartych w CREATESTRUCT strukturze.

Wartość zwracana

W przypadku powodzenia dojście do nowo utworzonego okna określonego przez m_hWnd. W przeciwnym razie wartość NULL.

Uwagi

CWindow::rcDefault parametr jest zdefiniowany jako __declspec(selectany) RECT CWindow::rcDefault = {CW_USEDEFAULT, CW_USEDEFAULT, 0, 0};.

Aby uzyskać więcej informacji, zobacz CreateWindow w zestawie Windows SDK.

Uwaga Jeśli wartość 0 jest używana jako wartość parametru MenuOrID , należy ją określić jako 0U (wartość domyślną), aby uniknąć błędu kompilatora.

CWindow::CreateCaret

Tworzy nowy kształt karetki systemu.

BOOL CreateCaret(HBITMAP pBitmap) throw();

Uwagi

Zobacz CreateCaret w zestawie Windows SDK.

CWindow::CreateGrayCaret

Tworzy szary prostokąt dla karetki systemu.

BOOL CreateGrayCaret(int nWidth, int nHeight) throw();

Uwagi

Zobacz CreateCaret w zestawie Windows SDK.

Przekazuje (HBITMAP) 1 parametr uchwytu mapy bitowej do funkcji Win32.

CWindow::CreateSolidCaret

Tworzy solidny prostokąt dla karetki systemu.

BOOL CreateSolidCaret(int nWidth, int nHeight) throw();

Uwagi

Zobacz CreateCaret w zestawie Windows SDK.

Przekazuje (HBITMAP) 0 parametr uchwytu mapy bitowej do funkcji Win32.

CWindow::CWindow

Konstruktor.

CWindow(HWND hWnd = NULL) throw();

Parametry

hWnd
[in] Uchwyt do okna.

Uwagi

Inicjuje element członkowski m_hWnd na hWnd, który domyślnie to NULL.

CWindow::DeferWindowPos

Aktualizuje określoną strukturę położenia wielu okien dla określonego okna.

HDWP DeferWindowPos(
    HDWP hWinPosInfo,
    HWND hWndInsertAfter,
    int x,
    int y,
    int cx,
    int cy,
    UINT uFlags) throw();

Uwagi

Zobacz DeferWindowPos w zestawie Windows SDK.

CWindow::DestroyWindow

Niszczy okno skojarzone z obiektem CWindow i ustawia wartość m_hWnd NULL.

BOOL DestroyWindow() throw();

Uwagi

Zobacz DestroyWindow w zestawie Windows SDK.

Nie niszczy CWindow samego obiektu.

Przykład

  //The following example attaches an HWND to the CWindow object and 
  //calls CWindow::DestroyWindow() to destroy the window

  CWindow myWindow;
  myWindow.Attach(hWndChild);
  //call the CWindow wrappers

  myWindow.DestroyWindow();
  hWndChild = NULL;

CWindow::Detach

Odłącza m_hWnd się od CWindow obiektu i ustawia wartość NULLm_hWnd .

HWND Detach() throw();

Wartość zwracana

Obiekt HWND skojarzony z obiektem CWindow .

Przykład

//The following example attaches an HWND to the CWindow object and 
//later detaches the CWindow object from the HWND when no longer needed

CWindow myWindow;
myWindow.Attach(hWnd);

//call CWindow wrappers

//We don't need the C++ object any more, so detach it from the HWND.
myWindow.Detach(); 

CWindow::DlgDirList

Wypełnia pole listy nazwami wszystkich plików pasujących do określonej ścieżki lub nazwy pliku.

int DlgDirList(
    LPTSTR lpPathSpec,
    int nIDListBox,
    int nIDStaticPath,
    UINT nFileType) throw();

Uwagi

Zobacz DlgDirList w zestawie Windows SDK.

CWindow::DlgDirListComboBox

Wypełnia pole kombi nazwami wszystkich plików pasujących do określonej ścieżki lub nazwy pliku.

int DlgDirListComboBox(
    LPTSTR lpPathSpec,
    int nIDComboBox,
    int nIDStaticPath,
    UINT nFileType) throw();

Uwagi

Zobacz DlgDirListComboBox w zestawie Windows SDK.

CWindow::DlgDirSelect

Pobiera bieżące zaznaczenie z pola listy.

BOOL DlgDirSelect(
    LPTSTR lpString,
    int nCount,
    int nIDListBox) throw();

Uwagi

Zobacz DlgDirSelectEx w zestawie Windows SDK.

CWindow::DlgDirSelectComboBox

Pobiera bieżące zaznaczenie z pola kombi.

BOOL DlgDirSelectComboBox(
    LPTSTR lpString,
    int nCount,
    int nIDComboBox) throw();

Uwagi

Zobacz DlgDirSelectComboBoxEx w zestawie Windows SDK.

CWindow::DragAcceptFiles

Rejestruje, czy okno akceptuje przeciągane pliki.

void DragAcceptFiles(BOOL bAccept = TRUE);

Uwagi

Zobacz DragAcceptFiles w zestawie Windows SDK.

CWindow::DrawMenuBar

Ponownie rysuje pasek menu okna.

BOOL DrawMenuBar() throw();

Uwagi

Zobacz DrawMenuBar w zestawie Windows SDK.

CWindow::EnableScrollBar

Włącza lub wyłącza strzałki paska przewijania.

BOOL EnableScrollBar(UINT uSBFlags, UINT uArrowFlags = ESB_ENABLE_BOTH) throw();

Uwagi

Zobacz EnableScrollBar w zestawie Windows SDK.

CWindow::EnableWindow

Włącza lub wyłącza dane wejściowe.

BOOL EnableWindow(BOOL bEnable = TRUE) throw();

Uwagi

Zobacz EnableWindow w zestawie Windows SDK.

Przykład

//The following example attaches an HWND to the CWindow object and 
//calls CWindow::EnableWindow() to enable and disable the window
//wrapped by the CWindow object

CWindow myWindow;
myWindow.Attach(hWnd);

//The following call enables the window 
//CWindow::EnableWindow() takes TRUE as the default parameter

myWindow.EnableWindow();

if(myWindow.IsWindowEnabled())
{
   //Do something now that the window is enabled

   //Now it's time to disable the window again
   myWindow.EnableWindow(FALSE);
}

CWindow::EndPaint

Oznacza koniec malowania.

void EndPaint(LPPAINTSTRUCT lpPaint) throw();

Uwagi

Zobacz EndPaint w zestawie Windows SDK.

Przykład

//The following example attaches an HWND to the CWindow object
//and calls CWindow::BeginPaint() and CWindow::EndPaint() in the 
// WM_PAINT handler of a CWindowImpl-derived class
LRESULT CMyCtrl::OnPaint(UINT /*uMsg*/, WPARAM /*wParam*/, LPARAM /*lParam*/, 
   BOOL& /*bHandled*/)
{
   CWindow myWindow;
   myWindow.Attach(m_hWnd);
   PAINTSTRUCT ps;
   HDC hDC  = myWindow.BeginPaint(&ps);
   //Use the hDC as much as you want
   ::Rectangle(hDC, 0, 0, 50, 50);

   myWindow.EndPaint(&ps);

   return 0;
}

CWindow::FlashWindow

okno raz.

BOOL FlashWindow(BOOL bInvert) throw();

Uwagi

Zobacz FlashWindow w zestawie Windows SDK.

CWindow::GetClientRect

Pobiera współrzędne obszaru klienta.

BOOL GetClientRect(LPRECT lpRect) const throw();

Uwagi

Zobacz GetClientRect w zestawie Windows SDK.

Przykład

//The following example attaches an HWND to the CWindow object and 
//calls CWindow::GetClientRect() to get the client area rectangle
//of the window

CWindow myWindow;
myWindow.Attach(hWnd);
RECT rc;
myWindow.GetClientRect(&rc);

CWindow::GetDC

Pobiera kontekst urządzenia dla obszaru klienta.

HDC GetDC() throw();

Uwagi

Zobacz GetDC w zestawie Windows SDK.

Przykład

// The following example attaches a HWND to the CWindow object,
// calls CWindow::GetDC to retrieve the DC of the client
// area of the window wrapped by CWindow Object, and calls
// CWindow::ReleaseDC to release the DC. 

CWindow myWindow;
myWindow.Attach(hWnd);   
HDC hDC = myWindow.GetDC();

// Use the DC

myWindow.ReleaseDC(hDC);
hDC = NULL;

CWindow::GetDCEx

Pobiera kontekst urządzenia dla obszaru klienta i umożliwia opcje wycinania.

HDC GetDCEx(HRGN hRgnClip, DWORD flags) throw();

Uwagi

Zobacz GetDCEx w zestawie Windows SDK.

CWindow::GetDescendantWindow

Znajduje okno elementów potomnych określone przez dany identyfikator.

HWND GetDescendantWindow(int nID) const throw();

Parametry

nID
[in] Identyfikator okna podrzędnego do pobrania.

Wartość zwracana

Uchwyt do okna elementu potomnego.

Uwagi

GetDescendantWindow wyszukuje całe drzewo okien podrzędnych, nie tylko okna, które są bezpośrednimi dziećmi.

CWindow::GetDlgControl

Wywołaj tę funkcję, aby uzyskać wskaźnik do interfejsu kontrolki ActiveX hostowanej przez kontrolkę złożoną lub okno dialogowe hostingu kontrolek.

HRESULT GetDlgControl(
    int nID,
    REFIID iid,
    void** ppCtrl) throw();

Parametry

nID
[in] Identyfikator zasobu pobieranej kontrolki.

iid
[in] Identyfikator interfejsu, który chcesz pobrać z kontrolki.

ppCtrl
[out] Wskaźnik do interfejsu.

Wartość zwracana

Zwraca wartość S_OK dla powodzenia lub dowolnego prawidłowego błędu HRESULT. Na przykład funkcja zwraca E_FAIL wartość , jeśli kontrolka określona przez nID element nie może zostać znaleziona i zwraca E_NOINTERFACE informację, czy można odnaleźć kontrolkę, ale nie obsługuje interfejsu określonego przez iidpolecenie .

Uwagi

Za pomocą tego wskaźnika można wywołać metody w interfejsie.

CWindow::GetDlgCtrlID

Pobiera identyfikator okna (tylko dla okien podrzędnych).

int GetDlgCtrlID() const throw();

Uwagi

Zobacz GetDlgCtrlID w zestawie Windows SDK.

CWindow::GetDlgHost

Pobiera wskaźnik do interfejsu do kontenera hostingu kontrolki ATL.

HRESULT GetDlgHost(
    int nID,
    REFIID iid,
    void** ppHost) throw();

Parametry

nID
[in] Identyfikator zasobu pobieranej kontrolki.

iid
[in] Identyfikator interfejsu, który chcesz pobrać z kontrolki.

ppHost
[out] Wskaźnik do interfejsu.

Wartość zwracana

Zwraca wartość S_OK , jeśli okno określone przez iid jest kontenerem sterowania, a żądany interfejs może zostać pobrany. Zwraca wartość E_FAIL , jeśli okno nie jest kontenerem sterowania lub jeśli nie można pobrać żądanego interfejsu. Jeśli nie można odnaleźć okna z określonym identyfikatorem, zwracana wartość jest równa HRESULT_FROM_WIN32(ERROR_CONTROL_ID_NOT_FOUND).

Uwagi

Za pomocą tego wskaźnika można wywołać metody w interfejsie.

CWindow::GetDlgItem

Pobiera określone okno podrzędne.

HWND GetDlgItem(int nID) const throw();

Uwagi

Zobacz GetDlgItem w zestawie Windows SDK.

CWindow::GetDlgItemInt

Tłumaczy tekst kontrolki na liczbę całkowitą.

UINT GetDlgItemInt(
    int nID,
    BOOL* lpTrans = NULL,
    BOOL bSigned = TRUE) const throw();

Uwagi

Zobacz GetDlgItemInt w zestawie Windows SDK.

CWindow::GetDlgItemText

Pobiera tekst kontrolki.

UINT GetDlgItemText(
    int nID,
    LPTSTR lpStr,
    int nMaxCount) const throw();

BOOL GetDlgItemText(
    int nID,
    BSTR& bstrText) const throw();

Uwagi

Aby uzyskać więcej informacji, zobacz GetDlgItemText w zestawie Windows SDK.

Druga wersja tej metody umożliwia skopiowanie tekstu kontrolki do elementu BSTR. Ta wersja zwraca TRUE wartość , jeśli tekst został pomyślnie skopiowany; w przeciwnym razie FALSE.

CWindow::GetExStyle

Pobiera rozszerzone style okna okna.

DWORD GetExStyle() const throw();

Wartość zwracana

Rozszerzone style okna.

Uwagi

Aby pobrać zwykłe style okna, wywołaj metodę GetStyle.

Przykład

//The following example attaches an HWND to the CWindow object and 
//calls CWindow::GetExStyle() to retrieve the extended styles of 
//the window

CWindow myWindow;
myWindow.Attach(hWnd);
DWORD dwExStyles = myWindow.GetExStyle();

CWindow::GetFont

Pobiera bieżącą czcionkę WM_GETFONT okna, wysyłając komunikat do okna.

HFONT GetFont() const throw();

Wartość zwracana

Uchwyt czcionki.

CWindow::GetHotKey

Określa klucz gorący skojarzony z oknem WM_GETHOTKEY , wysyłając komunikat.

DWORD GetHotKey() const throw();

Wartość zwracana

Kod klucza wirtualnego i modyfikatory klucza gorącego skojarzonego z oknem. Aby uzyskać listę możliwych modyfikatorów, zobacz WM_GETHOTKEY w zestawie Windows SDK. Aby uzyskać listę standardowych kodów kluczy wirtualnych, zobacz Winuser.h.

CWindow::GetIcon

Pobiera uchwyt do dużej lub małej ikony okna.

HICON GetIcon(BOOL bBigIcon = TRUE) const;

Parametry

bBigIcon
[in] Jeśli TRUE (wartość domyślna) metoda zwraca dużą ikonę. W przeciwnym razie zwraca małą ikonę.

Wartość zwracana

Uchwyt ikony.

Uwagi

GetIconWM_GETICON wysyła wiadomość do okna.

CWindow::GetLastActivePopup

Pobiera ostatnio aktywne okno podręczne.

HWND GetLastActivePopup() const throw();

Uwagi

Zobacz GetLastActivePopup w zestawie Windows SDK.

CWindow::GetMenu

Pobiera menu okna.

HMENU GetMenu() const throw();

Uwagi

Zobacz GetMenu w zestawie Windows SDK.

CWindow::GetNextDlgGroupItem

Pobiera poprzednią lub następną kontrolkę w grupie kontrolek.

HWND GetNextDlgGroupItem(HWND hWndCtl, BOOL bPrevious = FALSE) const throw();

Uwagi

Zobacz GetNextDlgGroupItem w zestawie Windows SDK.

CWindow::GetNextDlgTabItem

Pobiera poprzednią lub następną kontrolkę WS_TABSTOP o stylu.

HWND GetNextDlgTabItem(HWND hWndCtl, BOOL bPrevious = FALSE) const throw();

Uwagi

Zobacz GetNextDlgTabItem w zestawie Windows SDK.

CWindow::GetParent

Pobiera natychmiastowe okno nadrzędne.

HWND GetParent() const throw();

Uwagi

Zobacz GetParent w zestawie Windows SDK.

Przykład

// The following example attaches a HWND to the CWindow object
// and calls CWindow::GetParent to find out the parent
// window of the window wrapped by CWindow object.

CWindow myWindow;
myWindow.Attach(hWnd);   
HWND hWndParent = myWindow.GetParent();

CWindow::GetScrollInfo

Pobiera parametry paska przewijania.

BOOL GetScrollInfo(int nBar, LPSCROLLINFO lpScrollInfo) throw();

Uwagi

Zobacz GetScrollInfo w zestawie Windows SDK.

CWindow::GetScrollPos

Pobiera położenie pola przewijania.

int GetScrollPos(int nBar) const throw();

Uwagi

Zobacz GetScrollPos w zestawie Windows SDK.

CWindow::GetScrollRange

Pobiera zakres pasków przewijania.

BOOL GetScrollRange(
    int nBar,
    LPINT lpMinPos,
    LPINT lpMaxPos) const throw();

Uwagi

Zobacz GetScrollRange w zestawie Windows SDK.

CWindow::GetStyle

Pobiera style okna okna.

DWORD GetStyle() const throw();

Wartość zwracana

Style okna.

Uwagi

Aby pobrać rozszerzone style okna, wywołaj metodę GetExStyle.

Przykład

//The following example attaches an HWND to the CWindow object and 
//calls CWindow::GetStyle() to retrieve the styles of the window

CWindow myWindow;
myWindow.Attach(hWnd);
DWORD dwStyles = myWindow.GetStyle();

CWindow::GetSystemMenu

Tworzy kopię menu systemowego do modyfikacji.

HMENU GetSystemMenu(BOOL bRevert) const throw();

Uwagi

Zobacz GetSystemMenu w zestawie Windows SDK.

CWindow::GetTopLevelParent

Pobiera okno nadrzędne najwyższego poziomu okna.

HWND GetTopLevelParent() const throw();

Wartość zwracana

Dojście do okna nadrzędnego najwyższego poziomu.

CWindow::GetTopLevelWindow

Pobiera okno nadrzędne najwyższego poziomu lub okno właściciela.

HWND GetTopLevelWindow() const throw();

Wartość zwracana

Dojście do okna właściciela najwyższego poziomu.

CWindow::GetTopWindow

Pobiera okno podrzędne najwyższego poziomu.

HWND GetTopWindow() const throw();

Uwagi

Zobacz GetTopWindow w zestawie Windows SDK.

Przykład

//The following example attaches an HWND to the CWindow object and 
//calls CWindow::GetTopWindow() to get the top-level child window

CWindow myWindow;
myWindow.Attach(hWnd);
HWND hWndFavoriteChild = myWindow.GetTopWindow();

CWindow::GetUpdateRect

Pobiera współrzędne najmniejszego prostokąta, który całkowicie otacza region aktualizacji.

BOOL GetUpdateRect(LPRECT lpRect, BOOL bErase = FALSE) throw();

Uwagi

Zobacz GetUpdateRect w zestawie Windows SDK.

CWindow::GetUpdateRgn

Pobiera region aktualizacji i kopiuje go do określonego regionu.

int GetUpdateRgn(HRGN hRgn, BOOL bErase = FALSE) throw();

Uwagi

Zobacz GetUpdateRgn w zestawie Windows SDK.

CWindow::GetWindow

Pobiera określone okno.

HWND GetWindow(UINT nCmd) const throw();

Uwagi

Zobacz GetWindow w zestawie Windows SDK.

CWindow::GetWindowContextHelpId

Pobiera identyfikator kontekstu pomocy okna.

DWORD GetWindowContextHelpId() const throw();

Uwagi

Zobacz GetWindowContextHelpId w zestawie Windows SDK.

CWindow::GetWindowDC

Pobiera kontekst urządzenia dla całego okna.

HDC GetWindowDC() throw();

Uwagi

Zobacz GetWindowDC w zestawie Windows SDK.

Przykład

//The following example attaches an HWND to the CWindow object and 
//calls CWindow::GetWindowDC() to retrieve the DC of the entire window

CWindow myWindow;
myWindow.Attach(hWnd);
HDC hDC = myWindow.GetWindowDC();

CWindow::GetWindowLong

Pobiera wartość 32-bitową z określonym przesunięciem do dodatkowej pamięci okna.

LONG GetWindowLong(int nIndex) const throw();

Uwagi

Zobacz GetWindowLong w zestawie Windows SDK.

CWindow::GetWindowLongPtr

Pobiera informacje o określonym oknie, w tym wartość z określonym przesunięciem do dodatkowej pamięci okna.

LONG_PTR GetWindowLongPtr(int nIndex) const throw();

Uwagi

Aby uzyskać więcej informacji, zobacz GetWindowLongPtr w zestawie Windows SDK.

Jeśli pobierasz wskaźnik lub uchwyt, ta funkcja zastępuje metodę CWindow::GetWindowLong .

Aby napisać kod zgodny zarówno z 32-bitowymi, jak i 64-bitowymi wersjami systemu Windows, użyj polecenia CWindow::GetWindowLongPtr.

CWindow::GetWindowPlacement

Pobiera stan i pozycje pokazu.

BOOL GetWindowPlacement(WINDOWPLACEMENT FAR* lpwndpl) const throw();

Uwagi

Zobacz GetWindowPlacement w zestawie Windows SDK.

CWindow::GetWindowProcessID

Pobiera identyfikator procesu, który utworzył okno.

DWORD GetWindowProcessID() throw();

Uwagi

Zobacz GetWindowThreadProcessID w zestawie Windows SDK.

Przykład

//The following example attaches an HWND to the CWindow object and 
//calls CWindow::GetWindowProcessID() to retrieve the id of the 
//process that created the window

CWindow myWindow;
myWindow.Attach(hWnd);
DWORD dwID = myWindow.GetWindowProcessID();

CWindow::GetWindowRect

Pobiera wymiary ograniczenia okna.

BOOL GetWindowRect(LPRECT lpRect) const throw();

Uwagi

Zobacz GetWindowRect w zestawie Windows SDK.

CWindow::GetWindowRgn

Uzyskuje kopię obszaru okna okna.

int GetWindowRgn(HRGN hRgn) throw();

Uwagi

Zobacz GetWindowRgn w zestawie Windows SDK.

CWindow::GetWindowText

Pobiera tekst okna.

int GetWindowText(LPTSTR lpszStringBuf, int nMaxCount) const throw();
BOOL GetWindowText(BSTR& bstrText) throw();
int GetWindowText(CSimpleString& strText) const;

Parametry

lpszStringBuf
Bufor, do którego ma być zapisywany tekst okna.

nMaxCount
Rozmiar buforu w znakach; maksymalna liczba znaków do zapisania.

bstrText
Element BSTR , w którym ma być przechowywany tekst okna.

strText
Element CString , w którym ma być przechowywany tekst okna.

Wartość zwracana

Jeśli tekst zostanie pomyślnie skopiowany, zwracana wartość to TRUE; w przeciwnym razie zwracana wartość to FALSE.

Uwagi

Zobacz GetWindowText w zestawie Windows SDK.

Druga wersja tej metody umożliwia przechowywanie tekstu w obiekcie BSTR; trzecia wersja pozwala przechowywać wynik w elemecie , ponieważ CSimpleString jest klasą CStringbazową CStringklasy .

CWindow::GetWindowTextLength

Pobiera długość tekstu okna.

int GetWindowTextLength() const throw();

Uwagi

Zobacz GetWindowTextLength w zestawie Windows SDK.

CWindow::GetWindowThreadID

Pobiera identyfikator wątku, który utworzył określone okno.

DWORD GetWindowThreadID() throw();

Uwagi

Zobacz GetWindowThreadProcessID w zestawie Windows SDK.

Przykład

//The following example attaches an HWND to the CWindow object and 
//calls CWindow::GetWindowThreadID() to retrieve the id of the thread 
//that created the window

CWindow myWindow;
myWindow.Attach(hWnd);
DWORD dwID = myWindow.GetWindowThreadID();

CWindow::GetWindowWord

Pobiera 16-bitową wartość z określonym przesunięciem do dodatkowej pamięci okna.

WORD GetWindowWord(int nIndex) const throw();

Uwagi

Zobacz GetWindowLong w zestawie Windows SDK.

CWindow::GotoDlgCtrl

Ustawia fokus klawiatury na kontrolkę w oknie dialogowym.

void GotoDlgCtrl(HWND hWndCtrl) const throw();

Uwagi

Zobacz WM_NEXTDLGCTL w zestawie Windows SDK.

CWindow::HideCaret

Ukrywa daszek systemowy.

BOOL HideCaret() throw();

Uwagi

Zobacz HideCaret w zestawie Windows SDK.

Przykład

//The following example attaches an HWND to the CWindow object and 
//calls CWindow::HideCaret() to hide the caret of the window owning 
//the caret

CWindow myWindow;
myWindow.Attach(hWndEdit);
myWindow.HideCaret();

CWindow::HiliteMenuItem

Wyróżnia lub usuwa wyróżnienie z elementu menu najwyższego poziomu.

BOOL HiliteMenuItem(
    HMENU hMenu,
    UINT uHiliteItem,
    UINT uHilite) throw();

Uwagi

Zobacz HiliteMenuItem w zestawie Windows SDK.

CWindow::Invalidate

Unieważnia cały obszar klienta.

BOOL Invalidate(BOOL bErase = TRUE) throw();

Uwagi

Zobacz InvalidateRect w zestawie Windows SDK.

Przekazuje NULL parametr RECT do InvalidateRect funkcji Win32.

Przykład

//The following example attaches an HWND to the CWindow object and 
//calls CWindow::Invalidate() to invalidate the entire client area

CWindow myWindow;
myWindow.Attach(hWnd);
myWindow.Invalidate();

CWindow::InvalidateRect

Unieważnia obszar klienta w określonym prostokątze.

BOOL InvalidateRect(LPCRECT lpRect, BOOL bErase = TRUE) throw();

Uwagi

Zobacz InvalidateRect w zestawie Windows SDK.

CWindow::InvalidateRgn

Unieważnia obszar klienta w określonym regionie.

void InvalidateRgn(HRGN hRgn, BOOL bErase = TRUE) throw();

Uwagi

Aby uzyskać więcej informacji, zobacz InvalidateRgn w zestawie Windows SDK.

Określa typ zwracany void , a InvalidateRgn funkcja Win32 zawsze zwraca wartość TRUE.

CWindow::IsChild

Określa, czy określone okno jest oknem podrzędnym.

BOOL IsChild(const HWND hWnd) const throw();

Uwagi

Zobacz IsChild w zestawie Windows SDK.

CWindow::IsDialogMessage

Określa, czy komunikat jest przeznaczony dla określonego okna dialogowego.

BOOL IsDialogMessage(LPMSG lpMsg) throw();

Uwagi

Zobacz IsDialogMessage w zestawie Windows SDK.

CWindow::IsDlgButtonChecked

Określa stan sprawdzania przycisku.

UINT IsDlgButtonChecked(int nIDButton) const throw();

Uwagi

Zobacz IsDlgButtonChecked w zestawie Windows SDK.

CWindow::IsIconic

Określa, czy okno jest zminimalizowane.

BOOL IsIconic() const throw();

Uwagi

Zobacz IsIconic w zestawie Windows SDK.

Przykład

//The following example attaches an HWND to the CWindow object and 
//calls CWindow::IsIconic() to determine if the window is minimized

CWindow myWindow;
myWindow.Attach(hWnd);
BOOL bIconic = myWindow.IsIconic();

CWindow::IsParentDialog

Określa, czy nadrzędne okno kontrolki jest oknem dialogowym.

BOOL IsParentDialog() throw();

Wartość zwracana

Zwraca wartość TRUE , jeśli okno nadrzędne jest oknem dialogowym, FALSE w przeciwnym razie.

CWindow::IsWindow

Określa, czy określony uchwyt okna identyfikuje istniejące okno.

BOOL IsWindow() throw();

Uwagi

Zobacz IsWindow w zestawie Windows SDK.

Przykład

//The following example attaches an HWND to the CWindow object and 
//calls CWindow::IsWindow() to verify if the HWND corresponds 
//to an existing window

CWindow myWindow;
myWindow.Attach(hWnd);
BOOL bWindow = myWindow.IsWindow();

CWindow::IsWindowEnabled

Określa, czy okno jest włączone dla danych wejściowych.

BOOL IsWindowEnabled() const throw();

Uwagi

Zobacz IsWindowEnabled w zestawie Windows SDK.

Przykład

//The following example attaches an HWND to the CWindow object and 
//calls CWindow::IsWindowEnabled() to verify if the window is enabled 
//for receiving input

CWindow myWindow;
myWindow.Attach(hWnd);
BOOL bEnabled = myWindow.IsWindowEnabled();

CWindow::IsWindowVisible

Określa stan widoczności okna.

BOOL IsWindowVisible() const throw();

Uwagi

Zobacz IsWindowVisible w zestawie Windows SDK.

Przykład

//The following example attaches an HWND to the CWindow object and 
//calls CWindow::IsWindowVisible() to determine the visibility state 
//of the window

CWindow myWindow;
myWindow.Attach(hWnd);
BOOL bVisible = myWindow.IsWindowVisible();

CWindow::IsWindowUnicode

Określa, czy określone okno jest natywnym oknem Unicode.

BOOL IsWindowUnicode() throw();

Uwagi

Zobacz IsWindowUnicode w zestawie Windows SDK.

Przykład

//The following example attaches an HWND to the CWindow object and 
//calls CWindow::IsWindowUnicode() to determine if the window is a 
//UNICODE window or an ANSI one.

CWindow myWindow;
myWindow.Attach(hWnd);
BOOL bUnicode = myWindow.IsWindowUnicode();

CWindow::IsZoomed

Określa, czy okno jest zmaksymalizowane.

BOOL IsZoomed() const throw();

Uwagi

Zobacz IsZoomed w zestawie Windows SDK.

CWindow::KillTimer

Niszczy zdarzenie czasomierza utworzone przez CWindow::SetTimerprogram .

BOOL KillTimer(UINT nIDEvent) throw();

Uwagi

Zobacz KillTimer w zestawie Windows SDK.

CWindow::LockWindowUpdate

Wyłącza lub włącza rysowanie w oknie przez wywołanie LockWindowUpdate funkcji Win32.

BOOL LockWindowUpdate(BOOL bLock = TRUE) throw();

Parametry

bLock
[in] Jeśli TRUE (wartość domyślna), okno zostanie zablokowane. W przeciwnym razie zostanie odblokowany.

Wartość zwracana

TRUE jeśli okno zostało pomyślnie zablokowane; w przeciwnym razie, FALSE.

Uwagi

Jeśli bLock jest TRUEto , ta metoda przekazuje m_hWnd do funkcji Win32; w przeciwnym razie przekazuje NULL.

CWindow::m_hWnd

Zawiera uchwyt do okna skojarzonego z obiektem CWindow .

HWND m_hWnd throw() throw();

CWindow::MapWindowPoints

Konwertuje zestaw punktów z przestrzeni współrzędnej okna na przestrzeń współrzędną innego okna.

int MapWindowPoints(
    HWND hWndTo,
    LPPOINT lpPoint,
    UINT nCount) const throw();

int MapWindowPoints(
    HWND hWndTo,
    LPRECT lpRect) const throw();

Uwagi

Zobacz MapWindowPoints w zestawie Windows SDK.

Druga wersja tej metody umożliwia konwertowanie współrzędnych RECT struktury.

CWindow::MessageBox

Wyświetla okno komunikatu.

int MessageBox(
    LPCTSTR lpszText,
    LPCTSTR lpszCaption = NULL,
    UINT nType = MB_OK) throw();

Uwagi

Zobacz MessageBox w zestawie Windows SDK.

Przykład

//The following example attaches an HWND to the CWindow object and 
//calls CWindow::MessageBox() to pop up a Windows message box

CWindow myWindow;
myWindow.Attach(hWnd);
myWindow.MessageBox(_T("Hello World"));

CWindow::ModifyStyle

Modyfikuje style CWindow okna obiektu.

BOOL ModifyStyle(
    DWORD dwRemove,
    DWORD dwAdd,
    UINT nFlags = 0) throw();

Parametry

dwRemove
[in] Określa style okna, które mają zostać usunięte podczas modyfikowania stylu.

dwAdd
[in] Określa style okna, które mają zostać dodane podczas modyfikacji stylu.

nFlags
[in] Flagi pozycjonowania okien. Aby uzyskać listę możliwych wartości, zobacz SetWindowPos funkcję w zestawie Windows SDK.

Wartość zwracana

TRUE jeśli style okna są modyfikowane; w przeciwnym razie, FALSE.

Uwagi

Style do dodania lub usunięcia można połączyć za pomocą operatora bitowego "lub" (|). CreateWindow Zobacz funkcję w zestawie SDK systemu Windows, aby uzyskać informacje o dostępnych stylach okna.

Jeśli nFlags element jest niezerowy, ModifyStyle wywołuje funkcję SetWindowPosWin32 i ponownie rysuje okno, łącząc nFlags z następującymi czterema flagami:

• SWP_NOSIZE Zachowuje bieżący rozmiar.

• SWP_NOMOVE Zachowuje bieżące położenie.

• SWP_NOZORDER Zachowuje bieżącą kolejność Z.

• SWP_NOACTIVATE Nie aktywuje okna.

Aby zmodyfikować style rozszerzone okna, wywołaj metodę ModifyStyleEx.

Przykład

//The following example attaches an HWND to the CWindow object and 
//calls CWindow::ModifyStyle() to add and remove the window styles

CWindow myWindow;
myWindow.Attach(hWnd);

//The following line removes the WS_CLIPCHILDREN style from the 
//window and adds the WS_CAPTION style to the window
myWindow.ModifyStyle(WS_CLIPCHILDREN, WS_CAPTION);

CWindow::ModifyStyleEx

Modyfikuje rozszerzone style CWindow okna obiektu.

BOOL ModifyStyleEx(
    DWORD dwRemove,
    DWORD dwAdd,
    UINT nFlags = 0) throw();

Parametry

dwRemove
[in] Określa style rozszerzone do usunięcia podczas modyfikacji stylu.

dwAdd
[in] Określa style rozszerzone, które mają być dodawane podczas modyfikowania stylu.

nFlags
[in] Flagi pozycjonowania okien. Aby uzyskać listę możliwych wartości, zobacz SetWindowPos funkcję w zestawie Windows SDK.

Wartość zwracana

TRUE jeśli style rozszerzonego okna są modyfikowane; w przeciwnym razie, FALSE.

Uwagi

Style do dodania lub usunięcia można połączyć za pomocą operatora bitowego "lub" (|). CreateWindowEx Zobacz funkcję w zestawie Windows SDK, aby uzyskać informacje o dostępnych stylach rozszerzonych.

Jeśli nFlags element jest niezerowy, ModifyStyleEx wywołuje funkcję SetWindowPosWin32 i ponownie rysuje okno, łącząc nFlags z następującymi czterema flagami:

• SWP_NOSIZE Zachowuje bieżący rozmiar.

• SWP_NOMOVE Zachowuje bieżące położenie.

• SWP_NOZORDER Zachowuje bieżącą kolejność Z.

• SWP_NOACTIVATE Nie aktywuje okna.

Aby zmodyfikować okna przy użyciu zwykłych stylów okien, wywołaj metodę ModifyStyle.

Przykład

//The following example attaches an HWND to the CWindow object and 
//calls CWindow::ModifyStyleEx() to add and remove the extended 
//window styles

CWindow myWindow;
myWindow.Attach(hWnd);

//The following line removes WS_EX_CONTEXTHELP extended style from 
//the window and adds WS_EX_TOOLWINDOW extended style to the window 

myWindow.ModifyStyleEx(WS_EX_CONTEXTHELP, WS_EX_TOOLWINDOW);

CWindow::MoveWindow

Zmienia rozmiar i położenie okna.

BOOL MoveWindow(
    int x,
    int y,
    int nWidth,
    int nHeight,
    BOOL bRepaint = TRUE) throw();

BOOL MoveWindow(
    LPCRECT lpRect,
    BOOL bRepaint = TRUE) throw();

Uwagi

W przypadku obiektu x okna najwyższego poziomu parametry i y są względne względem lewego górnego rogu ekranu. W przypadku obiektu okna podrzędnego są one względne względem lewego górnego rogu obszaru klienta okna nadrzędnego.

Druga wersja tej metody używa RECT struktury do określenia nowej pozycji, szerokości i wysokości okna.

CWindow::NextDlgCtrl

Ustawia fokus klawiatury na następną kontrolkę w oknie dialogowym.

void NextDlgCtrl() const throw();

Uwagi

Zobacz WM_NEXTDLGCTL w zestawie Windows SDK.

CWindow::OpenClipboard

Otwiera Schowek.

BOOL OpenClipboard() throw();

Uwagi

Zobacz OpenClipboard w zestawie Windows SDK.

CWindow::operator HWND

Konwertuje CWindow obiekt na HWNDobiekt .

operator HWND() const throw();

CWindow::operator =

Przypisuje obiekt HWND do CWindow obiektu, ustawiając element członkowski na .hWndm_hWnd

CWindow& operator= (HWND hWnd) throw();

CWindow::PostMessage

Umieszcza komunikat w kolejce komunikatów skojarzony z wątkiem, który utworzył okno.

BOOL PostMessage(
    UINT message,
    WPARAM wParam = 0,
    LPARAM lParam = 0) throw();

Uwagi

Zobacz PostMessage w zestawie Windows SDK.

Zwraca wartość bez oczekiwania na przetworzenie komunikatu przez wątek.

Przykład

//The following example attaches an HWND to the CWindow object and 
//posts a WM_PAINT message to the Window wrapped by the CWindow object 
//using CWindow::PostMessage() with the default values of WPARAM and 
//LPARAM

CWindow myWindow;
myWindow.Attach(hWnd);
myWindow.PostMessage(WM_PAINT);

CWindow::PrevDlgCtrl

Ustawia fokus klawiatury na poprzednią kontrolkę w oknie dialogowym.

void PrevDlgCtrl() const throw();

Uwagi

Zobacz WM_NEXTDLGCTL w zestawie Windows SDK.

CWindow::Print

WM_PRINT Wysyła komunikat do okna, aby zażądać, aby narysowała się w określonym kontekście urządzenia.

void Print(HDC hDC, DWORD dwFlags) const throw();

Parametry

hDC
[in] Dojście do kontekstu urządzenia.

dwFlags
[in] Określa opcje rysunku. Można połączyć co najmniej jedną z następujących flag:

• PRF_CHECKVISIBLE Rysuj okno tylko wtedy, gdy jest widoczne.

• PRF_CHILDREN Rysuj wszystkie widoczne okna podrzędne.

• PRF_CLIENT Rysuj obszar klienta okna.

• PRF_ERASEBKGND Wymazywanie tła przed rysowaniem okna.

• PRF_NONCLIENT Rysuj obszar niekliencki okna.

• PRF_OWNED Rysuj wszystkie okna należące do użytkownika.

CWindow::PrintClient

WM_PRINTCLIENT Wysyła komunikat do okna, aby zażądać, aby narysować obszar klienta w określonym kontekście urządzenia.

void PrintClient(HDC hDC, DWORD dwFlags) const throw();

Parametry

hDC
[in] Dojście do kontekstu urządzenia.

dwFlags
[in] Określa opcje rysunku. Można połączyć co najmniej jedną z następujących flag:

• PRF_CHECKVISIBLE Rysuj okno tylko wtedy, gdy jest widoczne.

• PRF_CHILDREN Rysuj wszystkie widoczne okna podrzędne.

• PRF_CLIENT Rysuj obszar klienta okna.

• PRF_ERASEBKGND Wymazywanie tła przed rysowaniem okna.

• PRF_NONCLIENT Rysuj obszar niekliencki okna.

• PRF_OWNED Rysuj wszystkie okna należące do użytkownika.

CWindow::rcDefault

Zawiera domyślne wymiary okna.

static RECT rcDefault;

CWindow::RedrawWindow

Aktualizuje określony prostokąt lub region w obszarze klienta.

BOOL RedrawWindow(
    LPCRECT lpRectUpdate = NULL,
    HRGN hRgnUpdate = NULL,
    UINT flags = RDW_INVALIDATE | RDW_UPDATENOW | RDW_ERASE);

throw()

Uwagi

Zobacz RedrawWindow w zestawie Windows SDK.

Przykład

//The following example attaches an HWND to the CWindow object and 
//calls CWindow::RedrawWindow() to update the entire window using the 
//default arguments

CWindow myWindow;
myWindow.Attach(hWnd);
BOOL bRedrawn = myWindow.RedrawWindow();

CWindow::ReleaseDC

Zwalnia kontekst urządzenia.

int ReleaseDC(HDC hDC);

Uwagi

Zobacz ReleaseDC w zestawie Windows SDK.

Przykład

// The following example attaches a HWND to the CWindow object,
// calls CWindow::GetDC to retrieve the DC of the client
// area of the window wrapped by CWindow Object, and calls
// CWindow::ReleaseDC to release the DC. 

CWindow myWindow;
myWindow.Attach(hWnd);   
HDC hDC = myWindow.GetDC();

// Use the DC

myWindow.ReleaseDC(hDC);
hDC = NULL;

CWindow::ResizeClient

Zmienia rozmiar okna na określony rozmiar obszaru klienta.

BOOL ResizeClient(
    int nWidth,
    int nHeight,
    BOOL bRedraw = FALSE) throw();

Parametry

nWidth
Nowa szerokość okna w pikselach.

nHeight
Nowa wysokość okna w pikselach.

bRedraw
Flaga wskazująca, czy zmiany mają być ponownie rysowane. Wartość domyślna to FALSE, co wskazuje, że okno nie powoduje ponownego rysowania zmian.

CWindow::ScreenToClient

Konwertuje współrzędne ekranu na współrzędne klienta.

BOOL ScreenToClient(LPPOINT lpPoint) const throw();
BOOL ScreenToClient(LPRECT lpRect) const throw();

Uwagi

Zobacz ScreenToClient w zestawie Windows SDK.

Druga wersja tej metody umożliwia konwertowanie współrzędnych RECT struktury.

CWindow::ScrollWindow

Przewija określony obszar klienta.

BOOL ScrollWindow(
    int xAmount,
    int yAmount,
    LPCRECT lpRect = NULL,
    LPCRECT lpClipRect = NULL) throw();

Uwagi

Zobacz ScrollWindow w zestawie Windows SDK.

CWindow::ScrollWindowEx

Przewija określony obszar klienta z dodatkowymi funkcjami.

int ScrollWindowEx(
    int dx,
    int dy,
    LPCRECT lpRectScroll,
    LPCRECT lpRectClip,
    HRGN hRgnUpdate,
    LPRECT lpRectUpdate,
    UINT flags) throw();

Uwagi

Zobacz ScrollWindowEx w zestawie Windows SDK.

CWindow::SendDlgItemMessage

Wysyła komunikat do kontrolki.

LRESULT SendDlgItemMessage(
    int nID,
    UINT message,
    WPARAM wParam = 0,
    LPARAM lParam = 0) throw();

Uwagi

Zobacz SendDlgItemMessage w zestawie Windows SDK.

CWindow::SendMessage

Wysyła komunikat do okna i nie zwraca się do momentu przetworzenia komunikatu przez procedurę okna.

LRESULT SendMessage(
    UINT message,
    WPARAM wParam = 0,
    LPARAM lParam = 0) throw();

static LRESULT SendMessage(
    HWND hWnd,
    UINT message,
    WPARAM wParam,
    LPARAM lParam) throw();

Uwagi

Zobacz SendMessage w zestawie Windows SDK.

Przykład

// The following example attaches a HWND to the CWindow
// object and sends a WM_PAINT message to the window
// wrapped by CWindow object using CWindow::SendMessage.

CWindow myWindow;
myWindow.Attach(hWnd);   
myWindow.SendMessage(WM_PAINT, 0L, 0L);

CWindow::SendMessageToDescendants

Wysyła określony komunikat do wszystkich natychmiastowych elementów podrzędnych CWindow obiektu.

void SendMessageToDescendants(
    UINT message,
    WPARAM wParam = 0,
    LPARAM lParam = 0,
    BOOL bDeep = TRUE) throw();

Parametry

message
[in] Wiadomość do wysłania.

wParam
[in] Dodatkowe informacje specyficzne dla komunikatów.

lParam
[in] Dodatkowe informacje specyficzne dla komunikatów.

bDeep
[in] Jeśli TRUE (wartość domyślna), wiadomość zostanie wysłana do wszystkich okien podrzędnych; w przeciwnym razie zostanie ona wysłana tylko do natychmiastowych okien podrzędnych.

Uwagi

Jeśli bDeep parametr to TRUE, komunikat jest dodatkowo wysyłany do wszystkich innych okien elementów potomnych.

CWindow::SendNotifyMessage

Wysyła wiadomość do okna.

BOOL SendNotifyMessage(
    UINT message,
    WPARAM wParam = 0,
    LPARAM lParam = 0) throw();

Uwagi

Zobacz SendNotifyMessage w zestawie Windows SDK.

Jeśli okno zostało utworzone przez wątek wywołujący, SendNotifyMessage nie zwraca się do momentu przetworzenia komunikatu przez procedurę okna. W przeciwnym razie zwraca natychmiast.

CWindow::SetActiveWindow

Aktywuje okno.

HWND SetActiveWindow() throw();

Uwagi

Zobacz SetActiveWindow w zestawie Windows SDK.

Przykład

// The following example attaches a HWND to the CWindow object
// and sets the window as an active window by calling 
// CWindow::SetActiveWindow which returns the HWND of the
// previously active window.

CWindow myWindow;
myWindow.Attach(hWnd);   
HWND hWndPrev = myWindow.SetActiveWindow();

CWindow::SetCapture

Wysyła wszystkie kolejne dane wejściowe myszy do okna.

HWND SetCapture() throw();

Uwagi

Zobacz SetCapture w zestawie Windows SDK.

CWindow::SetClipboardViewer

Dodaje okno do łańcucha przeglądarki Schowka.

HWND SetClipboardViewer() throw();

Uwagi

Zobacz SetClipboardViewer w zestawie Windows SDK.

CWindow::SetDlgCtrlID

Ustawia identyfikator okna na określoną wartość.

int SetDlgCtrlID(int nID) throw();

Parametry

nID
[in] Nowa wartość ustawiona dla identyfikatora okna.

Wartość zwracana

Jeśli to się powiedzie, poprzedni identyfikator okna; w przeciwnym razie 0.

CWindow::SetDlgItemInt

Zmienia tekst kontrolki na ciąg reprezentujący wartość całkowitą.

BOOL SetDlgItemInt(
    int nID,
    UINT nValue,
    BOOL bSigned = TRUE) throw();

Uwagi

Zobacz SetDlgItemInt w zestawie Windows SDK.

CWindow::SetDlgItemText

Zmienia tekst kontrolki.

BOOL SetDlgItemText(int nID, LPCTSTR lpszString) throw();

Uwagi

Zobacz SetDlgItemText w zestawie Windows SDK.

CWindow::SetFocus

Ustawia fokus danych wejściowych na okno.

HWND SetFocus() throw();

Uwagi

Zobacz SetFocus w zestawie Windows SDK.

Przykład

//The following example attaches an HWND to the CWindow object and 
//calls CWindow::SetFocus() to set the input focus

CWindow myWindow;
myWindow.Attach(hWnd);
HWND hWndLeftFocus = myWindow.SetFocus();

CWindow::SetFont

Zmienia bieżącą czcionkę WM_SETFONT okna, wysyłając komunikat do okna.

void SetFont(HFONT hFont, BOOL bRedraw = TRUE) throw();

Parametry

hFont
[in] Uchwyt nowej czcionki.

bRedraw
[in] Jeśli TRUE (wartość domyślna), okno zostanie ponownie wyrysowane. W przeciwnym razie nie jest.

CWindow::SetHotKey

Kojarzy klucz gorący z oknem WM_SETHOTKEY , wysyłając komunikat.

int SetHotKey(WORD wVirtualKeyCode, WORD wModifiers) throw();

Parametry

wVirtualKeyCode
[in] Kod klucza wirtualnego klucza gorącego. Aby uzyskać listę standardowych kodów kluczy wirtualnych, zobacz Winuser.h.

wModifiers
[in] Modyfikatory klucza gorącego. Aby uzyskać listę możliwych wartości, zobacz WM_SETHOTKEY w zestawie Windows SDK.

Wartość zwracana

Aby uzyskać listę możliwych wartości zwracanych, zobacz WM_SETHOTKEY w zestawie Windows SDK.

CWindow::SetIcon

Ustawia dużą lub małą ikonę okna na ikonę zidentyfikowaną przez hIcon.

HICON SetIcon(HICON hIcon, BOOL bBigIcon = TRUE) throw();

Parametry

hIcon
[in] Uchwyt do nowej ikony.

bBigIcon
[in] Jeśli TRUE (wartość domyślna), metoda ustawia dużą ikonę. W przeciwnym razie ustawia małą ikonę.

Wartość zwracana

Uchwyt poprzedniej ikony.

Uwagi

SetIconWM_SETICON wysyła wiadomość do okna.

CWindow::SetMenu

Zmienia bieżące menu okna.

BOOL SetMenu(HMENU hMenu) throw();

Uwagi

Zobacz SetMenu w zestawie Windows SDK.

CWindow::SetParent

Zmienia okno nadrzędne.

HWND SetParent(HWND hWndNewParent) throw();

Uwagi

Zobacz SetParent w zestawie Windows SDK.

Przykład

// The following example attaches a HWND to the CWindow object
// and sets the hWndParent as the parent window of the 
// window wrapped by CWindow object using CWindow::SetParent.

CWindow myWindow;
myWindow.Attach(hWndChild);
HWND hWndPrevParent = myWindow.SetParent(hWndParent);

CWindow::SetRedraw

Ustawia lub czyści flagę WM_SETREDRAW ponownego rysowania, wysyłając komunikat do okna.

void SetRedraw(BOOL bRedraw = TRUE) throw();

Parametry

bRedraw
[in] Określa stan flagi redraw. Jeśli TRUE (wartość domyślna), zostanie ustawiona flaga ponownego rysowania; jeśli FALSEflaga zostanie wyczyszczone.

Uwagi

Wywołaj polecenie SetRedraw , aby zezwolić na ponowne rysowanie zmian lub uniemożliwić ponowne rysowanie zmian.

Przykład

//The following example attaches an HWND to the CWindow object and 
//calls CWindow::SetRedraw() to set and reset the redraw flag

CWindow myWindow;
myWindow.Attach(hWnd);
myWindow.SetRedraw();      //sets the redraw flag to TRUE
//
//
myWindow.SetRedraw(FALSE); //sets the redraw flag to FALSE

CWindow::SetScrollInfo

Ustawia parametry paska przewijania.

int SetScrollInfo(
    int nBar,
    LPSCROLLINFO lpScrollInfo,
    BOOL bRedraw = TRUE) throw();

Uwagi

Zobacz SetScrollInfo w zestawie Windows SDK.

CWindow::SetScrollPos

Zmienia położenie pola przewijania.

int SetScrollPos(
    int nBar,
    int nPos,
    BOOL bRedraw = TRUE) throw();

Uwagi

Zobacz SetScrollPos w zestawie Windows SDK.

CWindow::SetScrollRange

Zmienia zakres pasków przewijania.

BOOL SetScrollRange(
    int nBar,
    int nMinPos,
    int nMaxPos,
    BOOL bRedraw = TRUE) throw();

Uwagi

Zobacz SetScrollRange w zestawie Windows SDK.

CWindow::SetTimer

Tworzy zdarzenie czasomierza.

UINT SetTimer(
    UINT nIDEvent,
    UINT nElapse,
    void (CALLBACK* lpfnTimer)(HWND, UINT, UINT, DWORD) = NULL) throw();

Uwagi

Zobacz SetTimer w zestawie Windows SDK.

CWindow::SetWindowContextHelpId

Ustawia identyfikator kontekstu pomocy okna.

BOOL SetWindowContextHelpId(DWORD dwContextHelpId) throw();

Uwagi

Zobacz SetWindowContextHelpId w zestawie Windows SDK.

CWindow::SetWindowLong

Ustawia wartość 32-bitową na określonym przesunięcie do dodatkowej pamięci okna.

LONG SetWindowLong(int nIndex, LONG dwNewLong) throw();

Uwagi

Zobacz SetWindowLong w zestawie Windows SDK.

CWindow::SetWindowLongPtr

Zmienia atrybut określonego okna, a także ustawia wartość z określonym przesunięciem w dodatkowej pamięci okna.

LONG_PTR SetWindowLongPtr(int nIndex, LONG_PTR dwNewLong) throw();

Uwagi

Zobacz SetWindowLongPtr w zestawie Windows SDK.

Ta funkcja zastępuje metodę CWindow::SetWindowLong . Aby napisać kod zgodny zarówno z 32-bitowymi, jak i 64-bitowymi wersjami systemu Windows, użyj polecenia CWindow::SetWindowLongPtr.

CWindow::SetWindowPlacement

Ustawia stan i pozycje show.

BOOL SetWindowPlacement(const WINDOWPLACEMENT FAR* lpwndpl);

Uwagi

Zobacz SetWindowPlacement w zestawie Windows SDK.

CWindow::SetWindowPos

Ustawia rozmiar, położenie i kolejność Z.

BOOL SetWindowPos(
    HWND hWndInsertAfter,
    int x,
    int y,
    int cx,
    int cy,
    UINT nFlags) throw();

BOOL SetWindowPos(
    HWND hWndInsertAfter,
    LPCRECT lpRect,
    UINT nFlags) throw();

Uwagi

Zobacz SetWindowPos w zestawie Windows SDK.

Druga wersja tej metody używa RECT struktury do ustawiania nowej pozycji, szerokości i wysokości okna.

CWindow::SetWindowRgn

Ustawia region okna okna.

int SetWindowRgn(HRGN hRgn, BOOL bRedraw = FALSE) throw();

Uwagi

Zobacz SetWindowRgn w zestawie Windows SDK.

CWindow::SetWindowText

Zmienia tekst okna.

BOOL SetWindowText(LPCTSTR lpszString) throw();

Uwagi

Zobacz SetWindowText w zestawie Windows SDK.

Przykład

//The following example attaches an HWND to the CWindow object and 
//calls CWindow::SetWindowText() to set the new title-text of the 
//window

CWindow myWindow;
myWindow.Attach(hWnd);
myWindow.SetWindowText(_T("Hello ATL"));

CWindow::SetWindowWord

Ustawia wartość 16-bitową na określonym przesunięcie do dodatkowej pamięci okna.

WORD SetWindowWord(int nIndex, WORD wNewWord) throw();

Uwagi

Zobacz SetWindowLong w zestawie Windows SDK.

CWindow::ShowCaret

Wyświetla daszek systemowy.

BOOL ShowCaret() throw();

Uwagi

Zobacz ShowCaret w zestawie Windows SDK.

Przykład

//The following example attaches an HWND to the CWindow object and 
//calls CWindow::ShowCaret() to show the caret

CWindow myWindow;
myWindow.Attach(hWnd);
myWindow.ShowCaret();

CWindow::ShowOwnedPopups

Wyświetla lub ukrywa wyskakujące okna należące do okna.

BOOL ShowOwnedPopups(BOOL bShow = TRUE) throw();

Uwagi

Zobacz ShowOwnedPopups w zestawie Windows SDK.

CWindow::ShowScrollBar

Wyświetla lub ukrywa pasek przewijania.

BOOL ShowScrollBar(UINT nBar, BOOL bShow = TRUE) throw();

Uwagi

Zobacz ShowScrollBar w zestawie Windows SDK.

CWindow::ShowWindow

Ustawia stan pokazywania okna.

BOOL ShowWindow(int nCmdShow) throw();

Uwagi

Zobacz ShowWindow w zestawie Windows SDK.

Przykład

//The following example attaches an HWND to the CWindow object and 
//calls CWindow::ShowWindow() to show the window in its maximized state

CWindow myWindow;
myWindow.Attach(hWnd);
myWindow.ShowWindow(SW_SHOWMAXIMIZED);

CWindow::ShowWindowAsync

Ustawia stan wyświetlania okna utworzonego przez inny wątek.

BOOL ShowWindowAsync(int nCmdShow) throw();

Uwagi

Zobacz ShowWindowAsync w zestawie Windows SDK.

CWindow::UpdateWindow

Aktualizuje obszar klienta.

BOOL UpdateWindow() throw();

Uwagi

Zobacz UpdateWindow w zestawie Windows SDK.

Przykład

//The following example attaches an HWND to the CWindow object and 
//calls CWindow::UpdateWindow() to update the window

CWindow myWindow;
myWindow.Attach(hWnd);
BOOL bUpdated = myWindow.UpdateWindow();

CWindow::ValidateRect

Sprawdza poprawność obszaru klienta w określonym prostokątze.

BOOL ValidateRect(LPCRECT lpRect) throw();

Uwagi

Zobacz ValidateRect w zestawie Windows SDK.

CWindow::ValidateRgn

Sprawdza poprawność obszaru klienta w określonym regionie.

BOOL ValidateRgn(HRGN hRgn) throw();

Uwagi

Zobacz ValidateRgn w zestawie Windows SDK.

CWindow::WinHelp

Uruchamia Pomoc systemu Windows.

BOOL WinHelp(
    LPCTSTR lpszHelp,
    UINT nCmd = HELP_CONTEXT,
    DWORD dwData = 0) throw();

Uwagi

Zobacz WinHelp w zestawie Windows SDK.

Zobacz też

Omówienie klasy