Classe CMFCPropertyGridProperty

Un CMFCPropertyGridProperty oggetto rappresenta una voce di elenco in un controllo elenco di proprietà.

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.

Sintassi

class CMFCPropertyGridProperty : public CObject

Membri

Costruttori pubblici

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

Metodi pubblici

Nome	Descrizione
CMFCPropertyGridProperty::AddOption	Aggiunge una nuova voce di elenco a un controllo elenco di proprietà.
CMFCPropertyGridProperty::AddSubItem	Aggiunge un elemento figlio a una proprietà .
CMFCPropertyGridProperty::AdjustButtonRect	Chiamato dal controllo elenco proprietà padre per indicare a una proprietà di ridimensionare il rettangolo di delimitazione di un pulsante incorporato.
CMFCPropertyGridProperty::AdjustInPlaceEditRect	Recupera i limiti della casella di testo e il controllo pulsante di selezione facoltativo utilizzati per impostare un valore della proprietà.
CMFCPropertyGridProperty::AllowEdit	Rende una proprietà modificabile o di sola lettura.
CMFCPropertyGridProperty::CreateInPlaceEdit	Chiamato dal framework per creare un controllo modificabile per una proprietà.
CMFCPropertyGridProperty::CreateSpinControl	Chiamato dal framework per creare un controllo pulsante di selezione modificabile.
CMFCPropertyGridProperty::Enable	Abilita o disabilita una proprietà.
CMFCPropertyGridProperty::EnableSpinControl	Abilita o disabilita un controllo pulsante di selezione utilizzato per modificare un valore della proprietà.
CMFCPropertyGridProperty::Expand	Espande o comprime una proprietà che contiene proprietà secondarie.
CMFCPropertyGridProperty::FormatProperty	Formatta la rappresentazione di testo di un valore della proprietà.
CMFCPropertyGridProperty::GetData	Recupera un valore DWORD associato a una proprietà .
CMFCPropertyGridProperty::GetDescription	Recupera una descrizione della proprietà.
CMFCPropertyGridProperty::GetExpandedSubItems	Recupera il numero di elementi secondari espansi.
CMFCPropertyGridProperty::GetHierarchyLevel	Recupera l'indice in base zero del livello della gerarchia della proprietà.
CMFCPropertyGridProperty::GetName	Recupera il nome della proprietà.
CMFCPropertyGridProperty::GetNameTooltip	Chiamato dal framework per visualizzare il nome della proprietà in una descrizione comando.
CMFCPropertyGridProperty::GetOption	Recupera il testo dell'opzione specificata da un indice.
CMFCPropertyGridProperty::GetOptionCount	Recupera il numero di opzioni che appartengono a una proprietà.
CMFCPropertyGridProperty::GetOriginalValue	Recupera il valore iniziale della proprietà corrente.
CMFCPropertyGridProperty::GetParent	Recupera un puntatore a una proprietà padre.
CMFCPropertyGridProperty::GetRect	Recupera il rettangolo di delimitazione di una proprietà.
CMFCPropertyGridProperty::GetSubItem	Recupera una sottoproperty identificata da un indice in base zero.
CMFCPropertyGridProperty::GetSubItemsCount	Recupera il numero di elementi secondari.
CMFCPropertyGridProperty::GetThisClass	Utilizzato dal framework per ottenere un puntatore all'oggetto CRuntimeClass associato a questo tipo di classe.
CMFCPropertyGridProperty::GetValue	Recupera un valore della proprietà.
CMFCPropertyGridProperty::GetValueTooltip	Chiamato dal framework per recuperare la rappresentazione testuale del valore della proprietà che viene quindi visualizzato in una descrizione comando.
CMFCPropertyGridProperty::HitTest	Punta all'oggetto proprietà che corrisponde all'elemento dell'elenco delle proprietà che corrisponde a un punto.
CMFCPropertyGridProperty::IsAllowEdit	Indica se una proprietà è modificabile.
CMFCPropertyGridProperty::IsEnabled	Indica se una proprietà è abilitata o disabilitata.
CMFCPropertyGridProperty::IsExpanded	Indica se una proprietà è espansa o compressa.
CMFCPropertyGridProperty::IsGroup	Indica se la proprietà corrente rappresenta un gruppo.
CMFCPropertyGridProperty::IsInPlaceEditing	Indica se la proprietà corrente è modificabile.
CMFCPropertyGridProperty::IsModified	Indica se la proprietà corrente viene modificata.
CMFCPropertyGridProperty::IsParentExpanded	Indica se gli elementi padre della proprietà corrente vengono espansi.
CMFCPropertyGridProperty::IsSelected	Indica se la proprietà corrente è selezionata.
CMFCPropertyGridProperty::IsVisible	Indica se la proprietà corrente è visibile.
CMFCPropertyGridProperty::OnClickButton	Chiamato dal framework quando l'utente seleziona un pulsante contenuto in una proprietà.
CMFCPropertyGridProperty::OnClickName	Chiamato da un controllo elenco di proprietà padre quando un utente seleziona il campo nome di una proprietà.
CMFCPropertyGridProperty::OnClickValue	Chiamato da un controllo elenco di proprietà padre quando un utente seleziona il campo valore di una proprietà.
CMFCPropertyGridProperty::OnCloseCombo	Chiamato dal framework quando una casella combinata contenuta in una proprietà viene chiusa.
CMFCPropertyGridProperty::OnDblClk	Chiamato dal framework quando l'utente fa doppio clic su una proprietà.
CMFCPropertyGridProperty::OnDrawButton	Chiamato dal framework per disegnare un pulsante contenuto in una proprietà .
CMFCPropertyGridProperty::OnDrawDescription	Chiamato dal framework per visualizzare la descrizione della proprietà.
CMFCPropertyGridProperty::OnDrawExpandBox	Chiamato dal framework per disegnare un controllo casella di espansione vicino a una proprietà che contiene proprietà secondarie.
CMFCPropertyGridProperty::OnDrawName	Chiamato dal framework per visualizzare il nome della proprietà.
CMFCPropertyGridProperty::OnDrawValue	Chiamato dal framework per visualizzare il valore della proprietà.
CMFCPropertyGridProperty::OnEdit	Chiamato dal framework quando l'utente sta per modificare il valore di una proprietà.
CMFCPropertyGridProperty::OnEndEdit	Chiamato dal framework al termine della modifica del valore di una proprietà.
CMFCPropertyGridProperty::OnKillSelection
CMFCPropertyGridProperty::OnPosSizeChanged
CMFCPropertyGridProperty::OnRClickName	Chiamato dal framework quando l'utente seleziona il pulsante destro del mouse nell'area del nome della proprietà.
CMFCPropertyGridProperty::OnRClickValue	Chiamato dal framework quando l'utente seleziona il pulsante destro del mouse nell'area del valore della proprietà.
CMFCPropertyGridProperty::OnSelectCombo	Chiamato dal framework quando l'utente seleziona un elemento dalla casella combinata modificabile.
CMFCPropertyGridProperty::OnSetCursor	Chiamato dal framework quando il puntatore del mouse passa a un elemento della proprietà.
CMFCPropertyGridProperty::OnSetSelection
CMFCPropertyGridProperty::OnUpdateValue	Chiamato dal framework quando viene modificato il valore di una proprietà modificabile.
CMFCPropertyGridProperty::PushChar	Chiamato dal controllo elenco di proprietà quando la proprietà è selezionata e l'utente immette un nuovo carattere.
CMFCPropertyGridProperty::Redraw	Ridisegna la proprietà .
CMFCPropertyGridProperty::RemoveAllOptions	Rimuove tutte le opzioni (elementi) da una proprietà.
CMFCPropertyGridProperty::RemoveSubItem	Rimuove l'elemento secondario specificato.
CMFCPropertyGridProperty::ResetOriginalValue	Ripristina il valore originale di una proprietà modificata.
CMFCPropertyGridProperty::SetData	Associa un valore DWORD a una proprietà .
CMFCPropertyGridProperty::SetDescription	Specifica il testo che descrive la proprietà corrente.
CMFCPropertyGridProperty::SetName	Imposta il nome di una proprietà.
CMFCPropertyGridProperty::SetOriginalValue	Imposta il valore originale di una proprietà modificabile.
CMFCPropertyGridProperty::SetValue	Imposta il valore di una proprietà della griglia delle proprietà.
CMFCPropertyGridProperty::Show	Mostra o nasconde una proprietà.

