CWnd Classe

Fornece a funcionalidade base de todas as classes de janelas na Microsoft Foundation Class Library.

Sintaxe

class CWnd : public CCmdTarget

Membros

Construtores Públicos

Métodos Públicos

Métodos Protegidos

Operadores Públicos

Membros de Dados Públicos

Observações

Um CWnd objeto é distinto de uma janela Windows, mas os dois estão fortemente ligados. Um CWnd objeto é criado ou destruído pelo construtor e destruidor CWnd . A janela do Windows, por outro lado, é uma estrutura de dados interna ao Windows que é criada por uma Create função membro e destruída pelo CWnd destruidor virtual. A DestroyWindow função destrói a janela do Windows sem destruir o objeto.

A CWnd classe e o mecanismo de mapa de mensagens escondem a WndProc função. As mensagens de notificação recebidas do Windows são automaticamente encaminhadas através do mapa de mensagens para as funções adequadas do membro OnMessageCWnd . Sobrepões uma função de membro OnMessage para tratar a mensagem particular de um membro nas tuas classes derivadas.

A CWnd classe também permite criar uma janela filho do Windows para a sua aplicação. Derive uma classe a partir de CWnd, e depois adicione variáveis membro à classe derivada para armazenar dados específicos da sua aplicação. Implemente funções de membro do manipulador de mensagens e um mapa de mensagens na classe derivada para especificar o que acontece quando as mensagens são direcionadas para a janela.

Cria-se uma janela filho em dois passos. Primeiro, chama o construtor CWnd para construir o CWnd objeto, depois chama a Create função membro para criar a janela filho e anexá-la ao CWnd objeto.

Quando o utilizador termina a sua janela filha, destrua o CWnd objeto ou chame a DestroyWindow função membro para remover a janela e destruir as suas estruturas de dados.

Dentro da Microsoft Foundation Class Library, são derivadas classes adicionais para CWnd fornecer tipos específicos de janelas. Muitas destas classes, incluindo CFrameWnd, CMDIFrameWnd, CMDIChildWnd, CView, e CDialog, são concebidas para derivação posterior. As classes de controlo derivadas de CWnd, como CButton, podem ser usadas diretamente ou podem ser usadas para dedução adicional de classes.

Para mais informações sobre a utilização CWndde , veja Frame Windows e Objetos Janela.

Hierarquia de herança

CObject

CCmdTarget

CWnd

Requerimentos

Cabeçalho: afxwin.h

CWnd::accDoDefaultAction

Chamado pelo framework para realizar a ação padrão do objeto.

virtual HRESULT accDoDefaultAction(VARIANT varChild);

Parâmetros

varCriança
Especifica se a ação padrão a invocar é a do objeto ou de um dos elementos filhos do objeto. Este parâmetro pode ser CHILDID_SELF (para realizar a ação padrão do objeto) ou um ID filho (para executar a ação padrão de um dos elementos filhos do objeto).

Valor de retorno

Devolve S_OK em caso de sucesso, um código de erro COM em caso de falha. Ver valores de retorno em IAccessible::accDoDefaultAction no SDK do Windows.

Observações

Esta função faz parte do suporte de Acessibilidade Ativa da MFC.

Substitua esta função na sua CWndclasse derivada para executar a ação padrão do seu objeto. Para mais informações, consulte IAccessible::accDoDefaultAction no SDK do Windows.

CWnd::accHitTest

Chamado pela estrutura para recuperar o elemento filho ou objeto filho em um determinado ponto na tela.

virtual HRESULT accHitTest(
    long xLeft,
    long yTop,
    VARIANT* pvarChild);

Parâmetros

xLeft
Coordenada X do ponto a ser testado (em unidades de ecrã).

yTop
Coordenada Y do ponto a ser testado (em unidades de ecrã).

pvarChild
Recebe informação que identifica o objeto no ponto especificado por xLeft e yTop. Veja pvarID no IAccessible::accHitTest SDK do Windows.

Valor de retorno

Retornos S_OK em caso de sucesso, um código de erro COM em caso de falha. Veja valores de retorno em IAccessible::accHitTest no SDK do Windows.

Observações

Esta função faz parte do suporte de Acessibilidade Ativa da MFC.

Substitua esta função na sua CWndclasse derivada se tiver elementos de interface de utilizador sem janelas (exceto os controlos ActiveX sem janelas, que o MFC gere).

Para obter mais informações, consulte IAccessible::accHitTest no SDK do Windows.

CWnd::accLocation

Chamado pela estrutura para recuperar o local da tela atual do objeto especificado.

virtual HRESULT accLocation(
    long* pxLeft,
    long* pyTop,
    long* pcxWidth,
    long* pcyHeight,
    VARIANT varChild);

Parâmetros

pxLeft
Recebe a coordenada x do canto superior esquerdo do objeto (em unidades de ecrã).

pyTop
Recebe a coordenada y do canto superior esquerdo do objeto (em unidades de ecrã).

pcxWidth
Recebe a largura do objeto (em unidades de ecrã).

pcyHeight
Recebe a altura do objeto (em unidades de ecrã).

varChild
Especifica se a localização a recuperar é a do objeto ou de um dos elementos filhos do objeto. Este parâmetro pode ser ( CHILDID_SELF para obter informação sobre o objeto) ou um ID filho (para obter informação sobre o elemento filho do objeto).

Valor de retorno

Devolve S_OK em caso de sucesso, um código de erro COM em caso de falha. Veja valores de retorno em IAccessible::accLocation no SDK do Windows.

Observações

Substitua esta função na sua CWndclasse derivada se tiver elementos de interface de utilizador sem janelas (exceto os controlos ActiveX sem janelas, que o MFC gere).

Para obter mais informações, consulte IAccessible::accLocation no SDK do Windows.

CWnd::accNavigate

Chamado pelo framework para percorrer até outro elemento da interface de utilizador dentro de um contentor e, se possível, recuperar o objeto.

virtual HRESULT accNavigate(
    long navDir,
    VARIANT varStart,
    VARIANT* pvarEndUpAt);

Parâmetros

navDir
Especifica a direção a seguir. Veja navDir no IAccessible::accNavigate SDK do Windows.

varStart
Especifica o objeto inicial. Veja varStart no IAccessible::accNavigate SDK do Windows.

pvarEndUpAt
Recebe informação sobre o objeto de interface de utilizador de destino. Veja pvarEnd no IAccessible::accNavigate SDK do Windows.

Valor de retorno

Retornos S_OK em caso de sucesso, um código de erro COM em caso de falha. Veja valores de retorno em IAccessible::accNavigate no SDK do Windows.

Observações

Esta função faz parte do suporte de Acessibilidade Ativa da MFC.

Substitua esta função na sua CWndclasse derivada se tiver elementos de interface de utilizador sem janelas (exceto os controlos ActiveX sem janelas, que o MFC gere).

Para obter mais informações, consulte IAccessible::accNavigate no SDK do Windows.

CWnd::accSelect

Chamado pela estrutura para modificar a seleção ou mover o foco do teclado do objeto especificado.

virtual HRESULT accSelect(
    long flagsSelect,
    VARIANT varChild);

Parâmetros

flagsSelect
Especifica como alterar a seleção ou foco atual. Veja flagsSelect no IAccessible::accSelect SDK do Windows.

varChild
Especifica o objeto a ser selecionado. Este parâmetro pode ser tanto CHILDID_SELF (para selecionar o próprio objeto) como um ID filho (para selecionar um dos filhos do objeto).

Valor de retorno

Retornos S_OK em caso de sucesso, um código de erro COM em caso de falha. Veja valores de retorno em IAccessible::accSelect no SDK do Windows.

Observações

Esta função faz parte do suporte de Acessibilidade Ativa da MFC.

Substitua esta função na sua CWndclasse derivada se tiver elementos de interface de utilizador sem janelas (exceto os controlos ActiveX sem janelas, que o MFC gere).

Para obter mais informações, consulte IAccessible::accSelect no SDK do Windows.

CWnd::AnimateWindow

Produz efeitos especiais ao mostrar ou esconder janelas.

BOOL AnimateWindow(
    DWORD dwTime,
    DWORD dwFlags);

Parâmetros

dwTime
Especifica quanto tempo demora a reproduzir a animação, em milissegundos. Normalmente, uma animação demora 200 milissegundos a ser executada.

dwFlags
Especifica o tipo de animação. Para uma lista completa de valores possíveis, veja AnimateWindow.

Valor de retorno

Não nula se a função tiver sucesso; caso contrário, 0.

Observações

Esta função de membro emula a funcionalidade da função AnimateWindow, conforme descrito no SDK do Windows.

CWnd::ArrangeIconicWindows

Organiza todas as janelas filhos minimizadas (icónicas).

UINT ArrangeIconicWindows();

Valor de retorno

A altura de uma fila de ícones se a função for bem-sucedida; caso contrário, 0.

Observações

Esta função dos membros também organiza ícones na janela do ambiente de trabalho, que cobre todo o ecrã. A GetDesktopWindow função membro recupera um ponteiro para o objeto janela do ambiente de trabalho.

Para organizar janelas filhos icónicas do MDI numa janela de cliente MDI, ligue CMDIFrameWnd::MDIIconArrangepara .

Example

// arrange minimized MDI child windows
// called from menu item; CMdiChildFrame is derived from CMDIChildWnd
void CMdiChildFrame::OnActionArrangeIconicWindows()
{
   UINT height = GetParent()->ArrangeIconicWindows();   
   TRACE(_T("height = %d\n"), height);
}

CWnd::Attach

Anexa uma janela Windows a um CWnd objeto.

BOOL Attach(HWND hWndNew);

Parâmetros

hWndNew
Especifica um handle para uma janela do Windows.

Valor de retorno

Não nulo se for bem-sucedido; caso contrário, 0.

Example

Este exemplo mostra como usar Attach e Detach mapear para a janela do cliente MDI.

// Declare a CWnd member of CMainFrame
public:
CWnd m_wndMDIClient;

// detach MDI client window in CMainFrame destructor
m_wndMDIClient.Detach();

// In CMainFrame::OnCreate, attach MDI client window

if (CMDIFrameWnd::OnCreate(lpCreateStruct) == -1)
   return -1;

// attach MDI client window
if (m_wndMDIClient.Attach(m_hWndMDIClient) == 0)
{
   TRACE(_T("Failed to attach MDIClient.\n"));
   return -1; // fail to create
}

CWnd::BeginModalState

Chame essa função de membro para criar uma janela de quadro modal.

virtual void BeginModalState();

CWnd::BeginPaint

Prepara-se CWnd para a pintura e preenche uma PAINTSTRUCT estrutura de dados com informação sobre a pintura.

CDC* BeginPaint(LPPAINTSTRUCT lpPaint);

Parâmetros

lpPaint
Aponta para a PAINTSTRUCT estrutura que deve receber informações sobre pintura.

Valor de retorno

Identifica o contexto do dispositivo para CWnd. O ponteiro pode ser temporário e não deve ser armazenado para além do âmbito de EndPaint.

Observações

A estrutura de pintura contém uma RECT estrutura de dados que tem o retângulo mais pequeno que envolve completamente a região de atualização e um flag que especifica se o fundo foi apagado.

A região de atualização é definida pelas Invalidate, InvalidateRect, ou InvalidateRgn funções membros e pelo sistema depois de dimensionar, mover, criar, deslocar ou realizar qualquer outra operação que afete a área do cliente. Se a região de atualização estiver marcada para apagamento, BeginPaint envia uma WM_ONERASEBKGND mensagem.

Não chame a BeginPaint função membro exceto em resposta a uma WM_PAINT mensagem. Cada chamada à BeginPaint função membro deve ter uma chamada correspondente à EndPaint função membro. Se o caret estiver na área a pintar, a BeginPaint função elemento esconde automaticamente o caret para evitar que seja apagado.

Example

// Use BeginPaint and EndPaint when responding to WM_PAINT message
// An alternative method is to use CPaintDC in place of
// BeginPaint and EndPaint
void CMdiView::OnPaint()
{
   PAINTSTRUCT ps;
   CDC *pDC = BeginPaint(&ps);

   pDC->Rectangle(CRect(0, 0, 100, 100));

   EndPaint(&ps);

   // Do not call CView::OnPaint() for painting messages
}

CWnd::BindDefaultProperty

Vincula a propriedade simples limitada por defeito do objeto chamador (como um controlo de edição), conforme marcada na biblioteca de tipos, ao cursor subjacente definido pelas DataSourcepropriedades , UserName, Password, e SQL do controlo de fonte de dados.

void BindDefaultProperty(
    DISPID dwDispID,
    VARTYPE vtProp,
    LPCTSTR szFieldName,
    CWnd* pDSCWnd);

Parâmetros

dwDispID
Especifica o DISPID de uma propriedade num controlo ligado a dados que deve ser ligado a um controlo de fonte de dados.

vtProp
Especifica o tipo da propriedade a ser encadenada. Por exemplo, VT_BSTR, VT_VARIANT, e assim sucessivamente.

szFieldName
Especifica o nome da coluna, no cursor fornecido pelo controle da fonte de dados, à qual a propriedade será vinculada.

pDSCWnd
Aponta para a janela que alberga o controlo da fonte de dados ao qual a propriedade será vinculada. Ligue GetDlgItem com o ID de recurso da janela host do DCS para recuperar este ponteiro.

Observações

O CWnd objeto no qual você chama essa função deve ser um controle ligado a dados.

Example

BindDefaultProperty pode ser usado no seguinte contexto:

BOOL CMyDlg::OnInitDialog()
{
   CWnd *pDSC = GetDlgItem(IDC_DATASOURCE);
   CWnd *pMyBound = GetDlgItem(IDC_MYBOUNDCTRL1);
   pMyBound->BindDefaultProperty(0x1, VT_BSTR, _T("ContactFirstName"), pDSC);
   return TRUE;
}

CWnd::BindProperty

Liga uma propriedade limitada por cursor num controlo ligado a dados (como um controlo de grelha) a um controlo de fonte de dados e regista essa relação com o gestor de ligação MFC.

void BindProperty(
    DISPID dwDispId,
    CWnd* pWndDSC);

Parâmetros

dwDispId
Especifica o DISPID de uma propriedade num controlo ligado a dados que deve ser ligado a um controlo de fonte de dados.

pWndDSC
Aponta para a janela que alberga o controlo da fonte de dados ao qual a propriedade será vinculada. Ligue GetDlgItem com o ID de recurso da janela host do DCS para recuperar este ponteiro.

Observações

O CWnd objeto no qual você chama essa função deve ser um controle ligado a dados.

Example

BindProperty pode ser usado no seguinte contexto:

BOOL CMyDlg::OnInitDialog()
{
   CWnd *pDSC = GetDlgItem(IDC_DATASOURCE);
   CWnd *pMyBound = GetDlgItem(IDC_MYBOUNDCTRL2);
   pMyBound->BindProperty(0x1, pDSC);
   return TRUE;
}

CWnd::BringWindowToTop

Leva CWnd para o topo de uma pilha de janelas sobrepostas.

void BringWindowToTop();

Observações

Além disso, BringWindowToTop ativa janelas pop-up, top-level e filhos MDI. A BringWindowToTop função membro deve ser usada para revelar qualquer janela que esteja parcial ou completamente obscurecida por janelas sobrepostas.

Esta função apenas chama a função Win32 BringWindowToTop . Chama a SetWindowPos função para alterar a posição de uma janela na ordem Z. A BringWindowToTop função não altera o estilo da janela para a tornar numa janela de topo. Para mais informações, veja Qual é a diferença entre HWND_TOP e HWND_TOPMOST

Example

// Moves MDI child windows to the top when a mouse passes
// over it. CMdiView is derived from CView.
void CMdiView::OnMouseMove(UINT nFlags, CPoint point) 
{
   UNREFERENCED_PARAMETER(nFlags);
   UNREFERENCED_PARAMETER(point);

   GetParentFrame()->BringWindowToTop();
}

CWnd::CalcWindowRect

Calcula o retângulo de janela que pode conter o retângulo cliente especificado.

virtual void CalcWindowRect(
    LPRECT lpClientRect,
    UINT nAdjustType = adjustBorder);

Parâmetros

lpClientRect
[inspira, expira] Apontar para uma estrutura retangular. Na entrada, esta estrutura contém o retângulo cliente. Depois de concluído o método, esta estrutura contém o retângulo de janela que pode conter o retângulo cliente especificado.

nAdjustType
[dentro] Use CWnd::adjustBorder para calcular coordenadas de janela sem o WS_EX_CLIENTEDGE estilo; caso contrário, use CWnd::adjustOutside.

Observações

O tamanho do retângulo de janela calculado não inclui espaço para uma barra de menus.

Para mais restrições de uso, veja AdjustWindowRectEx.

Example

// Uses CalcWindowRect to determine size for new CFrameWnd
// based on the size of the current view. The end result is a
// top level frame window of the same size as CMdiView's frame.
void CMdiView::OnMyCreateFrame()
{
   CFrameWnd *pFrameWnd = new CFrameWnd;
   CRect myRect;
   GetClientRect(myRect);
   pFrameWnd->Create(NULL, _T("My Frame"));
   pFrameWnd->CalcWindowRect(&myRect, CWnd::adjustBorder);
   pFrameWnd->MoveWindow(0, 0, myRect.Width(), myRect.Height());
   pFrameWnd->ShowWindow(SW_SHOW);
}

CWnd::CancelToolTips

Chame esta função membro para remover uma dica de ferramenta do ecrã se uma dica estiver atualmente apresentada.

static void PASCAL CancelToolTips(BOOL bKeys = FALSE);

Parâmetros

bKeys
TRUE cancelar dicas de ferramenta quando uma tecla é pressionada e definir o texto da barra de estado para o padrão; caso contrário FALSE.

Observações

Example

// In this example, tool tips were set up to
// pop up when the user moves the mouse
// over this edit control.
// If the mouse is moved to the upper left-hand
// corner, the tool tip would disappear because of
// calling CancelToolTips.
void CMyEdit::OnMouseMove(UINT nFlags, CPoint point)
{
   CRect corner(0, 0, 10, 10);
   if (corner.PtInRect(point))
      CancelToolTips();
   CEdit::OnMouseMove(nFlags, point);
}

CWnd::CenterWindow

Centra uma janela em relação ao seu progenitor.

void CenterWindow(CWnd* pAlternateOwner = NULL);

Parâmetros

pAlternateOwner
Aponta para uma janela alternativa relativamente à qual estará centrado (diferente da janela principal).

Observações

Normalmente é chamado de CDialog::OnInitDialog para centrar as caixas de diálogo em relação à janela principal da aplicação. Por defeito, a função centra as janelas filhas em relação à janela mãe, e as janelas pop-up em relação ao dono. Se a janela pop-up não for propriedade, está centrada em relação ao ecrã. Para centralizar uma janela em relação a uma janela específica que não seja o proprietário ou o pai, o pAlternateOwner parâmetro pode ser definido para uma janela válida. Para forçar o centramento em relação ao ecrã, passa o valor devolvido por CWnd::GetDesktopWindow .pAlternateOwner

Example

BOOL CAboutDlg::OnInitDialog()
{
   CDialog::OnInitDialog();

   CenterWindow();

   return TRUE;
}

CWnd::ChangeClipboardChain

Remove CWnd da cadeia de visualizadores do Clipboard e cria a janela especificada pelo hWndNext descendente do CWnd antepassado na cadeia.

BOOL ChangeClipboardChain(HWND hWndNext);

Parâmetros

hWndNext
Identifica a janela que se segue CWnd na cadeia Clipboard-viewer.

Valor de retorno

Não nulo se for bem-sucedido; caso contrário, 0.

CWnd::CheckDlgButton

Seleciona (coloca uma marca de verificação ao lado) ou limpa (remove uma marca de verificação de) um botão, ou altera o estado de um botão de três estados.

void CheckDlgButton(
    int nIDButton,
    UINT nCheck);

Parâmetros

nIDButton
Especifica o botão a ser modificado.

nCheck
Especifica a ação a tomar. Se nCheck for diferente de zero, a CheckDlgButton função membro coloca uma marca de verificação ao lado do botão; se for 0, a marca de verificação é removida. Para botões de três estados, se nCheck for 2, o estado do botão é indeterminado.

Observações

A CheckDlgButton função envia uma BM_SETCHECK mensagem para o botão especificado.

Example

// Sets 3 check buttons in various ways.  Note BST_INDETERMINATE
// requires BS_3STATE or BS_AUTO3STATE in the button's style.
void CMyDlg::OnMarkButtons()
{
   CheckDlgButton(IDC_CHECK1, BST_UNCHECKED);     // 0
   CheckDlgButton(IDC_CHECK2, BST_CHECKED);       // 1
   CheckDlgButton(IDC_CHECK3, BST_INDETERMINATE); // 2
}

CWnd::CheckRadioButton

Seleciona (adiciona uma marca de verificação) a um dado botão de acesso num grupo e limpa (remove uma marca de verificação de) todos os outros botões de opção do grupo.

void CheckRadioButton(
    int nIDFirstButton,
    int nIDLastButton,
    int nIDCheckButton);

Parâmetros

nIDFirstButton
Especifica o identificador inteiro do primeiro botão de acesso do grupo.

nIDLastButton
Especifica o identificador inteiro do último botão de acesso do grupo.

nIDCheckButton
Especifica o identificador inteiro do botão de acesso a verificar.

Observações

A CheckRadioButton função envia uma BM_SETCHECK mensagem para o botão de acesso especificado.

Example

// Of the 4 radio buttons, selects radio button 3.
void CMyDlg::OnMarkRadio()
{
   CheckRadioButton(IDC_RADIO1, IDC_RADIO4, IDC_RADIO3);
}

CWnd::ChildWindowFromPoint

Determina qual, se houver, das janelas filhas a CWnd que pertencem o ponto especificado.

CWnd* ChildWindowFromPoint(POINT point) const;

CWnd* ChildWindowFromPoint(
    POINT point,
    UINT nFlags) const;

Parâmetros

point
Especifica as coordenadas do cliente do ponto a ser testado.

nflags
Especifica quais as janelas filhas a saltar. Este parâmetro pode ser uma combinação dos seguintes valores:

Valor de retorno

Identifica a janela filho que contém o ponto. É NULL se o ponto dado estiver fora da área do cliente. Se o ponto estiver dentro da área do cliente mas não estiver contido em nenhuma janela filha, CWnd é devolvido.

Esta função membro devolverá uma janela filha oculta ou desativada que contenha o ponto especificado.

Mais do que uma janela pode conter o ponto dado. No entanto, esta função devolve apenas o CWnd* da primeira janela encontrada que contém o ponto.

O CWnd* que é devolvido pode ser temporário e não deve ser armazenado para uso posterior.

Example

void CMyDlg::OnFindCenterChild() 
{
   CRect rect;
   GetClientRect(&rect);
   CWnd* pWnd = ChildWindowFromPoint(
      CPoint(rect.Width()/2, rect.Height()/2), 
      // Top left is always 0, 0.
      CWP_SKIPINVISIBLE);
   TRACE(_T("Center window is 0x%08x\n"), pWnd->m_hWnd);
}

CWnd::ClientToScreen

Converte as coordenadas do cliente de um dado ponto ou retângulo no ecrã em coordenadas do ecrã.

void ClientToScreen(LPPOINT lpPoint) const;
void ClientToScreen(LPRECT lpRect) const;

Parâmetros

lpPoint
Aponta para uma POINT estrutura ou CPoint objeto que contém as coordenadas do cliente a converter.

lpRect
Aponta para uma RECT estrutura ou CRect objeto que contém as coordenadas do cliente a converter.

Observações

A ClientToScreen função membro usa as coordenadas do cliente na POINT estrutura ou RECT no CPoint objeto ou CRect apontado por lpPoint ou lpRect para calcular novas coordenadas de ecrã; depois substitui as coordenadas na estrutura pelas novas coordenadas. As novas coordenadas do ecrã são relativas ao canto superior esquerdo do ecrã do sistema.

A ClientToScreen função membro assume que o ponto ou retângulo dado está nas coordenadas do cliente.

Example

// resize dialog to client's size
void CMyDlg::OnSizeToClient()
{
   CRect myRect;
   GetClientRect(&myRect);

   ClientToScreen(myRect);
   MoveWindow(myRect.left, myRect.top,
              myRect.Width(), myRect.Height());
}

CWnd::CloseWindow

Minimiza a janela.

void CloseWindow();

Observações

Esta função de membro emula a funcionalidade da função CloseWindow, conforme descrito no SDK do Windows.

CWnd::ContinueModal

Esta função membro é chamada por RunModalLoop para determinar quando o estado modal deve ser retirado.

virtual BOOL ContinueModal();

Valor de retorno

