Função CreateDialogIndirectParamW (winuser.h)

Cria uma caixa de diálogo modeless a partir de um modelo de caixa de diálogo na memória. Antes de exibir a caixa de diálogo, a função passa um valor definido pelo aplicativo para o procedimento da caixa de diálogo como o parâmetro lParam da mensagem WM_INITDIALOG. Um aplicativo pode usar esse valor para inicializar controles de caixa de diálogo.

Sintaxe

HWND CreateDialogIndirectParamW(
  [in, optional] HINSTANCE       hInstance,
  [in]           LPCDLGTEMPLATEW lpTemplate,
  [in, optional] HWND            hWndParent,
  [in, optional] DLGPROC         lpDialogFunc,
  [in]           LPARAM          dwInitParam
);

Parâmetros

[in, optional] hInstance

Tipo: HINSTANCE

Um identificador para o módulo que contém o modelo da caixa de diálogo. Se esse parâmetro for NULL, o executável atual será usado.

[in] lpTemplate

Tipo: LPCDLGTEMPLATE

O modelo CreateDialogIndirectParam usa para criar a caixa de diálogo. Um modelo de caixa de diálogo consiste em um cabeçalho que descreve a caixa de diálogo, seguido por um ou mais blocos adicionais de dados que descrevem cada um dos controles na caixa de diálogo. O modelo pode usar o formato padrão ou o formato estendido.

Em um modelo padrão, o cabeçalho é uma estrutura de DLGTEMPLATE seguida por matrizes de comprimento variável adicionais. Os dados de cada controle consistem em uma estrutura de DLGITEMTEMPLATE seguida por matrizes de comprimento variável adicionais.

Em um modelo de caixa de diálogo estendida, o cabeçalho usa o formato de DLGTEMPLATEEX e as definições de controle usam o formato DLGITEMTEMPLATEEX .

Depois que CreateDialogIndirectParam retornar, você poderá liberar o modelo, que só é usado para iniciar a caixa de diálogo.

[in, optional] hWndParent

Tipo: HWND

Um identificador para a janela que possui a caixa de diálogo.

[in, optional] lpDialogFunc

Tipo: DLGPROC

Um ponteiro para o procedimento da caixa de diálogo. Para obter mais informações sobre o procedimento da caixa de diálogo, consulte DialogProc.

[in] dwInitParam

Tipo: LPARAM

O valor a ser passado para a caixa de diálogo no parâmetro lParam da mensagem WM_INITDIALOG.

Valor de retorno

Tipo: HWND

Se a função for bem-sucedida, o valor retornado será o identificador de janela para a caixa de diálogo.

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

Observações

A função CreateDialogIndirectParam usa a função CreateWindowEx para criar a caixa de diálogo. CreateDialogIndirectParam envia uma mensagem WM_INITDIALOG para o procedimento da caixa de diálogo. Se o modelo especificar o estilo DS_SETFONT ou DS_SHELLFONT, a função também enviará uma mensagem de WM_SETFONT para o procedimento da caixa de diálogo. A função exibirá a caixa de diálogo se o modelo especificar o estilo WS_VISIBLE. Por fim, CreateDialogIndirectParam retorna o identificador de janela para a caixa de diálogo.

Depois que CreateDialogIndirectParam retorna, você pode usar a função ShowWindow para exibir a caixa de diálogo (se ela ainda não estiver visível). Para destruir a caixa de diálogo, use a função DestroyWindow. Para dar suporte à navegação do teclado e a outra funcionalidade de caixa de diálogo, o loop de mensagem da caixa de diálogo deve chamar a função IsDialogMessage.

Em um modelo de caixa de diálogo padrão, a estrutura de DLGTEMPLATE e cada uma das estruturas de DLGITEMTEMPLATE devem ser alinhadas em limites de DWORD. A matriz de dados de criação que segue uma estrutura de DLGITEMTEMPLATE também deve ser alinhada em um limite DWORD. Todas as outras matrizes de comprimento variável no modelo devem ser alinhadas em limites WORD.

Em um modelo de caixa de diálogo estendida, o cabeçalho DLGTEMPLATEEX e cada uma das definições de controle de DLGITEMTEMPLATEEX devem ser alinhadas em limites de DWORD . A matriz de dados de criação, se houver, que segue uma estrutura de DLGITEMTEMPLATEEX também deve ser alinhada em um limite DWORD. Todas as outras matrizes de comprimento variável no modelo devem ser alinhadas em limites WORD.

Todas as cadeias de caracteres no modelo da caixa de diálogo, como títulos para a caixa de diálogo e botões, devem ser cadeias de caracteres Unicode.

Nota

O cabeçalho winuser.h define CreateDialogIndirectParam como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	winuser.h (inclua Windows.h)
biblioteca	User32.lib
de DLL	User32.dll
conjunto de API	ext-ms-win-ntuser-dialogbox-l1-1-0 (introduzido no Windows 8)