CMFCPropertyGridProperty-Klasse

Ein CMFCPropertyGridProperty Objekt stellt ein Listenelement in einem Eigenschaftenlistensteuerelement dar.

Weitere Details finden Sie im Quellcode, der mfc sich im Ordner Ihrer Visual Studio-Installation befindet. Beispiel: %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc.

Syntax

class CMFCPropertyGridProperty : public CObject

Member

Öffentliche Konstruktoren

Name	Beschreibung
CMFCPropertyGridProperty::CMFCPropertyGridProperty	Erstellt ein CMFCPropertyGridProperty-Objekt.
CMFCPropertyGridProperty::~CMFCPropertyGridProperty	Destruktor.

Öffentliche Methoden

Name	Beschreibung
CMFCPropertyGridProperty::AddOption	Fügt einem Eigenschaftenlistensteuerelement ein neues Listenelement hinzu.
CMFCPropertyGridProperty::AddSubItem	Fügt einer Eigenschaft ein untergeordnetes Element hinzu.
CMFCPropertyGridProperty::AdjustButtonRect	Wird vom übergeordneten Eigenschaftenlistensteuerelement aufgerufen, um eine Eigenschaft anzuweisen, die Größe des umgebenden Rechtecks einer eingebetteten Schaltfläche zu ändern.
CMFCPropertyGridProperty::AdjustInPlaceEditRect	Ruft die Begrenzungen des Textfelds und des optionalen Drehfeld-Steuerelements ab, das zum Festlegen eines Eigenschaftswerts verwendet wird.
CMFCPropertyGridProperty::AllowEdit	Macht eine Eigenschaft entweder bearbeitbar oder schreibgeschützt.
CMFCPropertyGridProperty::CreateInPlaceEdit	Vom Framework aufgerufen, um ein bearbeitbares Steuerelement für eine Eigenschaft zu erstellen.
CMFCPropertyGridProperty::CreateSpinControl	Vom Framework aufgerufen, um ein bearbeitbares Drehfeld-Steuerelement zu erstellen.
CMFCPropertyGridProperty::Enable	Aktiviert oder deaktiviert eine Eigenschaft.
CMFCPropertyGridProperty::EnableSpinControl	Aktiviert oder deaktiviert ein Drehfeld-Steuerelement, das zum Ändern eines Eigenschaftswerts verwendet wird.
CMFCPropertyGridProperty::Expand	Erweitert oder reduziert eine Eigenschaft, die Untereigenschaften enthält.
CMFCPropertyGridProperty::FormatProperty	Formatiert die Textdarstellung eines Eigenschaftswerts.
CMFCPropertyGridProperty::GetData	Ruft einen DWORD-Wert ab, der einer Eigenschaft zugeordnet ist.
CMFCPropertyGridProperty::GetDescription	Ruft eine Eigenschaftsbeschreibung ab.
CMFCPropertyGridProperty::GetExpandedSubItems	Ruft die Anzahl der erweiterten Unterelemente ab.
CMFCPropertyGridProperty::GetHierarchyLevel	Ruft den nullbasierten Index der Hierarchieebene der Eigenschaft ab.
CMFCPropertyGridProperty::GetName	Ruft den Namen der Eigenschaft ab.
CMFCPropertyGridProperty::GetNameTooltip	Wird vom Framework aufgerufen, um den Namen der Eigenschaft in einer QuickInfo anzuzeigen.
CMFCPropertyGridProperty::GetOption	Ruft den Text der Option ab, die durch einen Index angegeben wird.
CMFCPropertyGridProperty::GetOptionCount	Ruft die Anzahl der Optionen ab, die zu einer Eigenschaft gehören.
CMFCPropertyGridProperty::GetOriginalValue	Ruft den Anfangswert der aktuellen Eigenschaft ab.
CMFCPropertyGridProperty::GetParent	Ruft einen Zeiger auf eine übergeordnete Eigenschaft ab.
CMFCPropertyGridProperty::GetRect	Ruft das umgebende Rechteck einer Eigenschaft ab.
CMFCPropertyGridProperty::GetSubItem	Ruft eine Untereigenschaft ab, die durch einen nullbasierten Index identifiziert wird.
CMFCPropertyGridProperty::GetSubItemsCount	Ruft die Anzahl der Unterelemente ab.
CMFCPropertyGridProperty::GetThisClass	Wird vom Framework verwendet, um einen Zeiger auf das CRuntimeClass Objekt abzurufen, das diesem Klassentyp zugeordnet ist.
CMFCPropertyGridProperty::GetValue	Ruft einen Eigenschaftswert ab.
CMFCPropertyGridProperty::GetValueTooltip	Wird vom Framework aufgerufen, um die Textdarstellung des Eigenschaftswerts abzurufen, der dann in einer QuickInfo angezeigt wird.
CMFCPropertyGridProperty::HitTest	Verweist auf das Eigenschaftsobjekt, das dem Eigenschaftslistenelement entspricht, das einem Punkt entspricht.
CMFCPropertyGridProperty::IsAllowEdit	Gibt an, ob eine Eigenschaft bearbeitbar ist.
CMFCPropertyGridProperty::IsEnabled	Gibt an, ob eine Eigenschaft aktiviert oder deaktiviert ist.
CMFCPropertyGridProperty::IsExpanded	Gibt an, ob eine Eigenschaft erweitert oder reduziert ist.
CMFCPropertyGridProperty::IsGroup	Gibt an, ob die aktuelle Eigenschaft eine Gruppe darstellt.
CMFCPropertyGridProperty::IsInPlaceEditing	Gibt an, ob die aktuelle Eigenschaft bearbeitet werden kann.
CMFCPropertyGridProperty::IsModified	Gibt an, ob die aktuelle Eigenschaft geändert wird.
CMFCPropertyGridProperty::IsParentExpanded	Gibt an, ob die übergeordneten Elemente der aktuellen Eigenschaft erweitert werden.
CMFCPropertyGridProperty::IsSelected	Gibt an, ob die aktuelle Eigenschaft ausgewählt ist.
CMFCPropertyGridProperty::IsVisible	Gibt an, ob die aktuelle Eigenschaft sichtbar ist.
CMFCPropertyGridProperty::OnClickButton	Wird vom Framework aufgerufen, wenn der Benutzer eine Schaltfläche auswählt, die in einer Eigenschaft enthalten ist.
CMFCPropertyGridProperty::OnClickName	Wird von einem übergeordneten Eigenschaftenlistensteuerelement aufgerufen, wenn ein Benutzer das Namensfeld einer Eigenschaft auswählt.
CMFCPropertyGridProperty::OnClickValue	Wird von einem übergeordneten Eigenschaftenlistensteuerelement aufgerufen, wenn ein Benutzer das Wertfeld einer Eigenschaft auswählt.
CMFCPropertyGridProperty::OnCloseCombo	Wird vom Framework aufgerufen, wenn ein Kombinationsfeld, das in einer Eigenschaft enthalten ist, geschlossen wird.
CMFCPropertyGridProperty::OnDblClk	Wird vom Framework aufgerufen, wenn der Benutzer auf eine Eigenschaft doppelklicken soll.
CMFCPropertyGridProperty::OnDrawButton	Wird vom Framework aufgerufen, um eine Schaltfläche zu zeichnen, die in einer Eigenschaft enthalten ist.
CMFCPropertyGridProperty::OnDrawDescription	Vom Framework aufgerufen, um die Eigenschaftenbeschreibung anzuzeigen.
CMFCPropertyGridProperty::OnDrawExpandBox	Wird vom Framework aufgerufen, um ein Erweiterungsfeld-Steuerelement in der Nähe einer Eigenschaft zu zeichnen, die Untereigenschaften enthält.
CMFCPropertyGridProperty::OnDrawName	Wird vom Framework aufgerufen, um den Eigenschaftennamen anzuzeigen.
CMFCPropertyGridProperty::OnDrawValue	Wird vom Framework aufgerufen, um die Liste der Eigenschaftenwerte anzuzeigen.
CMFCPropertyGridProperty::OnEdit	Wird vom Framework aufgerufen, wenn der Benutzer dabei ist, einen Eigenschaftenwert zu bearbeiten.
CMFCPropertyGridProperty::OnEndEdit	Wird vom Framework aufgerufen, wenn der Benutzer mit dem Ändern eines Eigenschaftswerts fertig ist.
CMFCPropertyGridProperty::OnKillSelection
CMFCPropertyGridProperty::OnPosSizeChanged
CMFCPropertyGridProperty::OnRClickName	Wird vom Framework aufgerufen, wenn der Benutzer im Eigenschaftennamenbereich die rechte Maustaste auswählt.
CMFCPropertyGridProperty::OnRClickValue	Wird vom Framework aufgerufen, wenn der Benutzer die rechte Maustaste im Eigenschaftswertbereich auswählt.
CMFCPropertyGridProperty::OnSelectCombo	Wird vom Framework aufgerufen, wenn der Benutzer ein Element aus dem bearbeitbaren Kombinationsfeld auswählt.
CMFCPropertyGridProperty::OnSetCursor	Wird vom Framework aufgerufen, wenn der Mauszeiger zu einem Eigenschaftselement wechselt.
CMFCPropertyGridProperty::OnSetSelection
CMFCPropertyGridProperty::OnUpdateValue	Wird vom Framework aufgerufen, wenn der Wert einer änderbaren Eigenschaft geändert wurde.
CMFCPropertyGridProperty::PushChar	Wird aus dem Eigenschaftenlistensteuerelement aufgerufen, wenn die Eigenschaft ausgewählt ist und der Benutzer ein neues Zeichen eingibt.
CMFCPropertyGridProperty::Redraw	Redraws the property.
CMFCPropertyGridProperty::RemoveAllOptions	Entfernt alle Optionen (Elemente) aus einer Eigenschaft.
CMFCPropertyGridProperty::RemoveSubItem	Entfernt das angegebene Unterelement.
CMFCPropertyGridProperty::ResetOriginalValue	Stellt den ursprünglichen Wert einer bearbeiteten Eigenschaft wieder her.
CMFCPropertyGridProperty::SetData	Ordnet einen DWORD-Wert einer Eigenschaft zu.
CMFCPropertyGridProperty::SetDescription	Gibt den Text an, der die aktuelle Eigenschaft beschreibt.
CMFCPropertyGridProperty::SetName	Legt den Namen einer Eigenschaft fest.
CMFCPropertyGridProperty::SetOriginalValue	Legt den ursprünglichen Wert einer bearbeitbaren Eigenschaft fest.
CMFCPropertyGridProperty::SetValue	Legt den Wert einer Eigenschaftsrastereigenschaft fest.
CMFCPropertyGridProperty::Show	Blendet eine Eigenschaft ein oder aus.

