CMFCPropertyGridCtrl-Klasse

Artikel
03/12/2013

Dieses Thema ist aus Gründen der Vollständigkeit enthalten. Ausführliche Informationen finden Sie im Quellcode des Ordners VC\atlmfc\src\mfc der Visual Studio-Installation.

Unterstützt ein bearbeitbares Eigenschaftenraster, das Eigenschaften in der alphabetischen Reihenfolge oder hierarchische anzeigen kann.

class CMFCPropertyGridCtrl : public CWnd

Mitglieder

Öffentliche Konstruktoren

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

Öffentliche Methoden

Name	Description
CMFCPropertyGridCtrl::accHitTest	Aufgerufen vom Framework, um das untergeordnete Element oder das untergeordnete Objekt an einem angegebenen Punkt auf dem Bildschirm abzurufen.(Überschreibungen CWnd::accHitTest.)
CMFCPropertyGridCtrl::accLocation	Aufgerufen durch das Framework, um die angegebenen aktuelle Bildschirmposition des Objekts abzurufen.(Überschreibungen CWnd::accLocation.)
CMFCPropertyGridCtrl::accSelect	Aufgerufen durch das Framework, um die Auswahl zu ändern oder den Tastaturfokus des angegebenen Objekts zu verschieben.(Überschreibungen CWnd::accSelect.)
CMFCPropertyGridCtrl::AddProperty	Fügt eine neue Eigenschaft einem Eigenschaftenraster hinzu.
CMFCPropertyGridCtrl::AlwaysShowUserToolTip
CMFCPropertyGridCtrl::CloseColorPopup	Schließt das Farben-Auswahldialogfeld.
CMFCPropertyGridCtrl::Create	Erstellt ein und fügt es dem Eigenschaftenraster Eigenschaftraster-steuerelement-Objekt an.
CMFCPropertyGridCtrl::DeleteProperty	Löscht die angegebene Eigenschaft aus dem Eigenschaftenraster.
CMFCPropertyGridCtrl::DrawControlBarColors
CMFCPropertyGridCtrl::EnableDescriptionArea	Aktiviert oder deaktiviert den Beschreibungsbereich, der unter der Liste von Eigenschaften angezeigt.
CMFCPropertyGridCtrl::EnableHeaderCtrl	Aktiviert oder deaktiviert das Header-Steuerelement oben im Eigenschaftraster-steuerelements.
CMFCPropertyGridCtrl::EnsureVisible	Führt ein Eigenschaftenraster Bildlauf durch und erweitert Projekteigenschaftenelemente, bis die angegebene Eigenschaft sichtbar ist.
CMFCPropertyGridCtrl::ExpandAll	Erweitert oder reduziert alle Eigenschaftraster-steuerelement-Knoten.
CMFCPropertyGridCtrl::FindItemByData	Ruft die Eigenschaft ab, die mit einem benutzerdefinierten DWORD-Wert zugeordnet ist.
CMFCPropertyGridCtrl::get_accChild	Aufgerufen durch das Framework, um die Adresse einer IDispatch-Schnittstelle für das angegebene untergeordnete Element abzurufen.(Überschreibungen CWnd::get_accChild.)
CMFCPropertyGridCtrl::get_accChildCount	Aufgerufen vom Framework, um die Anzahl der untergeordneten Elemente ab, die diesem Objekt gehören.(Überschreibungen CWnd::get_accChildCount.)
CMFCPropertyGridCtrl::get_accDefaultAction	Aufgerufen durch das Framework, um eine Zeichenfolge abzurufen, die die Standardaktion des Objekts beschreibt.(Überschreibungen CWnd::get_accDefaultAction.)
CMFCPropertyGridCtrl::get_accDescription	Aufgerufen durch Framework, um eine Zeichenfolge abzurufen, die die visuelle Darstellung des angegebenen Objekts beschreibt.(Überschreibungen CWnd::get_accDescription.)
CMFCPropertyGridCtrl::get_accFocus	Aufgerufen durch das Framework, um das Objekt ab, das den Tastaturfokus hat.(Überschreibungen CWnd::get_accFocus.)
CMFCPropertyGridCtrl::get_accHelp	Aufgerufen durch das Framework, um Help-Eigenschaftzeichenfolge eines Objekts abzurufen.(Überschreibungen CWnd::get_accHelp.)
CMFCPropertyGridCtrl::get_accHelpTopic	Aufgerufen vom Framework, um den vollständigen Pfad der Datei WinHelp abzurufen zugeordnet mit dem angegebenen Objekt und dem entsprechenden Bezeichner des Themas in der Datei.(Überschreibungen CWnd::get_accHelpTopic.)
CMFCPropertyGridCtrl::get_accKeyboardShortcut	Aufgerufen durch das Framework, um des angegebene die Tastenkombination oder Tastenkombinationen Objekts abzurufen.(Überschreibungen CWnd::get_accKeyboardShortcut.)
CMFCPropertyGridCtrl::get_accName	Aufgerufen vom Framework, um den Namen des angegebenen Objekts abzurufen.(Überschreibungen CWnd::get_accName.)
CMFCPropertyGridCtrl::get_accRole	Aufgerufen vom Framework, um Informationen abzurufen, die die Rolle des angegebenen Objekts beschreibt.(Überschreibungen CWnd::get_accRole.)
CMFCPropertyGridCtrl::get_accSelection	Aufgerufen vom Framework, um die ausgewählten untergeordneten Elemente aus diesem abzurufenden Objekts.(Überschreibungen CWnd::get_accSelection.)
CMFCPropertyGridCtrl::get_accState	Aufgerufen vom Framework, um den aktuellen Zustand des angegebenen Objekts abzurufen.(Überschreibungen WaitForStatus-Methode.)
CMFCPropertyGridCtrl::get_accValue	Aufgerufen vom Framework, um den Wert des angegebenen Objekts abzurufen.(Überschreibungen CWnd::get_accValue.)
CMFCPropertyGridCtrl::GetBkColor	Ruft die Hintergrundfarbe des aktuellen Eigenschaftraster-steuerelements ab.
CMFCPropertyGridCtrl::GetBoldFont	Ruft die Windows-Schriftart ab, die vom Text im aktuellen im Eigenschaftenraster fett.
CMFCPropertyGridCtrl::GetCurSel	Ruft die aktuell ausgewählte Eigenschaft ab.
CMFCPropertyGridCtrl::GetCustomColors	Ruft die benutzerdefinierten Farben ab, die derzeit für Eigenschaftraster-steuerelement-Elemente definiert werden.
CMFCPropertyGridCtrl::GetDescriptionHeight	Ruft die Höhe des Beschreibungsbereichs ab, der unten im Eigenschaftenraster gleich ist.
CMFCPropertyGridCtrl::GetDescriptionRows	Ruft die Anzahl der Zeilen im Beschreibungsbereich des aktuellen Eigenschaftraster-steuerelements ab.
CMFCPropertyGridCtrl::GetHeaderCtrl	Ruft das interne CMFCHeaderCtrl-Objekt ab, das vom Framework verwendet, um das aktuelle Eigenschaftenraster anzuzeigen.
CMFCPropertyGridCtrl::GetHeaderHeight	Ruft die Höhe des Eigenschaftraster-steuerelement-Headers ab.
CMFCPropertyGridCtrl::GetLeftColumnWidth	Ruft die Breite der linken Spalte des aktuellen Eigenschaftraster-steuerelements ab, das den Namen der Eigenschaft enthält.
CMFCPropertyGridCtrl::GetListRect	Ruft das umschließende Rechteck des Eigenschaftraster-steuerelements ab.
CMFCPropertyGridCtrl::GetProperty	Ruft einen Zeiger auf das Eigenschaftenobjekt ab, die dem angegebenen Index eines Eigenschaftenraster-Steuerelements entspricht.
CMFCPropertyGridCtrl::GetPropertyColumnWidth	Ruft die aktuelle Breite der Spalte ab, die Eigenschaftswerte enthält.
CMFCPropertyGridCtrl::GetPropertyCount	Ruft die Anzahl von Eigenschaften in einem Eigenschaftenraster ab.
CMFCPropertyGridCtrl::GetRowHeight	Ruft die Höhe einer Zeile im Eigenschaftenraster ab.
CMFCPropertyGridCtrl::GetScrollBarCtrl	Ruft einen Zeiger auf das ScrollBar-Steuerelement im Eigenschaftenraster ab.(Überschreibungen CWnd::GetScrollBarCtrl.)
CMFCPropertyGridCtrl::GetTextColor	Ruft die Farbe des Texts der Projekteigenschaftenelemente im aktuellen Eigenschaftenraster ab.
CMFCPropertyGridCtrl::GetThisClass	Wird vom Framework, um ein Zeiger auf CRuntimeClass-Objekt abzurufen, das diesem Klassentyp zugeordnet ist.
CMFCPropertyGridCtrl::HitTest	Ruft einen Zeiger auf das Eigenschaftenobjekt ab, das einem Eigenschaftenraster-Steuerelement entspricht, wenn ein bestimmter Punkt im Element ist.Diese Methode gibt auch den Bereich im Eigenschaftenraster an, das den Punkt enthält.
CMFCPropertyGridCtrl::InitHeader	Initialisiert das interne CMFCHeaderCtrl-Objekt, dem das Framework verwendet, um das aktuelle Eigenschaftenraster anzuzeigen.
CMFCPropertyGridCtrl::IsAlphabeticMode	Gibt an, ob ein Eigenschaftenraster im alphabetischen Modus ist.
CMFCPropertyGridCtrl::IsAlwaysShowUserToolTip
CMFCPropertyGridCtrl::IsDescriptionArea	Gibt an, ob der Beschreibungsbereich des Eigenschaftraster-steuerelements angezeigt wird.
CMFCPropertyGridCtrl::IsGroupNameFullWidth	Gibt an, ob jeder Eigenschaftengruppenname über die Breite des aktuellen Eigenschaftraster-steuerelements angezeigt wird.
CMFCPropertyGridCtrl::IsHeaderCtrl	Gibt an, ob das Header-Steuerelement angezeigt wird.
CMFCPropertyGridCtrl::IsMarkModifiedProperties	Gibt an, wie das Eigenschaftenraster geänderte Eigenschaften angezeigt.
CMFCPropertyGridCtrl::IsShowDragContext	Gibt an, ob das Framework die Namens- und Wertsspalten des aktuellen Eigenschaftraster-steuerelements neu gezeichnet wird, wenn ein Benutzer die Größe der Spalten ändert.
CMFCPropertyGridCtrl::IsVSDotNetLook	Gibt an, ob die Darstellung des Eigenschaftraster-steuerelements im Format ist, das von .NET VS verwendet wird.
CMFCPropertyGridCtrl::MarkModifiedProperties	Gibt an, wie geänderte Eigenschaften angezeigt.
CMFCPropertyGridCtrl::PreTranslateMessage	Wird von Klasse CWinApp, um Fenstermeldungen zu übersetzen, bevor sie an den TranslateMessage und DispatchMessage Windows-Funktionen weitergeleitet werden.(Überschreibungen CWnd::PreTranslateMessage.)
CMFCPropertyGridCtrl::RemoveAll	Entfernt alle Eigenschaftobjekte von einem Eigenschaftenraster.
CMFCPropertyGridCtrl::ResetOriginalValues	Stellt den ursprünglichen Wert aller Eigenschaften wiederher.
CMFCPropertyGridCtrl::SetAlphabeticMode	Setzt oder alphabetischer Modus der zurückgesetzt.
CMFCPropertyGridCtrl::SetBoolLabels	Gibt den Text von booleschen Bezeichnungen.
CMFCPropertyGridCtrl::SetCurSel	Wählt eine Eigenschaft in einem Eigenschaftenraster aus.
CMFCPropertyGridCtrl::SetCustomColors	Gibt benutzerdefinierte Farben für verschiedene Eigenschaftraster-steuerelement-Elemente an.
CMFCPropertyGridCtrl::SetDescriptionRows	Gibt die Anzahl der Zeilen an, die im Beschreibungsabschnitt des aktuellen Eigenschaftraster-steuerelements anzuzeigen.
CMFCPropertyGridCtrl::SetGroupNameFullWidth	Gibt an, ob die gesamte Breite des Kategoriennamens für eine Gruppe von Eigenschaften im aktuellen Eigenschaftenraster anzeigt.
CMFCPropertyGridCtrl::SetListDelimiter	Definiert ein Zeichen, das als Trennzeichen in einer Liste von Eigenschaftswerten verwendet wird.
CMFCPropertyGridCtrl::SetShowDragContext	Gibt an, ob das Framework die Namens- und Wertsspalten des aktuellen Eigenschaftraster-steuerelements neu gezeichnet wird, wenn ein Benutzer die Größe der Spalten ändert.
CMFCPropertyGridCtrl::SetVSDotNetLook	Legt die Darstellung des Eigenschaftraster-steuerelements dem Stil fest, das in VS .NET verwendet wird.
CMFCPropertyGridCtrl::UpdateColor	Legt den Farbwert der aktuell ausgewählten Farbeigenschaft fest.

