Classe CMFCPropertyGridCtrl

Per altri dettagli, vedere il codice sorgente che si trova nella mfc cartella dell'installazione di Visual Studio. Ad esempio: %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc.

Supporta un controllo griglia delle proprietà modificabile che può visualizzare le proprietà in ordine alfabetico o gerarchico.

Sintassi

class CMFCPropertyGridCtrl : public CWnd

Membri

Costruttori pubblici

Nome	Descrizione
CMFCPropertyGridCtrl::CMFCPropertyGridCtrl	Costruisce un oggetto CMFCPropertyGridCtrl.
CMFCPropertyGridCtrl::~CMFCPropertyGridCtrl	Distruttore.

Metodi pubblici

Nome	Descrizione
CMFCPropertyGridCtrl::accHitTest	Chiamata eseguita dal framework per recuperare l'elemento figlio o l'oggetto figlio in un determinato punto dello schermo. Esegue l'override di CWnd::accHitTest.
CMFCPropertyGridCtrl::accLocation	Chiamata eseguita dal framework per recuperare la posizione sullo schermo corrente dell'oggetto specificato. Esegue l'override di CWnd::accLocation.
CMFCPropertyGridCtrl::accSelect	Chiamata eseguita dal framework per modificare la selezione o per spostare lo stato attivo della tastiera dell'oggetto specificato. Esegue l'override di CWnd::accSelect.
CMFCPropertyGridCtrl::AddProperty	Aggiunge una nuova proprietà a un controllo griglia delle proprietà.
CMFCPropertyGridCtrl::AlwaysShowUserToolTip
CMFCPropertyGridCtrl::CloseColorPopup	Chiude la finestra di dialogo di selezione dei colori.
CMFCPropertyGridCtrl::Create	Crea un controllo griglia delle proprietà e lo associa all'oggetto controllo griglia delle proprietà.
CMFCPropertyGridCtrl::DeleteProperty	Elimina la proprietà specificata dal controllo griglia delle proprietà.
CMFCPropertyGridCtrl::DrawControlBarColors
CMFCPropertyGridCtrl::EnableDescriptionArea	Abilita o disabilita l'area di descrizione visualizzata sotto l'elenco delle proprietà.
CMFCPropertyGridCtrl::EnableHeaderCtrl	Abilita o disabilita il controllo intestazione nella parte superiore del controllo griglia delle proprietà.
CMFCPropertyGridCtrl::EnsureVisible	Scorre un controllo griglia di proprietà ed espande gli elementi delle proprietà fino a quando la proprietà specificata non è visibile.
CMFCPropertyGridCtrl::ExpandAll	Espande o comprime tutti i nodi di controllo della griglia delle proprietà.
CMFCPropertyGridCtrl::FindItemByData	Recupera la proprietà associata a un valore definito dall'utente DWORD .
CMFCPropertyGridCtrl::get_accChild	Chiamata eseguita dal framework per recuperare l'indirizzo di un'interfaccia IDispatch per l'elemento figlio specificato. Esegue l'override di CWnd::get_accChild.
CMFCPropertyGridCtrl::get_accChildCount	Chiamata eseguita dal framework per recuperare il numero di elementi figlio appartenenti all'oggetto corrente. Esegue l'override di CWnd::get_accChildCount.
CMFCPropertyGridCtrl::get_accDefaultAction	Chiamata eseguita dal framework per recuperare una stringa che descrive l'azione predefinita dell'oggetto. Esegue l'override di CWnd::get_accDefaultAction.
CMFCPropertyGridCtrl::get_accDescription	Chiamata eseguita dal framework per recuperare una stringa che descrive l'aspetto visivo dell'oggetto specificato. Esegue l'override di CWnd::get_accDescription.
CMFCPropertyGridCtrl::get_accFocus	Chiamata eseguita dal framework per recuperare l'oggetto con lo stato attivo della tastiera. Esegue l'override di CWnd::get_accFocus.
CMFCPropertyGridCtrl::get_accHelp	Chiamato dal framework per recuperare la stringa di proprietà di Help un oggetto. Esegue l'override di CWnd::get_accHelp.
CMFCPropertyGridCtrl::get_accHelpTopic	Chiamata eseguita dal framework per recuperare il percorso completo del file WinHelp associato all'oggetto specificato e l'identificatore dell'argomento appropriato all'interno del file. Esegue l'override di CWnd::get_accHelpTopic.
CMFCPropertyGridCtrl::get_accKeyboardShortcut	Chiamata eseguita dal framework per recuperare la combinazione di tasti o il tasto di scelta dell'oggetto specificato. Esegue l'override di CWnd::get_accKeyboardShortcut.
CMFCPropertyGridCtrl::get_accName	Chiamata eseguita dal framework per recuperare il nome dell'oggetto specificato. Esegue l'override di CWnd::get_accName.
CMFCPropertyGridCtrl::get_accRole	Chiamata eseguita dal framework per recuperare informazioni che descrivono il ruolo dell'oggetto specificato. Esegue l'override di CWnd::get_accRole.
CMFCPropertyGridCtrl::get_accSelection	Chiamata eseguita dal framework per recuperare gli elementi figlio selezionati dell'oggetto. Esegue l'override di CWnd::get_accSelection.
CMFCPropertyGridCtrl::get_accState	Chiamata eseguita dal framework per recuperare lo stato corrente dell'oggetto specificato. Esegue l'override di CWnd::get_accState.
CMFCPropertyGridCtrl::get_accValue	Chiamata eseguita dal framework per recuperare il valore dell'oggetto specificato. Esegue l'override di CWnd::get_accValue.
CMFCPropertyGridCtrl::GetBkColor	Recupera il colore di sfondo del controllo griglia delle proprietà corrente.
CMFCPropertyGridCtrl::GetBoldFont	Recupera il tipo di carattere di Windows del testo nel controllo griglia delle proprietà corrente in grassetto.
CMFCPropertyGridCtrl::GetCurSel	Recupera la proprietà attualmente selezionata.
CMFCPropertyGridCtrl::GetCustomColors	Recupera i colori personalizzati attualmente definiti per gli elementi di controllo griglia delle proprietà.
CMFCPropertyGridCtrl::GetDescriptionHeight	Recupera l'altezza dell'area di descrizione che si trova nella parte inferiore del controllo griglia delle proprietà.
CMFCPropertyGridCtrl::GetDescriptionRows	Recupera il numero di righe nell'area di descrizione del controllo griglia delle proprietà corrente.
CMFCPropertyGridCtrl::GetHeaderCtrl	Recupera l'oggetto interno CMFCHeaderCtrl utilizzato dal framework per visualizzare il controllo griglia delle proprietà corrente.
CMFCPropertyGridCtrl::GetHeaderHeight	Recupera l'altezza dell'intestazione del controllo griglia delle proprietà.
CMFCPropertyGridCtrl::GetLeftColumnWidth	Recupera la larghezza della colonna sinistra del controllo griglia delle proprietà corrente, che contiene il nome di ogni proprietà.
CMFCPropertyGridCtrl::GetListRect	Recupera il rettangolo di delimitazione del controllo griglia delle proprietà.
CMFCPropertyGridCtrl::GetProperty	Recupera un puntatore all'oggetto proprietà che corrisponde all'indice specificato di un elemento di controllo griglia delle proprietà.
CMFCPropertyGridCtrl::GetPropertyColumnWidth	Recupera la larghezza corrente della colonna che contiene i valori delle proprietà.
CMFCPropertyGridCtrl::GetPropertyCount	Recupera il numero di proprietà in un controllo griglia delle proprietà.
CMFCPropertyGridCtrl::GetRowHeight	Recupera l'altezza di una riga nel controllo griglia delle proprietà.
CMFCPropertyGridCtrl::GetScrollBarCtrl	Recupera un puntatore al controllo barra di scorrimento nel controllo griglia delle proprietà. Esegue l'override di CWnd::GetScrollBarCtrl.
CMFCPropertyGridCtrl::GetTextColor	Recupera il colore del testo degli elementi della proprietà nel controllo griglia delle proprietà corrente.
CMFCPropertyGridCtrl::GetThisClass	Utilizzato dal framework per ottenere un puntatore all'oggetto CRuntimeClass associato a questo tipo di classe.
CMFCPropertyGridCtrl::HitTest	Recupera un puntatore all'oggetto proprietà che corrisponde a un elemento di controllo griglia delle proprietà se un punto specificato si trova nell'elemento. Questo metodo indica anche l'area nel controllo griglia delle proprietà che contiene il punto.
CMFCPropertyGridCtrl::InitHeader	Inizializza l'oggetto interno CMFCHeaderCtrl utilizzato dal framework per visualizzare il controllo griglia delle proprietà corrente.
CMFCPropertyGridCtrl::IsAlphabeticMode	Indica se un controllo griglia delle proprietà è in modalità alfabetica.
CMFCPropertyGridCtrl::IsAlwaysShowUserToolTip
CMFCPropertyGridCtrl::IsDescriptionArea	Indica se viene visualizzata l'area di descrizione del controllo griglia delle proprietà.
CMFCPropertyGridCtrl::IsGroupNameFullWidth	Indica se ogni nome del gruppo di proprietà viene visualizzato nella larghezza del controllo griglia delle proprietà corrente.
CMFCPropertyGridCtrl::IsHeaderCtrl	Indica se viene visualizzato il controllo intestazione.
CMFCPropertyGridCtrl::IsMarkModifiedProperties	Indica in che modo il controllo griglia delle proprietà visualizza le proprietà modificate.
CMFCPropertyGridCtrl::IsShowDragContext	Indica se il framework ridisegna il nome e le colonne valore del controllo griglia delle proprietà corrente quando un utente ridimensiona le colonne.
CMFCPropertyGridCtrl::IsVSDotNetLook	Indica se l'aspetto del controllo griglia delle proprietà è nello stile utilizzato da VS .NET.
CMFCPropertyGridCtrl::MarkModifiedProperties	Specifica come visualizzare le proprietà modificate.
CMFCPropertyGridCtrl::PreTranslateMessage	Usato dalla classe CWinApp per convertire i messaggi della TranslateMessage finestra prima che vengano inviati alle funzioni di e DispatchMessage Windows. Esegue l'override di CWnd::PreTranslateMessage.
CMFCPropertyGridCtrl::RemoveAll	Rimuove tutti gli oggetti proprietà da un controllo griglia delle proprietà.
CMFCPropertyGridCtrl::ResetOriginalValues	Ripristina il valore originale di tutte le proprietà.
CMFCPropertyGridCtrl::SetAlphabeticMode	Imposta o reimposta la modalità alfabetica.
CMFCPropertyGridCtrl::SetBoolLabels	Specifica il testo delle etichette booleane.
CMFCPropertyGridCtrl::SetCurSel	Seleziona una proprietà in un controllo griglia delle proprietà.
CMFCPropertyGridCtrl::SetCustomColors	Specifica colori personalizzati per vari elementi di controllo griglia delle proprietà.
CMFCPropertyGridCtrl::SetDescriptionRows	Specifica il numero di righe da visualizzare nella sezione descrizione del controllo griglia delle proprietà corrente.
CMFCPropertyGridCtrl::SetGroupNameFullWidth	Specifica se visualizzare la larghezza intera del nome della categoria per un gruppo di proprietà nel controllo griglia delle proprietà corrente.
CMFCPropertyGridCtrl::SetListDelimiter	Definisce un carattere che verrà utilizzato come delimitatore in un elenco di valori delle proprietà.
CMFCPropertyGridCtrl::SetShowDragContext	Specifica se il framework ridisegna il nome e le colonne valore del controllo griglia delle proprietà corrente quando un utente ridimensiona le colonne.
CMFCPropertyGridCtrl::SetVSDotNetLook	Imposta l'aspetto del controllo griglia delle proprietà sullo stile usato in VS .NET.
CMFCPropertyGridCtrl::UpdateColor	Imposta il valore del colore della proprietà colore attualmente selezionata.