Geschützte Methoden

Name	Beschreibung
CMFCPropertyGridProperty::CreateCombo	Wird vom Framework aufgerufen, um einer Eigenschaft ein Kombinationsfeld hinzuzufügen.
CMFCPropertyGridProperty::HasButton	Gibt an, ob eine Eigenschaft eine Schaltfläche enthält.
CMFCPropertyGridProperty::Init	Vom Framework aufgerufen, um ein Eigenschaftsobjekt zu initialisieren.
CMFCPropertyGridProperty::IsSubItem	Gibt an, ob die angegebene Eigenschaft ein Unterelement der aktuellen Eigenschaft ist.
CMFCPropertyGridProperty::IsValueChanged	Gibt an, ob sich der Wert der aktuellen Eigenschaft geändert hat.
CMFCPropertyGridProperty::OnCtlColor	Wird vom Framework aufgerufen, wenn ein Pinsel abgerufen werden muss, um die Hintergrundfarbe einer Eigenschaft auszufüllen.
CMFCPropertyGridProperty::OnDestroyWindow	Wird vom Framework aufgerufen, wenn eine Eigenschaft zerstört oder die Bearbeitung abgeschlossen ist.
CMFCPropertyGridProperty::OnKillFocus	Wird vom Framework aufgerufen, wenn die Eigenschaft den Eingabefokus verliert.

Datenelemente

Name	Beschreibung
CMFCPropertyGridProperty::m_strFormatDouble	Formatzeichenfolge für einen Wert vom Typ Double.
CMFCPropertyGridProperty::m_strFormatFloat	Formatzeichenfolge für einen Wert vom Typ Float.
CMFCPropertyGridProperty::m_strFormatLong	Formatzeichenfolge für einen Wert vom Typ Long.
CMFCPropertyGridProperty::m_strFormatShort	Formatzeichenfolge für einen Wert vom Typ short.

Hinweise

Verwenden Sie ein CMFCPropertyGridProperty Objekt, um eine Eigenschaft darzustellen, die Sie dann einem Eigenschaftenlistensteuerelement hinzufügen. Weitere Informationen finden Sie unter CMFCPropertyGridCtrl "Klasse".

Ein Eigenschaftsobjekt kann Datentypen wie Zeichenfolgen, Datumsangaben und boolesche oder ganzzahlige Werte darstellen. Sie kann untergeordnete Eigenschaften enthalten oder ein Steuerelement wie ein Kombinationsfeld oder ein Schaltflächensteuerelement enthalten.

Beispiel

