Função CreateWindowExW (winuser.h)

Cria uma janela filho, pop-up ou sobreposta com um estilo de janela estendida; caso contrário, essa função é idêntica à função CreateWindow. Para obter mais informações sobre como criar uma janela e para obter descrições completas dos outros parâmetros do CreateWindowEx, consulte CreateWindow.

Sintaxe

HWND CreateWindowExW(
  [in]           DWORD     dwExStyle,
  [in, optional] LPCWSTR   lpClassName,
  [in, optional] LPCWSTR   lpWindowName,
  [in]           DWORD     dwStyle,
  [in]           int       X,
  [in]           int       Y,
  [in]           int       nWidth,
  [in]           int       nHeight,
  [in, optional] HWND      hWndParent,
  [in, optional] HMENU     hMenu,
  [in, optional] HINSTANCE hInstance,
  [in, optional] LPVOID    lpParam
);

Parâmetros

[in] dwExStyle

Tipo: DWORD

O estilo de janela estendida da janela que está sendo criada. Para obter uma lista de valores possíveis, consulte Estilos de Janela Estendida.

[in, optional] lpClassName

Tipo: LPCTSTR

Um cadeia de caracteresterminada ou um átomo de classe.

Se um cadeia de caracteresterminada em nulo, ele especifica o nome da classe de janela. O nome da classe pode ser qualquer nome registrado com a função RegisterClass ou RegisterClassEx, desde que o módulo que registra a classe também seja o módulo que cria a janela. O nome da classe também pode ser qualquer um dos nomes predefinidos classe do sistema.

Se um atom de classe criado por uma chamada anterior para RegisterClass ou RegisterClassEx, ele deverá ser convertido usando a macro MAKEINTATOM. (O átomo deve estar na palavra de baixa ordem de lpClassName; a palavra de alta ordem deve ser zero.)

[in, optional] lpWindowName

Tipo: LPCTSTR

O nome da janela. Se o estilo da janela especificar uma barra de título, o título da janela apontado por lpWindowName será exibido na barra de título. Ao usar CreateWindow para criar controles, como botões, caixas de seleção e controles estáticos, use lpWindowName para especificar o texto do controle. Ao criar um controle estático com o estilo SS_ICON, use lpWindowName para especificar o nome ou o identificador do ícone. Para especificar um identificador, use a sintaxe "#num".

[in] dwStyle

Tipo: DWORD

O estilo da janela que está sendo criada. Esse parâmetro pode ser uma combinação dos valores de estilo da janela , além dos estilos de controle indicados na seção Comentários.

[in] X

Tipo: int

A posição horizontal inicial da janela. Para uma janela pop-up ou sobreposta, o parâmetro x é a coordenada x inicial do canto superior esquerdo da janela, em coordenadas de tela. Para uma janela filho, x é a coordenada x do canto superior esquerdo da janela em relação ao canto superior esquerdo da área do cliente da janela pai. Se x estiver definido como CW_USEDEFAULT, o sistema selecionará a posição padrão para o canto superior esquerdo da janela e ignorará o parâmetro y. CW_USEDEFAULT é válido apenas para janelas sobrepostas; se for especificado para uma janela pop-up ou filho, os parâmetros x e y serão definidos como zero.

[in] Y

Tipo: int

A posição vertical inicial da janela. Para uma janela sobreposta ou pop-up, o parâmetro y é a coordenada y inicial do canto superior esquerdo da janela, nas coordenadas da tela. Para uma janela filho, y é a coordenada y inicial do canto superior esquerdo da janela filho em relação ao canto superior esquerdo da área do cliente da janela pai. Para uma caixa de listagem y é a coordenada y inicial do canto superior esquerdo da área do cliente da caixa de listagem em relação ao canto superior esquerdo da área do cliente da janela pai.

Se uma janela sobreposta for criada com o conjunto de bits de estilo WS_VISIBLE e o parâmetro x for definido como CW_USEDEFAULT, o parâmetro y determinará como a janela é mostrada. Se o parâmetro y for CW_USEDEFAULT, o gerenciador de janelas chamará ShowWindow com o sinalizador SW_SHOW após a criação da janela. Se o parâmetro y for algum outro valor, o gerenciador de janelas chamará ShowWindow com esse valor como o parâmetro nCmdShow .

[in] nWidth

Tipo: int

A largura, em unidades de dispositivo, da janela. Para janelas sobrepostas, nWidth é a largura da janela, em coordenadas de tela ou CW_USEDEFAULT. Se nWidth for CW_USEDEFAULT, o sistema selecionará uma largura e altura padrão para a janela; a largura padrão se estende das coordenadas x iniciais até a borda direita da tela; a altura padrão se estende da coordenada y inicial até a parte superior da área do ícone. CW_USEDEFAULT é válido apenas para janelas sobrepostas; se CW_USEDEFAULT for especificado para uma janela pop-up ou filho, o nWidth e parâmetro nHeight serão definidos como zero.

[in] nHeight

Tipo: int

A altura, em unidades do dispositivo, da janela. Para janelas sobrepostas, nHeight é a altura da janela, nas coordenadas da tela. Se o parâmetro nWidth estiver definido como CW_USEDEFAULT, o sistema ignorará nHeight.

[in, optional] hWndParent

Tipo: HWND

Um identificador para a janela pai ou proprietário da janela que está sendo criada. Para criar uma janela filho ou uma janela de propriedade, forneça um identificador de janela válido. Esse parâmetro é opcional para janelas pop-up.

