CMFCPropertyGridCtrl-Klasse

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.

Unterstützt ein bearbeitbares Eigenschaftenraster-Steuerelement, das Eigenschaften in alphabetischer oder hierarchischer Reihenfolge anzeigen kann.

Syntax

class CMFCPropertyGridCtrl : public CWnd

Member

Öffentliche Konstruktoren

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

Öffentliche Methoden

Name	Beschreibung
CMFCPropertyGridCtrl::accHitTest	Wird durch das Framework aufgerufen, um das untergeordnete Element oder untergeordnete Objekt an einem bestimmten Punkt auf dem Bildschirm abzurufen. (Überschreibt CWnd::accHitTest.)
CMFCPropertyGridCtrl::accLocation	Wird durch das Framework aufgerufen, um die aktuelle Bildschirmposition des angegebenen Objekts abzurufen. (Überschreibt CWnd::accLocation.)
CMFCPropertyGridCtrl::accSelect	Wird durch das Framework aufgerufen, um die Auswahl zu ändern oder den Tastaturfokus des angegebenen Objekts zu verschieben. (Überschreibt CWnd::accSelect.)
CMFCPropertyGridCtrl::AddProperty	Fügt einem Eigenschaftenrastersteuerelement eine neue Eigenschaft hinzu.
CMFCPropertyGridCtrl::AlwaysShowUserToolTip
CMFCPropertyGridCtrl::CloseColorPopup	Schließt das Dialogfeld für die Farbauswahl.
CMFCPropertyGridCtrl::Create	Erstellt ein Eigenschaftenraster-Steuerelement und fügt es an das Objekt des Eigenschaftenrastersteuerelements an.
CMFCPropertyGridCtrl::DeleteProperty	Löscht die angegebene Eigenschaft aus dem Eigenschaftenrastersteuerelement.
CMFCPropertyGridCtrl::DrawControlBarColors
CMFCPropertyGridCtrl::EnableDescriptionArea	Aktiviert oder deaktiviert den Beschreibungsbereich, der unter der Liste der Eigenschaften angezeigt wird.
CMFCPropertyGridCtrl::EnableHeaderCtrl	Aktiviert oder deaktiviert das Kopfzeilensteuerelement am oberen Rand des Eigenschaftenrastersteuerelements.
CMFCPropertyGridCtrl::EnsureVisible	Scrollt ein Eigenschaftenrastersteuerelement und erweitert Eigenschaftselemente, bis die angegebene Eigenschaft sichtbar ist.
CMFCPropertyGridCtrl::ExpandAll	Erweitert oder reduziert alle Knoten des Eigenschaftenrastersteuerelements.
CMFCPropertyGridCtrl::FindItemByData	Ruft die Eigenschaft ab, die einem benutzerdefinierten DWORD Wert zugeordnet ist.
CMFCPropertyGridCtrl::get_accChild	Wird durch das Framework aufgerufen, um die Adresse einer IDispatch-Schnittstelle für das angegebene, untergeordnete Element abzurufen. (Überschreibt CWnd::get_accChild.)
CMFCPropertyGridCtrl::get_accChildCount	Wird durch das Framework aufgerufen, um die Zahl der untergeordneten Elemente abzurufen, die zu diesem Objekt gehören. (Überschreibt CWnd::get_accChildCount.)
CMFCPropertyGridCtrl::get_accDefaultAction	Wird durch das Framework aufgerufen, um eine Zeichenfolge abzurufen, die die Standardaktion des Objekts beschreibt. (Überschreibt CWnd::get_accDefaultAction.)
CMFCPropertyGridCtrl::get_accDescription	Wird durch das Framework aufgerufen, um eine Zeichenfolge abzurufen, die die visuelle Darstellung des angegebenen Objekts beschreibt. (Überschreibt CWnd::get_accDescription.)
CMFCPropertyGridCtrl::get_accFocus	Wird durch das Framework aufgerufen, um das Objekt abzurufen, das den Tastaturfokus hat. (Überschreibt CWnd::get_accFocus.)
CMFCPropertyGridCtrl::get_accHelp	Vom Framework aufgerufen, um die Eigenschaftszeichenfolge Help eines Objekts abzurufen. (Überschreibt CWnd::get_accHelp.)
CMFCPropertyGridCtrl::get_accHelpTopic	Wird durch das Framework aufgerufen, um den vollständigen Pfad der WinHelp-Datei abzurufen, die mit dem angegebenen Objekt verbunden ist und dem Bezeichner des passenden Themas innerhalb dieser Datei. (Überschreibt CWnd::get_accHelpTopic.)
CMFCPropertyGridCtrl::get_accKeyboardShortcut	Wird durch das Framework aufgerufen, um die Tastenkombination oder Zugriffstaste des angegebenen Objekts abzurufen. (Überschreibt CWnd::get_accKeyboardShortcut.)
CMFCPropertyGridCtrl::get_accName	Wird durch das Framework aufgerufen, um den Namen des angegebenen Objekts abzurufen. (Überschreibt CWnd::get_accName.)
CMFCPropertyGridCtrl::get_accRole	Wird durch das Framework aufgerufen, um Informationen abzurufen, die die Rolle des angegebenen Objekts beschreiben. (Überschreibt CWnd::get_accRole.)
CMFCPropertyGridCtrl::get_accSelection	Wird durch das Framework aufgerufen, um die ausgewählten, untergeordneten Elemente dieses Objekts abzurufen. (Überschreibt CWnd::get_accSelection.)
CMFCPropertyGridCtrl::get_accState	Wird durch das Framework aufgerufen, um den aktuellen Status des angegebenen Objekts abzurufen. (Überschreibt CWnd::get_accState.)
CMFCPropertyGridCtrl::get_accValue	Wird durch das Framework aufgerufen, um den Wert des angegebenen Objekts abzurufen. (Überschreibt CWnd::get_accValue.)
CMFCPropertyGridCtrl::GetBkColor	Ruft die Hintergrundfarbe des aktuellen Eigenschaftenrastersteuerelements ab.
CMFCPropertyGridCtrl::GetBoldFont	Ruft die Windows-Schriftart des Texts im aktuellen Eigenschaftenraster-Steuerelement fett formatiert ab.
CMFCPropertyGridCtrl::GetCurSel	Ruft die aktuell ausgewählte Eigenschaft ab.
CMFCPropertyGridCtrl::GetCustomColors	Ruft die benutzerdefinierten Farben ab, die derzeit für Eigenschaftenrastersteuerelementelemente definiert sind.
CMFCPropertyGridCtrl::GetDescriptionHeight	Ruft die Höhe des Beschreibungsbereichs am unteren Rand des Eigenschaftenrastersteuerelements ab.
CMFCPropertyGridCtrl::GetDescriptionRows	Ruft die Anzahl der Zeilen im Beschreibungsbereich des aktuellen Eigenschaftenrastersteuerelements ab.
CMFCPropertyGridCtrl::GetHeaderCtrl	Ruft das interne CMFCHeaderCtrl Objekt ab, das vom Framework zum Anzeigen des aktuellen Eigenschaftenrastersteuerelements verwendet wird.
CMFCPropertyGridCtrl::GetHeaderHeight	Ruft die Höhe der Kopfzeile des Eigenschaftenrastersteuerelements ab.
CMFCPropertyGridCtrl::GetLeftColumnWidth	Ruft die Breite der linken Spalte des aktuellen Eigenschaftenraster-Steuerelements ab, die den Namen jeder Eigenschaft enthält.
CMFCPropertyGridCtrl::GetListRect	Ruft das umgebende Rechteck des Eigenschaftenraster-Steuerelements ab.
CMFCPropertyGridCtrl::GetProperty	Ruft einen Zeiger auf das Eigenschaftsobjekt ab, das dem angegebenen Index eines Eigenschaftsrastersteuerelementelements entspricht.
CMFCPropertyGridCtrl::GetPropertyColumnWidth	Ruft die aktuelle Breite der Spalte ab, die Eigenschaftswerte enthält.
CMFCPropertyGridCtrl::GetPropertyCount	Ruft die Anzahl der Eigenschaften in einem Eigenschaftenraster-Steuerelement ab.
CMFCPropertyGridCtrl::GetRowHeight	Ruft die Höhe einer Zeile im Eigenschaftenraster-Steuerelement ab.
CMFCPropertyGridCtrl::GetScrollBarCtrl	Ruft einen Zeiger auf das Bildlaufleisten-Steuerelement im Eigenschaftenraster-Steuerelement ab. (Überschreibt CWnd::GetScrollBarCtrl.)
CMFCPropertyGridCtrl::GetTextColor	Ruft die Farbe des Texts von Eigenschaftenelementen im aktuellen Eigenschaftenraster-Steuerelement ab.
CMFCPropertyGridCtrl::GetThisClass	Wird vom Framework verwendet, um einen Zeiger auf das CRuntimeClass Objekt abzurufen, das diesem Klassentyp zugeordnet ist.
CMFCPropertyGridCtrl::HitTest	Ruft einen Zeiger auf das Eigenschaftsobjekt ab, das einem Element des Eigenschaftenrastersteuerelements entspricht, wenn sich ein angegebener Punkt im Element befindet. Diese Methode gibt auch den Bereich im Eigenschaftenraster-Steuerelement an, der den Punkt enthält.
CMFCPropertyGridCtrl::InitHeader	Initialisiert das interne CMFCHeaderCtrl Objekt, das vom Framework zum Anzeigen des aktuellen Eigenschaftenrastersteuerelements verwendet wird.
CMFCPropertyGridCtrl::IsAlphabeticMode	Gibt an, ob sich ein Eigenschaftenrastersteuerelement im alphabetischen Modus befindet.
CMFCPropertyGridCtrl::IsAlwaysShowUserToolTip
CMFCPropertyGridCtrl::IsDescriptionArea	Gibt an, ob der Beschreibungsbereich des Eigenschaftenrastersteuerelements angezeigt wird.
CMFCPropertyGridCtrl::IsGroupNameFullWidth	Gibt an, ob jeder Eigenschaftengruppenname über die Breite des aktuellen Eigenschaftenrastersteuerelements angezeigt wird.
CMFCPropertyGridCtrl::IsHeaderCtrl	Gibt an, ob das Kopfzeilensteuerelement angezeigt wird.
CMFCPropertyGridCtrl::IsMarkModifiedProperties	Gibt an, wie das Eigenschaftenrastersteuerelement geänderte Eigenschaften anzeigt.
CMFCPropertyGridCtrl::IsShowDragContext	Gibt an, ob das Framework die Namen- und Wertspalten des aktuellen Eigenschaftenrastersteuerelements neu gezeichnet, wenn ein Benutzer die Größe der Spalten ändert.
CMFCPropertyGridCtrl::IsVSDotNetLook	Gibt an, ob sich das Erscheinungsbild des Eigenschaftenrastersteuerelements in der Formatvorlage befindet, die von VS .NET verwendet wird.
CMFCPropertyGridCtrl::MarkModifiedProperties	Gibt an, wie geänderte Eigenschaften angezeigt werden.
CMFCPropertyGridCtrl::PreTranslateMessage	Wird von der Klasse CWinApp verwendet, um Fenstermeldungen zu übersetzen, bevor sie an die TranslateMessage Funktionen und DispatchMessage Windows verteilt werden. (Überschreibt CWnd::PreTranslateMessage.)
CMFCPropertyGridCtrl::RemoveAll	Entfernt alle Eigenschaftsobjekte aus einem Eigenschaftenrastersteuerelement.
CMFCPropertyGridCtrl::ResetOriginalValues	Stellt den ursprünglichen Wert aller Eigenschaften wieder her.
CMFCPropertyGridCtrl::SetAlphabeticMode	Legt den alphabetischen Modus fest oder setzt sie zurück.
CMFCPropertyGridCtrl::SetBoolLabels	Gibt den Text boolescher Beschriftungen an.
CMFCPropertyGridCtrl::SetCurSel	Wählt eine Eigenschaft in einem Eigenschaftenraster-Steuerelement aus.
CMFCPropertyGridCtrl::SetCustomColors	Gibt benutzerdefinierte Farben für verschiedene Eigenschaftenrastersteuerelementelemente an.
CMFCPropertyGridCtrl::SetDescriptionRows	Gibt die Anzahl der Zeilen an, die im Beschreibungsbereich des aktuellen Eigenschaftenrastersteuerelements angezeigt werden sollen.
CMFCPropertyGridCtrl::SetGroupNameFullWidth	Gibt an, ob die vollständige Breite des Kategorienamens für eine Gruppe von Eigenschaften im aktuellen Eigenschaftenrastersteuerelement angezeigt werden soll.
CMFCPropertyGridCtrl::SetListDelimiter	Definiert ein Zeichen, das als Trennzeichen in einer Liste von Eigenschaftswerten verwendet wird.
CMFCPropertyGridCtrl::SetShowDragContext	Gibt an, ob das Framework den Namen und die Wertspalten des aktuellen Eigenschaftenrastersteuerelements neu angibt, wenn ein Benutzer die Größe der Spalten ändert.
CMFCPropertyGridCtrl::SetVSDotNetLook	Legt die Darstellung des Eigenschaftenrastersteuerelements auf die Formatvorlage fest, die in VS .NET verwendet wird.
CMFCPropertyGridCtrl::UpdateColor	Legt den Farbwert der aktuell ausgewählten Farbeigenschaft fest.