Im folgenden Beispiel wird veranschaulicht, wie ein CMFCPropertyGridProperty Objekt erstellt wird. Im Beispiel wird auch veranschaulicht, wie verschiedene Methoden in der CMFCPropertyGridProperty Klasse verwendet werden, um eine Option hinzuzufügen, ein Unterelement hinzuzufügen, eine Eigenschaft zu aktivieren und eine Eigenschaft anzuzeigen. Dieses Beispiel ist Teil des Beispiels "Neue Steuerelemente".

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

Vererbungshierarchie

CObject

CMFCPropertyGridProperty

Anforderungen

Headerafxpropertygridctrl.h:

CMFCPropertyGridProperty::AddOption

Fügt einem Eigenschaftenlistensteuerelement ein neues Listenelement hinzu.

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

Parameter

lpszOption
[in] Das hinzuzufügende Listenelement (Option).

bInsertUnique
[in] TRUE das Listenelement nur dann hinzuzufügen, wenn es noch nicht vorhanden ist; andernfalls . FALSE Der Standardwert ist TRUE.

Rückgabewert

TRUE, was bedeutet, dass das Listenelement hinzugefügt wird. Andernfalls bedeutet dies, FALSEdass das Listenelement nicht hinzugefügt wird, da der bInsertUnique Parameter und das durch den lpszOption Parameter angegebene Listenelement bereits vorhanden istTRUE.

CMFCPropertyGridProperty::AddSubItem

Fügt einer Eigenschaft ein untergeordnetes Element hinzu.

BOOL AddSubItem(CMFCPropertyGridProperty* pProp);

Parameter

pProp
[in] Zeiger auf eine hinzuzufügende Eigenschaft.

Rückgabewert

TRUE wenn die angegebene Eigenschaft erfolgreich als untergeordnete Eigenschaft hinzugefügt wird. FALSE wenn die Eigenschaft nicht hinzugefügt wird, da sie bereits in der übergeordneten Eigenschaft auftritt.

Hinweise

Verwenden Sie diese Methode, um eine hierarchische Liste der übergeordneten und untergeordneten Eigenschaften zu erstellen. Nachdem eine untergeordnete Eigenschaft hinzugefügt wurde, zeigt die übergeordnete Eigenschaft automatisch ein Erweiterungsfeld-Steuerelement an, das durch ein Pluszeichen (+) festgelegt ist. Wenn der Benutzer das Pluszeichen auswählt, wird die übergeordnete Eigenschaft erweitert und zeigt alle untergeordneten Eigenschaftselemente an.

CMFCPropertyGridProperty::AdjustButtonRect

Wird vom übergeordneten Eigenschaftenlistensteuerelement aufgerufen, um eine Eigenschaft anzuweisen, die Größe des umgebenden Rechtecks einer eingebetteten Schaltfläche zu ändern.

virtual void AdjustButtonRect();

Hinweise

Standardmäßig gilt für diese Methode:

• Passt die Breite der Schaltfläche an, die der Höhe der Schaltfläche plus drei Pixel entspricht.
• Verschiebt das umgebende Rechteck der Schaltfläche an den rechten Rand der Eigenschaft.
• Verschiebt die Schaltfläche um 1 Pixel unter dem oberen Rand der Eigenschaft.

CMFCPropertyGridProperty::AdjustInPlaceEditRect

Ruft die Begrenzungen des Textfelds und des optionalen Drehfeld-Steuerelements ab, das zum Festlegen eines Eigenschaftswerts verwendet wird.

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

Parameter

rectEdit
[out] Wenn diese Methode zurückgegeben wird, gibt ein Rechteck, das die Grenzen des Textfelds für den Eigenschaftswert angibt.

rectSpin
[out] Wenn diese Methode zurückgegeben wird, gibt ein Rechteck, das die Grenzen des Drehfeld-Steuerelements für den Eigenschaftswert angibt. Oder, wenn die Eigenschaft keine Drehschaltfläche unterstützt, ein leeres Rechteck.

Hinweise

Der Wertbereich einer Eigenschaft besteht aus einem Textfeld und möglicherweise einer Optionsschaltfläche, z. B. einem Drehfeld-Steuerelement. Diese Methode berechnet die Abmessungen des Textfelds und der Optionsschaltfläche und gibt diese Werte dann in den angegebenen Parametern zurück.

CMFCPropertyGridProperty::AllowEdit

Macht eine Eigenschaft entweder bearbeitbar oder schreibgeschützt.

void AllowEdit(BOOL bAllow=TRUE);

Parameter

bAllow
[in] TRUE um die Eigenschaft bearbeitbar zu machen; FALSE um die Eigenschaft schreibgeschützt zu machen. Der Standardwert ist TRUE.

CMFCPropertyGridProperty::CMFCPropertyGridProperty

Erstellt ein CMFCPropertyGridProperty-Objekt.

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

Parameter

strGroupName
[in] Der Gruppenname. Eine Gruppe ist eine Auflistung verwandter Eigenschaften in einem Eigenschaftenrastersteuerelement. Wenn das Steuerelement hierarchisch angezeigt wird, wird der Gruppenname als Kategorietitel in der Zeile oberhalb der Gruppe angezeigt.

dwData
[in] Anwendungsspezifische Daten, z. B. eine ganze Zahl oder ein Zeiger auf andere Daten, die der Eigenschaft zugeordnet sind. Der Standardwert ist 0.

strName
[in] Der Name der Eigenschaft.

varValue
[in] Der Eigenschaftswert.

lpszDescr
[in] Die Eigenschaftsbeschreibung. Der Standardwert ist NULL.

lpszEditMask
[in] Das Bearbeitungsformat, wenn es sich bei der Eigenschaft um ein maskiertes Bearbeitungssteuerelement handelt. Der Standardwert ist NULL.

lpszEditTemplate
[in] Die Bearbeitungsvorlage, wenn es sich bei der Eigenschaft um ein maskiertes Bearbeitungssteuerelement handelt. Der Standardwert ist NULL.

lpszValidChars
[in] Eine Liste gültiger Zeichen, wenn es sich bei der Eigenschaft um ein maskiertes Bearbeitungssteuerelement handelt. Der Standardwert ist NULL.

bIsValueList
[in] TRUE wenn die Eigenschaft eine Liste von Werten darstellt; FALSE wenn die Eigenschaft einen einzelnen Wert darstellt. Der Standardwert ist FALSE.

CMFCPropertyGridProperty::CreateCombo

Wird vom Framework aufgerufen, um einer Eigenschaft ein Kombinationsfeld hinzuzufügen.

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

Parameter

pWndParent
[in] Zeigen Sie auf das übergeordnete Fenster des Kombinationsfelds.