Metodi protetti

Nome	Descrizione
CMFCPropertyGridCtrl::AdjustLayout	Ridisegna il controllo griglia delle proprietà e le relative proprietà.
CMFCPropertyGridCtrl::CompareProps	Chiamato dal controllo griglia delle proprietà per ordinare le proprietà.
CMFCPropertyGridCtrl::EditItem	Chiamato dal framework quando l'utente inizia a modificare una proprietà.
CMFCPropertyGridCtrl::EndEditItem	Chiamato dal framework quando l'utente smette di modificare una proprietà.
CMFCPropertyGridCtrl::Init	Chiamato dal framework per inizializzare un controllo griglia delle proprietà.
CMFCPropertyGridCtrl::OnChangeSelection	Chiamato dal framework quando viene modificata la selezione corrente.
CMFCPropertyGridCtrl::OnClickButton	Chiamato dal framework quando si fa clic su un pulsante di proprietà.
CMFCPropertyGridCtrl::OnDrawBorder	Chiamato dal framework per disegnare un bordo intorno a un controllo griglia delle proprietà.
CMFCPropertyGridCtrl::OnDrawDescription	Chiamato dal framework per disegnare l'area di descrizione e visualizzare il testo della descrizione.
CMFCPropertyGridCtrl::OnDrawList	Chiamato dal framework per visualizzare l'elenco delle proprietà nel controllo griglia delle proprietà.
CMFCPropertyGridCtrl::OnDrawProperty	Chiamato dal framework per visualizzare una proprietà.
CMFCPropertyGridCtrl::OnPropertyChanged	Chiamato dal framework quando viene modificato il valore di una proprietà.
CMFCPropertyGridCtrl::OnSelectCombo	Chiamato dal framework quando viene selezionata una proprietà che contiene un controllo casella combinata.
CMFCPropertyGridCtrl::ValidateItemData	Chiamato dal framework per convalidare i dati delle proprietà.