Geschützte Methoden

Name	Beschreibung
CMFCPropertyGridCtrl::AdjustLayout	Neurastern des Eigenschaftenrastersteuerelements und der zugehörigen Eigenschaften.
CMFCPropertyGridCtrl::CompareProps	Wird vom Eigenschaftenrastersteuerelement zum Sortieren von Eigenschaften aufgerufen.
CMFCPropertyGridCtrl::EditItem	Wird vom Framework aufgerufen, wenn der Benutzer beginnt, eine Eigenschaft zu ändern.
CMFCPropertyGridCtrl::EndEditItem	Wird vom Framework aufgerufen, wenn der Benutzer die Änderung einer Eigenschaft beendet.
CMFCPropertyGridCtrl::Init	Wird vom Framework aufgerufen, um ein Eigenschaftenrastersteuerelement zu initialisieren.
CMFCPropertyGridCtrl::OnChangeSelection	Wird vom Framework aufgerufen, wenn die aktuelle Auswahl geändert wird.
CMFCPropertyGridCtrl::OnClickButton	Wird vom Framework aufgerufen, wenn auf eine Eigenschaftenschaltfläche geklickt wird.
CMFCPropertyGridCtrl::OnDrawBorder	Wird vom Framework aufgerufen, um einen Rahmen um ein Eigenschaftenrastersteuerelement zu zeichnen.
CMFCPropertyGridCtrl::OnDrawDescription	Vom Framework aufgerufen, um den Beschreibungsbereich zu zeichnen und den Beschreibungstext anzuzeigen.
CMFCPropertyGridCtrl::OnDrawList	Wird vom Framework aufgerufen, um die Liste der Eigenschaften im Eigenschaftenrastersteuerelement anzuzeigen.
CMFCPropertyGridCtrl::OnDrawProperty	Vom Framework aufgerufen, um eine Eigenschaft anzuzeigen.
CMFCPropertyGridCtrl::OnPropertyChanged	Wird vom Framework aufgerufen, wenn der Wert einer Eigenschaft geändert wird.
CMFCPropertyGridCtrl::OnSelectCombo	Wird vom Framework aufgerufen, wenn eine Eigenschaft, die ein Kombinationsfeld-Steuerelement enthält, ausgewählt wird.
CMFCPropertyGridCtrl::ValidateItemData	Vom Framework aufgerufen, um Eigenschaftsdaten zu überprüfen.

