Classe di CMFCPropertyGridCtrl

Articolo
02/19/2013

Questo argomento è incluso per motivi di completezza. Per informazioni dettagliate, vedere il codice sorgente disponibile nella cartella VC\atlmfc\src\mfc dell'installazione di Visual Studio.

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

class CMFCPropertyGridCtrl : public CWnd

Membri

Costruttori pubblici

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

Metodi pubblici

Nome	Descrizione
CMFCPropertyGridCtrl::accHitTest	Chiamato dal framework per recuperare l'elemento figlio o l'oggetto figlio in un determinato punto dello schermo.(Override CWnd::accHitTest).
CMFCPropertyGridCtrl::accLocation	Chiamato dal framework per recuperare la posizione corrente dello schermo dell'oggetto specificato.(Override CWnd::accLocation).
CMFCPropertyGridCtrl::accSelect	Chiamato dal framework per modificare la selezione o spostare lo stato attivo dell'oggetto specificato.(Override CWnd::accSelect).
CMFCPropertyGridCtrl::AddProperty	Aggiunge una nuova proprietà a un controllo griglia delle proprietà.
CMFCPropertyGridCtrl::AlwaysShowUserToolTip
CMFCPropertyGridCtrl::CloseColorPopup	Chiudere la finestra di dialogo di selezione di colori.
CMFCPropertyGridCtrl::Create	Crea un controllo griglia delle proprietà e lo aggiunge all'oggetto del 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 visualizzati sotto l'elenco delle proprietà.
CMFCPropertyGridCtrl::EnableHeaderCtrl	Abilita o disabilita il controllo intestazione all'inizio del controllo griglia delle proprietà.
CMFCPropertyGridCtrl::EnsureVisible	Scorre un controllo griglia delle proprietà ed espandere gli elementi della proprietà che la proprietà specificata non sia visibile.
CMFCPropertyGridCtrl::ExpandAll	Espandere o comprimere tutti i nodi del controllo griglia delle proprietà.
CMFCPropertyGridCtrl::FindItemByData	Recupera la proprietà associata a un valore definito dall'utente DWORD.
CMFCPropertyGridCtrl::get_accChild	Chiamato dal framework per recuperare l'indirizzo di un'interfaccia IDispatch per il figlio specificato.(Override CWnd::get_accChild).
CMFCPropertyGridCtrl::get_accChildCount	Chiamato dal framework per recuperare il numero di elementi figlio che appartengono a questo oggetto.(Override CWnd::get_accChildCount).
CMFCPropertyGridCtrl::get_accDefaultAction	Chiamato dal framework per recuperare una stringa che descrive l'azione predefinita dell'oggetto.(Override CWnd::get_accDefaultAction).
CMFCPropertyGridCtrl::get_accDescription	Chiamato dal framework per recuperare una stringa che descrive l'aspetto visivo dell'oggetto specificato.(Override CWnd::get_accDescription).
CMFCPropertyGridCtrl::get_accFocus	Chiamato dal framework per recuperare l'oggetto che ha lo stato attivo.(Override CWnd::get_accFocus).
CMFCPropertyGridCtrl::get_accHelp	Chiamato dal framework per recuperare la stringa della proprietà Help di un oggetto.(Override CWnd::get_accHelp).
CMFCPropertyGridCtrl::get_accHelpTopic	Chiamato dal framework per recuperare il percorso completo del file WinHelpassociato all'oggetto specificato e l'identificatore dell'argomento appropriato all'interno del file.(Override CWnd::get_accHelpTopic).
CMFCPropertyGridCtrl::get_accKeyboardShortcut	Chiamato dal framework per recuperare il tasto di scelta rapida o il tasto di scelta dell'oggetto specificato.(Override CWnd::get_accKeyboardShortcut).
CMFCPropertyGridCtrl::get_accName	Chiamato dal framework per recuperare il nome dell'oggetto specificato.(Override CWnd::get_accName).
CMFCPropertyGridCtrl::get_accRole	Chiamato dal framework per recuperare informazioni che descrivono il ruolo dell'oggetto specificato.(Override CWnd::get_accRole).
CMFCPropertyGridCtrl::get_accSelection	Chiamato dal framework per recupero di elementi selezionati di questo oggetto.(Override CWnd::get_accSelection).
CMFCPropertyGridCtrl::get_accState	Chiamato dal framework per recuperare lo stato corrente dell'oggetto specificato.(Override CWnd::get_accState).
CMFCPropertyGridCtrl::get_accValue	Chiamato dal framework per recuperare il valore dell'oggetto specificato.(Override CWnd::get_accValue).
CMFCPropertyGridCtrl::GetBkColor	Recupera il colore di sfondo del controllo griglia corrente della proprietà.
CMFCPropertyGridCtrl::GetBoldFont	Recupera il tipo di Windows che di testo nel controllo griglia corrente della proprietà dello stile grassetto.
CMFCPropertyGridCtrl::GetCurSel	Recupera la proprietà selezionata.
CMFCPropertyGridCtrl::GetCustomColors	Recupera i colori personalizzati che attualmente definiti per gli elementi di controllo griglia delle proprietà.
CMFCPropertyGridCtrl::GetDescriptionHeight	Recupera l'altezza dell'area di descrizione ha individuato nella parte inferiore del controllo griglia delle proprietà.
CMFCPropertyGridCtrl::GetDescriptionRows	Recupera il numero di righe dell'area di descrizione del controllo griglia corrente della proprietà.
CMFCPropertyGridCtrl::GetHeaderCtrl	Recupera l'oggetto interno CMFCHeaderCtrl che il framework per visualizzare il controllo griglia corrente della proprietà.
CMFCPropertyGridCtrl::GetHeaderHeight	Recupera l'altezza dell'intestazione del controllo griglia delle proprietà.
CMFCPropertyGridCtrl::GetLeftColumnWidth	Recupera la larghezza della colonna sinistra del controllo griglia corrente della proprietà, 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 della proprietà che corrisponde all'indice specificato di un elemento del controllo griglia delle proprietà.
CMFCPropertyGridCtrl::GetPropertyColumnWidth	Recupera la larghezza della colonna corrente contenente i valori della proprietà.
CMFCPropertyGridCtrl::GetPropertyCount	Recupera il numero di proprietà in un controllo griglia delle proprietà.
CMFCPropertyGridCtrl::GetRowHeight	Recupera l'altezza di una riga del controllo griglia delle proprietà.
CMFCPropertyGridCtrl::GetScrollBarCtrl	Recupera un puntatore al controllo barra di scorrimento nel controllo griglia delle proprietà.(Override CWnd::GetScrollBarCtrl).
CMFCPropertyGridCtrl::GetTextColor	Recupera il colore del testo degli elementi della proprietà nel controllo griglia corrente della proprietà.
CMFCPropertyGridCtrl::GetThisClass	Utilizzato dal framework per ottenere un puntatore all'oggetto CRuntimeClass associato a questo tipo della classe.
CMFCPropertyGridCtrl::HitTest	Recupera un puntatore all'oggetto della proprietà che corrisponde a un elemento del controllo griglia delle proprietà se un punto specificato consiste nell'elemento.Questo metodo indica l'area nel controllo griglia delle proprietà che contiene il punto.
CMFCPropertyGridCtrl::InitHeader	Inizializza l'oggetto interno CMFCHeaderCtrl che il framework per visualizzare il controllo griglia corrente della proprietà.
CMFCPropertyGridCtrl::IsAlphabeticMode	Indica se un controllo griglia della proprietà è in modalità alfabetico.
CMFCPropertyGridCtrl::IsAlwaysShowUserToolTip
CMFCPropertyGridCtrl::IsDescriptionArea	Indica se l'area di descrizione del controllo griglia della proprietà di.
CMFCPropertyGridCtrl::IsGroupNameFullWidth	Indica se ogni nome di un gruppo di proprietà visualizzato tramite la larghezza del controllo griglia corrente della proprietà.
CMFCPropertyGridCtrl::IsHeaderCtrl	Indica se il controllo intestazione visualizzato.
CMFCPropertyGridCtrl::IsMarkModifiedProperties	Indica come il controllo griglia delle proprietà vengono visualizzate le proprietà modificate.
CMFCPropertyGridCtrl::IsShowDragContext	Indica se il framework ridisegna il nome e le colonne di valori di controllo grid corrente della proprietà quando l'utente ridimensiona le colonne.
CMFCPropertyGridCtrl::IsVSDotNetLook	Indica se l'aspetto del controllo griglia delle proprietà dello stile è utilizzato da FAR il .NET.
CMFCPropertyGridCtrl::MarkModifiedProperties	Specifica come visualizzare le proprietà modificate.
CMFCPropertyGridCtrl::PreTranslateMessage	Utilizzato da CWinApp classe per convertire i messaggi della finestra prima che vengano inviati alle funzioni Windows DispatchMessage e TranslateMessage.(Override CWnd::PreTranslateMessage).
CMFCPropertyGridCtrl::RemoveAll	Rimuove tutti gli oggetti della proprietà da un controllo griglia delle proprietà.
CMFCPropertyGridCtrl::ResetOriginalValues	È possibile ripristinare il valore originale di tutte le proprietà.
CMFCPropertyGridCtrl::SetAlphabeticMode	Imposta la modalità o alfabetico di reimpostato.
CMFCPropertyGridCtrl::SetBoolLabels	Specifica il testo delle etichette booleane.
CMFCPropertyGridCtrl::SetCurSel	Selezionare una proprietà in un controllo griglia delle proprietà.
CMFCPropertyGridCtrl::SetCustomColors	Specifica i colori personalizzati per diversi elementi di controllo griglia delle proprietà.
CMFCPropertyGridCtrl::SetDescriptionRows	Specifica il numero di righe da visualizzare nella sezione descrizione del controllo griglia corrente della proprietà.
CMFCPropertyGridCtrl::SetGroupNameFullWidth	Specifica se visualizzare la larghezza intera il nome della categoria per un gruppo di proprietà nel controllo griglia corrente della proprietà.
CMFCPropertyGridCtrl::SetListDelimiter	Definisce un carattere che verrà utilizzato come delimitatore in un elenco di valori di proprietà.
CMFCPropertyGridCtrl::SetShowDragContext	Specifica se il framework ridisegna il nome e le colonne di valori di controllo grid corrente della proprietà quando l'utente ridimensiona le colonne.
CMFCPropertyGridCtrl::SetVSDotNetLook	Imposta l'aspetto del controllo griglia della proprietà sullo stile è utilizzato in VS il .NET.
CMFCPropertyGridCtrl::UpdateColor	Imposta il valore del colore della proprietà color 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 per 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 la selezione corrente viene modificata.
CMFCPropertyGridCtrl::OnClickButton	Chiamato dal framework quando un pulsante della proprietà è fatto clic.
CMFCPropertyGridCtrl::OnDrawBorder	Chiamato dal framework per creare un bordo intorno al controllo griglia delle proprietà.
CMFCPropertyGridCtrl::OnDrawDescription	Chiamato dal framework per disegnare l'area di descrizione e visualizzare il testo di 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 il valore di una proprietà viene modificato.
CMFCPropertyGridCtrl::OnSelectCombo	Chiamato dal framework quando una proprietà contenente un controllo casella combinata viene selezionata.
CMFCPropertyGridCtrl::ValidateItemData	Chiamato dal framework per convalidare i dati della proprietà.

