CWnd::CreateEx

Artigo
06/10/2015

Cria a janela especificada e anexá-la ao objeto de CWnd .

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 (OPERADOR) de estilos estendidos da janela; se não NULL estendido para o estilo padrão da janela.
lpszClassName
Ponteiro para uma cadeia de caracteres NULL- finalizada que contém o nome de uma classe registrada da janela do sistema; ou o nome de uma classe de janela predefinida do sistema.
lpszWindowName
Ponteiro para uma cadeia de caracteres NULL- finalizada que contém o nome para exibição da janela; se não NULL para qualquer nome para exibição da janela.
dwStyle
Combinação bit a bit (OPERADOR) de estilos de janela; se não NULL para o estilo padrão da janela.
x
A distância horizontal inicial da janela do lado esquerdo da tela ou da janela pai.
y
A distância vertical inicial da janela na parte superior da tela ou da janela pai.
nWidth
A largura, em pixels, da janela.
nHeight
A altura, em pixels, da janela.
hwndParent
Para uma janela filho, o identificador para a janela pai; caso contrário, o identificador de janela proprietária se a janela tem um proprietário.
nIDorHMenu
Para uma janela filho, a identificação da janela; caso contrário, a identificação de um menu para a janela.
lpParam
Ponteiro para os dados do usuário que são passados ao método de CWnd::OnCreate no campo de lpCreateParams .
rect
O tamanho e local da janela em relação à tela ou janela pai.
pParentWnd
Para uma janela filho, ponteiro para a janela pai; caso contrário, ponteiro para a janela do proprietário se a janela tem um proprietário.
nID
Para uma janela filho, a identificação da janela; caso contrário, a identificação de um menu para a janela.

Valor de retorno

TRUE se o método tenha êxito; se não FALSE.

Comentários

Aviso

AgoraCWnd::PreCreateWindow atribui o membro de hMenu do seu parâmetro de CREATESTRUCT ao ponteiro de this se o menu é NULL e o estilo contém WS_CHILD.Para a funcionalidade adequada, certifique-se que o controle de caixa de diálogo tenha uma identificação que não é NULL.

Essa alteração corrigir uma falha cenários gerenciados/nativos de interoperabilidade.Uma declaração de TRACE em CWnd::Create alerta o desenvolvedor do problema.

O estilo padrão estendido da janela é WS_EX_LEFT. O estilo padrão da janela é WS_OVERLAPPED.

Use a função de AfxRegisterWndClass para registrar classes da janela. As classes definidas pelo usuário da janela estão disponíveis no módulo onde eles são registrados.

As dimensões de janelas filho são relativos ao canto superior esquerdo da área cliente da janela pai. As dimensões para janelas de nível superior são relativos ao canto superior esquerdo da tela.

O método de CWnd::OnCreate é chamado antes que o método de CreateEx retorna, e antes da janela ficará visível.

Exemplo

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