CMFCPropertyGridCtrl, classe

Cette rubrique est incluse par souci d'exhaustivité. Pour plus d'informations, consultez le code source situé dans le dossier VC\atlmfc\src\mfc de votre installation Visual Studio.

Prend en charge un contrôle de grille des propriétés modifiables qui peut afficher des propriétés dans l'ordre alphabétique ou hiérarchique.

class CMFCPropertyGridCtrl : public CWnd

Membres

Constructeurs publics

Nom	Description
CMFCPropertyGridCtrl::CMFCPropertyGridCtrl	Construit un objet CMFCPropertyGridCtrl.
CMFCPropertyGridCtrl::~CMFCPropertyGridCtrl	Destructor.

Méthodes publiques

Nom	Description
CMFCPropertyGridCtrl::accHitTest	Appelé par l'infrastructure pour récupérer l'élément enfant ou l'objet enfant à un point donné sur l'écran. (Substitutions CWnd::accHitTest.)
CMFCPropertyGridCtrl::accLocation	Appelé par l'infrastructure pour récupérer l'emplacement actuel de l'écran de l'objet spécifié. (Substitutions CWnd::accLocation.)
CMFCPropertyGridCtrl::accSelect	Appelé par l'infrastructure pour modifier la sélection ou pour déplacer le focus clavier de l'objet spécifié. (Substitutions CWnd::accSelect.)
CMFCPropertyGridCtrl::AddProperty	Ajoute une nouvelle propriété à un contrôle de grille des propriétés.
CMFCPropertyGridCtrl::AlwaysShowUserToolTip
CMFCPropertyGridCtrl::CloseColorPopup	Ferme la boîte de dialogue de sélection de couleurs.
CMFCPropertyGridCtrl::Create	Crée un contrôle de grille des propriétés et l'attache à l'objet contrôle de grille des propriétés.
CMFCPropertyGridCtrl::DeleteProperty	Supprime la propriété spécifiée du contrôle de grille des propriétés.
CMFCPropertyGridCtrl::DrawControlBarColors
CMFCPropertyGridCtrl::EnableDescriptionArea	Active ou désactive la zone de description qui s'affiche sous la liste de propriétés.
CMFCPropertyGridCtrl::EnableHeaderCtrl	Active ou désactive le contrôle header en haut du contrôle de grille des propriétés.
CMFCPropertyGridCtrl::EnsureVisible	Fait défiler un contrôle de grille des propriétés et développe des éléments de propriété jusqu'à ce que la propriété spécifiée est visible.
CMFCPropertyGridCtrl::ExpandAll	Augmente ou diminue tous les nœuds de contrôle de grille des propriétés.
CMFCPropertyGridCtrl::FindItemByData	Récupère la propriété associée à une valeur définie par l'utilisateur d' DWORD .
CMFCPropertyGridCtrl::get_accChild	Appelé par l'infrastructure pour récupérer l'adresse d'une interface d' IDispatch pour l'enfant spécifié. (Substitutions CWnd::get_accChild.)
CMFCPropertyGridCtrl::get_accChildCount	Appelé par l'infrastructure pour récupérer le nombre d'enfants appartenant à cet objet. (Substitutions CWnd::get_accChildCount.)
CMFCPropertyGridCtrl::get_accDefaultAction	Appelé par l'infrastructure pour récupérer une chaîne qui décrit l'action par défaut de l'objet. (Substitutions CWnd::get_accDefaultAction.)
CMFCPropertyGridCtrl::get_accDescription	Appelé par l'infrastructure pour récupérer une chaîne qui décrit l'apparence visuelle de l'objet spécifié. (Substitutions CWnd::get_accDescription.)
CMFCPropertyGridCtrl::get_accFocus	Appelé par l'infrastructure pour récupérer l'objet qui a le focus clavier. (Substitutions CWnd::get_accFocus.)
CMFCPropertyGridCtrl::get_accHelp	Appelé par l'infrastructure pour récupérer la chaîne de propriété d' Help d'un objet. (Substitutions CWnd::get_accHelp.)
CMFCPropertyGridCtrl::get_accHelpTopic	Appelé par l'infrastructure pour récupérer le chemin d'accès complet du fichier d' WinHelpassocié à l'objet spécifié et l'identificateur de la rubrique appropriée dans ce fichier. (Substitutions CWnd::get_accHelpTopic.)
CMFCPropertyGridCtrl::get_accKeyboardShortcut	Appelé par l'infrastructure pour récupérer la touche de raccourci spécifiée ou le raccourci de l'objet. (Substitutions CWnd::get_accKeyboardShortcut.)
CMFCPropertyGridCtrl::get_accName	Appelé par l'infrastructure pour extraire le nom de l'objet spécifié. (Substitutions CWnd::get_accName.)
CMFCPropertyGridCtrl::get_accRole	Appelé par l'infrastructure pour récupérer des informations qui décrivent le rôle de l'objet spécifié. (Substitutions CWnd::get_accRole.)
CMFCPropertyGridCtrl::get_accSelection	Appelé par l'infrastructure pour récupérer les enfants sélectionnés de faire objet. (Substitutions CWnd::get_accSelection.)
CMFCPropertyGridCtrl::get_accState	Appelé par l'infrastructure pour récupérer l'état actuel de l'objet spécifié. (Substitutions CWnd::get_accState.)
CMFCPropertyGridCtrl::get_accValue	Appelé par l'infrastructure pour récupérer la valeur de l'objet spécifié. (Substitutions CWnd::get_accValue.)
CMFCPropertyGridCtrl::GetBkColor	Extrait la couleur d'arrière-plan du contrôle de grille des propriétés actuel.
CMFCPropertyGridCtrl::GetBoldFont	Extrait la police windows qui du texte dans le contrôle de grille des propriétés actuel dans le style gras.
CMFCPropertyGridCtrl::GetCurSel	Récupère la propriété sélectionnée.
CMFCPropertyGridCtrl::GetCustomColors	Récupère les couleurs personnalisées qui sont actuellement définies pour les éléments de contrôle de grille des propriétés.
CMFCPropertyGridCtrl::GetDescriptionHeight	Extrait la hauteur de la zone de description située en bas du contrôle de grille des propriétés.
CMFCPropertyGridCtrl::GetDescriptionRows	Récupère le nombre de lignes dans le champ de description du contrôle de grille des propriétés actuel.
CMFCPropertyGridCtrl::GetHeaderCtrl	Récupère l'objet interne de CMFCHeaderCtrl que l'infrastructure utilise pour afficher le contrôle de grille des propriétés actuel.
CMFCPropertyGridCtrl::GetHeaderHeight	Extrait la hauteur de l'en-tête de contrôle de grille des propriétés.
CMFCPropertyGridCtrl::GetLeftColumnWidth	Extrait la largeur de la colonne de gauche du contrôle de grille des propriétés actuellement, qui contient le nom de chaque propriété.
CMFCPropertyGridCtrl::GetListRect	Récupère le rectangle englobant du contrôle de grille des propriétés.
CMFCPropertyGridCtrl::GetProperty	Extrait un pointeur vers l'objet de propriété correspondant à l'index spécifié d'un élément de contrôle de grille des propriétés.
CMFCPropertyGridCtrl::GetPropertyColumnWidth	Extrait la largeur actuelle de la colonne qui contient les valeurs de propriété.
CMFCPropertyGridCtrl::GetPropertyCount	Récupère le nombre de propriétés dans un contrôle de grille des propriétés.
CMFCPropertyGridCtrl::GetRowHeight	Extrait la hauteur d'une ligne dans le contrôle de grille des propriétés.
CMFCPropertyGridCtrl::GetScrollBarCtrl	Extrait un pointeur vers le contrôle de barre de défilement dans le contrôle de grille des propriétés. (Substitutions CWnd::GetScrollBarCtrl.)
CMFCPropertyGridCtrl::GetTextColor	Extrait la couleur du texte des éléments de propriété dans le contrôle de grille des propriétés actuel.
CMFCPropertyGridCtrl::GetThisClass	Utilisé par l'infrastructure pour obtenir un pointeur vers l'objet de CRuntimeClass associé à ce type de classe.
CMFCPropertyGridCtrl::HitTest	Extrait un pointeur vers l'objet de propriété qui correspond à un élément de contrôle de grille des propriétés si un point spécifié dans l'élément. Cette méthode indique également la zone dans le contrôle de grille des propriétés qui contient le point.
CMFCPropertyGridCtrl::InitHeader	Initialise l'objet interne de CMFCHeaderCtrl que l'infrastructure utilise pour afficher le contrôle de grille des propriétés actuel.
CMFCPropertyGridCtrl::IsAlphabeticMode	Indique si un contrôle de grille des propriétés est en mode alphabétique.
CMFCPropertyGridCtrl::IsAlwaysShowUserToolTip
CMFCPropertyGridCtrl::IsDescriptionArea	Indique si le champ de description du contrôle de grille de propriétés s'affiche.
CMFCPropertyGridCtrl::IsGroupNameFullWidth	Indique si chaque nom de groupe de propriétés est affiché entre la largeur du contrôle de grille des propriétés actuel.
CMFCPropertyGridCtrl::IsHeaderCtrl	Indique si le contrôle header est affiché.
CMFCPropertyGridCtrl::IsMarkModifiedProperties	Indique comment le contrôle de grille des propriétés affiche les propriétés modifiées.
CMFCPropertyGridCtrl::IsShowDragContext	Indique si l'infrastructure redessine les colonnes de nom et valeur du contrôle de grille des propriétés actuel lorsqu'un utilisateur redimensionne les colonnes.
CMFCPropertyGridCtrl::IsVSDotNetLook	Indique si l'apparence du contrôle de grille de propriétés est dans le style utilisé par VS .NET.
CMFCPropertyGridCtrl::MarkModifiedProperties	Indique comment afficher les propriétés modifiées.
CMFCPropertyGridCtrl::PreTranslateMessage	Utilisé par la classe CWinApp pour convertir des messages de fenêtre pour qu'ils soient distribués aux fonctions Windows de TranslateMessage et de DispatchMessage . (Substitutions CWnd::PreTranslateMessage.)
CMFCPropertyGridCtrl::RemoveAll	Supprime tous les objets de propriété d'un contrôle de grille des propriétés.
CMFCPropertyGridCtrl::ResetOriginalValues	Restaure la valeur d'origine de toutes les propriétés.
CMFCPropertyGridCtrl::SetAlphabeticMode	Définit ou mode alphabétique de réinitialise.
CMFCPropertyGridCtrl::SetBoolLabels	Spécifie le texte des étiquettes booléennes.
CMFCPropertyGridCtrl::SetCurSel	Sélectionne une propriété dans un contrôle de grille des propriétés.
CMFCPropertyGridCtrl::SetCustomColors	Spécifie des couleurs personnalisées pour différents éléments de contrôle de grille des propriétés.
CMFCPropertyGridCtrl::SetDescriptionRows	Spécifie le nombre de lignes à afficher dans la section de description du contrôle de grille des propriétés actuel.
CMFCPropertyGridCtrl::SetGroupNameFullWidth	Spécifie s'il faut afficher la largeur du nom de catégorie pour un groupe de propriétés dans le contrôle de grille des propriétés actuel.
CMFCPropertyGridCtrl::SetListDelimiter	Définit un caractère qui sera utilisé comme séparateur dans une liste de valeurs de propriété.
CMFCPropertyGridCtrl::SetShowDragContext	Spécifie si l'infrastructure redessine les colonnes de nom et valeur du contrôle de grille des propriétés actuel lorsqu'un utilisateur redimensionne les colonnes.
CMFCPropertyGridCtrl::SetVSDotNetLook	Définit l'apparence du contrôle de grille des propriétés du style utilisé dans VS .NET.
CMFCPropertyGridCtrl::UpdateColor	Définit la valeur de couleur de la propriété de couleur sélectionnée.