Osservazioni:

La CMFCPropertyGridCtrl classe visualizza un controllo griglia delle proprietà che contiene proprietà modificabili derivate dalla CMFCPropertyGridProperty classe . Ogni proprietà può rappresentare un tipo e può contenere elementi secondari. Il controllo griglia delle proprietà supporta un'area ridimensionabile nella parte inferiore che può visualizzare la descrizione di una proprietà selezionata.

Per usare un controllo griglia delle proprietà, costruire un CMFCPropertyGridCtrl oggetto e quindi chiamare il CMFCPropertyGridCtrl::Create metodo . Utilizzare il CMFCPropertyGridCtrl::AddProperty metodo per aggiungere proprietà all'elenco.

Proprietà di selezione

Anziché rappresentare un valore, un elemento della proprietà può avviare una finestra di dialogo che consente all'utente di selezionare un colore, un file o un tipo di carattere.

Nella tabella seguente sono elencati quattro tipi di proprietà di selezione:

Classe	Descrizione
CMFCPropertyGridProperty Classe	Proprietà per utilizzo generico utilizzata per specificare il valore di stringhe, valori booleani, date e così via.
CMFCPropertyGridColorProperty Classe	Proprietà utilizzata per selezionare un valore di colore.
CMFCPropertyGridFileProperty Classe	Proprietà utilizzata per selezionare un file.
CMFCPropertyGridFontProperty Classe	Proprietà utilizzata per selezionare un tipo di carattere.

Illustrazioni

Le illustrazioni seguenti illustrano un controllo griglia delle proprietà che visualizza le proprietà in due modi. La prima illustrazione visualizza le proprietà in modo gerarchico e la seconda visualizza le proprietà in ordine alfabetico.

Esempio

Nell'esempio seguente viene illustrato come configurare un oggetto controllo griglia delle proprietà usando vari metodi nella CMFCPropertyGridCtrl classe . Nell'esempio viene illustrato come abilitare il controllo intestazione, abilitare l'area di descrizione e impostare l'aspetto del controllo griglia delle proprietà. Nell'esempio viene inoltre illustrato come impostare la modalità alfabetica per il controllo in base al quale il controllo ordina tutte le proprietà contenute in base al nome della proprietà e come impostare i colori personalizzati per vari elementi del controllo griglia delle proprietà. Questo esempio fa parte dell'esempio New Controls.This example is part of the New Controls sample.

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();

Gerarchia di ereditarietà

CObject

CCmdTarget

CWnd

CMFCPropertyGridCtrl

Requisiti

Intestazione: afxpropertygridctrl.h

CMFCPropertyGridCtrl::accSelect

virtual HRESULT accSelect(
    long flagsSelect,
    VARIANT varChild);

Parametri

[in] flagsSelect
[in] varChild\

Valore restituito

Osservazioni:

CMFCPropertyGridCtrl::AddProperty

Aggiunge una nuova proprietà a un controllo griglia delle proprietà.

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

Parametri

pProp
[in] Puntatore a una proprietà.

bRedraw
[in] TRUE per ridisegnare immediatamente la proprietà; in caso contrario, FALSE. Il valore predefinito è TRUE.

bAdjustLayout
[in] TRUE per ricalcolare come disegnare il testo e il valore della proprietà e quindi disegnare la proprietà; FALSE per utilizzare calcoli esistenti per disegnare la proprietà. Il valore predefinito è TRUE.

Valore restituito

Se questo metodo ha esito positivo, l'indice in base zero della posizione nel controllo griglia delle proprietà in cui viene aggiunta la proprietà; in caso contrario, -1.

Osservazioni:

Questo metodo aggiunge un puntatore alla proprietà specificata alla fine dell'elenco di proprietà nel controllo griglia delle proprietà. Non distruggere le proprietà o consentire loro di uscire dall'ambito prima che il controllo griglia venga eliminato definitivamente. Al termine del controllo griglia delle proprietà, chiamare CMFCPropertyGridCtrl::RemoveAll per eliminare tutte le proprietà aggiunte. Il metodo AddProperty ha esito negativo se la proprietà specificata è già stata aggiunta all'elenco.

CMFCPropertyGridCtrl::AdjustLayout

Ridisegna il controllo griglia delle proprietà e le relative proprietà.

virtual void AdjustLayout();

Osservazioni:

Questo metodo ricalcola come disegnare l'intero controllo griglia delle proprietà e le relative proprietà, incluse immagini, tipi di carattere e controlli.

CMFCPropertyGridCtrl::AlwaysShowUserToolTip

void AlwaysShowUserToolTip(BOOL bShow = TRUE);

Parametri

[in] bShow\

Osservazioni:

CMFCPropertyGridCtrl::CloseColorPopup

Chiude la finestra di dialogo di selezione dei colori.

virtual void CloseColorPopup();

Osservazioni:

Per altre informazioni sulla finestra di dialogo di selezione dei colori, vedere CMFCPropertyGridColorProperty Classe.

CMFCPropertyGridCtrl::CMFCPropertyGridCtrl

Costruisce un oggetto CMFCPropertyGridCtrl.

CMFCPropertyGridCtrl();

Valore restituito

Osservazioni:

CMFCPropertyGridCtrl::CompareProps

Chiamato dal controllo griglia delle proprietà per ordinare le proprietà.

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

Parametri

pProp1
Puntatore a una proprietà.

pProp2
Puntatore a una proprietà.

Valore restituito

Valore restituito	Descrizione
< 0	Il nome del pProp1 parametro è minore del nome del pProp2 parametro.
0	Il nome del pProp1 parametro è uguale al nome del pProp2 parametro.
> 0	Il nome dell'oggetto pProp1 è maggiore del nome del pProp2 parametro.