Hinweise

Die CMFCPropertyGridCtrl Klasse zeigt ein Eigenschaftenrastersteuerelement an, das bearbeitbare Eigenschaften enthält, die von der CMFCPropertyGridProperty Klasse abgeleitet sind. Jede Eigenschaft kann einen Typ darstellen und kann Unterelemente enthalten. Das Eigenschaftenraster-Steuerelement unterstützt einen verkleinerbaren Bereich unten, der die Beschreibung einer ausgewählten Eigenschaft anzeigen kann.

Um ein Eigenschaftenrastersteuerelement zu verwenden, erstellen Sie ein CMFCPropertyGridCtrl Objekt, und rufen Sie dann die CMFCPropertyGridCtrl::Create Methode auf. Verwenden Sie die CMFCPropertyGridCtrl::AddProperty Methode, um der Liste Eigenschaften hinzuzufügen.

Auswahleigenschaften

Anstatt einen Wert darzustellen, kann ein Eigenschaftenelement ein Dialogfeld starten, in dem der Benutzer eine Farbe, Datei oder Schriftart auswählen kann.

In der folgenden Tabelle sind vier Auswahleigenschaftentypen aufgeführt:

Klasse	Beschreibung
CMFCPropertyGridProperty Klasse	Eine allgemeine Eigenschaft, die verwendet wird, um den Wert von Zeichenfolgen, Booleans, Datumsangaben usw. anzugeben.
CMFCPropertyGridColorProperty Klasse	Eine Eigenschaft, die zum Auswählen eines Farbwerts verwendet wird.
CMFCPropertyGridFileProperty Klasse	Eine Eigenschaft, die zum Auswählen einer Datei verwendet wird.
CMFCPropertyGridFontProperty Klasse	Eine Eigenschaft, die zum Auswählen einer Schriftart verwendet wird.

Abbildungen

Die folgenden Abbildungen zeigen ein Eigenschaftenrastersteuerelement, das Eigenschaften auf zwei Arten anzeigt. In der ersten Abbildung werden hierarchische Eigenschaften angezeigt, und die zweite zeigt alphabetisch Eigenschaften an.

Beispiel

Im folgenden Beispiel wird veranschaulicht, wie Ein Eigenschaftenraster-Steuerelementobjekt mithilfe verschiedener Methoden in der CMFCPropertyGridCtrl Klasse konfiguriert wird. Das Beispiel veranschaulicht, wie sie das Kopfzeilensteuerelement aktivieren, den Beschreibungsbereich aktivieren und die Darstellung des Eigenschaftenrastersteuerelements festlegen. Das Beispiel zeigt auch, wie der alphabetische Modus für das Steuerelement festgelegt wird, wobei das Steuerelement alle darin enthaltenen Eigenschaften nach dem Eigenschaftennamen sortiert und wie die benutzerdefinierten Farben für verschiedene Elemente des Eigenschaftenrastersteuerelements festgelegt werden. Dieses Beispiel ist Teil des Beispiels "Neue Steuerelemente".

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

Vererbungshierarchie

CObject

CCmdTarget

CWnd

CMFCPropertyGridCtrl

Anforderungen

Header: afxpropertygridctrl.h

CMFCPropertyGridCtrl::accSelect

virtual HRESULT accSelect(
    long flagsSelect,
    VARIANT varChild);

Parameter

[in] flagsSelect
[in] varChild\

Rückgabewert

Bemerkungen

CMFCPropertyGridCtrl::AddProperty

Fügt einem Eigenschaftenrastersteuerelement eine neue Eigenschaft hinzu.

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

Parameter

pProp
[in] Zeiger auf eine Eigenschaft.

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

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

Rückgabewert

Wenn diese Methode erfolgreich ist, wird der nullbasierte Index der Position im Eigenschaftenrastersteuerelement, in dem die Eigenschaft hinzugefügt wird, hinzugefügt. andernfalls -1.

Hinweise

Mit dieser Methode wird der angegebenen Eigenschaft am Ende der Liste der Eigenschaften im Eigenschaftenrastersteuerelement ein Zeiger hinzugefügt. Zerstören Sie die Eigenschaften nicht, oder erlauben Sie es ihnen, den Gültigkeitsbereich zu verlassen, bevor das Rastersteuerelement zerstört wird. Wenn Sie mit dem Eigenschaftenrastersteuerelement fertig sind, rufen CMFCPropertyGridCtrl::RemoveAll Sie auf, um alle hinzugefügten Eigenschaften zu löschen. Die AddProperty-Methode schlägt fehl, wenn die angegebene Eigenschaft der Liste bereits hinzugefügt wurde.

CMFCPropertyGridCtrl::AdjustLayout

Neurastern des Eigenschaftenrastersteuerelements und der zugehörigen Eigenschaften.

virtual void AdjustLayout();

Hinweise

Mit dieser Methode wird neu berechnet, wie das gesamte Eigenschaftenrastersteuerelement und dessen Eigenschaften einschließlich Bildern, Schriftarten und Steuerelementen gezeichnet werden.

CMFCPropertyGridCtrl::AlwaysShowUserToolTip

void AlwaysShowUserToolTip(BOOL bShow = TRUE);

Parameter

[in] bShow\

Hinweise

CMFCPropertyGridCtrl::CloseColorPopup

Schließt das Dialogfeld für die Farbauswahl.

virtual void CloseColorPopup();

Hinweise

Weitere Informationen zum Dialogfeld "Farbauswahl" finden Sie unter CMFCPropertyGridColorProperty "Klasse".

CMFCPropertyGridCtrl::CMFCPropertyGridCtrl

Erstellt ein CMFCPropertyGridCtrl-Objekt.

CMFCPropertyGridCtrl();

Rückgabewert

Bemerkungen

CMFCPropertyGridCtrl::CompareProps

Wird vom Eigenschaftenrastersteuerelement zum Sortieren von Eigenschaften aufgerufen.

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

Parameter

pProp1
Ein Zeiger auf eine Eigenschaft.

pProp2
Ein Zeiger auf eine Eigenschaft.

Rückgabewert

Rückgabewert	Beschreibung
< 0	Der Name des pProp1 Parameters ist kleiner als der Name des pProp2 Parameters.
0	Der Name des pProp1 Parameters entspricht dem Namen des pProp2 Parameters.
> 0	Der Name des pProp1 Objekts ist größer als der Name des pProp2 Parameters.

Hinweise