Méthodes protégées

Nom	Description
CMFCPropertyGridCtrl::AdjustLayout	Redessine le contrôle de grille des propriétés et ses propriétés.
CMFCPropertyGridCtrl::CompareProps	Appelé par le contrôle de grille de propriétés pour trier les propriétés.
CMFCPropertyGridCtrl::EditItem	Appelé par l'infrastructure lorsque l'utilisateur commence à modifier une propriété.
CMFCPropertyGridCtrl::EndEditItem	Appelé par l'infrastructure lorsque l'utilisateur arrête de modifier une propriété.
CMFCPropertyGridCtrl::Init	Appelé par l'infrastructure pour initialiser un contrôle de grille des propriétés.
CMFCPropertyGridCtrl::OnChangeSelection	Appelé par l'infrastructure lorsque la sélection actuelle est modifiée.
CMFCPropertyGridCtrl::OnClickButton	Appelé par l'infrastructure lorsqu'un bouton de propriété est effectué sur.
CMFCPropertyGridCtrl::OnDrawBorder	Appelé par l'infrastructure pour dessiner une bordure autour d'un contrôle de grille des propriétés.
CMFCPropertyGridCtrl::OnDrawDescription	Appelé par l'infrastructure pour dessiner la zone de description et afficher le texte de description.
CMFCPropertyGridCtrl::OnDrawList	Appelé par l'infrastructure pour afficher la liste des propriétés dans le contrôle de grille des propriétés.
CMFCPropertyGridCtrl::OnDrawProperty	Appelé par l'infrastructure pour afficher une propriété.
CMFCPropertyGridCtrl::OnPropertyChanged	Appelé par l'infrastructure lorsque la valeur d'une propriété est modifiée.
CMFCPropertyGridCtrl::OnSelectCombo	Appelé par l'infrastructure lorsqu'une propriété qui contient un contrôle zone de liste déroulante est sélectionnée.
CMFCPropertyGridCtrl::ValidateItemData	Appelé par l'infrastructure pour valider les données de propriété.

