Classe `CWindow`

Artigo
04/03/2023

Essa classe fornece métodos para manipular uma janela.

Importante

Essa classe e os respectivos membros não podem ser usados em aplicativos executados no Windows Runtime.

Sintaxe

class CWindow

Membros

Construtores públicos

Nome	Descrição
`CWindow::CWindow`	Construtor.

Métodos públicos

Nome	Descrição
`CWindow::ArrangeIconicWindows`	Organiza todas as janelas filho minimizadas.
`CWindow::Attach`	Anexa uma janela ao objeto `CWindow`.
`CWindow::BeginPaint`	Prepara a janela para pintura.
`CWindow::BringWindowToTop`	Traz a janela para a parte superior da ordem Z.
`CWindow::CenterWindow`	Centraliza a janela em uma determinada janela.
`CWindow::ChangeClipboardChain`	Remove a janela da cadeia de visualizadores da Área de Transferência.
`CWindow::CheckDlgButton`	Altera o estado de verificação do botão especificado.
`CWindow::CheckRadioButton`	Verifica o botão de opção especificado.
`CWindow::ChildWindowFromPoint`	Recupera a janela filho que contém o ponto especificado.
`CWindow::ChildWindowFromPointEx`	Recupera um tipo específico de janela filho que contém o ponto especificado.
`CWindow::ClientToScreen`	Converte as coordenadas do cliente em coordenadas da tela.
`CWindow::Create`	Cria uma janela.
`CWindow::CreateCaret`	Cria uma nova forma para o cursor do sistema.
`CWindow::CreateGrayCaret`	Cria um retângulo cinza para o cursor do sistema.
`CWindow::CreateSolidCaret`	Cria um retângulo sólido para o cursor do sistema.
`CWindow::DeferWindowPos`	Atualiza a estrutura de posição de várias janelas especificada para a janela especificada.
`CWindow::DestroyWindow`	Destrói a janela associada ao objeto `CWindow`.
`CWindow::Detach`	Desanexa a janela do objeto `CWindow`.
`CWindow::DlgDirList`	Preenche uma caixa de listagem com os nomes de todos os arquivos que correspondem a um caminho ou nome de arquivo especificado.
`CWindow::DlgDirListComboBox`	Preenche uma caixa de combinação com os nomes de todos os arquivos que correspondem a um caminho ou nome de arquivo especificado.
`CWindow::DlgDirSelect`	Recupera a seleção atual de uma caixa de listagem.
`CWindow::DlgDirSelectComboBox`	Recupera a seleção atual de uma caixa de combinação.
`CWindow::DragAcceptFiles`	Registra se a janela aceita arquivos arrastados.
`CWindow::DrawMenuBar`	Redesenha a barra de menus da janela.
`CWindow::EnableScrollBar`	Habilita ou desabilita as setas da barra de rolagem.
`CWindow::EnableWindow`	Habilita ou desabilita a entrada.
`CWindow::EndPaint`	Marca o fim da pintura.
`CWindow::FlashWindow`	Pisca a janela uma vez.
`CWindow::GetClientRect`	Recupera as coordenadas da área de cliente.
`CWindow::GetDC`	Recupera um contexto de dispositivo para a área de cliente.
`CWindow::GetDCEx`	Recupera um contexto de dispositivo para a área de cliente e permite as opções de recorte.
`CWindow::GetDescendantWindow`	Recupera a janela descendente especificada.
`CWindow::GetDlgControl`	Recupera uma interface no controle especificado.
`CWindow::GetDlgCtrlID`	Recupera o identificador da janela (somente para janelas filhas).
`CWindow::GetDlgHost`	Recupera um ponteiro para uma interface para o contêiner de hospedagem do Controle do ATL.
`CWindow::GetDlgItem`	Recupera a janela filho especificada.
`CWindow::GetDlgItemInt`	Traduz o texto de um controle para um inteiro.
`CWindow::GetDlgItemText`	Recupera o texto de um controle.
`CWindow::GetExStyle`	Recupera os estilos de janela estendidos.
`CWindow::GetFont`	Recupera a fonte atual da janela.
`CWindow::GetHotKey`	Determina a tecla de acesso associada à janela.
`CWindow::GetIcon`	Recupera o ícone grande ou pequeno da janela.
`CWindow::GetLastActivePopup`	Recupera a janela pop-up ativa mais recentemente.
`CWindow::GetMenu`	Recupera o menu da janela.
`CWindow::GetNextDlgGroupItem`	Recupera o controle anterior ou próximo dentro de um grupo de controles.
`CWindow::GetNextDlgTabItem`	Recupera o controle anterior ou próximo com o estilo `WS_TABSTOP`.
`CWindow::GetParent`	Recupera a janela pai imediata.
`CWindow::GetScrollInfo`	Recupera os parâmetros de uma barra de rolagem.
`CWindow::GetScrollPos`	Recupera a posição da caixa de rolagem.
`CWindow::GetScrollRange`	Recupera o intervalo de barras de rolagem.
`CWindow::GetStyle`	Recupera os estilos de janela.
`CWindow::GetSystemMenu`	Cria uma cópia do menu de sistema para modificação.
`CWindow::GetTopLevelParent`	Recupera a janela proprietária ou pai de nível superior.
`CWindow::GetTopLevelWindow`	Recupera a janela proprietária de nível superior.
`CWindow::GetTopWindow`	Recupera a janela filho de nível superior.
`CWindow::GetUpdateRect`	Recupera as coordenadas do menor retângulo que envolve completamente a região de atualização.
`CWindow::GetUpdateRgn`	Recupera a região de atualização e a copia em uma região especificada.
`CWindow::GetWindow`	Recupera a janela especificada.
`CWindow::GetWindowContextHelpId`	Recupera o identificador de contexto de ajuda da janela.
`CWindow::GetWindowDC`	Recupera um contexto de dispositivo para a janela inteira.
`CWindow::GetWindowLong`	Recupera um valor de 32 bits em um deslocamento especificado na memória de janela adicional.
`CWindow::GetWindowLongPtr`	Recupera as informações sobre a janela especificada, incluindo um valor em um deslocamento especificado na memória de janela adicional.
`CWindow::GetWindowPlacement`	Recupera o estado de exibição e as posições.
`CWindow::GetWindowProcessID`	Recupera o identificador do processo que criou a janela.
`CWindow::GetWindowRect`	Recupera as dimensões delimitadoras da janela.
`CWindow::GetWindowRgn`	Obtém uma cópia da região de janela de uma janela.
`CWindow::GetWindowText`	Recupera o texto da janela.
`CWindow::GetWindowTextLength`	Recupera o comprimento do texto da janela.
`CWindow::GetWindowThreadID`	Recupera o identificador do thread que criou a janela especificada.
`CWindow::GetWindowWord`	Recupera um valor de 16 bits em um deslocamento especificado na memória de janela adicional.
`CWindow::GotoDlgCtrl`	Define o foco do teclado para um controle na caixa de diálogo.
`CWindow::HideCaret`	Oculta o cursor do sistema.
`CWindow::HiliteMenuItem`	Realça ou remove o realce de um item de menu de nível superior.
`CWindow::Invalidate`	Invalida toda a área de cliente.
`CWindow::InvalidateRect`	Invalida a área de cliente dentro do retângulo especificado.
`CWindow::InvalidateRgn`	Invalida a área de cliente dentro da região especificada.
`CWindow::IsChild`	Determina se a janela especificada é uma janela filho.
`CWindow::IsDialogMessage`	Determina se uma mensagem é destinada à caixa de diálogo especificada.
`CWindow::IsDlgButtonChecked`	Determina o estado de verificação do botão.
`CWindow::IsIconic`	Determina se a janela é minimizada.
`CWindow::IsParentDialog`	Determina se a janela pai de um controle é uma janela de diálogo.
`CWindow::IsWindow`	Determina se o identificador de janela especificado identifica uma janela existente.
`CWindow::IsWindowEnabled`	Determina se a janela está habilitada para entrada.
`CWindow::IsWindowUnicode`	Determina se a janela especificada é uma janela Unicode nativa.
`CWindow::IsWindowVisible`	Determina o estado de visibilidade da janela.
`CWindow::IsZoomed`	Determina se a janela é maximizada.
`CWindow::KillTimer`	Destrói um evento de temporizador.
`CWindow::LockWindowUpdate`	Desabilita ou habilita o desenho na janela.
`CWindow::MapWindowPoints`	Converte um conjunto de pontos do espaço de coordenadas da janela para o espaço de coordenadas de outra janela.
`CWindow::MessageBox`	Mostra uma caixa de mensagem.
`CWindow::ModifyStyle`	Modifica os estilos de janela.
`CWindow::ModifyStyleEx`	Modifica os estilos de janela estendidos.
`CWindow::MoveWindow`	Altera o tamanho e a posição da janela.
`CWindow::NextDlgCtrl`	Define o foco do teclado para o próximo controle na caixa de diálogo.
`CWindow::OpenClipboard`	Abre a Área de Transferência.
`CWindow::PostMessage`	Coloca uma mensagem na fila de mensagens associada ao thread que criou a janela. Retorna sem esperar que o thread processe a mensagem.
`CWindow::PrevDlgCtrl`	Define o foco do teclado para o controle anterior na caixa de diálogo.
`CWindow::Print`	Solicita que a janela seja desenhada em um contexto de dispositivo especificado.
`CWindow::PrintClient`	Solicita que a área de cliente da janela seja desenhada em um contexto de dispositivo especificado.
`CWindow::RedrawWindow`	Atualiza um retângulo ou região especificado na área de cliente.
`CWindow::ReleaseDC`	Libera um contexto de dispositivo.
`CWindow::ResizeClient`	Redimensiona a janela.
`CWindow::ScreenToClient`	Converte as coordenadas da tela em coordenadas do cliente.
`CWindow::ScrollWindow`	Rola a área de cliente especificada.
`CWindow::ScrollWindowEx`	Rola a área de cliente especificada com recursos adicionais.
`CWindow::SendDlgItemMessage`	Envia uma mensagem para um controle.
`CWindow::SendMessage`	Envia uma mensagem para a janela e não retornará até que o procedimento da janela tenha processado a mensagem.
`CWindow::SendMessageToDescendants`	Envia uma mensagem para as janelas descendentes especificadas.
`CWindow::SendNotifyMessage`	Envia uma mensagem para a janela. Se a janela foi criada pelo thread de chamada, `SendNotifyMessage` não retornará até que o procedimento da janela tenha processado a mensagem. Caso contrário, retornará imediatamente.
`CWindow::SetActiveWindow`	Ativa a janela.
`CWindow::SetCapture`	Envia todas as entradas de mouse subsequentes para a janela.
`CWindow::SetClipboardViewer`	Adiciona a janela à cadeia do visualizador da Área de Transferência.
`CWindow::SetDlgCtrlID`	Altera o identificador da janela.
`CWindow::SetDlgItemInt`	Altera o texto de um controle para a representação de cadeia de caracteres de um valor inteiro.
`CWindow::SetDlgItemText`	Altera o texto de um controle.
`CWindow::SetFocus`	Define o foco de entrada para a janela.
`CWindow::SetFont`	Altera a fonte atual da janela.
`CWindow::SetHotKey`	Associa uma tecla de acesso à janela.
`CWindow::SetIcon`	Altera o ícone grande ou o pequeno da janela.
`CWindow::SetMenu`	Altera o menu atual da janela.
`CWindow::SetParent`	Altera a janela pai.
`CWindow::SetRedraw`	Define ou limpa o sinalizador de redesenhar.
`CWindow::SetScrollInfo`	Define os parâmetros de uma barra de rolagem.
`CWindow::SetScrollPos`	Altera a posição da caixa de rolagem.
`CWindow::SetScrollRange`	Altera o intervalo da barra de rolagem.
`CWindow::SetTimer`	Cria um evento de temporizador.
`CWindow::SetWindowContextHelpId`	Define o identificador de contexto de ajuda da janela.
`CWindow::SetWindowLong`	Define um valor de 32 bits em um deslocamento especificado na memória de janela adicional.
`CWindow::SetWindowLongPtr`	Altera um atributo da janela especificada e também define um valor no deslocamento especificado na memória da janela adicional.
`CWindow::SetWindowPlacement`	Define o estado de apresentação e as posições.
`CWindow::SetWindowPos`	Define o tamanho, a posição e a ordem Z.
`CWindow::SetWindowRgn`	Define a região da janela de uma janela.
`CWindow::SetWindowText`	Altera o texto da janela.
`CWindow::SetWindowWord`	Define um valor de 16 bits em um deslocamento especificado na memória da janela adicional.
`CWindow::ShowCaret`	Exibe o cursor do sistema.
`CWindow::ShowOwnedPopups`	Mostra ou oculta as janelas pop-up pertencentes à janela.
`CWindow::ShowScrollBar`	Mostra ou oculta uma barra de rolagem.
`CWindow::ShowWindow`	Define o estado de apresentação da janela.
`CWindow::ShowWindowAsync`	Define o estado de apresentação de uma janela criada por um thread diferente.
`CWindow::UpdateWindow`	Atualiza a área de cliente.
`CWindow::ValidateRect`	Valida a área de cliente dentro do retângulo especificado.
`CWindow::ValidateRgn`	Valida a área de cliente dentro da região especificada.
`CWindow::WinHelp`	Inicia a Ajuda do Windows.