Standardmäßig verwendet diese Methode die CString::Compare Methode, um die CMFCPropertyGridProperty::m_strName Member der angegebenen Parameter zu vergleichen.

CMFCPropertyGridCtrl::Create

Erstellt ein Eigenschaftenraster-Steuerelement und fügt es an das Objekt des Eigenschaftenrastersteuerelements an.

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

Parameter

dwStyle
[in] Eine bitweise Kombination "oder" (|) von Fensterformatvorlagen.

rect
[in] Ein umgebendes Rechteck, das die Größe und Position des Fensters in Clientkoordinaten angibt pParentWnd.

pParentWnd
[in] Zeiger auf das übergeordnete Fenster. Dieser Wert darf nicht NULL sein.

nID
[in] Die ID des untergeordneten Fensters.

Rückgabewert

TRUEwenn das Fenster erfolgreich erstellt wurde; andernfalls . FALSE

Hinweise

Zum Erstellen eines Eigenschaftenrastersteuerelements rufen CMFCPropertyGridCtrl::CMFCPropertyGridCtrl Sie zuerst auf, um ein Eigenschaftsrasterobjekt zu erstellen. Rufen Sie dann CMFCPropertyGridCtrl::Create auf.

Beispiel

Im folgenden Beispiel wird die Verwendung der Methode in CMFCPropertyGridCtrl der Create Klasse veranschaulicht. Dieses Beispiel ist Teil des Beispiels "Neue Steuerelemente".

// CRect rectPropList
// CMFCPropertyGridCtrl m_wndPropList
// The this pointer points to a CPage5 class which extends the CMFCPropertyPage class.
m_wndPropList.Create(WS_CHILD | WS_VISIBLE | WS_TABSTOP | WS_BORDER, rectPropList, this, (UINT)-1);

CMFCPropertyGridCtrl::DeleteProperty

Löscht die angegebene Eigenschaft aus dem Eigenschaftenrastersteuerelement.

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

Parameter

pProp
[in] Zeiger auf eine Eigenschaft.

bRedraw
[in] TRUE um das Eigenschaftenrastersteuerelement neu zu zeichnen; andernfalls . FALSE Der Standardwert ist TRUE.

bAdjustLayout
[in] TRUE um neu zu berechnen, wie alle Text, Bilder und Elemente im Eigenschaftenrastersteuerelement gezeichnet werden, und zeichnen Sie dann das Steuerelement; andernfalls . FALSE Der Standardwert ist TRUE.

Rückgabewert

TRUEwenn diese Methode erfolgreich ist; andernfalls . FALSE

Hinweise

Verwenden Sie diese Methode, um eine Eigenschaft und alle Unterelemente aus dem Eigenschaftenrastersteuerelement zu löschen.

CMFCPropertyGridCtrl::DrawControlBarColors

BOOL DrawControlBarColors() const;

Rückgabewert

Bemerkungen

CMFCPropertyGridCtrl::EditItem

Wird vom Framework aufgerufen, wenn der Benutzer beginnt, eine Eigenschaft zu ändern.

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

Parameter

pProp
[in] Zeiger auf eine Eigenschaft.

lptClick
[in] Der Punkt auf dem Eigenschaftenrastersteuerelement, auf das der Benutzer geklickt hat, um den Bearbeitungsvorgang zu starten. Der Punkt befindet sich in den Clientkoordinaten des Steuerelements. Der Standardwert ist NULL.

Rückgabewert

TRUEwenn die Methode erfolgreich ist; andernfalls . FALSE

Hinweise

CMFCPropertyGridCtrl::EnableDescriptionArea

Aktiviert oder deaktiviert den Beschreibungsbereich, der unter der Liste der Eigenschaften im Eigenschaftenrastersteuerelement angezeigt wird.

void EnableDescriptionArea(BOOL bEnable=TRUE);

Parameter

bEnable
[in] TRUE um den Beschreibungsbereich zu aktivieren; FALSE um den Beschreibungsbereich zu deaktivieren. Der Standardwert ist TRUE.

Hinweise

Der Beschreibungsbereich wird unten im Eigenschaftenraster-Steuerelement angezeigt. Standardmäßig ist der Beschreibungsbereich deaktiviert und nicht sichtbar.

CMFCPropertyGridCtrl::EnableHeaderCtrl

Aktiviert oder deaktiviert das Kopfzeilensteuerelement am oberen Rand des Eigenschaftenrastersteuerelements.

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

Parameter

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

lpszLeftColumn
[in] Der Titel der linken Spalte des Kopfzeilensteuerelements. Der Standardwert ist Property.

lpszRightColumn
[in] Der Titel der rechten Spalte des Kopfzeilensteuerelements. Der Standardwert ist Value.

CMFCPropertyGridCtrl::EndEditItem

Wird vom Framework aufgerufen, wenn der Benutzer die Änderung einer Eigenschaft abgeschlossen hat.

virtual BOOL EndEditItem(BOOL bUpdateData=TRUE);

Parameter

bUpdateData
[in] TRUE um anzugeben, dass die geänderten Eigenschaftendaten überprüft werden müssen, wenn der Bearbeitungsvorgang abgeschlossen ist; andernfalls . FALSE Der Standardwert ist TRUE.

Rückgabewert

TRUE wenn der Bearbeitungsvorgang erfolgreich beendet wird; FALSE wenn die geänderten Eigenschaftendaten ungültig sind oder der Bearbeitungsvorgang fortgesetzt werden soll.

Hinweise

CMFCPropertyGridCtrl::EnsureVisible

Scrollt ein Eigenschaftenrastersteuerelement und erweitert Eigenschaftselemente, bis die angegebene Eigenschaft sichtbar ist.

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

Parameter

pProp
[in] Zeiger auf eine Eigenschaft.

bExpandParents
[in] TRUE um übergeordnete Elemente zu erweitern, um die angegebene Eigenschaft sichtbar zu machen; andernfalls . FALSE Der Standardwert ist FALSE.

Hinweise

CMFCPropertyGridCtrl::ExpandAll

Erweitert oder reduziert alle Knoten des Eigenschaftenrastersteuerelements.

void ExpandAll(BOOL bExpand=TRUE);

Parameter

bExpand
[in] TRUE um alle Knoten zu erweitern; FALSE um alle Knoten zu reduzieren. Der Standardwert ist TRUE.

Hinweise

CMFCPropertyGridCtrl::FindItemByData

Ruft die Eigenschaft ab, die einem benutzerdefinierten DWORD Wert zugeordnet ist.

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

Parameter

dwData
[in] Ein DWORD Wert.

bSearchSubItems
[in] TRUE um Unterelemente von Eigenschaften zu durchsuchen; andernfalls . FALSE Der Standardwert ist TRUE.

Rückgabewert

Ein Zeiger auf das zugeordnete Eigenschaftsobjekt, wenn diese Methode erfolgreich ist; andernfalls . NULL

Hinweise

Verwenden Sie den Konstruktor oder CMFCPropertyGridProperty::SetData die CMFCPropertyGridCtrl::CMFCPropertyGridCtrl Methode, um eine DWORD Eigenschaft zuzuordnen.

CMFCPropertyGridCtrl::get_accChildCount

virtual HRESULT get_accChildCount(long* pcountChildren);

Parameter

[in] pcountChildren\

Rückgabewert

Bemerkungen

CMFCPropertyGridCtrl::get_accFocus

virtual HRESULT get_accFocus(VARIANT* pvarChild);

Parameter

[in] pvarChild\

Rückgabewert

Bemerkungen