Não nulo se o loop modal for continuado; 0 quando EndModalLoop é chamado.

Observações

Por defeito, devolve um valor diferente de zero até EndModalLoop ser chamado.

CWnd::Create

Cria a janela filha especificada e anexa-a ao CWnd objeto.

virtual BOOL Create(
    LPCTSTR lpszClassName,
    LPCTSTR lpszWindowName,
    DWORD dwStyle,
    Const RECT& rect,
    CWnd* pParentWnd,
    UINT nID,
    CCreateContext* pContext = NULL);

Parâmetros

lpszClassName
[dentro] Apontador para uma cadeia terminada por nulo que contém o nome de uma classe de janela do sistema registada; ou o nome de uma classe de janela de sistema pré-definida.

lpszWindowName
[dentro] Apontador para uma cadeia terminada em nulo que contém o nome de exibição da janela; caso contrário NULL , sem nome de exibição de janela.

dwStyle
[dentro] Combinação bit a bit (OR) de estilos de janelas. A WS_POPUP opção não é um estilo válido.

rect
[dentro] O tamanho e a localização da janela em relação ao canto superior esquerdo da janela principal.

pParentWnd
[dentro] Aponta para a janela principal.

nID
[dentro] ID da janela.

pContext
[dentro] Apontador para uma CCreateContext estrutura usada para personalizar a arquitetura de visualização do documento para a aplicação.

Valor de retorno

TRUE se o método fosse bem-sucedido; caso contrário FALSE.

Observações

Use a AfxRegisterWndClass função para registar classes de janela. Classes de janela definidas pelo utilizador estão disponíveis no módulo onde estão registadas.

O CWnd::OnCreate método é chamado antes de o Create método regressar e antes de a janela se tornar visível.

Example

// Dynamically create static control using CWnd::Create,
// instead of with CStatic::Create, which doesn't
// need the "STATIC" class name.
void CMyDlg::OnCreateStatic() 
{
   // m_pWndStatic is a CWnd* member of CMyDlg
   m_pWndStatic = new CWnd;
   m_pWndStatic->Create(_T("STATIC"), _T("Hi"), WS_CHILD | WS_VISIBLE,
       CRect(0, 0, 20, 20), this, 1234);
}

CWnd::CreateAccessibleProxy

Cria um proxy de Acessibilidade Ativa para o objeto especificado.

virtual HRESULT CreateAccessibleProxy(
    WPARAM wParam,
    LPARAM lParam,
    LRESULT* pResult);

Parâmetros

wParam
Identifica o objeto acedido pelo proxy de Acessibilidade Ativa. Pode ser um dos seguintes valores

lParam
Fornece informação adicional dependente da mensagem.

pResult
Um apontador para um LRESULT que armazena o código do resultado.

Observações

Cria um proxy de Acessibilidade Ativa para o objeto especificado.

CWnd::CreateCaret

Cria uma nova forma para o caret do sistema e reivindica a propriedade do caret.

void CreateCaret(CBitmap* pBitmap);

Parâmetros

pBitmap
Identifica o bitmap que define a forma do caret.

Observações

O bitmap deve ter sido previamente criado pela CBitmap::CreateBitmap função membro, pela CreateDIBitmap função Windows ou pela CBitmap::LoadBitmap função membro.

CreateCaret destrói automaticamente a forma do caret anterior, se existir, independentemente da janela que possui o caret. Uma vez criado, o caret é inicialmente escondido. Para mostrar o carente, deve ser chamada a ShowCaret função elementar.

O caret do sistema é um recurso partilhado. CWnd Deve criar um caret apenas quando tiver o foco de entrada ou estiver ativo. Deve destruir o caret antes de perder o foco de entrada ou ficar inativo.

Example

// Changes the caret of the edit control in this dialog box
void CMyDlg::OnChangeCaret()
{
   m_pBitmapCaret = new CBitmap;
   m_pBitmapCaret->LoadBitmap(IDB_HAPPY_BITMAP);
   m_MyEdit.CreateCaret(m_pBitmapCaret);
   m_MyEdit.ShowCaret();
}

CWnd::CreateControl

Use esta função membro para criar um controlo ActiveX que será representado no programa MFC por um CWnd objeto.

BOOL CreateControl(
    LPCTSTR pszClass,
    LPCTSTR pszWindowName,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID,
    CFile* pPersist = NULL,
    BOOL bStorage = FALSE,
    BSTR bstrLicKey = NULL);

BOOL CreateControl(
    REFCLSID clsid,
    LPCTSTR pszWindowName,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID,
    CFile* pPersist = NULL,
    BOOL bStorage = FALSE,
    BSTR bstrLicKey = NULL);

BOOL CreateControl(
    REFCLSID clsid,
    LPCTSTR pszWindowName,
    DWORD dwStyle,
    const POINT* ppt,
    const SIZE* psize,
    CWnd* pParentWnd,
    UINT nID,
    CFile* pPersist = NULL,
    BOOL bStorage = FALSE,
    BSTR bstrLicKey = NULL);

Parâmetros

pszClass
Esta cadeia pode conter o "nome curto" OLE (ProgID) para a classe. Por exemplo, "CIRC3.Circ3Ctrl.1". O nome tem de corresponder ao mesmo nome registado pelo controlo. Alternativamente, a corda pode conter a forma de corda de um CLSID, contida entre chaves. Por exemplo, "{9DBAFCCF-592F-101B-85CE-00608CEC297B}". Em qualquer dos casos, CreateControl converte a cadeia para o correspondente ID de classe.

pszWindowName
Um ponteiro para o texto a ser apresentado no controlo. Define o valor da propriedade Caption ou Text do controlo (se houver). Se NULL, a propriedade Legenda ou Texto do controlo não é alterada.

dwStyle
Estilos do Windows. Os estilos disponíveis estão listados em Observações.

rect
Especifica o tamanho e a posição do controle. Pode ser um CRect objeto ou uma RECT estrutura.

ppt
Aponta para uma POINT estrutura ou CPoint objeto que contém o canto superior esquerdo do controlo.

pSize
Aponta para uma SIZE estrutura ou CSize objeto que contém o tamanho do controlo

pParentWnd
Especifica a janela pai do controlo. Não pode ser NULL.

nID
Especifica o ID do controlo.

pPersist
Um apontador para um CFile que contém o estado persistente do controlo. O valor predefinido é NULL, indicando que o controlo se inicializa sem restaurar o seu estado a partir de qualquer armazenamento persistente. Se não NULLfor , deve ser um apontador para um CFileobjeto derivado em que contém os dados persistentes do controlo, sob a forma de um fluxo ou de um armazenamento. Estes dados poderiam ter sido guardados numa ativação anterior do cliente. O CFile pode conter outros dados, mas deve ter o seu ponteiro de leitura-escrita definido para o primeiro byte de dados persistentes no momento da chamada para CreateControl.

bStorage
Indica se os dados devem pPersist ser interpretados como IStorage ou IStream dados. Se os dados em pPersist forem um armazenamento, bStorage deve ser TRUE. Se os dados em pPersist forem um fluxo, bStorage deverá ser FALSE. O valor predefinido é FALSE.

bstrLicKey
Dados opcionais da chave da licença. Estes dados são necessários apenas para criar controlos que exijam uma chave de licença em tempo de execução. Se o controlo suportar licenciamento, deve fornecer uma chave de licença para que a criação do controlo tenha sucesso. O valor predefinido é NULL.

clsid
O ID de classe único do controlo.

Valor de retorno

Não nulo se for bem-sucedido; caso contrário, 0.

Observações

CreateControl é um análogo direto da CWnd::Create função, que cria a janela para um CWnd. CreateControl cria um controlo ActiveX em vez de uma janela comum.

Apenas um subconjunto das flags do Windows dwStyle é suportado para CreateControl:

• WS_VISIBLE Cria uma janela que é inicialmente visível. É necessário se quiseres que o controlo seja visível imediatamente, como janelas normais.

• WS_DISABLED Cria uma janela que está inicialmente desativada. Uma janela desativada não pode receber entrada do utilizador. Pode ser definido se o controlo tiver uma propriedade Ativada.

• WS_BORDER Cria uma janela com uma borda fina. Pode ser definido se o controlo tiver uma BorderStyle propriedade.

• WS_GROUP Especifica o primeiro controlo de um grupo de controlos. O utilizador pode alterar o foco do teclado de um controlo no grupo para o seguinte usando as teclas de direção. Todos os controlos definidos com o WS_GROUP estilo após o primeiro controlo pertencem ao mesmo grupo. O próximo controlo com o WS_GROUP estilo termina o grupo e inicia o grupo seguinte.

• WS_TABSTOP Especifica um controlo que pode receber o foco do teclado quando o utilizador pressiona a tecla TAB. Pressionar a tecla TAB muda o foco do teclado para o próximo controlo do WS_TABSTOP estilo.

Example

class CGenocx : public CWnd
{
protected:
   DECLARE_DYNCREATE(CGenocx)
public:
   CLSID const &GetClsid()
   {
      static CLSID const clsid = {0x20DD1B9E, 0x87C4, 0x11D1, {0x8B, 0xE3, 0x0, 0x0, 0xF8, 0x75, 0x4D, 0xA1}};
      return clsid;
   }

   // This code is generated by the Control Wizard.
   // It wraps the call to CreateControl in the call to Create.
   virtual BOOL Create(LPCTSTR lpszClassName, LPCTSTR lpszWindowName, DWORD dwStyle,
                       const RECT &rect, CWnd *pParentWnd, UINT nID,
                       CCreateContext *pContext = NULL)
   {
      UNREFERENCED_PARAMETER(pContext);
      UNREFERENCED_PARAMETER(lpszClassName);

      return CreateControl(GetClsid(), lpszWindowName, dwStyle, rect, pParentWnd, nID);
   }