Operadores públicos

Nome	Descrição
`CWindow::operator HWND`	Converte o objeto `CWindow` em um `HWND`.
`CWindow::operator =`	Atribui um `HWND` ao objeto `CWindow`.

Membros de Dados Públicos

Nome	Descrição
`CWindow::m_hWnd`	O identificador para a janela associada ao objeto `CWindow`.
`CWindow::rcDefault`	Contém as dimensões de janela padrão.

Comentários

CWindow fornece a funcionalidade base para manipular uma janela em ATL. Muitos dos métodos CWindow simplesmente encapsulam uma das funções da API do Win32. Por exemplo, compare os protótipos para CWindow::ShowWindow e ShowWindow:

Método CWindow	Função do Win32
`BOOL ShowWindow( int nCmdShow );`	`BOOL ShowWindow( HWND hWnd , int nCmdShow );`

CWindow::ShowWindow chama a função do Win32 ShowWindow passando CWindow::m_hWnd como o primeiro parâmetro. Cada método CWindow que encapsula diretamente uma função do Win32 passa o membro m_hWnd, portanto, grande parte da documentação do CWindow irá direcionar você para o SDK do Windows.

Observação

Nem todas as funções do Win32 relacionadas à janela são encapsuladas por CWindow, e nem todos os métodos CWindow encapsulam uma função do Win32.

CWindow::m_hWnd armazena HWND que identifica uma janela. Um HWND é anexado ao objeto quando você:

