Virtual int DoModal ( );
Valeur de retour
IDOK ou IDCANCEL si la fonction a réussi ; sinon 0 ou -1. Si la feuille de propriétés a été établie comme un Assistant (voir SetWizardMode), DoModal renvoie la valeur ID_WIZFINISH ou IDCANCEL.
Remarques
Appelez cette fonction membre pour afficher une feuille de propriété modal. La valeur de retour correspond à l'ID du contrôle qui a fermé la feuille de propriétés. Après que cette fonction retourne les windows correspondant à la feuille de propriétés et de toutes les pages seront ont été détruits. Les objets eux-mêmes existeront toujours. En général, vous récupérerez données depuis les objets CPropertyPage après DoModal retourne IDOK.
Pour afficher une feuille non modale, appelez Create.
&Notenbsp ; La première fois qu'une page de propriétés est créée à partir de la ressource de la boîte de dialogue correspondante, elle peut causer une exception de première chance. C'est un résultat de la page de propriétés, changer le style de la ressource de boîte de dialogue du style requis avant de créer la page. Parce que les ressources sont généralement en lecture seule, cela provoque une exception. L'exception est gérée par le système, et une copie de la ressource modifiée est faite automatiquement par le système. L'exception de première chance peut donc être ignorée.
Étant donné que cette exception doit être gérée par le système d'exploitation, n'enroulez pas d'appels à CPropertySheet::DoModal avec un C++ essayer/attraper bloc dans lequel le catch gère toutes les exceptions, par exemple, catch (...) . Il gérera l'exception destinée au système d'exploitation, provoquant un comportement imprévisible. À l'aide d'exception C++ avec les types d'exceptions spécifiques de manutention ou à l'aide de gestion structurée des exceptions où l'exception de Violation d'accès est passée par le biais du système d'exploitation est sans danger, toutefois.
CPropertySheet aperçu | ; Membres de la classe | Graphique de la hiérarchie
Voir aussi ;CDialog::DoModal, CPropertySheet::Create