rect
[in] Das umgebende Rechteck des Kombinationsfelds.

Rückgabewert

Zeiger auf ein neues CComboBox Objekt.

CMFCPropertyGridProperty::CreateInPlaceEdit

Vom Framework aufgerufen, um ein bearbeitbares Steuerelement für eine Eigenschaft zu erstellen.

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

Parameter

rectEdit
[in] Das umgebende Rechteck des bearbeitbaren Steuerelements.

bDefaultFormat
[in] TRUE um den Text des bearbeitbaren Steuerelements mithilfe des Standardeigenschaftenformats festzulegen; andernfalls . FALSE

Rückgabewert

Ein Zeiger auf das bearbeitbare Steuerelement, wenn diese Methode erfolgreich ist; andernfalls . NULL

Hinweise

Diese Methode verwendet die Werte der varValueim Klassenkonstruktor angegebenen CMFCPropertyGridProperty Parameter , lpszEditMask, und lpszEditTemplatelpszValidChars die Werte. Standardmäßig unterstützt diese Methode die varValue Variantentypen. Dazu gehören VT_BSTR, , VT_R4, , VT_UI1VT_R8, VT_INTVT_I4VT_UINTVT_UI2VT_I2, , und . VT_UI4VT_BOOL

Diese Methode erstellt ein CMFCMaskedEdit Steuerelement, wenn mindestens eins der lpszEditMaskParameter lpszEditTemplatelpszValidChars angegeben wird. Andernfalls wird ein CEdit Steuerelement erstellt.

CMFCPropertyGridProperty::CreateSpinControl

Vom Framework aufgerufen, um ein bearbeitbares Drehfeld-Steuerelement zu erstellen.

virtual CSpinButtonCtrl* CreateSpinControl(CRect rectSpin);

Parameter

rectSpin
[in] Ein Rechteck, das definiert, wo das bearbeitbare Drehfeld-Steuerelement erstellt wird.

Rückgabewert

Ein Zeiger auf ein neues CMFCSpinButtonCtrl Objekt, das als Zeiger auf ein CSpinButtonCtrl Objekt umgegossen wird.

Hinweise

Rufen Sie die CMFCPropertyGridProperty::EnableSpinControl Methode auf, um ein bearbeitbares Drehfeld-Steuerelement am rechten Rand der Eigenschaft anzuzeigen.

CMFCPropertyGridProperty::Enable

Aktiviert oder deaktiviert eine Eigenschaft.

void Enable(BOOL bEnable=TRUE);

Parameter

bEnable
[in] TRUE um die Eigenschaft zu aktivieren; FALSE um die Eigenschaft zu deaktivieren. Deaktivierte Eigenschaften reagieren nicht auf Maus- oder Tastatureingaben. Der Standardwert ist TRUE.

CMFCPropertyGridProperty::EnableSpinControl

Aktiviert oder deaktiviert ein Drehfeld-Steuerelement, das zum Ändern eines Eigenschaftswerts verwendet wird.

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

Parameter

bEnable
[in] TRUE um das Drehfeld-Steuerelement zu aktivieren; FALSE um das Drehfeld-Steuerelement zu deaktivieren. Der Standardwert ist TRUE.

nMin
[in] Der Mindestwert des Drehfeld-Steuerelements. Der Standardwert ist 0.

nMax
[in] Der Maximalwert des Drehfeld-Steuerelements. Der Standardwert ist 0.

Hinweise

Das Framework erstellt automatisch ein Drehfeld-Steuerelement, wenn eine Eigenschaft gerade bearbeitet werden soll.

Der Eigenschaftstyp, der durch den varValue Parameter des CMFCPropertyGridProperty::CMFCPropertyGridProperty Konstruktors angegeben wird, muss ein unterstützter Variant-Typ sein. Andernfalls wird diese Methode im Debugmodus bestätigt. Zu den unterstützten Typen gehören VT_INT: , VT_UINT, , VT_I2, VT_I4, VT_UI2und VT_UI4.

CMFCPropertyGridProperty::Expand

Erweitert oder reduziert eine Eigenschaft, die Untereigenschaften enthält.

void Expand(BOOL bExpand=TRUE);

Parameter

bExpand
[in] TRUE um die Eigenschaft zu erweitern; FALSE um die Eigenschaft zu reduzieren. Der Standardwert ist TRUE.

CMFCPropertyGridProperty::FormatProperty

Formatiert die Textdarstellung eines Eigenschaftswerts.

virtual CString FormatProperty();

Rückgabewert

Die Textdarstellung des Eigenschaftswerts.

Hinweise

Diese Methode wird vom Framework aufgerufen, bevor der Eigenschaftswert angezeigt wird.

CMFCPropertyGridProperty::GetData

Ruft einen DWORD Wert ab, der einer Eigenschaft zugeordnet ist.

DWORD_PTR GetData() const;

Rückgabewert

Ein DWORD-Wert.

Hinweise

Die zurückgegebenen Daten sind ein anwendungsspezifischer Wert, z. B. eine Zahl oder ein Zeiger auf andere Daten. Geben Sie den Datenwert an, wenn Sie die Eigenschaft erstellen oder die Methode aufrufen CMFCPropertyGridProperty::SetData .

CMFCPropertyGridProperty::GetDescription

Ruft eine Eigenschaftsbeschreibung ab.

const CString& GetDescription() const;

Rückgabewert

Eine Textzeichenfolge, die die Eigenschaftsbeschreibung enthält.

Hinweise

Das Eigenschaftenlistensteuerelement verwendet diese Methode auch, um die Beschreibung der Eigenschaft anzuzeigen.

CMFCPropertyGridProperty::GetExpandedSubItems

Ruft die Anzahl der erweiterten Unterelemente ab.

int GetExpandedSubItems(BOOL bIncludeHidden=TRUE) const;

Parameter

bIncludeHidden
[in] TRUE um die ausgeblendeten Unterelemente in die Anzahl einzuschließen; andernfalls . FALSE Der Standardwert ist TRUE.

Rückgabewert

Die Anzahl der erweiterten Unterelemente.

CMFCPropertyGridProperty::GetHierarchyLevel

Ruft den nullbasierten Index der Hierarchieebene der Eigenschaft ab.

int GetHierarchyLevel() const;

Rückgabewert

Die hierarchische Ebene der Eigenschaft.

CMFCPropertyGridProperty::GetName

Ruft den Namen der Eigenschaft ab.

LPCTSTR GetName() const;

Rückgabewert

Zeigen Sie auf eine Zeichenfolge, die den Namen der Eigenschaft enthält.

CMFCPropertyGridProperty::GetNameTooltip