Especifica um HWND no construtor de CWindow.
Chame CWindow::Attach.
Usa CWindow's operator =.
Crie ou define subclasse de uma janela usando uma das seguintes classes derivadas de CWindow:

CWindowImpl Permite que você crie uma nova janela ou subclasse uma janela existente.

CContainedWindow Implementa uma janela contida em outro objeto. É possível criar uma nova janela ou uma subclasse de uma janela existente.

CDialogImpl Permite criar uma caixa de diálogo modal ou sem janela restrita.

Para obter mais informações sobre janelas, consulte Windows e tópicos subsequentes no SDK do Windows. Para obter mais informações sobre como usar janelas na ATL, confira o artigo Classes de janelas de ATL.

Requisitos

Cabeçalhoatlwin.h:

`CWindow::ArrangeIconicWindows`

Organiza todas as janelas filho minimizadas.

UINT ArrangeIconicWindows() throw();

Comentários

Consulte ArrangeIconicWindows no SDK do Windows.

`CWindow::Attach`

Anexa a janela identificada por hWndNew ao objeto CWindow.

void Attach(HWND hWndNew) throw();

Parâmetros

hWndNew
[in] O identificador para uma janela.

Exemplo

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

`CWindow::BeginPaint`

Prepara a janela para pintura.

HDC BeginPaint(LPPAINTSTRUCT lpPaint) throw();

Comentários

Consulte BeginPaint no SDK do Windows.

Exemplo

//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`

Traz a janela para a parte superior da ordem Z.

BOOL BringWindowToTop() throw();

Comentários

Consulte BringWindowToTop no SDK do Windows.

Exemplo

//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`

Centraliza a janela em uma determinada janela.

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

Parâmetros

hWndCenter
[in] O identificador para a janela na qual centralizar. Se este parâmetro for NULL (o valor padrão), o método definirá hWndCenter como a janela pai da janela se for uma janela filho. Caso contrário, definirá hWndCenter como a janela proprietária da janela.

Valor de Devolução

TRUE se a janela for centralizada com êxito, caso contrário, FALSE.

Exemplo

//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`

Remove a janela da cadeia de visualizadores da Área de Transferência.

BOOL ChangeClipboardChain(HWND hWndNewNext) throw();

Comentários

Consulte ChangeClipboardChain no SDK do Windows.

`CWindow::CheckDlgButton`

Altera o estado de verificação do botão especificado.

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

Comentários

Consulte CheckDlgButton no SDK do Windows.

`CWindow::CheckRadioButton`

Verifica o botão de opção especificado.

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

Comentários

Consulte CheckRadioButton no SDK do Windows.

`CWindow::ChildWindowFromPoint`

Recupera a janela filho que contém o ponto especificado.

HWND ChildWindowFromPoint(POINT point) const throw();

Comentários

Consulte ChildWindowFromPoint no SDK do Windows.

`CWindow::ChildWindowFromPointEx`

Recupera um tipo específico de janela filho que contém o ponto especificado.

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

Comentários

Consulte ChildWindowFromPointEx no SDK do Windows.

`CWindow::ClientToScreen`

Converte as coordenadas do cliente em coordenadas da tela.

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

Comentários

Consulte ClientToScreen no SDK do Windows.

A segunda versão desse método permite converter as coordenadas de uma estrutura RECT.

`CWindow::Create`

Cria uma janela.

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();

Parâmetros

lpstrWndClass
[in] Um ponteiro para a classe da janela.

hWndParent
[in] O identificador para a janela proprietária ou pai.

rect
[in] Uma variável de tipo _U_RECT que especifica a posição da janela. O valor padrão é NULL. Quando esse parâmetro for NULL, será usado o valor de CWindow::rcDefault.

szWindowName
[in] Especifica o nome da janela. O valor padrão é NULL.

dwStyle
[in] O estilo da janela. O valor padrão é 0, significando que nenhum estilo está especificado. Para obter uma lista de valores possíveis, consulte CreateWindow no SDK do Windows.

dwExStyle
[in] O estilo de janela estendida. O valor padrão é 0, significando que nenhum estilo estendido está especificado. Para obter uma lista de valores possíveis, consulte CreateWindowEx no SDK do Windows.

MenuOrID
[in] Uma variável do tipo _U_MENUorID especificando um identificador para um menu ou um identificador de janela. O valor padrão é 0U.

lpCreateParam
Um ponteiro para os dados de criação de janela contidos em uma estrutura CREATESTRUCT.

Valor de Devolução

Se bem-sucedido, o identificador para a janela recém-criada, especificado por m_hWnd. Caso contrário, NULL.

Comentários

CWindow::rcDefault é definido como __declspec(selectany) RECT CWindow::rcDefault = {CW_USEDEFAULT, CW_USEDEFAULT, 0, 0};.

Confira CreateWindow no SDK do Windows para mais informações.

Nota Se 0 for usado como o valor do parâmetro MenuOrID, ele deverá ser especificado como 0U (o valor padrão) para evitar um erro do compilador.

`CWindow::CreateCaret`

Cria uma nova forma para o cursor do sistema.

BOOL CreateCaret(HBITMAP pBitmap) throw();

Comentários

Consulte CreateCaret no SDK do Windows.

`CWindow::CreateGrayCaret`

Cria um retângulo cinza para o cursor do sistema.

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

Comentários

Consulte CreateCaret no SDK do Windows.

Passa (HBITMAP) 1 para o parâmetro de identificador de bitmap para a função do Win32.

`CWindow::CreateSolidCaret`

Cria um retângulo sólido para o cursor do sistema.

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

Comentários

Consulte CreateCaret no SDK do Windows.

Passa (HBITMAP) 0 para o parâmetro de identificador de bitmap para a função do Win32.

`CWindow::CWindow`

O construtor .

CWindow(HWND hWnd = NULL) throw();

Parâmetros

hWnd
[in] O identificador para uma janela.

Comentários

Inicializa o membro m_hWnd para hWnd, que por padrão é NULL.

Observação

CWindow::CWindow não cria uma janela. Classes CWindowImpl, CContainedWindow e CDialogImpl (todos os quais derivam de CWindow) fornecem um método para criar uma janela ou caixa de diálogo que é atribuída a CWindow::m_hWnd. Também é possível usar a função do Win32 CreateWindow.

`CWindow::DeferWindowPos`

Atualiza a estrutura de posição de várias janelas especificada para a janela especificada.

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

Comentários

Consulte DeferWindowPos no SDK do Windows.

`CWindow::DestroyWindow`

Destrói a janela associada ao objeto CWindow e definem_hWnd como NULL.

BOOL DestroyWindow() throw();

Comentários

Consulte DestroyWindow no SDK do Windows.

Não destrói o próprio objeto CWindow.

Exemplo

  //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`

Desanexa m_hWnd do objeto CWindow e define m_hWnd como NULL.

HWND Detach() throw();

Valor de Devolução

O HWND associado ao objeto CWindow.

Exemplo

//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`

Preenche uma caixa de listagem com os nomes de todos os arquivos que correspondem a um caminho ou nome de arquivo especificado.

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

Comentários

Consulte DlgDirList no SDK do Windows.

`CWindow::DlgDirListComboBox`

Preenche uma caixa de combinação com os nomes de todos os arquivos que correspondem a um caminho ou nome de arquivo especificado.

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

Comentários

Consulte DlgDirListComboBox no SDK do Windows.

`CWindow::DlgDirSelect`

