CWindow Classe

Esta classe fornece métodos para manipular uma janela.

Sintaxe

class CWindow

Membros

Construtores Públicos

Métodos Públicos

Operadores Públicos

Membros de Dados Públicos

Observações

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

CWindow::ShowWindow chama a função ShowWindow Win32 passando CWindow::m_hWnd como o primeiro parâmetro. Cada CWindow método que envolve diretamente uma função Win32 passa o m_hWnd membro; por isso, grande parte da CWindow documentação irá encaminhá-lo para o SDK do Windows.

CWindow::m_hWnd Armazena o HWND que identifica uma janela. An HWND está ligado ao seu objeto quando você:

• Especifique um HWND construtor em CWindow.

• Ligue para o CWindow::Attach.

• Use CWindow's operator =.

• Crie ou subclasse uma janela usando uma das seguintes classes derivadas de CWindow:

CWindowImpl Permite criar uma nova janela ou subclasse uma janela existente.

CContainedWindow Implementa uma janela contida noutro objeto. Podes criar uma nova janela ou subclassificar uma janela existente.

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

Para mais informações sobre o Windows, consulte Windows e tópicos subsequentes no Windows SDK. Para mais informações sobre o uso de janelas em ATL, consulte o artigo Classes de Janelas ATL.

Requerimentos

Cabeçalho:atlwin.h

CWindow::ArrangeIconicWindows

Organiza todas as janelas de crianças minimizadas.

UINT ArrangeIconicWindows() throw();

Observações

Veja ArrangeIconicWindows no SDK do Windows.

CWindow::Attach

Anexa a janela identificada por hWndNew ao CWindow objeto.

void Attach(HWND hWndNew) throw();

Parâmetros

hWndNew
[dentro] A maçaneta de uma janela.

Example

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

CWindow::BeginPaint

Prepara a janela para pintar.

HDC BeginPaint(LPPAINTSTRUCT lpPaint) throw();

Observações

Veja BeginPaint no SDK do Windows.

Example

//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 o topo da ordem Z.

BOOL BringWindowToTop() throw();

Observações

Veja BringWindowToTop no SDK do Windows.

Example

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

Centra a janela contra uma dada janela.

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

Parâmetros

hWndCenter
[dentro] A maçaneta para a janela contra a qual se centra. Se este parâmetro for NULL (o valor predefinido), o método será definido hWndCenter como a janela pai da janela se for uma janela filha. Caso contrário, será definido hWndCenter para a janela do proprietário da janela.

Valor de retorno

TRUE se a janela estiver centrada com sucesso; caso contrário, FALSE.

Example

//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 do Clipboard.

BOOL ChangeClipboardChain(HWND hWndNewNext) throw();

Observações

Veja ChangeClipboardChain no SDK do Windows.

CWindow::CheckDlgButton

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

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

Observações

Veja CheckDlgButton no SDK do Windows.

CWindow::CheckRadioButton

Verifica o botão de acesso especificado.

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

Observações

Veja CheckRadioButton no SDK do Windows.

CWindow::ChildWindowFromPoint

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

HWND ChildWindowFromPoint(POINT point) const throw();

Observações

Veja ChildWindowFromPoint no SDK do Windows.

CWindow::ChildWindowFromPointEx

Recupera um tipo particular de janela filha contendo o ponto especificado.

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

Observações

Veja ChildWindowFromPointEx no SDK do Windows.

CWindow::ClientToScreen

Converte as coordenadas do cliente em coordenadas de ecrã.

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

Observações

Veja ClientToScreen no SDK do Windows.

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

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
[dentro] Um indicador para a classe da janela.

hWndParent
[dentro] A maçaneta da janela dos pais ou proprietários.

rect
[dentro] Uma variável do tipo _U_RECT que especifica a posição da janela. O valor predefinido é NULL. Quando este parâmetro é NULL, utiliza-se o valor de CWindow::rcDefault .

szWindowName
[dentro] Especifica o nome da janela. O valor predefinido é NULL.

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

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