Wird vom Framework aufgerufen, um den Namen der Eigenschaft in einer QuickInfo anzuzeigen.

virtual CString GetNameTooltip();

Rückgabewert

Eine Zeichenfolge, die den Namen der Eigenschaft enthält. Standardmäßig ist der Rückgabewert die leere Zeichenfolge.

CMFCPropertyGridProperty::GetOption

Ruft den Text der Option ab, die durch einen Index angegeben wird.

LPCTSTR GetOption(int nIndex) const;

Parameter

nIndex
Der nullbasierte Index des abzurufenden Eigenschaftslistenelements (Option).

Rückgabewert

Zeigen Sie auf eine Zeichenfolge, die den Optionstext enthält.

CMFCPropertyGridProperty::GetOptionCount

Ruft die Anzahl der Optionen ab, die zu einer Eigenschaft gehören.

int GetOptionCount() const;

Rückgabewert

Die Anzahl der Eigenschaftenlistenelemente (Optionen), die im Eigenschaftensteuerelement enthalten sind.

Hinweise

Rufen Sie die CMFCPropertyGridProperty::AddOption Methode auf, um der Eigenschaftenliste Elemente hinzuzufügen. Rufen Sie die CMFCPropertyGridProperty::RemoveAllOptions Methode auf, um alle Elemente zu entfernen.

CMFCPropertyGridProperty::GetOriginalValue

Ruft den Anfangswert der aktuellen Eigenschaft ab.

const COleVariant& GetOriginalValue() const;

Rückgabewert

Der ursprüngliche Wert der aktuellen Eigenschaft.

Hinweise

Verwenden Sie diese Methode, um die Auswirkung eines Bearbeitungsvorgangs rückgängig zu machen, der den Wert der aktuellen Eigenschaft ändert.

Der ursprüngliche Wert der aktuellen Eigenschaft wird vom CMFCPropertyGridProperty::CMFCPropertyGridProperty Konstruktor festgelegt, von der CMFCPropertyGridProperty::SetOriginalValue Methode geändert und von der CMFCPropertyGridProperty::ResetOriginalValue Methode zurückgesetzt.

CMFCPropertyGridProperty::GetParent

Ruft einen Zeiger auf eine übergeordnete Eigenschaft ab.

CMFCPropertyGridProperty* GetParent() const;

Rückgabewert

Ein Zeiger auf ein übergeordnetes Eigenschaftsobjekt oder NULL für die Eigenschaft der obersten Ebene.

CMFCPropertyGridProperty::GetRect

Ruft das umgebende Rechteck einer Eigenschaft ab.

CRect GetRect() const;

Rückgabewert

Ein CRect Objekt, das das umgebende Rechteck beschreibt.

CMFCPropertyGridProperty::GetSubItem

Ruft eine Untereigenschaft ab, die durch einen nullbasierten Index identifiziert wird.

CMFCPropertyGridProperty* GetSubItem(int nIndex) const;

Parameter

nIndex
[in] Der nullbasierte Index der abzurufenden Eigenschaft. Dieser Parameter ist ungültig, wenn er kleiner als null oder größer oder gleich der Anzahl der Untereigenschaften ist.

Rückgabewert

Ein Zeiger auf ein Eigenschaftsobjekt, das ein untergeordnetes Element dieser Eigenschaft ist.

Oder

Im Einzelhandelsmodus, NULL wenn der nIndex Parameter ungültig ist. Im Debugmodus bestätigt diese Methode.

CMFCPropertyGridProperty::GetSubItemsCount

Ruft die Anzahl der Unterelemente ab.

int GetSubItemsCount() const;

Rückgabewert

Die Anzahl der untergeordneten Elemente.

CMFCPropertyGridProperty::GetValue

Ruft einen Eigenschaftswert ab.

virtual const _variant_t& GetValue() const;

Rückgabewert

Eine Variante, die den Eigenschaftswert enthält.

CMFCPropertyGridProperty::GetValueTooltip

Wird vom Framework aufgerufen, um die Textdarstellung des Eigenschaftswerts abzurufen, der dann in einer QuickInfo angezeigt wird.

virtual CString GetValueTooltip();

Rückgabewert

Ein CString Objekt, das die Textdarstellung des Eigenschaftswerts enthält. Dieser Wert ist standardmäßig die leere Zeichenfolge.

CMFCPropertyGridProperty::HasButton

Gibt an, ob eine Eigenschaft eine Schaltfläche enthält.

virtual BOOL HasButton() const;

Rückgabewert

TRUEwenn eine Eigenschaft eine Schaltfläche (oder Eigenschaftsliste) enthält; andernfalls . FALSE

CMFCPropertyGridProperty::HitTest

Verweist auf das Eigenschaftsobjekt, das dem Eigenschaftslistenelement entspricht, das einem Punkt entspricht.

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

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

Parameter

point
[in] Der zu testde Punkt in Clientkoordinaten. Dieser Parameter ist in der Regel die aktuelle Position des Mauszeigers.

pt
[in] Der zu testde Punkt in Clientkoordinaten.

pnArea
[out] Wenn diese Methode zurückgegeben wird, wird der Bereich angegeben, der den angegebenen Punkt enthält. Weitere Informationen finden Sie in den Hinweisen. Der Standardwert ist NULL.

bPropsOnly
[in] TRUE um einen beliebigen Bereich im Eigenschaftensteuerelement zu testen; FALSE um nur den Beschreibungsbereich zu testen. Der Standardwert ist FALSE.

Rückgabewert

Ein Zeiger auf ein Eigenschaftsobjekt oder NULLein .

Hinweise

Standardmäßig testet diese Methode Eigenschaftsunterelemente, wenn der angegebene Punkt in keinem der Eigenschaftselemente gefunden wird.

In der folgenden Tabelle sind die Werte aufgeführt, die an den pnArea Parameter zurückgegeben werden können.

Bereich	Beschreibung
ClickArea::ClickExpandBox	Das Erweiterungsfeld-Steuerelement, das durch ein Pluszeichen (+) festgelegt wird.
ClickArea::ClickName	Der Eigenschaftenname.
ClickArea::ClickValue	Der Eigenschaftswert.

CMFCPropertyGridProperty::Init

Vom Framework aufgerufen, um ein Eigenschaftsobjekt zu initialisieren.

void Init();

CMFCPropertyGridProperty::IsAllowEdit

Gibt an, ob eine Eigenschaft bearbeitbar ist.

BOOL IsAllowEdit() const;

Rückgabewert

TRUE wenn die Eigenschaft bearbeitbar ist; andernfalls FALSE.

CMFCPropertyGridProperty::IsEnabled

Gibt an, ob eine Eigenschaft aktiviert oder deaktiviert ist.

