Partager via


AtlAxDialogBox

Crée une boîte de dialogue modale d'un modèle de boîte de dialogue fourni par l'utilisateur.

Important

Cette fonction ne peut pas être utilisée dans les applications qui s'exécutent dans Windows Runtime.

ATLAPI_(int) AtlAxDialogBox( 
HINSTANCE hInstance, 
LPCWSTR lpTemplateName, 
HWND hWndParent, 
DLGPROC lpDialogProc, 
LPARAM dwInitParam  
);

Paramètres

  • hInstance
    [in] Identifie une instance du module dont l'exécutable contient le modèle de boîte de dialogue.

  • lpTemplateName
    [in] identifie le modèle de boîte de dialogue. Ce paramètre est le pointeur vers une chaîne se terminant par null qui spécifie le nom du modèle de boîte de dialogue ou d'une valeur entière qui spécifie l'identificateur de ressource de boîte de dialogue. Si le paramètre spécifie un identificateur de ressource, son mot de poids fort doit être égal à zéro et son mot de poids faible doit contenir l'identificateur. Vous pouvez utiliser la macro de MAKEINTRESOURCE pour créer cette valeur.

  • hWndParent
    [in] Identifie la fenêtre propriétaire de la boîte de dialogue.

  • lpDialogProc
    [in] points à la procédure de boîte de dialogue. Pour plus d'informations sur la procédure de boîte de dialogue, consultez DialogProc.

  • dwInitParam
    [in] Spécifie la valeur à passer à la boîte de dialogue dans le paramètre de LPARAM du message de WM_INITDIALOG .

Valeur de retour

L'une des valeurs HRESULT standard.

Notes

Pour utiliser AtlAxDialogBox avec un modèle de boîte de dialogue qui contient un contrôle ActiveX, spécifiez CLSIDvalide, la chaîne d' APPID ou d'URL en tant que champ de texte de la section de CONTROL de la ressource de boîte de dialogue, avec « AtlAxWin80 » comme champ de nom de classe sous la même section. Ce qui suit montre à quoi ressemble une section valide de CONTROL peut :

CONTROL "{04FE35E9-ADBC-4f1d-83FE-8FA4D1F71C7F}", IDC_TEST,

"AtlAxWin80", WS_GROUP | WS_TABSTOP, 0, 0, 100, 100

Pour plus d'informations sur les scripts de ressources de modification, consultez l' Comment : ouvrir un fichier de script de ressources au format texte. Pour plus d'informations sur les instructions de contrôle de ressource définition, consultez Paramètres de contrôles communs sous Kit de développement logiciel Windows*: outils du Kit de développement logiciel*.

Pour plus d'informations sur les boîtes de dialogue pour en général à DialogBox et à CreateDialogParam dans Kit de développement logiciel Windows.

Configuration requise

Header: atlhost.h

Voir aussi

Référence

AtlAxCreateDialog

Concepts

Notions de base du contrôle composite

Autres ressources

Fonctions globales de contrôle composite