CMFCPropertyGridCtrl::get_accHelp

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

Parameter

[in] varChild
[in] pszHelp\

Rückgabewert

Bemerkungen

CMFCPropertyGridCtrl::get_accHelpTopic

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

Parameter

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

Rückgabewert

Bemerkungen

CMFCPropertyGridCtrl::get_accKeyboardShortcut

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

Parameter

[in] varChild
[in] pszKeyboardShortcut\

Rückgabewert

Bemerkungen

CMFCPropertyGridCtrl::get_accSelection

virtual HRESULT get_accSelection(VARIANT* pvarChildren);

Parameter

[in] pvarChildren\

Rückgabewert

Bemerkungen

CMFCPropertyGridCtrl::GetBkColor

Ruft die Hintergrundfarbe des aktuellen Eigenschaftenrastersteuerelements ab.

COLORREF GetBkColor() const;

Rückgabewert

Ein RGB-Farbwert.

Hinweise

Diese Methode ruft die Farbe ab, die das Framework zum Zeichnen des Hintergrunds des aktuellen Eigenschaftenrastersteuerelements verwendet. Die CMFCPropertyGridCtrl::GetTextColor Methode ruft die Vordergrundfarbe ab.

CMFCPropertyGridCtrl::GetBoldFont

Ruft die Windows-Schriftart ab, die zum Zeichnen von Text im aktuellen Eigenschaftenraster-Steuerelement in Fettformat verwendet wird.

CFont& GetBoldFont();

Rückgabewert

Ein Verweis auf ein CFont Objekt, das die Merkmale einer fett formatierten Schriftart beschreibt.

CMFCPropertyGridCtrl::GetCurSel

Ruft die aktuell ausgewählte Eigenschaft ab.

CMFCPropertyGridProperty* GetCurSel() const;

Rückgabewert

Ein Zeiger auf das Eigenschaftsobjekt, das dem ausgewählten Element im Eigenschaftenrastersteuerelement entspricht.

Hinweise

CMFCPropertyGridCtrl::GetCustomColors

Ruft die benutzerdefinierten Farben ab, die derzeit für Eigenschaftenrastersteuerelementelemente definiert sind.

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

Parameter

clrBackground
[out] Die Hintergrundfarbe von Eigenschaftswerten.

clrText
[out] Die Farbe von Eigenschaftsnamen und Eigenschaftswerttext.

clrGroupBackground
[out] Die Hintergrundfarbe einer Eigenschaftengruppe.

clrGroupText
[out] Die Farbe des Texts in der Eigenschaftengruppe.

clrDescriptionBackground
[out] Die Hintergrundfarbe des Beschreibungsbereichs.

clrDescriptionText
[out] Die Textfarbe im Beschreibungsbereich.

clrLine
[out] Die Farbe der Linien, die zwischen Eigenschaften gezeichnet werden.

Hinweise

Verwenden Sie die CMFCPropertyGridCtrl::SetCustomColors Methode, um benutzerdefinierte Farben festzulegen.

CMFCPropertyGridCtrl::GetDescriptionHeight

Ruft die Höhe des Beschreibungsbereichs ab, der sich am unteren Rand des Eigenschaftenrastersteuerelements befindet.

int GetDescriptionHeight() const;

Rückgabewert

Die Höhe des Beschreibungsbereichs in Pixel.

Hinweise

Die Höhe des Beschreibungsbereichs wird automatisch berechnet und auf 1/4 der Höhe des Eigenschaftenrastersteuerelements festgelegt.

Verwenden Sie die CMFCPropertyGridCtrl::EnableDescriptionArea Methode, um den Beschreibungsbereich anzuzeigen oder auszublenden. Verwenden Sie die CMFCPropertyGridCtrl::IsDescriptionArea Methode, um zu bestimmen, ob der Beschreibungsbereich angezeigt oder ausgeblendet wird.

CMFCPropertyGridCtrl::GetDescriptionRows

Ruft die Anzahl der Zeilen im Beschreibungsbereich des aktuellen Eigenschaftenrastersteuerelements ab.

int GetDescriptionRows() const;

Rückgabewert

Die Anzahl der Zeilen im Beschreibungsbereich des aktuellen Eigenschaftenrastersteuerelements.

Hinweise

Der CMFCPropertyGridCtrl::CMFCPropertyGridCtrl Konstruktor initialisiert den Beschreibungsbereich auf 3 Zeilen.

CMFCPropertyGridCtrl::GetHeaderCtrl

Ruft das interne CMFCHeaderCtrl Objekt ab, das vom Framework zum Anzeigen des aktuellen Eigenschaftenrastersteuerelements verwendet wird.

virtual CMFCHeaderCtrl& GetHeaderCtrl();

Rückgabewert

Ein Verweis auf ein CMFCHeaderCtrl-Objekt.

CMFCPropertyGridCtrl::GetHeaderHeight

Ruft die Höhe der Kopfzeile eines Eigenschaftenrastersteuerelements ab.

int GetHeaderHeight() const;

Rückgabewert

Die Höhe der Kopfzeile in Pixel.

Hinweise

CMFCPropertyGridCtrl::GetLeftColumnWidth

Ruft die Breite der linken Spalte des aktuellen Eigenschaftenraster-Steuerelements ab, die den Namen jeder Eigenschaft enthält.

int GetLeftColumnWidth() const;

Rückgabewert

Die Breite der Namensspalte.

Hinweise

Die rechte Spalte eines Eigenschaftenraster-Steuerelements enthält den Wert jeder Eigenschaft.

CMFCPropertyGridCtrl::GetListRect

Ruft das umgebende Rechteck des Eigenschaftenraster-Steuerelements ab.

CRect GetListRect() const;

Rückgabewert

Das umgebende Rechteck des Eigenschaftenrastersteuerelements. Dieses Rectange enthält nicht den Beschreibungsbereich und die Kopfzeile.

Hinweise

CMFCPropertyGridCtrl::GetProperty

Ruft einen Zeiger auf das Eigenschaftsobjekt ab, das dem angegebenen Index eines Elements in einem Eigenschaftenrastersteuerelement entspricht.

CMFCPropertyGridProperty* GetProperty(int nIndex) const;

Parameter

nIndex
[in] Der nullbasierte Index eines Eigenschaftsraster-Steuerelementelements.

Diese Methode gibt an, ob der nIndex Parameter kleiner als null oder größer oder gleich der Anzahl der Eigenschaften ist.

Rückgabewert

Ein Zeiger auf das Eigenschaftsobjekt, das dem angegebenen Index entspricht, wenn diese Methode erfolgreich ist; andernfalls . NULL

Hinweise

CMFCPropertyGridCtrl::GetPropertyColumnWidth

Ruft die aktuelle Breite der Spalte ab, die Eigenschaftswerte enthält.

int GetPropertyColumnWidth() const;

Rückgabewert

Die aktuelle Breite der Spalte, die Eigenschaftswerte enthält.

Hinweise

Die Spalte rechts im Eigenschaftenrastersteuerelement enthält die Eigenschaftswerte. Ein Kunde kann das geteilte Feld des Eigenschaftenrastersteuerelements verwenden, um die Breite der Wertespalte zu ändern.

CMFCPropertyGridCtrl::GetPropertyCount

Ruft die Anzahl der Eigenschaften in einem Eigenschaftenraster-Steuerelement ab.

int GetPropertyCount() const;

Rückgabewert

Die Anzahl der Eigenschaften.

Hinweise

