CMFCPropertyGridCtrl, classe

Pour plus d’informations, consultez le code source situé dans le mfc dossier de votre installation de Visual Studio. Par exemple : %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc.

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

Syntaxe

class CMFCPropertyGridCtrl : public CWnd

Membres

Constructeurs publics

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

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

Méthodes protégées

Nom	Description
CMFCPropertyGridCtrl::AdjustLayout	Redessine le contrôle de grille de 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 cesse de modifier une propriété.
CMFCPropertyGridCtrl::Init	Appelé par l’infrastructure pour initialiser un contrôle de grille de 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 cliqué.
CMFCPropertyGridCtrl::OnDrawBorder	Appelé par l’infrastructure pour dessiner une bordure autour d’un contrôle de grille de 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 de 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 de zone de liste modifiable est sélectionnée.
CMFCPropertyGridCtrl::ValidateItemData	Appelé par l’infrastructure pour valider les données de propriété.

Notes

La CMFCPropertyGridCtrl classe affiche un contrôle de grille de propriétés qui contient des propriétés modifiables dérivées de la CMFCPropertyGridProperty classe. Chaque propriété peut représenter un type et peut contenir des sous-éléments. Le contrôle de grille de propriétés prend en charge une zone redimensionnable en bas qui peut afficher la description d’une propriété sélectionnée.

Pour utiliser un contrôle de grille de propriétés, construisez un CMFCPropertyGridCtrl objet, puis appelez la CMFCPropertyGridCtrl::Create méthode. Utilisez la CMFCPropertyGridCtrl::AddProperty méthode 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és de sélection :

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

Illustrations

Les illustrations suivantes illustrent un contrôle de grille de propriétés qui affiche les propriétés de deux manières. La première illustration affiche les propriétés hiérarchiquement et la seconde affiche les propriétés par ordre alphabétique.

Exemple

L’exemple suivant montre comment configurer un objet de contrôle de grille de propriétés à l’aide de différentes méthodes dans la CMFCPropertyGridCtrl classe. L’exemple montre comment activer le contrôle d’en-tête, activer la zone de description et définir l’apparence du contrôle de grille de propriétés. L’exemple montre également comment définir le mode alphabétique du contrôle dans lequel le contrôle trie toutes les propriétés qu’il contient par son nom de propriété et comment définir les couleurs personnalisées pour différents éléments du contrôle de grille de propriétés. Cet exemple fait partie de l’exemple New Controls.

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

Spécifications

En-tête : afxpropertygridctrl.h

CMFCPropertyGridCtrl::accSelect

virtual HRESULT accSelect(
    long flagsSelect,
    VARIANT varChild);

Paramètres

[in] flagsSelect
[in] varChild\

Valeur de retour

Notes

CMFCPropertyGridCtrl::AddProperty

Ajoute une nouvelle propriété à un contrôle de grille de propriétés.

int AddProperty(
    CMFCPropertyGridProperty* pProp,
    BOOL bRedraw=TRUE,
    BOOL bAdjustLayout=TRUE);

Paramètres

pProp
[in] Pointeur vers une propriété.

bRedraw
[in] TRUE pour redessiner immédiatement la propriété ; sinon, FALSE. La valeur par défaut est TRUE.

bAdjustLayout
[in] TRUE pour recalculer comment dessiner le texte et la valeur de la propriété, puis dessiner la propriété ; FALSE pour utiliser des calculs existants pour dessiner la propriété. La valeur par défaut est TRUE.

Valeur de retour

Si cette méthode réussit, l’index de base zéro de la position dans le contrôle de grille de propriétés où la propriété est ajoutée ; sinon, -1.

Notes

Cette méthode ajoute un pointeur à la propriété spécifiée à la fin de la liste des propriétés dans le contrôle de grille de propriétés. Ne détruisez pas les propriétés ou ne les autorisez pas à sortir de portée avant la destruction du contrôle de grille. Lorsque vous avez terminé avec le contrôle de grille de propriétés, appelez CMFCPropertyGridCtrl::RemoveAll pour supprimer toutes les propriétés ajoutées. La méthode AddProperty échoue si la propriété spécifiée a déjà été ajoutée à la liste.

CMFCPropertyGridCtrl::AdjustLayout

Redessine le contrôle de grille de propriétés et ses propriétés.

virtual void AdjustLayout();

Notes

Cette méthode recalcule comment dessiner l’ensemble du contrôle de grille de propriétés et ses propriétés, y compris les images, les polices et les contrôles.

CMFCPropertyGridCtrl::AlwaysShowUserToolTip

void AlwaysShowUserToolTip(BOOL bShow = TRUE);

Paramètres

[in] bShow\

Notes

CMFCPropertyGridCtrl::CloseColorPopup

Ferme la boîte de dialogue de sélection de couleur.

virtual void CloseColorPopup();

Notes

Pour plus d’informations sur la boîte de dialogue de sélection de couleurs, consultez CMFCPropertyGridColorProperty Classe.

CMFCPropertyGridCtrl::CMFCPropertyGridCtrl

Construit un objet CMFCPropertyGridCtrl.

CMFCPropertyGridCtrl();

Valeur de retour

Notes