Recupera a seleção atual de uma caixa de listagem.

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

Comentários

Consulte DlgDirSelectEx no SDK do Windows.

`CWindow::DlgDirSelectComboBox`

Recupera a seleção atual de uma caixa de combinação.

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

Comentários

Consulte DlgDirSelectComboBoxEx no SDK do Windows.

`CWindow::DragAcceptFiles`

Registra se a janela aceita arquivos arrastados.

void DragAcceptFiles(BOOL bAccept = TRUE);

Comentários

Consulte DragAcceptFiles no SDK do Windows.

`CWindow::DrawMenuBar`

Redesenha a barra de menus da janela.

BOOL DrawMenuBar() throw();

Comentários

Consulte DrawMenuBar no SDK do Windows.

`CWindow::EnableScrollBar`

Habilita ou desabilita as setas da barra de rolagem.

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

Comentários

Consulte EnableScrollBar no SDK do Windows.

`CWindow::EnableWindow`

Habilita ou desabilita a entrada.

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

Comentários

Consulte EnableWindow no SDK do Windows.

Exemplo

//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`

Marca o fim da pintura.

void EndPaint(LPPAINTSTRUCT lpPaint) throw();

Comentários

Consulte EndPaint no SDK do Windows.

Exemplo

//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`

Pisca a janela uma vez.

BOOL FlashWindow(BOOL bInvert) throw();

Comentários

Consulte FlashWindow no SDK do Windows.

`CWindow::GetClientRect`

Recupera as coordenadas da área de cliente.

BOOL GetClientRect(LPRECT lpRect) const throw();

Comentários

Consulte GetClientRect no SDK do Windows.

Exemplo

//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`

Recupera um contexto de dispositivo para a área de cliente.

HDC GetDC() throw();

Comentários

Consulte GetDC no SDK do Windows.

Exemplo

// 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`

Recupera um contexto de dispositivo para a área de cliente e permite as opções de recorte.

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

Comentários

Consulte GetDCEx no SDK do Windows.

`CWindow::GetDescendantWindow`

Localiza a janela descendente especificada pelo identificador especificado.

HWND GetDescendantWindow(int nID) const throw();

Parâmetros

nID
[in] O identificador da janela descendente que deve recuperar.

Valor de Devolução

O identificador de uma janela descendente.

Comentários

GetDescendantWindow pesquisa toda a árvore de janelas filhas, não apenas as janelas filhas imediatas.

`CWindow::GetDlgControl`

Chame essa função para obter um ponteiro para uma interface de um controle ActiveX hospedado por um controle composto ou uma caixa de diálogo de hospedagem de controle.

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

Parâmetros

nID
[in] A ID do recurso do controle que está sendo recuperado.

iid
[in] A ID da interface que você deseja obter do controle.

ppCtrl
[out] O ponteiro para a interface.

Valor de Devolução

Retorna S_OK em caso de êxito ou qualquer erro válido HRESULT. Por exemplo, a função retorna E_FAIL se o controle especificado por não puder ser encontrado e retornará E_NOINTERFACE se o controle puder ser encontrado, mas não oferece suporte à interface especificada por nIDiid.

Comentários

Usando esse ponteiro, você poderá chamar os métodos na interface.

`CWindow::GetDlgCtrlID`

Recupera o identificador da janela (somente para janelas filhas).

int GetDlgCtrlID() const throw();

Comentários

Consulte GetDlgCtrlID no SDK do Windows.

`CWindow::GetDlgHost`

Recupera um ponteiro para uma interface para o contêiner de hospedagem do Controle do ATL.

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

Parâmetros

nID
[in] A ID do recurso do controle que está sendo recuperado.

iid
[in] A ID da interface que você deseja obter do controle.

ppHost
[out] O ponteiro para a interface.

Valor de Devolução

Retornará S_OK se a janela especificada por iid for um Contêiner de Controle e a interface solicitada puder ser recuperada. Retornará E_FAIL se a janela não for um Contêiner de Controle ou se a interface solicitada não puder ser recuperada. Se uma janela com a ID especificada não puder ser localizada, o valor retornado será igual a HRESULT_FROM_WIN32(ERROR_CONTROL_ID_NOT_FOUND).

Comentários

Usando esse ponteiro, você poderá chamar os métodos na interface.

`CWindow::GetDlgItem`

Recupera a janela filho especificada.

HWND GetDlgItem(int nID) const throw();

Comentários

Consulte GetDlgItem no SDK do Windows.

`CWindow::GetDlgItemInt`

Traduz o texto de um controle para um inteiro.

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

Comentários

Consulte GetDlgItemInt no SDK do Windows.

`CWindow::GetDlgItemText`

Recupera o texto de um controle.

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

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

Comentários

Para obter mais informações, consulte GetDlgItemText no SDK do Windows.

A segunda versão desse método permite copiar o texto do controle para um BSTR. Essa versão retornará TRUE se o texto for copiado com êxito, caso contrário, FALSE.

`CWindow::GetExStyle`

Recupera os estilos de janela estendidos da janela.

DWORD GetExStyle() const throw();

Valor de Devolução

Os estilos estendidos da janela.

Comentários

Para recuperar os estilos de janela regulares, chame GetStyle.

Exemplo

//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`

Recupera a fonte atual da janela enviando uma mensagem WM_GETFONT para a janela.

HFONT GetFont() const throw();

Valor de Devolução

Um identificador de fonte.

`CWindow::GetHotKey`

Determina a chave de acesso associada à janela enviando uma mensagem WM_GETHOTKEY.

DWORD GetHotKey() const throw();

Valor de Devolução

O código de tecla virtual e modificadores para a chave de acesso associada à janela. Para obter uma lista de modificadores possíveis, consulte WM_GETHOTKEY no SDK do Windows. Para obter uma lista de códigos de tecla virtual padrão, consulte Winuser.h.

`CWindow::GetIcon`

Recupera o identificador do ícone grande ou pequeno da janela.

HICON GetIcon(BOOL bBigIcon = TRUE) const;

Parâmetros

bBigIcon
[in] Se TRUE (o valor padrão) o método retornará o ícone grande. Caso contrário, retornará o ícone pequeno.

Valor de Devolução

Um identificador de ícone.

Comentários

GetIcon envia uma mensagem WM_GETICON para a janela.

`CWindow::GetLastActivePopup`

Recupera a janela pop-up ativa mais recentemente.

HWND GetLastActivePopup() const throw();

Comentários

Consulte GetLastActivePopup no SDK do Windows.

`CWindow::GetMenu`

Recupera o menu da janela.

HMENU GetMenu() const throw();

Comentários

Consulte GetMenu no SDK do Windows.

`CWindow::GetNextDlgGroupItem`

Recupera o controle anterior ou próximo dentro de um grupo de controles.

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

Comentários

Consulte GetNextDlgGroupItem no SDK do Windows.

`CWindow::GetNextDlgTabItem`

Recupera o controle anterior ou próximo com o estilo WS_TABSTOP.

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

Comentários

Consulte GetNextDlgTabItem no SDK do Windows.

`CWindow::GetParent`

Recupera a janela pai imediata.

HWND GetParent() const throw();

Comentários

Consulte GetParent no SDK do Windows.

Exemplo

// 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`

Recupera os parâmetros de uma barra de rolagem.

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

Comentários

Consulte GetScrollInfo no SDK do Windows.

`CWindow::GetScrollPos`

Recupera a posição da caixa de rolagem.

int GetScrollPos(int nBar) const throw();

Comentários