Notes

Les affichages de classe d' CMFCPropertyGridCtrl qu'un contrôle de grille des propriétés qui contient des propriétés modifiables a dérivés de la classe de CMFCPropertyGridProperty . Chaque propriété peut représenter un type et peut contenir des sous-éléments. Le contrôle de grille des propriétés prend en charge une zone redimensionnable au bas qui peut consulter la description d'une propriété sélectionnée.

Pour utiliser un contrôle de grille des propriétés, construisez un objet d' CMFCPropertyGridCtrl puis appelez la méthode de CMFCPropertyGridCtrl::Create . Utilisez la méthode de CMFCPropertyGridCtrl::AddProperty pour ajouter des propriétés à la liste.

Propriétés de sélection

Au lieu de représenter une valeur, un élément de propriété peut démarrer une boîte de dialogue qui permet à l'utilisateur de sélectionner une couleur, un fichier, ou une police.

Le tableau suivant répertorie quatre types de propriété de sélection :

Classe	Description
CMFCPropertyGridProperty, classe	Une propriété à usage général qui est utilisée pour spécifier la valeur des chaînes, valeur booléenne, dates et ainsi de suite.
CMFCPropertyGridColorProperty, classe	Une propriété utilisée pour sélectionner une valeur de couleur.
CMFCPropertyGridFileProperty, classe	Une propriété utilisée pour sélectionner un fichier.
CMFCPropertyGridFontProperty, classe	Une propriété utilisée pour sélectionner une police.

