CSimpleDialog, classe
Cette classe implémente une boîte de dialogue modale de base.
Syntaxe
template <WORD t_wDlgTemplateID, BOOL t_bCenter = TRUE>
class CSimpleDialog : public CDialogImplBase
Paramètres
t_wDlgTemplateID
ID de ressource de la ressource de modèle de boîte de dialogue.
t_bCenter
TRUE si l’objet de boîte de dialogue doit être centré sur la fenêtre propriétaire ; sinon FALSE.
Membres
Méthodes publiques
| Nom | Description |
|---|---|
| CSimpleDialog ::D oModal | Crée une boîte de dialogue modale. |
Notes
Implémente une boîte de dialogue modale avec des fonctionnalités de base. CSimpleDialog assure la prise en charge des contrôles courants Windows uniquement. Pour créer et afficher une boîte de dialogue modale, créez une instance de cette classe, en fournissant le nom d’un modèle de ressource existant pour la boîte de dialogue. L’objet de boîte de dialogue se ferme lorsque l’utilisateur clique sur n’importe quel contrôle avec une valeur prédéfinie (par exemple, IDOK ou IDCANCEL).
CSimpleDialog vous permet de créer uniquement des boîtes de dialogue modales. CSimpleDialog fournit la procédure de boîte de dialogue, qui utilise le mappage de messages par défaut pour diriger les messages vers les gestionnaires appropriés.
Pour plus d’informations, voir Implémentation d’une boîte de dialogue.
Hiérarchie d'héritage
CDialogImplBase
CSimpleDialog
Spécifications
En-tête : atlwin.h
CSimpleDialog ::D oModal
Appelle une boîte de dialogue modale et retourne le résultat de la boîte de dialogue lorsque vous avez terminé.
INT_PTR DoModal(HWND hWndParent = ::GetActiveWindow());
Paramètres
hWndParent
Handle vers le parent de la boîte de dialogue. Si aucune valeur n’est fournie, le parent est défini sur la fenêtre active actuelle.
Valeur de retour
Si elle réussit, la valeur de retour est l’ID de ressource du contrôle qui a ignoré la boîte de dialogue.
Si la fonction échoue, la valeur de retour est -1. Pour obtenir des informations plus complètes sur les erreurs, appelez GetLastError.
Notes
Cette méthode gère toutes les interactions avec l’utilisateur pendant que la boîte de dialogue est active. C’est ce qui rend la boîte de dialogue modale ; autrement dit, l’utilisateur ne peut pas interagir avec d’autres fenêtres tant que la boîte de dialogue n’est pas fermée.