   // remainder of class declaration omitted...

CWnd::CreateEx

Cria a janela especificada e anexa-a ao CWnd objeto.

virtual BOOL CreateEx(
    DWORD dwExStyle,
    LPCTSTR lpszClassName,
    LPCTSTR lpszWindowName,
    DWORD dwStyle,
    int x,
    int y,
    int nWidth,
    int nHeight,
    HWND hWndParent,
    HMENU nIDorHMenu,
    LPVOID lpParam = NULL);

virtual BOOL CreateEx(
    DWORD dwExStyle,
    LPCTSTR lpszClassName,
    LPCTSTR lpszWindowName,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID,
    LPVOID lpParam = NULL);

Parâmetros

dwExStyle
Combinação bit a bit (OR) de estilos de janelas estendidas; caso contrário NULL , para o estilo padrão de janela estendida.

lpszClassName
Apontador para uma cadeia terminada por nulo que contém o nome de uma classe de janela do sistema registada; ou o nome de uma classe de janela de sistema pré-definida.

lpszWindowName
Apontador para uma cadeia terminada em nulo que contém o nome de exibição da janela; caso contrário NULL , sem nome de exibição de janela.

dwStyle
Combinação bit a bit (OR) de estilos de janelas; caso contrário NULL , para o estilo de janela padrão.

x
A distância horizontal inicial da janela em relação ao lado esquerdo do ecrã ou à janela principal.

y
A distância vertical inicial da janela em relação ao topo do ecrã ou à janela principal.

nWidth
A largura, em píxeis, da janela.

nHeight
A altura, em pixels, da janela.

hwndParent
Para uma janela filha, a maçaneta da janela principal; caso contrário, a maçaneta da janela do proprietário se a janela tiver um dono.

nIDorHMenu
Para uma janela criança, o ID da janela; caso contrário, o ID de um menu da janela.

lpParam
Apontador para dados do utilizador que são passados para o CWnd::OnCreate método no lpCreateParams campo.

rect
O tamanho e a localização da janela em relação ao ecrã ou à janela principal.

pParentWnd
Para uma janela filho, apontar para a janela pai; caso contrário, aponta para a janela do proprietário se a janela tiver um dono.

nID
Para uma janela criança, o ID da janela; caso contrário, o ID de um menu da janela.

Valor de retorno

TRUE se o método fosse bem-sucedido; caso contrário FALSE.

Observações

O estilo padrão de janela estendida é WS_EX_LEFT. O estilo padrão da janela é WS_OVERLAPPED.

Use a AfxRegisterWndClass função para registar classes de janela. Classes de janela definidas pelo utilizador estão disponíveis no módulo onde estão registadas.

As dimensões das janelas filhos são relativas ao canto superior esquerdo da área cliente da janela pai. As dimensões das janelas do nível superior são relativas ao canto superior esquerdo do ecrã.

O CWnd::OnCreate método é chamado antes de o CreateEx método regressar e antes de a janela se tornar visível.

Example

void CMyDlg::OnCreateExtendedControl() 
{
   // m_pWndStaticEx is a CWnd* member of CMyDlg
   m_pWndStaticEx = new CStatic;
   m_pWndStaticEx->CreateEx(WS_EX_CLIENTEDGE, // Make a client edge label.
      _T("STATIC"), _T("Hi"),
      WS_CHILD | WS_TABSTOP | WS_VISIBLE,
      5, 5, 30, 30, m_hWnd, (HMENU)2345);
}

CWnd::CreateGrayCaret

Cria um retângulo cinzento para o caret do sistema e reivindica a propriedade do caret.

void CreateGrayCaret(
    int nWidth,
    int nHeight);

Parâmetros

nWidth
Especifica a largura do caret (em unidades lógicas). Se este parâmetro for 0, a largura é definida para a largura da janela definida pelo sistema.

nHeight
Especifica a altura do caret (em unidades lógicas). Se este parâmetro for 0, a altura é definida para a altura da borda da janela definida pelo sistema.

Observações

A forma do caret pode ser uma linha ou um bloco.

Os parâmetros nWidth e nHeight especificam a largura e altura do caret (em unidades lógicas); a largura e altura exatas (em píxeis) dependem do modo de mapeamento.

A largura ou altura da borda das janelas do sistema pode ser recuperada pela GetSystemMetrics função Windows com os SM_CXBORDER índices e.SM_CYBORDER Usar a largura ou altura da borda da janela garante que o caret será visível num ecrã de alta resolução.

A CreateGrayCaret função elemento destrói automaticamente a forma de caret anterior, se existir, independentemente de qual janela detém o caret. Uma vez criado, o caret é inicialmente escondido. Para mostrar o carente, deve ser chamada a ShowCaret função elementar.

O caret do sistema é um recurso partilhado. CWnd Deve criar um caret apenas quando tiver o foco de entrada ou estiver ativo. Deve destruir o caret antes de perder o foco de entrada ou ficar inativo.

Example

// Create a 5x10 gray caret in the edit control.
void CMyDlg::OnCreateGrayCaret()
{
   m_MyEdit.CreateGrayCaret(5, 10);
   m_MyEdit.ShowCaret();
}

CWnd::CreateSolidCaret

Cria um retângulo sólido para o caret do sistema e reivindica a propriedade do caret.

void CreateSolidCaret(
    int nWidth,
    int nHeight);

Parâmetros

nWidth
Especifica a largura do caret (em unidades lógicas). Se este parâmetro for 0, a largura é definida para a largura da janela definida pelo sistema.

nHeight
Especifica a altura do caret (em unidades lógicas). Se este parâmetro for 0, a altura é definida para a altura da borda da janela definida pelo sistema.

Observações

A forma do caret pode ser uma linha ou bloco.

Os parâmetros nWidth e nHeight especificam a largura e altura do caret (em unidades lógicas); a largura e altura exatas (em píxeis) dependem do modo de mapeamento.

A largura ou altura da borda das janelas do sistema pode ser recuperada pela GetSystemMetrics função Windows com os SM_CXBORDER índices e.SM_CYBORDER Usar a largura ou altura da borda da janela garante que o caret será visível num ecrã de alta resolução.

A CreateSolidCaret função elemento destrói automaticamente a forma de caret anterior, se existir, independentemente de qual janela detém o caret. Uma vez criado, o caret é inicialmente escondido. Para mostrar o carente, deve ser chamada a ShowCaret função elementar.

O caret do sistema é um recurso partilhado. CWnd Deve criar um caret apenas quando tiver o foco de entrada ou estiver ativo. Deve destruir o caret antes de perder o foco de entrada ou ficar inativo.

Example

// Create a 5x10 solid caret in the edit control.
void CMyDlg::OnCreateSolidCaret()
{
   m_MyEdit.CreateSolidCaret(5, 10);
   m_MyEdit.ShowCaret();
}

CWnd::CWnd

Constrói um CWnd objeto.

CWnd();

Observações

A janela do Windows não é criada e anexada até que a CreateEx função do membro ou Create seja chamada.

CWnd::Default

Chama o procedimento da janela padrão.

LRESULT Default();

Valor de retorno

Depende da mensagem enviada.

Observações

O procedimento de janela por defeito fornece processamento por defeito para qualquer mensagem de janela que uma aplicação não processe. Esta função de membro garante que todas as mensagens são processadas.

Example

// This sample shows how to avoid any button handling in base class,
// if any, and call the default window procedure directly.
void CMyDlg::OnLButtonDown(UINT nFlags, CPoint point)
{
   UNREFERENCED_PARAMETER(nFlags);
   UNREFERENCED_PARAMETER(point);

   CWnd::Default();
}

CWnd::DefWindowProc

Chama o procedimento de janela por defeito, que fornece processamento por defeito para qualquer mensagem de janela que uma aplicação não processe.

virtual LRESULT DefWindowProc(
    UINT message,
    WPARAM wParam,
    LPARAM lParam);

Parâmetros

message
Especifica a mensagem do Windows a ser processada.

wParam
Especifica informação adicional dependente da mensagem.

lParam
Especifica informação adicional dependente da mensagem.

Valor de retorno

Depende da mensagem enviada.

Observações

Esta função de membro garante que todas as mensagens são processadas. Deve ser chamada com os mesmos parâmetros que os recebidos pelo procedimento janela.

CWnd::DeleteTempMap

Chamada automaticamente pelo responsável pelo tempo de inatividade do CWinApp objeto.

static void PASCAL DeleteTempMap();

Observações

Apaga quaisquer objetos temporários CWnd criados pela FromHandle função membro.

Example

// DeleteTempMap() is a static member and does not need 
// to be called within the scope of an instantiated CWnd object.
CWnd::DeleteTempMap();

CWnd::DestroyWindow

Destrói a janela das janelas presa ao CWnd objeto.

virtual BOOL DestroyWindow();

Valor de retorno

Não nula se a janela for destruída; caso contrário, 0.

Observações

A DestroyWindow função membro envia mensagens apropriadas para a janela para a desativar e remover o foco de entrada. Também destrói o menu da janela, limpa a fila de aplicação, destrói temporizadores pendentes, remove a posse do Clipboard e quebra a cadeia Clipboard-viewer se CWnd estiver no topo da cadeia de visualização. Envia WM_DESTROY e WM_NCDESTROY envia mensagens para a janela. Não destrói o CWnd objeto.

DestroyWindow é um reservatório para a limpeza. Como DestroyWindow é uma função virtual, é mostrada em qualquer CWndclasse derivada de -na Vista de Classe. Mas mesmo que sobreescrevas esta função na tua CWndclasse derivada por -, DestroyWindow não é necessariamente chamada. Se DestroyWindow não for chamado no código MFC, então tens de o chamar explicitamente no teu próprio código se quiseres que seja chamado.

Suponha, por exemplo, que sobrescreveu DestroyWindow numa CViewclasse derivada por -. Como o código-fonte MFC não chama DestroyWindow nenhuma das suas CFrameWndclasses derivadas em -, o seu overdden DestroyWindow não será chamado a menos que o chame explicitamente.

Se a janela for o pai de qualquer janela, essas janelas filhas são automaticamente destruídas quando a janela mãe é destruída. A DestroyWindow função membro destrói primeiro as janelas filhas e depois a própria janela.

A DestroyWindow função membro também destrói as caixas de diálogo sem modos criadas por CDialog::Create.

Se o CWnd ser destruído for uma janela filho e não tiver o WS_EX_NOPARENTNOTIFY estilo definido, então a WM_PARENTNOTIFY mensagem é enviada ao pai.

Example

// CModeless is a CDialog class representing a modeless dialog
// Destruction of the modeless dialog involves calling DestroyWindow in 
// OnOK() & OnCancel() handlers
void CModeless::OnOK() 
{ 
   if (!UpdateData(TRUE)) 
   {
      TRACE(_T("UpdateData failed during dialog termination\n"));
      // The UpdateData routine will set focus to correct item
      return;
   }
   DestroyWindow();
}

void CModeless::OnCancel()
{
   DestroyWindow();
}

CWnd::Detach

Desliga um handle do Windows de um CWnd objeto e devolve o handle.

HWND Detach();

Valor de retorno

A HWND ao objeto Windows.

Example

Veja o exemplo para CWnd::Attach.

CWnd::DlgDirList

Preenche uma caixa de lista com uma listagem de ficheiros ou diretórios.

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

Parâmetros

lpPathSpec
Aponta para uma cadeia terminada por null que contém o caminho ou nome do ficheiro. DlgDirList modifica esta cadeia, que deve ser suficientemente longa para conter as modificações. Para mais informações, consulte a seguinte secção "Observações".

nIDListBox
Especifica o identificador de uma caixa de lista. Se nIDListBox for 0, DlgDirList assume que não existe caixa de lista e não tenta preencher uma.

nIDStaticPath
Especifica o identificador do controlo estático-texto usado para mostrar a unidade e diretório atuais. Se nIDStaticPath for 0, DlgDirList assume que não existe tal controlo de texto.

nFileType
Especifica os atributos dos ficheiros a serem exibidos. Pode ser qualquer combinação dos seguintes valores:

• DDL_READWRITE Ler e escrever ficheiros de dados sem atributos adicionais.

• DDL_READONLY Ficheiros apenas de leitura.

• DDL_HIDDEN Ficheiros escondidos.

• DDL_SYSTEM Ficheiros do sistema.

• DDL_DIRECTORY Diretórios.

• DDL_ARCHIVE Arquivos.

• DDL_POSTMSGS LB_DIR Flag. Se a LB_DIR flag estiver definida, o Windows coloca as mensagens geradas por DlgDirList na fila da aplicação; caso contrário, são enviadas diretamente para o procedimento da caixa de diálogo.

• DDL_DRIVES Conduz. Se a DDL_DRIVES bandeira estiver definida, a DDL_EXCLUSIVE bandeira é definida automaticamente. Portanto, para criar uma lista de diretórios que inclua discos e ficheiros, deve chamar DlgDirList duas vezes: uma com a DDL_DRIVES bandeira definida e outra com as bandeiras para o resto da lista.

• DDL_EXCLUSIVE Parte exclusiva. Se o bit exclusivo estiver definido, apenas ficheiros do tipo especificado são listados; caso contrário, os ficheiros normais e os ficheiros do tipo especificado estão listados.

Valor de retorno

Diferente de zero se a função for bem-sucedida; caso contrário, 0.

Observações

DlgDirList envia LB_RESETCONTENT e LB_DIR envia mensagens para a caixa da lista. Preenche a caixa de lista especificada por nIDListBox com os nomes de todos os ficheiros que correspondem ao caminho dado por lpPathSpec.

O lpPathSpec parâmetro tem a seguinte forma:

[drive:] [ [\u]directory[\idirectory]...\u] [filename]

Neste exemplo, drive é uma letra de unidade, directory é um nome de diretório válido, e filename é um nome de ficheiro válido que deve conter pelo menos um coringa. Os coringas são um ponto de interrogação (?), que significa corresponder a qualquer personagem, e um asterisco (*), que significa corresponder a qualquer número de caracteres.

Se especificar uma string de comprimento 0 para lpPathSpec, ou se especificar apenas um nome de diretório mas não incluir qualquer especificação de ficheiro, a string será alterada para "*.*".

Se lpPathSpec incluir um nome de disco e/ou diretório, o disco e diretório atuais são alterados para o disco e diretório designados antes de preencher a caixa de lista. O controlo de texto identificado por nIDStaticPath é também atualizado com o novo nome da unidade e/ou diretório.

Depois de preenchida a caixa de lista, lpPathSpec é atualizado removendo a parte do disco e/ou diretório do caminho.

Example

// If pDialog points to a CDialog object with a list box
// with the identifier IDC_DIRLIST, this call will populate
// the box with only the non-hidden subdirectories in the root
// directory of the C:\ drive.
TCHAR path[MAX_PATH];
_tcscpy_s(path, MAX_PATH, _T("C:\\"));

pDialog->DlgDirList(path, IDC_DIRLIST, 0, DDL_EXCLUSIVE | DDL_DIRECTORY);

CWnd::DlgDirListComboBox

Preenche a caixa de lista de uma caixa de combo com uma listagem de ficheiros ou diretórios.

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

Parâmetros

lpPathSpec
Aponta para uma cadeia terminada por null que contém o caminho ou nome do ficheiro. DlgDirListComboBox modifica esta cadeia, por isso estes dados não devem estar na forma de uma cadeia literal. Consulte a seguinte secção "Observações".

nIDComboBox
Especifica o identificador de uma caixa de combo numa caixa de diálogo. Se nIDComboBox for 0, DlgDirListComboBox assume que não existe caixa de combo e não tenta preencher uma.

nIDStaticPath
Especifica o identificador do controlo estático-texto usado para mostrar a unidade e diretório atuais. Se nIDStaticPath for 0, DlgDirListComboBox assume que não existe tal controlo de texto.

nFileType
Especifica atributos de ficheiros DOS dos ficheiros a serem exibidos. Pode ser qualquer combinação dos seguintes valores:

• DDL_READWRITE Ler e escrever ficheiros de dados sem atributos adicionais.

• DDL_READONLY Ficheiros apenas de leitura.

• DDL_HIDDEN Ficheiros escondidos.

• DDL_SYSTEM Ficheiros do sistema.

• DDL_DIRECTORY Diretórios.

• DDL_ARCHIVE Arquivos.

• DDL_POSTMSGS CB_DIR Flag. Se a CB_DIR flag estiver definida, o Windows coloca as mensagens geradas por DlgDirListComboBox na fila da aplicação; caso contrário, são enviadas diretamente para o procedimento da caixa de diálogo.

• DDL_DRIVES Conduz. Se a DDL_DRIVES bandeira estiver definida, a DDL_EXCLUSIVE bandeira é definida automaticamente. Portanto, para criar uma lista de diretórios que inclua discos e ficheiros, deve chamar DlgDirListComboBox duas vezes: uma com a DDL_DRIVES bandeira definida e outra com as bandeiras para o resto da lista.

• DDL_EXCLUSIVE Parte exclusiva. Se o bit exclusivo estiver definido, apenas ficheiros do tipo especificado são listados; caso contrário, os ficheiros normais e os ficheiros do tipo especificado estão listados.

Valor de retorno

Especifica o resultado da função. É diferente de zero se uma listagem foi feita, mesmo que vazia. Um valor de retorno 0 implica que a cadeia de entrada não continha um caminho de pesquisa válido.

Observações

DlgDirListComboBox envia CB_RESETCONTENT e CB_DIR envia mensagens para a caixa combinada. Preenche a caixa de lista da caixa de combo especificada por nIDComboBox com os nomes de todos os ficheiros que correspondem ao caminho dado por lpPathSpec.

O lpPathSpec parâmetro tem a seguinte forma:

[drive:] [ [\u]directory[\idirectory]...\u] [filename]

Neste exemplo, drive é uma letra de unidade, directory é um nome de diretório válido, e filename é um nome de ficheiro válido que deve conter pelo menos um coringa. Os coringas são um ponto de interrogação (?), que significa corresponder a qualquer personagem, e um asterisco (*), que significa corresponder a qualquer número de caracteres.

Se especificar uma string de comprimento zero para lpPathSpec, o diretório atual será usado e lpPathSpec não será modificado. Se especificar apenas um nome de diretório mas não incluir qualquer especificação de ficheiro, a cadeia será alterada para "*".

Se lpPathSpec incluir um nome de disco e/ou diretório, o disco e diretório atuais são alterados para o disco e diretório designados antes de preencher a caixa de lista. O controlo de texto identificado por nIDStaticPath é também atualizado com o novo nome da unidade e/ou diretório.

Depois de preenchida a caixa de lista de combo, lpPathSpec é atualizado removendo a parte do disco e/ou diretório do caminho.

Example

// If pDialog points to a CDialog object with a combo box
// with the identifier IDC_DIRCOMBO, this call will populate
// the box with only the non-hidden subdirectories in the root
// directory of the C:\ drive.

TCHAR szPath[MAX_PATH];
_tcsncpy_s(szPath, MAX_PATH, _T("C:\\"), MAX_PATH);
pDialog->DlgDirListComboBox(szPath, IDC_DIRCOMBO, 0, DDL_EXCLUSIVE | DDL_DIRECTORY);

// Note that the first argument is a string and not a string
// literal. This is necessary because DlgDirListComboBox
// modifies the supplied string. Passing a string literal
// will result in an access violation.

CWnd::DlgDirSelect

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

BOOL DlgDirSelect(
    LPTSTR lpString,
    int nIDListBox);

Parâmetros

lpString
Aponta para um buffer que recebe a seleção atual na caixa da lista.

nIDListBox
Especifica o ID inteiro de uma caixa de lista na caixa de diálogo.

Valor de retorno

Não nulo se for bem-sucedido; caso contrário, 0.

Observações

Assume que a caixa de lista foi preenchida pela DlgDirList função membro e que a seleção é uma letra de unidade, um ficheiro ou um nome de diretório.

A DlgDirSelect função membro copia a seleção para o buffer dado por lpString. Se não houver seleção, lpString não muda.

DlgDirSelect envia LB_GETCURSEL e LB_GETTEXT envia mensagens para a caixa da lista.

Não permite que mais do que um nome de ficheiro seja devolvido a partir de uma caixa de lista. A caixa de lista não deve ser uma caixa de seleção múltipla.

CWnd::DlgDirSelectComboBox

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

BOOL DlgDirSelectComboBox(
    LPTSTR lpString,
    int nIDComboBox);

Parâmetros

lpString
Aponta para um buffer que deve receber o caminho selecionado.

nIDComboBox
Especifica o ID inteiro da caixa de combo na caixa de diálogo.

Valor de retorno

Não nulo se for bem-sucedido; caso contrário, 0.

Observações

Assume que a caixa de lista foi preenchida pela DlgDirListComboBox função membro e que a seleção é uma letra de unidade, um ficheiro ou um nome de diretório.

A DlgDirSelectComboBox função membro copia a seleção para o buffer especificado. Se não houver seleção, o conteúdo do buffer não é alterado.

DlgDirSelectComboBox envia CB_GETCURSEL e CB_GETLBTEXT envia mensagens para a caixa combinada.

Não permite que mais do que um nome de ficheiro seja devolvido a partir de uma caixa combinada.

CWnd::DoDataExchange

Chamado pelo framework para trocar e validar dados de diálogo.

virtual void DoDataExchange(CDataExchange* pDX);

Parâmetros

pDX
Um ponteiro para um CDataExchange objeto.

Observações

Nunca chames esta função diretamente. É chamada pela UpdateData função elemento. Chamar UpdateData para inicializar os controlos de uma caixa de diálogo ou recuperar dados de uma caixa de diálogo.

Quando deriva uma classe de diálogo específica para uma aplicação a partir de CDialog, precisa de sobrescrever esta função membro se quiser utilizar a troca e validação automática de dados do framework. O assistente de Adicionar Variável irá escrever uma versão sobreposta desta função membro para si, contendo o "mapa de dados" desejado das chamadas globais de função de troca de dados de diálogo (DDX) e validação (DDV).

Para gerar automaticamente uma versão sobreposta desta função membro, crie primeiro um recurso de diálogo com o editor de diálogo e, de seguida, derive uma classe de diálogo específica para cada aplicação. Depois, use o assistente Adicionar Variável para associar variáveis, dados e intervalos de validação a vários controlos na nova caixa de diálogo. O assistente então escreve o sobrescrito DoDataExchange, que contém um mapa de dados. Segue-se um exemplo de bloco de código DDX/DDV gerado pelo assistente de Adicionar Variável:

void CPenWidthsDlg::DoDataExchange(CDataExchange *pDX)
{
   CDialog::DoDataExchange(pDX);
   DDX_Text(pDX, IDC_THINPENWIDTH, m_nThinWidth);
   DDV_MinMaxInt(pDX, m_nThinWidth, 1, 20);
   DDX_Text(pDX, IDC_THICKPENWIDTH, m_nThickWidth);
   DDV_MinMaxInt(pDX, m_nThickWidth, 1, 20);
}

A DoDataExchange função membro sobreposta deve preceder as instruções macro no seu ficheiro fonte.

Para mais informações sobre troca e validação de dados de diálogo, veja Exibição e Manipulação de Dados em Formulário e Troca e Validação de Dados em Diálogo. Para uma descrição dos macros DDX_ e DDV_ gerados pelo assistente de Adicionar Variável, consulte a Nota Técnica 26.

CWnd::DragAcceptFiles

Chame esta função membro a partir de uma janela, usando um CWnd ponteiro, na função da CWinApp::InitInstance sua aplicação para indicar que a janela aceita ficheiros caídos do Gestor de Ficheiros do Windows ou do Explorador de Ficheiros.

void DragAcceptFiles(BOOL bAccept = TRUE);

Parâmetros

BAccept
Flag que indica se os ficheiros arrastados são aceites.

Observações

Apenas a janela que chama DragAcceptFiles com o bAccept parâmetro definido para TRUE se identificou como capaz de processar a mensagem WM_DROPFILESdo Windows . Por exemplo, numa aplicação MDI, se o CMDIFrameWnd ponteiro da janela for usado na DragAcceptFiles chamada de função, apenas a CMDIFrameWnd janela recebe a WM_DROPFILES mensagem. Esta mensagem não é enviada para todas as janelas abertas CMDIChildWnd . Para que uma CMDIChildWnd janela receba esta mensagem, deve ligar DragAcceptFiles com o CMDIChildWnd ponteiro da janela.

Para deixar de receber ficheiros arrastados, chame a função membro com bAccept definido para FALSE.

CWnd::DragDetect

Captura o rato e acompanha o seu movimento até o utilizador soltar o botão esquerdo, pressionar a tecla ESC ou mover o rato para fora do retângulo de arrastar em torno do ponto especificado.

BOOL DragDetect(POINT pt) const;

Parâmetros

pt
Posição inicial do rato, em coordenadas do ecrã. A função determina as coordenadas do retângulo de arrasto usando este ponto.

Valor de retorno

Se o utilizador mover o rato para fora do retângulo de arrastar enquanto mantém pressionado o botão esquerdo, o valor de retorno é diferente de zero.

Se o utilizador não mover o rato para fora do retângulo de arrastar enquanto mantém pressionado o botão esquerdo, o valor de retorno é zero.

Observações

Esta função de membro emula a funcionalidade da função DragDetect, conforme descrito no SDK do Windows.

CWnd::DrawAnimatedRects

Desenha um retângulo em wireframe e anima-o para indicar a abertura de um ícone ou a minimização ou maximização de uma janela.

BOOL DrawAnimatedRects(
    int idAni,
    CONST RECT* lprcFrom,
    CONST RECT* lprcTo);

Parâmetros

idAni
Especifica o tipo de animação. Se especificar IDANI_CAPTION, a legenda da janela irá ser animada da posição especificada por lprcFrom para a posição especificada por lprcTo. O efeito é semelhante a minimizar ou maximizar uma janela.

lprcFrom
Apontador para uma RECT estrutura que especifica a localização e o tamanho do ícone ou janela minimizada.

lprcTo
Ponteiro para uma RECT estrutura que especifica a localização e o tamanho da janela restaurada

Valor de retorno

Não nula se a função tiver sucesso; caso contrário, 0.

Observações

Esta função de membro emula a funcionalidade da função DrawAnimatedRects, conforme descrito no SDK do Windows.

CWnd::DrawCaption

Desenha uma legenda de janela.

BOOL DrawCaption(
    CDC* pDC,
    LPCRECT lprc,
    UINT uFlags);

Parâmetros

pDC
Um ponteiro para um contexto de dispositivo. A função desenha a legenda da janela para o contexto deste dispositivo.

lprc
Um ponteiro para uma RECT estrutura que especifica o retângulo delimitador para a legenda da janela.

uFlags
Especifica opções de desenho. Para uma lista completa de valores, veja DrawCaption.

Valor de retorno

Não nula se a função tiver sucesso; caso contrário, 0.

Observações

Esta função de membro emula a funcionalidade da função DrawCaption, conforme descrito no SDK do Windows.

CWnd::DrawMenuBar

Redesenha a barra de menus.

void DrawMenuBar();

Observações

Se uma barra de menu for alterada depois de o Windows criar a janela, chame esta função para desenhar a barra de menu alterada.

Example

Veja o exemplo para CWnd::GetMenu.

CWnd::EnableActiveAccessibility

Ativa funções de Acessibilidade Ativa definidas pelo utilizador.

void EnableActiveAccessibility();

Observações

O suporte padrão de Acessibilidade Ativa do MFC é suficiente para janelas e controlos padrão, incluindo controlos ActiveX; no entanto, se a sua CWndclasse -derivada contiver elementos de interface de utilizador sem janela, o MFC não tem forma de os conhecer. Nesse caso, deve sobrescrever as funções de membro Active Accessibility apropriadas na sua classe e deve chamar EnableActiveAccessibility o construtor da classe.

CWnd::EnableDynamicLayout

Ativa ou desativa o gestor de layout dinâmico. Quando o layout dinâmico está ativado, a posição e o tamanho das janelas filhos podem ajustar-se dinamicamente quando o utilizador redimensiona a janela.

void EnableDynamicLayout(BOOL bEnable = TRUE);

Parâmetros

bEnable
TRUE para permitir o layout dinâmico; FALSE para desativar o layout dinâmico.

Observações

Se quiseres ativar o layout dinâmico, tens de fazer mais do que simplesmente chamar este método. Também tens de fornecer informação dinâmica sobre a disposição das espécies, como os controlos na janela respondem às mudanças de tamanho. Pode especificar esta informação no editor de recursos, ou programaticamente, para cada controlo. Ver Layout Dinâmico.

CWnd::EnableD2DSupport

Ativa ou desativa o suporte D2D para janelas. Chame este método antes de a janela principal ser inicializada.

void EnableD2DSupport(
    BOOL bEnable = TRUE,
    BOOL bUseDCRenderTarget = FALSE);

Parâmetros

bEnable
Especifica se deve ativar ou desativar o suporte D2D.

bUseDCRenderTarget
Espécies se devem usar o alvo de renderização do Contexto do Dispositivo (DC), CDCRenderTarget. Se FALSE, CHwndRenderTarget é usado.

CWnd::EnableScrollBar

Ativa ou desativa uma ou ambas as setas de uma barra de scroll.

BOOL EnableScrollBar(
    int nSBFlags,
    UINT nArrowFlags = ESB_ENABLE_BOTH);

Parâmetros

nSBFlags
Especifica o tipo de barra de deslocamento. Pode ter um dos seguintes valores:

• SB_BOTH Ativa ou desativa as setas das barras de scroll horizontais e verticais associadas à janela.

• SB_HORZ Ativa ou desativa as setas da barra de rolagem horizontal associada à janela.

• SB_VERT Ativa ou desativa as setas da barra vertical associada à janela.

nArrowFlags
Especifica se as setas da barra de deslocamento estão ativadas ou desativadas e quais setas estão ativadas ou desativadas. Pode ter um dos seguintes valores:

• ESB_ENABLE_BOTH Ativa ambas as setas de uma barra de deslocamento (por defeito).

• ESB_DISABLE_LTUP Desativa a seta esquerda de uma barra de deslocamento horizontal ou a seta para cima de uma barra de deslocamento vertical.

• ESB_DISABLE_RTDN Desativa a seta direita de uma barra de scroll horizontal ou a seta para baixo de uma barra de scroll vertical.

• ESB_DISABLE_BOTH Desativa ambas as setas da barra de deslocamento.

Valor de retorno

Diferente de zero se as setas estiverem ativadas ou desativadas conforme especificado. Caso contrário, é 0, o que indica que as setas já estão no estado solicitado ou que ocorreu um erro.

CWnd::EnableScrollBarCtrl

Ativa ou desativa a barra de deslocação desta janela.

void EnableScrollBarCtrl(
    int nBar,
    BOOL bEnable = TRUE);

Parâmetros

nBar
O identificador da barra de deslocamento.

bEnable
Especifica se a barra de deslocamento deve ser ativada ou desativada.

Observações

Se a janela tiver um controlo de barra de scroll irmã, essa barra de scroll é utilizada; caso contrário, é usada a barra de deslocação própria da janela.

CWnd::EnableToolTips

Permite as dicas de ferramenta para a janela dada.

BOOL EnableToolTips(BOOL bEnable = TRUE);

Parâmetros

bEnable
Especifica se o controlo da tooltip está ativado ou desativado. TRUE permite o controlo; FALSE desativa o controlo.

Valor de retorno

TRUE se as dicas de ferramenta estiverem ativadas; caso contrário FALSE.

Observações

Override OnToolHitTest para fornecer a TOOLINFO estrutura ou estruturas para a janela.

Consulte TOOLINFO o SDK do Windows para mais informações sobre esta estrutura.

Simplesmente chamar EnableToolTips não é suficiente para mostrar dicas de ferramenta para os controlos do seu filho, a menos que a janela pai seja derivada de CFrameWnd. Isto deve-se ao facto CFrameWnd de fornecer um handler padrão para a TTN_NEEDTEXT notificação. Se a sua janela de pai não for derivada de CFrameWnd, ou seja, se for uma caixa de diálogo ou uma vista de formulário, as dicas de ferramenta para os controlos do seu filho não serão exibidas corretamente, a menos que forneça um handler para a TTN_NEEDTEXT notificação da tooltip. Ver dicas de ferramenta.

As dicas de ferramenta padrão fornecidas para as suas janelas EnableToolTips não têm texto associado a elas. Para recuperar texto para a dica de ferramenta ser exibida, a TTN_NEEDTEXT notificação é enviada para a janela principal do controlo da dica pouco antes da janela da dica ser exibida. Se não houver um handler para esta mensagem atribuir algum valor ao pszText membro da TOOLTIPTEXT estrutura, não será exibido texto para a dica de ferramenta.

Example

// From message map for CMdiView, a CView-derived class
ON_NOTIFY_EX_RANGE(TTN_NEEDTEXTW, 0, 0xFFFF, &CMdiView::OnToolTipNotify)
ON_NOTIFY_EX_RANGE(TTN_NEEDTEXTA, 0, 0xFFFF, &CMdiView::OnToolTipNotify)

void CMdiView::OnInitialUpdate()
{
   CView::OnInitialUpdate();

   m_Edit.Create(ES_MULTILINE | WS_CHILD | WS_VISIBLE | WS_TABSTOP | WS_BORDER,
                 CRect(10, 10, 100, 100), this, IDC_TTEDIT);
   EnableToolTips(TRUE); // enable tool tips for view
}

//Notification handler
BOOL CMdiView::OnToolTipNotify(UINT id, NMHDR *pNMHDR, LRESULT *pResult)
{
   UNREFERENCED_PARAMETER(id);
   UNREFERENCED_PARAMETER(pResult);

   // need to handle both ANSI and UNICODE versions of the message
   TOOLTIPTEXTA *pTTTA = (TOOLTIPTEXTA*)pNMHDR;
   TOOLTIPTEXTW *pTTTW = (TOOLTIPTEXTW*)pNMHDR;
   CStringA strTipText;
   UINT_PTR nID = pNMHDR->idFrom;
   if (pNMHDR->code == TTN_NEEDTEXTA && (pTTTA->uFlags & TTF_IDISHWND) ||
       pNMHDR->code == TTN_NEEDTEXTW && (pTTTW->uFlags & TTF_IDISHWND))
   {
      // idFrom is actually the HWND of the tool
      nID = ::GetDlgCtrlID((HWND)nID);
   }

   if (nID != 0) // will be zero on a separator
      strTipText.Format("Control ID = %d", nID);

   if (pNMHDR->code == TTN_NEEDTEXTA)
   {
      strncpy_s(pTTTA->szText, sizeof(pTTTA->szText), strTipText,
                strTipText.GetLength() + 1);
   }
   else
   {
      ::MultiByteToWideChar(CP_ACP, 0, strTipText, strTipText.GetLength() + 1,
                            pTTTW->szText, sizeof(pTTTW->szText) / (sizeof pTTTW->szText[0]));
   }

   return TRUE; // message was handled
}

CWnd::EnableTrackingToolTips

Ativa ou desativa as dicas de rastreamento.

BOOL EnableTrackingToolTips(BOOL bEnable = TRUE);

Parâmetros

bEnable
Especifica se as descrições de ferramentas de rastreamento estão ativadas ou desativadas. Se este parâmetro for TRUE, as dicas de ferramentas de rastreamento serão ativadas. Se este parâmetro for FALSE, as descrições de ferramentas de rastreamento serão desativadas.

Valor de retorno

Indica o estado antes de a EnableWindow função membro ser chamada. O valor de retorno é diferente de zero se a janela estivesse previamente desativada. O valor de retorno é 0 se a janela estivesse previamente ativada ou se ocorreu um erro.

Observações

As dicas de tracking são janelas de tooltip que podes posicionar dinamicamente no ecrã. Ao atualizar rapidamente a posição, a janela da dica de ferramenta parece mover-se suavemente, ou "rastrear". Esta funcionalidade pode ser útil se precisares de texto tipo de ferramenta para acompanhar a posição do ponteiro à medida que este se move.

CWnd::EnableWindow

Ativa ou desativa a entrada de rato e teclado.

BOOL EnableWindow(BOOL bEnable = TRUE);

Parâmetros

bEnable
Especifica se a janela dada deve ser ativada ou desativada. Se este parâmetro for TRUE, a janela será ativada. Se este parâmetro for FALSE, a janela será desativada.

Valor de retorno

Indica o estado antes de a EnableWindow função membro ser chamada. O valor de retorno é diferente de zero se a janela estivesse previamente desativada. O valor de retorno é 0 se a janela estivesse previamente ativada ou se ocorreu um erro.

Observações

Quando a entrada está desativada, a entrada como cliques de rato e teclas é ignorada. Quando a entrada está ativada, a janela processa toda a entrada.

Se o estado ativado estiver a mudar, a WM_ENABLE mensagem é enviada antes de esta função regressar.

Se desativadas, todas as janelas filhos ficam implicitamente desativadas, embora não sejam enviadas WM_ENABLE mensagens.

Uma janela deve ser ativada antes de poder ser ativada. Por exemplo, se uma aplicação estiver a exibir uma caixa de diálogo sem modos e tiver desativado a sua janela principal, a janela principal deve estar ativada antes de a caixa de diálogo ser destruída. Caso contrário, outra janela recebe o foco de entrada e é ativada. Se uma janela filha estiver desativada, é ignorada quando o Windows tenta determinar qual janela deve receber mensagens do rato.

Por defeito, uma janela está ativada quando é criada. Uma aplicação pode especificar o WS_DISABLED estilo na Create função membro ou CreateEx para criar uma janela que está inicialmente desativada. Depois de criada uma janela, uma aplicação pode também usar a EnableWindow função membro para ativar ou desativar a janela.

Uma aplicação pode usar esta função para ativar ou desativar um controlo numa caixa de diálogo. Um controlo desativado não pode receber o foco de entrada, nem o utilizador pode aceder a ele.

Example

//CMyFileDialog is a CFileDialog-derived class
//OnInitDialog is the handler for WM_INITDIALOG
BOOL CMyFileDialog::OnInitDialog()
{
   CFileDialog::OnInitDialog();

   CWnd *pWndParent = GetParent();

   //make sure you add #include <dlgs.h> for IDs 'edt1' & 'stc3'

   //disables the 'file name' edit and static control
   //of the standard file open dialog

   //get handle of 'file name' combobox control & disable it
   CWnd *pWnd = pWndParent->GetDlgItem(cmb13);
   pWnd->EnableWindow(FALSE);

   //get handle of 'file name' static control & disable it
   pWnd = pWndParent->GetDlgItem(stc3);
   pWnd->EnableWindow(FALSE);

   return TRUE;
}

CWnd::EndModalLoop

Termina uma chamada para RunModalLoop.

virtual void EndModalLoop(int nResult);

Parâmetros

nResult
Contém o valor a ser devolvido ao chamador de RunModalLoop.

Observações

O nResult parâmetro é propagado para o valor de retorno de RunModalLoop.

CWnd::EndModalState

Chame essa função de membro para alterar uma janela de quadro de modal para sem modo.

virtual void EndModalState();

CWnd::EndPaint

Marca o fim da pintura na janela indicada.

void EndPaint(LPPAINTSTRUCT lpPaint);

Parâmetros

lpPaint
Aponta para uma PAINTSTRUCT estrutura que contém a informação de pintura recuperada pela BeginPaint função elemento.

Observações

A EndPaint função elemento é necessária para cada chamada à BeginPaint função elemento, mas apenas depois de a pintura estar concluída.

Se o caret estava oculto pela BeginPaint função membro, EndPaint restaura o caret no ecrã.

Example

Veja o exemplo para CWnd::BeginPaint.

CWnd::ExecuteDlgInit

Inicia um recurso de diálogo.

BOOL ExecuteDlgInit(LPCTSTR lpszResourceName);
BOOL ExecuteDlgInit(LPVOID lpResource);

Parâmetros

lpszResourceName
Um apontador para uma cadeia terminada por nulo que especifica o nome do recurso.

lpResource
Um indicador para um recurso.

Valor de retorno

TRUE se um recurso de diálogo for executado; caso contrário FALSE.

Observações

ExecuteDlgInit utilizará recursos vinculados ao módulo em execução, ou recursos de outras fontes. Para isso, ExecuteDlgInit encontra um handle de recurso chamando AfxFindResourceHandle. Se a sua aplicação MFC não usar a DLL partilhada (MFCx0[U][D].DLL), AfxFindResourceHandle chama AfxGetResourceHandle, que devolve o handle de recurso atual para o executável. Se a sua aplicação MFC que utiliza MFCx0[U][D].DLL percorrer AfxFindResourceHandle a CDynLinkLibrary lista de objetos de DLLs partilhadas e de extensão MFC à procura do handle de recurso correto.

CWnd::FilterToolTipMessage

Chamado pelo framework para mostrar mensagens de tooltip.

void FilterToolTipMessage(MSG* pMsg);

Parâmetros

pMsg
Um apontador para a mensagem da dica de ferramenta.

Observações

Na maioria das aplicações MFC, este método é chamado pelo framework from PreTranslateMessage e EnableToolTips, e não precisa de o chamar por si próprio.

No entanto, em certas aplicações, por exemplo alguns controlos ActiveX, estes métodos podem não ser invocados pelo framework, e terá de se chamar FilterToolTipMessage a si próprio. Para mais informações, consulte Métodos de Criação de Dicas de Ferramentas.

CWnd::FindWindow

Devolve o top-level CWnd cuja classe de janela é dada por lpszClassName e cujo nome, ou título, da janela é dado por lpszWindowName.

static CWnd* PASCAL FindWindow(
    LPCTSTR lpszClassName,
    LPCTSTR lpszWindowName);

Parâmetros

lpszClassName
Aponta para uma cadeia terminada por nulo que especifica o nome da classe da janela (uma WNDCLASS estrutura). Se lpClassName for NULL, todos os nomes das classes coincidem.

lpszWindowName
Aponta para uma cadeia terminada por nulo que especifica o nome da janela (o título da janela). Se lpWindowName for NULL, todos os nomes de janelas coincidem.

Valor de retorno

Identifica a janela que tem o nome da classe e o nome da janela especificados. É, NULL se não for encontrada tal janela.

O CWnd* pode ser temporário e não deve ser guardado para uso posterior.

Observações

Esta função não pesquisa janelas filhas.

Example

// activate an application with a window with a specific class name
BOOL CMyApp::FirstInstance()
{
   CWnd *pWndPrev, *pWndChild;

   // Determine if a window with the class name exists...
   pWndPrev = CWnd::FindWindow(_T("MyNewClass"), NULL);
   if (NULL != pWndPrev)
   {
      // If so, does it have any popups?
      pWndChild = pWndPrev->GetLastActivePopup();

      // If iconic, restore the main window
      if (pWndPrev->IsIconic())
         pWndPrev->ShowWindow(SW_RESTORE);

      // Bring the main window or its popup to the foreground
      pWndChild->SetForegroundWindow();

      // and you are done activating the other application
      return FALSE;
   }

   return TRUE;
}

CWnd::FindWindowEx

Recupera o objeto janela cujo nome da classe e do nome da janela correspondem às strings especificadas.

static CWnd* FindWindowEx(
    HWND hwndParent,
    HWND hwndChildAfter,
    LPCTSTR lpszClass,
    LPCTSTR lpszWindow);

Parâmetros

hwndParent
Handle para a janela mãe cujas janelas filhas devem ser pesquisadas.

hwndChildAfter
Pega na janela de uma criança. A pesquisa começa com a próxima janela filha na ordem Z. A janela filho deve ser uma janela filha direta de hwndParent, não apenas uma janela descendente.

lpszClass
Apontador para uma cadeia terminada por nulo que especifica o nome da classe ou um átomo de classe criado por uma chamada anterior ao RegisterClass ou RegisterClassEx.

lpszWindow
Apontador para uma cadeia terminada por nulo que especifica o nome da janela (o título da janela). Se este parâmetro for NULL, todos os nomes das janelas coincidem.

Valor de retorno

Se a função tiver sucesso, o valor de retorno é um ponteiro para o objeto janela com os nomes de classe e janela especificados. Se a função falhar, o valor de retorno é NULL.

Observações

Esta função de membro emula a funcionalidade da função FindWindowEx, conforme descrito no SDK do Windows.

CWnd::FlashWindow

Pisca a janela dada uma vez.

BOOL FlashWindow(BOOL bInvert);

Parâmetros

bInvert
Especifica se o CWnd deve ser flashado ou devolvido ao seu estado original. O CWnd é flashado de um estado para o outro se bInvert for TRUE. Se bInvert for FALSE, a janela é devolvida ao seu estado original (ativo ou inativo).

Valor de retorno

Diferente de zero se a janela estivesse ativa antes da chamada para a FlashWindow função membro; caso contrário, 0.

Observações

Para flashes sucessivos, crie um temporizador de sistema e chame FlashWindowrepetidamente . Piscar o CWnd sistema muda a aparência da barra de título como se estivesse CWnd a mudar de inativo para ativo, ou vice-versa. (Uma barra de título inativa muda para uma barra de título ativa; uma barra de título ativa muda para uma barra de título inativa.)

Normalmente, uma janela é projetada para informar o utilizador de que precisa de atenção, mas que não tem atualmente o foco de entrada.

O bInvert parâmetro deve ser FALSE apenas quando a janela está a receber o foco de entrada e deixa de estar a piscar; deve estar TRUE em chamadas sucessivas enquanto espera obter o foco de entrada.

Esta função devolve sempre o que não é zero para janelas minimizadas. Se a janela estiver minimizada, FlashWindow o ícone da janela irá piscar; bInvert é ignorado para janelas minimizadas.

Example

BOOL CPenWidthsDlg::OnInitDialog()
{
   CDialog::OnInitDialog();

   // set timer to cause dialog to flash
   SetTimer(1, 500, NULL);
   return TRUE; // return TRUE unless you set the focus to a control
}

void CPenWidthsDlg::OnTimer(UINT_PTR nIDEvent)
{
   // cause the dialog to flash
   FlashWindow(TRUE);
   CDialog::OnTimer(nIDEvent);
}

CWnd::FlashWindowEx

Pisca a janela indicada.

BOOL FlashWindowEx(
    DWORD dwFlags,
    UINT uCount,
    DWORD dwTimeout);

Parâmetros

dwFlags
Especifica o estado do flash. Para uma lista completa de valores, veja a FLASHWINFO estrutura.

uCount
Especifica o número de vezes a piscar a janela.

dwTimeout
Especifica a velocidade, em milissegundos, a que a janela será piscada. Se dwTimeout for zero, a função utiliza a taxa de piscar do cursor por defeito.

Valor de retorno

O valor de retorno especifica o estado da janela antes da chamada à FlashWindowEx função. Se a legenda da janela foi desenhada como ativa antes da chamada, o valor de retorno é diferente de zero. Caso contrário, o valor de retorno é zero.

Observações

Este método emula a funcionalidade da função FlashWindowEx, conforme descrito no SDK do Windows.

CWnd::FromHandle

Devolve um ponteiro para um CWnd objeto quando recebe uma alavanca para uma janela. Se um CWnd objeto não estiver anexado à alça, um objeto temporário CWnd será criado e anexado.

static CWnd* PASCAL FromHandle(HWND hWnd);

Parâmetros

hWnd
Uma HWND janela de janela.

Valor de retorno

Devolve um ponteiro para um CWnd objeto quando recebe uma alavanca para uma janela. Se um CWnd objeto não estiver anexado à alça, um objeto temporário CWnd será criado e anexado.

O ponteiro pode ser temporário e não deve ser guardado para uso posterior.

CWnd::FromHandlePermanent

Devolve um ponteiro para um CWnd objeto quando recebe uma alavanca para uma janela.

static CWnd* PASCAL FromHandlePermanent(HWND hWnd);

Parâmetros

hWnd
Uma HWND janela de janela.

Valor de retorno

Um ponteiro para um CWnd objeto.

Observações

Se um CWnd objeto não estiver preso à pega, NULL é devolvido.

Esta função, ao contrário de FromHandle, não cria objetos temporários.

CWnd::get_accChild

Chamado pela estrutura para recuperar o endereço de uma interface IDispatch para o filho especificado.

virtual HRESULT get_accChild(
    VARIANT varChild,
    IDispatch** ppdispChild);

Parâmetros

varChild
Identifica a criança cuja IDispatch interface deve ser recuperada.

ppdispChild
Recebe o endereço da interface do IDispatch objeto filho.

Valor de retorno

Retornos S_OK em caso de sucesso, um código de erro COM em caso de falha. Veja valores de retorno em IAccessible::get_accChild no SDK do Windows.

Observações

Esta função faz parte do suporte de Acessibilidade Ativa da MFC.

Substitua esta função na sua CWndclasse derivada se tiver elementos de interface de utilizador sem janelas (exceto os controlos ActiveX sem janelas, que o MFC gere).

Para obter mais informações, consulte IAccessible::get_accChild no SDK do Windows.

CWnd::get_accChildCount

Chamado pela estrutura para recuperar o número de filhos pertencentes a este objeto.

virtual HRESULT get_accChildCount(long* pcountChildren);

Parâmetros

pcountChildren
Recebe o número de crianças.

Valor de retorno

Retornos S_OK em caso de sucesso, um código de erro COM em caso de falha. Veja valores de retorno em IAccessible::get_accChildCount no SDK do Windows.

Observações

Esta função faz parte do suporte de Acessibilidade Ativa da MFC.

Substitua esta função na sua CWndclasse derivada se tiver elementos de interface de utilizador sem janelas (exceto os controlos ActiveX sem janelas, que o MFC gere). Chame a versão base da classe e depois adicione os elementos filhos sem janela.

Para obter mais informações, consulte IAccessible::get_accChildCount no SDK do Windows.

CWnd::get_accDefaultAction

Chamado pela estrutura para recuperar uma cadeia de caracteres que descreve a ação padrão do objeto.

virtual HRESULT get_accDefaultAction(
    VARIANT varChild,
    BSTR* pszDefaultAction);

Parâmetros

varChild
Especifica se a ação padrão a recuperar é a do objeto ou de um dos elementos filhos do objeto. Este parâmetro pode ser ( CHILDID_SELF para obter informação sobre o objeto) ou um ID filho (para obter informação sobre o elemento filho do objeto).

pszDefaultAction
Endereço de a BSTR que recebe uma string localizada descrevendo a ação padrão para o objeto especificado, ou NULL se esse objeto não tiver uma ação por defeito.

Valor de retorno

Devolve S_OK em caso de sucesso, um código de erro COM em caso de falha. Ver valores de retorno em IAccessible::get_accDefaultAction no SDK do Windows.

Observações

Esta função faz parte do suporte de Acessibilidade Ativa da MFC.

Sobrescrita esta função na tua CWndclasse derivada de -para descrever a ação padrão do teu objeto.

Para obter mais informações, consulte IAccessible::get_accDefaultAction no SDK do Windows.

CWnd::get_accDescription

Chamado pela estrutura para recuperar uma cadeia de caracteres que descreve a aparência visual do objeto especificado.

virtual HRESULT get_accDescription(
    VARIANT varChild,
    BSTR* pszDescription);

Parâmetros

varChild
Especifica se a descrição a recuperar é a do objeto ou de um dos elementos filhos do objeto. Este parâmetro pode ser ( CHILDID_SELF para obter informação sobre o objeto) ou um ID filho (para obter informação sobre o elemento filho do objeto).

pszDescription
Endereço de a BSTR que recebe uma string localizada a descrever o objeto especificado, ou NULL se não houver descrição disponível para esse objeto.

Valor de retorno

Retornos S_OK em caso de sucesso, um código de erro COM em caso de falha. Veja valores de retorno em IAccessible::get_accDescription no SDK do Windows.

Observações

Esta função faz parte do suporte de Acessibilidade Ativa da MFC.

Sobrescrita esta função na tua CWndclasse derivada para descrever o teu objeto. Liga para a versão da classe base e adiciona a tua descrição.

Para obter mais informações, consulte IAccessible::get_accDescription no SDK do Windows.

CWnd::get_accFocus

Chamado pela estrutura para recuperar o objeto que tem o foco do teclado.

virtual HRESULT get_accFocus(VARIANT* pvarChild);

Parâmetros

pvarChild
Recebe informação sobre o objeto que tem o foco. Veja pvarID no IAccessible::get_accFocus SDK do Windows.

Valor de retorno

Retornos S_OK em caso de sucesso, um código de erro COM em caso de falha. Veja valores de retorno em IAccessible::get_accFocus no SDK do Windows.

Observações

Esta função faz parte do suporte de Acessibilidade Ativa da MFC.

Substitua esta função na sua CWndclasse derivada se tiver elementos de interface de utilizador sem janelas (exceto os controlos ActiveX sem janelas, que o MFC gere).

Para obter mais informações, consulte IAccessible::get_accFocus no SDK do Windows.

CWnd::get_accHelp

Chamada pelo framework para recuperar a cadeia de propriedades Help de um objeto.

virtual HRESULT get_accHelp(
    VARIANT varChild,
    BSTR* pszHelp);

Parâmetros

varChild
Especifica se a informação de ajuda a ser recuperada pertence ao objeto ou a de um dos elementos filhos do objeto. Este parâmetro pode ser ( CHILDID_SELF para obter informação sobre o objeto) ou um ID filho (para obter informação sobre o elemento filho do objeto).

pszHelp
Endereço de a BSTR que recebe a string localizada contendo a informação de ajuda para o objeto especificado, ou NULL se não houver informação de ajuda disponível.

Valor de retorno

Retornos S_OK em caso de sucesso, um código de erro COM em caso de falha. Veja valores de retorno em IAccessible::get_accHelp no SDK do Windows.

Observações

Esta função faz parte do suporte de Acessibilidade Ativa da MFC.

Substitua esta função na sua CWndclasse derivada para fornecer texto de ajuda para o seu objeto.

Para obter mais informações, consulte IAccessible::get_accHelp no SDK do Windows.

CWnd::get_accHelpTopic

Chamado pelo framework para recuperar o caminho completo do ficheiro WinHelp associado ao objeto especificado e o identificador do tópico apropriado dentro desse ficheiro.

virtual HRESULT get_accHelpTopic(
    BSTR* pszHelpFile,
    VARIANT varChild,
    long* pidTopic);

Parâmetros

pszHelpFile
Endereço de a BSTR que recebe o caminho completo do WinHelp ficheiro associado ao objeto especificado, se houver.

varChild
Especifica se o tópico Ajuda a ser recuperado é o do objeto ou um dos elementos filhos do objeto. Este parâmetro pode ser ( CHILDID_SELF para obter um tópico de Ajuda para o objeto) ou um ID filho (para obter um tópico de Ajuda para um dos elementos filho do objeto).

pidTopic
Identifica o tópico do ficheiro de Ajuda associado ao objeto especificado. Veja pidTopic no IAccessible::get_accHelpTopic SDK do Windows.

Valor de retorno

Retornos S_OK em caso de sucesso, um código de erro COM em caso de falha. Veja valores de retorno em IAccessible::get_accHelpTopic no SDK do Windows.

Observações

Esta função faz parte do suporte de Acessibilidade Ativa da MFC.

Substitua esta função na sua CWndclasse derivada para fornecer informação de ajuda sobre o seu objeto.

Para obter mais informações, consulte IAccessible::get_accHelpTopic no SDK do Windows.

CWnd::get_accKeyboardShortcut

Chamado pela estrutura para recuperar a tecla de atalho ou a chave de acesso do objeto especificado.

virtual HRESULT get_accKeyboardShortcut(
    VARIANT varChild,
    BSTR* pszKeyboardShortcut);

Parâmetros

varChild
Especifica se o atalho de teclado a recuperar é o do objeto ou de um dos elementos filhos do objeto. Este parâmetro pode ser ( CHILDID_SELF para obter informação sobre o objeto) ou um ID filho (para obter informação sobre o elemento filho do objeto).

pszKeyboardShortcut
Endereço de a BSTR que recebe uma string localizada identificando o atalho de teclado, ou NULL se não estiver associado nenhum atalho de teclado ao objeto especificado.

Valor de retorno

Retornos S_OK em caso de sucesso, um código de erro COM em caso de falha. Veja valores de retorno em IAccessible::get_accKeyboardShortcut no SDK do Windows.

Observações

Esta função faz parte do suporte da Active Accessibility MFC.

Sobrescrita esta função na tua CWndclasse derivada para identificar o atalho de teclado do teu objeto.

Para obter mais informações, consulte IAccessible::get_accKeyboardShortcut no SDK do Windows.

CWnd::get_accName

Chamado pela estrutura para recuperar o nome do objeto especificado.

virtual HRESULT get_accName(
    VARIANT varChild,
    BSTR* pszName);

Parâmetros

varChild
Especifica se o nome a recuperar é o do objeto ou de um dos elementos filhos do objeto. Este parâmetro pode ser ( CHILDID_SELF para obter informação sobre o objeto) ou um ID filho (para obter informação sobre o elemento filho do objeto).

pszName
Endereço de a BSTR que recebe uma string contendo o nome do objeto especificado.

Valor de retorno

Retornos S_OK em caso de sucesso, um código de erro COM em caso de falha. Veja valores de retorno em IAccessible::get_accName no SDK do Windows.

Observações

Esta função faz parte do suporte de Acessibilidade Ativa da MFC.

Substitua esta função na sua CWndclasse derivada para devolver o nome do seu objeto.

Para obter mais informações, consulte IAccessible::get_accName no SDK do Windows.

CWnd::get_accParent

Chamado pelo framework para recuperar a IDispatch interface do pai do objeto.

virtual HRESULT get_accParent(IDispatch** ppdispParent);

Parâmetros

ppdispParent
Recebe o endereço da interface do IDispatch objeto pai. A variável é definida para NULL se não existir um pai, ou se o filho não conseguir aceder ao seu pai.

Valor de retorno

Retornos S_OK do sucesso, um COM código de erro em caso de falha. Veja valores de retorno em IAccessible::get_accParent no SDK do Windows.

Observações

Esta função faz parte do suporte de Acessibilidade Ativa da MFC.

Na maioria dos casos, não tens de sobrescrever esta função.

Para obter mais informações, consulte IAccessible::get_accParent no SDK do Windows.

CWnd::get_accRole

Chamado pela estrutura para recuperar informações que descrevem a função do objeto especificado.

virtual HRESULT get_accRole(
    VARIANT varChild,
    VARIANT* pvarRole);

Parâmetros

varChild
Especifica se a informação do papel a recuperar é a do objeto ou de um dos elementos filhos do objeto. Este parâmetro pode ser ( CHILDID_SELF para obter informação sobre o objeto) ou um ID filho (para obter informação sobre o elemento filho do objeto).

pvarRole
Recebe a informação do cargo. Veja pvarRole no IAccessible::get_accRole SDK do Windows.

Valor de retorno

Retornos S_OK em caso de sucesso, um código de erro COM em caso de falha. Veja valores de retorno em IAccessible::get_accRole no SDK do Windows.

Observações

Esta função faz parte do suporte de Acessibilidade Ativa da MFC.

Substitua esta função na sua CWndclasse derivada se tiver elementos de interface de utilizador sem janelas (exceto os controlos ActiveX sem janelas, que o MFC gere).

Para obter mais informações, consulte IAccessible::get_accRole no SDK do Windows.

CWnd::get_accSelection

Chamado pela estrutura para recuperar os filhos selecionados deste objeto.

virtual HRESULT get_accSelection(VARIANT* pvarChildren);

Parâmetros

pvarChildren
Recebe informações sobre quais as crianças selecionadas. Veja pvarChildren no IAccessible::get_accSelection SDK do Windows.

Valor de retorno

Devolve S_OK em caso de sucesso, um código de erro COM em caso de falha. Veja valores de retorno em IAccessible::get_accSelection no SDK do Windows.

Observações

Esta função faz parte do suporte de Acessibilidade Ativa da MFC.

Substitua esta função na sua CWndclasse derivada se tiver elementos de interface de utilizador sem janelas (exceto os controlos ActiveX sem janelas, que o MFC gere).

Para obter mais informações, consulte IAccessible::get_accSelection no SDK do Windows.

CWnd::get_accState

Chamado pela estrutura para recuperar o estado atual do objeto especificado.

virtual HRESULT get_accState(
    VARIANT varChild,
    VARIANT* pvarState);

Parâmetros

varChild
Especifica se a informação de estado a recuperar é a do objeto ou de um dos elementos filhos do objeto. Este parâmetro pode ser ( CHILDID_SELF para obter informação sobre o objeto) ou um ID filho (para obter informação sobre o elemento filho do objeto).

pvarState
Recebe informação sobre o estado do objeto. Veja pvarState no IAccessible::get_accState SDK do Windows.

Valor de retorno

Retornos S_OK em caso de sucesso, um código de erro COM em caso de falha. Veja valores de retorno em IAccessible::get_accState no SDK do Windows.

Observações

Esta função faz parte do suporte de Acessibilidade Ativa da MFC.

Substitua esta função na sua CWndclasse derivada se tiver elementos de interface de utilizador sem janelas (exceto os controlos ActiveX sem janelas, que o MFC gere).

Para obter mais informações, consulte IAccessible::get_accState no SDK do Windows.

CWnd::get_accValue

Chamado pela estrutura para recuperar o valor do objeto especificado.

virtual HRESULT get_accValue(
    VARIANT varChild,
    BSTR* pszValue);

Parâmetros

varChild
Especifica se a informação de valor a recuperar pertence ao objeto ou a de um dos elementos filhos do objeto. Este parâmetro pode ser ( CHILDID_SELF para obter informação sobre o objeto) ou um ID filho (para obter informação sobre o elemento filho do objeto).

pszValue
Endereço de que BSTR recebe uma string localizada contendo o valor atual do objeto.

Valor de retorno

Retornos S_OK em caso de sucesso, um código de erro COM em caso de falha. Veja valores de retorno em IAccessible::get_accValue no SDK do Windows.

Observações

Esta função faz parte do suporte de Acessibilidade Ativa da MFC.

Substitua esta função na sua CWndclasse derivada se tiver elementos de interface de utilizador sem janelas (exceto os controlos ActiveX sem janelas, que o MFC gere).

Para obter mais informações, consulte IAccessible::get_accValue no SDK do Windows.

CWnd::GetActiveWindow

Recupera um ponteiro para a janela ativa.

static CWnd* PASCAL GetActiveWindow();

Valor de retorno

A janela ativa ou NULL se nenhuma janela estivesse ativa no momento da chamada. O ponteiro pode ser temporário e não deve ser guardado para uso posterior.

Observações

A janela ativa é ou a janela que tem o foco de entrada atual ou a janela explicitamente tornada ativa pela SetActiveWindow função membro.

CWnd::GetAncestor

Recupera o objeto janela ancestral da janela especificada.

CWnd* GetAncestor(UINT gaFlags) const;

Parâmetros

gaFlags
Especifica o antepassado a ser recuperado. Para uma lista completa de valores possíveis, veja GetAncestor.

Valor de retorno

Se a função tiver sucesso, o valor de retorno é um apontador para o objeto janela ancestral. Se a função falhar, o valor de retorno é NULL.

Observações

Esta função de membro emula a funcionalidade da função GetAncestor, conforme descrito no SDK do Windows.

CWnd::GetCapture

Recupera a janela onde o rato é capturado.

static CWnd* PASCAL GetCapture();

Valor de retorno

Identifica a janela que tem a captura do rato. É NULL se nenhuma janela tiver captura do rato.

O valor de retorno pode ser temporário e não deve ser guardado para uso posterior.

Observações

Apenas uma janela tem a captura do rato em cada momento. Uma janela recebe a captura do rato quando a SetCapture função membro é chamada. Esta janela recebe a entrada do rato, quer o cursor esteja ou não dentro das suas bordas.

CWnd::GetCaretPos

Recupera as coordenadas do cliente com a posição atual do caret e devolve-as como um CPoint.

static CPoint PASCAL GetCaretPos();

Valor de retorno

CPoint objeto contendo as coordenadas da posição do caret.

Observações

A posição do caret é dada nas coordenadas cliente da CWnd janela.

CWnd::GetCheckedRadioButton

Recupera o ID do botão de rádio atualmente verificado no grupo especificado.

int GetCheckedRadioButton(
    int nIDFirstButton,
    int nIDLastButton);

Parâmetros

nIDFirstButton
Especifica o identificador inteiro do primeiro botão de acesso do grupo.

nIDLastButton
Especifica o identificador inteiro do último botão de acesso do grupo.

Valor de retorno

ID do botão de rádio verificado, ou 0 se não estiver selecionado.

CWnd::GetClientRect

Copia as coordenadas cliente da CWnd área cliente na estrutura apontada por lpRect.

void GetClientRect(LPRECT lpRect) const;

Parâmetros

lpRect
Aponta para uma RECT estrutura ou objeto CRect para receber as coordenadas do cliente. Os left membros e top serão 0. Os right membros e bottom conterão a largura e a altura da janela.

Observações

As coordenadas do cliente especificam os cantos superior esquerdo e inferior direito da área do cliente. Como as coordenadas do cliente são relativas aos cantos superiores esquerdos da CWnd área do cliente, as coordenadas do canto superior esquerdo são (0,0).

Example

Veja o exemplo para CWnd::IsIconic.

CWnd::GetClipboardOwner

Recupera o atual proprietário da Prancheta.

static CWnd* PASCAL GetClipboardOwner();

Valor de retorno

Identifica a janela que detém a Área de Transferência se a função for bem-sucedida. Caso contrário, é NULL.

O ponteiro devolvido pode ser temporário e não deve ser guardado para uso posterior.

Observações

A Prancheta pode conter dados mesmo que não seja atualmente possuida.

CWnd::GetClipboardViewer

Recupera a primeira janela da cadeia Clipboard-viewer.

static CWnd* PASCAL GetClipboardViewer();

Valor de retorno

Identifica a janela atualmente responsável por exibir a Área de Transferência se for bem-sucedida; caso contrário NULL (por exemplo, se não houver visualizador).

O ponteiro devolvido pode ser temporário e não deve ser guardado para uso posterior.

CWnd::GetControlUnknown

Chame esta função membro para recuperar um ponteiro para um controlo OLE desconhecido.

LPUNKNOWN GetControlUnknown();

Valor de retorno

Um ponteiro para a IUnknown interface do controlo OLE representado por este CWnd objeto. Se este objeto não representa um controlo OLE, o valor de retorno é NULL.

Observações

Não devias libertar este IUnknown ponteiro. Normalmente, usaria para obter uma interface específica do controlo.

O ponteiro de interface devolvido GetControlUnknown não é contado por referência. Não ligue IUnknown::Release pelo ponteiro a menos que já o tenha contactado anteriormente IUnknown::AddRef .

Example

// The following code fragment is taken from CMyDlg::OnInitDialog
// CMyDlg is a CDialog-derived class.

// IDC_MSACALCTRL1 is the ID of the Calendar control OCX embedded
// on this dialog
CWnd *pWndCal = GetDlgItem(IDC_MSACALCTRL1);

// Use the IUnknown of the control
LPUNKNOWN pUnk = pWndCal->GetControlUnknown();

// From there get the IDispatch interface of control
LPDISPATCH pDisp = NULL;
pUnk->QueryInterface(IID_IDispatch, (LPVOID*)&pDisp);

// use IDispatch method to invoke the control's functionality

CWnd::GetCurrentMessage

Devolve um ponteiro para a mensagem que esta janela está a processar. Só deve ser chamado quando estiver numa função membro do handler demensagens On.

static const MSG* PASCAL GetCurrentMessage();

Valor de retorno

Devolve um ponteiro para a MSG estrutura que contém a mensagem que a janela está a processar. Só deve ser chamada quando estiver num manipulador de mensagens On.

Example

Veja o exemplo para CMDIFrameWnd::MDICascade.

CWnd::GetDC

Recupera um ponteiro para um contexto comum, de classe ou de dispositivo privado para a área do cliente, dependendo do estilo de classe especificado para o CWnd.

CDC* GetDC();

Valor de retorno

Identifica o contexto do dispositivo para a CWnd área do cliente se for bem-sucedido; caso contrário, o valor de retorno é NULL. O ponteiro pode ser temporário e não deve ser guardado para uso posterior.

Observações

Para contextos comuns de dispositivos, GetDC atribui atributos predefinidos ao contexto cada vez que este é recuperado. Para contextos de classe e privados, GetDC mantém os atributos previamente atribuídos inalterados. O contexto do dispositivo pode ser usado em funções subsequentes de interface gráfica (GDI) para desenhar na área do cliente.

A menos que o contexto do dispositivo pertença a uma classe janela, a ReleaseDC função membro deve ser chamada para libertar o contexto após a pintura.

Um contexto de dispositivo pertencente à CWnd classe é devolvido pela GetDC função membro se CS_CLASSDC, CS_OWNDC, ou CS_PARENTDC foi especificado como um estilo na WNDCLASS estrutura quando a classe foi registada.

CWnd::GetDCEx

Recupera o handle de um contexto de dispositivo para a CWnd janela.

CDC* GetDCEx(
    CRgn* prgnClip,
    DWORD flags);

Parâmetros

prgnClip
Identifica uma região de recorte que pode ser combinada com a região visível da janela do cliente.

flags
Pode ter um dos seguintes valores predefinidos:

• DCX_CACHE Devolve o contexto do dispositivo a partir da cache em vez da OWNDC janela ou CLASSDC . Substitui CS_OWNDC e CS_CLASSDC.

• DCX_CLIPCHILDREN Exclui as regiões visíveis de todas as janelas filhas abaixo da CWnd janela.

• DCX_CLIPSIBLINGS Exclui as regiões visíveis de todas as janelas irmãs acima da CWnd janela.

• DCX_EXCLUDERGN Exclui a região de clipping identificada por prgnClip da região visível do contexto do dispositivo devolvido.

• DCX_INTERSECTRGN Intersecta a região de clipping identificada por prgnClip dentro da região visível do contexto do dispositivo devolvido.

• DCX_LOCKWINDOWUPDATE Permite desenhar mesmo que haja um LockWindowUpdate efeito de chamada que, de outra forma, excluiria essa janela. Este valor é usado para desenhar durante o rastreamento.

• DCX_PARENTCLIP Usa a região visível da janela pai e ignora os bits da WS_CLIPCHILDREN janela pai e WS_PARENTDC do estilo. Este valor define a origem do contexto do dispositivo para o canto superior esquerdo da CWnd janela.

• DCX_WINDOW Devolve um contexto de dispositivo que corresponde ao retângulo da janela em vez do retângulo cliente.

Valor de retorno

O contexto do dispositivo para a janela especificada, caso a função seja bem-sucedida; caso contrário NULL.

Observações

O contexto do dispositivo pode ser usado em funções GDI subsequentes para desenhar na área do cliente.

Esta função, que é uma extensão da GetDC função, dá à aplicação mais controlo sobre como e se o contexto de um dispositivo para uma janela é clipado.

A menos que o contexto do dispositivo pertença a uma classe janela, a ReleaseDC função deve ser chamada para libertar o contexto após o desenho. Como apenas cinco contextos comuns de dispositivo estão disponíveis em cada momento, a falha em libertar um contexto de dispositivo pode impedir que outras aplicações acedam ao contexto do dispositivo.

Para obter um contexto de dispositivo em cache, uma aplicação deve especificar DCX_CACHE. Se DCX_CACHE não for especificado e a janela não for nem CS_OWNDC , CS_CLASSDCesta função devolve NULL.

Um contexto de dispositivo com características especiais é devolvido pela GetDCEx função se o CS_CLASSDC, CS_OWNDC, ou CS_PARENTDC estilo foi especificado na WNDCLASS estrutura quando a classe foi registada.

Para mais informações sobre estas características, consulte a descrição da WNDCLASS estrutura no SDK do Windows.

CWnd::GetDCRenderTarget

Recupera o destino de renderização do contexto do dispositivo (DC) para a CWnd janela.

CDCRenderTarget* GetDCRenderTarget();

Valor de retorno

O alvo de renderização contextual do dispositivo para a janela especificada se a função for bem-sucedida; caso contrário NULL.

Observações

CWnd::GetDescendantWindow

Chame esta função membro para encontrar a janela descendente especificada pelo ID indicado.

CWnd* GetDescendantWindow(
    int nID,
    BOOL bOnlyPerm = FALSE) const;

Parâmetros

nID
Especifica o identificador da janela de controlo ou filha a ser recuperada.

bOnlyPerm
Especifica se a janela a devolver pode ser temporária. Se TRUE, apenas uma janela permanente pode ser devolvida; se FALSE, a função pode devolver uma janela temporária. Para mais informações sobre janelas temporárias, consulte a Nota Técnica 3.

Valor de retorno

Um ponteiro para um CWnd objeto, ou NULL se não for encontrada nenhuma janela filha.

Observações

Esta função membro pesquisa toda a árvore de janelas filhas, não apenas as janelas que são filhos imediatos.

CWnd::GetDesktopWindow

Devolve a janela do ambiente de trabalho do Windows.

static CWnd* PASCAL GetDesktopWindow();

Valor de retorno

Identifica a janela do ambiente de trabalho do Windows. Este ponteiro pode ser temporário e não deve ser guardado para uso posterior.

Observações

A janela do ambiente de trabalho cobre todo o ecrã e é a área em cima da qual todos os ícones e outras janelas estão pintados.

CWnd::GetDlgCtrlID

Devolve o valor de janela ou ID de controlo para qualquer janela filha, não apenas o de um controlo numa caixa de diálogo.

int GetDlgCtrlID() const;

Valor de retorno

O identificador numérico da CWnd janela filha se a função for bem-sucedida; caso contrário, 0.

Observações

Como as janelas de topo não têm um valor ID, o valor de retorno desta função é inválido se for CWnd uma janela de topo de nível.

Example

Veja o exemplo para CWnd::OnCtlColor.

CWnd::GetDlgItem

Recupera um ponteiro para a janela de controlo ou filho especificada numa caixa de diálogo ou noutra janela.

CWnd* GetDlgItem(int nID) const;

void GetDlgItem(
    int nID,
    HWND* phWnd) const;

Parâmetros

nID
Especifica o identificador da janela de controlo ou filha a ser recuperada.

phWnd
Um apontador para uma janela de criança.

Valor de retorno

Um apontador para a janela de controlo ou filha dada. Se não existir controlo com o ID inteiro dado pelo nID parâmetro, o valor é NULL.

O ponteiro devolvido pode ser temporário e não deve ser guardado para uso posterior.

Observações

O ponteiro devolvido é geralmente lançado para o tipo de controlo identificado por nID.

Example

// uses GetDlgItem to return a pointer to a user interface control
CEdit *pBoxOne;
pBoxOne = (CEdit*)GetDlgItem(IDC_MYEDIT);
GotoDlgCtrl(pBoxOne);

CWnd::GetDlgItemInt

Recupera o texto do controlo identificado por nID.

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

Parâmetros

nID
Especifica o identificador inteiro do controlo da caixa de diálogo a ser traduzido.

lpTrans
Aponta para a variável booleana que recebe a bandeira traduzida.

bSigned
Especifica se o valor a recuperar está assinado.

Valor de retorno

Especifica o valor traduzido do texto do item da caixa de diálogo. Como 0 é um valor de retorno válido, lpTrans deve ser usado para detetar erros. Se um valor de retorno assinado for desejado, conjure-o como um int tipo.

A função devolve 0 se o número traduzido for maior que INT_MAX (para números com assinatura) ou UINT_MAX (para não assinado).

Quando ocorrem erros, como encontrar caracteres não numéricos e exceder o máximo acima, GetDlgItemInt copia 0 para a localização apontada por lpTrans. Se não houver erros, lpTrans recebe um valor diferente de zero. Se lpTrans for NULL, GetDlgItemInt não alerta sobre erros.

Observações

Traduz o texto do controlo especificado na caixa de diálogo em valor inteiro, removendo quaisquer espaços extra no início do texto e convertendo dígitos decimais. Para a tradução quando chega ao fim do texto ou encontra qualquer carácter não numérico.

Se bSigned for TRUE, GetDlgItemInt verifica um sinal menos (-) no início do texto e traduz o texto para um número com sinal. Caso contrário, cria um valor sem sinal.

Envia uma WM_GETTEXT mensagem para o controlo.

CWnd::GetDlgItemText

Chame esta função membro para recuperar o título ou texto associado a um controlo numa caixa de diálogo.

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

int GetDlgItemText(
    int nID,
    CString& rString) const;

Parâmetros

nID
Especifica o identificador inteiro do controlo cujo título deve ser recuperado.

lpStr
Aponta para o buffer para receber o título ou texto do controlo.

nMaxCount
Especifica o comprimento máximo (em caracteres) da cadeia a copiar para lpStr. Se a corda for mais longa que nMaxCount, é truncada.

rString
Uma referência a um CStringarquivo .

Valor de retorno

Especifica o número real de caracteres copiados para o buffer, não incluindo o carácter nulo que termina. O valor é 0 se não for copiado texto.

Observações

A GetDlgItemText função membro copia o texto para a localização apontada por lpStr e devolve uma contagem do número de bytes que copia.

CWnd::GetDSCCursor

Chame esta função membro para recuperar um ponteiro para o cursor subjacente definido pelas DataSourcepropriedades , UserName, Password, e SQL do controlo de código-fonte de dados.

IUnknown* GetDSCCursor();

Valor de retorno

Um apontador para um cursor definido por um controlo de fonte de dados. A MFC trata de chamar AddRef o apontador.

Observações

Use o ponteiro retornado para definir a ICursor propriedade de um controlo limitado por dados complexo, como o controlo de grelha limitado por dados. Um controlo de fonte de dados não se tornará ativo até que o primeiro controlo vinculado solicite o seu cursor. Isto pode acontecer explicitamente por uma chamada ou GetDSCCursor implicitamente pelo gestor de ligação MFC. Em qualquer dos casos, pode forçar um controlo de fonte de dados a ativar-se chamando GetDSCCursor e depois ligando Release ao ponteiro retornado para IUnknown. A ativação fará com que o controlo de fonte de dados tente ligar-se à fonte de dados subjacente. O ponteiro devolvido pode ser usado no seguinte contexto:

Example

BOOL CMyDlg::OnInitDialog()
{
   // Find the child controls on the dialog
   HRESULT hr = E_FAIL;
   CWnd *pDSC = GetDlgItem(IDC_DATASOURCE);
   CWnd *pListWnd = GetDlgItem(IDC_DBLIST1);
   IUnknown *punkList = pListWnd->GetControlUnknown();
   IDBList *pList = NULL;

   if (NULL != punkList)
   {
      hr = punkList->QueryInterface(__uuidof(IDBList), (void **)&pList);
   }

   if (SUCCEEDED(hr))
   {
      // Tell the MFC binding manager that we are
      // binding DISPID 3 to the data-source control.
      pListWnd->BindProperty(0x3, pDSC);

      // Tell the listbox which field to expose as its bound column
      pList->put_BoundColumn(_T("ContactFirstName"));

      // Tell the listbox which cursor and column to populate its list from
      pList->put_ListField(_T("ContactFirstName"));

      IUnknown *punkCursor = pDSC->GetDSCCursor();
      if (NULL != punkCursor)
      {
         punkCursor->Release();
      }

      pList->Release();
      return TRUE;
   }

CWnd::GetDynamicLayout

Recupera um ponteiro para o objeto gestor de layout dinâmico.

CMFCDynamicLayout* GetDynamicLayout();

Valor de retorno

Um apontador para o objeto gestor de layout dinâmico, ou NULL se o layout dinâmico não estiver ativado.

Observações

O objeto janela detém e gere a vida útil do ponteiro devolvido, pelo que deve ser usado apenas para aceder ao objeto; Não apague o ponteiro nem armazene o ponteiro permanentemente.

CWnd::GetExStyle

Devolve o estilo estendido da janela.

DWORD GetExStyle() const;

Valor de retorno

O estilo estendido da janela. Para mais informações sobre os estilos de janelas estendidas usados no MFC, consulte Estilos de Janelas Estendidas.

CWnd::GetFocus

Recupera um ponteiro para o CWnd que atualmente tem o foco de entrada.

static CWnd* PASCAL GetFocus();

Valor de retorno

Um apontador para a janela que tem o foco atual, ou NULL se não houver janela de foco.

O ponteiro pode ser temporário e não deve ser guardado para uso posterior.

CWnd::GetFont

Envia a WM_GETFONT mensagem para a janela para recuperar a fonte atual.

CFont* GetFont() const;

Valor de retorno

Apontar para um CFont objeto que está associado à fonte atual da janela.

Observações

Este método não tem efeito a menos que a janela processe a WM_GETFONT mensagem. Muitas classes MFC que derivam de CWnd processam esta mensagem porque estão associadas a uma classe janela predefinida que inclui um manipulador de mensagens para a WM_GETFONT mensagem. Para usar este método, as classes de CWnd onde se deriva devem definir um handler de método para a WM_GETFONT mensagem.

CWnd::GetForegroundWindow

Devolve um ponteiro para a janela em primeiro plano (a janela com a qual o utilizador está a trabalhar no momento).

static CWnd* PASCAL GetForegroundWindow();

Valor de retorno

Um apontador para a janela em primeiro plano. Isto pode ser um objeto temporário CWnd .

Observações

A janela em primeiro plano aplica-se apenas às janelas de nível superior (janelas de molduras ou caixas de diálogo).

CWnd::GetIcon

Chame esta função membro para levar a pega a um ícone grande (32x32) ou a alça a um ícone pequeno (16x16), como indicado por bBigIcon.

HICON GetIcon(BOOL bBigIcon) const;

Parâmetros

bBigIcon
Especifica um ícone de 32 píxeis por 32 píxeis se TRUE; especifica um ícone de 16 píxeis por 16 píxeis se FALSE.

Valor de retorno

Um identificador para um ícone. Se não for bem-sucedido, retorna NULL.

CWnd::GetLastActivePopup

Determina qual janela pop-up pertencente CWnd esteve mais recentemente ativa.

CWnd* GetLastActivePopup() const;

Valor de retorno

Identifica a janela pop-up mais recente e ativa. O valor de retorno será a própria janela se alguma das seguintes condições for cumprida:

• A janela em si esteve mais recentemente ativa.

• A janela não possui nenhuma janela pop-up.

• A janela não é de nível superior nem pertence a outra janela.

O ponteiro pode ser temporário e não deve ser guardado para uso posterior.

Example

Veja o exemplo para CWnd::FindWindow.

CWnd::GetLayeredWindowAttributes

Recupera a tecla de cor opacidade e transparência de uma janela em camadas.

BOOL GetLayeredWindowAttributes(
    COLORREF* pcrKey,
    BYTE* pbAlpha,
    DWORD* pdwFlags) const;

Parâmetros

pcrKey
Apontador para um COLORREF valor que recebe a chave de cor de transparência a ser usada ao compor a janela em camadas. Todos os píxeis pintados pela janela nesta cor serão transparentes. Isto pode acontecer NULL se o argumento não for necessário.

pbAlpha
Apontador para um BYTE que recebe o valor Alpha usado para descrever a opacidade da janela em camadas. Quando a variável referida por pbAlpha é 0, a janela é completamente transparente. Quando a variável referida por pbAlpha é 255, a janela é opaca. Isto pode acontecer NULL se o argumento não for necessário.

pdwFlags
Apontador para um DWORD que recebe uma flag de camadas. Isto pode acontecer NULL se o argumento não for necessário. Para uma lista completa dos valores possíveis, veja 'GetLayeredWindowAttributes.

Valor de retorno

Não nula se a função tiver sucesso; caso contrário, 0.

Observações

Esta função de membro emula a funcionalidade da função GetLayeredWindowAttributes, conforme descrito no SDK do Windows.

CWnd::GetMenu

Recupera um ponteiro para o menu desta janela.

CMenu* GetMenu() const;

Valor de retorno

Identifica o menu. O valor é NULL se CWnd não tiver menu. O valor de retorno é indefinido se CWnd for uma janela filha.

O ponteiro devolvido pode ser temporário e não deve ser guardado para uso posterior.

Observações

Esta função não deve ser usada para janelas crianças porque não têm menu.

Example

void CMainFrame::OnCwndDeletefilemenu()
{
   // This example deletes the leftmost popup menu or leftmost
   // popup menu item from the application's main window.
   CWnd *pMain = AfxGetMainWnd();

   // The main window _can_ be NULL, so this code
   // doesn't ASSERT and actually tests.
   if (pMain != NULL)
   {
      // Get the main window's menu
      CMenu *pMenu = pMain->GetMenu();

      // If there is a menu and it has items, we'll
      // delete the first one.
      if (pMenu != NULL && pMenu->GetMenuItemCount() > 0)
      {
         pMenu->DeleteMenu(0, MF_BYPOSITION);
         // force a redraw of the menu bar
         pMain->DrawMenuBar();
      }

      // No need to delete pMenu because it is an MFC
      // temporary object.
   }
}

CWnd::GetMenuBarInfo

Recupera informações sobre a barra de menus especificada.

BOOL GetMenuBarInfo(
    LONG idObject,
    LONG idItem,
    PMENUBARINFO pmbi) const;

Parâmetros

idObject
Especifica o objeto do menu. Para uma lista de valores possíveis, veja GetMenuBarInfo.

idItem
Especifica o item para o qual obter informação. Se este parâmetro for zero, a função recupera informação sobre o próprio menu. Se este parâmetro for 1, a função recupera informação sobre o primeiro item no menu, e assim sucessivamente.

pmbi
Apontador para uma MENUBARINFO estrutura que recebe a informação.

Valor de retorno

Não nula se a função tiver sucesso; caso contrário, 0.

Observações

Esta função de membro emula a funcionalidade da função GetMenuBarInfo, conforme descrito no SDK do Windows.

CWnd::GetNextDlgGroupItem

Procura o controlo anterior ou próximo dentro de um grupo de controlos numa caixa de diálogo.

CWnd* GetNextDlgGroupItem(
    CWnd* pWndCtl,
    BOOL bPrevious = FALSE) const;

COleControlSiteOrWnd* GetNextDlgGroupItem(
    COleControlSiteOrWnd* pCurSiteOrWnd = NULL) const;

Parâmetros

pWndCtl
Identifica o controlo a ser usado como ponto de partida para a pesquisa.

bPrevious
Especifica como a função deve pesquisar o grupo de controlos na caixa de diálogo. Se TRUE, a função procura o controlo anterior no grupo; se FALSE, procura o controlo seguinte no grupo.

pCurSiteOrWnd
Identifica o COleControlSiteOrWnd controlo. Para mais informações sobre COleControlSiteOrWnd, veja Observações.

Valor de retorno

Apontar para o controlo anterior ou seguinte no grupo se a função membro for bem-sucedida.

O ponteiro devolvido pode ser temporário e não deve ser guardado para uso posterior.

Observações

Um grupo de controlos começa com um controlo criado com o WS_GROUP estilo e termina com o último controlo que não foi criado com esse WS_GROUP estilo.

Por defeito, a GetNextDlgGroupItem função membro devolve um ponteiro para o controlo seguinte no grupo. Se pWndCtl identifica o primeiro controlo do grupo e bPrevious é TRUE, GetNextDlgGroupItem devolve um ponteiro para o último controlo do grupo.

CWnd::GetNextDlgTabItem

Recupera um ponteiro para o primeiro controlo criado com o WS_TABSTOP estilo e que precede ou segue o controlo especificado.

CWnd* GetNextDlgTabItem(
    CWnd* pWndCtl,
    BOOL bPrevious = FALSE) const;

COleControlSiteOrWnd* GetNextDlgTabItem(
    COleControlSiteOrWnd* pCurSiteOrWnd,
    BOOL bPrevious) const;

Parâmetros

pWndCtl
Identifica o controlo a ser usado como ponto de partida para a pesquisa.

pCurSiteOrWnd
Identifica o COleControlSiteOrWnd controlo. Para obter mais informações sobre COleControlSiteOrWndo , consulte CWnd::GetNextDlgGroupItem.

bPrevious
Especifica como a função deve pesquisar na caixa de diálogo. Se TRUE, a função procura o controlo anterior na caixa de diálogo; se FALSE, procura o controlo seguinte.

Valor de retorno

Apontar para o controlo anterior ou seguinte que tenha o WS_TABSTOP estilo, se a função membro for bem-sucedida.

O ponteiro devolvido pode ser temporário e não deve ser guardado para uso posterior.

Para obter mais informações sobre COleControlSiteOrWndo , consulte CWnd::GetNextDlgGroupItem.

CWnd::GetNextWindow

Procura a próxima (ou anterior) janela na lista do gestor de janelas.

CWnd* GetNextWindow(UINT nFlag = GW_HWNDNEXT) const;

Parâmetros

nFlag
Especifica se a função devolve um ponteiro para a janela seguinte ou para a janela anterior. Pode ser GW_HWNDNEXT, que devolve a janela que segue o CWnd objeto na lista do gestor de janelas, ou GW_HWNDPREV, que devolve a janela anterior na lista do gestor de janelas.

Valor de retorno

Identifica a janela seguinte (ou a anterior) na lista do gestor de janelas se a função membro for bem-sucedida.

O ponteiro devolvido pode ser temporário e não deve ser guardado para uso posterior.

Observações

A lista do gestor de janelas contém entradas para todas as janelas de nível superior, as janelas filhas associadas e as janelas filhas de qualquer janela filha.

Se CWnd for uma janela de nível superior, a função procura a próxima (ou anterior) janela de nível superior; se CWnd for uma janela filha, a função procura a janela filha seguinte (ou anterior).

CWnd::GetOleControlSite

Recupera o site personalizado para o controlo ActiveX especificado.

COleControlSite* GetOleControlSite(UINT idControl) const;

Parâmetros

idControl
O ID do controlo ActiveX.

CWnd::GetOpenClipboardWindow

Recupera a maçaneta da janela que atualmente tem a prancheta aberta.

static CWnd* PASCAL GetOpenClipboardWindow();

Valor de retorno

O puxador da janela que atualmente tem a Prancheta aberta se a função for bem-sucedida; caso contrário NULL.

CWnd::GetOwner

Recupera um ponteiro para o dono da janela.

CWnd* GetOwner() const;

Valor de retorno

Um ponteiro para um CWnd objeto.

Observações

Se a janela não tiver proprietário, então um ponteiro para o objeto janela pai é devolvido por defeito. Note-se que a relação entre o proprietário e o proprietário difere do aspeto entre pais e filhos em vários aspetos importantes. Por exemplo, uma janela com um pai está confinada à área do cliente da sua janela mãe. Janelas próprias podem ser desenhadas em qualquer local do ambiente de trabalho.

O conceito de propriedade desta função é diferente do conceito de propriedade de GetWindow.

CWnd::GetParent

Chame esta função para obter um ponteiro para a janela pai de uma janela filho (se existir).

CWnd* GetParent() const;

Valor de retorno

Veja a secção Valores de Retorno no GetParent SDK do Windows.

Observações

A GetParent função devolve um ponteiro para o pai imediato (se existir). Em contraste, a GetParentOwner função devolve um ponteiro para a janela parental ou proprietária mais imediata que não é uma janela filho (não tem o WS_CHILD estilo). Se tiver uma janela de filho dentro de outra janela GetParent de criança e GetParentOwner devolverem resultados diferentes.

CWnd::GetParentFrame

Chame esta função membro para recuperar a janela do frame pai.

CFrameWnd* GetParentFrame() const;

Valor de retorno

Um apontador para uma janela de frame, se bem-sucedido; caso contrário NULL.

Observações

A função membro pesquisa a cadeia de progenitores até ser encontrado um CFrameWnd objeto (ou de classe derivada).

CWnd::GetParentOwner

Chama esta função membro para obter um ponteiro para a janela pai ou janela proprietária de uma janela filha.

CWnd* GetParentOwner() const;

Valor de retorno

Um ponteiro para um CWnd objeto. Se um CWnd objeto não estiver anexado à alça, um objeto temporário CWnd será criado e anexado. O ponteiro pode ser temporário e não deve ser guardado para uso posterior.

Observações

GetParentOwner Devolve um ponteiro para a janela parental ou proprietária mais imediata que não é uma janela filho (não tem o WS_CHILD estilo). A janela atual do proprietário pode ser definida com SetOwner. Por defeito, o pai de uma janela é o seu proprietário.

Em contraste, a GetParent função devolve um ponteiro para o pai imediato, seja ou não uma janela filha. Se tiver uma janela de filho dentro de outra janela GetParent de criança e GetParentOwner devolverem resultados diferentes.

CWnd::GetProperty

Chame esta função membro para obter a propriedade de controlo ActiveX especificada por dwDispID.

void GetProperty(
    DISPID dwDispID,
    VARTYPE vtProp,
    void* pvProp)const;

Parâmetros

dwDispID
Identifica a propriedade a recuperar.

vtProp
Especifica o tipo da propriedade a ser recuperada. Para valores possíveis, veja a secção Observações para COleDispatchDriver::InvokeHelper.

pvProp
Endereço da variável que irá receber o valor da propriedade. Deve corresponder ao tipo especificado por vtProp.

Observações

GetProperty devolve o valor através de pvProp.

Para mais informações sobre a utilização desta função membro com Contentores de Controlo ActiveX, consulte o artigo Contentores de Controlo ActiveX: Programação de Controlos ActiveX num Contentor de Controlo ActiveX.

CWnd::GetRenderTarget

Obtém um render target associado a essa janela.

CHwndRenderTarget* GetRenderTarget();

Valor de retorno

Apontador para o alvo de renderização ou NULL.

CWnd::GetSafeHwnd

Retorna m_hWnd, ou NULL se o this ponteiro for NULL.

HWND GetSafeHwnd() const;

Valor de retorno

Devolve a maçaneta da janela por uma janela. Retorna NULL se não CWnd estiver ligado a uma janela ou se for usado com um NULLCWnd apontador.

Example

Veja o exemplo para CWnd::SubclassWindow.

CWnd::GetSafeOwner

Chame esta função membro para recuperar a janela proprietária que deve ser usada para caixas de diálogo ou outras janelas modais.

static CWnd* GetSafeOwner(
    CWnd* pParent = NULL,
    HWND* pWndTop = NULL);

Parâmetros

pParent
Um indicador para uma janela dos pais CWnd . Pode ser NULL.

pWndTop
Um apontador para a janela que está atualmente no topo. Pode ser NULL.

Valor de retorno

Um indicador para o dono do cofre para a janela em questão.

Observações

O proprietário do cofre é o primeiro progenitor que não é filho de pParent. Se pParent for NULL, a janela principal do tópico (recuperada via AfxGetMainWnd) é usada para encontrar um proprietário.

CWnd::GetScrollBarCtrl

Chame esta função membro para obter um apontador para a barra de scroll irmã ou janela divisora especificada.

virtual CScrollBar* GetScrollBarCtrl(int nBar) const;

Parâmetros

nBar
Especifica o tipo de barra de deslocamento. O parâmetro pode assumir um dos seguintes valores:

• SB_HORZ Recupera a posição da barra de deslocamento horizontal.

• SB_VERT Recupera a posição da barra de scroll vertical.

Valor de retorno

Um controlo de barra de scroll irmão, ou NULL se não houver.

Observações

Esta função membro não opera em barras de scroll criadas quando os WS_HSCROLL bits ou WS_VSCROLL são definidos durante a criação de uma janela. A CWnd implementação desta função simplesmente devolve NULL. Classes derivadas, como CView, implementam a funcionalidade descrita.

CWnd::GetScrollBarInfo

Recupera informações sobre a barra de scroll especificada.

BOOL GetScrollBarInfo(
    LONG idObject,
    PSCROLLBARINFO psbi) const;

Parâmetros

idObject
Especifica o objeto do menu. Para uma lista de valores possíveis, veja GetScrollBarInfo.

psbi
Apontador para uma SCROLLBARINFO estrutura que recebe a informação.

Valor de retorno

Não nula se a função tiver sucesso; caso contrário, 0.

Observações

Esta função de membro emula a funcionalidade da função GetScrollBarInfo, conforme descrito no SDK do Windows.

CWnd::GetScrollInfo

Chame esta função membro para recuperar a informação que a SCROLLINFO estrutura mantém sobre uma barra de deslocamento.

BOOL GetScrollInfo(
    int nBar,
    LPSCROLLINFO lpScrollInfo,
    UINT nMask = SIF_ALL);

Parâmetros

nBar
Especifica se a barra de deslocamento é um controlo ou parte da área não cliente de uma janela. Se fizer parte da área não cliente, nBar indica também se a barra de deslocamento está posicionada horizontalmente, verticalmente ou ambas. Deve ser um dos seguintes:

• SB_CTL Recupera os parâmetros para um controlo de barra de deslocamento. O m_hWnd elemento de dados deve ser o alavanca do controlo da barra de deslocamento.

• SB_HORZ Recupera os parâmetros para a barra horizontal padrão da janela.

• SB_VERT Recupera os parâmetros para a barra de scroll vertical padrão da janela.

lpScrollInfo
Um ponteiro para uma SCROLLINFO estrutura. Consulte o Windows SDK para mais informações sobre esta estrutura.

nMask
Especifica os parâmetros da barra de deslocamento a recuperar. O padrão especifica uma combinação de SIF_PAGE, SIF_POS, SIF_TRACKPOS, e SIF_RANGE. Consulte SCROLLINFO para mais informações sobre os nMask valores.

Valor de retorno

Se a mensagem recuperou algum valor, o retorno é TRUE. Caso contrário, é FALSE.

Observações

GetScrollInfo permite que as aplicações utilizem posições de scroll de 32 bits.

A SCROLLINFO estrutura contém informações sobre uma barra de deslocamento, incluindo as posições mínima e máxima, o tamanho da página e a posição da caixa de deslocamento (o polegar). Consulte o SCROLLINFO tópico de estrutura no SDK do Windows para mais informações sobre como alterar os padrões de estrutura.

Os manipuladores de mensagens MFC do Windows que indicam a posição da barra de deslocamento, CWnd::OnHScroll e CWnd::OnVScroll, fornecem apenas 16 bits de dados de posição. GetScrollInfo e SetScrollInfo fornecem 32 bits de dados de posição da barra de deslocamento. Assim, uma aplicação pode chamar GetScrollInfo enquanto processa ou CWnd::OnVScrollCWnd::OnHScroll para obter dados de posição em barra de scroll de 32 bits.

CWnd::GetScrollLimit

Chame esta função membro para recuperar a posição máxima de scroll da barra de scroll.

int GetScrollLimit(int nBar);

Parâmetros

nBar
Especifica o tipo de barra de deslocamento. O parâmetro pode assumir um dos seguintes valores:

• SB_HORZ Recupera o limite de scroll da barra de scroll horizontal.

• SB_VERT Recupera o limite de scroll da barra vertical.

Valor de retorno

Especifica a posição máxima de uma barra de deslocamento se for bem-sucedido; caso contrário, 0.

CWnd::GetScrollPos

Recupera a posição atual da caixa de deslocamento de uma barra de deslocamento.

int GetScrollPos(int nBar) const;

Parâmetros

nBar
Especifica a barra de deslocamento a examinar. O parâmetro pode assumir um dos seguintes valores:

• SB_HORZ Recupera a posição da barra de deslocamento horizontal.

• SB_VERT Recupera a posição da barra de scroll vertical.

Valor de retorno

Especifica a posição atual da caixa de deslocamento na barra de deslocamento se for bem-sucedido; caso contrário, 0.

Observações

A posição atual é um valor relativo que depende do intervalo de scrolling atual. Por exemplo, se o intervalo de scroll for de 50 a 100 e a caixa de scroll estiver no meio da barra, a posição atual é 75.

CWnd::GetScrollRange

Copia as posições mínimas e máximas atuais da barra de rolagem para a barra de rolagem dada para as localizações especificadas por lpMinPos e lpMaxPos.

void GetScrollRange(
    int nBar,
    LPINT lpMinPos,
    LPINT lpMaxPos) const;

Parâmetros

nBar
Especifica a barra de deslocamento a examinar. O parâmetro pode assumir um dos seguintes valores:

• SB_HORZ Recupera a posição da barra de deslocamento horizontal.

• SB_VERT Recupera a posição da barra de scroll vertical.

lpMinPos
Aponta para a variável inteira que deve receber a posição mínima.

lpMaxPos
Aponta para a variável inteira que recebe a posição máxima.

Observações

Se CWnd não tiver barra de deslocamento, então a GetScrollRange função membro copia 0 para lpMinPos e lpMaxPos.

O intervalo padrão para uma barra de scroll padrão é de 0 a 100. O intervalo padrão para um controlo de barra de deslocamento é vazio (ambos os valores são 0).

CWnd::GetStyle

Devolve o estilo de janela atual.

DWORD GetStyle() const;

Valor de retorno

O estilo da janela. Para mais informações sobre os estilos de janelas usados no MFC, veja Estilos de Janelas.

CWnd::GetSystemMenu

Permite à aplicação aceder ao menu de Controlo para copiar e modificar.

CMenu* GetSystemMenu(BOOL bRevert) const;

Parâmetros

bRevert
Especifica a ação a tomar. Se bRevert for FALSE, GetSystemMenu devolve um handle a uma cópia do menu Control atualmente em uso. Esta cópia é inicialmente idêntica ao menu Control, mas pode ser modificada. Se bRevert for TRUE, GetSystemMenu reinicia o menu de Controlo de volta ao estado predefinido. O menu de Controlo anterior, possivelmente modificado, se é que existe, é destruído. O valor de retorno é indefinido neste caso.

Valor de retorno

Identifica uma cópia do menu de Controlo se bRevert for FALSE. Se bRevert for TRUE, o valor de retorno é indefinido.

O ponteiro devolvido pode ser temporário e não deve ser guardado para uso posterior.

Observações

Qualquer janela que não use GetSystemMenu para criar a sua própria cópia do menu Control recebe o menu Control padrão.

O ponteiro devolvido pela GetSystemMenu função membro pode ser usado com as CMenu::AppendMenufunções , CMenu::InsertMenu, ou CMenu::ModifyMenu para alterar o menu Control.

O menu de Controlo contém inicialmente elementos identificados com vários valores de ID, como SC_CLOSE, SC_MOVE, e SC_SIZE. Os itens no menu de Controlo geram WM_SYSCOMMAND mensagens. Todos os itens pré-definidos do menu Control têm números de ID superiores a 0xF000. Se uma aplicação adicionar itens ao menu Controlo, deverá usar números de ID inferiores a F000.

As janelas podem automaticamente tornar os itens indisponíveis no menu de Controlo padrão. CWnd pode realizar a sua própria seleção ou indisponibilidade respondendo às WM_INITMENU mensagens, que são enviadas antes de qualquer menu ser exibido.

Example

// The following code fragment is taken from CMyDlg::OnInitDialog
// CMyDlg is derived from CDialog

// Add "About..." menu item to system menu.

// IDM_ABOUTBOX must be in the system command range.
ASSERT((IDM_ABOUTBOX & 0xFFF0) == IDM_ABOUTBOX);
ASSERT(IDM_ABOUTBOX < 0xF000);

CMenu *pSysMenu = GetSystemMenu(FALSE);
if (pSysMenu != NULL)
{
   CString strAboutMenu;
   strAboutMenu.LoadString(IDS_ABOUT);
   if (!strAboutMenu.IsEmpty())
   {
      pSysMenu->AppendMenu(MF_SEPARATOR);
      pSysMenu->AppendMenu(MF_STRING, IDM_ABOUTBOX, strAboutMenu);
   }
}

// Set the icon for this dialog. The framework does this automatically
// when the application's main window is not a dialog
SetIcon(m_hIcon, TRUE);  // Set big icon
SetIcon(m_hIcon, FALSE); // Set small icon

CWnd::GetTitleBarInfo

Recupera informações sobre a barra de título especificada.

BOOL GetTitleBarInfo(PTITLEBARINFO pti) const;

Parâmetros

pti
Apontador para uma TITLEBARINFO estrutura que recebe a informação.

Observações

Esta função de membro emula a funcionalidade da função GetTitleBarInfo, conforme descrito no SDK do Windows.

CWnd::GetTopLevelFrame

Chame esta função membro para recuperar a janela de frames de nível superior da janela, se existir.

CFrameWnd* GetTopLevelFrame() const;

Valor de retorno

Identifica a janela de moldura de nível superior da janela.

O ponteiro devolvido pode ser temporário e não deve ser guardado para uso posterior.

Observações

Se não tiver janela anexada, ou se CWnd o seu pai de topo não for um CFrameWndobjeto derivado em , esta função devolve NULL.

CWnd::GetTopLevelOwner

Chame esta função membro para recuperar a janela de nível superior.

CWnd* GetTopLevelOwner() const;

Valor de retorno

Identifica a janela de nível superior. O ponteiro devolvido pode ser temporário e não deve ser guardado para uso posterior.

Observações

A janela de nível superior é a janela que é filha do ambiente de trabalho. Se CWnd não tiver janela anexada, esta função devolve NULL.

CWnd::GetTopLevelParent

Chame esta função membro para recuperar o pai de topo da janela.

CWnd* GetTopLevelParent() const;

Valor de retorno

Identifica a janela principal de nível superior da janela.

O ponteiro devolvido pode ser temporário e não deve ser guardado para uso posterior.

Observações

GetTopLevelParent é semelhante a GetTopLevelFrame e GetTopLevelOwner; no entanto, ignora o conjunto de valores como janela atual do proprietário.

CWnd::GetTopWindow

Procura a janela filha de nível superior que pertence a CWnd.

CWnd* GetTopWindow() const;

Valor de retorno

Identifica a janela filha de nível superior numa CWnd lista ligada de janelas filhas. Se não existirem janelas filhas, o valor é NULL.

O ponteiro devolvido pode ser temporário e não deve ser guardado para uso posterior.

Observações

Se CWnd não tiver filhos, esta função devolve NULL.

CWnd::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);

Parâmetros

lpRect
Aponta para um CRect objeto ou RECT estrutura que irá receber as coordenadas do cliente da atualização que envolve a região de atualização.

Defina este parâmetro para NULL determinar se existe uma região de atualização dentro do CWnd. Se lpRect for NULL, a GetUpdateRect função membro devolve não nula se existir uma região de atualização e 0 se não existir. Isto permite determinar se uma WM_PAINT mensagem resultou de uma área inválida. Não defina este parâmetro para NULL na versão 3.0 do Windows e anteriores.

bErase
Especifica se o fundo na região de atualização deve ser apagado.

Valor de retorno

Especifica o estado da região de atualização. O valor é diferente de zero se a região de atualização não estiver vazia; caso contrário, 0.

Se o lpRect parâmetro for definido para NULL, o valor de retorno é diferente de zero se existir uma região de atualização; caso contrário, 0.

Observações

Se CWnd foi criado com o CS_OWNDC estilo e o modo de mapeamento não MM_TEXTé , a GetUpdateRect função membro dá o retângulo em coordenadas lógicas. Caso contrário, GetUpdateRect dá o retângulo em coordenadas do cliente. Se não houver região de atualização, GetUpdateRect define o retângulo como vazio (define todas as coordenadas para 0).

O bErase parâmetro especifica se GetUpdateRect deve apagar o fundo da região de atualização. Se bErase for TRUE e a região de atualização não estiverem vazias, o fundo é apagado. Para apagar o fundo, GetUpdateRect envia a WM_ERASEBKGND mensagem.

O retângulo de atualização recuperado pela BeginPaint função membro é idêntico ao recuperado pela GetUpdateRect função membro.

A BeginPaint função membro valida automaticamente a região de atualização, por isso qualquer chamada GetUpdateRect feita imediatamente após uma chamada BeginPaint recupera uma região de atualização vazia.

CWnd::GetUpdateRgn

Recupera a região de atualização numa região identificada por pRgn.

int GetUpdateRgn(
    CRgn* pRgn,
    BOOL bErase = FALSE);

Parâmetros

pRgn
Identifica a região de atualização.

bErase
Especifica se o fundo será apagado e se as áreas não clientes das janelas filhas serão desenhadas. Se o valor for FALSE, não se faz nenhum desenho.

Valor de retorno

Especifica uma bandeira de inteiro curto que indica o tipo de região resultante. O valor pode assumir qualquer um dos seguintes:

• SIMPLEREGION A região não tem fronteiras sobrepostas.

• COMPLEXREGION A região tem fronteiras sobrepostas.

• NULLREGION A região está vazia.

• ERROR Nenhuma região foi criada.

Observações

As coordenadas desta região são relativas ao canto superior esquerdo (coordenadas do cliente).

A BeginPaint função membro valida automaticamente a região de atualização, por isso qualquer chamada GetUpdateRgn feita imediatamente após uma chamada BeginPaint recupera uma região de atualização vazia.

CWnd::GetWindow

Devolve um ponteiro para a janela solicitada, ou NULL se não houver.

CWnd* GetWindow(UINT nCmd) const;

Parâmetros

nCmd
Especifica a relação entre CWnd e a janela devolvida. Pode assumir um dos seguintes valores:

• GW_CHILD Identifica a CWnd primeira janela filha.

• GW_HWNDFIRST Se CWnd for uma janela de criança, devolve a primeira janela de irmãos. Caso contrário, devolve a primeira janela de topo na lista.

• GW_HWNDLAST Se CWnd for uma janela de filho, devolve a última janela de irmãos. Caso contrário, devolve a última janela de topo na lista.

• GW_HWNDNEXT Devolve a próxima janela na lista do gestor de janelas.

• GW_HWNDPREV Devolve a janela anterior na lista do gestor de janelas.

• GW_OWNER Identifica o CWnd proprietário.

Valor de retorno

O ponteiro devolvido pode ser temporário e não deve ser guardado para uso posterior.

CWnd::GetWindowContextHelpId

Chame esta função membro para recuperar o identificador de contexto de ajuda, se existir, associado à janela.

DWORD GetWindowContextHelpId() const;

Valor de retorno

O identificador de contexto da ajuda. Devolve 0 se a janela não tiver nenhuma.

CWnd::GetWindowedChildCount

Chame esta função membro para recuperar o número de janelas filhas associadas.

long GetWindowedChildCount();

Valor de retorno

O número de janelas filhas associadas ao CWnd objeto.

CWnd::GetWindowDC

Recupera o contexto de exibição de toda a janela, incluindo a barra de legendas, menus e barras de scroll.

CDC* GetWindowDC();

Valor de retorno

Identifica o contexto de exibição para a janela dada se a função for bem-sucedida; caso contrário NULL.

O ponteiro devolvido pode ser temporário e não deve ser guardado para uso posterior. ReleaseDC deve ser chamada uma vez por cada chamada bem-sucedida para GetWindowDC.

Observações

Um contexto de exibição de janela permite pintar em qualquer lugar em CWnd, uma vez que a origem do contexto é o canto superior esquerdo de CWnd em vez da área do cliente.

Atributos padrão são atribuídos ao contexto de visualização cada vez que este recupera o contexto. Atributos anteriores são perdidos.

GetWindowDC destina-se a ser usado para efeitos especiais de pintura dentro da CWnd área não cliente. Não é recomendado pintar em áreas não relacionadas com o cliente de qualquer janela.

A GetSystemMetrics função Windows pode ser usada para recuperar as dimensões de várias partes da área não cliente, como a barra de legendas, menus e barras de scroll.

Depois de concluída a pintura, deve ser chamada a ReleaseDC função membro para libertar o contexto de visualização. A falha em libertar o contexto do ecrã afetará seriamente a pintura solicitada pelas aplicações devido às limitações no número de contextos de dispositivos que podem ser abertos ao mesmo tempo.

CWnd::GetWindowInfo

Recupera informações sobre a janela.

BOOL GetWindowInfo(PWINDOWINFO pwi) const;

Parâmetros

pwi
Um ponteiro para uma WINDOWINFO estrutura.

Observações

Esta função de membro emula a funcionalidade da função GetWindowInfo, conforme descrito no SDK do Windows.

CWnd::GetWindowlessChildCount

Recupera o número de janelas filhas sem janelas associadas.

long GetWindowlessChildCount();

Valor de retorno

O número de janelas filhas sem janelas associadas ao CWnd objeto.

CWnd::GetWindowPlacement

Recupera o estado de exibição e as posições normais (restauradas), minimizadas e maximizadas de uma janela.

BOOL GetWindowPlacement(WINDOWPLACEMENT* lpwndpl) const;

Parâmetros

lpwndpl
Aponta para a WINDOWPLACEMENT estrutura que recebe a informação de estado e posição do espetáculo.

Valor de retorno

Diferente de zero se a função for bem-sucedida; caso contrário, 0.

Observações

O flags elemento da WINDOWPLACEMENT estrutura recuperado por esta função é sempre 0. Se CWnd for maximizado, o showCmd elemento de WINDOWPLACEMENT é SW_SHOWMAXIMIZED. Se a janela for minimizada, é SW_SHOWMINIMIZED. Caso SW_SHOWNORMAL contrário.

CWnd::GetWindowRect

Copia as dimensões do retângulo delimitador do CWnd objeto para a estrutura apontada por lpRect.

void GetWindowRect(LPRECT lpRect) const;

Parâmetros

lpRect
Aponta para um CRect objeto ou umaRECT estrutura que receberá as coordenadas do ecrã dos cantos superior esquerdo e inferior direito.

Observações

As dimensões são dadas em coordenadas do ecrã relativas ao canto superior esquerdo do ecrã. As dimensões da legenda, da borda e das barras de scroll, se presentes, estão incluídas.

CWnd::GetWindowRgn

Chame esta função membro para obter a região da janela de uma janela.

int GetWindowRgn(HRGN hRgn)const;

Parâmetros

hRgn
Uma pega para uma região de janela.

Valor de retorno

O valor de retorno especifica o tipo da região que a função obtém. Pode ser um dos seguintes valores:

• NULLREGION A região está vazia.

• SIMPLEREGION A região é um único retângulo.

• COMPLEXREGION A região é composta por mais do que um retângulo.

• ERROR Ocorreu um erro; a região não é afetada.

Observações

A região da janela determina a área dentro da janela onde o sistema operativo permite desenhar. O sistema operativo não exibe nenhuma parte de uma janela que esteja fora da região da janela.

As coordenadas da região da janela são relativas ao canto superior esquerdo da janela, não à área cliente da janela.

Para definir a região da janela de uma janela, chame CWnd::SetWindowRgn.

CWnd::GetWindowText

Copia o CWnd título da legenda (se houver) para o buffer apontado por lpszStringBuf ou para a cadeia rStringde destino .

int GetWindowText(
    LPTSTR lpszStringBuf,
    int nMaxCount) const;

void GetWindowText(
    CString& rString) const;

Parâmetros

lpszStringBuf
Aponta para o buffer que irá receber a cadeia copiada do título da janela.

nMaxCount
Especifica o número máximo de caracteres a serem copiados para o buffer, incluindo o carácter nulo que termina. Se a cadeia for maior do que o número de caracteres especificados em nMaxCount, é truncada.

rString
Um CString objeto que deve receber a cadeia copiada do título da janela.

Valor de retorno

Especifica o comprimento, em caracteres, da cadeia copiada, não incluindo o carácter nulo de terminação. É 0 se CWnd não tiver legenda ou se a legenda estiver vazia.

Observações

Se o CWnd objeto for um controlo, a GetWindowText função membro copia o texto dentro do controlo em vez de copiar a legenda.

Esta função membro faz com que a WM_GETTEXT mensagem seja enviada para o CWnd objeto.

Example

Veja o exemplo para CWnd::SetWindowText.

CWnd::GetWindowTextLength

Devolve o comprimento do título da CWnd legenda do objeto.

int GetWindowTextLength() const;

Valor de retorno

Especifica o comprimento do texto em caracteres, não incluindo qualquer carácter de terminação nula. O valor é 0 se tal texto não existir.

Observações

Se CWnd for um controlo, a GetWindowTextLength função membro devolve o comprimento do texto dentro do controlo em vez da legenda.

Esta função membro faz com que a WM_GETTEXTLENGTH mensagem seja enviada para o CWnd objeto.

Example

Veja o exemplo para CWnd::SetWindowText.

CWnd::HideCaret

Esconde o caret removendo-o do ecrã.

void HideCaret();

Observações

Embora o caret já não seja visível, pode ser novamente exibido usando a ShowCaret função elemento. Esconder o caret não destrói a sua forma atual.

Esconder-se é cumulativo. Se HideCaret foi chamada cinco vezes seguidas, a ShowCaret função membro deve ser chamada cinco vezes antes de o caret ser mostrado.

CWnd::HiliteMenuItem

Destaca ou remove o destaque de um item do menu de nível superior (barra de menu).

BOOL HiliteMenuItem(
    CMenu* pMenu,
    UINT nIDHiliteItem,
    UINT nHilite);

Parâmetros

pMenu
Identifica o menu de topo que contém o item a destacar.

nIDHiliteItem
Especifica o item do menu a destacar, dependendo do valor do nHilite parâmetro.

nHilite
Especifica se o item do menu é destacado ou se o destaque é removido. Pode ser uma combinação de MF_HILITE ou MF_UNHILITE com MF_BYCOMMAND ou MF_BYPOSITION. Os valores podem ser combinados usando o operador bit a OR bit. Estes valores têm os seguintes significados:

• MF_BYCOMMAND Interpreta nIDHiliteItem como o ID do item do menu (a interpretação padrão).

• MF_BYPOSITION Interpreta nIDHiliteItem como o deslocamento zero do item do menu.

• MF_HILITE Destaca o item. Se este valor não for indicado, o destaque é removido do item.

• MF_UNHILITE Remove o destaque do item.

Valor de retorno

Especifica se o item do menu foi destacado. Diferente de zero se o item estivesse destacado; caso contrário, 0.

Observações

Os MF_HILITE flags e MF_UNHILITE só podem ser usados com esta função membro; não podem ser usados com a CMenu::ModifyMenu função membro.

CWnd::HtmlHelp

Chame esta função membro para invocar a aplicação HTMLHelp.

virtual void HtmlHelp(
    DWORD_PTR dwData,
    UINT nCmd = 0x000F);

Parâmetros

dwData
Especifica dados adicionais. O valor utilizado depende do valor do nCmd parâmetro.

nCmd
Especifica o tipo de ajuda solicitada. Para uma lista de valores possíveis e como estes afetam o dwData parâmetro, consulte o uCommand parâmetro descrito na Referência da API de Ajuda HTML no SDK do Windows.

Observações

Consulte CWinApp::HtmlHelp para obter mais informações.

CWnd::InitDynamicLayout

Chamado pelo framework para inicializar o layout dinâmico de uma janela.

void InitDynamicLayout();

Observações

Não chame este método diretamente.

CWnd::Invalidate

Invalida toda a área do cliente de CWnd.

void Invalidate(BOOL bErase = TRUE);

Parâmetros

bErase
Especifica se o fundo dentro da região de atualização deve ser apagado.

Observações

A área do cliente está marcada para pintura quando surge a próxima WM_PAINT mensagem. A região também pode ser validada antes de ocorrer uma WM_PAINT mensagem pela ValidateRect função de membro.ValidateRgn

O bErase parâmetro especifica se o fundo dentro da área de atualização deve ser apagado quando a região de atualização for processada. Se bErase for TRUE, o fundo é apagado quando a BeginPaint função membro é chamada; se bErase for FALSE, o fundo permanece inalterado. Se bErase for TRUE para qualquer parte da região de atualização, o fundo em toda a região, e não apenas na parte dada, é apagado.

O Windows envia uma WM_PAINT mensagem sempre que a CWnd região de atualização não está vazia e não há outras mensagens na fila da aplicação para essa janela.

Example

Veja o exemplo para CWnd::UpdateWindow.

CWnd::InvalidateRect

Invalida a área cliente dentro do retângulo dado ao adicionar esse retângulo à CWnd região de atualização.

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

Parâmetros

lpRect
Aponta para um CRect objeto ou estruturaRECT que contém o retângulo (em coordenadas do cliente) a ser adicionado à região de atualização. Se lpRect for NULL, toda a área do cliente é adicionada à região.

bErase
Especifica se o fundo dentro da região de atualização deve ser apagado.

Observações

O retângulo invalidado, juntamente com todas as outras áreas na região de atualização, é marcado para pintura quando a próxima WM_PAINT mensagem é enviada. As áreas invalidadas acumulam-se na região de atualização até que a região seja processada quando ocorre a próxima WM_PAINT chamada, ou até que a região seja validada pela ValidateRect função ou ValidateRgn membro.

O bErase parâmetro especifica se o fundo dentro da área de atualização deve ser apagado quando a região de atualização for processada. Se bErase for TRUE, o fundo é apagado quando a BeginPaint função membro é chamada; se bErase for FALSE, o fundo permanece inalterado. Se bErase for TRUE para qualquer parte da região de atualização, o fundo em toda a região é apagado, não apenas na parte dada.

O Windows envia uma WM_PAINT mensagem sempre que a CWnd região de atualização não está vazia e não há outras mensagens na fila da aplicação para essa janela.

CWnd::InvalidateRgn

Invalida a área do cliente dentro da região dada ao adicioná-la à região de atualização atual de CWnd.

void InvalidateRgn(
    CRgn* pRgn,
    BOOL bErase = TRUE);

Parâmetros

pRgn
Um apontador para um CRgn objeto que identifica a região a ser adicionada à região de atualização. Assume-se que a região tem coordenadas do cliente. Se este parâmetro for NULL, toda a área do cliente é adicionada à região de atualização.

bErase
Especifica se o fundo dentro da região de atualização deve ser apagado.

Observações

A região invalidada, juntamente com todas as outras áreas da região de atualização, é marcada para ser pintada quando a WM_PAINT mensagem for enviada novamente. As áreas invalidadas acumulam-se na região de atualização até que a região seja processada quando uma WM_PAINT mensagem é enviada novamente, ou até que a região seja validada pela ValidateRect função de membro de OR ValidateRgn .

O bErase parâmetro especifica se o fundo dentro da área de atualização deve ser apagado quando a região de atualização for processada. Se bErase for TRUE, o fundo é apagado quando a BeginPaint função membro é chamada; se bErase for FALSE, o fundo permanece inalterado. Se bErase for TRUE para qualquer parte da região de atualização, o fundo em toda a região, e não apenas na parte dada, é apagado.

O Windows envia uma WM_PAINT mensagem sempre que a CWnd região de atualização não está vazia e não há outras mensagens na fila da aplicação para essa janela.

A região em questão deve ter sido criada anteriormente por uma das funções da região.

CWnd::InvokeHelper

Chame esta função membro para invocar o método ActiveX Control ou propriedade especificada por dwDispID, no contexto especificado por wFlags.

void AFX_CDECL InvokeHelper(
    DISPID dwDispID,
    WORD wFlags,
    VARTYPE vtRet,
    void* pvRet,
    const BYTE* pbParamInfo,
    ... );

Parâmetros

dwDispID
Identifica o método ou propriedade a ser invocada.

wFlags
Bandeiras que descrevem o contexto da chamada para IDispatch::Invoke.

vtRet
Especifica o tipo do valor de retorno. Para valores possíveis, veja a secção Observações para COleDispatchDriver::InvokeHelper.

pvRet
Endereço da variável que irá receber o valor da propriedade ou devolver o valor. Deve corresponder ao tipo especificado por vtRet.

pbParamInfo
Apontador para uma cadeia de bytes terminada por nulo que especifica os tipos dos parâmetros após pbParamInfo. Para valores possíveis, veja a secção Observações para COleDispatchDriver::InvokeHelper.

...
Lista de variáveis de parâmetros, de tipos especificados em pbParamInfo.

Observações

O pbParamInfo parâmetro especifica os tipos de parâmetros passados ao método ou propriedade. A lista de variáveis de argumentos é representada por ... na declaração de sintaxe.

Esta função converte os parâmetros em VARIANTARG valores e depois invoca o IDispatch::Invoke método no controlo ActiveX. Se a chamada falhar IDispatch::Invoke , esta função lançará uma exceção. Se o SCODE (código de estado) devolvido por IDispatch::Invoke for DISP_E_EXCEPTION, esta função lança um COleException objeto, caso contrário lança um COleDispatchException.

Para mais informações sobre a utilização desta função membro com Contentores de Controlo ActiveX, consulte o artigo Contentores de Controlo ActiveX: Programação de Controlos ActiveX num Contentor de Controlo ActiveX.

CWnd::IsChild

Indica se a janela especificada por pWnd é uma janela filha ou outro descendente direto de CWnd.

BOOL IsChild(const CWnd* pWnd) const;

Parâmetros

pWnd
Identifica a janela a ser testada.

Valor de retorno

Especifica o resultado da função. O valor é diferente de zero se a janela identificada por pWnd for uma janela filha de CWnd; caso contrário, 0.

Observações

Uma janela filho é o descendente direto de CWnd se o CWnd objeto estiver na cadeia de janelas pais que conduz da janela pop-up original à janela filha.

CWnd::IsD2DSupportEnabled

Determina se o suporte a D2D está ativado.

BOOL IsD2DSupportEnabled();

Valor de retorno

TRUE se a funcionalidade estiver ativada; caso contrário FALSE.

CWnd::IsDialogMessage

Chame esta função membro para determinar se a mensagem dada é destinada a uma caixa de diálogo sem modos; se for, esta função processa a mensagem.

BOOL IsDialogMessage(LPMSG lpMsg);

Parâmetros

lpMsg
Aponta para uma MSG estrutura que contém a mensagem a verificar.

Valor de retorno

Especifica se a função membro processou a mensagem dada. É diferente de zero se a mensagem tiver sido processada; caso contrário, 0. Se o retorno for 0, chame a CWnd::PreTranslateMessage função membro da classe base para processar a mensagem. Numa sobreposição da CWnd::PreTranslateMessage função membro, o código apresenta-se assim:

BOOL CAboutDlg::PreTranslateMessage(MSG *pMsg)
{
   if (IsDialogMessage(pMsg))
      return TRUE;
   else
      return CDialog::PreTranslateMessage(pMsg);
}

Observações

Quando a IsDialogMessage função processa uma mensagem, verifica mensagens de teclado e converte-as em comandos de seleção para a correspondente caixa de diálogo. Por exemplo, a tecla TAB seleciona o próximo controlo ou grupo de controlos, e a tecla SETA PARA BAIXO seleciona o próximo controlo num grupo.

Não deve passar uma mensagem processada IsDialogMessage para as TranslateMessage funções do Windows, DispatchMessage porque já foi processada.

CWnd::IsDlgButtonChecked

Determina se um controlo de botão tem uma marca de verificação ao lado.

UINT IsDlgButtonChecked(int nIDButton) const;

Parâmetros

nIDButton
Especifica o identificador inteiro do controlo do botão.

Valor de retorno

Não nulo se o controlo dado estiver marcado, e 0 se não estiver marcado. Só se podem assinalar botões de rádio e caixas de verificação. Para botões de três estados, o valor de retorno pode ser 2 se o botão for indeterminado. Esta função membro devolve 0 para um botão.

Observações

Se o botão for um controlo de três estados, a função elemento determina se está escurecido, verificado ou nenhum dos dois.

CWnd::IsDynamicLayoutEnabled

Determina se o layout dinâmico está ativado nesta janela. Se o layout dinâmico estiver ativado, a posição e o tamanho das janelas filhas podem mudar quando o utilizador redimensiona a janela principal.

BOOL IsDynamicLayoutEnabled() const;

Valor de retorno

TRUE se o layout dinâmico estiver ativado; caso contrário FALSE.

Observações

CWnd::IsIconic

Especifica se CWnd é minimizado (icónico).

BOOL IsIconic() const;

Valor de retorno

Não nulo se CWnd for minimizado; caso contrário 0.

Example

void CAboutDlg::OnPaint()
{
   // This code, normally emitted by the Application Wizard for a dialog-
   // based project for the dialog's WM_PAINT handler, runs only if the
   // window is iconic. The window erases the icon's area, then
   // paints the icon referenced by m_hIcon.
   if (IsIconic())
   {
      CPaintDC dc(this); // device context for painting

      SendMessage(WM_ICONERASEBKGND, (WPARAM)dc.GetSafeHdc(), 0);

      // Center icon in client rectangle
      int cxIcon = GetSystemMetrics(SM_CXICON);
      int cyIcon = GetSystemMetrics(SM_CYICON);
      CRect rect;
      GetClientRect(&rect);
      int x = (rect.Width() - cxIcon + 1) / 2;
      int y = (rect.Height() - cyIcon + 1) / 2;

      // Draw the icon
      dc.DrawIcon(x, y, m_hIcon);
   }
   else
   {
      CDialog::OnPaint();
   }
}

CWnd::IsTouchWindow

Especifica se CWnd tem suporte por toque.

BOOL IsTouchWindow() const;

Valor de retorno

TRUE se CWnd tiver suporte de toque; caso contrário FALSE.

Observações

CWnd::IsWindowEnabled

Especifica se CWnd está ativado para entrada de rato e teclado.

BOOL IsWindowEnabled() const;

Valor de retorno

Não nulo se CWnd estiver ativado; caso contrário 0.

Example

//change the background color of an edit control on the dialog
HBRUSH CMyDlg::OnCtlColor(CDC *pDC, CWnd *pWnd, UINT nCtlColor)
{
   HBRUSH hbr = CDialog::OnCtlColor(pDC, pWnd, nCtlColor);

   if (pWnd->GetDlgCtrlID() == IDC_MYEDIT)
   {
      if (pWnd->IsWindowEnabled())
      {
         // Red brush for the background...
         pDC->SetBkColor(RGB(255, 0, 0));
         // m_pRedBrush is the CBrush object initialized with a red brush
         // using CreateSolidBrush
         return (HBRUSH)m_RedBrush.GetSafeHandle();
      }
      else
      {
         // Blue brush for the background...
         pDC->SetBkColor(RGB(0, 0, 255));
         // m_pBlueBrush is the CBrush object initialized with a blue
         // brush using CreateSolidBrush
         return (HBRUSH)m_BlueBrush.GetSafeHandle();
      }
   }

   return hbr;
}

CWnd::IsWindowVisible

Determina o estado de visibilidade da janela dada.

BOOL IsWindowVisible() const;

Valor de retorno

Não nulo se CWnd for visível (tem o WS_VISIBLE bit de estilo definido, e a janela pai é visível). Como o valor de retorno reflete o estado do WS_VISIBLE bit de estilo, o valor de retorno pode ser diferente de zero, mesmo estando CWnd totalmente oculto por outras janelas.

Observações

Uma janela possui um estado de visibilidade indicado pela WS_VISIBLE parte de estilo. Quando este bit de estilo é definido com uma chamada para a ShowWindow função membro, a janela é exibida e o desenho subsequente para a janela é exibido desde que a janela tenha o bit de estilo definido.

Qualquer desenho de uma janela que tenha esse WS_VISIBLE estilo não será exibido se a janela estiver coberta por outras janelas ou estiver recortada pela sua janela principal.

Example

// This example uses the CWnd::IsWindowVisible() function to
// determine if a dialog box is visible. If it is not, it calls
// CWnd::ShowWindow with the SW_SHOWNORMAL command.
void CMainFrame::DisplayModeless()
{
   if(!m_Modeless.IsWindowVisible())
   {
      m_Modeless.ShowWindow(SW_SHOWNORMAL);
   }
}

// This example uses the CWnd::IsWindowVisible() function to
// determine if a dialog box is visible. If it is, it calls
// CWnd::ShowWindow with the SW_HIDE command.
void CMainFrame::HideModeless()
{
   if(m_Modeless.IsWindowVisible())
   {
      m_Modeless.ShowWindow(SW_HIDE);
   }
}

CWnd::IsZoomed

Determina se CWnd foi maximizado.

BOOL IsZoomed() const;

Valor de retorno

Não nulo se CWnd for maximizado; caso contrário 0.

CWnd::KillTimer

Mata o evento temporizador identificado pela nIDEvent chamada anterior para SetTimer.

BOOL KillTimer(UINT_PTR nIDEvent);

Parâmetros

nIDEvent
O valor do evento temporizador passou para SetTimer.

Valor de retorno

Especifica o resultado da função. O valor é diferente de zero se o evento foi eliminado. É 0 se a KillTimer função membro não conseguir encontrar o evento temporizador especificado.

Observações

As mensagens pendentes WM_TIMER associadas ao temporizador não são removidas da fila de mensagens.

Example

Veja o exemplo para CWnd::SetTimer.

CWnd::LoadDynamicLayoutResource

Chamado pelo framework para carregar a informação de layout dinâmico a partir do ficheiro de recurso.

BOOL LoadDynamicLayoutResource(LPCTSTR lpszResourceName);

Parâmetros

lpszResourceName
O nome do recurso que contém a informação de layout dinâmico desejada para esta janela.

Valor de retorno

Diferente de zero se a função for bem-sucedida. É 0 se ocorrer uma falha.

Observações

Não chame este método diretamente.

CWnd::LockWindowUpdate

Desativa o desenho na janela indicada.

BOOL LockWindowUpdate();

Valor de retorno

Diferente de zero se a função for bem-sucedida. É 0 se ocorrer uma falha ou se a LockWindowUpdate função tiver sido usada para bloquear outra janela.

Observações

Uma janela trancada não pode ser movida. Só uma janela pode ser trancada de cada vez. Para destrancar uma janela trancada com LockWindowUpdate, chame UnlockWindowUpdate.

Se uma aplicação com uma janela bloqueada (ou qualquer janela filha bloqueada) chamar a GetDCfunção , GetDCEx, ou BeginPaint Windows, a função chamada devolve um contexto de dispositivo cuja região visível está vazia. Isto ocorrerá até que a aplicação desbloqueie a janela ao chamar a UnlockWindowUpdate função membro.

Embora as atualizações de janelas estejam bloqueadas, o sistema mantém o registo do retângulo delimitador de quaisquer operações de desenho para contextos de dispositivo associadas a uma janela bloqueada. Quando o desenho é reativado, este retângulo delimitado é invalidado na janela bloqueada e nas suas janelas filhas para forçar uma mensagem eventual WM_PAINT para atualizar o ecrã. Se não ocorrer nenhum desenho enquanto as atualizações das janelas estavam bloqueadas, nenhuma área é invalidada.

A LockWindowUpdate função membro não torna a janela dada invisível nem limpa o WS_VISIBLE bit de estilo.

CWnd::m_hWnd

A maçaneta da janela das janelas ligada a este CWnd.

HWND m_hWnd;

Observações

O m_hWnd membro de dados é uma variável pública do tipo HWND.

CWnd::MapWindowPoints

Converte (mapeia) um conjunto de pontos do espaço de coordenadas do para CWnd o espaço de coordenadas de outra janela.

void MapWindowPoints(
    CWnd* pwndTo,
    LPRECT lpRect) const;

void MapWindowPoints(
    CWnd* pwndTo,
    LPPOINT lpPoint,
    UINT nCount) const;

Parâmetros

pwndTo
Identifica a janela para a qual os pontos são convertidos. Se este parâmetro for NULL, os pontos são convertidos em coordenadas de ecrã.

lpRect
Especifica o retângulo cujos pontos devem ser convertidos. A primeira versão desta função está disponível apenas para Windows 3.1 e versões posteriores.

lpPoint
Um ponteiro para um array de POINT estruturas que contêm o conjunto de pontos a converter.

nCount
Especifica o número de POINT estruturas no array apontado por lpPoint.

CWnd::MessageBox

Cria e apresenta uma janela que contém uma mensagem e legenda fornecidas pela aplicação, além de uma combinação dos ícones e botões pré-definidos descritos na lista Message-Box Estilos .

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

Parâmetros

lpszText
Aponta para um CString objeto ou cadeia terminada por null que contém a mensagem a ser exibida.

lpszCaption
Aponta para um CString objeto ou cadeia terminada por null a ser usada na legenda da caixa de mensagem. Se lpszCaption for NULL, é usada a legenda padrão "Erro".

nType
Especifica o conteúdo e o comportamento da caixa de mensagem.

Valor de retorno

Este método utiliza a MessageBox função conforme definida no SDK do Windows. Este método devolve o resultado de chamar esta função.

Observações

Use a função AfxMessageBox global em vez desta função membro para implementar uma caixa de mensagens na sua aplicação.

Segue-se os vários ícones do sistema que podem ser usados numa caixa de mensagem:

Ícone	Macro
	MB_ICONHAND, MB_ICONSTOPe MB_ICONERROR
	MB_ICONQUESTION
	MB_ICONEXCLAMATION e MB_ICONWARNING
	MB_ICONASTERISK e MB_ICONINFORMATION

Example

void CMainFrame::OnDisplayErrorMessage()
{
   // This displays a message box with the title "Error"
   // and the message "Help, Something went wrong."
   // The error icon is displayed in the message box, along with
   // an OK button.
   MessageBox(_T("Help, Something went wrong."), _T("Error"),
              MB_ICONERROR | MB_OK);
}

CWnd::ModifyStyle

Chame esta função membro para modificar o estilo de uma janela.

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

Parâmetros

dwRemove
Especifica estilos de janelas a serem removidos durante a modificação de estilo.

dwAdd
Especifica estilos de janelas a serem adicionados durante a modificação de estilo.

nFlags
As bandeiras devem ser passadas para SetWindowPos, ou zero se SetWindowPos não devem ser chamadas. O padrão é zero. Consulte a secção de Observações para uma lista de bandeiras pré-definidas.

Valor de retorno

Não nulo se o estilo foi modificado com sucesso; caso contrário, 0.

Observações

Os estilos a serem adicionados ou removidos podem ser combinados usando o operador bit a bit OR (|). Consulte os tópicos Estilos de Janelas e CreateWindow 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 SetWindowPos da API do Windows e redesenha a janela combinando nFlags com as seguintes quatro bandeiras predefinidas:

• 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, veja ModifyStyleEx.

Example

// This example adds the WS_CLIPCHILDREN style to the window.
// No Styles are removed from the window.
void CMyView::OnInitialUpdate()
{
   CView::OnInitialUpdate();
   ModifyStyle(0, WS_CLIPCHILDREN);
}

CWnd::ModifyStyleEx

Chame esta função membro para modificar o estilo estendido de uma janela.

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

Parâmetros

dwRemove
Especifica estilos estendidos a serem removidos durante a modificação de estilo.

dwAdd
Especifica estilos estendidos a serem adicionados durante a modificação de estilo.

nFlags
As bandeiras devem ser passadas para SetWindowPos, ou zero se SetWindowPos não devem ser chamadas. O padrão é zero. Consulte a secção de Observações para uma lista de bandeiras pré-definidas.

Valor de retorno

Não nulo se o estilo foi modificado com sucesso; caso contrário, 0.

Observações

Estilos a adicionar ou remover podem ser combinados usando o operador bit a bit OR (|). Consulte os tópicos Estilos de Janelas Estendidas neste livro e CreateWindowEx no SDK do Windows para informações sobre os estilos estendidos disponíveis

Se nFlags for diferente de zero, ModifyStyleEx chama a função SetWindowPos da API do Windows e redesenha a janela combinando nFlags com as seguintes quatro bandeiras predefinidas:

• 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, veja ModifyStyle.

Example

// This example would make the dialog box transparent by
// changing the dialog window's extended styles.
int CAboutDlg::OnCreate(LPCREATESTRUCT lpCreateStruct)
{
   if (CDialog::OnCreate(lpCreateStruct) == -1)
      return -1;

   ModifyStyleEx(0, WS_EX_TRANSPARENT);   
   
   return 0;
}

CWnd::MoveWindow

Muda a posição e as dimensões.

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

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

Parâmetros

x
Especifica a nova posição do lado esquerdo do CWnd.

y
Especifica a nova posição do topo do CWnd.

nWidth
Especifica a nova largura do CWnd.

nHeight
Especifica a nova altura do CWnd.

bRepaint
Especifica se CWnd deve ser repintado. Se TRUE, CWnd recebe uma WM_PAINT mensagem no seu OnPaint manipulador de mensagens como de costume. Se este parâmetro for FALSE, não ocorre qualquer tipo de repintura. Isto aplica-se à área do cliente, à área não-cliente (incluindo o título e as barras de scroll), e a qualquer parte da janela principal descoberta como resultado do CWnd's move. Quando este parâmetro é FALSE, a aplicação deve invalidar ou redesenhar explicitamente quaisquer partes de CWnd uma janela pai que devam ser redesenhadas.

lpRect
O CRect objeto ou RECT estrutura que especifica o novo tamanho e posição.

Observações

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

A MoveWindow função envia a WM_GETMINMAXINFO mensagem. Lidar com esta mensagem dá CWnd a oportunidade de modificar os valores predefinidos para as janelas maiores e menores possíveis. Se os parâmetros da MoveWindow função membro excederem estes valores, os valores podem ser substituídos pelos valores mínimos ou máximos no WM_GETMINMAXINFO handler.

Example

Veja o exemplo para CWnd::ClientToScreen.

CWnd::NotifyWinEvent

Sinaliza ao sistema que ocorreu um evento pré-definido. Se alguma aplicação cliente tiver registado uma função hook para o evento, o sistema chama a função hook do cliente.

void NotifyWinEvent(
    DWORD event,
    LONG idObjectType,
    LONG idObject);

Parâmetros

event
Especifica o evento que ocorreu. Este valor deve ser uma das constantes do evento.

idObjectType
Identifica o tipo de objeto que gerou o evento. Este valor é um dos identificadores de objeto pré-definidos ou um valor personalizado de ID de objeto.

idObject
Identifica se o evento foi gerado por um objeto ou por um elemento filho do objeto. Se este valor for CHILDID_SELF, o evento foi gerado pelo próprio objeto. Se não, este valor é o ID filho do elemento que gerou o evento.

Observações

Esta função de membro emula a funcionalidade da função NotifyWinEvent, conforme descrito no SDK do Windows.

CWnd::OnActivate

A estrutura chama a este elemento função quando um CWnd objeto está a ser ativado ou desativado.

afx_msg void OnActivate(
    UINT nState,
    CWnd* pWndOther,
    BOOL bMinimized);

Parâmetros

nState
Especifica se o CWnd está sendo ativado ou desativado. Pode ser um dos seguintes valores:

• WA_INACTIVE A janela está a ser desativada.

• WA_ACTIVE A janela é ativada por algum método que não seja um clique do rato (por exemplo, usando a interface do teclado para selecionar a janela).

• WA_CLICKACTIVE A janela é ativada por um clique do rato.

pWndOther
Ponteiro para o CWnd que está sendo ativado ou desativado. O ponteiro pode ser NULL, e pode ser temporário.

bMinimized
Especifica o estado minimizado do CWnd que está sendo ativado ou desativado. Um valor de TRUE indica que a janela é minimizada.

Se TRUE, o CWnd estiver a ser ativado; caso contrário, desativado.

Observações

Se o CWnd objeto for ativado com um clique do rato, também receberá uma OnMouseActivate chamada de função membro.

CWnd::OnActivateApp

A estrutura chama esta função membro a todas as janelas de topo da tarefa a ativar e a todas as janelas de topo da tarefa a ser desativadas.

afx_msg void OnActivateApp(
    BOOL bActive,
    DWORD dwThreadID);

Parâmetros

bActive
Especifica se o CWnd está sendo ativado ou desativado. TRUE significa que está CWnd a ser ativado. FALSE significa que está CWnd a ser desativado.

dwThreadID
Especifica o valor do ID da thread. Se bActive for TRUE, dwThreadID identifica a thread que detém o CWnd ser desativado. Se bActive for FALSE, dwThreadID identifica o thread que detém o CWnd ser ativado.

Observações

CWnd::OnAmbientProperty

O framework chama esta função membro para obter valores de propriedades ambientais a partir de uma janela que contém controlos OLE.

virtual BOOL OnAmbientProperty(
    COleControlSite* pSite,
    DISPID dispid,
    VARIANT* pvar);

Parâmetros

pSite
Aponta para o local do controlo que solicitou a propriedade ambiente.

dispid
O ID de despacho da propriedade ambiente solicitada.

pvar
Apontar para uma estrutura atribuída VARIANT pelo chamador, através da qual o valor da propriedade ambiente será devolvido.

Valor de retorno

TRUE se a propriedade ambiente for suportada; FALSE se não.

Observações

Substitua esta função para alterar os valores de propriedades ambientais predefinidos devolvidos por um contentor de controlo OLE para os seus controlos. Quaisquer pedidos de propriedade ambiente que não sejam tratados por uma função sobreposta devem ser encaminhados para a implementação da classe base.

CWnd::OnAppCommand

O framework chama esta função membro quando o utilizador gera um evento de comando de aplicação. Tal evento ocorre quando o utilizador clica num botão de comando de aplicação ou digita uma tecla de comando de aplicação.

afx_msg void OnAppCommand(
    CWnd* pWnd,
    UINT nCmd,
    UINT nDevice,
    UINT nKey);

Parâmetros

pWnd
[dentro] Apontador para um CWnd objeto que representa a janela onde o utilizador clicou no botão de comando ou pressionou a tecla de comando. Esta janela pode ser uma janela filha da janela que recebe a mensagem.

nCmd
[dentro] Indica o comando de aplicação. Para uma lista de valores possíveis, veja os comandos sob a cmd secção do lParam parâmetro de WM_APPCOMMAND.

nDevice
[dentro] O dispositivo de entrada que gerou o evento de entrada. Para uma lista de valores possíveis, veja os dispositivos sob a uDevice secção do lParam parâmetro de WM_APPCOMMAND.

nKey
[dentro] Indica quaisquer teclas virtuais que estejam para baixo, como a tecla CTRL ou o botão esquerdo do rato. Para uma lista de valores possíveis, veja as chaves sob a dwKeys secção do lParam parâmetro de WM_APPCOMMAND. Para mais informações, consulte o subtítulo "Parâmetros da Mensagem" em Sobre a Entrada do Rato.

Observações

Este método recebe a WM_APPCOMMAND notificação, que é descrita no SDK do Windows.

CWnd::OnAskCbFormatName

A estrutura chama esta função membro quando a Área de Transferência contém um handler de dados para o CF_OWNERDISPLAY formato (ou seja, quando o proprietário da Área de Transferência irá mostrar o conteúdo da Área de Transferências).

afx_msg void OnAskCbFormatName(
    UINT nMaxCount,
    LPTSTR lpszString);

Parâmetros

nMaxCount
Especifica o número máximo de bytes a copiar.

lpszString
Aponta para o buffer onde a cópia do nome do formato deve ser armazenada.

Observações

O proprietário da Clipboard deve fornecer um nome para o seu formato.

Sobrescrita esta função membro e copia o nome do CF_OWNERDISPLAY formato para o buffer especificado, sem exceder o número máximo de bytes especificado.

CWnd::OnCancelMode

A estrutura chama esta função membro para informar CWnd para cancelar qualquer modo interno.

afx_msg void OnCancelMode();

Observações

Se o CWnd objeto tiver o foco, a sua OnCancelMode função membro é chamada quando uma caixa de diálogo ou caixa de mensagem é exibida. Isto dá a CWnd oportunidade de cancelar modos como a captura do rato.

A implementação padrão responde chamando a ReleaseCapture função Windows. Substitui esta função membro na tua classe derivada para lidar com outros modos.

CWnd::OnCaptureChanged

O framework chama esta função membro para notificar a janela que está a perder a captura do rato.

afx_msg void OnCaptureChanged(CWnd* pWnd);

Parâmetros

pWnd
Um apontador para a janela para capturar com o rato

Observações

Uma janela recebe esta mensagem mesmo que se chame ReleaseCapture a si própria. Uma aplicação não deve tentar definir a captura do rato em resposta a esta mensagem. Quando recebe esta mensagem, uma janela deve redesenhar-se, se necessário, para refletir o novo estado de captura do rato.

Consulte o SDK do Windows para informações sobre a ReleaseCapture função do Windows.

CWnd::OnChangeCbChain

A estrutura chama esta função membro para cada janela na cadeia Clipboard-viewer para a notificar de que uma janela está a ser removida da cadeia.

afx_msg void OnChangeCbChain(
    HWND hWndRemove,
    HWND hWndAfter);

Parâmetros

hWndRemove
Especifica a manivela da janela que está a ser removida da cadeia Clipboard-viewer.

hWndAfter
Especifica o handler da janela que segue a janela ser removido da cadeia Clipboard-viewer.

Observações

Cada CWnd objeto que recebe uma OnChangeCbChain chamada deve usar a SendMessage função Windows para enviar a WM_CHANGECBCHAIN mensagem para a próxima janela na cadeia Clipboard-viewer (o handle devolvido por SetClipboardViewer). Se hWndRemove for a próxima janela na cadeia, a janela especificada por hWndAfter torna-se a janela seguinte, e as mensagens da Área de Transferência são passadas para ela.

CWnd::OnChangeUIState

É chamado quando o estado da interface de utilizador (UI) deve ser alterado.

afx_msg void OnChangeUIState(
    UINT nAction,
    UINT nUIElement);

Parâmetros

nAction
Especifica a ação a tomar. Pode ser um dos seguintes valores:

• UIS_CLEAR O elemento de estado da interface (especificado por nUIElement) deve estar oculto.

• UIS_INITIALIZE O elemento de estado da interface (especificado por nUIElement) deve ser alterado com base no último evento de entrada. Para mais informações, consulte a secção de Observações de WM_CHANGEUISTATE.

• UIS_SET O elemento de estado da interface (especificado por nUIElement) deve ser visível.

nUIElement
Especifica quais os elementos do estado da interface que são afetados ou o estilo do controlo. Pode ser um dos seguintes valores:

• UISF_HIDEACCEL Aceleradores de teclado.

• UISF_HIDEFOCUS Indicadores de foco.

• UISF_ACTIVE Windows XP: Um controlo deve ser desenhado no estilo usado para controlos ativos.

Observações

Esta função membro emula a funcionalidade da WM_CHANGEUISTATE mensagem, conforme descrito no SDK do Windows.

CWnd::OnChar

O framework chama a este elemento função quando uma tecla se traduz para um carácter não de sistema.

afx_msg void OnChar(
    UINT nChar,
    UINT nRepCnt,
    UINT nFlags);

Parâmetros

nChar
Contém o valor do código do carácter da chave.

nRepCnt
Contém a contagem de repetições, o número de vezes que a tecla é repetida quando o utilizador mantém a tecla pressionada.

nFlags
Contém o código de varrimento, código de transição de chave, estado anterior da chave e código de contexto, conforme mostrado na lista seguinte:

Observações

Esta função é chamada antes da OnKeyUp função membro e depois de a OnKeyDown função membro ser chamada. OnChar contém o valor da tecla do teclado pressionada ou libertada.

Como não existe necessariamente uma correspondência um-para-um entre as teclas pressionadas e OnChar as chamadas geradas, a informação presente nFlags geralmente não é útil para as aplicações. A informação em nFlags aplica-se apenas à chamada mais recente para a OnKeyUp função membro ou à OnKeyDown função membro que precede a chamada para OnChar.

Para teclados IBM Enhanced de 101 e 102 teclas, as teclas melhoradas são o ALT direito e as teclas CTRL direitas na secção principal do teclado; o INS, DEL, HOME, END, PAGE UP, PAGE DOWN, e as setas nos clusters à esquerda do teclado numérico; e as teclas de barra (/) e ENTER no teclado numérico. Alguns outros teclados podem suportar o bit de tecla estendida em nFlags.

CWnd::OnCharToItem

Chamada quando uma caixa de lista com o LBS_WANTKEYBOARDINPUT estilo envia uma WM_CHARTOITEM mensagem ao seu proprietário em resposta a uma WM_CHAR mensagem.

afx_msg int OnCharToItem(
    UINT nChar,
    CListBox* pListBox,
    UINT nIndex);

Parâmetros

nChar
Especifica o valor da tecla pressionada pelo utilizador.

pListBox
Especifica um ponteiro para a caixa da lista. Pode ser temporário.

nIndex
Especifica a posição atual do caret.

Valor de retorno

O framework chama esta função membro para especificar a ação que a aplicação realizou em resposta à chamada. Um valor de retorno de -2 indica que a aplicação tratou de todos os aspetos da seleção do item e não quer que a caixa da lista faça mais ação. Um valor de retorno de -1 indica que a caixa de lista deve executar a ação padrão em resposta ao pressionamento da tecla. Um valor de retorno de 0 ou superior especifica o índice em base zero de um item na caixa de lista e indica que a caixa de lista deve executar a ação padrão para a tecla pressionada no item dado.

Observações

CWnd::OnChildActivate

Se o CWnd objeto for uma janela filha de múltiplos documentos (MDI), OnChildActivate é chamada pelo framework quando o utilizador clica na barra de título da janela ou quando a janela é ativada, movida ou dimensionada.

afx_msg void OnChildActivate();

CWnd::OnChildNotify

Esta função membro é chamada pela janela principal desta janela quando recebe uma mensagem de notificação que se aplica a essa janela.

virtual BOOL OnChildNotify(
    UINT message,
    WPARAM wParam,
    LPARAM lParam,
    LRESULT* pResult);

Parâmetros

message
Um número de mensagem do Windows enviado para uma janela principal.

wParam
O wparam associado à mensagem.

lParam
O lparam associado à mensagem.

pLResult
Um apontador para um valor a ser devolvido do procedimento da janela do pai. Este apontador será NULL se não for esperado valor de retorno.

Valor de retorno

Não nula se esta janela for responsável por tratar a mensagem enviada ao seu pai; caso contrário, 0.

Observações

Nunca chame esta função de membro diretamente.

A implementação padrão desta função membro devolve 0, o que significa que o pai deve tratar da mensagem.

Substitua esta função membro para prolongar a forma como um controlo responde a mensagens de notificação.

CWnd::OnClipboardUpdate

A estrutura chama a este elemento função quando o conteúdo da prancheta mudou.

afx_msg void OnClipboardUpdate();

CWnd::OnClose

O framework chama a esta função membro um sinal de que a CWnd ou uma aplicação deve terminar.

afx_msg void OnClose();

Observações

A implementação padrão chama DestroyWindow.

CWnd::OnColorizationColorChanged

A estrutura chama este membro quando a política de renderização para a área não cliente mudou.

afx_msg void OnColorizationColorChanged(
    DWORD dwColorizationColor,
    BOOL bOpacity);

Parâmetros

dwColorizationColor
[dentro] Especifica a nova cor de colorização. O formato de cor é um número hexadecimal da forma 0xAARRGGBB, onde cada um dos quatro componentes varia de 0x00 a 0xFF. O componente AA é o valor alfa, RR é a cor vermelha, GG é verde e BB é azul.

bOpacity
[dentro] TRUE se a nova cor for misturada com opacidade; FALSE Se não for.

Observações

Este método recebe a WM_DWMNCRENDERINGCHANGED mensagem de notificação, que é descrita no SDK do Windows.

CWnd::OnCommand

O framework chama esta função membro quando o utilizador seleciona um item de um menu, quando um controlo filho envia uma mensagem de notificação, ou quando uma tecla aceleradora é traduzida.

virtual BOOL OnCommand(
    WPARAM wParam,
    LPARAM lParam);

Parâmetros

wParam
A palavra de ordem baixa identifica wParam o ID do comando do item do menu, controlo ou acelerador. A palavra de ordem superior de wParam especifica a mensagem de notificação se a mensagem for de um controlo. Se a mensagem for de um acelerador, a palavra de ordem superior é 1. Se a mensagem for de um menu, a palavra de ordem superior é 0.

lParam
Identifica o controlo que envia a mensagem se a mensagem for de um controlo. Caso contrário, lParam é 0.

Valor de retorno

Uma aplicação devolve uma resposta diferente de zero se processar esta mensagem; caso contrário, 0.

Observações

OnCommand processa o mapa de mensagens para notificações de controlo e ON_COMMAND entradas, e chama a função membro apropriada.

Substitua esta função membro na sua classe derivada para tratar da WM_COMMAND mensagem. Um override não processará o mapa da mensagem a menos que a classe OnCommand base seja chamada.

CWnd::OnCompacting

A estrutura chama a esta função membro para todas as janelas de topo quando o Windows deteta que mais de 12,5 por cento do tempo do sistema, num intervalo de 30 a 60 segundos, está a ser gasto a compactar a memória.

afx_msg void OnCompacting(UINT nCpuTime);

Parâmetros

nCpuTime
Especifica a razão entre o tempo de CPU atualmente gasto pelo Windows a compactar memória e o tempo de CPU gasto a realizar outras operações. Por exemplo, 8000h representa 50 por cento do tempo de CPU gasto a compactar memória.

Observações

Isto indica que a memória do sistema é baixa.

Quando um CWnd objeto recebe esta chamada, deve libertar o máximo de memória possível, tendo em conta o nível atual de atividade da aplicação e o número total de aplicações a correr no Windows. A aplicação pode chamar a função Windows para determinar quantas aplicações estão a correr.

CWnd::OnCompareItem

O framework chama esta função membro para especificar a posição relativa de um novo item numa combinação de sorteio proprietário ordenada ou numa caixa de lista.

afx_msg int OnCompareItem(
    int nIDCtl,
    LPCOMPAREITEMSTRUCT lpCompareItemStruct);

Parâmetros

nIDCtl
O identificador do controlo que enviou a WM_COMPAREITEM mensagem.

lpCompareItemStruct
Contém um ponteiro longo para uma COMPAREITEMSTRUCT estrutura de dados que contém os identificadores e dados fornecidos pela aplicação para dois itens na caixa combinada ou lista.

Valor de retorno

Indica a posição relativa dos dois itens. Pode ser qualquer um dos seguintes valores:

Observações

Se for criado um combo ou caixa de lista com o CBS_SORT estilo ou, LBS_SORT o Windows envia uma WM_COMPAREITEM mensagem ao proprietário da caixa de combo ou da caixa de lista sempre que a aplicação adiciona um novo item.

Dois itens na caixa de combo ou lista são reformados numa COMPAREITEMSTRUCT estrutura apontada por lpCompareItemStruct. OnCompareItem deve devolver um valor que indique quais dos itens devem aparecer antes do outro. Normalmente, o Windows faz esta chamada várias vezes até determinar a posição exata do novo item.

Se o hwndItem elemento da COMPAREITEMSTRUCT estrutura pertencer a um CListBox objeto ou CComboBox , então a CompareItem função virtual da classe apropriada é chamada. Substitui CComboBox::CompareItem ou CListBox::CompareItem entra no teu derivado CListBox ou CComboBox classe para fazer a comparação de itens.

CWnd::OnCompositionChanged

O framework chama esta função membro para todas as janelas de topo quando a composição do Gestor de Janelas do Ambiente de Trabalho (DWM) está ativada ou desativada.

afx_msg void OnCompositionChanged();

Observações

Este método recebe a WM_DWMCOMPOSITIONCHANGED notificação, que é descrita no SDK do Windows.

CWnd::OnContextMenu

É chamada pela framework quando o utilizador clicou no botão direito do rato (clicou com o botão direito) na janela.

afx_msg void OnContextMenu(
    CWnd* pWnd,
    CPoint pos);

Parâmetros

pWnd
Handle para a janela onde o utilizador clicou com o botão direito do rato. Esta pode ser uma janela filha da janela que recebe a mensagem. Para mais informações sobre o processamento desta mensagem, consulte a secção Observações.

pos
Posição do cursor, em coordenadas do ecrã, no momento do clique do rato.

Observações

Pode processar esta mensagem exibindo um menu de contexto usando o TrackPopupMenuarquivo .

Se não mostrar um menu contextual, deve passar esta mensagem para a DefWindowProc função. Se a sua janela for uma janela filha, DefWindowProc envia a mensagem para o pai. Caso contrário, DefWindowProc apresenta um menu contextual predefinido se a posição especificada estiver na legenda da janela.

CWnd::OnCopyData

Esta função membro é chamada pelo framework para copiar dados de uma aplicação para outra.

afx_msg BOOL OnCopyData(
    CWnd* pWnd,
    COPYDATASTRUCT* pCopyDataStruct);

Parâmetros

pWnd
Um apontador para um CWnd objeto que está a enviar os dados.

pCopyDataStruct
Um apontador para uma COPYDATASTRUCT estrutura que contém os dados enviados.

Valor de retorno

Retorna TRUE se a aplicação recetora aceitar com sucesso os dados. Caso contrário, retorna FALSE.

Observações

Os dados passados não devem conter ponteiros ou outras referências a objetos não acessíveis à aplicação que recebe os dados.

Enquanto os dados estão a ser copiados, não podem ser alterados por outro fio do processo de envio.

A aplicação recetora deve considerar os dados apenas de leitura. A estrutura apontada pelo parâmetro pCopyDataStruct é válida apenas durante a transferência de dados; no entanto, a aplicação recetora não deve libertar a memória associada à estrutura.

Se a aplicação recetora precisar de acesso aos dados após o retorno desta função, deve copiar os dados recebidos para um buffer local.

CWnd::OnCreate

O framework chama esta função membro quando uma aplicação solicita que a janela do Windows seja criada chamando a Create função ou CreateEx membro.

afx_msg int OnCreate(LPCREATESTRUCT lpCreateStruct);

Parâmetros

lpCreateStruct
Aponta para uma CREATESTRUCT estrutura que contém informação sobre o CWnd objeto a ser criado.

Valor de retorno

OnCreate deve devolver 0 para continuar a criação do CWnd objeto. Se a candidatura devolver -1, a janela será destruída.

Observações

O CWnd objeto recebe esta chamada depois de a janela ser criada, mas antes de se tornar visível. OnCreate é chamada antes do retorno da Create função membro ou CreateEx .

Sobrescrita esta função membro para realizar qualquer inicialização necessária de uma classe derivada.

A CREATESTRUCT estrutura contém cópias dos parâmetros usados para criar a janela.

CWnd::OnCtlColor

A estrutura chama a este elemento função quando um controlo filho está prestes a ser desenhado.

afx_msg HBRUSH OnCtlColor(
    CDC* pDC,
    CWnd* pWnd,
    UINT nCtlColor);

Parâmetros

pDC
Contém um ponteiro para o contexto de exibição da janela filho. Pode ser temporário.

pWnd
Contém um ponteiro para o controlo a pedir a cor. Pode ser temporário.