Consulte GetScrollPos no SDK do Windows.

`CWindow::GetScrollRange`

Recupera o intervalo de barras de rolagem.

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

Comentários

Consulte GetScrollRange no SDK do Windows.

`CWindow::GetStyle`

Recupera os estilos de janela da janela.

DWORD GetStyle() const throw();

Valor de Devolução

Os estilos da janela.

Comentários

Para recuperar os estilos de janela estendidos, chame GetExStyle.

Exemplo

//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`

Cria uma cópia do menu de sistema para modificação.

HMENU GetSystemMenu(BOOL bRevert) const throw();

Comentários

Consulte GetSystemMenu no SDK do Windows.

`CWindow::GetTopLevelParent`

Recupera a janela pai de nível superior da janela.

HWND GetTopLevelParent() const throw();

Valor de Devolução

O identificador para a janela pai de nível superior.

`CWindow::GetTopLevelWindow`

Recupera a janela proprietária ou pai de nível superior da janela.

HWND GetTopLevelWindow() const throw();

Valor de Devolução

O identificador para a janela proprietária de nível superior.

`CWindow::GetTopWindow`

Recupera a janela filho de nível superior.

HWND GetTopWindow() const throw();

Comentários

Consulte GetTopWindow no SDK do Windows.

Exemplo

//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`

Recupera as coordenadas do menor retângulo que envolve completamente a região de atualização.

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

Comentários

Consulte GetUpdateRect no SDK do Windows.

`CWindow::GetUpdateRgn`

Recupera a região de atualização e a copia em uma região especificada.

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

Comentários

Consulte GetUpdateRgn no SDK do Windows.

`CWindow::GetWindow`

Recupera a janela especificada.

HWND GetWindow(UINT nCmd) const throw();

Comentários

Consulte GetWindow no SDK do Windows.

`CWindow::GetWindowContextHelpId`

Recupera o identificador de contexto de ajuda da janela.

DWORD GetWindowContextHelpId() const throw();

Comentários

Consulte GetWindowContextHelpId no SDK do Windows.

`CWindow::GetWindowDC`

Recupera um contexto de dispositivo para a janela inteira.

HDC GetWindowDC() throw();

Comentários

Consulte GetWindowDC no SDK do Windows.

Exemplo

//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`

Recupera um valor de 32 bits em um deslocamento especificado na memória de janela adicional.

LONG GetWindowLong(int nIndex) const throw();

Comentários

Consulte GetWindowLong no SDK do Windows.

Observação

Para gravar um código compatível com as versões de 32 bits e de 64 bits do Windows, use CWindow::GetWindowLongPtr.

`CWindow::GetWindowLongPtr`

Recupera as informações sobre a janela especificada, incluindo um valor em um deslocamento especificado na memória de janela adicional.

LONG_PTR GetWindowLongPtr(int nIndex) const throw();

Comentários

Para obter mais informações, consulte GetWindowLongPtr no SDK do Windows.

Se estiver recuperando um ponteiro ou um identificador, essa função substituirá o método CWindow::GetWindowLong.

Observação

Ponteiros e identificadores são de 32 bits no Windows de 32 bits e 64 bits no Windows de 64 bits.

Para gravar um código compatível com as versões de 32 bits e de 64 bits do Windows, use CWindow::GetWindowLongPtr.

`CWindow::GetWindowPlacement`

Recupera o estado de exibição e as posições.

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

Comentários

Consulte GetWindowPlacement no SDK do Windows.

`CWindow::GetWindowProcessID`

Recupera o identificador do processo que criou a janela.

DWORD GetWindowProcessID() throw();

Comentários

Consulte GetWindowThreadProcessID no SDK do Windows.

Exemplo

//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`

Recupera as dimensões delimitadoras da janela.

BOOL GetWindowRect(LPRECT lpRect) const throw();

Comentários

Consulte GetWindowRect no SDK do Windows.

`CWindow::GetWindowRgn`

Obtém uma cópia da região de janela de uma janela.

int GetWindowRgn(HRGN hRgn) throw();

Comentários

Consulte GetWindowRgn no SDK do Windows.

`CWindow::GetWindowText`

Recupera o texto da janela.

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

Parâmetros

lpszStringBuf
Um buffer no qual gravar o texto da janela.

nMaxCount
O tamanho do buffer em caracteres, também o número máximo de caracteres para gravar.

bstrText
Um BSTR no qual armazenar o texto da janela.

strText
Um CString no qual armazenar o texto da janela.

Valor de Devolução

Se o texto for copiado com êxito, o valor retornado será TRUE, caso contrário, o valor retornado será FALSE.

Comentários

Consulte GetWindowText no SDK do Windows.

A segunda versão desse método permite armazenar o texto em um BSTR, a terceira versão permite armazenar o resultado em um CString, pois CSimpleString que é a classe base de CString.

`CWindow::GetWindowTextLength`

Recupera o comprimento do texto da janela.

int GetWindowTextLength() const throw();

Comentários

Consulte GetWindowTextLength no SDK do Windows.

`CWindow::GetWindowThreadID`

Recupera o identificador do thread que criou a janela especificada.

DWORD GetWindowThreadID() throw();

Comentários

Consulte GetWindowThreadProcessID no SDK do Windows.

Exemplo

//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`

Recupera um valor de 16 bits em um deslocamento especificado na memória de janela adicional.

WORD GetWindowWord(int nIndex) const throw();

Comentários

Consulte GetWindowLong no SDK do Windows.

`CWindow::GotoDlgCtrl`

Define o foco do teclado para um controle na caixa de diálogo.

void GotoDlgCtrl(HWND hWndCtrl) const throw();

Comentários

Consulte WM_NEXTDLGCTL no SDK do Windows.

`CWindow::HideCaret`

Oculta o cursor do sistema.

BOOL HideCaret() throw();

Comentários

Consulte HideCaret no SDK do Windows.

Exemplo

//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`

Realça ou remove o realce de um item de menu de nível superior.

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

Comentários

Consulte HiliteMenuItem no SDK do Windows.

`CWindow::Invalidate`

Invalida toda a área de cliente.

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

Comentários

Consulte InvalidateRect no SDK do Windows.

Passa NULL para o parâmetro RECT para a InvalidateRect função do Win32.

Exemplo

//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`

Invalida a área de cliente dentro do retângulo especificado.

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

Comentários

Consulte InvalidateRect no SDK do Windows.

`CWindow::InvalidateRgn`

Invalida a área de cliente dentro da região especificada.

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

Comentários

Para obter mais informações, consulte InvalidateRgn no SDK do Windows.

Especifica um tipo de retorno void, enquanto a função do Win32 InvalidateRgn sempre retorna TRUE.

`CWindow::IsChild`

Determina se a janela especificada é uma janela filho.

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

Comentários

Consulte IsChild no SDK do Windows.

`CWindow::IsDialogMessage`

Determina se uma mensagem é destinada à caixa de diálogo especificada.

BOOL IsDialogMessage(LPMSG lpMsg) throw();

Comentários

Consulte IsDialogMessage no SDK do Windows.

`CWindow::IsDlgButtonChecked`

Determina o estado de verificação do botão.

UINT IsDlgButtonChecked(int nIDButton) const throw();

Comentários

Consulte IsDlgButtonChecked no SDK do Windows.

`CWindow::IsIconic`

Determina se a janela é minimizada.

BOOL IsIconic() const throw();

Comentários

Consulte IsIconic no SDK do Windows.

Exemplo

//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`