Metodi protetti

Nome	Descrizione
CMFCPropertyGridProperty::CreateCombo	Chiamato dal framework per aggiungere una casella combinata a una proprietà.
CMFCPropertyGridProperty::HasButton	Indica se una proprietà contiene un pulsante.
CMFCPropertyGridProperty::Init	Chiamato dal framework per inizializzare un oggetto proprietà.
CMFCPropertyGridProperty::IsSubItem	Indica se la proprietà specificata è un elemento secondario della proprietà corrente.
CMFCPropertyGridProperty::IsValueChanged	Indica se il valore della proprietà corrente è stato modificato.
CMFCPropertyGridProperty::OnCtlColor	Chiamato dal framework quando deve recuperare un pennello per riempire il colore di sfondo di una proprietà.
CMFCPropertyGridProperty::OnDestroyWindow	Chiamato dal framework quando una proprietà viene eliminata definitivamente o al termine della modifica.
CMFCPropertyGridProperty::OnKillFocus	Chiamato dal framework quando la proprietà perde lo stato attivo dell'input.

Membri dei dati

Nome	Descrizione
CMFCPropertyGridProperty::m_strFormatDouble	Stringa di formato per un valore di tipo double.
CMFCPropertyGridProperty::m_strFormatFloat	Stringa di formato per un valore di tipo float.
CMFCPropertyGridProperty::m_strFormatLong	Stringa di formato per un valore di tipo long.
CMFCPropertyGridProperty::m_strFormatShort	Stringa di formato per un valore di tipo short.

Osservazioni:

Utilizzare un CMFCPropertyGridProperty oggetto per rappresentare una proprietà, che viene quindi aggiunta a un controllo elenco di proprietà. Per altre informazioni, vedere CMFCPropertyGridCtrl Classe.

Un oggetto proprietà può rappresentare tipi di dati come stringhe, date e valori booleani o interi. Può contenere proprietà figlio oppure può contenere un controllo, ad esempio una casella combinata o un controllo pulsante.

Esempio

Nell'esempio seguente viene illustrato come costruire un CMFCPropertyGridProperty oggetto . Nell'esempio viene inoltre illustrato come usare vari metodi nella CMFCPropertyGridProperty classe per aggiungere un'opzione, aggiungere un elemento secondario, abilitare una proprietà e mostrare una proprietà. Questo esempio fa parte dell'esempio New Controls.This example is part of the New Controls sample.

CMFCPropertyGridProperty *pGroup1 = new CMFCPropertyGridProperty(_T("Appearance"));

// construct a COleVariant object.
COleVariant var3DLook((short)VARIANT_FALSE, VT_BOOL);

pGroup1->AddSubItem(new CMFCPropertyGridProperty(_T("3D Look"), var3DLook,
                                                 _T("Specifies the dialog's font will be nonbold and controls will have a 3D border")));

CMFCPropertyGridProperty *pProp = new CMFCPropertyGridProperty(_T("Border"),
                                                               _T("Dialog Frame"), _T("One of: None, Thin, Resizable, or Dialog Frame"));