Osservazioni:

Per impostazione predefinita, questo metodo usa il CString::Compare metodo per confrontare i CMFCPropertyGridProperty::m_strName membri dei parametri specificati.

CMFCPropertyGridCtrl::Create

Crea un controllo griglia delle proprietà e lo associa all'oggetto controllo griglia delle proprietà.

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

Parametri

dwStyle
[in] Combinazione bit per bit "o" (|) degli stili di finestra.

rect
[in] Rettangolo di delimitazione che specifica le dimensioni e la posizione della finestra, nelle coordinate client di pParentWnd.

pParentWnd
[in] Puntatore alla finestra padre. Non deve essere NULL.

nID
[in] ID della finestra figlio.

Valore restituito

TRUE se la finestra è stata creata correttamente; in caso contrario, FALSE.

Osservazioni:

Per creare un controllo griglia delle proprietà, chiamare CMFCPropertyGridCtrl::CMFCPropertyGridCtrl prima di tutto per costruire un oggetto griglia delle proprietà. Chiamare CMFCPropertyGridCtrl::Createquindi .

Esempio

Nell'esempio seguente viene illustrato come usare il Create metodo nella CMFCPropertyGridCtrl classe . Questo esempio fa parte dell'esempio New Controls.This example is part of the New Controls sample.

// 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

Elimina la proprietà specificata dal controllo griglia delle proprietà.

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

Parametri

pProp
[in] Puntatore a una proprietà.

bRedraw
[in] TRUE per ridisegnare il controllo griglia delle proprietà; in caso contrario, FALSE. Il valore predefinito è TRUE.

bAdjustLayout
[in] TRUE per ricalcolare come disegnare tutto il testo, le immagini e gli elementi nel controllo griglia delle proprietà e quindi disegnare il controllo; in caso contrario, FALSE. Il valore predefinito è TRUE.

Valore restituito

TRUE se questo metodo ha esito positivo; in caso contrario, FALSE.

Osservazioni:

Utilizzare questo metodo per eliminare una proprietà e tutti gli elementi secondari dal controllo griglia delle proprietà.

CMFCPropertyGridCtrl::DrawControlBarColors

BOOL DrawControlBarColors() const;

Valore restituito

Osservazioni:

CMFCPropertyGridCtrl::EditItem

Chiamato dal framework quando l'utente inizia a modificare una proprietà.

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

Parametri

pProp
[in] Puntatore a una proprietà.

lptClick
[in] Il punto nella griglia delle proprietà controlla che l'utente ha fatto clic per avviare l'operazione di modifica. Il punto si trova nelle coordinate client del controllo. Il valore predefinito è NULL.

Valore restituito

TRUE se il metodo ha esito positivo; in caso contrario, FALSE.

Osservazioni:

CMFCPropertyGridCtrl::EnableDescriptionArea

Abilita o disabilita l'area di descrizione visualizzata sotto l'elenco delle proprietà nel controllo griglia delle proprietà.

void EnableDescriptionArea(BOOL bEnable=TRUE);

Parametri

bEnable
[in] TRUE per abilitare l'area di descrizione; FALSE per disabilitare l'area di descrizione. Il valore predefinito è TRUE.

Osservazioni:

L'area della descrizione viene visualizzata nella parte inferiore del controllo griglia delle proprietà. Per impostazione predefinita, l'area della descrizione è disabilitata e non visibile.

CMFCPropertyGridCtrl::EnableHeaderCtrl

Abilita o disabilita il controllo intestazione nella parte superiore del controllo griglia delle proprietà.

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

Parametri

bEnable
[in] TRUE per abilitare il controllo intestazione; FALSE per disabilitare il controllo intestazione. Il valore predefinito è TRUE.

lpszLeftColumn
[in] Titolo della colonna sinistra del controllo intestazione. Il valore predefinito è Property.

lpszRightColumn
[in] Titolo della colonna destra del controllo intestazione. Il valore predefinito è Value.

CMFCPropertyGridCtrl::EndEditItem

Chiamato dal framework quando l'utente termina la modifica di una proprietà.

virtual BOOL EndEditItem(BOOL bUpdateData=TRUE);

Parametri

bUpdateData
[in] TRUE per specificare che i dati delle proprietà modificate devono essere convalidati al termine dell'operazione di modifica; in caso contrario, FALSE. Il valore predefinito è TRUE.

Valore restituito

TRUE se l'operazione di modifica termina correttamente; FALSE se i dati delle proprietà modificate non sono validi o se l'operazione di modifica deve continuare.

Osservazioni:

CMFCPropertyGridCtrl::EnsureVisible

Scorre un controllo griglia di proprietà ed espande gli elementi delle proprietà fino a quando la proprietà specificata non è visibile.

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

Parametri

pProp
[in] Puntatore a una proprietà.

bExpandParents
[in] TRUE per espandere gli elementi padre per rendere visibile la proprietà specificata; in caso contrario, FALSE. Il valore predefinito è FALSE.

Osservazioni:

CMFCPropertyGridCtrl::ExpandAll

Espande o comprime tutti i nodi di controllo della griglia delle proprietà.

void ExpandAll(BOOL bExpand=TRUE);

Parametri

bExpand
[in] TRUE per espandere tutti i nodi; FALSE per comprimere tutti i nodi. Il valore predefinito è TRUE.

Osservazioni:

CMFCPropertyGridCtrl::FindItemByData

Recupera la proprietà associata a un valore definito dall'utente DWORD .

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

Parametri

dwData
[in] Valore DWORD .

bSearchSubItems
[in] TRUE per cercare sottoelementi delle proprietà; in caso contrario, FALSE. Il valore predefinito è TRUE.

Valore restituito

Puntatore all'oggetto proprietà associato se questo metodo ha esito positivo; in caso contrario, NULL.

Osservazioni:

Utilizzare il costruttore o CMFCPropertyGridProperty::SetData il CMFCPropertyGridCtrl::CMFCPropertyGridCtrl metodo per associare un oggetto DWORD a una proprietà .

CMFCPropertyGridCtrl::get_accChildCount

virtual HRESULT get_accChildCount(long* pcountChildren);

Parametri

[in] pcountChildren\

Valore restituito

Osservazioni:

CMFCPropertyGridCtrl::get_accFocus

virtual HRESULT get_accFocus(VARIANT* pvarChild);

Parametri

[in] pvarChild\

Valore restituito

Osservazioni:

CMFCPropertyGridCtrl::get_accHelp

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

Parametri

[in] varChild
[in] pszHelp\

Valore restituito

Osservazioni:

CMFCPropertyGridCtrl::get_accHelpTopic

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

Parametri

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

Valore restituito

Osservazioni:

CMFCPropertyGridCtrl::get_accKeyboardShortcut

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

Parametri

[in] varChild
[in] pszKeyboardShortcut\

Valore restituito

Osservazioni:

CMFCPropertyGridCtrl::get_accSelection

virtual HRESULT get_accSelection(VARIANT* pvarChildren);

Parametri

[in] pvarChildren\

Valore restituito

Osservazioni:

CMFCPropertyGridCtrl::GetBkColor

Recupera il colore di sfondo del controllo griglia delle proprietà corrente.

COLORREF GetBkColor() const;

Valore restituito

Valore di colore RGB.

Osservazioni:

Questo metodo recupera il colore utilizzato dal framework per disegnare lo sfondo del controllo griglia delle proprietà corrente. Il CMFCPropertyGridCtrl::GetTextColor metodo recupera il colore di primo piano.

CMFCPropertyGridCtrl::GetBoldFont

Recupera il tipo di carattere di Windows utilizzato per disegnare testo nel controllo griglia delle proprietà corrente in grassetto.

CFont& GetBoldFont();

Valore restituito

Riferimento a un CFont oggetto che descrive le caratteristiche di un tipo di carattere in grassetto.

CMFCPropertyGridCtrl::GetCurSel

Recupera la proprietà attualmente selezionata.

CMFCPropertyGridProperty* GetCurSel() const;

Valore restituito

Puntatore all'oggetto proprietà che corrisponde all'elemento selezionato nel controllo griglia delle proprietà.

Osservazioni:

CMFCPropertyGridCtrl::GetCustomColors

Recupera i colori personalizzati attualmente definiti per gli elementi di controllo griglia delle proprietà.

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

Parametri

clrBackground
[out] Colore di sfondo dei valori delle proprietà.

clrText
[out] Colore dei nomi delle proprietà e del testo del valore della proprietà.

clrGroupBackground
[out] Colore di sfondo di un gruppo di proprietà.

clrGroupText
[out] Colore del testo nel gruppo di proprietà.

clrDescriptionBackground
[out] Colore di sfondo dell'area della descrizione.

clrDescriptionText
[out] Colore del testo nell'area della descrizione.

clrLine
[out] Colore delle linee disegnate tra le proprietà.

Osservazioni:

Utilizzare il CMFCPropertyGridCtrl::SetCustomColors metodo per impostare colori personalizzati.

CMFCPropertyGridCtrl::GetDescriptionHeight

Recupera l'altezza dell'area di descrizione, che si trova nella parte inferiore del controllo griglia delle proprietà.

int GetDescriptionHeight() const;

Valore restituito

Altezza dell'area della descrizione, in pixel.

Osservazioni:

L'altezza dell'area di descrizione viene calcolata automaticamente e viene impostata su 1/4 l'altezza del controllo griglia delle proprietà.

Utilizzare il CMFCPropertyGridCtrl::EnableDescriptionArea metodo per visualizzare o nascondere l'area della descrizione. Utilizzare il CMFCPropertyGridCtrl::IsDescriptionArea metodo per determinare se l'area della descrizione viene visualizzata o nascosta.

CMFCPropertyGridCtrl::GetDescriptionRows

Recupera il numero di righe nell'area di descrizione del controllo griglia delle proprietà corrente.

int GetDescriptionRows() const;

Valore restituito

Numero di righe nell'area di descrizione del controllo griglia delle proprietà corrente.

Osservazioni:

Il CMFCPropertyGridCtrl::CMFCPropertyGridCtrl costruttore inizializza l'area di descrizione su 3 righe.

CMFCPropertyGridCtrl::GetHeaderCtrl

Recupera l'oggetto interno CMFCHeaderCtrl utilizzato dal framework per visualizzare il controllo griglia delle proprietà corrente.

virtual CMFCHeaderCtrl& GetHeaderCtrl();

Valore restituito

Riferimento a un oggetto CMFCHeaderCtrl.

CMFCPropertyGridCtrl::GetHeaderHeight

Recupera l'altezza dell'intestazione di un controllo griglia delle proprietà.

int GetHeaderHeight() const;

Valore restituito

Altezza dell'intestazione, in pixel.

Osservazioni:

CMFCPropertyGridCtrl::GetLeftColumnWidth

Recupera la larghezza della colonna sinistra del controllo griglia delle proprietà corrente, che contiene il nome di ogni proprietà.

int GetLeftColumnWidth() const;

Valore restituito

Larghezza della colonna del nome.

Osservazioni:

La colonna destra di un controllo griglia delle proprietà contiene il valore di ogni proprietà.

CMFCPropertyGridCtrl::GetListRect

Recupera il rettangolo di delimitazione del controllo griglia delle proprietà.

CRect GetListRect() const;

Valore restituito

Rettangolo di delimitazione del controllo griglia delle proprietà. Questa rectange non include l'area e l'intestazione della descrizione.

Osservazioni:

CMFCPropertyGridCtrl::GetProperty

Recupera un puntatore all'oggetto proprietà che corrisponde all'indice specificato di un elemento in un controllo griglia delle proprietà.

CMFCPropertyGridProperty* GetProperty(int nIndex) const;

Parametri

nIndex
[in] Indice in base zero di un elemento di controllo griglia delle proprietà.

Questo metodo asserisce se il nIndex parametro è minore di zero o maggiore o uguale al numero di proprietà.

Valore restituito

Puntatore all'oggetto proprietà che corrisponde all'indice specificato se questo metodo ha esito positivo; in caso contrario, NULL.

Osservazioni:

CMFCPropertyGridCtrl::GetPropertyColumnWidth

Recupera la larghezza corrente della colonna che contiene i valori delle proprietà.

int GetPropertyColumnWidth() const;

Valore restituito

Larghezza corrente della colonna contenente i valori delle proprietà.

Osservazioni:

La colonna a destra nel controllo griglia delle proprietà contiene i valori delle proprietà. Un cliente può usare la casella di divisione del controllo griglia delle proprietà per modificare la larghezza della colonna dei valori.

CMFCPropertyGridCtrl::GetPropertyCount

Recupera il numero di proprietà in un controllo griglia delle proprietà.

int GetPropertyCount() const;

Valore restituito

Numero di proprietà.

Osservazioni:

CMFCPropertyGridCtrl::GetRowHeight

Recupera l'altezza di una riga nel controllo griglia delle proprietà.

int GetRowHeight() const;

Valore restituito

Altezza di una riga.

Osservazioni:

L'altezza di una riga è uguale all'altezza corrente del carattere più 4 pixel.

CMFCPropertyGridCtrl::GetScrollBarCtrl

Recupera un puntatore al controllo barra di scorrimento nel controllo griglia delle proprietà.

virtual CScrollBar* GetScrollBarCtrl(int nBar) const;

Parametri

nBar
[in] Orientamento della barra di scorrimento, che deve essere SB_VERT.

Valore restituito

Puntatore a un oggetto barra di scorrimento oppure NULL se non è presente alcuna barra di scorrimento o l'orientamento della barra di scorrimento è SB_HORZ.

Osservazioni:

Utilizzare questo metodo per accedere direttamente al controllo barra di scorrimento verticale.

CMFCPropertyGridCtrl::GetTextColor

Recupera il colore utilizzato per disegnare il testo degli elementi della proprietà nel controllo griglia delle proprietà corrente.

COLORREF GetTextColor() const;

Valore restituito

Valore di colore RGB.

Osservazioni:

Questo metodo recupera il colore utilizzato dal framework per disegnare il primo piano del controllo griglia delle proprietà corrente. Il CMFCPropertyGridCtrl::GetBkColor metodo recupera il colore di sfondo.

CMFCPropertyGridCtrl::HitTest

Recupera un puntatore all'oggetto proprietà che corrisponde a un elemento di controllo griglia delle proprietà se un punto specificato si trova nell'elemento. Questo metodo indica anche l'area nel controllo griglia delle proprietà che contiene il punto.

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

Parametri

pt
[in] Punto, nelle coordinate client.

pnArea
[in, out] Puntatore a una ClickArea variabile. Quando termina, la variabile indica l'area della proprietà che contiene il punto specificato. Per altre informazioni su un'area delle proprietà, vedere Osservazioni.

bPropsOnly
[in] TRUE per testare solo l'area delle proprietà; FALSE per testare l'area di descrizione se il punto specificato non si trova nell'area delle proprietà. Il valore predefinito è FALSE. Per altre informazioni sull'area di descrizione, vedere Osservazioni.

Valore restituito

Se il bPropsOnly parametro è TRUE e il punto specificato si trova in un'area di proprietà, il valore restituito è un puntatore all'oggetto proprietà corrispondente. Inoltre, il pnArea parametro viene impostato sull'area specifica che contiene il punto specificato. In caso contrario, il valore restituito è NULL e il pnArea parametro non viene modificato.

Se il bPropsOnly parametro è FALSE, il valore restituito è sempre NULL. Tuttavia, se il punto specificato si trova nell'area della descrizione, il pnArea parametro viene impostato su CMFCPropertyGridProperty::ClickDescription.

Osservazioni:

L'area della proprietà del termine fa riferimento a una qualsiasi area del nome, del valore o della casella di espansione di un elemento di controllo griglia delle proprietà. L'area di descrizione è la zona nella parte inferiore di un controllo griglia delle proprietà. Quando si seleziona un elemento di controllo griglia delle proprietà, l'area della descrizione visualizza una descrizione della proprietà corrispondente.

Questo metodo imposta il valore della variabile a cui punta il pnArea parametro . Nella tabella seguente sono elencati i valori possibili e le aree corrispondenti.

Valore	Area
ClickArea::ClickExpandBox	Controllo Casella di espansione proprietà.
ClickArea::ClickName	Nome della proprietà.
ClickArea::ClickValue	Valore proprietà.
CMFCPropertyGridProperty::ClickDescription	Area di descrizione del controllo griglia delle proprietà.

CMFCPropertyGridCtrl::Init

Chiamato dal framework per inizializzare un controllo griglia delle proprietà.

virtual void Init();

Osservazioni:

CMFCPropertyGridCtrl::InitHeader

Inizializza l'oggetto interno CMFCHeaderCtrl utilizzato dal framework per visualizzare il controllo griglia delle proprietà corrente.

virtual void InitHeader();

CMFCPropertyGridCtrl::IsAlphabeticMode

Indica se un controllo griglia delle proprietà è in modalità alfabetica.

BOOL IsAlphabeticMode() const;

Valore restituito

TRUE se il controllo griglia delle proprietà è in modalità alfabetica; in caso contrario FALSE, .

Osservazioni:

Quando il controllo griglia delle proprietà è in modalità alfabetica, tutte le proprietà vengono ordinate alfabeticamente in base ai nomi. In caso contrario, le proprietà vengono raggruppate sotto i nodi padre.

Usare il metodo per abilitare o disabilitare la CMFCPropertyGridCtrl::SetAlphabeticMode modalità alfabetica.

CMFCPropertyGridCtrl::IsAlwaysShowUserToolTip

BOOL IsAlwaysShowUserToolTip() const;

Valore restituito

Osservazioni:

CMFCPropertyGridCtrl::IsDescriptionArea

Indica se viene visualizzata l'area di descrizione del controllo griglia delle proprietà.

BOOL IsDescriptionArea() const;

Valore restituito

TRUE se viene visualizzata l'area di descrizione; in caso contrario, FALSE.

Osservazioni:

Utilizzare il CMFCPropertyGridCtrl::EnableDescriptionArea metodo per nascondere o visualizzare l'area della descrizione.

CMFCPropertyGridCtrl::IsGroupNameFullWidth

Indica se ogni nome del gruppo di proprietà viene visualizzato nella larghezza del controllo griglia delle proprietà corrente.

BOOL IsGroupNameFullWidth() const;

Valore restituito

TRUE se i nomi dei gruppi vengono visualizzati nella larghezza del controllo griglia delle proprietà; FALSE se i nomi dei gruppi vengono troncati dalla colonna destra (valore) del controllo.

Osservazioni:

Un gruppo è una raccolta di proprietà correlate in un controllo griglia delle proprietà. Se il controllo viene visualizzato in modo gerarchico, il nome del gruppo viene visualizzato come titolo di categoria nella riga sopra il gruppo.

CMFCPropertyGridCtrl::IsHeaderCtrl

Indica se viene visualizzato il controllo intestazione.

BOOL IsHeaderCtrl() const;

Valore restituito

TRUE se viene visualizzato il controllo intestazione; in caso contrario FALSE, .

Osservazioni:

Utilizzare il CMFCPropertyGridCtrl::EnableHeaderCtrl metodo per nascondere o visualizzare il controllo intestazione.

CMFCPropertyGridCtrl::IsMarkModifiedProperties

Indica in che modo il controllo griglia delle proprietà visualizza le proprietà modificate.

BOOL IsMarkModifiedProperties() const;

Valore restituito