Geschützte Methoden

Name	Description
CMFCPropertyGridCtrl::AdjustLayout	Aktualisiert das Eigenschaftenraster und seine Eigenschaften neu.
CMFCPropertyGridCtrl::CompareProps	Aufgerufen durch das Eigenschaftenraster, um Eigenschaften zu sortieren.
CMFCPropertyGridCtrl::EditItem	Aufgerufen vom Framework wenn der Benutzer beginnt, per eine Eigenschaft zu ändern.
CMFCPropertyGridCtrl::EndEditItem	Aufgerufen vom Framework, wenn der Benutzer angehalten wird, eine Eigenschaft zu ändern.
CMFCPropertyGridCtrl::Init	Aufgerufen vom Framework, um ein Eigenschaftenraster zu initialisieren.
CMFCPropertyGridCtrl::OnChangeSelection	Aufgerufen vom Framework, wenn die aktuelle Auswahl geändert wird.
CMFCPropertyGridCtrl::OnClickButton	Aufgerufen vom Framework, wenn auf eine Eigenschaftschaltfläche geklickt wird.
CMFCPropertyGridCtrl::OnDrawBorder	Aufgerufen durch das Framework, um einen Rahmen um ein Eigenschaftenraster zu zeichnen.
CMFCPropertyGridCtrl::OnDrawDescription	Aufgerufen vom Framework, um den Beschreibungsbereich zu zeichnen und den Beschreibungstext anzuzeigen.
CMFCPropertyGridCtrl::OnDrawList	Aufgerufen vom Framework, um die Liste der Eigenschaften im Eigenschaftenraster anzuzeigen.
CMFCPropertyGridCtrl::OnDrawProperty	Aufgerufen vom Framework, um eine Eigenschaft anzuzeigen.
CMFCPropertyGridCtrl::OnPropertyChanged	Aufgerufen vom Framework, wenn der Wert einer Eigenschaft geändert wird.
CMFCPropertyGridCtrl::OnSelectCombo	Aufgerufen vom Framework, wenn eine Eigenschaft, die ein Kombinationsfeld-Steuerelement enthält, ausgewählt ist.
CMFCPropertyGridCtrl::ValidateItemData	Aufgerufen durch das Framework, um Eigenschaftendaten zu überprüfen.