MenuOrID
[dentro] Uma variável do tipo _U_MENUorID que especifica um handle para um menu ou identificador de janela. O valor predefinido é 0U.

lpCreateParam
Um ponteiro para os dados de criação de janelas contidos numa CREATESTRUCT estrutura.

Valor de retorno

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

Observações

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

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

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

CWindow::CreateCaret

Cria uma nova forma para o suporte do sistema.

BOOL CreateCaret(HBITMAP pBitmap) throw();

Observações

Veja CreateCaret no SDK do Windows.

CWindow::CreateGrayCaret

Cria um retângulo cinzento para o suporte do sistema.

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

Observações

Veja CreateCaret no SDK do Windows.

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

CWindow::CreateSolidCaret

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

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

Observações

Veja CreateCaret no SDK do Windows.

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

CWindow::CWindow

O construtor.

CWindow(HWND hWnd = NULL) throw();

Parâmetros

hWnd
[dentro] A maçaneta de uma janela.

Observações

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

CWindow::DeferWindowPos

Atualiza a estrutura especificada de múltiplas janelas e posições para a janela especificada.

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

Observações

Veja DeferWindowPos no SDK do Windows.

CWindow::DestroyWindow

Destrói a janela associada ao CWindow objeto e define m_hWnd para NULL.

BOOL DestroyWindow() throw();

Observações

Veja DestroyWindow no SDK do Windows.

Não destrói o CWindow objeto em si.

Example

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

separa-se m_hWnd do CWindow objeto e define m_hWnd para NULL.

HWND Detach() throw();

Valor de retorno

O HWND associado ao CWindow objeto.

Example

//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 lista com os nomes de todos os ficheiros que correspondem a um caminho ou nome de ficheiro especificado.

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

Observações

Veja DlgDirList no SDK do Windows.

CWindow::DlgDirListComboBox

Preenche uma caixa combinada com os nomes de todos os ficheiros que correspondem a um caminho ou nome de ficheiro especificado.

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

Observações

Veja DlgDirListComboBox no SDK do Windows.

CWindow::DlgDirSelect

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

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

Observações

Veja DlgDirSelectEx no SDK do Windows.

CWindow::DlgDirSelectComboBox

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

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

Observações

Veja DlgDirSelectComboBoxEx no SDK do Windows.

CWindow::DragAcceptFiles

Regista se a janela aceita ficheiros arrastados.

void DragAcceptFiles(BOOL bAccept = TRUE);

Observações

Veja DragAcceptFiles no SDK do Windows.

CWindow::DrawMenuBar

Redesenha a barra de menus da janela.

BOOL DrawMenuBar() throw();

Observações

Veja DrawMenuBar no SDK do Windows.

CWindow::EnableScrollBar

Ativa ou desativa as setas da barra de deslocamento.

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

Observações

Veja EnableScrollBar no SDK do Windows.

CWindow::EnableWindow

Ativa ou desativa a entrada.

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

Observações

Veja EnableWindow no SDK do Windows.

Example

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

Observações

Veja EndPaint no SDK do Windows.

Example

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

Observações

Veja FlashWindow no SDK do Windows.

CWindow::GetClientRect

Recupera as coordenadas da área do cliente.

BOOL GetClientRect(LPRECT lpRect) const throw();

Observações

Veja GetClientRect no SDK do Windows.

Example

//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 o contexto do dispositivo para a área do cliente.

HDC GetDC() throw();

Observações

Veja GetDC no SDK do Windows.

Example

// 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 o contexto do dispositivo para a área do cliente e permite opções de clipping.

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

Observações

Veja GetDCEx no SDK do Windows.

CWindow::GetDescendantWindow

Encontra a janela descendente especificada pelo identificador indicado.

HWND GetDescendantWindow(int nID) const throw();

Parâmetros

nID
[dentro] O identificador da janela descendente a recuperar.

Valor de retorno

A maçaneta de uma janela descendente.

Observações