Determina se a janela pai do controle é uma janela de diálogo.

BOOL IsParentDialog() throw();

Valor de Devolução

Retornará TRUE se a janela pai for uma caixa de diálogo, caso contrário, retornará FALSE.

`CWindow::IsWindow`

Determina se o identificador de janela especificado identifica uma janela existente.

BOOL IsWindow() throw();

Comentários

Consulte IsWindow no SDK do Windows.

Exemplo

//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`

Determina se a janela está habilitada para entrada.

BOOL IsWindowEnabled() const throw();

Comentários

Consulte IsWindowEnabled no SDK do Windows.

Exemplo

//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`

Determina o estado de visibilidade da janela.

BOOL IsWindowVisible() const throw();

Comentários

Consulte IsWindowVisible no SDK do Windows.

Exemplo

//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`

Determina se a janela especificada é uma janela Unicode nativa.

BOOL IsWindowUnicode() throw();

Comentários

Consulte IsWindowUnicode no SDK do Windows.

Exemplo

//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`

Determina se a janela é maximizada.

BOOL IsZoomed() const throw();

Comentários

Consulte IsZoomed no SDK do Windows.

`CWindow::KillTimer`

Destrói um evento de temporizador criado por CWindow::SetTimer.

BOOL KillTimer(UINT nIDEvent) throw();

Comentários

Consulte KillTimer no SDK do Windows.

`CWindow::LockWindowUpdate`

Desabilita ou habilita o desenho na janela chamando a função do Win32 LockWindowUpdate.

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

Parâmetros

bLock
[in] Se TRUE (o valor padrão), a janela será bloqueada. Caso contrário, será desbloqueada.

Valor de Devolução

TRUE se a janela for bloqueada com sucesso, caso contrário, FALSE.

Comentários

Se bLock for TRUE, esse método passará m_hWnd para a função do Win32, caso contrário, passará NULL.

`CWindow::m_hWnd`

Contém um identificador para a janela associada ao objeto CWindow.

HWND m_hWnd throw() throw();

`CWindow::MapWindowPoints`

Converte um conjunto de pontos do espaço de coordenadas da janela para o espaço de coordenadas de outra janela.

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

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

Comentários

Consulte MapWindowPoints no SDK do Windows.

A segunda versão desse método permite converter as coordenadas de uma estrutura RECT.

`CWindow::MessageBox`

Mostra uma caixa de mensagem.

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

Comentários

Consulte MessageBox no SDK do Windows.

Exemplo

//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`

Modifica os estilos de janela do objeto CWindow.

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

Parâmetros

dwRemove
[in] Especifica os estilos de janela a serem removidos durante a modificação de estilo.

dwAdd
[in] Especifica os estilos de janela a serem adicionados durante a modificação de estilo.

nFlags
[in] Sinalizadores de posicionamento de janela. Para obter uma lista de valores possíveis, consulte a função SetWindowPos no SDK do Windows.

Valor de Devolução

TRUE se os estilos de janela forem modificados, caso contrário, FALSE.

Comentários

Estilos a serem adicionados ou removidos poderão ser combinados usando o operador bit a bit "or"(|). Consulte a função CreateWindow no SDK do Windows para obter mais informações sobre os estilos de janela disponíveis.

Se nFlags for diferente de zero, ModifyStyle chamará a função do Win32 SetWindowPos e redesenhará a janela combinando nFlags com os quatro sinalizadores a seguir:

SWP_NOSIZE Retém o tamanho atual.
SWP_NOMOVE Retém a posição atual.
SWP_NOZORDER Retém a ordem Z atual.
SWP_NOACTIVATE Não ativa a janela.

Para modificar os estilos estendidos de uma janela, chame ModifyStyleEx.

Exemplo

//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`

Modifica os estilos de janela estendidos do objeto CWindow.

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

Parâmetros

dwRemove
[in] Especifica os estilos estendidos a serem removidos durante a modificação de estilo.

dwAdd
[in] Especifica os estilos estendidos a serem adicionados durante a modificação de estilo.

nFlags
[in] Sinalizadores de posicionamento de janela. Para obter uma lista de valores possíveis, consulte a função SetWindowPos no SDK do Windows.

Valor de Devolução

TRUE se os estilos de janela estendidos forem modificados, caso contrário, FALSE.

Comentários

Estilos a serem adicionados ou removidos poderão ser combinados usando o operador bit a bit "or"(|). Consulte a função CreateWindowEx no SDK do Windows para obter mais informações sobre os estilos estendidos disponíveis.

Se nFlags for diferente de zero, ModifyStyleEx chamará a função do Win32 SetWindowPos e redesenhará a janela combinando nFlags com os quatro sinalizadores a seguir:

SWP_NOSIZE Retém o tamanho atual.
SWP_NOMOVE Retém a posição atual.
SWP_NOZORDER Retém a ordem Z atual.
SWP_NOACTIVATE Não ativa a janela.

Para modificar janelas usando estilos de janela regulares, chame ModifyStyle.

Exemplo

//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`

Altera o tamanho e a posição da janela.

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

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

Comentários

Para um objeto de janela de nível superior, os parâmetros x e y são relativos ao canto superior esquerdo da tela. Para um objeto de janela filho, são relativos ao canto superior esquerdo da área do cliente da janela pai.

A segunda versão desse método usa uma estrutura RECT para determinar a nova posição, largura e altura da janela.

`CWindow::NextDlgCtrl`

Define o foco do teclado para o próximo controle na caixa de diálogo.

void NextDlgCtrl() const throw();

Comentários

Consulte WM_NEXTDLGCTL no SDK do Windows.

`CWindow::OpenClipboard`

Abre a Área de Transferência.

BOOL OpenClipboard() throw();

Comentários

Consulte OpenClipboard no SDK do Windows.

`CWindow::operator HWND`

Converte um objeto CWindow em um HWND.

operator HWND() const throw();

`CWindow::operator =`

Atribui um HWND ao objeto CWindow definindo o membro m_hWnd como hWnd.

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

`CWindow::PostMessage`

Coloca uma mensagem na fila de mensagens associada ao thread que criou a janela.

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

Comentários

Consulte PostMessage no SDK do Windows.

Retorna sem esperar que o thread processe a mensagem.

Exemplo

//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`

Define o foco do teclado para o controle anterior na caixa de diálogo.

void PrevDlgCtrl() const throw();

Comentários

Consulte WM_NEXTDLGCTL no SDK do Windows.

`CWindow::Print`

Envia uma mensagem WM_PRINT à janela para solicitar que desenhe a si mesma no contexto do dispositivo especificado.

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

Parâmetros

hDC
[in] O identificador para um contexto de dispositivo.

dwFlags
[in] Especifica as opções de desenho. É possível combinar um ou mais dos seguintes sinalizadores:

PRF_CHECKVISIBLE Desenha a janela apenas se estiver visível.
PRF_CHILDREN Desenha todas as janelas filho visíveis.
PRF_CLIENT Desenha a área de cliente da janela.
PRF_ERASEBKGND Apaga o plano de fundo antes de desenhar a janela.
PRF_NONCLIENT Desenha a área que não é destinada aos clientes da janela.
PRF_OWNED Desenha todas as janelas de propriedade.

`CWindow::PrintClient`

Envia uma mensagem WM_PRINTCLIENT à janela para solicitar que desenhe a área de cliente no contexto do dispositivo especificado.

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

Parâmetros

hDC
[in] O identificador para um contexto de dispositivo.