CMFCPropertyGridCtrl::GetRowHeight

Ruft die Höhe einer Zeile im Eigenschaftenraster-Steuerelement ab.

int GetRowHeight() const;

Rückgabewert

Die Höhe einer Zeile.

Hinweise

Die Höhe einer Zeile entspricht der aktuellen Schrifthöhe plus 4 Pixel.

CMFCPropertyGridCtrl::GetScrollBarCtrl

Ruft einen Zeiger auf das Bildlaufleisten-Steuerelement im Eigenschaftenraster-Steuerelement ab.

virtual CScrollBar* GetScrollBarCtrl(int nBar) const;

Parameter

nBar
[in] Die Ausrichtung der Bildlaufleiste, die sein SB_VERTmuss.

Rückgabewert

Ein Zeiger auf ein Bildlaufleistenobjekt oder NULL wenn keine Bildlaufleiste oder die Ausrichtung der Bildlaufleiste vorhanden ist SB_HORZ.

Hinweise

Verwenden Sie diese Methode, um direkten Zugriff auf das Steuerelement für die vertikale Bildlaufleiste zu erhalten.

CMFCPropertyGridCtrl::GetTextColor

Ruft die Farbe ab, die zum Zeichnen des Texts von Eigenschaftselementen im aktuellen Eigenschaftenrastersteuerelement verwendet wird.

COLORREF GetTextColor() const;

Rückgabewert

Ein RGB-Farbwert.

Hinweise

Diese Methode ruft die Farbe ab, die das Framework zum Zeichnen des Vordergrunds des aktuellen Eigenschaftenrastersteuerelements verwendet. Die CMFCPropertyGridCtrl::GetBkColor Methode ruft die Hintergrundfarbe ab.

CMFCPropertyGridCtrl::HitTest

Ruft einen Zeiger auf das Eigenschaftsobjekt ab, das einem Element des Eigenschaftenrastersteuerelements entspricht, wenn sich ein angegebener Punkt im Element befindet. Diese Methode gibt auch den Bereich im Eigenschaftenraster-Steuerelement an, der den Punkt enthält.

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

Parameter

pt
[in] Ein Punkt in Clientkoordinaten.

pnArea
[in, out] Ein Zeiger auf eine ClickArea Variable. Wenn diese Methode zurückgegeben wird, gibt die Variable den Eigenschaftenbereich an, der den angegebenen Punkt enthält. Weitere Informationen zu einem Eigenschaftenbereich finden Sie in den Hinweisen.

bPropsOnly
[in] TRUE nur den Eigenschaftenbereich zu testen; FALSE um den Beschreibungsbereich zu testen, wenn sich der angegebene Punkt nicht im Eigenschaftenbereich befindet. Der Standardwert ist FALSE. Weitere Informationen zum Beschreibungsbereich finden Sie in den Hinweisen.

Rückgabewert

Wenn sich der bPropsOnly Parameter befindet TRUE und sich der angegebene Punkt in einem Eigenschaftenbereich befindet, ist der Rückgabewert ein Zeiger auf das entsprechende Eigenschaftsobjekt. Darüber hinaus wird der pnArea Parameter auf den bestimmten Bereich festgelegt, der den angegebenen Punkt enthält. Andernfalls wird NULL der Rückgabewert und der pnArea Parameter nicht geändert.

Wenn der bPropsOnly Parameter lautet FALSE, ist der Rückgabewert immer NULL. Wenn sich der angegebene Punkt jedoch im Beschreibungsbereich befindet, wird der pnArea Parameter auf CMFCPropertyGridProperty::ClickDescription.

Hinweise

Der Begriffseigenschaftenbereich bezieht sich auf einen der Namen, Werte oder Erweiterungsfeldbereiche eines Eigenschaftsrasters-Steuerelementelements. Der Beschreibungsbereich ist die Zone am unteren Rand eines Eigenschaftenrastersteuerelements. Wenn Sie ein Eigenschaftenraster-Steuerelementelement auswählen, wird im Beschreibungsbereich eine Beschreibung der entsprechenden Eigenschaft angezeigt.

Diese Methode legt den Wert der Variablen fest, auf die der pnArea Parameter verweist. In der folgenden Tabelle sind die möglichen Werte und entsprechenden Bereiche aufgeführt.

Wert	Bereich
ClickArea::ClickExpandBox	Eigenschaftenerweiterungsfeld-Steuerelement.
ClickArea::ClickName	Eigenschaftenname.
ClickArea::ClickValue	Eigenschaftswert.
CMFCPropertyGridProperty::ClickDescription	Beschreibungsbereich des Eigenschaftenrastersteuerelements.

CMFCPropertyGridCtrl::Init

Wird vom Framework aufgerufen, um ein Eigenschaftenrastersteuerelement zu initialisieren.

virtual void Init();

Hinweise

CMFCPropertyGridCtrl::InitHeader

Initialisiert das interne CMFCHeaderCtrl Objekt, das vom Framework zum Anzeigen des aktuellen Eigenschaftenrastersteuerelements verwendet wird.

virtual void InitHeader();

CMFCPropertyGridCtrl::IsAlphabeticMode

Gibt an, ob sich ein Eigenschaftenrastersteuerelement im alphabetischen Modus befindet.

BOOL IsAlphabeticMode() const;

Rückgabewert

TRUE wenn sich das Eigenschaftenraster-Steuerelement im alphabetischen Modus befindet; andernfalls FALSE.

Hinweise

Wenn sich das Eigenschaftenrastersteuerelement im alphabetischen Modus befindet, werden alle Eigenschaften alphabetisch nach ihren Namen sortiert. Andernfalls werden Eigenschaften unter ihren übergeordneten Knoten gruppiert.

Verwenden Sie die Methode, um den CMFCPropertyGridCtrl::SetAlphabeticMode alphabetischen Modus zu aktivieren oder zu deaktivieren.

CMFCPropertyGridCtrl::IsAlwaysShowUserToolTip

BOOL IsAlwaysShowUserToolTip() const;

Rückgabewert

Bemerkungen

CMFCPropertyGridCtrl::IsDescriptionArea

Gibt an, ob der Beschreibungsbereich des Eigenschaftenrastersteuerelements angezeigt wird.

BOOL IsDescriptionArea() const;

Rückgabewert

TRUEwenn der Beschreibungsbereich angezeigt wird; andernfalls . FALSE

Hinweise

Verwenden Sie die CMFCPropertyGridCtrl::EnableDescriptionArea Methode, um den Beschreibungsbereich auszublenden oder anzuzeigen.

CMFCPropertyGridCtrl::IsGroupNameFullWidth

Gibt an, ob jeder Eigenschaftengruppenname über die Breite des aktuellen Eigenschaftenrastersteuerelements angezeigt wird.

BOOL IsGroupNameFullWidth() const;

Rückgabewert

TRUE wenn Gruppennamen über die Breite des Eigenschaftenrastersteuerelements angezeigt werden; FALSE wenn Gruppennamen von der rechten Spalte (Wert) des Steuerelements abgeschnitten werden.

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.

CMFCPropertyGridCtrl::IsHeaderCtrl

Gibt an, ob das Kopfzeilensteuerelement angezeigt wird.

BOOL IsHeaderCtrl() const;

Rückgabewert

TRUE wenn das Kopfzeilensteuerelement angezeigt wird; andernfalls FALSE.

Hinweise

Verwenden Sie die CMFCPropertyGridCtrl::EnableHeaderCtrl Methode, um das Kopfzeilensteuerelement auszublenden oder anzuzeigen.