GetDescendantWindow Procura em toda a árvore de janelas crianças, não apenas nas janelas que são imediatamente crianças.

CWindow::GetDlgControl

Chame esta função para obter um ponteiro para uma interface de um controlo ActiveX que é alojado por um controlo composto ou por um diálogo de controlo-hospedagem.

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

Parâmetros

nID
[dentro] O ID do recurso do controlo a ser recuperado.

iid
[dentro] O ID da interface que gostaria de obter do controlo.

ppCtrl
[fora] O ponteiro para a interface.

Valor de retorno

Retornos S_OK do sucesso ou qualquer erro HRESULTválido. Por exemplo, a função retorna E_FAIL se o controlo especificado por nID não puder ser encontrado e retorna E_NOINTERFACE se o controlo for encontrado, mas não suporta a interface especificada por iid.

Observações

Usando este apontador, pode chamar métodos na interface.

CWindow::GetDlgCtrlID

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

int GetDlgCtrlID() const throw();

Observações

Veja GetDlgCtrlID no SDK do Windows.

CWindow::GetDlgHost

Recupera um apontador para uma interface do contentor de alojamento do ATL Control.

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

Parâmetros

nID
[dentro] O ID do recurso do controlo a ser recuperado.

iid
[dentro] O ID da interface que gostaria de obter do controlo.

ppHost
[fora] O ponteiro para a interface.

Valor de retorno

Retorna S_OK se a janela especificada por iid for um Contentor de Controlo, e a interface solicitada puder ser recuperada. Retorna E_FAIL se a janela não for um Contentor de Controlo, ou se a interface solicitada não puder ser recuperada. Se uma janela com o ID especificado não pudesse ser encontrada, então o valor de retorno é igual a HRESULT_FROM_WIN32(ERROR_CONTROL_ID_NOT_FOUND).

Observações

Usando este apontador, pode chamar métodos na interface.

CWindow::GetDlgItem

Recupera a janela filha especificada.

HWND GetDlgItem(int nID) const throw();

Observações

Veja GetDlgItem no SDK do Windows.

CWindow::GetDlgItemInt

Traduz o texto de um controlo para um inteiro.

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

Observações

Veja GetDlgItemInt no SDK do Windows.

CWindow::GetDlgItemText

Recupera o texto de um controlo.

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

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

Observações

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

A segunda versão deste método permite copiar o texto do controlo para um BSTR. Esta versão retorna TRUE se o texto for copiado com sucesso; caso contrário, FALSE.

CWindow::GetExStyle

Recupera os estilos de janelas estendidas da janela.

DWORD GetExStyle() const throw();

Valor de retorno

Os estilos estendidos da janela.

Observações

Para recuperar os estilos de janelas regulares, ligue GetStylepara .

Example

//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 WM_GETFONT mensagem para a janela.

HFONT GetFont() const throw();

Valor de retorno

Um nome de letra de letra.

CWindow::GetHotKey

Determina a tecla de atalho associada à janela enviando uma WM_GETHOTKEY mensagem.

DWORD GetHotKey() const throw();

Valor de retorno

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

CWindow::GetIcon

Recupera a maçaneta do ícone grande ou pequeno da janela.

HICON GetIcon(BOOL bBigIcon = TRUE) const;

Parâmetros

bBigIcon
[dentro] Se TRUE (o valor predefinido) o método devolve o ícone grande. Caso contrário, devolve o ícone pequeno.

Valor de retorno

Um nome de identificação com ícones.

Observações

GetIcon Envia uma WM_GETICON mensagem para a janela.

CWindow::GetLastActivePopup

Recupera a janela pop-up mais recente e ativa.

HWND GetLastActivePopup() const throw();

Observações

Veja GetLastActivePopup no SDK do Windows.

CWindow::GetMenu

Recupera o menu da janela.

HMENU GetMenu() const throw();

Observações

Veja GetMenu no SDK do Windows.

CWindow::GetNextDlgGroupItem

Recupera o controlo anterior ou seguinte dentro de um grupo de controlos.

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

Observações