dwFlags
[in] Especifica as opções de desenho. É possível combinar um ou mais dos seguintes sinalizadores:

PRF_CHECKVISIBLE Desenha a janela apenas se estiver visível.
PRF_CHILDREN Desenha todas as janelas filho visíveis.
PRF_CLIENT Desenha a área de cliente da janela.
PRF_ERASEBKGND Apaga o plano de fundo antes de desenhar a janela.
PRF_NONCLIENT Desenha a área que não é destinada aos clientes da janela.
PRF_OWNED Desenha todas as janelas de propriedade.

`CWindow::rcDefault`

Contém as dimensões de janela padrão.

static RECT rcDefault;

`CWindow::RedrawWindow`

Atualiza um retângulo ou região especificado na área de cliente.

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

throw()

Comentários

Consulte RedrawWindow no SDK do Windows.

Exemplo

//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`

Libera um contexto de dispositivo.

int ReleaseDC(HDC hDC);

Comentários

Consulte ReleaseDC no SDK do Windows.

Exemplo

// 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`

Redimensiona a janela para o tamanho da área de cliente especificado.

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

Parâmetros

nWidth
Nova largura da janela em pixels.

nHeight
Nova altura da janela em pixels.

bRedraw
Um sinalizador que indica se as alterações deverão ser redesenhadas. O padrão é FALSE, indicando que a janela não redesenha as alterações.

`CWindow::ScreenToClient`

Converte as coordenadas da tela em coordenadas do cliente.

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

Comentários

Consulte ScreenToClient no SDK do Windows.

A segunda versão desse método permite converter as coordenadas de uma estrutura RECT.

`CWindow::ScrollWindow`

Rola a área de cliente especificada.

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

Comentários

Consulte ScrollWindow no SDK do Windows.

`CWindow::ScrollWindowEx`

Rola a área de cliente especificada com recursos adicionais.

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

Comentários

Consulte ScrollWindowEx no SDK do Windows.

`CWindow::SendDlgItemMessage`

Envia uma mensagem para um controle.

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

Comentários

Consulte SendDlgItemMessage no SDK do Windows.

`CWindow::SendMessage`

Envia uma mensagem para a janela e não retornará até que o procedimento da janela tenha processado a mensagem.

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

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

Comentários

Consulte SendMessage no SDK do Windows.

Exemplo

// 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`

Envia a mensagem especificada para todos os filhos imediatos do objeto CWindow.

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

Parâmetros

message
[in] A mensagem a ser enviada.

wParam
[in] Informações adicionais específicas de mensagem.

lParam
[in] Informações adicionais específicas de mensagem.

bDeep
[in] Se TRUE (o valor padrão), a mensagem será enviada para todas as janelas descendentes, caso contrário, será enviada apenas para as janelas filhas imediatas.

Comentários

Se bDeep for TRUE, a mensagem será enviada adicionalmente para todas as outras janelas descendentes.

`CWindow::SendNotifyMessage`

Envia uma mensagem para a janela.

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

Comentários

Consulte SendNotifyMessage no SDK do Windows.

Se a janela foi criada pelo thread de chamada, SendNotifyMessage não retornará até que o procedimento da janela tenha processado a mensagem. Caso contrário, retornará imediatamente.

`CWindow::SetActiveWindow`

Ativa a janela.

HWND SetActiveWindow() throw();

Comentários

Consulte SetActiveWindow no SDK do Windows.

Exemplo

// 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`

Envia todas as entradas de mouse subsequentes para a janela.

HWND SetCapture() throw();

Comentários

Consulte SetCapture no SDK do Windows.

`CWindow::SetClipboardViewer`

Adiciona a janela à cadeia do visualizador da Área de Transferência.

HWND SetClipboardViewer() throw();

Comentários

Consulte SetClipboardViewer no SDK do Windows.

`CWindow::SetDlgCtrlID`

Define o identificador da janela para o valor especificado.

int SetDlgCtrlID(int nID) throw();

Parâmetros

nID
[in] O novo valor a ser definido para o identificador da janela.

Valor de Devolução

Se bem-sucedido, o identificador anterior da janela, caso contrário, 0.

`CWindow::SetDlgItemInt`

Altera o texto de um controle para a representação de cadeia de caracteres de um valor inteiro.

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

Comentários

Consulte SetDlgItemInt no SDK do Windows.

`CWindow::SetDlgItemText`

Altera o texto de um controle.

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

Comentários

Consulte SetDlgItemText no SDK do Windows.

`CWindow::SetFocus`

Define o foco de entrada para a janela.

HWND SetFocus() throw();

Comentários

Consulte SetFocus no SDK do Windows.

Exemplo

//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`

Altera a fonte atual da janela enviando uma mensagemWM_SETFONT para a janela.

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

Parâmetros

hFont
[in] O identificador para a nova fonte.

bRedraw
[in] Se TRUE (o valor padrão), a janela será redesenhada. Caso contrário, não.

`CWindow::SetHotKey`

Associa uma tecla de acesso à janela enviando uma mensagem WM_SETHOTKEY.

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

Parâmetros

wVirtualKeyCode
[in] O código de tecla virtual da tecla de acesso. Para obter uma lista de códigos de tecla virtual padrão, consulte Winuser.h.

wModifiers
[in] Os modificadores da tecla de acesso. Para obter uma lista de valores possíveis, consulte WM_SETHOTKEY no SDK do Windows.

Valor de Devolução

Para obter uma lista de valores retornados possíveis, consulte WM_SETHOTKEY no SDK do Windows.

`CWindow::SetIcon`

Define o ícone grande ou o pequeno da janela como o ícone identificado por hIcon.

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

Parâmetros

hIcon
[in] O identificador para um novo ícone.

bBigIcon
[in] Se TRUE (o valor padrão), o método definirá um ícone grande. Caso contrário, definirá um ícone pequeno.

Valor de Devolução

O identificador para o ícone anterior.

Comentários

SetIcon envia uma mensagem WM_SETICON para a janela.

`CWindow::SetMenu`

Altera o menu atual da janela.

BOOL SetMenu(HMENU hMenu) throw();

Comentários

Consulte SetMenu no SDK do Windows.

`CWindow::SetParent`

Altera a janela pai.

HWND SetParent(HWND hWndNewParent) throw();

Comentários

Consulte SetParent no SDK do Windows.

Exemplo

// 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`

Define ou limpa o sinalizador de redesenhar enviando uma mensagem WM_SETREDRAW para a janela.

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

Parâmetros

bRedraw
[in] Especifica o estado do sinalizador de redesenhar. Se TRUE (o valor padrão), o sinalizador de redesenhar será definido, se FALSE, o sinalizador será desmarcado.

Comentários

Chame SetRedraw para permitir que as alterações sejam redesenhadas ou para impedir que as alterações sejam redesenhadas.

Exemplo

//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`

Define os parâmetros de uma barra de rolagem.

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

Comentários

Consulte SetScrollInfo no SDK do Windows.

`CWindow::SetScrollPos`

Altera a posição da caixa de rolagem.

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

Comentários

Consulte SetScrollPos no SDK do Windows.

`CWindow::SetScrollRange`

Altera o intervalo da barra de rolagem.

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

Comentários

Consulte SetScrollRange no SDK do Windows.

`CWindow::SetTimer`

Cria um evento de temporizador.

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

Comentários

Consulte SetTimer no SDK do Windows.

`CWindow::SetWindowContextHelpId`

Define o identificador de contexto de ajuda da janela.