CMFCPropertyGridCtrl::IsMarkModifiedProperties

Gibt an, wie das Eigenschaftenrastersteuerelement geänderte Eigenschaften anzeigt.

BOOL IsMarkModifiedProperties() const;

Rückgabewert

TRUE wenn die Fettformatvorlage verwendet wird, um geänderte Eigenschaften anzuzeigen; FALSE wenn die normale Formatvorlage verwendet wird, um geänderte Eigenschaften anzuzeigen.

Hinweise

CMFCPropertyGridCtrl::IsShowDragContext

Gibt an, ob das Framework die Namen- und Wertspalten des aktuellen Eigenschaftenrastersteuerelements neu gezeichnet, wenn ein Benutzer die Größe der Spalten ändert.

BOOL IsShowDragContext() const;

Rückgabewert

TRUE wenn das Framework die Namen- und Wertspalten während eines Größenänderungsvorgangs neu gezeichnet hat; FALSE wenn das Framework die Spalten nach Abschluss des Ziehvorgangs neu zeichnet.

Hinweise

Der Benutzer kann die Größe der Namen- und Wertspalten eines Eigenschaftenraster-Steuerelements ändern, indem er den geteilten Balken zwischen den Spalten zieht. Wenn der Ziehkontext angezeigt wird, werden die Spalten für Name und Wert geändert, solange der Benutzer die Geteilte Leiste zieht. Andernfalls wird die Teilleiste verschoben, aber die Spalten werden erst neu gezeichnet, wenn der Ziehvorgang abgeschlossen ist.

CMFCPropertyGridCtrl::IsVSDotNetLook

Gibt an, ob sich die Darstellung des Eigenschaftenrastersteuerelements im Stil von Visual Studio .NET befindet.

BOOL IsVSDotNetLook() const;

Rückgabewert

TRUEwenn sich das Eigenschaftenrastersteuerelement im Stil von Visual Studio .NET befindet; andernfalls . FALSE

Hinweise

Verwenden Sie die CMFCPropertyGridCtrl::SetVSDotNetLook Methode, um das Eigenschaftenrastersteuerelement auf die Formatvorlage von Visual Studio .NET festzulegen.

CMFCPropertyGridCtrl::MarkModifiedProperties

Gibt an, wie geänderte Eigenschaften angezeigt werden.

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

Parameter

bMark
[in] TRUE um geänderte Eigenschaften fett formatiert anzuzeigen; FALSE um geänderte Eigenschaften im regulären Stil anzuzeigen. Der Standardwert ist TRUE.

bRedraw
[in] TRUE um das Eigenschaftenrastersteuerelement sofort neu zu zeichnen; andernfalls . FALSE Der Standardwert ist TRUE.

Hinweise

CMFCPropertyGridCtrl::OnChangeSelection

Wird vom Framework aufgerufen, wenn die aktuelle Auswahl geändert wird.

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

Parameter

pNewSel
[in] Zeiger auf die neu ausgewählte Eigenschaft.

pOldSel
[in] Zeiger auf die zuvor ausgewählte Eigenschaft.

Hinweise

Die Standardimplementierung dieser Methode führt nichts aus.

CMFCPropertyGridCtrl::OnClickButton

Wird vom Framework aufgerufen, wenn auf eine Eigenschaftenschaltfläche geklickt wird.

virtual void OnClickButton(CPoint point);

Parameter

point
[in] Ein Punkt in Clientkoordinaten.

Hinweise

Standardmäßig aktualisiert diese Methode den aktuellen Eigenschaftswert.

CMFCPropertyGridCtrl::OnDrawBorder

Wird vom Framework aufgerufen, um einen Rahmen um ein Eigenschaftenrastersteuerelement zu zeichnen.

virtual void OnDrawBorder(CDC* pDC);

Parameter

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

Hinweise

CMFCPropertyGridCtrl::OnDrawDescription

Vom Framework aufgerufen, um den Beschreibungsbereich zu zeichnen und den Beschreibungstext anzuzeigen.

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

Parameter

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

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

Hinweise

Verwenden Sie die CMFCPropertyGridCtrl::EnableDescriptionArea Methode, um den Beschreibungsbereich anzuzeigen.

CMFCPropertyGridCtrl::OnDrawList

Wird vom Framework aufgerufen, um die Liste der Eigenschaften im Eigenschaftenrastersteuerelement anzuzeigen.

virtual void OnDrawList(CDC* pDC);

Parameter

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

Hinweise

CMFCPropertyGridCtrl::OnDrawProperty

Vom Framework aufgerufen, um eine Eigenschaft anzuzeigen.

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

Parameter

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

pProp
[in] Ein Zeiger auf ein Eigenschaftsobjekt.

Rückgabewert

TRUEwenn diese Methode erfolgreich ist; andernfalls . FALSE

Hinweise

CMFCPropertyGridCtrl::OnPropertyChanged

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

virtual void OnPropertyChanged(CMFCPropertyGridProperty* pProp) const;

Parameter

pProp
[in] Ein Zeiger auf ein Eigenschaftsobjekt, dessen Wert sich geändert hat.

Hinweise

Standardmäßig sendet diese Methode die AFX_WM_PROPERTY_CHANGED Nachricht an den Besitzer des Eigenschaftenrastersteuerelements.

CMFCPropertyGridCtrl::OnSelectCombo

Wird vom Framework aufgerufen, wenn eine Eigenschaft, die ein Kombinationsfeld-Steuerelement enthält, ausgewählt wird.

void OnSelectCombo();

Hinweise

CMFCPropertyGridCtrl::RemoveAll

Entfernt alle Eigenschaftsobjekte aus einem Eigenschaftenrastersteuerelement.

void RemoveAll();

Hinweise

CMFCPropertyGridCtrl::ResetOriginalValues

Stellt die ursprünglichen Werte aller Eigenschaften wieder her.

void ResetOriginalValues(BOOL bRedraw=TRUE);

Parameter

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

Hinweise

CMFCPropertyGridCtrl::SetAlphabeticMode

Legt den alphabetischen Modus fest oder setzt sie zurück.

void SetAlphabeticMode(BOOL bSet=TRUE);

Parameter

bSet
[in] TRUE zum Festlegen des alphabetischen Modus; FALSE Alphabetischer Modus zurücksetzen. Der Standardwert ist TRUE.

Hinweise

Wenn sich das Eigenschaftenraster-Steuerelement im alphabetischen Modus befindet, sortiert das Steuerelement alle Eigenschaften, die es enthält, anhand des Eigenschaftennamens.

CMFCPropertyGridCtrl::SetBoolLabels

Gibt den Text boolescher Beschriftungen an.

void SetBoolLabels(
    LPCTSTR lpszTrue,
    LPCTSTR lpszFalse);

Parameter

lpszTrue
[in] Die für den booleschen Wert "true" anzuzeigende Textzeichenfolge.

lpszFalse
[in] Die für den booleschen Wert "false" anzuzeigende Textzeichenfolge.

Hinweise

CMFCPropertyGridCtrl::SetCurSel

Wählt eine Eigenschaft in einem Eigenschaftenraster-Steuerelement aus.

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

Parameter

pProp
[in] Ein Zeiger auf ein Eigenschaftsobjekt.

bRedraw
[in] TRUE um das Eigenschaftenrastersteuerelement sofort neu zu zeichnen; andernfalls . FALSE Der Standardwert ist TRUE.