Veja GetNextDlgGroupItem no SDK do Windows.

CWindow::GetNextDlgTabItem

Recupera o controlo anterior ou seguinte com o WS_TABSTOP estilo.

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

Observações

Veja GetNextDlgTabItem no SDK do Windows.

CWindow::GetParent

Recupera a janela parental imediata.

HWND GetParent() const throw();

Observações

Veja GetParent no SDK do Windows.

Example

// 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 deslocamento.

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

Observações

Veja GetScrollInfo no SDK do Windows.

CWindow::GetScrollPos

Recupera a posição da caixa do pergaminho.

int GetScrollPos(int nBar) const throw();

Observações

Veja GetScrollPos no SDK do Windows.

CWindow::GetScrollRange

Recupera o intervalo da barra de deslocamento.

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

Observações

Veja GetScrollRange no SDK do Windows.

CWindow::GetStyle

Recupera os estilos das janelas da janela.

DWORD GetStyle() const throw();

Valor de retorno

Os estilos da janela.

Observações

Para recuperar os estilos de janelas estendidas, ligue GetExStylepara .

Example

//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 do sistema para modificação.

HMENU GetSystemMenu(BOOL bRevert) const throw();

Observações

Veja GetSystemMenu no SDK do Windows.

CWindow::GetTopLevelParent

Recupera a janela principal do topo da janela.

HWND GetTopLevelParent() const throw();

Valor de retorno

A maçaneta para a janela principal do nível superior.

CWindow::GetTopLevelWindow

Recupera a janela principal ou proprietária do nível superior da janela.

HWND GetTopLevelWindow() const throw();

Valor de retorno

A maçaneta da janela do proprietário do piso superior.

CWindow::GetTopWindow

Recupera a janela criança do nível superior.

HWND GetTopWindow() const throw();

Observações

Veja GetTopWindow no SDK do Windows.

Example

//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 retângulo mais pequeno que envolve completamente a região de atualização.

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

Observações

Veja GetUpdateRect no SDK do Windows.

CWindow::GetUpdateRgn

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

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

Observações

Veja GetUpdateRgn no SDK do Windows.

CWindow::GetWindow

Recupera a janela especificada.

HWND GetWindow(UINT nCmd) const throw();

Observações

Veja GetWindow no SDK do Windows.

CWindow::GetWindowContextHelpId

Recupera o identificador de contexto de ajuda da janela.

DWORD GetWindowContextHelpId() const throw();

Observações

Veja GetWindowContextHelpId no SDK do Windows.

CWindow::GetWindowDC

Recupera o contexto do dispositivo para toda a janela.

HDC GetWindowDC() throw();

Observações

Veja GetWindowDC no SDK do Windows.

Example

//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 a um deslocamento especificado para a memória extra da janela.

LONG GetWindowLong(int nIndex) const throw();

Observações

Veja GetWindowLong no SDK do Windows.

CWindow::GetWindowLongPtr

Recupera informação sobre a janela especificada, incluindo um valor num deslocamento especificado, para a memória extra da janela.

LONG_PTR GetWindowLongPtr(int nIndex) const throw();

Observações

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

Se estiveres a recuperar um ponteiro ou um handler, esta função substitui o CWindow::GetWindowLong método.

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

CWindow::GetWindowPlacement

Recupera o estado e as posições do programa.

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

Observações

Veja GetWindowPlacement no SDK do Windows.

CWindow::GetWindowProcessID

Recupera o identificador do processo que criou a janela.

DWORD GetWindowProcessID() throw();

Observações

Veja GetWindowThreadProcessID no SDK do Windows.

Example

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

Observações

Veja GetWindowRect no SDK do Windows.

CWindow::GetWindowRgn

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

int GetWindowRgn(HRGN hRgn) throw();

Observações

Veja 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 para escrever o texto da janela.

nMaxCount
O tamanho do buffer em caracteres; Também o número máximo de caracteres para escrever.

bstrText
Um BSTR onde guardar o texto da janela.