TRUE se lo stile grassetto viene utilizzato per visualizzare le proprietà modificate; FALSE se viene utilizzato lo stile regolare per visualizzare le proprietà modificate.

Osservazioni:

CMFCPropertyGridCtrl::IsShowDragContext

Indica se il framework ridisegna il nome e le colonne valore del controllo griglia delle proprietà corrente quando un utente ridimensiona le colonne.

BOOL IsShowDragContext() const;

Valore restituito

TRUE se il framework ridisegna il nome e le colonne valore durante un'operazione di ridimensionamento; FALSE se il framework ridisegna le colonne dopo il completamento dell'operazione di trascinamento.

Osservazioni:

L'utente può ridimensionare il nome e le colonne valore di un controllo griglia delle proprietà trascinando la barra divisa tra le colonne. Se viene visualizzato il contesto di trascinamento, le colonne nome e valore vengono ridimensionate finché l'utente trascina la barra di divisione. In caso contrario, la barra di divisione si sposta ma le colonne non vengono ridisegnate fino al completamento dell'operazione di trascinamento.

CMFCPropertyGridCtrl::IsVSDotNetLook

Indica se l'aspetto del controllo griglia delle proprietà è nello stile di Visual Studio .NET.

BOOL IsVSDotNetLook() const;

Valore restituito

TRUE se il controllo griglia delle proprietà è nello stile di Visual Studio .NET; in caso contrario, FALSE.

Osservazioni:

Usare il CMFCPropertyGridCtrl::SetVSDotNetLook metodo per impostare il controllo griglia delle proprietà sullo stile di Visual Studio .NET.

CMFCPropertyGridCtrl::MarkModifiedProperties

Specifica come visualizzare le proprietà modificate.

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

Parametri

bMark
[in] TRUE per visualizzare le proprietà modificate in grassetto; FALSE per visualizzare le proprietà modificate in stile regolare. Il valore predefinito è TRUE.

bRedraw
[in] TRUE per ridisegnare immediatamente il controllo griglia delle proprietà; in caso contrario, FALSE. Il valore predefinito è TRUE.

Osservazioni:

CMFCPropertyGridCtrl::OnChangeSelection

Chiamato dal framework quando viene modificata la selezione corrente.

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

Parametri

pNewSel
[in] Puntatore alla proprietà appena selezionata.

pOldSel
[in] Puntatore alla proprietà selezionata in precedenza.

Osservazioni:

L'implementazione predefinita di questo metodo non esegue alcuna operazione.

CMFCPropertyGridCtrl::OnClickButton

Chiamato dal framework quando si fa clic su un pulsante di proprietà.

virtual void OnClickButton(CPoint point);

Parametri

point
[in] Punto, nelle coordinate client.

Osservazioni:

Per impostazione predefinita, questo metodo aggiorna il valore della proprietà corrente.

CMFCPropertyGridCtrl::OnDrawBorder

Chiamato dal framework per disegnare un bordo intorno a un controllo griglia delle proprietà.

virtual void OnDrawBorder(CDC* pDC);

Parametri

pDC
[in] Puntatore a un contesto di dispositivo.

Osservazioni:

CMFCPropertyGridCtrl::OnDrawDescription

Chiamato dal framework per disegnare l'area di descrizione e visualizzare il testo della descrizione.

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

Parametri

pDC
[in] Puntatore a un contesto di dispositivo.

rect
[in] Rettangolo che specifica dove disegnare l'area di descrizione.

Osservazioni:

Utilizzare il CMFCPropertyGridCtrl::EnableDescriptionArea metodo per visualizzare l'area di descrizione.

CMFCPropertyGridCtrl::OnDrawList

Chiamato dal framework per visualizzare l'elenco delle proprietà nel controllo griglia delle proprietà.

virtual void OnDrawList(CDC* pDC);

Parametri

pDC
[in] Puntatore a un contesto di dispositivo.

Osservazioni:

CMFCPropertyGridCtrl::OnDrawProperty

Chiamato dal framework per visualizzare una proprietà.

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

Parametri

pDC
[in] Puntatore a un contesto di dispositivo.

pProp
[in] Puntatore a un oggetto proprietà.

Valore restituito

TRUE se questo metodo ha esito positivo; in caso contrario, FALSE.

Osservazioni:

CMFCPropertyGridCtrl::OnPropertyChanged

Chiamato dal framework quando viene modificato il valore di una proprietà.

virtual void OnPropertyChanged(CMFCPropertyGridProperty* pProp) const;

Parametri

pProp
[in] Puntatore a un oggetto proprietà il cui valore è stato modificato.

Osservazioni:

Per impostazione predefinita, questo metodo invia il AFX_WM_PROPERTY_CHANGED messaggio al proprietario del controllo griglia delle proprietà.

CMFCPropertyGridCtrl::OnSelectCombo

Chiamato dal framework quando viene selezionata una proprietà che contiene un controllo casella combinata.

void OnSelectCombo();

Osservazioni:

CMFCPropertyGridCtrl::RemoveAll

Rimuove tutti gli oggetti proprietà da un controllo griglia delle proprietà.

void RemoveAll();

Osservazioni:

CMFCPropertyGridCtrl::ResetOriginalValues

Ripristina i valori originali di tutte le proprietà.

void ResetOriginalValues(BOOL bRedraw=TRUE);

Parametri

bRedraw
[in] TRUE per ridisegnare l'elenco delle proprietà; in caso contrario, FALSE. Il valore predefinito è TRUE.

Osservazioni:

CMFCPropertyGridCtrl::SetAlphabeticMode

Imposta o reimposta la modalità alfabetica.

void SetAlphabeticMode(BOOL bSet=TRUE);

Parametri

bSet
[in] TRUE per impostare la modalità alfabetica; FALSE reimpostare la modalità alfabetica. Il valore predefinito è TRUE.

Osservazioni:

Quando il controllo griglia delle proprietà è in modalità alfabetica, il controllo ordina tutte le proprietà che contiene in base al nome della proprietà.

CMFCPropertyGridCtrl::SetBoolLabels

Specifica il testo delle etichette booleane.

void SetBoolLabels(
    LPCTSTR lpszTrue,
    LPCTSTR lpszFalse);

Parametri

lpszTrue
[in] Stringa di testo da visualizzare per il valore booleano true.

lpszFalse
[in] Stringa di testo da visualizzare per il valore booleano false.

Osservazioni:

CMFCPropertyGridCtrl::SetCurSel

Seleziona una proprietà in un controllo griglia delle proprietà.

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

Parametri

pProp
[in] Puntatore a un oggetto proprietà.