pProp->AddOption(_T("None"));
pProp->AddOption(_T("Thin"));
pProp->AddOption(_T("Resizable"));
pProp->AddOption(_T("Dialog Frame"));
pProp->AllowEdit(FALSE);

pGroup1->AddSubItem(pProp);
pGroup1->AddSubItem(new CMFCPropertyGridProperty(_T("Caption"), (COleVariant) _T("About NewControlsDemo"), _T("Specifies the text that will be displayed in the dialog's title bar")));
pGroup1->AdjustButtonRect();
pGroup1->AllowEdit();
pGroup1->Enable();
pGroup1->Show();
pGroup1->Redraw();

Gerarchia di ereditarietà

CObject

CMFCPropertyGridProperty

Requisiti

Intestazione: afxpropertygridctrl.h

CMFCPropertyGridProperty::AddOption

Aggiunge una nuova voce di elenco a un controllo elenco di proprietà.

BOOL AddOption(
    LPCTSTR lpszOption,
    BOOL bInsertUnique=TRUE);

Parametri

lpszOption
[in] Voce di elenco (opzione) da aggiungere.

bInsertUnique
[in] TRUE per aggiungere la voce di elenco solo se non esiste già; in caso contrario, FALSE. Il valore predefinito è TRUE.

Valore restituito

TRUE, il che significa che l'elemento dell'elenco viene aggiunto. In caso contrario, FALSE, il che significa che l'elemento dell'elenco non viene aggiunto perché il bInsertUnique parametro è TRUE e l'elemento di elenco specificato dal lpszOption parametro esiste già.

CMFCPropertyGridProperty::AddSubItem

Aggiunge un elemento figlio a una proprietà .

BOOL AddSubItem(CMFCPropertyGridProperty* pProp);

Parametri

pProp
[in] Puntatore a una proprietà da aggiungere.

Valore restituito

TRUE se la proprietà specificata viene aggiunta correttamente come proprietà figlio. FALSE se la proprietà non viene aggiunta perché si verifica già nella proprietà padre.

Osservazioni:

Utilizzare questo metodo per creare un elenco gerarchico di proprietà padre e figlio. Dopo l'aggiunta di una proprietà figlio, la proprietà padre visualizza automaticamente un controllo casella di espansione designato da un segno più (+). Quando l'utente seleziona il segno più, la proprietà padre si espande e visualizza tutti gli elementi delle proprietà figlio.

CMFCPropertyGridProperty::AdjustButtonRect

Chiamato dal controllo elenco proprietà padre per indicare a una proprietà di ridimensionare il rettangolo di delimitazione di un pulsante incorporato.

virtual void AdjustButtonRect();

Osservazioni:

Per impostazione predefinita, questo metodo:

• Regola la larghezza del pulsante uguale all'altezza del pulsante più tre pixel.
• Sposta il rettangolo di delimitazione del pulsante sul bordo destro della proprietà.
• Sposta il pulsante 1 pixel sotto il bordo superiore della proprietà.

CMFCPropertyGridProperty::AdjustInPlaceEditRect

Recupera i limiti della casella di testo e il controllo pulsante di selezione facoltativo utilizzati per impostare un valore della proprietà.

virtual void AdjustInPlaceEditRect(
    CRect& rectEdit,
    CRect& rectSpin);

Parametri

rectEdit
[out] Quando termina, un rettangolo che specifica i limiti della casella di testo per il valore della proprietà.

rectSpin
[out] Quando termina, un rettangolo che specifica i limiti del controllo pulsante di selezione per il valore della proprietà. In alternativa, se la proprietà non supporta un pulsante di selezione, un rettangolo vuoto.

Osservazioni:

L'area del valore di una proprietà è costituita da una casella di testo ed eventualmente da un pulsante di opzione, ad esempio un controllo pulsante di selezione. Questo metodo calcola le dimensioni della casella di testo e del pulsante di opzione e quindi restituisce tali valori nei parametri specificati.

CMFCPropertyGridProperty::AllowEdit

Rende una proprietà modificabile o di sola lettura.

void AllowEdit(BOOL bAllow=TRUE);

Parametri

bAllow
[in] TRUE per rendere modificabile la proprietà; FALSE per rendere la proprietà di sola lettura. Il valore predefinito è TRUE.

CMFCPropertyGridProperty::CMFCPropertyGridProperty

Costruisce un oggetto CMFCPropertyGridProperty.

CMFCPropertyGridProperty(
    const CString& strGroupName,
    DWORD_PTR dwData=0,
    BOOL bIsValueList=FALSE);

CMFCPropertyGridProperty(
    const CString& strName,
    const _variant_t& varValue,
    LPCTSTR lpszDescr=NULL,
    DWORD_PTR dwData=0,
    LPCTSTR lpszEditMask=NULL,
    LPCTSTR lpszEditTemplate=NULL,
    LPCTSTR lpszValidChars=NULL);

Parametri

strGroupName
[in] Nome del gruppo. 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.

dwData
[in] Dati specifici dell'applicazione, ad esempio un numero intero o un puntatore ad altri dati associati alla proprietà . Il valore predefinito è 0.

strName
[in] Nome della proprietà.

varValue
[in] Valore della proprietà.

lpszDescr
[in] Descrizione della proprietà. Il valore predefinito è NULL.

lpszEditMask
[in] Maschera di modifica, se la proprietà è un controllo di modifica mascherato. Il valore predefinito è NULL.

lpszEditTemplate
[in] Modello di modifica, se la proprietà è un controllo di modifica mascherato. Il valore predefinito è NULL.

lpszValidChars
[in] Elenco di caratteri validi, se la proprietà è un controllo di modifica mascherato. Il valore predefinito è NULL.

bIsValueList
[in] TRUE se la proprietà rappresenta un elenco di valori; FALSE se la proprietà rappresenta un singolo valore. Il valore predefinito è FALSE.