strText
Um CString onde guardar o texto da janela.

Valor de retorno

Se o texto for copiado com sucesso, o valor de retorno é TRUE; caso contrário, o valor de retorno é FALSE.

Observações

Veja GetWindowText no SDK do Windows.

A segunda versão deste método permite armazenar o texto num BSTR; a terceira versão permite armazenar o resultado num CString, já que CSimpleString é a classe base de CString.

CWindow::GetWindowTextLength

Recupera o texto da janela.

int GetWindowTextLength() const throw();

Observações

Veja GetWindowTextLength no SDK do Windows.

CWindow::GetWindowThreadID

Recupera o identificador do thread que criou a janela especificada.

DWORD GetWindowThreadID() throw();

Observações

Veja GetWindowThreadProcessID no SDK do Windows.

Example

//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 com um deslocamento especificado para a memória extra da janela.

WORD GetWindowWord(int nIndex) const throw();

Observações

Veja GetWindowLong no SDK do Windows.

CWindow::GotoDlgCtrl

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

void GotoDlgCtrl(HWND hWndCtrl) const throw();

Observações

Veja WM_NEXTDLGCTL no SDK do Windows.

CWindow::HideCaret

Esconde o marcador do sistema.

BOOL HideCaret() throw();

Observações

Veja HideCaret no SDK do Windows.

Example

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

Destaca ou remove o destaque de um item de topo do menu.

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

Observações

Veja HiliteMenuItem no SDK do Windows.

CWindow::Invalidate

Invalida toda a área do cliente.

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

Observações

Veja InvalidateRect no SDK do Windows.

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

Example

//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 do cliente dentro do retângulo especificado.

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

Observações

Veja InvalidateRect no SDK do Windows.

CWindow::InvalidateRgn

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

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

Observações

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

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

CWindow::IsChild

Determina se a janela especificada é uma janela filha.

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

Observações

Veja IsChild no SDK do Windows.

CWindow::IsDialogMessage

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

BOOL IsDialogMessage(LPMSG lpMsg) throw();

Observações

Veja IsDialogMessage no SDK do Windows.

CWindow::IsDlgButtonChecked

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

UINT IsDlgButtonChecked(int nIDButton) const throw();

Observações

Veja IsDlgButtonChecked no SDK do Windows.

CWindow::IsIconic

Determina se a janela é minimizada.

BOOL IsIconic() const throw();

Observações

Veja IsIconic no SDK do Windows.

Example

//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 principal do controlo é uma janela de diálogo.

BOOL IsParentDialog() throw();

Valor de retorno

Retorna TRUE se a janela pai for um diálogo, FALSE caso contrário.

CWindow::IsWindow

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

BOOL IsWindow() throw();

Observações

Veja IsWindow no SDK do Windows.

Example

//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á ativada para entrada.

BOOL IsWindowEnabled() const throw();

Observações

Veja IsWindowEnabled no SDK do Windows.

Example

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

Observações

Veja IsWindowVisible no SDK do Windows.

Example

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

Observações

Veja IsWindowUnicode no SDK do Windows.

Example

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

Observações

Veja IsZoomed no SDK do Windows.

CWindow::KillTimer

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

BOOL KillTimer(UINT nIDEvent) throw();

Observações

Veja KillTimer no SDK do Windows.

CWindow::LockWindowUpdate

Desativa ou ativa o desenho na janela ao chamar a LockWindowUpdate função Win32.

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

Parâmetros

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

Valor de retorno

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

Observações

Se bLock for TRUE, este método passa m_hWnd para a função Win32; caso contrário, passa NULLpara .

CWindow::m_hWnd

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

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

Observações

Veja MapWindowPoints no SDK do Windows.

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

CWindow::MessageBox

Mostra uma caixa de mensagem.

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

Observações

Veja MessageBox no SDK do Windows.

Example

//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 das janelas do CWindow objeto.

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

Parâmetros

dwRemove
[dentro] Especifica os estilos de janelas a remover durante a modificação de estilo.

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