Para criar uma janela somente de mensagem, forneça HWND_MESSAGE ou um identificador para uma janela somente mensagem existente.

[in, optional] hMenu

Tipo: HMENU

Um identificador para um menu ou especifica um identificador de janela filho, dependendo do estilo da janela. Para uma janela sobreposta ou pop-up, hMenu identifica o menu a ser usado com a janela; ele poderá ser NULL se o menu de classe for usado. Para uma janela filho, hMenu especifica o identificador de janela filho, um valor inteiro usado por um controle de caixa de diálogo para notificar o pai sobre eventos. O aplicativo determina o identificador de janela filho; deve ser exclusivo para todas as janelas filho com a mesma janela pai.

[in, optional] hInstance

Tipo: HINSTANCE

Um identificador para a instância do módulo a ser associado à janela.

[in, optional] lpParam

Tipo: LPVOID

Ponteiro para um valor a ser passado para a janela por meio da estrutura CREATETRUCT (lpCreateParams membro) apontada pelo lParam param da mensagem WM_CREATE. Essa mensagem é enviada para a janela criada por essa função antes de retornar.

Se um aplicativo chamar CreateWindow para criar uma janela de cliente MDI, lpParam deverá apontar para uma estrutura CLIENTCREATESTRUCT . Se uma janela do cliente MDI chamar CreateWindow para criar uma janela filho do MDI, lpParam deverá apontar para uma estrutura de MDICREATESTRUCT . lpParam poderá ser NULL se nenhum dado adicional for necessário.

Valor de retorno

Tipo: HWND

Se a função for bem-sucedida, o valor retornado será um identificador para a nova janela.

Se a função falhar, o valor retornado será NULL. Para obter informações de erro estendidas, chame GetLastError.

Essa função normalmente falha por um dos seguintes motivos:

• um valor de parâmetro inválido
• a classe do sistema foi registrada por um módulo diferente
• O gancho de WH_CBT é instalado e retorna um código de falha
• se um dos controles no modelo de caixa de diálogo não estiver registrado ou o procedimento de janela falhar WM_CREATE ou WM_NCCREATE

Observações

A função CreateWindowEx envia WM_NCCREATE, WM_NCCALCSIZEe WM_CREATE mensagens para a janela que está sendo criada.

Se a janela criada for uma janela filho, sua posição padrão será na parte inferior da ordem Z. Se a janela criada for uma janela de nível superior, sua posição padrão estará na parte superior da ordem Z (mas abaixo de todas as janelas superiores, a menos que a janela criada seja a própria parte superior).

Para obter informações sobre como controlar se a Barra de Tarefas exibe um botão para a janela criada, consulte Gerenciando botões da barra de tarefas.

Para obter informações sobre como remover uma janela, consulte a função DestroyWindow.

As classes de controle predefinidas a seguir podem ser especificadas no parâmetro lpClassName. Observe os estilos de controle correspondentes que você pode usar no parâmetro dwStyle.

O valor WS_EX_NOACTIVATE para dwExStyle impede a ativação em primeiro plano pelo sistema. Para impedir a ativação da fila quando o usuário clicar na janela, você deve processar a mensagem WM_MOUSEACTIVATE adequadamente. Para colocar a janela em primeiro plano ou ativá-la programaticamente, use SetForegroundWindow ou SetActiveWindow. Retornar FALSE para WM_NCACTIVATE impede que a janela perca a ativação da fila. No entanto, o valor retornado é ignorado no momento da ativação.

Com WS_EX_COMPOSITED definido, todos os descendentes de uma janela recebem ordem de pintura de baixo para cima usando buffer duplo. A ordem de pintura de baixo para cima permite que uma janela decrescente tenha efeitos de translúcibilidade (alfa) e transparência (chave de cor), mas somente se a janela decrescente também tiver o WS_EX_TRANSPARENT conjunto de bits. O buffer duplo permite que a janela e seus descendentes sejam pintados sem cintilação.

Exemplo

O código de exemplo a seguir ilustra o uso de CreateWindowExA.

BOOL Create(
        PCWSTR lpWindowName,
        DWORD dwStyle,
        DWORD dwExStyle = 0,
        int x = CW_USEDEFAULT,
        int y = CW_USEDEFAULT,
        int nWidth = CW_USEDEFAULT,
        int nHeight = CW_USEDEFAULT,
        HWND hWndParent = 0,
        HMENU hMenu = 0
        )
    {
        WNDCLASS wc = {0};

        wc.lpfnWndProc   = DERIVED_TYPE::WindowProc;
        wc.hInstance     = GetModuleHandle(NULL);
        wc.lpszClassName = ClassName();

        RegisterClass(&wc);

        m_hwnd = CreateWindowEx(
            dwExStyle, ClassName(), lpWindowName, dwStyle, x, y,
            nWidth, nHeight, hWndParent, hMenu, GetModuleHandle(NULL), this
            );

        return (m_hwnd ? TRUE : FALSE);
    }

Requisitos

Consulte também

sobre a interface de vários documentos

CLIENTCREATESTRUCT

CREATESTRUCT

Conceitual

CreateWindow

DestroyWindow

EnableWindow

outros recursos

de referência de

RegisterClass

RegisterClassEx

SetActiveWindow

SetForegroundWindow

SetWindowLong

SetWindowPos

ShowWindow

WM_CREATE

WM_NCCALCSIZE

WM_NCCREATE

WM_PAINT

WM_PARENTNOTIFY

Windows