CMFCPropertyGridProperty::CreateCombo

Chiamato dal framework per aggiungere una casella combinata a una proprietà.

virtual CComboBox* CreateCombo(
    CWnd* pWndParent,
    CRect rect);

Parametri

pWndParent
[in] Puntatore alla finestra padre della casella combinata.

rect
[in] Rettangolo di delimitazione della casella combinata.

Valore restituito

Puntatore a un nuovo CComboBox oggetto.

CMFCPropertyGridProperty::CreateInPlaceEdit

Chiamato dal framework per creare un controllo modificabile per una proprietà.

virtual CWnd* CreateInPlaceEdit(
    CRect rectEdit,
    BOOL& bDefaultFormat);

Parametri

rectEdit
[in] Rettangolo di delimitazione del controllo modificabile.

bDefaultFormat
[in] TRUE per utilizzare il formato di proprietà predefinito per impostare il testo del controllo modificabile; in caso contrario, FALSE.

Valore restituito

Puntatore al controllo modificabile se questo metodo ha esito positivo; in caso contrario, NULL.

Osservazioni:

Questo metodo usa i valori dei varValueparametri , lpszEditMask, lpszEditTemplatee lpszValidChars specificati nel costruttore della CMFCPropertyGridProperty classe . Per impostazione predefinita, questo metodo supporta i varValue tipi varianti. Sono inclusi VT_BSTR, VT_R4, VT_R8VT_UI1, VT_I2, VT_INT, VT_UINT, VT_I4, VT_UI2, VT_UI4, e VT_BOOL.

Questo metodo crea un CMFCMaskedEdit controllo se vengono specificati uno o più lpszEditMaskparametri , lpszEditTemplateo lpszValidChars ; in caso contrario, crea un CEdit controllo .

CMFCPropertyGridProperty::CreateSpinControl

Chiamato dal framework per creare un controllo pulsante di selezione modificabile.

virtual CSpinButtonCtrl* CreateSpinControl(CRect rectSpin);

Parametri

rectSpin
[in] Rettangolo che definisce la posizione in cui viene creato il controllo pulsante di selezione modificabile.

Valore restituito

Puntatore a un nuovo CMFCSpinButtonCtrl oggetto di cui viene eseguito il cast come puntatore a un CSpinButtonCtrl oggetto .

Osservazioni:

Chiamare il CMFCPropertyGridProperty::EnableSpinControl metodo per visualizzare un controllo pulsante di selezione modificabile sul bordo destro della proprietà.

CMFCPropertyGridProperty::Enable

Abilita o disabilita una proprietà.

void Enable(BOOL bEnable=TRUE);

Parametri

bEnable
[in] TRUE per abilitare la proprietà; FALSE per disabilitare la proprietà . Le proprietà disabilitate non rispondono all'input del mouse o della tastiera. Il valore predefinito è TRUE.

CMFCPropertyGridProperty::EnableSpinControl

Abilita o disabilita un controllo pulsante di selezione utilizzato per modificare un valore della proprietà.

void EnableSpinControl(
    BOOL bEnable=TRUE,
    int nMin=0,
    int nMax=0);

Parametri

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

nMin
[in] Valore minimo del controllo pulsante di selezione. Il valore predefinito è 0.

nMax
[in] Valore massimo del controllo pulsante di selezione. Il valore predefinito è 0.

Osservazioni:

Il framework crea automaticamente un controllo pulsante di selezione quando una proprietà sta per essere modificata.

Il tipo di proprietà, specificato dal varValue parametro del CMFCPropertyGridProperty::CMFCPropertyGridProperty costruttore, deve essere un tipo variant supportato. In caso contrario, questo metodo asserisce in modalità di debug. I tipi supportati includono VT_INT, VT_UINT, VT_I4VT_I2, , VT_UI2e VT_UI4.

CMFCPropertyGridProperty::Expand

Espande o comprime una proprietà che contiene proprietà secondarie.

void Expand(BOOL bExpand=TRUE);

Parametri

bExpand
[in] TRUE per espandere la proprietà; FALSE per comprimere la proprietà. Il valore predefinito è TRUE.

CMFCPropertyGridProperty::FormatProperty

Formatta la rappresentazione di testo di un valore della proprietà.

virtual CString FormatProperty();

Valore restituito

Rappresentazione testuale del valore della proprietà.

Osservazioni:

Questo metodo viene chiamato dal framework prima che venga visualizzato il valore della proprietà.

CMFCPropertyGridProperty::GetData

Recupera un DWORD valore associato a una proprietà.

DWORD_PTR GetData() const;

Valore restituito

Valore DWORD.

Osservazioni:

I dati restituiti sono un valore specifico dell'applicazione, ad esempio un numero o un puntatore ad altri dati. Specificare il valore dei dati quando si costruisce la proprietà o quando si chiama il CMFCPropertyGridProperty::SetData metodo .

CMFCPropertyGridProperty::GetDescription

Recupera una descrizione della proprietà.

const CString& GetDescription() const;

Valore restituito

Stringa di testo contenente la descrizione della proprietà.

Osservazioni:

Il controllo Elenco proprietà utilizza anche questo metodo per visualizzare la descrizione della proprietà.

CMFCPropertyGridProperty::GetExpandedSubItems

Recupera il numero di elementi secondari espansi.

int GetExpandedSubItems(BOOL bIncludeHidden=TRUE) const;

Parametri

bIncludeHidden
[in] TRUE per includere gli elementi secondari nascosti nel conteggio; in caso contrario, FALSE. Il valore predefinito è TRUE.

Valore restituito

Numero di elementi secondari espansi.

CMFCPropertyGridProperty::GetHierarchyLevel

Recupera l'indice in base zero del livello della gerarchia della proprietà.

int GetHierarchyLevel() const;

Valore restituito