nFlags
[dentro] Bandeiras de posicionamento da janela. Para uma lista de valores possíveis, veja a SetWindowPos função no SDK do Windows.

Valor de retorno

TRUE se os estilos das janelas forem modificados; caso contrário, FALSE.

Observações

Os estilos a adicionar ou remover podem ser combinados usando o operador bit a bit "ou" (|). Consulte a CreateWindow função no SDK do Windows para informações sobre os estilos de janelas disponíveis.

Se nFlags for diferente de zero, ModifyStyle chama a função SetWindowPosWin32 , e redesenha a janela combinando nFlags com as seguintes quatro bandeiras:

• SWP_NOSIZE Mantém o tamanho atual.

• SWP_NOMOVE Mantém a posição atual.

• SWP_NOZORDER Mantém a ordem Z atual.

• SWP_NOACTIVATE Não ativa a janela.

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

Example

//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 janelas estendidas do CWindow objeto.

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

Parâmetros

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

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

nFlags
[dentro] Bandeiras de posicionamento da janela. Para uma lista de valores possíveis, veja a SetWindowPos função no SDK do Windows.

Valor de retorno

TRUE se os estilos de janelas estendidas forem modificados; caso contrário, FALSE.

Observações

Os estilos a adicionar ou remover podem ser combinados usando o operador bit a bit "ou" (|). Consulte a CreateWindowEx função no SDK do Windows para informações sobre os estilos estendidos disponíveis.

Se nFlags for diferente de zero, ModifyStyleEx chama a função SetWindowPosWin32 , e redesenha a janela combinando nFlags com as seguintes quatro bandeiras:

• SWP_NOSIZE Mantém o tamanho atual.

• SWP_NOMOVE Mantém a posição atual.

• SWP_NOZORDER Mantém a ordem Z atual.

• SWP_NOACTIVATE Não ativa a janela.

Para modificar janelas usando estilos de janelas normais, chame ModifyStyle.

Example

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

Observações

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

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

CWindow::NextDlgCtrl

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

void NextDlgCtrl() const throw();

Observações

Veja WM_NEXTDLGCTL no SDK do Windows.

CWindow::OpenClipboard

Abre a prancheta.

BOOL OpenClipboard() throw();

Observações

Veja OpenClipboard no SDK do Windows.

CWindow::operator HWND

Converte um CWindow objeto em um HWND.

operator HWND() const throw();

CWindow::operator =

Atribui an HWND ao CWindow objeto definindo o m_hWnd membro 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();

Observações

Veja PostMessage no SDK do Windows.

Retorna sem esperar que o fio processe a mensagem.

Example

//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 controlo anterior na caixa de diálogo.

void PrevDlgCtrl() const throw();

Observações

Veja WM_NEXTDLGCTL no SDK do Windows.

CWindow::Print

Envia uma WM_PRINT mensagem para a janela a pedir que ela se desenhe sozinha no contexto do dispositivo especificado.

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

Parâmetros

hDC
[dentro] O handle para um contexto de dispositivo.

dwFlags
[dentro] Especifica as opções de desenho. Pode combinar uma ou mais das seguintes bandeiras:

• PRF_CHECKVISIBLE Desenha a janela apenas se for visível.

• PRF_CHILDREN Desenha todas as janelas das crianças visíveis.

• PRF_CLIENT Desenha a área do cliente na janela.

• PRF_ERASEBKGND Apaga o fundo antes de desenhar a janela.

• PRF_NONCLIENT Desenha a área não cliente da janela.

• PRF_OWNED Desenha todas as janelas que possui.

CWindow::PrintClient

Envia uma WM_PRINTCLIENT mensagem para a janela a pedir que desenhe a sua área cliente no contexto do dispositivo especificado.

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

Parâmetros

hDC
[dentro] O handle para um contexto de dispositivo.

dwFlags
[dentro] Especifica opções de desenho. Pode combinar uma ou mais das seguintes bandeiras:

• PRF_CHECKVISIBLE Desenha a janela apenas se for visível.