Illustrations

Les illustrations suivantes représentent un contrôle de grille des propriétés qui affiche les propriétés de deux façons. La première illustration affiche les propriétés de façon hiérarchique et la deuxième affiche les propriétés par ordre alphabétique.

Exemple

L'exemple suivant montre comment configurer un objet contrôle de grille des propriétés en utilisant différentes méthodes dans la classe d' CMFCPropertyGridCtrl . L'exemple montre comment activer le contrôle header, activer la zone de description, et définir l'apparence du contrôle de grille des propriétés. L'exemple montre également comment définir le mode alphabétique pour le contrôle par lequel le contrôle trie toutes les propriétés qu'il contient par leur nom de la propriété, et comment définir des couleurs personnalisées pour des éléments du contrôle de grille des propriétés. Cet exemple fait partie de Nouvel exemples de contrôles.

    CMFCPropertyGridCtrl m_wndPropList;


...


    m_wndPropList.EnableHeaderCtrl();
    m_wndPropList.EnableDescriptionArea();
    m_wndPropList.SetVSDotNetLook(m_bDotNetLook);
    // BOOL m_bMarkChanged
    m_wndPropList.MarkModifiedProperties(m_bMarkChanged);
    // BOOL m_bPropListCategorized
    m_wndPropList.SetAlphabeticMode(!m_bPropListCategorized);
    // BOOL m_bShowDragContext
    m_wndPropList.SetShowDragContext(m_bShowDragContext);


...


    // BOOL m_bMarkSortedColumn
    m_wndList.EnableMarkSortedColumn(m_bMarkSortedColumn);


...


    // BOOL m_bPropListCustomColors 
    // set custom colors for various elements of the property grid control 
    if (m_bPropListCustomColors)
    {
        m_wndPropList.SetCustomColors(RGB(228, 243, 254), RGB(46, 70, 165), RGB(200, 236, 209), RGB(33, 102, 49), RGB(255, 229, 216), RGB(128, 0, 0), RGB(159, 159, 255));
    }
    else
    {
        COLORREF c = (COLORREF)-1;
        m_wndPropList.SetCustomColors(c, c, c, c, c, c, c);
    }

    m_wndPropList.RedrawWindow();


...


    // restore original values of the properties
    m_wndPropList.ResetOriginalValues();

Hiérarchie d'héritage

CObject

   CCmdTarget

      CWnd

         CMFCPropertyGridCtrl

Configuration requise

en-tête : afxpropertygridctrl.h

Voir aussi

Référence

Graphique de la hiérarchie

Autres ressources

classes MFC