Livello gerarchico della proprietà.

CMFCPropertyGridProperty::GetName

Recupera il nome della proprietà.

LPCTSTR GetName() const;

Valore restituito

Puntatore a una stringa contenente il nome della proprietà.

CMFCPropertyGridProperty::GetNameTooltip

Chiamato dal framework per visualizzare il nome della proprietà in una descrizione comando.

virtual CString GetNameTooltip();

Valore restituito

Stringa contenente il nome della proprietà. Per impostazione predefinita, il valore restituito è la stringa vuota.

CMFCPropertyGridProperty::GetOption

Recupera il testo dell'opzione specificata da un indice.

LPCTSTR GetOption(int nIndex) const;

Parametri

nIndex
Indice in base zero dell'elemento dell'elenco delle proprietà (opzione) da recuperare.

Valore restituito

Puntatore a una stringa contenente il testo dell'opzione.

CMFCPropertyGridProperty::GetOptionCount

Recupera il numero di opzioni che appartengono a una proprietà.

int GetOptionCount() const;

Valore restituito

Numero di elementi dell'elenco di proprietà (opzioni) contenuti nel controllo proprietà.

Osservazioni:

Chiamare il CMFCPropertyGridProperty::AddOption metodo per aggiungere elementi all'elenco delle proprietà. Chiamare il CMFCPropertyGridProperty::RemoveAllOptions metodo per rimuovere tutti gli elementi.

CMFCPropertyGridProperty::GetOriginalValue

Recupera il valore iniziale della proprietà corrente.

const COleVariant& GetOriginalValue() const;

Valore restituito

Valore originale della proprietà corrente.

Osservazioni:

Utilizzare questo metodo per annullare l'effetto di un'operazione di modifica che modifica il valore della proprietà corrente.

Il valore originale della proprietà corrente viene impostato dal CMFCPropertyGridProperty::CMFCPropertyGridProperty costruttore, modificato dal CMFCPropertyGridProperty::SetOriginalValue metodo e reimpostato dal CMFCPropertyGridProperty::ResetOriginalValue metodo .

CMFCPropertyGridProperty::GetParent

Recupera un puntatore a una proprietà padre.

CMFCPropertyGridProperty* GetParent() const;

Valore restituito

Puntatore a un oggetto proprietà padre o NULL per la proprietà di primo livello.

CMFCPropertyGridProperty::GetRect

Recupera il rettangolo di delimitazione di una proprietà.

CRect GetRect() const;

Valore restituito

Oggetto CRect che descrive il rettangolo di delimitazione.

CMFCPropertyGridProperty::GetSubItem

Recupera una sottoproperty identificata da un indice in base zero.

CMFCPropertyGridProperty* GetSubItem(int nIndex) const;

Parametri

nIndex
[in] Indice in base zero della proprietà da recuperare. Questo parametro non è valido se è minore di zero o maggiore o uguale al numero di sottoproprietà.

Valore restituito

Puntatore a un oggetto proprietà che è un elemento figlio di questa proprietà.

oppure

In modalità retail, NULL se il nIndex parametro non è valido. In modalità di debug, questo metodo asserisce.

CMFCPropertyGridProperty::GetSubItemsCount

Recupera il numero di elementi secondari.

int GetSubItemsCount() const;

Valore restituito

Numero di elementi figlio.

CMFCPropertyGridProperty::GetValue

Recupera un valore della proprietà.

virtual const _variant_t& GetValue() const;

Valore restituito

Variante che contiene il valore della proprietà.

CMFCPropertyGridProperty::GetValueTooltip

Chiamato dal framework per recuperare la rappresentazione testuale del valore della proprietà che viene quindi visualizzato in una descrizione comando.

virtual CString GetValueTooltip();

Valore restituito

Oggetto CString contenente la rappresentazione testuale del valore della proprietà. Per impostazione predefinita, questo valore è la stringa vuota.

CMFCPropertyGridProperty::HasButton

Indica se una proprietà contiene un pulsante.

virtual BOOL HasButton() const;

Valore restituito

TRUE se una proprietà contiene un pulsante (o un elenco di proprietà); in caso contrario, FALSE.

CMFCPropertyGridProperty::HitTest

Punta all'oggetto proprietà che corrisponde all'elemento dell'elenco delle proprietà che corrisponde a un punto.

CMFCPropertyGridProperty* HitTest(
    CPoint point,
    CMFCPropertyGridProperty::ClickArea* pnArea=NULL);

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

Parametri

point
[in] Punto da testare, nelle coordinate client. Questo parametro è in genere la posizione corrente del puntatore del mouse.

pt
[in] Punto da testare, nelle coordinate client.

pnArea
[out] Quando termina, questo metodo indica l'area che contiene il punto specificato. Per altre informazioni, vedere la sezione Note. Il valore predefinito è NULL.

bPropsOnly
[in] TRUE per testare qualsiasi area nel controllo proprietà; FALSE per testare solo l'area di descrizione. Il valore predefinito è FALSE.

Valore restituito

Puntatore a un oggetto proprietà o NULLa .

Osservazioni:

Per impostazione predefinita, questo metodo verifica gli elementi secondari della proprietà se il punto specificato non viene trovato all'interno di nessuno degli elementi della proprietà.

Nella tabella seguente sono elencati i valori che è possibile restituire al pnArea parametro .

Area	Descrizione
ClickArea::ClickExpandBox	Controllo casella di espansione, designato da un segno più (+).
ClickArea::ClickName	Nome della proprietà.
ClickArea::ClickValue	Valore della proprietà di .

CMFCPropertyGridProperty::Init

Chiamato dal framework per inizializzare un oggetto proprietà.

void Init();

CMFCPropertyGridProperty::IsAllowEdit

Indica se una proprietà è modificabile.

BOOL IsAllowEdit() const;

Valore restituito