BOOL IsEnabled() const;

Rückgabewert

TRUE wenn die Eigenschaft aktiviert ist; FALSE wenn die Eigenschaft deaktiviert ist.

Hinweise

Gibt an, ob eine Eigenschaft aktiviert oder deaktiviert ist.

CMFCPropertyGridProperty::IsExpanded

Gibt an, ob eine Eigenschaft erweitert oder reduziert ist.

BOOL IsExpanded() const;

Rückgabewert

TRUE wenn die Eigenschaft erweitert wird; FALSE wenn die Eigenschaft reduziert ist.

CMFCPropertyGridProperty::IsGroup

Gibt an, ob die aktuelle Eigenschaft eine Gruppe darstellt.

BOOL IsGroup() const;

Rückgabewert

TRUE wenn das aktuelle Eigenschaftsobjekt eine Gruppe darstellt; FALSE wenn die Eigenschaft einen Wert darstellt.

Hinweise

Eine Gruppe ist eine Auflistung verwandter Eigenschaften in einem Eigenschaftenrastersteuerelement. Wenn das Steuerelement hierarchisch angezeigt wird, wird der Gruppenname als Kategorietitel in der Zeile oberhalb der Gruppe angezeigt.

CMFCPropertyGridProperty::IsInPlaceEditing

Gibt an, ob die aktuelle Eigenschaft bearbeitet werden kann.

BOOL IsInPlaceEditing() const;

Rückgabewert

TRUEwenn die aktuelle Eigenschaft bearbeitbar ist; andernfalls . FALSE

CMFCPropertyGridProperty::IsModified

Gibt an, ob die aktuelle Eigenschaft geändert wird.

BOOL IsModified() const;

Rückgabewert

TRUEwenn die Eigenschaft geändert wird; andernfalls . FALSE

CMFCPropertyGridProperty::IsParentExpanded

Gibt an, ob die übergeordneten Elemente der aktuellen Eigenschaft erweitert werden.

BOOL IsParentExpanded() const;

Rückgabewert

TRUE wenn alle übergeordneten Elemente der aktuellen Eigenschaft erweitert werden; FALSE wenn die übergeordneten Eigenschaften reduziert sind.

CMFCPropertyGridProperty::IsSelected

Gibt an, ob die aktuelle Eigenschaft ausgewählt ist.

virtual BOOL IsSelected() const;

Rückgabewert

TRUEwenn die aktuelle Eigenschaft ausgewählt ist; andernfalls . FALSE

CMFCPropertyGridProperty::IsSubItem

Gibt an, ob die angegebene Eigenschaft ein Unterelement der aktuellen Eigenschaft ist.

BOOL IsSubItem(CMFCPropertyGridProperty* pProp) const;

Parameter

pProp
[in] Ein Zeiger auf eine Eigenschaft.

Rückgabewert

TRUEwenn die angegebene Eigenschaft ein Unterelement der aktuellen Eigenschaft ist; andernfalls . FALSE

CMFCPropertyGridProperty::IsValueChanged

Gibt an, ob sich der Wert der aktuellen Eigenschaft geändert hat.

virtual BOOL IsValueChanged() const;

Rückgabewert

TRUEwenn sich der Wert der aktuellen Eigenschaft geändert hat; andernfalls . FALSE

CMFCPropertyGridProperty::IsVisible

Gibt an, ob die aktuelle Eigenschaft sichtbar ist.

BOOL IsVisible() const;

Rückgabewert

TRUE wenn die aktuelle Eigenschaft sichtbar ist; Andernfalls; FALSE.

CMFCPropertyGridProperty::m_strFormatDouble

Enthält eine Formatzeichenfolge für einen Wert vom Typ Double.

static CString m_strFormatDouble;

CMFCPropertyGridProperty::m_strFormatFloat

Enthält eine Formatzeichenfolge für einen Wert vom Typ Float.

static CString m_strFormatFloat;

CMFCPropertyGridProperty::m_strFormatLong

Enthält eine Formatzeichenfolge für einen Wert vom Typ Long.

static CString m_strFormatLong;

CMFCPropertyGridProperty::m_strFormatShort

Enthält eine Formatzeichenfolge für einen Kurzen Wert.

static CString m_strFormatShort;

CMFCPropertyGridProperty::OnClickButton

Wird vom Framework aufgerufen, wenn der Benutzer eine Schaltfläche auswählt, die in einer Eigenschaft enthalten ist.

virtual void OnClickButton(CPoint point);

Parameter

point
[in] Ein Punkt in Clientkoordinaten.

Hinweise

Standardmäßig hat diese Methode keine Auswirkungen.

CMFCPropertyGridProperty::OnClickName

Wird von einem übergeordneten Eigenschaftenlistensteuerelement aufgerufen, wenn ein Benutzer das Namensfeld einer Eigenschaft auswählt.

virtual void OnClickName(CPoint C);

Parameter

C
[in] Ein Punkt in Clientkoordinaten.

Hinweise

Standardmäßig hat diese Methode keine Auswirkungen.

CMFCPropertyGridProperty::OnClickValue

Wird von einem übergeordneten Eigenschaftenlistensteuerelement aufgerufen, wenn ein Benutzer das Wertfeld einer Eigenschaft auswählt.

virtual BOOL OnClickValue(
    UINT uiMsg,
    CPoint point);

Parameter

uiMsg
[in] Eine Mausnachricht.

point
[in] Ein Punkt in Clientkoordinaten.

Rückgabewert

TRUEwenn die angegebene Mausnachricht von dieser Methode verarbeitet wird; andernfalls . FALSE

Hinweise

Diese Methode gibt standardmäßig zurück FALSE , wenn die aktuelle Eigenschaft nicht bearbeitet werden kann. Andernfalls verarbeitet das Bearbeitungs- oder Drehsteuerelement, das dieser Eigenschaft zugeordnet ist, die angegebene Mausnachricht, und dann gibt diese Methode zurück TRUE.

CMFCPropertyGridProperty::OnCloseCombo

Wird vom Framework aufgerufen, wenn ein Kombinationsfeld, das in einer Eigenschaft enthalten ist, geschlossen wird.

virtual void OnCloseCombo();

CMFCPropertyGridProperty::OnCtlColor

Wird vom Framework aufgerufen, wenn ein Pinsel abgerufen werden muss, um die Hintergrundfarbe einer Eigenschaft auszufüllen.

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

Parameter

pDC
[in] Zeiger auf einen Gerätekontext.

nCtlColor
[in] (Dieser Parameter wird nicht verwendet.)

Rückgabewert

Der Ziehpunkt für einen Pinsel, wenn diese Methode erfolgreich ist; andernfalls . NULL

