Classe di CMFCPropertyGridCtrl

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

Bb983759.collapse_all(it-it,VS.110).gifCostruttori pubblici

Nome

Descrizione

CMFCPropertyGridCtrl::CMFCPropertyGridCtrl

Costruisce un oggetto CMFCPropertyGridCtrl.

CMFCPropertyGridCtrl::~CMFCPropertyGridCtrl

Distruttore

Bb983759.collapse_all(it-it,VS.110).gifMetodi 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.

Bb983759.collapse_all(it-it,VS.110).gifMetodi 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();

Gerarchia di ereditarietà

CObject

   CCmdTarget

      CWnd

         CMFCPropertyGridCtrl

Requisiti

intestazione: afxpropertygridctrl.h

Vedere anche

Riferimenti

Grafico della gerarchia

Altre risorse

Classi MFC