AtlAxDialogBox
Cria uma caixa de diálogo modal de um modelo da caixa de diálogo fornecido pelo usuário.
.gif "Observação importante") 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 um arquivo de Script de 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