CMFCPropertyGridProperty::OnDblClk

Wird vom Framework aufgerufen, wenn der Benutzer auf eine Eigenschaft doppelklicken soll.

virtual BOOL OnDblClk(CPoint point);

Parameter

point
[in] Ein Punkt in Clientkoordinaten.

Rückgabewert

TRUEwenn diese Methode erfolgreich ist; andernfalls . FALSE

Hinweise

Standardmäßig wählt diese Methode das nächste Eigenschaftselement im Eigenschaftenlistensteuerelement aus.

CMFCPropertyGridProperty::OnDestroyWindow

Wird vom Framework aufgerufen, wenn eine Eigenschaft zerstört oder die Bearbeitung abgeschlossen ist.

virtual void OnDestroyWindow();

CMFCPropertyGridProperty::OnDrawButton

Wird vom Framework aufgerufen, um eine Schaltfläche zu zeichnen, die in einer Eigenschaft enthalten ist.

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

Parameter

pDC
[in] Ein Zeiger auf einen Gerätekontext.

rectButton
[in] Ein umgebendes Rechteck, das angibt, wo eine Schaltfläche gezeichnet werden soll.

CMFCPropertyGridProperty::OnDrawDescription

Wird vom Framework aufgerufen, um die Eigenschaftsbeschreibung zu zeichnen.

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

Parameter

pDC
[in] Ein Zeiger auf einen Gerätekontext.

rect
[in] Ein umgebendes Rechteck, das angibt, wo die Eigenschaftsbeschreibung gezeichnet werden soll.

Hinweise

Standardmäßig zeichnet diese Methode den Eigenschaftennamen und die Beschreibung in der Schriftart, die vom übergeordneten Eigenschaftenlistensteuerelement verwendet wird. Die Eigenschaftenbeschreibung wird in normaler Formatvorlage gezeichnet, und der Eigenschaftenname wird fett formatiert gezeichnet.

CMFCPropertyGridProperty::OnDrawExpandBox

Wird vom Framework aufgerufen, um ein Erweiterungsfeld-Steuerelement in der Nähe einer Eigenschaft zu zeichnen, die Untereigenschaften enthält.

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

Parameter

pDC
[in] Ein Zeiger auf einen Gerätekontext.

rectExpand
[in] Ein umgebendes Rechteck, das angibt, wo das Erweiterungsfeld-Steuerelement gezeichnet werden soll.

Hinweise

Wählen Sie das Erweiterungsfeld-Steuerelement aus, um eine Liste von Untereigenschaften zu erweitern oder zu reduzieren. Das Erweiterungsfeld-Steuerelement wird durch ein Quadrat festgelegt, das ein Pluszeichen (+) oder Minuszeichen (-) enthält. Ein Pluszeichen gibt an, dass die Eigenschaft erweitert werden kann, um eine Liste von Untereigenschaften anzuzeigen. Ein Minuszeichen gibt an, dass die Liste reduziert werden kann, um nur die Eigenschaft anzuzeigen.

CMFCPropertyGridProperty::OnDrawName

Wird vom Framework aufgerufen, um den Eigenschaftennamen anzuzeigen.

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

Parameter

pDC
[in] Ein Zeiger auf einen Gerätekontext.

rect
[in] Ein umgebendes Rechteck, das angibt, wo der Eigenschaftsname gezeichnet werden soll.

CMFCPropertyGridProperty::OnDrawValue

Wird vom Framework aufgerufen, um die Liste der Eigenschaftenwerte anzuzeigen.

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

Parameter

pDC
[in] Ein Zeiger auf einen Gerätekontext.

rect
[in] Ein umgebendes Rechteck, das angibt, wo der Eigenschaftswert gezeichnet werden soll.

CMFCPropertyGridProperty::OnEdit

Wird vom Framework aufgerufen, wenn der Benutzer dabei ist, einen Eigenschaftenwert zu bearbeiten.

virtual BOOL OnEdit(LPPOINT lptClick);

Parameter

lptClick
[in] (Dieser Parameter wird nicht verwendet.) Ein Zeiger auf einen Punkt in Clientkoordinaten.

Rückgabewert

TRUEwenn der Bearbeitungsvorgang erfolgreich gestartet wird; andernfalls . FALSE

Hinweise

Diese Funktion wird vom Framework aufgerufen, wenn der Benutzer einen Eigenschaftswert ändern möchte. Standardmäßig startet diese Methode den entsprechenden Editor für ein Kombinationsfeld-Steuerelement oder ein Drehsteuerelement.

CMFCPropertyGridProperty::OnEndEdit

Wird vom Framework aufgerufen, wenn der Benutzer mit dem Ändern eines Eigenschaftswerts fertig ist.

virtual BOOL OnEndEdit();

Rückgabewert

Diese Methode gibt immer TRUE zurück.

Hinweise

Standardmäßig zerstört diese Methode das aktuelle Bearbeitungssteuerelement und gibt dann zurück TRUE.

CMFCPropertyGridProperty::OnKillFocus

Wird vom Framework aufgerufen, wenn die Eigenschaft den Eingabefokus verliert.

virtual BOOL OnKillFocus(CWnd*);

Parameter

CWnd
[in] (Nicht verwendet.) Zeiger auf ein Fenster.

Rückgabewert

Diese Methode gibt immer TRUE zurück.

Hinweise

Standardmäßig führt diese Methode nichts aus und gibt dann zurück TRUE. Wenn Sie diese Methode außer Kraft setzen, geben Sie zurück TRUE , wenn das Framework den Bearbeitungsvorgang beenden kann, wenn die Eigenschaft den Eingabefokus verliert.

CMFCPropertyGridProperty::OnKillSelection

virtual void OnKillSelection(CMFCPropertyGridProperty*);

Parameter

[in] CMFCPropertyGridProperty*\

Hinweise

Standardmäßig hat diese Methode keine Auswirkungen.

CMFCPropertyGridProperty::OnPosSizeChanged

virtual void OnPosSizeChanged(CRect);

Parameter

[in] CRect\

Hinweise

Standardmäßig hat diese Methode keine Auswirkungen.

CMFCPropertyGridProperty::OnRClickName

Wird vom Framework aufgerufen, wenn der Benutzer im Eigenschaftennamenbereich die rechte Maustaste auswählt.

virtual void OnRClickName(CPoint C);

Parameter

C
[in] Ein Punkt in Clientkoordinaten.

Hinweise

Standardmäßig hat diese Methode keine Auswirkungen.

CMFCPropertyGridProperty::OnRClickValue

Wird vom Framework aufgerufen, wenn der Benutzer die rechte Maustaste im Eigenschaftswertbereich auswählt.