bRedraw
[in] TRUE per ridisegnare immediatamente il controllo griglia delle proprietà; in caso contrario, FALSE. Il valore predefinito è TRUE.

Osservazioni:

Utilizzare questo metodo per annullare la selezione dell'elemento corrente nel controllo griglia delle proprietà e quindi selezionare l'elemento corrispondente alla proprietà specificata.

CMFCPropertyGridCtrl::SetCustomColors

Specifica i colori personalizzati per vari elementi del controllo griglia delle proprietà.

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

Parametri

clrBackground
[in] Colore di sfondo dei valori delle proprietà.

clrText
[in] Colore dei nomi delle proprietà e del testo del valore della proprietà.

clrGroupBackground
[in] Colore di sfondo di un gruppo di proprietà.

clrGroupText
[in] Nuovo colore del testo del gruppo di proprietà.

clrDescriptionBackground
[in] Colore di sfondo dell'area della descrizione.

clrDescriptionText
[in] Colore del testo nell'area della descrizione.

clrLine
[in] Colore delle linee disegnate tra le proprietà.

Osservazioni:

Per qualsiasi parametro, specificare il valore del ((COLORREF)-1) colore per utilizzare il colore predefinito per l'elemento del controllo griglia delle proprietà.

Per personalizzare l'aspetto di una proprietà specifica, derivare una classe dalla CMFCPropertyGridProperty classe e quindi eseguire l'override dei CMFCPropertyGridProperty::OnDrawNamemetodi , CMFCPropertyGridProperty::OnDrawValueCMFCPropertyGridProperty::OnDrawExpandBox, e CMFCPropertyGridProperty::OnDrawButton .

CMFCPropertyGridCtrl::SetDescriptionRows

Specifica il numero di righe da visualizzare nella sezione descrizione del controllo griglia delle proprietà corrente.

void SetDescriptionRows(int nDescRows);

Parametri

nDescRows
[in] Numero di righe da visualizzare nella descrizione della proprietà.

CMFCPropertyGridCtrl::SetGroupNameFullWidth

Specifica se visualizzare la larghezza intera del nome della categoria per un gruppo di proprietà nel controllo griglia delle proprietà corrente.

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

Parametri

bGroupNameFullWidth
[in] TRUE per visualizzare la larghezza completa del nome della categoria indipendentemente dalla larghezza della colonna del nome della proprietà. FALSE per limitare la larghezza del nome della categoria alla larghezza della colonna del nome della proprietà. Il valore predefinito è TRUE.

bRedraw
[in] TRUE per aggiornare immediatamente il controllo griglia delle proprietà; FALSE per aggiornare il controllo quando si verifica l'evento di ridisegno successivo. Il valore predefinito è TRUE.

Osservazioni:

Il controllo griglia delle proprietà è costituito da una colonna nome proprietà ridimensionabile e una colonna del valore della proprietà. La fine della colonna name è anche l'inizio della colonna del valore. Per ridimensionare le colonne, trascinare il bordo tra le colonne.

I termini nome del gruppo e nome di categoria vengono usati in modo intercambiabile in questo metodo. Il nome della categoria viene visualizzato in una riga che testa un set di proprietà e valori correlati. Questo metodo specifica se la larghezza della colonna del nome della proprietà specifica anche la larghezza del nome della categoria visualizzata.

CMFCPropertyGridCtrl::SetListDelimiter

Definisce un carattere utilizzato come delimitatore in un elenco di valori di proprietà.

void SetListDelimiter(TCHAR c);

Parametri

c
[in] Carattere da usare come delimitatore.

Osservazioni:

Utilizzare questo metodo per definire un carattere delimitatore in un elenco di valori di proprietà utilizzati nel CMFCPropertyGridProperty::CMFCPropertyGridProperty costruttore. In tale costruttore impostare il bIsValueList parametro su TRUE.

Per impostazione predefinita, il CMFCPropertyGridCtrl::CMFCPropertyGridCtrl costruttore imposta il carattere delimitatore su virgola (',').

CMFCPropertyGridCtrl::SetShowDragContext

Specifica se il framework ridisegna il nome e le colonne valore del controllo griglia delle proprietà corrente quando un utente ridimensiona le colonne.

void SetShowDragContext(BOOL bShowDragContext = TRUE);

Parametri

bShowDragContext
[in] TRUE per ridisegnare il nome e le colonne di valore durante un'operazione di ridimensionamento; FALSE per ridisegnare le colonne al termine dell'operazione di trascinamento. Il valore predefinito è TRUE.

Osservazioni:

L'utente può ridimensionare il nome e le colonne valore di un controllo griglia delle proprietà trascinando la barra divisa tra le colonne. Se viene visualizzato il contesto di trascinamento, le colonne nome e valore vengono ridimensionate finché l'utente trascina la barra di divisione. In caso contrario, la barra di divisione si sposta ma le colonne non vengono ridisegnate fino al completamento dell'operazione di trascinamento.

CMFCPropertyGridCtrl::SetVSDotNetLook

Imposta l'aspetto del controllo griglia delle proprietà sullo stile usato in Visual Studio .NET.

void SetVSDotNetLook(BOOL bSet=TRUE);

Parametri

bSet
[in] TRUE per impostare il controllo griglia delle proprietà sullo stile usato in Visual Studio .NET; in caso contrario, FALSE. Il valore predefinito è TRUE.

Osservazioni:

CMFCPropertyGridCtrl::UpdateColor

Imposta il valore del colore della proprietà colore attualmente selezionata.

virtual void UpdateColor(COLORREF color);

Parametri

color
[in] Valore di colore RGB.

Osservazioni:

Questo metodo asserisce in modalità di debug se la proprietà attualmente selezionata del controllo griglia delle proprietà non è una proprietà color.

CMFCPropertyGridCtrl::ValidateItemData

Chiamato dal framework per convalidare i dati delle proprietà.

virtual BOOL ValidateItemData(CMFCPropertyGridProperty* pProp);

Parametri

pProp
[in] Puntatore a una proprietà. Questo parametro non viene usato.

Valore restituito

Sempre TRUE.

Osservazioni:

Il CMFCPropertyGridCtrl::EndEditItem metodo chiama questo metodo per convalidare i dati. Per impostazione predefinita, questo metodo non usa il pProp parametro e il relativo valore restituito è sempre TRUE.

Se si esegue l'override di questo metodo, restituire TRUE se i dati della proprietà specificati sono validi. In caso contrario, restituire FALSE, nel qual caso il framework non aggiorna la proprietà .

Vedi anche

Grafico della gerarchia
Classi