Note

Le visualizzazioni di classe CMFCPropertyGridCtrl un controllo griglia delle proprietà che contiene le proprietà modificabili derivate dalla classe CMFCPropertyGridProperty.Ogni proprietà può rappresentare un tipo e può contenere elementi secondari.Il controllo griglia della proprietà supporta un'area ridimensionabile alla fine che può visualizzare la descrizione di una proprietà selezionata.

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

Proprietà di selezione

Anziché la rappresentazione del valore, un elemento proprietà può avviare una finestra di dialogo che consente all'utente di selezionare un colore, un file, oppure un tipo di carattere.

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

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

Illustrazioni

Le seguenti illustrazioni rappresenta un controllo griglia delle proprietà tale proprietà presenti in due modi.La prima figura visualizzazione gerarchica in ordine alfabetico le proprietà e nel secondo proprietà delle visualizzazioni.

Elenco di proprietà PropertySheet

Esempio

Nell'esempio seguente viene illustrato come configurare un oggetto controllo griglia delle proprietà utilizzando i diversi metodi nella classe CMFCPropertyGridCtrl.Nell'esempio viene illustrato come abilitare il controllo intestazione, consente all'area di descrizione e imposta l'aspetto del controllo griglia delle proprietà.Nell'esempio viene inoltre illustrato come impostare la modalità alfabetico per il controllo a cui il controllo ordina tutte le proprietà che contiene il relativo nome proprietà e come impostare colori personalizzati per diversi elementi del controllo griglia delle proprietà.Questo esempio fa parte Nuovo esempio di controlli.

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