TRUE se la proprietà è modificabile; in caso contrario FALSE, .

CMFCPropertyGridProperty::IsEnabled

Indica se una proprietà è abilitata o disabilitata.

BOOL IsEnabled() const;

Valore restituito

TRUE se la proprietà è abilitata; FALSE se la proprietà è disabilitata.

Osservazioni:

Indica se una proprietà è abilitata o disabilitata.

CMFCPropertyGridProperty::IsExpanded

Indica se una proprietà è espansa o compressa.

BOOL IsExpanded() const;

Valore restituito

TRUE se la proprietà è espansa; FALSE se la proprietà è compressa.

CMFCPropertyGridProperty::IsGroup

Indica se la proprietà corrente rappresenta un gruppo.

BOOL IsGroup() const;

Valore restituito

TRUE se l'oggetto proprietà corrente rappresenta un gruppo; FALSE se la proprietà rappresenta un valore.

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.

CMFCPropertyGridProperty::IsInPlaceEditing

Indica se la proprietà corrente è modificabile.

BOOL IsInPlaceEditing() const;

Valore restituito

TRUE se la proprietà corrente è modificabile; in caso contrario, FALSE.

CMFCPropertyGridProperty::IsModified

Indica se la proprietà corrente viene modificata.

BOOL IsModified() const;

Valore restituito

TRUE se la proprietà viene modificata; in caso contrario, FALSE.

CMFCPropertyGridProperty::IsParentExpanded

Indica se gli elementi padre della proprietà corrente vengono espansi.

BOOL IsParentExpanded() const;

Valore restituito

TRUE se tutti gli elementi padre della proprietà corrente vengono espansi; FALSE se le proprietà padre sono compresse.

CMFCPropertyGridProperty::IsSelected

Indica se la proprietà corrente è selezionata.

virtual BOOL IsSelected() const;

Valore restituito

TRUE se la proprietà corrente è selezionata; in caso contrario, FALSE.

CMFCPropertyGridProperty::IsSubItem

Indica se la proprietà specificata è un elemento secondario della proprietà corrente.

BOOL IsSubItem(CMFCPropertyGridProperty* pProp) const;

Parametri

pProp
[in] Puntatore a una proprietà.

Valore restituito

TRUE se la proprietà specificata è un elemento secondario della proprietà corrente; in caso contrario, FALSE.

CMFCPropertyGridProperty::IsValueChanged

Indica se il valore della proprietà corrente è stato modificato.

virtual BOOL IsValueChanged() const;

Valore restituito

TRUE se il valore della proprietà corrente è stato modificato; in caso contrario, FALSE.

CMFCPropertyGridProperty::IsVisible

Indica se la proprietà corrente è visibile.

BOOL IsVisible() const;

Valore restituito

TRUE se la proprietà corrente è visibile; altrimenti; FALSE.

CMFCPropertyGridProperty::m_strFormatDouble

Contiene una stringa di formato per un valore di tipo double.

static CString m_strFormatDouble;

CMFCPropertyGridProperty::m_strFormatFloat

Contiene una stringa di formato per un valore di tipo float.

static CString m_strFormatFloat;

CMFCPropertyGridProperty::m_strFormatLong

Contiene una stringa di formato per un valore di tipo long.

static CString m_strFormatLong;

CMFCPropertyGridProperty::m_strFormatShort

Contiene una stringa di formato per un valore di tipo short.

static CString m_strFormatShort;

CMFCPropertyGridProperty::OnClickButton

Chiamato dal framework quando l'utente seleziona un pulsante contenuto in una proprietà.

virtual void OnClickButton(CPoint point);

Parametri

point
[in] Punto, nelle coordinate client.

Osservazioni:

Per impostazione predefinita, questo metodo non effettua alcuna operazione.

CMFCPropertyGridProperty::OnClickName

Chiamato da un controllo elenco di proprietà padre quando un utente seleziona il campo nome di una proprietà.

virtual void OnClickName(CPoint C);

Parametri

C
[in] Punto, nelle coordinate client.

Osservazioni:

Per impostazione predefinita, questo metodo non effettua alcuna operazione.

CMFCPropertyGridProperty::OnClickValue

Chiamato da un controllo elenco di proprietà padre quando un utente seleziona il campo valore di una proprietà.

virtual BOOL OnClickValue(
    UINT uiMsg,
    CPoint point);

Parametri

uiMsg
[in] Messaggio del mouse.

point
[in] Punto, nelle coordinate client.

Valore restituito

TRUE se il messaggio del mouse specificato viene elaborato da questo metodo; in caso contrario, FALSE.

Osservazioni:

Per impostazione predefinita, questo metodo restituisce FALSE se la proprietà corrente non è modificabile. In caso contrario, il controllo edit o spin associato a questa proprietà elabora il messaggio del mouse specificato e quindi questo metodo restituisce TRUE.

CMFCPropertyGridProperty::OnCloseCombo

Chiamato dal framework quando una casella combinata contenuta in una proprietà viene chiusa.

virtual void OnCloseCombo();

CMFCPropertyGridProperty::OnCtlColor

Chiamato dal framework quando deve recuperare un pennello per riempire il colore di sfondo di una proprietà.

virtual HBRUSH OnCtlColor(
    CDC* pDC,
    UINT nCtlColor);

Parametri

pDC
[in] Puntatore a un contesto di dispositivo.

nCtlColor
[in] Questo parametro non viene usato.

Valore restituito

Handle di un pennello se questo metodo ha esito positivo; in caso contrario, NULL.

CMFCPropertyGridProperty::OnDblClk

Chiamato dal framework quando l'utente fa doppio clic su una proprietà.

virtual BOOL OnDblClk(CPoint point);

Parametri

point
[in] Punto, nelle coordinate client.

Valore restituito

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

Osservazioni:

Per impostazione predefinita, questo metodo seleziona l'elemento della proprietà successivo nel controllo elenco delle proprietà.

CMFCPropertyGridProperty::OnDestroyWindow

Chiamato dal framework quando una proprietà viene eliminata definitivamente o al termine della modifica.

virtual void OnDestroyWindow();

CMFCPropertyGridProperty::OnDrawButton

Chiamato dal framework per disegnare un pulsante contenuto in una proprietà .

virtual void OnDrawButton(
    CDC* pDC,
    CRect rectButton);

Parametri

pDC
[in] Puntatore a un contesto di dispositivo.

rectButton
[in] Rettangolo di delimitazione che specifica dove disegnare un pulsante.

CMFCPropertyGridProperty::OnDrawDescription

Chiamato dal framework per disegnare la descrizione della proprietà.

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

Parametri

pDC
[in] Puntatore a un contesto di dispositivo.

rect
[in] Rettangolo di delimitazione che specifica dove disegnare la descrizione della proprietà.

Osservazioni:

Per impostazione predefinita, questo metodo disegna il nome e la descrizione della proprietà nel tipo di carattere utilizzato dal controllo elenco proprietà padre. La descrizione della proprietà viene disegnata in stile regolare e il nome della proprietà viene disegnato in grassetto.

CMFCPropertyGridProperty::OnDrawExpandBox

Chiamato dal framework per disegnare un controllo casella di espansione vicino a una proprietà che contiene proprietà secondarie.

virtual void OnDrawExpandBox(
    CDC* pDC,
    CRect rectExpand);

Parametri

pDC
[in] Puntatore a un contesto di dispositivo.

rectExpand
[in] Rettangolo di delimitazione che specifica dove disegnare il controllo casella di espansione.

Osservazioni:

Selezionare il controllo casella di espansione per espandere o comprimere un elenco di sottoproprietà. Il controllo casella di espansione è designato da un quadrato che contiene un segno più (+) o meno (-). Un segno più indica che la proprietà può essere espansa per visualizzare un elenco di sottoproprietà. Un segno meno indica che l'elenco può essere compresso per visualizzare solo la proprietà .

CMFCPropertyGridProperty::OnDrawName

Chiamato dal framework per visualizzare il nome della proprietà.

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

Parametri

pDC
[in] Puntatore a un contesto di dispositivo.

rect
[in] Rettangolo di delimitazione che specifica dove disegnare il nome della proprietà.

CMFCPropertyGridProperty::OnDrawValue

Chiamato dal framework per visualizzare il valore della proprietà.

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

Parametri

pDC
[in] Puntatore a un contesto di dispositivo.

rect
[in] Rettangolo di delimitazione che specifica dove disegnare il valore della proprietà.

CMFCPropertyGridProperty::OnEdit

Chiamato dal framework quando l'utente sta per modificare il valore di una proprietà.

virtual BOOL OnEdit(LPPOINT lptClick);

Parametri

lptClick
[in] Questo parametro non viene usato. Puntatore a un punto, nelle coordinate client.

Valore restituito

TRUE se l'operazione di modifica viene avviata correttamente; in caso contrario, FALSE.

Osservazioni:

Questa funzione viene chiamata dal framework quando l'utente sta per modificare un valore della proprietà. Per impostazione predefinita, questo metodo avvia l'editor appropriato per un controllo casella combinata o un controllo spin.

CMFCPropertyGridProperty::OnEndEdit

Chiamato dal framework al termine della modifica del valore di una proprietà.

virtual BOOL OnEndEdit();

Valore restituito

Questo metodo restituisce sempre TRUE.

Osservazioni:

Per impostazione predefinita, questo metodo elimina definitivamente il controllo di modifica corrente e quindi restituisce TRUE.

CMFCPropertyGridProperty::OnKillFocus

Chiamato dal framework quando la proprietà perde lo stato attivo dell'input.

virtual BOOL OnKillFocus(CWnd*);

Parametri

CWnd
[in] Non usato. Puntatore a una finestra.

Valore restituito

Questo metodo restituisce sempre TRUE.

Osservazioni:

Per impostazione predefinita, questo metodo non esegue alcuna operazione e quindi restituisce TRUE. Se si esegue l'override di questo metodo, restituire TRUE se il framework può terminare l'operazione di modifica quando la proprietà perde lo stato attivo dell'input.

CMFCPropertyGridProperty::OnKillSelection

virtual void OnKillSelection(CMFCPropertyGridProperty*);

Parametri

[in] CMFCPropertyGridProperty*\

Osservazioni:

Per impostazione predefinita, questo metodo non effettua alcuna operazione.

CMFCPropertyGridProperty::OnPosSizeChanged

virtual void OnPosSizeChanged(CRect);

Parametri

[in] CRect\

Osservazioni:

Per impostazione predefinita, questo metodo non effettua alcuna operazione.

CMFCPropertyGridProperty::OnRClickName

Chiamato dal framework quando l'utente seleziona il pulsante destro del mouse nell'area del nome della proprietà.

virtual void OnRClickName(CPoint C);

Parametri

C
[in] Punto, nelle coordinate client.

Osservazioni:

Per impostazione predefinita, questo metodo non effettua alcuna operazione.

CMFCPropertyGridProperty::OnRClickValue

Chiamato dal framework quando l'utente seleziona il pulsante destro del mouse nell'area del valore della proprietà.

virtual void OnRClickValue(
    CPoint C,
    BOOL B);

Parametri

C
[in] Punto, nelle coordinate client.

B
[in] Valore booleano.

Osservazioni:

Per impostazione predefinita, questo metodo non esegue alcuna operazione e il B parametro non ha alcun scopo predefinito.

CMFCPropertyGridProperty::OnSelectCombo

Chiamato dal framework quando l'utente seleziona un elemento dalla casella combinata modificabile.