Hinweise

Die Klasse erfasst CMFCPropertyGridCtrl ein Eigenschaftenraster, das die bearbeitbaren Eigenschaften enthält, die von der CMFCPropertyGridProperty-Klasse abgeleitet werden.Jede Eigenschaft kann einen Typ darstellen und kann Unterelemente enthalten.Das Eigenschaftenraster unterstützt einen in der Größe veränderbaren Bereich unten, der die Beschreibung einer ausgewählten Eigenschaft anzeigen kann.

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

Auswahl-Eigenschaften

Anstatt, einen Wert anzugeben, kann ein Eigenschaftenelement ein Dialogfeld starten, das dem Benutzer ermöglicht, eine Farbe, eine Datei oder eine Schriftart auswählen.

Die folgende Tabelle zeigt vier Auswahleigenschaftentypen auf:

Klasse	Description
CMFCPropertyGridProperty-Klasse	Eine allgemeine Eigenschaft, die verwendet wird, um den Wert von Zeichenfolgen, boolesche Werte, Datumsangaben usw. anzugeben.
CMFCPropertyGridColorProperty-Klasse	Eine Eigenschaft, die verwendet wird, um einen Farbwert auszuwählen.
CMFCPropertyGridFileProperty-Klasse	Eine Eigenschaft, die verwendet wird, um eine Datei auszuwählen.
CMFCPropertyGridFontProperty-Klasse	Eine Eigenschaft, die verwendet wird, um eine Schriftart auswählen.

Abbildungen

Die folgenden Abbildungen bieten ein Eigenschaftenraster dar, das Eigenschaften auf zwei Arten anzeigt.Die erste Figur werden Eigenschaften hierarchisch an und die zweite werden Eigenschaften alphabetisch an.

PropertySheet-Eigenschaftenliste

Beispiel

Das folgende Beispiel zeigt, wie ein Eigenschaftraster-steuerelement-Objekt konfiguriert, indem verschiedene Methoden in der CMFCPropertyGridCtrl-Klasse angewendet wird.Das Beispiel zeigt, wie das Header-Steuerelement aktiviert, aktiviert der Beschreibungsbereich und für die Darstellung des Eigenschaftraster-steuerelements fest.Das Beispiel zeigt auch, wie der alphabetischen Modus für das Steuerelement, wobei das Steuerelement alle Eigenschaften sortiert, die es durch den Eigenschaftennamen enthält festgelegt wird und wie die benutzerdefinierte Farben für verschiedene Elemente des Eigenschaftraster-steuerelements festgelegt wird.Dieses Beispiel ist Teil Neue Kontrollprobe.

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