• PRF_CHILDREN Desenha todas as janelas das crianças visíveis.

• PRF_CLIENT Desenha a área do cliente na janela.

• PRF_ERASEBKGND Apaga o fundo antes de desenhar a janela.

• PRF_NONCLIENT Desenha a área não cliente da janela.

• PRF_OWNED Desenha todas as janelas que possui.

CWindow::rcDefault

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

static RECT rcDefault;

CWindow::RedrawWindow

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

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

throw()

Observações

Veja RedrawWindow no SDK do Windows.

Example

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

Liberta o contexto do dispositivo.

int ReleaseDC(HDC hDC);

Observações

Veja ReleaseDC no SDK do Windows.

Example

// 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 especificado da área do cliente.

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
Uma bandeira a indicar se deveria ser redesenhado alterações. O padrão é FALSE, indicando que a janela não redesenha as alterações.

CWindow::ScreenToClient

Converte as coordenadas do ecrã em coordenadas do cliente.

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

Observações

Veja ScreenToClient no SDK do Windows.

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

CWindow::ScrollWindow

Percorre a área do cliente especificada.

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

Observações

Veja ScrollWindow no SDK do Windows.

CWindow::ScrollWindowEx

Percorre a área do cliente especificada com funcionalidades adicionais.

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

Observações

Veja ScrollWindowEx no SDK do Windows.

CWindow::SendDlgItemMessage

Envia uma mensagem para um controlo.

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

Observações

Veja SendDlgItemMessage no SDK do Windows.

CWindow::SendMessage

Envia uma mensagem para a janela e não retorna 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();

Observações

Veja SendMessage no SDK do Windows.

Example

// 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 a todos os filhos imediatos do CWindow objeto.

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

Parâmetros

message
[dentro] A mensagem a enviar.

wParam
[dentro] Informação adicional específica da mensagem.

lParam
[dentro] Informação adicional específica da mensagem.

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

Observações

Se bDeep for TRUE, a mensagem é adicionalmente enviada 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();

Observações

Veja SendNotifyMessage no SDK do Windows.

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

CWindow::SetActiveWindow

Ativa a janela.

HWND SetActiveWindow() throw();

Observações

Veja SetActiveWindow no SDK do Windows.

Example

// 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 subsequentes do rato para a janela.

HWND SetCapture() throw();

Observações

Veja SetCapture no SDK do Windows.

CWindow::SetClipboardViewer

Adiciona a janela à cadeia de visualização do Clipboard.

HWND SetClipboardViewer() throw();

Observações

Veja SetClipboardViewer no SDK do Windows.

CWindow::SetDlgCtrlID

Define o identificador da janela para o valor especificado.

int SetDlgCtrlID(int nID) throw();

Parâmetros

nID
[dentro] O novo valor a definir para o identificador da janela.

Valor de retorno

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

CWindow::SetDlgItemInt

Altera o texto de um controlo para a representação em cadeia de um valor inteiro.

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

Observações

Veja SetDlgItemInt no SDK do Windows.

CWindow::SetDlgItemText

Altera o texto de um controlo.

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

Observações

Veja SetDlgItemText no SDK do Windows.

CWindow::SetFocus

Define o foco de entrada para a janela.

HWND SetFocus() throw();

Observações

Veja SetFocus no SDK do Windows.

Example

//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 WM_SETFONT mensagem para a janela.

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

Parâmetros

hFont
[dentro] O nome da nova fonte.

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

CWindow::SetHotKey

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

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

Parâmetros

wVirtualKeyCode
[dentro] O código da tecla virtual da tecla de atalho. Para uma lista de códigos de chave virtuais padrão, veja Winuser.h.

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

Valor de retorno

Para uma lista de possíveis valores de retorno, consulte WM_SETHOTKEY o SDK do Windows.

CWindow::SetIcon

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

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

Parâmetros

hIcon
[dentro] O nome de um novo ícone.

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

Valor de retorno

O nome do ícone anterior.

Observações