virtual void OnSelectCombo();

Osservazioni:

Per impostazione predefinita, questo metodo usa il testo dell'elemento selezionato per aggiornare il valore della proprietà.

CMFCPropertyGridProperty::OnSetCursor

Chiamato dal framework quando il puntatore del mouse passa a un elemento della proprietà.

virtual BOOL OnSetCursor() const;

Valore restituito

TRUE se la proprietà corrente è un tipo variant o un elenco di valori e questo metodo carica correttamente il cursore del mouse del punto di inserimento (I-beam); in caso contrario, FALSE.

Osservazioni:

Questo metodo supporta i tipi varianti seguenti: VT_INT, VT_I2, VT_I4, VT_UI1VT_UINT, VT_UI2, VT_UI4VT_R4, , VT_R8, , e VT_BSTR.

CMFCPropertyGridProperty::OnSetSelection

virtual void OnSetSelection CMFCPropertyGridProperty*);

Parametri

[in] CMFCPropertyGridProperty*\

Osservazioni:

Per impostazione predefinita, questo metodo non effettua alcuna operazione.

CMFCPropertyGridProperty::OnUpdateValue

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

virtual BOOL OnUpdateValue();

Valore restituito

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

CMFCPropertyGridProperty::PushChar

Chiamato dal controllo elenco di proprietà quando la proprietà è selezionata e l'utente immette un nuovo carattere.

virtual BOOL PushChar(UINT nChar);

Parametri

nChar
[in] Carattere.

Valore restituito

TRUE se l'operazione di modifica continua; in caso contrario, FALSE.

Osservazioni:

Questo metodo supporta una proprietà che è un elenco di valori o uno dei tipi varianti seguenti: VT_INT, VT_UI1VT_UINTVT_I2VT_I4VT_UI2, VT_R4VT_UI4, , VT_R8e .VT_BSTR

CMFCPropertyGridProperty::Redraw

Ridisegna la proprietà .

void Redraw();

CMFCPropertyGridProperty::RemoveAllOptions

Rimuove tutte le opzioni (elementi) da una proprietà.

void RemoveAllOptions();

Osservazioni:

Le opzioni sono note anche come elementi di elenco di un controllo elenco di proprietà.

CMFCPropertyGridProperty::RemoveSubItem

Rimuove l'elemento secondario specificato.

BOOL RemoveSubItem(
    CMFCPropertyGridProperty*& pProp,
    BOOL bDelete=TRUE);

Parametri

pProp
[in] Puntatore a un elemento secondario della proprietà.

bDelete
[in] TRUE per eliminare l'oggetto proprietà specificato dal pProp parametro ; in caso contrario, FALSE. Il valore predefinito è TRUE.

Valore restituito

Osservazioni:

Specificare FALSE per il bDelete parametro se si intende spostare l'elemento secondario specificato, ovvero rimuovere l'elemento secondario e quindi aggiungerlo altrove.

CMFCPropertyGridProperty::ResetOriginalValue

Ripristina il valore originale di una proprietà modificata.

virtual void ResetOriginalValue();

CMFCPropertyGridProperty::SetData

Associa un DWORD valore a una proprietà.

void SetData(DWORD_PTR dwData);

Parametri

dwData
[in] Valore a 32 bit specifico dell'applicazione, ad esempio un numero intero o un puntatore ad altri dati.

Osservazioni:

Utilizzare il CMFCPropertyGridProperty::GetData metodo per recuperare il DWORD valore. Utilizzare il CMFCPropertyGridCtrl::FindItemByData metodo per individuare l'elemento dell'elenco delle proprietà associato al valore specificato DWORD .

CMFCPropertyGridProperty::SetDescription

Specifica il testo che descrive la proprietà corrente.

void SetDescription(const CString& strDescr);

Parametri

strDescr
[in] Testo che descrive la proprietà corrente.

CMFCPropertyGridProperty::SetName

Imposta il nome di una proprietà.

void SetName(
    LPCTSTR lpszName,
    BOOL bRedraw=TRUE);

Parametri

lpszName
[in] Nome della proprietà.

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

CMFCPropertyGridProperty::SetOriginalValue

Imposta il valore originale di una proprietà modificabile.

virtual void SetOriginalValue(const COleVariant& varValue);

Parametri

varValue
[in] Valore .

Osservazioni:

Utilizzare il CMFCPropertyGridProperty::ResetOriginalValue metodo per reimpostare il valore originale di una proprietà modificata.

CMFCPropertyGridProperty::SetValue

Imposta il valore di una proprietà della griglia delle proprietà.

virtual void SetValue(const _variant_t& varValue);

Parametri

varValue
[in] Riferimento al valore su cui impostare la proprietà .

Esempio: SetValue

void SetPropBarValue(UINT propId, const DWORD& barPropDwordValue)
{
  auto property = propertiesGridCtrlList.FindItemByData(propId);
  if (property != nullptr)
  {
    property->SetValue(static_cast<_variant_t >(barPropDwordValue == 1)); // set value to true or false depending on dword value
  }
}

CMFCPropertyGridProperty::Show

Mostra o nasconde una proprietà.

void Show(
    BOOL bShow=TRUE,
    BOOL bAdjustLayout=TRUE);

Parametri

bShow
[in] TRUE per visualizzare la proprietà corrente e i relativi elementi secondari; FALSE per nascondere la proprietà corrente e i relativi elementi secondari. Il valore predefinito è TRUE.

bAdjustLayout
[in] TRUE per ricalcolare come disegnare l'etichetta e il valore di una proprietà e quindi disegnare la proprietà; FALSE per utilizzare calcoli esistenti per disegnare la proprietà. Il valore predefinito è TRUE.

Vedi anche

Grafico della gerarchia
Classi
Classe CMFCPropertyGridCtrl