CMFCPropertyGridCtrl::CompareProps

Appelé par le contrôle de grille de propriétés pour trier les propriétés.

virtual int CompareProps(
    const CMFCPropertyGridProperty* pProp1,
    const CMFCPropertyGridProperty* pProp2) const;

Paramètres

pProp1
Pointeur vers une propriété.

pProp2
Pointeur vers une propriété.

Valeur de retour

Valeur de retour	Description
< 0	Le nom du pProp1 paramètre est inférieur au nom du pProp2 paramètre.
0	Le nom du pProp1 paramètre est égal au nom du pProp2 paramètre.
> 0	Le nom de l’objet pProp1 est supérieur au nom du pProp2 paramètre.

Notes

Par défaut, cette méthode utilise la CString::Compare méthode pour comparer les CMFCPropertyGridProperty::m_strName membres des paramètres spécifiés.

CMFCPropertyGridCtrl::Create

Crée un contrôle de grille de propriétés et l’attache à l’objet de contrôle de grille de propriétés.

virtual BOOL Create(
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

Paramètres

dwStyle
[in] Combinaison au niveau du bit « ou » (|) des styles de fenêtre.

rect
[in] Rectangle englobant qui spécifie la taille et la position de la fenêtre, dans les coordonnées clientes de pParentWnd.

pParentWnd
[in] Pointeur vers la fenêtre parente. Ne doit pas être NULL.

nID
[in] ID de la fenêtre enfant.

Valeur de retour

TRUE si la fenêtre a été créée avec succès ; sinon, FALSE.

Notes

Pour créer un contrôle de grille de propriétés, appelez CMFCPropertyGridCtrl::CMFCPropertyGridCtrl d’abord pour construire un objet de grille de propriétés. Appelez ensuite CMFCPropertyGridCtrl::Create.

Exemple

L’exemple suivant montre comment utiliser la méthode dans CMFCPropertyGridCtrl la Create classe. Cet exemple fait partie de l’exemple New Controls.

// CRect rectPropList
// CMFCPropertyGridCtrl m_wndPropList
// The this pointer points to a CPage5 class which extends the CMFCPropertyPage class.
m_wndPropList.Create(WS_CHILD | WS_VISIBLE | WS_TABSTOP | WS_BORDER, rectPropList, this, (UINT)-1);

CMFCPropertyGridCtrl::DeleteProperty

Supprime la propriété spécifiée du contrôle de grille de propriétés.

BOOL DeleteProperty(
    CMFCPropertyGridProperty*& pProp,
    BOOL bRedraw=TRUE,
    BOOL bAdjustLayout=TRUE);

Paramètres

pProp
[in] Pointeur vers une propriété.

bRedraw
[in] TRUE pour redessiner le contrôle de grille de propriétés ; sinon, FALSE. La valeur par défaut est TRUE.

bAdjustLayout
[in] TRUE pour recalculer comment dessiner tout le texte, les images et les éléments du contrôle de grille de propriétés, puis dessiner le contrôle ; sinon, FALSE. La valeur par défaut est TRUE.

Valeur de retour

TRUE si cette méthode réussit ; sinon, FALSE.

Notes

Utilisez cette méthode pour supprimer une propriété et tous les sous-éléments du contrôle de grille de propriétés.

CMFCPropertyGridCtrl::DrawControlBarColors

BOOL DrawControlBarColors() const;

Valeur de retour

Notes

CMFCPropertyGridCtrl::EditItem

Appelé par l’infrastructure lorsque l’utilisateur commence à modifier une propriété.

virtual BOOL EditItem(
    CMFCPropertyGridProperty* pProp,
    LPPOINT lptClick=NULL);

Paramètres

pProp
[in] Pointeur vers une propriété.

lptClick
[in] Point du contrôle de grille de propriétés sur lequel l’utilisateur a cliqué pour commencer l’opération de modification. Le point se trouve dans les coordonnées du client du contrôle. La valeur par défaut est NULL.

Valeur de retour

TRUE si la méthode réussit ; sinon, FALSE.

Notes

CMFCPropertyGridCtrl::EnableDescriptionArea

Active ou désactive la zone de description affichée sous la liste des propriétés dans le contrôle de grille de propriétés.

void EnableDescriptionArea(BOOL bEnable=TRUE);

Paramètres

bEnable
[in] TRUE pour activer la zone de description ; FALSE pour désactiver la zone de description. La valeur par défaut est TRUE.

Notes

La zone de description s’affiche en bas du contrôle de grille de propriétés. Par défaut, la zone de description est désactivée et non visible.

CMFCPropertyGridCtrl::EnableHeaderCtrl

Active ou désactive le contrôle d’en-tête en haut du contrôle de grille de propriétés.

void EnableHeaderCtrl(
    BOOL bEnable=TRUE,
    LPCTSTR lpszLeftColumn=_T("Property"),
    LPCTSTR lpszRightColumn=_T("Value"));

Paramètres

bEnable
[in] TRUE pour activer le contrôle d’en-tête ; FALSE pour désactiver le contrôle d’en-tête. La valeur par défaut est TRUE.

lpszLeftColumn
[in] Titre de la colonne gauche du contrôle d’en-tête. La valeur par défaut est Property.

lpszRightColumn
[in] Titre de la colonne droite du contrôle d’en-tête. La valeur par défaut est Value.

CMFCPropertyGridCtrl::EndEditItem

Appelé par l’infrastructure lorsque l’utilisateur termine la modification d’une propriété.

virtual BOOL EndEditItem(BOOL bUpdateData=TRUE);

Paramètres

bUpdateData
[in] TRUE pour spécifier que les données de propriété modifiées doivent être validées lorsque l’opération de modification est terminée ; sinon, FALSE. La valeur par défaut est TRUE.

Valeur de retour

TRUE si l’opération de modification se termine correctement ; FALSE si les données de propriété modifiées ne sont pas valides ou si l’opération d’édition doit continuer.

Notes

CMFCPropertyGridCtrl::EnsureVisible

Fait défiler un contrôle de grille de propriétés et développe les éléments de propriété jusqu’à ce que la propriété spécifiée soit visible.

void EnsureVisible(
    CMFCPropertyGridProperty* pProp,
    BOOL bExpandParents=FALSE);

Paramètres

pProp
[in] Pointeur vers une propriété.

bExpandParents
[in] TRUE pour développer les éléments parents pour rendre la propriété spécifiée visible ; sinon, FALSE. Par défaut, il s’agit de FALSE.

Notes

CMFCPropertyGridCtrl::ExpandAll

Développe ou réduit tous les nœuds de contrôle de grille de propriétés.

void ExpandAll(BOOL bExpand=TRUE);

Paramètres

bExpand
[in] TRUE pour développer tous les nœuds ; FALSE pour réduire tous les nœuds. La valeur par défaut est TRUE.

Notes

CMFCPropertyGridCtrl::FindItemByData

Récupère la propriété associée à une valeur définie par DWORD l’utilisateur.

CMFCPropertyGridProperty* FindItemByData(
    DWORD_PTR dwData,
    BOOL bSearchSubItems=TRUE) const;

Paramètres

dwData
[in] Valeur DWORD .

bSearchSubItems
[in] TRUE pour rechercher des sous-éléments de propriété ; sinon, FALSE. La valeur par défaut est TRUE.

Valeur de retour

Pointeur vers l’objet de propriété associé si cette méthode réussit ; sinon, NULL.

Notes

Utilisez le constructeur ou CMFCPropertyGridProperty::SetData la CMFCPropertyGridCtrl::CMFCPropertyGridCtrl méthode pour associer une DWORD propriété.

CMFCPropertyGridCtrl::get_accChildCount

virtual HRESULT get_accChildCount(long* pcountChildren);

Paramètres

[in] pcountChildren\

Valeur de retour

Notes

CMFCPropertyGridCtrl::get_accFocus

virtual HRESULT get_accFocus(VARIANT* pvarChild);

Paramètres

[in] pvarChild\

Valeur de retour

Notes

CMFCPropertyGridCtrl::get_accHelp

virtual HRESULT get_accHelp(
    VARIANT varChild,
    BSTR* pszHelp);

Paramètres

[in] varChild
[in] pszHelp\

Valeur de retour

Notes

CMFCPropertyGridCtrl::get_accHelpTopic

virtual HRESULT get_accHelpTopic(
    BSTR* pszHelpFile,
    VARIANT varChild,
    long* pidTopic);

Paramètres

[in] pszHelpFile
[in] varChild
[in] pidTopic\

Valeur de retour

Notes

CMFCPropertyGridCtrl::get_accKeyboardShortcut

virtual HRESULT get_accKeyboardShortcut(
    VARIANT varChild,
    BSTR* pszKeyboardShortcut);

Paramètres

[in] varChild
[in] pszKeyboardShortcut\

Valeur de retour

Notes

CMFCPropertyGridCtrl::get_accSelection

virtual HRESULT get_accSelection(VARIANT* pvarChildren);

Paramètres

[in] pvarChildren\

Valeur de retour

Notes

CMFCPropertyGridCtrl::GetBkColor

Récupère la couleur d’arrière-plan du contrôle de grille de propriétés actuel.

COLORREF GetBkColor() const;

Valeur de retour

Valeur de couleur RVB.

Notes

Cette méthode récupère la couleur utilisée par l’infrastructure pour dessiner l’arrière-plan du contrôle de grille de propriétés actuel. La CMFCPropertyGridCtrl::GetTextColor méthode récupère la couleur de premier plan.

CMFCPropertyGridCtrl::GetBoldFont

Récupère la police Windows utilisée pour dessiner du texte dans le contrôle de grille de propriétés actuel en gras.

CFont& GetBoldFont();

Valeur de retour

Référence à un CFont objet qui décrit les caractéristiques d’une police en gras.

CMFCPropertyGridCtrl::GetCurSel

Récupère la propriété actuellement sélectionnée.

CMFCPropertyGridProperty* GetCurSel() const;

Valeur de retour

Pointeur vers l’objet de propriété qui correspond à l’élément sélectionné dans le contrôle de grille de propriétés.

Notes

CMFCPropertyGridCtrl::GetCustomColors

Récupère les couleurs personnalisées actuellement définies pour les éléments de contrôle de grille de propriétés.

void GetCustomColors(
    COLORREF& clrBackground,
    COLORREF& clrText,
    COLORREF& clrGroupBackground,
    COLORREF& clrGroupText,
    COLORREF& clrDescriptionBackground,
    COLORREF& clrDescriptionText,
    COLORREF& clrLine);

Paramètres

clrBackground
[out] Couleur d’arrière-plan des valeurs de propriété.

clrText
[out] Couleur des noms de propriétés et du texte de valeur de propriété.

clrGroupBackground
[out] Couleur d’arrière-plan d’un groupe de propriétés.

clrGroupText
[out] Couleur du texte dans le groupe de propriétés.

clrDescriptionBackground
[out] Couleur d’arrière-plan de la zone de description.

clrDescriptionText
[out] Couleur du texte dans la zone de description.

clrLine
[out] Couleur des lignes dessinées entre les propriétés.

Notes

Utilisez la CMFCPropertyGridCtrl::SetCustomColors méthode pour définir des couleurs personnalisées.

CMFCPropertyGridCtrl::GetDescriptionHeight

Récupère la hauteur de la zone de description, située en bas du contrôle de grille de propriétés.

int GetDescriptionHeight() const;

Valeur de retour

Hauteur de la zone de description, en pixels.

Notes

La hauteur de la zone de description est calculée automatiquement et est définie sur 1/4 la hauteur du contrôle de grille de propriétés.

Utilisez la CMFCPropertyGridCtrl::EnableDescriptionArea méthode pour afficher ou masquer la zone de description. Utilisez la CMFCPropertyGridCtrl::IsDescriptionArea méthode pour déterminer si la zone de description est affichée ou masquée.

CMFCPropertyGridCtrl::GetDescriptionRows

Récupère le nombre de lignes dans la zone de description du contrôle de grille de propriétés actuel.

int GetDescriptionRows() const;

Valeur de retour

Nombre de lignes dans la zone de description du contrôle de grille de propriétés actuel.

Notes

Le CMFCPropertyGridCtrl::CMFCPropertyGridCtrl constructeur initialise la zone de description sur 3 lignes.

CMFCPropertyGridCtrl::GetHeaderCtrl

Récupère l’objet interne CMFCHeaderCtrl que l’infrastructure utilise pour afficher le contrôle de grille de propriétés actuel.

virtual CMFCHeaderCtrl& GetHeaderCtrl();

Valeur de retour

Référence à un objet CMFCHeaderCtrl.

CMFCPropertyGridCtrl::GetHeaderHeight

Récupère la hauteur de l’en-tête d’un contrôle de grille de propriétés.

int GetHeaderHeight() const;

Valeur de retour

Hauteur de l’en-tête, en pixels.

Notes

CMFCPropertyGridCtrl::GetLeftColumnWidth

Récupère la largeur de la colonne gauche du contrôle de grille de propriétés actuel, qui contient le nom de chaque propriété.

int GetLeftColumnWidth() const;

Valeur de retour

Largeur de la colonne name.

Notes

La colonne droite d’un contrôle de grille de propriétés contient la valeur de chaque propriété.

CMFCPropertyGridCtrl::GetListRect

Récupère le rectangle englobant du contrôle de grille de propriétés.

CRect GetListRect() const;

Valeur de retour

Rectangle englobant du contrôle de grille de propriétés. Cette rectange n’inclut pas la zone de description et l’en-tête.

Notes

CMFCPropertyGridCtrl::GetProperty

Récupère un pointeur vers l’objet de propriété qui correspond à l’index spécifié d’un élément dans un contrôle de grille de propriétés.

CMFCPropertyGridProperty* GetProperty(int nIndex) const;

Paramètres

nIndex
[in] Index de base zéro d’un élément de contrôle de grille de propriétés.

Cette méthode affirme si le nIndex paramètre est inférieur à zéro ou supérieur ou égal au nombre de propriétés.

Valeur de retour

Pointeur vers l’objet de propriété qui correspond à l’index spécifié si cette méthode réussit ; sinon, NULL.

Notes

CMFCPropertyGridCtrl::GetPropertyColumnWidth

Récupère la largeur actuelle de la colonne qui contient des valeurs de propriété.

int GetPropertyColumnWidth() const;

Valeur de retour

Largeur actuelle de la colonne qui contient des valeurs de propriété.

Notes

La colonne située à droite dans le contrôle de grille de propriétés contient les valeurs de propriété. Un client peut utiliser la zone fractionnée du contrôle de grille de propriétés pour modifier la largeur de la colonne valeurs.

CMFCPropertyGridCtrl::GetPropertyCount

Récupère le nombre de propriétés dans un contrôle de grille de propriétés.

int GetPropertyCount() const;

Valeur de retour

Nombre de propriétés.

Notes

CMFCPropertyGridCtrl::GetRowHeight

Récupère la hauteur d’une ligne dans le contrôle de grille de propriétés.

int GetRowHeight() const;

Valeur de retour

Hauteur d'une ligne.

Notes

La hauteur d’une ligne est égale à la hauteur de police actuelle plus 4 pixels.

CMFCPropertyGridCtrl::GetScrollBarCtrl

Récupère un pointeur vers le contrôle de barre de défilement dans le contrôle de grille de propriétés.

virtual CScrollBar* GetScrollBarCtrl(int nBar) const;

Paramètres

nBar
[in] Orientation de la barre de défilement, qui doit être SB_VERT.

Valeur de retour

Pointeur vers un objet de barre de défilement, ou NULL s’il n’y a pas de barre de défilement ou si l’orientation de la barre de défilement est SB_HORZ.

Notes

Utilisez cette méthode pour accéder directement au contrôle de barre de défilement verticale.

CMFCPropertyGridCtrl::GetTextColor

Récupère la couleur utilisée pour dessiner le texte des éléments de propriété dans le contrôle de grille de propriétés actuel.

COLORREF GetTextColor() const;

Valeur de retour

Valeur de couleur RVB.

Notes

Cette méthode récupère la couleur utilisée par l’infrastructure pour dessiner le premier plan du contrôle de grille de propriétés actuel. La CMFCPropertyGridCtrl::GetBkColor méthode récupère la couleur d’arrière-plan.

CMFCPropertyGridCtrl::HitTest

Récupère un pointeur vers l’objet de propriété qui correspond à un élément de contrôle de grille de propriétés si un point spécifié se trouve dans l’élément. Cette méthode indique également la zone du contrôle de grille de propriétés qui contient le point.

CMFCPropertyGridProperty* HitTest(
    CPoint pt,
    CMFCPropertyGridProperty::ClickArea* pnArea=NULL,
    BOOL bPropsOnly=FALSE) const;

Paramètres

pt
[in] Point, dans les coordonnées du client.

pnArea
[in, out] Pointeur vers une ClickArea variable. Lorsque cette méthode est retournée, la variable indique la zone de propriété qui contient le point spécifié. Pour plus d’informations sur une zone de propriété, consultez Remarques.

bPropsOnly
[in] TRUE pour tester uniquement la zone de propriété ; FALSE pour tester la zone de description si le point spécifié n’est pas dans la zone de propriété. La valeur par défaut est FALSE. Pour plus d’informations sur la zone de description, consultez Remarques.

Valeur de retour

Si le paramètre est TRUE et que le bPropsOnly point spécifié se trouve dans une zone de propriété, la valeur de retour est un pointeur vers l’objet de propriété correspondant. En outre, le pnArea paramètre est défini sur la zone particulière qui contient le point spécifié. Sinon, la valeur de retour est NULL et le pnArea paramètre n’est pas modifié.

Si le bPropsOnly paramètre est FALSE, la valeur de retour est toujours NULL. Toutefois, si le point spécifié se trouve dans la zone de description, le pnArea paramètre est défini sur CMFCPropertyGridProperty::ClickDescription.

Notes

La zone de propriété terme fait référence à l’une des zones nom, valeur ou zone de développement d’un élément de contrôle de grille de propriétés. La zone de description est la zone située en bas d’un contrôle de grille de propriétés. Lorsque vous sélectionnez un élément de contrôle de grille de propriétés, la zone de description affiche une description de la propriété correspondante.

Cette méthode définit la valeur de la variable à laquelle pointe le pnArea paramètre. Le tableau suivant répertorie les valeurs possibles et les zones correspondantes.

Valeur	Zone
ClickArea::ClickExpandBox	Contrôle de zone de développement de propriété.
ClickArea::ClickName	Nom de la propriété.
ClickArea::ClickValue	Valeur de la propriété.
CMFCPropertyGridProperty::ClickDescription	Zone de description du contrôle de grille de propriétés.

CMFCPropertyGridCtrl::Init

Appelé par l’infrastructure pour initialiser un contrôle de grille de propriétés.

virtual void Init();

Notes

CMFCPropertyGridCtrl::InitHeader

Initialise l’objet interne CMFCHeaderCtrl que l’infrastructure utilise pour afficher le contrôle de grille de propriétés actuel.

virtual void InitHeader();

CMFCPropertyGridCtrl::IsAlphabeticMode

Indique si un contrôle de grille de propriétés est en mode alphabétique.

BOOL IsAlphabeticMode() const;

Valeur de retour

TRUE si le contrôle de grille de propriétés est en mode alphabétique ; sinon FALSE.

Notes

Lorsque le contrôle de grille de propriétés est en mode alphabétique, toutes les propriétés sont triées par ordre alphabétique par leur nom. Sinon, les propriétés sont regroupées sous leurs nœuds parents.

Utilisez la méthode pour activer ou désactiver le CMFCPropertyGridCtrl::SetAlphabeticMode mode alphabétique.

CMFCPropertyGridCtrl::IsAlwaysShowUserToolTip

BOOL IsAlwaysShowUserToolTip() const;

Valeur de retour

Notes

CMFCPropertyGridCtrl::IsDescriptionArea

Indique si la zone de description du contrôle de grille de propriétés s’affiche.

BOOL IsDescriptionArea() const;

Valeur de retour

TRUE si la zone de description est affichée ; sinon, FALSE.

Notes

Utilisez la CMFCPropertyGridCtrl::EnableDescriptionArea méthode pour masquer ou afficher la zone de description.

CMFCPropertyGridCtrl::IsGroupNameFullWidth

Indique si chaque nom de groupe de propriétés est affiché sur la largeur du contrôle de grille de propriétés actuel.

BOOL IsGroupNameFullWidth() const;

Valeur de retour

TRUE si les noms de groupe sont affichés sur la largeur du contrôle de grille de propriétés ; FALSE si les noms de groupes sont tronqués par la colonne droite (valeur) du contrôle.

Notes

Un groupe est une collection de propriétés associées dans un contrôle de grille de propriétés. Si le contrôle est affiché hiérarchiquement, le nom du groupe s’affiche sous la forme d’un titre de catégorie dans la ligne au-dessus du groupe.

CMFCPropertyGridCtrl::IsHeaderCtrl

Indique si le contrôle d’en-tête est affiché.

BOOL IsHeaderCtrl() const;

Valeur de retour

TRUE si le contrôle d’en-tête est affiché ; sinon FALSE.

Notes

Utilisez la CMFCPropertyGridCtrl::EnableHeaderCtrl méthode pour masquer ou afficher le contrôle d’en-tête.

CMFCPropertyGridCtrl::IsMarkModifiedProperties

Indique comment le contrôle de grille de propriétés affiche les propriétés modifiées.

BOOL IsMarkModifiedProperties() const;

Valeur de retour

TRUE si le style gras est utilisé pour afficher les propriétés modifiées ; FALSE si le style standard est utilisé pour afficher les propriétés modifiées.

Notes

CMFCPropertyGridCtrl::IsShowDragContext

Indique si l’infrastructure redessine le nom et les colonnes de valeur du contrôle de grille de propriétés actuel lorsqu’un utilisateur redimensionne les colonnes.

BOOL IsShowDragContext() const;

Valeur de retour

TRUE si l’infrastructure redessine les colonnes nom et valeur pendant une opération de redimensionnement ; FALSE si l’infrastructure redessine les colonnes une fois l’opération de glisser terminée.

Notes

L’utilisateur peut redimensionner les colonnes nom et valeur d’un contrôle de grille de propriétés en faisant glisser la barre fractionnée entre les colonnes. Si le contexte de glissement s’affiche, les colonnes nom et valeur sont redimensionnées tant que l’utilisateur fait glisser la barre fractionnée. Sinon, la barre fractionnée se déplace, mais les colonnes ne sont pas redessinées tant que l’opération de glissement n’est pas terminée.

CMFCPropertyGridCtrl::IsVSDotNetLook

Indique si l’apparence du contrôle de grille de propriétés se trouve dans le style de Visual Studio .NET.

BOOL IsVSDotNetLook() const;

Valeur de retour

TRUE si le contrôle de grille de propriétés est dans le style de Visual Studio .NET ; sinon, FALSE.

Notes

Utilisez la CMFCPropertyGridCtrl::SetVSDotNetLook méthode pour définir le contrôle de grille de propriétés sur le style de Visual Studio .NET.

CMFCPropertyGridCtrl::MarkModifiedProperties

Spécifie comment afficher les propriétés modifiées.

void MarkModifiedProperties(
    BOOL bMark=TRUE,
    BOOL bRedraw=TRUE);

Paramètres

bMark
[in] TRUE pour afficher les propriétés modifiées en gras ; FALSE pour afficher les propriétés modifiées dans un style normal. La valeur par défaut est TRUE.

bRedraw
[in] TRUE pour redessiner immédiatement le contrôle de grille de propriétés ; sinon, FALSE. La valeur par défaut est TRUE.

Notes

CMFCPropertyGridCtrl::OnChangeSelection

Appelé par l’infrastructure lorsque la sélection actuelle est modifiée.

virtual void OnChangeSelection(
    CMFCPropertyGridProperty* pNewSel,
    CMFCPropertyGridProperty* pOldSel);

Paramètres

pNewSel
[in] Pointeur vers la propriété nouvellement sélectionnée.

pOldSel
[in] Pointeur vers la propriété précédemment sélectionnée.

Notes

L’implémentation par défaut de cette méthode ne fait rien.

CMFCPropertyGridCtrl::OnClickButton

Appelé par l’infrastructure lorsqu’un bouton de propriété est cliqué.

virtual void OnClickButton(CPoint point);

Paramètres

point
[in] Point, dans les coordonnées du client.

Notes

Par défaut, cette méthode met à jour la valeur de propriété actuelle.

CMFCPropertyGridCtrl::OnDrawBorder

Appelé par l’infrastructure pour dessiner une bordure autour d’un contrôle de grille de propriétés.

virtual void OnDrawBorder(CDC* pDC);

Paramètres

pDC
[in] Pointeur vers un contexte d’appareil.

Notes

CMFCPropertyGridCtrl::OnDrawDescription

Appelé par l’infrastructure pour dessiner la zone de description et afficher le texte de description.

virtual void OnDrawDescription(
    CDC* pDC,
    CRect rect);

Paramètres

pDC
[in] Pointeur vers un contexte d’appareil.

rect
[in] Rectangle qui spécifie où dessiner la zone de description.

Notes

Utilisez la CMFCPropertyGridCtrl::EnableDescriptionArea méthode pour afficher la zone de description.

CMFCPropertyGridCtrl::OnDrawList

Appelé par l’infrastructure pour afficher la liste des propriétés dans le contrôle de grille de propriétés.

virtual void OnDrawList(CDC* pDC);

Paramètres

pDC
[in] Pointeur vers un contexte d’appareil.

Notes

CMFCPropertyGridCtrl::OnDrawProperty

Appelé par l’infrastructure pour afficher une propriété.

virtual int OnDrawProperty(
    CDC* pDC,
    CMFCPropertyGridProperty* pProp) const;

Paramètres

pDC
[in] Pointeur vers un contexte d’appareil.

pProp
[in] Pointeur vers un objet de propriété.

Valeur de retour

TRUE si cette méthode réussit ; sinon, FALSE.

Notes

CMFCPropertyGridCtrl::OnPropertyChanged

Appelé par l’infrastructure lorsque la valeur d’une propriété est modifiée.

virtual void OnPropertyChanged(CMFCPropertyGridProperty* pProp) const;

Paramètres

pProp
[in] Pointeur vers un objet de propriété dont la valeur a changé.

Notes

Par défaut, cette méthode envoie le AFX_WM_PROPERTY_CHANGED message au propriétaire du contrôle de grille de propriétés.

CMFCPropertyGridCtrl::OnSelectCombo

Appelé par l’infrastructure lorsqu’une propriété qui contient un contrôle de zone de liste modifiable est sélectionnée.

void OnSelectCombo();

Notes

CMFCPropertyGridCtrl::RemoveAll

Supprime tous les objets de propriété d’un contrôle de grille de propriétés.

void RemoveAll();

Notes

CMFCPropertyGridCtrl::ResetOriginalValues

Restaure les valeurs d’origine de toutes les propriétés.

void ResetOriginalValues(BOOL bRedraw=TRUE);

Paramètres

bRedraw
[in] TRUE pour redessiner la liste des propriétés ; sinon, FALSE. La valeur par défaut est TRUE.

Notes

CMFCPropertyGridCtrl::SetAlphabeticMode

Définit ou réinitialise le mode alphabétique.

void SetAlphabeticMode(BOOL bSet=TRUE);

Paramètres

bSet
[in] TRUE pour définir le mode alphabétique ; FALSE réinitialiser le mode alphabétique. La valeur par défaut est TRUE.

Notes

Lorsque le contrôle de grille de propriétés est en mode alphabétique, le contrôle trie toutes les propriétés qu’il contient par leur nom de propriété.

CMFCPropertyGridCtrl::SetBoolLabels

Spécifie le texte des étiquettes booléennes.

void SetBoolLabels(
    LPCTSTR lpszTrue,
    LPCTSTR lpszFalse);

Paramètres

lpszTrue
[in] Chaîne de texte à afficher pour la valeur booléenne de true.

lpszFalse
[in] Chaîne de texte à afficher pour la valeur booléenne de false.

Notes

CMFCPropertyGridCtrl::SetCurSel

Sélectionne une propriété dans un contrôle de grille de propriétés.

void SetCurSel(
    CMFCPropertyGridProperty* pProp,
    BOOL bRedraw=TRUE);

Paramètres

pProp
[in] Pointeur vers un objet de propriété.

bRedraw
[in] TRUE pour redessiner immédiatement le contrôle de grille de propriétés ; sinon, FALSE. La valeur par défaut est TRUE.

Notes

Utilisez cette méthode pour annuler la sélection de l’élément actif dans le contrôle de grille de propriétés, puis sélectionnez l’élément qui correspond à la propriété spécifiée.

CMFCPropertyGridCtrl::SetCustomColors

Spécifie des couleurs personnalisées pour différents éléments du contrôle de grille de propriétés.

void SetCustomColors(
    COLORREF clrBackground,
    COLORREF clrText,
    COLORREF clrGroupBackground,
    COLORREF clrGroupText,
    COLORREF clrDescriptionBackground,
    COLORREF clrDescriptionText,
    COLORREF clrLine);

Paramètres

clrBackground
[in] Couleur d’arrière-plan des valeurs de propriété.

clrText
[in] Couleur des noms de propriétés et du texte de valeur de propriété.

clrGroupBackground
[in] Couleur d’arrière-plan d’un groupe de propriétés.

clrGroupText
[in] Nouvelle couleur de texte du groupe de propriétés.

clrDescriptionBackground
[in] Couleur d’arrière-plan de la zone de description.

clrDescriptionText
[in] Couleur du texte dans la zone de description.

clrLine
[in] Couleur des lignes dessinées entre les propriétés.

Notes

Pour n’importe quel paramètre, spécifiez la ((COLORREF)-1) valeur de couleur à utiliser la couleur par défaut pour cet élément du contrôle de grille de propriétés.

Pour personnaliser l’apparence d’une propriété spécifique, dérivez une classe de la CMFCPropertyGridProperty classe, puis remplacez les méthodes, et CMFCPropertyGridProperty::OnDrawExpandBoxCMFCPropertyGridProperty::OnDrawButton les CMFCPropertyGridProperty::OnDrawNameméthodesCMFCPropertyGridProperty::OnDrawValue.

CMFCPropertyGridCtrl::SetDescriptionRows

Spécifie le nombre de lignes à afficher dans la section description du contrôle de grille de propriétés actuel.

void SetDescriptionRows(int nDescRows);

Paramètres

nDescRows
[in] Nombre de lignes à afficher dans la description de la propriété.

CMFCPropertyGridCtrl::SetGroupNameFullWidth

Spécifie s’il faut afficher la largeur totale du nom de catégorie pour un groupe de propriétés dans le contrôle de grille de propriétés actuel.

void SetGroupNameFullWidth(
    BOOL bGroupNameFullWidth = TRUE,
    BOOL bRedraw = TRUE);

Paramètres

bGroupNameFullWidth
[in] TRUE pour afficher la largeur complète du nom de catégorie, quelle que soit la largeur de la colonne nom de propriété. FALSE pour limiter la largeur du nom de catégorie à la largeur de la colonne nom de propriété. La valeur par défaut est TRUE.

bRedraw
[in] TRUE pour mettre à jour immédiatement le contrôle de grille de propriétés ; FALSE pour mettre à jour le contrôle lorsque l’événement de redessination suivant se produit. La valeur par défaut est TRUE.

Notes

Le contrôle de grille de propriétés se compose d’une colonne de nom de propriété redimensionnable et d’une colonne de valeur de propriété. La fin de la colonne de nom est également le début de la colonne de valeur. Pour redimensionner les colonnes, faites glisser la bordure entre les colonnes.

Le nom du groupe et le nom de catégorie sont utilisés de façon interchangeable dans cette méthode. Le nom de catégorie s’affiche sur une ligne qui dirige un ensemble de propriétés et de valeurs associées. Cette méthode spécifie si la largeur de la colonne nom de propriété spécifie également la largeur du nom de catégorie affiché.

CMFCPropertyGridCtrl::SetListDelimiter

Définit un caractère utilisé comme délimiteur dans une liste de valeurs de propriété.

void SetListDelimiter(TCHAR c);

Paramètres

c
[in] Caractère à servir de délimiteur.

Notes

Utilisez cette méthode pour définir un caractère délimiteur dans une liste de valeurs de propriété utilisées dans le CMFCPropertyGridProperty::CMFCPropertyGridProperty constructeur. Dans ce constructeur, définissez le bIsValueList paramètre sur TRUE.

Par défaut, le CMFCPropertyGridCtrl::CMFCPropertyGridCtrl constructeur définit le caractère délimiteur sur virgule (',').

CMFCPropertyGridCtrl::SetShowDragContext

Spécifie si l’infrastructure redessine les colonnes nom et valeur du contrôle de grille de propriétés actuel lorsqu’un utilisateur redimensionne les colonnes.

void SetShowDragContext(BOOL bShowDragContext = TRUE);

Paramètres

bShowDragContext
[in] TRUE pour redessiner les colonnes nom et valeur pendant une opération de redimensionnement ; FALSE pour redessiner les colonnes une fois l’opération de glisser terminée. La valeur par défaut est TRUE.

Notes

L’utilisateur peut redimensionner les colonnes nom et valeur d’un contrôle de grille de propriétés en faisant glisser la barre fractionnée entre les colonnes. Si le contexte de glissement s’affiche, les colonnes nom et valeur sont redimensionnées tant que l’utilisateur fait glisser la barre fractionnée. Sinon, la barre fractionnée se déplace, mais les colonnes ne sont pas redessinées tant que l’opération de glissement n’est pas terminée.

CMFCPropertyGridCtrl::SetVSDotNetLook

Définit l’apparence du contrôle de grille de propriétés sur le style utilisé dans Visual Studio .NET.

void SetVSDotNetLook(BOOL bSet=TRUE);

Paramètres

bSet
[in] TRUE pour définir le contrôle de grille de propriétés sur le style utilisé dans Visual Studio .NET ; sinon, FALSE. La valeur par défaut est TRUE.

Notes

CMFCPropertyGridCtrl::UpdateColor

Définit la valeur de couleur de la propriété de couleur actuellement sélectionnée.

virtual void UpdateColor(COLORREF color);

Paramètres

color
[in] Valeur de couleur RVB.

Notes

Cette méthode s’affirme en mode débogage si la propriété actuellement sélectionnée du contrôle de grille de propriétés n’est pas une propriété de couleur.

CMFCPropertyGridCtrl::ValidateItemData

Appelé par l’infrastructure pour valider les données de propriété.

virtual BOOL ValidateItemData(CMFCPropertyGridProperty* pProp);

Paramètres

pProp
[in] Pointeur vers une propriété. Ce paramètre n’est pas utilisé.

Valeur de retour

A toujours la valeur TRUE.

Notes

La CMFCPropertyGridCtrl::EndEditItem méthode appelle cette méthode pour valider les données. Par défaut, cette méthode n’utilise pas son pProp paramètre et sa valeur de retour est toujours TRUE.

Si vous remplacez cette méthode, retournez TRUE si les données de propriété spécifiées sont valides. Sinon, retournez FALSE, auquel cas l’infrastructure ne met pas à jour la propriété.

Voir aussi

Graphique hiérarchique
Classes