SetIcon Envia uma WM_SETICON mensagem para a janela.

CWindow::SetMenu

Altera o menu atual da janela.

BOOL SetMenu(HMENU hMenu) throw();

Observações

Veja SetMenu no SDK do Windows.

CWindow::SetParent

Altera a janela dos pais.

HWND SetParent(HWND hWndNewParent) throw();

Observações

Veja SetParent no SDK do Windows.

Example

// 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 elimina a bandeira de redesenho enviando uma WM_SETREDRAW mensagem para a janela.

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

Parâmetros

bRedraw
[dentro] Especifica o estado da bandeira de redesenho. Se TRUE (o valor padrão), a bandeira de redesenho está definida; se FALSE, a bandeira é limpa.

Observações

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

Example

//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 deslocamento.

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

Observações

Veja SetScrollInfo no SDK do Windows.

CWindow::SetScrollPos

Muda a posição da caixa de pergaminho.

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

Observações

Veja SetScrollPos no SDK do Windows.

CWindow::SetScrollRange

Altera o alcance da barra de deslocamento.

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

Observações

Veja SetScrollRange no SDK do Windows.

CWindow::SetTimer

Cria um evento temporizador.

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

Observações

Veja SetTimer no SDK do Windows.

CWindow::SetWindowContextHelpId

Define o identificador de contexto de ajuda da janela.

BOOL SetWindowContextHelpId(DWORD dwContextHelpId) throw();

Observações

Veja SetWindowContextHelpId no SDK do Windows.

CWindow::SetWindowLong

Define um valor de 32 bits com um deslocamento especificado na memória extra da janela.

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

Observações

Veja SetWindowLong no SDK do Windows.

CWindow::SetWindowLongPtr

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

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

Observações

Veja SetWindowLongPtr no SDK do Windows.

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

CWindow::SetWindowPlacement

Define o estado e as posições do espetáculo.

BOOL SetWindowPlacement(const WINDOWPLACEMENT FAR* lpwndpl);

Observações

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

Observações

Veja SetWindowPos no SDK do Windows.

A segunda versão deste método utiliza uma RECT estrutura 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();

Observações

Veja SetWindowRgn no SDK do Windows.

CWindow::SetWindowText

Altera o texto da janela.

BOOL SetWindowText(LPCTSTR lpszString) throw();

Observações

Veja SetWindowText no SDK do Windows.

Example

//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 a um deslocamento especificado na memória extra da janela.

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

Observações

Veja SetWindowLong no SDK do Windows.

CWindow::ShowCaret

Exibe o sistema de controlo.

BOOL ShowCaret() throw();

Observações

Veja ShowCaret no SDK do Windows.

Example

//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 esconde as janelas pop-up que pertencem à janela.

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

Observações

Veja ShowOwnedPopups no SDK do Windows.

CWindow::ShowScrollBar

Mostra ou esconde uma barra de deslocamento.

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

Observações

Veja ShowScrollBar no SDK do Windows.

CWindow::ShowWindow

Define o estado de exibição da janela.

BOOL ShowWindow(int nCmdShow) throw();

Observações

Veja ShowWindow no SDK do Windows.

Example

//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 mostrar uma janela criada por um thread diferente.

BOOL ShowWindowAsync(int nCmdShow) throw();

Observações

Veja ShowWindowAsync no SDK do Windows.

CWindow::UpdateWindow

Atualiza a área do cliente.

BOOL UpdateWindow() throw();

Observações

Veja UpdateWindow no SDK do Windows.

Example

//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 do cliente dentro do retângulo especificado.

BOOL ValidateRect(LPCRECT lpRect) throw();

Observações

Veja ValidateRect no SDK do Windows.

CWindow::ValidateRgn

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

BOOL ValidateRgn(HRGN hRgn) throw();

Observações

Veja ValidateRgn no SDK do Windows.

CWindow::WinHelp

Ajuda para iniciar o Windows.

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

Observações

Veja WinHelp no SDK do Windows.

Consulte também

Visão geral da classe