Hinweise

Mit dieser Methode können Sie die Auswahl des aktuellen Elements im Eigenschaftenrastersteuerelement abbrechen und dann das Element auswählen, das der angegebenen Eigenschaft entspricht.

CMFCPropertyGridCtrl::SetCustomColors

Gibt benutzerdefinierte Farben für verschiedene Elemente des Eigenschaftenrastersteuerelements an.

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

Parameter

clrBackground
[in] Die Hintergrundfarbe von Eigenschaftswerten.

clrText
[in] Die Farbe von Eigenschaftsnamen und Eigenschaftswerttext.

clrGroupBackground
[in] Die Hintergrundfarbe einer Eigenschaftengruppe.

clrGroupText
[in] Die neue Textfarbe der Eigenschaftengruppe.

clrDescriptionBackground
[in] Die Hintergrundfarbe des Beschreibungsbereichs.

clrDescriptionText
[in] Die Textfarbe im Beschreibungsbereich.

clrLine
[in] Die Farbe der Linien, die zwischen Eigenschaften gezeichnet werden.

Hinweise

Geben Sie für jeden Parameter den ((COLORREF)-1) Farbwert an, der für dieses Element des Eigenschaftenrastersteuerelements die Standardfarbe verwendet werden soll.

Um die Darstellung einer bestimmten Eigenschaft anzupassen, leiten Sie eine Klasse von der CMFCPropertyGridProperty Klasse ab und überschreiben dann die CMFCPropertyGridProperty::OnDrawNameMethoden , CMFCPropertyGridProperty::OnDrawValue, , CMFCPropertyGridProperty::OnDrawExpandBoxund CMFCPropertyGridProperty::OnDrawButton methoden.

CMFCPropertyGridCtrl::SetDescriptionRows

Gibt die Anzahl der Zeilen an, die im Beschreibungsbereich des aktuellen Eigenschaftenrastersteuerelements angezeigt werden sollen.

void SetDescriptionRows(int nDescRows);

Parameter

nDescRows
[in] Die Anzahl der Zeilen, die in der Eigenschaftenbeschreibung angezeigt werden sollen.

CMFCPropertyGridCtrl::SetGroupNameFullWidth

Gibt an, ob die vollständige Breite des Kategorienamens für eine Gruppe von Eigenschaften im aktuellen Eigenschaftenrastersteuerelement angezeigt werden soll.

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

Parameter

bGroupNameFullWidth
[in] TRUE um die vollständige Breite des Kategorienamens unabhängig von der Breite der Eigenschaftsnamenspalte anzuzeigen. FALSE um die Breite des Kategorienamens auf die Breite der Eigenschaftsnamenspalte zu beschränken. Der Standardwert ist TRUE.

bRedraw
[in] TRUE das Eigenschaftenrastersteuerelement sofort zu aktualisieren; FALSE um das Steuerelement zu aktualisieren, wenn das nächste Neuzeichnen-Ereignis auftritt. Der Standardwert ist TRUE.

Hinweise

Das Eigenschaftsraster-Steuerelement besteht aus einer Spalten mit geänderter Größe des Eigenschaftennamens und einer Eigenschaftswertspalte . Das Ende der Namensspalte ist auch der Anfang der Wertspalte. Um die Größe der Spalten zu ändern, ziehen Sie den Rahmen zwischen den Spalten.

Die Begriffe "Gruppenname " und "Kategoriename " werden in dieser Methode austauschbar verwendet. Der Kategoriename wird in einer Zeile angezeigt, die einen Satz verwandter Eigenschaften und Werte leitet. Diese Methode gibt an, ob die Breite der Eigenschaftsnamenspalte auch die Breite des angezeigten Kategorienamens angibt.

CMFCPropertyGridCtrl::SetListDelimiter

Definiert ein Zeichen, das als Trennzeichen in einer Liste von Eigenschaftswerten verwendet wird.

void SetListDelimiter(TCHAR c);

Parameter

c
[in] Ein Zeichen, das als Trennzeichen dienen soll.

Hinweise

Verwenden Sie diese Methode, um ein Trennzeichen in einer Liste von Eigenschaftswerten zu definieren, die CMFCPropertyGridProperty::CMFCPropertyGridProperty im Konstruktor verwendet werden. Legen Sie in diesem Konstruktor den bIsValueList Parameter auf TRUE.

Standardmäßig legt der CMFCPropertyGridCtrl::CMFCPropertyGridCtrl Konstruktor das Trennzeichen auf Komma (',') fest.

CMFCPropertyGridCtrl::SetShowDragContext

Gibt an, ob das Framework den Namen und die Wertspalten des aktuellen Eigenschaftenrastersteuerelements neu angibt, wenn ein Benutzer die Größe der Spalten ändert.

void SetShowDragContext(BOOL bShowDragContext = TRUE);

Parameter

bShowDragContext
[in] TRUE um die Namen- und Wertspalten während eines Größenänderungsvorgangs neu zu zeichnen; FALSE um die Spalten nach Abschluss des Ziehvorgangs neu zu zeichnen. Der Standardwert ist TRUE.

Hinweise

Der Benutzer kann die Größe der Namen- und Wertspalten eines Eigenschaftenraster-Steuerelements ändern, indem er den geteilten Balken zwischen den Spalten zieht. Wenn der Ziehkontext angezeigt wird, werden die Spalten für Name und Wert geändert, solange der Benutzer die Geteilte Leiste zieht. Andernfalls wird die Teilleiste verschoben, aber die Spalten werden erst neu gezeichnet, wenn der Ziehvorgang abgeschlossen ist.

CMFCPropertyGridCtrl::SetVSDotNetLook

Legt die Darstellung des Eigenschaftenrastersteuerelements auf die Formatvorlage fest, die in Visual Studio .NET verwendet wird.

void SetVSDotNetLook(BOOL bSet=TRUE);

Parameter

bSet
[in] TRUE um das Eigenschaftenrastersteuerelement auf die Formatvorlage festzulegen, die in Visual Studio .NET verwendet wird; andernfalls . FALSE Der Standardwert ist TRUE.

Hinweise

CMFCPropertyGridCtrl::UpdateColor

Legt den Farbwert der aktuell ausgewählten Farbeigenschaft fest.

virtual void UpdateColor(COLORREF color);

Parameter

color
[in] Ein RGB-Farbwert.

Hinweise

Diese Methode bestätigt im Debugmodus, wenn die aktuell ausgewählte Eigenschaft des Eigenschaftenrastersteuerelements keine Farbeigenschaft ist.

CMFCPropertyGridCtrl::ValidateItemData

Vom Framework aufgerufen, um Eigenschaftsdaten zu überprüfen.

virtual BOOL ValidateItemData(CMFCPropertyGridProperty* pProp);

Parameter

pProp
[in] Zeiger auf eine Eigenschaft. Dieser Parameter wird nicht verwendet.

Rückgabewert

Immer TRUE.

Hinweise

Die CMFCPropertyGridCtrl::EndEditItem Methode ruft diese Methode auf, um Daten zu überprüfen. Standardmäßig verwendet pProp diese Methode den Parameter nicht, und der Rückgabewert ist immer TRUE.

Wenn Sie diese Methode außer Kraft setzen, geben Sie zurück TRUE , wenn die angegebenen Eigenschaftsdaten gültig sind. Andernfalls wird FALSEdie Eigenschaft vom Framework nicht aktualisiert.

Siehe auch

Hierarchiediagramm
Klassen