AtlAxDialogBox
Cria uma caixa de diálogo modal de um modelo da caixa de diálogo fornecido pelo usuário.
Importante
Essa função não pode ser usada em aplicativos executados em Tempo de Execução do Windows.
ATLAPI_(int) AtlAxDialogBox(
HINSTANCE hInstance,
LPCWSTR lpTemplateName,
HWND hWndParent,
DLGPROC lpDialogProc,
LPARAM dwInitParam
);
Parâmetros
hInstance
[in] identifica uma instância de módulo cujo arquivo executável contém o modelo da caixa de diálogo.lpTemplateName
[in] identifica o modelo da caixa de diálogo. Este parâmetro tanto o ponteiro para uma cadeia de caracteres NULL- finalizada que especifica o nome do modelo da caixa de diálogo ou um valor inteiro que especifica o identificador do recurso do modelo da caixa de diálogo. Se o parâmetro especifica um identificador do recurso, as palavras de alta-ordem devem ser zero e as palavras de ordem baixa devem conter o identificador. Você pode usar a macro de MAKEINTRESOURCE para criar esse valor.hWndParent
[in] identifica a janela que possui a caixa de diálogo.lpDialogProc
[in] aponta para o procedimento da caixa de diálogo. Para obter mais informações sobre o procedimento da caixa de diálogo, consulte DialogProc.dwInitParam
[in] especifica o valor para passar para a caixa de diálogo no parâmetro de lParam de mensagem de WM_INITDIALOG .
Valor de retorno
Um dos valores padrão do HRESULT.
Comentários
Para usar AtlAxDialogBox com um modelo da caixa de diálogo que contém um controle ActiveX, especifique CLSIDválido, a cadeia de caracteres de APPID ou URL como o campo de texto da seção de CONTROLE de recurso da caixa de diálogo, juntamente com “AtlAxWin80” como o campo de nome de classe na mesma seção. O exemplo a seguir demonstra o que uma seção válido de CONTROLE pode parecer como a seguir:
CONTROL "{04FE35E9-ADBC-4f1d-83FE-8FA4D1F71C7F}", IDC_TEST,
"AtlAxWin80", WS_GROUP | WS_TABSTOP, 0, 0, 100, 100
Para obter mais informações sobre scripts de recursos de edição, consulte Como abrir o arquivo de script do recurso no formato de texto. Para obter mais informações sobre as instruções de recurso definição de controle, consulte parâmetros de controle comum em Windows SDK*: SDK Tools*.
Para obter mais informações sobre caixas de diálogo geralmente, consulte DialogBox e CreateDialogParam em Windows SDK.
Requisitos
Cabeçalho: atlhost.h
Consulte também
Referência
Conceitos
Fundamentos do controle composto ATL