Classe de CPropertySheet

Article
03/04/2013

Représente des feuilles de propriétés, également appelé des boîtes de dialogue d'onglet.

class CPropertySheet : public CWnd

Membres

Constructeurs publics

Nom	Description
CPropertySheet::CPropertySheet	Construit un objet CPropertySheet.

Méthodes publiques

Nom	Description
CPropertySheet::AddPage	Ajoute une page à une feuille de propriétés.
CPropertySheet::Construct	Construit un objet CPropertySheet.
CPropertySheet::Create	Affiche une feuille de propriétés non modale.
CPropertySheet::DoModal	Affiche une feuille de propriétés modale.
CPropertySheet::EnableStackedTabs	Indique si les utilisations de feuille de propriétés empilées ou des tabulations de défilement.
CPropertySheet::EndDialog	Termine la feuille de propriétés.
CPropertySheet::GetActiveIndex	Extrait l'index de la page active de la feuille de propriétés.
CPropertySheet::GetActivePage	Retourne l'objet de la page active.
CPropertySheet::GetPage	Extrait un pointeur vers la page spécifiée.
CPropertySheet::GetPageCount	Récupère le nombre de pages dans la feuille de propriétés.
CPropertySheet::GetPageIndex	Extrait l'index de la page spécifiée de la feuille de propriétés.
CPropertySheet::GetTabControl	Extrait un pointeur vers un contrôle onglet.
CPropertySheet::MapDialogRect	Convertit les unités de boîte de dialogue d'un rectangle pour examiner les unités.
CPropertySheet::OnInitDialog	Substitution pour augmenter l'initialisation de feuille de propriétés.
CPropertySheet::PressButton	Décrit le choix du bouton spécifié dans une feuille de propriétés.
CPropertySheet::RemovePage	Supprime une page de la feuille de propriétés.
CPropertySheet::SetActivePage	Définit par programme l'objet page active.
CPropertySheet::SetFinishText	Définit le texte du bouton terminé.
CPropertySheet::SetTitle	Définit la légende de la feuille de propriétés.
CPropertySheet::SetWizardButtons	Active les boutons de l'assistant.
CPropertySheet::SetWizardMode	Active le mode d'assistant.

Données membres publiques

Nom	Description
CPropertySheet::m_psh	La structure de PROPSHEETHEADER windows.Fournit l'accès aux paramètres de base de feuille de propriétés.

Notes

Une feuille de propriétés se compose d'un objet d' CPropertySheet et d'un ou plusieurs objets de CPropertyPage .L'infrastructure affiche une feuille de propriétés comme fenêtre avec un ensemble d'index de tabulation et une zone qui contient la page sélectionnée.L'utilisateur navigue vers une page spécifique à l'aide de la table appropriée.

CPropertySheet fournit la prise en charge de la structure développée de PROPSHEETHEADER introduite dans Windows 98 et Windows NT 2000.La structure contient les balises et des membres supplémentaires qui prennent en charge l'utilisation d'une image d'arrière-plan « filigrane ».

Pour afficher ces nouvelles images automatiquement dans votre objet de feuille de propriétés, passez les valeurs valides pour les images de bitmap et de la palette dans l'appel à CPropertySheet::Construct ou à CPropertySheet::CPropertySheet.

Bien CPropertySheet ne soit pas dérivé de CDialog, gérer un objet d' CPropertySheet est semblable à gérer un objet d' CDialog .Par exemple, la création d'une feuille de propriétés requiert la construction en deux parties : appelez le constructeur, puis appelez DoModal d'une feuille de propriétés modale ou Create d'une feuille de propriétés non modale.CPropertySheet deux types de constructeurs : CPropertySheet::Construct et CPropertySheet::CPropertySheet.

Lorsque vous construisez un objet d' CPropertySheet , un certain Styles de fenêtre peut provoquer une exception de première chance.Cela résulte du système vous essayez de modifier le style de feuille de propriétés avant que la feuille créée.Pour éviter cette exception, assurez -vous que vous définissez les styles suivants lorsque vous créez votre CPropertySheet:

DS_3DLOOK
DS_CONTROL
WS_CHILD
WS_TABSTOP

Les styles suivants sont facultatifs, et n'entraîneront pas d'exceptions de première chance :

DS_SHELLFONT
DS_LOCALEDIT
WS_CLIPCHILDREN

Il est interdit un autre Window Styles et vous ne devez pas les activer.

Échange des données entre un objet d' CPropertySheet et un objet externe sont semblables aux données avec un échange objet d' CDialog .La différence importante est que les paramètres d'une feuille de propriétés sont en général des variables membres d'objets d' CPropertyPage plutôt que de l'objet d' CPropertySheet lui-même.

Vous pouvez créer un type de boîte de dialogue d'onglet appelé un assistant, qui se compose d'une feuille de propriétés avec une séquence de pages de propriétés qui guident l'utilisateur à travers les étapes d'une opération, par exemple configurer un périphérique ou créer un bulletin d'informations.Dans une boîte de dialogue de type assistant onglet, les pages de propriétés n'ont pas les onglets, et uniquement une page de propriétés est visible à la fois.Aussi, au lieu d'avoir OK et des boutons Appliquer maintenant , une boîte de dialogue de type assistant onglet comporte un bouton Arrière , un bouton Suivant ou Terminé , un bouton Annuler , et un bouton Aide .

Pour créer une boîte de dialogue de type assistant, suivez les mêmes étapes que vous suivriez pour créer une feuille de propriétés standard, mais l'appel SetWizardMode avant d'appeler DoModal.Pour permettre aux boutons de l'assistant, à l'appel SetWizardButtons, à l'aide de balises de personnaliser leur fonction et apparence.Pour activer le bouton Terminé , appelez SetFinishText une fois que l'utilisateur a agi sur la dernière page de l'assistant.

Pour plus d'informations sur l'utilisation des objets d' CPropertySheet , consultez l'article feuilles de propriétés et pages de propriétés.En outre, consultez l'article de la Base de connaissances Q146916 : HOWTO : Créez un CPropertySheet non modale avec les boutons et l'article standard Q300606 : HOWTO : Concevez une feuille de propriétés redimensionnable MFC.