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.

Voir aussi

Vue d’ensemble de la classe