BOOL SetWindowContextHelpId(DWORD dwContextHelpId) throw();

Comentários

Consulte SetWindowContextHelpId no SDK do Windows.

`CWindow::SetWindowLong`

Define um valor de 32 bits em um deslocamento especificado na memória de janela adicional.

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

Comentários

Consulte SetWindowLong no SDK do Windows.

Observação

Para gravar um código compatível com as versões de 32 bits e de 64 bits do Windows, use CWindow::SetWindowLongPtr.

`CWindow::SetWindowLongPtr`

Altera um atributo da janela especificada e também define um valor no deslocamento especificado na memória da janela adicional.

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

Comentários

Consulte SetWindowLongPtr no SDK do Windows.

Essa função substitui o método CWindow::SetWindowLong. Para gravar um código compatível com as versões de 32 bits e de 64 bits do Windows, use CWindow::SetWindowLongPtr.

`CWindow::SetWindowPlacement`

Define o estado de apresentação e as posições.

BOOL SetWindowPlacement(const WINDOWPLACEMENT FAR* lpwndpl);

Comentários

Consulte SetWindowPlacement no SDK do Windows.

`CWindow::SetWindowPos`

Define o tamanho, a posição e a ordem 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();

Comentários

Consulte SetWindowPos no SDK do Windows.

A segunda versão desse método usa uma estrutura RECT para definir a nova posição, largura e altura da janela.

`CWindow::SetWindowRgn`

Define a região da janela de uma janela.

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

Comentários

Consulte SetWindowRgn no SDK do Windows.

`CWindow::SetWindowText`

Altera o texto da janela.

BOOL SetWindowText(LPCTSTR lpszString) throw();

Comentários

Consulte SetWindowText no SDK do Windows.

Exemplo

//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`

Define um valor de 16 bits em um deslocamento especificado na memória da janela adicional.

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

Comentários

Consulte SetWindowLong no SDK do Windows.

`CWindow::ShowCaret`

Exibe o cursor do sistema.

BOOL ShowCaret() throw();

Comentários

Consulte ShowCaret no SDK do Windows.

Exemplo

//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`

Mostra ou oculta as janelas pop-up pertencentes à janela.

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

Comentários

Consulte ShowOwnedPopups no SDK do Windows.

`CWindow::ShowScrollBar`

Mostra ou oculta uma barra de rolagem.

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

Comentários

Consulte ShowScrollBar no SDK do Windows.

`CWindow::ShowWindow`

Define o estado de apresentação da janela.

BOOL ShowWindow(int nCmdShow) throw();

Comentários

Consulte ShowWindow no SDK do Windows.

Exemplo

//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`

Define o estado de apresentação de uma janela criada por um thread diferente.

BOOL ShowWindowAsync(int nCmdShow) throw();

Comentários

Consulte ShowWindowAsync no SDK do Windows.

`CWindow::UpdateWindow`

Atualiza a área de cliente.

BOOL UpdateWindow() throw();

Comentários

Consulte UpdateWindow no SDK do Windows.

Exemplo

//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`

Valida a área de cliente dentro do retângulo especificado.

BOOL ValidateRect(LPCRECT lpRect) throw();

Comentários

Consulte ValidateRect no SDK do Windows.

`CWindow::ValidateRgn`

Valida a área de cliente dentro da região especificada.

BOOL ValidateRgn(HRGN hRgn) throw();

Comentários

Consulte ValidateRgn no SDK do Windows.

`CWindow::WinHelp`

Inicia a Ajuda do Windows.

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

Comentários

Consulte WinHelp no SDK do Windows.

Confira também

Visão geral da classe

Classe CWindow

Sintaxe

Membros

Construtores públicos

Métodos públicos

Operadores públicos

Membros de Dados Públicos

Comentários

Requisitos

CWindow::ArrangeIconicWindows

Comentários

CWindow::Attach

Parâmetros

Exemplo

CWindow::BeginPaint

Comentários

Exemplo

CWindow::BringWindowToTop

Comentários

Exemplo

CWindow::CenterWindow

Parâmetros

Valor de Devolução

Exemplo

CWindow::ChangeClipboardChain

Comentários

CWindow::CheckDlgButton

Comentários

CWindow::CheckRadioButton

Comentários

CWindow::ChildWindowFromPoint

Comentários

CWindow::ChildWindowFromPointEx

Comentários

CWindow::ClientToScreen

Comentários

CWindow::Create

Parâmetros

Valor de Devolução

Comentários

CWindow::CreateCaret

Comentários

CWindow::CreateGrayCaret

Comentários

CWindow::CreateSolidCaret

Comentários

CWindow::CWindow

Parâmetros

Comentários

CWindow::DeferWindowPos

Comentários

CWindow::DestroyWindow

Comentários

Exemplo

CWindow::Detach

Valor de Devolução

Exemplo

CWindow::DlgDirList

Comentários

CWindow::DlgDirListComboBox

Comentários

CWindow::DlgDirSelect

Comentários

CWindow::DlgDirSelectComboBox

Comentários

CWindow::DragAcceptFiles

Comentários

CWindow::DrawMenuBar

Comentários

CWindow::EnableScrollBar

Comentários

CWindow::EnableWindow

Comentários

Exemplo

CWindow::EndPaint

Comentários

Exemplo

CWindow::FlashWindow

Comentários

CWindow::GetClientRect

Classe `CWindow`

`CWindow::ArrangeIconicWindows`

`CWindow::Attach`

`CWindow::BeginPaint`

`CWindow::BringWindowToTop`

`CWindow::CenterWindow`

`CWindow::ChangeClipboardChain`

`CWindow::CheckDlgButton`

`CWindow::CheckRadioButton`

`CWindow::ChildWindowFromPoint`

`CWindow::ChildWindowFromPointEx`

`CWindow::ClientToScreen`

`CWindow::Create`

`CWindow::CreateCaret`

`CWindow::CreateGrayCaret`

`CWindow::CreateSolidCaret`

`CWindow::CWindow`

`CWindow::DeferWindowPos`

`CWindow::DestroyWindow`

`CWindow::Detach`

`CWindow::DlgDirList`

`CWindow::DlgDirListComboBox`

`CWindow::DlgDirSelect`

`CWindow::DlgDirSelectComboBox`

`CWindow::DragAcceptFiles`

`CWindow::DrawMenuBar`

`CWindow::EnableScrollBar`

`CWindow::EnableWindow`

`CWindow::EndPaint`

`CWindow::FlashWindow`

`CWindow::GetClientRect`

`CWindow::GetDC`

`CWindow::GetDCEx`

`CWindow::GetDescendantWindow`

`CWindow::GetDlgControl`

`CWindow::GetDlgCtrlID`

`CWindow::GetDlgHost`

`CWindow::GetDlgItem`

`CWindow::GetDlgItemInt`

`CWindow::GetDlgItemText`

`CWindow::GetExStyle`

`CWindow::GetFont`

`CWindow::GetHotKey`

`CWindow::GetIcon`

`CWindow::GetLastActivePopup`

`CWindow::GetMenu`

`CWindow::GetNextDlgGroupItem`

`CWindow::GetNextDlgTabItem`

`CWindow::GetParent`

`CWindow::GetScrollInfo`

`CWindow::GetScrollPos`

`CWindow::GetScrollRange`

`CWindow::GetStyle`

`CWindow::GetSystemMenu`

`CWindow::GetTopLevelParent`

`CWindow::GetTopLevelWindow`

`CWindow::GetTopWindow`