virtual void OnRClickValue(
    CPoint C,
    BOOL B);

Parameter

C
[in] Ein Punkt in Clientkoordinaten.

B
[in] Ein Boolescher Wert.

Hinweise

Standardmäßig führt diese Methode nichts aus, und der B Parameter hat keinen vordefinierten Zweck.

CMFCPropertyGridProperty::OnSelectCombo

Wird vom Framework aufgerufen, wenn der Benutzer ein Element aus dem bearbeitbaren Kombinationsfeld auswählt.

virtual void OnSelectCombo();

Hinweise

Standardmäßig verwendet diese Methode den Text des ausgewählten Elements, um den Eigenschaftswert zu aktualisieren.

CMFCPropertyGridProperty::OnSetCursor

Wird vom Framework aufgerufen, wenn der Mauszeiger zu einem Eigenschaftselement wechselt.

virtual BOOL OnSetCursor() const;

Rückgabewert

TRUEwenn es sich bei der aktuellen Eigenschaft um einen Variantentyp oder eine Liste von Werten handelt, und diese Methode die Einfügemarke (I-Balken) erfolgreich lädt; andernfalls . FALSE

Hinweise

Diese Methode unterstützt die folgenden Variantentypen: VT_INT, , VT_I2, VT_I4, VT_UINT, VT_UI1, VT_UI2, VT_UI4, , VT_R4, , und VT_R8.VT_BSTR

CMFCPropertyGridProperty::OnSetSelection

virtual void OnSetSelection CMFCPropertyGridProperty*);

Parameter

[in] CMFCPropertyGridProperty*\

Hinweise

Standardmäßig hat diese Methode keine Auswirkungen.

CMFCPropertyGridProperty::OnUpdateValue

Wird vom Framework aufgerufen, wenn der Wert einer änderbaren Eigenschaft geändert wurde.

virtual BOOL OnUpdateValue();

Rückgabewert

TRUEwenn diese Methode erfolgreich ist; andernfalls . FALSE

CMFCPropertyGridProperty::PushChar

Wird aus dem Eigenschaftenlistensteuerelement aufgerufen, wenn die Eigenschaft ausgewählt ist und der Benutzer ein neues Zeichen eingibt.

virtual BOOL PushChar(UINT nChar);

Parameter

nChar
[in] Ein Zeichen.

Rückgabewert

TRUEwenn der Bearbeitungsvorgang fortgesetzt wird; andernfalls . FALSE

Hinweise

Diese Methode unterstützt eine Eigenschaft, die entweder eine Liste von Werten oder eine der folgenden Variantentypen ist: VT_INT, , , VT_I2, VT_I4, VT_UI2VT_UI4VT_UI1VT_R4VT_UINTund . VT_R8VT_BSTR

CMFCPropertyGridProperty::Redraw

Redraws the property.

void Redraw();

CMFCPropertyGridProperty::RemoveAllOptions

Entfernt alle Optionen (Elemente) aus einer Eigenschaft.

void RemoveAllOptions();

Hinweise

Optionen werden auch als Listenelemente eines Eigenschaftenlistensteuerelements bezeichnet.

CMFCPropertyGridProperty::RemoveSubItem

Entfernt das angegebene Unterelement.

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

Parameter

pProp
[in] Zeiger auf ein Eigenschaftsunterelement.

bDelete
[in] TRUE um das Eigenschaftsobjekt zu löschen, das durch den pProp Parameter angegeben wird; andernfalls . FALSE Der Standardwert ist TRUE.

Rückgabewert

Bemerkungen

Geben Sie FALSE für den bDelete Parameter an, wenn Sie das angegebene Unterelement verschieben möchten. Das heißt, entfernen Sie das Unterelement, und fügen Sie es an anderer Stelle hinzu.

CMFCPropertyGridProperty::ResetOriginalValue

Stellt den ursprünglichen Wert einer bearbeiteten Eigenschaft wieder her.

virtual void ResetOriginalValue();

CMFCPropertyGridProperty::SetData

Ordnet einen DWORD Wert einer Eigenschaft zu.

void SetData(DWORD_PTR dwData);

Parameter

dwData
[in] Ein anwendungsspezifischer 32-Bit-Wert, z. B. eine ganze Zahl oder ein Zeiger auf andere Daten.

Hinweise

Verwenden Sie die CMFCPropertyGridProperty::GetData Methode, um den DWORD Wert abzurufen. Verwenden Sie die CMFCPropertyGridCtrl::FindItemByData Methode, um das Eigenschaftslistenelement zu suchen, das dem angegebenen DWORD Wert zugeordnet ist.

CMFCPropertyGridProperty::SetDescription

Gibt den Text an, der die aktuelle Eigenschaft beschreibt.

void SetDescription(const CString& strDescr);

Parameter

strDescr
[in] Text, der die aktuelle Eigenschaft beschreibt.

CMFCPropertyGridProperty::SetName

Legt den Namen einer Eigenschaft fest.

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

Parameter

lpszName
[in] Der Name der Eigenschaft.

bRedraw
[in] TRUE die Eigenschaft sofort neu zu zeichnen; andernfalls . FALSE Der Standardwert ist TRUE.

CMFCPropertyGridProperty::SetOriginalValue

Legt den ursprünglichen Wert einer bearbeitbaren Eigenschaft fest.

virtual void SetOriginalValue(const COleVariant& varValue);

Parameter

varValue
[in] Ein Wert.

Hinweise

Verwenden Sie die CMFCPropertyGridProperty::ResetOriginalValue Methode, um den ursprünglichen Wert einer bearbeiteten Eigenschaft zurückzusetzen.

CMFCPropertyGridProperty::SetValue

Legt den Wert einer Eigenschaftsrastereigenschaft fest.

virtual void SetValue(const _variant_t& varValue);

Parameter

varValue
[in] Ein Verweis auf den Wert, auf den die Eigenschaft festgelegt werden soll.

Beispiel: 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

Blendet eine Eigenschaft ein oder aus.

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

Parameter

bShow
[in] TRUE um die aktuelle Eigenschaft und die zugehörigen Unterelemente anzuzeigen; FALSE um die aktuelle Eigenschaft und die zugehörigen Unterelemente auszublenden. Der Standardwert ist TRUE.

bAdjustLayout
[in] TRUE um neu zu berechnen, wie die Beschriftung und der Wert einer Eigenschaft gezeichnet und dann die Eigenschaft gezeichnet werden; FALSE zum Zeichnen der Eigenschaft vorhandene Berechnungen verwenden. Der Standardwert ist TRUE.

Siehe auch

Hierarchiediagramm
Klassen
CMFCPropertyGridCtrl-Klasse