Klasa CMFCPropertyGridCtrl
Ten temat dołączono w celu zapewnienia kompletności. Aby uzyskać więcej szczegółów, zobacz kod źródłowy znajdujący się w folderze VC\atlmfc\src\mfc w instalacji programu Visual Studio.
Obsługuje formant siatki edytowalną właściwość, który można wyświetlić właściwości w kolejności alfabetycznej lub hierarchicznej.
class CMFCPropertyGridCtrl : public CWnd
Członkowie
.gif "Bb983759.collapse_all(pl-pl,VS.110).gif")
Publiczne konstruktory
Nazwa |
Opis |
|---|---|
Konstrukcje CMFCPropertyGridCtrl obiektu. |
|
CMFCPropertyGridCtrl::~CMFCPropertyGridCtrl |
Destruktor. |
Metody publiczne
Nazwa |
Opis |
|---|---|
CMFCPropertyGridCtrl::accHitTest |
Wywołana przez RAM, aby pobrać obiekt podrzędny w danym punkcie na ekranie lub element podrzędny.(Zastępuje CWnd::accHitTest.) |
CMFCPropertyGridCtrl::accLocation |
Wywołana przez ramy pobrać bieżącej lokalizacji ekranu określony obiekt.(Zastępuje CWnd::accLocation.) |
Wywołana przez ramy zmodyfikować zaznaczenie lub przenoszenia fokusu klawiatury określonego obiektu.(Zastępuje CWnd::accSelect.) |
|
Dodaje nową właściwość formant siatki właściwości. |
|
|
|
Zamyka okno dialogowe wyboru kolorów. |
|
Tworzy formant siatki właściwości i dołącza go do obiektu formantu właściwości siatki. |
|
Określona właściwość usuwa z kontroli właściwości siatki. |
|
|
|
Włącza lub wyłącza obszar opis, który jest wyświetlany pod listą właściwości. |
|
Włącza lub wyłącza formantu nagłówka na początku formant właściwości siatki. |
|
Przewinie formant siatki właściwości i rozwija właściwości elementów aż określona właściwość jest widoczna. |
|
Rozwija lub zwija wszystkie węzły formant siatki właściwości. |
|
Pobiera właściwość, która jest skojarzona z przez użytkownika DWORD wartości. |
|
CMFCPropertyGridCtrl::get_accChild |
Wywołana w ramach pobrać adresu IDispatch dziecko określonego interfejsu.(Zastępuje CWnd::get_accChild.) |
Wywołana przez ramy pobrać liczby dzieci należące do tego obiektu.(Zastępuje CWnd::get_accChildCount.) |
|
CMFCPropertyGridCtrl::get_accDefaultAction |
Wywołana przez ramy pobrać ciąg, który opisuje akcję domyślną tego obiektu.(Zastępuje CWnd::get_accDefaultAction.) |
CMFCPropertyGridCtrl::get_accDescription |
Wywołana przez ramy pobrać ciąg znakowy opisujący wygląd określonego obiektu.(Zastępuje CWnd::get_accDescription.) |
Wywołana przez RAM, aby pobrać obiekt z fokusem klawiatury.(Zastępuje CWnd::get_accFocus.) |
|
Wywoływany przez RAM, aby pobrać obiekt Help ciąg znaków właociwooci.(Zastępuje CWnd::get_accHelp.) |
|
Wywołana w ramach pobrać pełną ścieżkę WinHelppliku skojarzonego z określonego obiektu i identyfikator odpowiedni temat w tym pliku.(Zastępuje CWnd::get_accHelpTopic.) |
|
Wywołana przez ramy pobierania klawisz skrótu do określonego obiektu lub klucza dostępu.(Zastępuje CWnd::get_accKeyboardShortcut.) |
|
CMFCPropertyGridCtrl::get_accName |
Wywołana przez ramy pobrać nazwy określonego obiektu.(Zastępuje CWnd::get_accName.) |
CMFCPropertyGridCtrl::get_accRole |
Wywołana przez ramy do pobierania informacji, która opisuje rolę obiektu.(Zastępuje CWnd::get_accRole.) |
Wywołana przez ramy do pobierania wybranych obiektów podrzędnych tego obiektu.(Zastępuje CWnd::get_accSelection.) |
|
CMFCPropertyGridCtrl::get_accState |
Wywołana przez RAM pobiera bieżący stan określonego obiektu.(Zastępuje CWnd::get_accState.) |
CMFCPropertyGridCtrl::get_accValue |
Wywołana przez RAM, aby pobrać wartość określonego obiektu.(Zastępuje CWnd::get_accValue.) |
Pobiera bieżący formant siatki właściwości kolor tła. |
|
Pobiera Windows Czcionka tekstu w bieżącym siatki właściwości kontroli styl pogrubiony. |
|
Pobiera aktualnie wybranej właściwości. |
|
Pobiera kolory niestandardowe, aktualnie zdefiniowanych elementów sterowania właściwości siatki. |
|
Pobiera wysokość obszaru Opis znajdujący się u dołu formant właściwości siatki. |
|
Pobiera liczbę wierszy w obszarze Opis bieżącego formantu właściwości siatki. |
|
Pobiera wewnętrznego CMFCHeaderCtrl obiekt używany do wyświetlania bieżącej formant siatki właściwości w ramach. |
|
Pobiera wysokość Nagłówek sterowania właściwości siatki. |
|
Pobiera szerokość lewej kolumnie bieżący formant siatki właściwości, który zawiera nazwę każdej właściwości. |
|
Pobiera prostokąta obwiedni formant właściwości siatki. |
|
Pobiera wskaźnik do obiektu właściwości, który odpowiada określony indeks elementu sterowania właściwości siatki. |
|
Pobiera bieżący szerokość kolumny zawierającej wartości właściwości. |
|
Pobiera numer właściwości siatki właściwości formantu. |
|
Pobiera wysokość wiersza w formancie właściwości siatki. |
|
Pobiera wskaźnik na pasek przewijania w formancie właściwości siatki.(Zastępuje CWnd::GetScrollBarCtrl.) |
|
Pobiera kolor tekstu właściwości elementów w bieżącym formant siatki właściwości. |
|
CMFCPropertyGridCtrl::GetThisClass |
Używane w ramach uzyskać wskaźnik do CRuntimeClass obiekt, który jest skojarzony z tego typu klasy. |
Pobiera wskaźnik do obiektu właściwości, który odpowiada element formant siatki właściwości, jeśli element jest określony punkt.Metoda ta wskazuje także obszar formant siatki właściwości, który zawiera punkt. |
|
Inicjuje wewnętrznego CMFCHeaderCtrl obiekt używany do wyświetlania bieżącej formant siatki właściwości w ramach. |
|
Wskazuje, czy formant siatki właściwości jest w trybie alfabetu. |
|
|
|
Wskazuje, czy formant siatki właściwości obszaru Opis jest wyświetlany. |
|
Wskazuje, czy każda nazwa grupy właściwości jest wyświetlany w poprzek bieżący formant siatki właściwości. |
|
Wskazuje, czy formant nagłówka jest wyświetlany. |
|
Wskazuje, jak formant siatki właściwości wyświetla właściwości zmodyfikowanych. |
|
Wskazuje, czy ramach odrysowania kolumny Nazwa i wartość bieżącego formant siatki właściwości, gdy użytkownik zmienia rozmiar kolumny. |
|
Wskazuje, czy formant siatki właściwości wyglądu jest w stylu, który jest używany przez VS .net. |
|
Określa sposób wyświetlania właściwości zmodyfikowanych. |
|
CMFCPropertyGridCtrl::PreTranslateMessage |
Używane przez klasę CWinApp do tłumaczenia okna wiadomości przed wysłaniem ich do TranslateMessage i DispatchMessage funkcje systemu Windows.(Zastępuje CWnd::PreTranslateMessage.) |
Usuwa wszystkie właściwości obiektów z siatki właściwości formantu. |
|
Przywraca pierwotną wartość wszystkich właściwości. |
|
Ustawia lub resetuje tryb alfabetycznej. |
|
Określa tekst etykiety Boolean. |
|
Właściwość zaznacza formant siatki właściwości. |
|
Określa niestandardowe kolory dla różnych elementów sterowania siatki właściwości. |
|
Określa liczbę wierszy wyświetlanych w sekcji Opis bieżącej formant siatki właściwości. |
|
Określa, czy wyświetlać pełną szerokość nazwa kategorii grupy właściwości kontrolce siatki właściwości. |
|
Określa znak, który będzie używany jako separator listy wartości właściwości. |
|
Określa, czy ramach odrysowania kolumny Nazwa i wartość bieżącego formant siatki właściwości, gdy użytkownik zmienia rozmiar kolumny. |
|
Ustawia styl, który jest używany w VS .net wygląd formantu właściwości siatki. |
|
Ustawia wartość koloru właściwość aktualnie wybrany kolor. |
Metody chronione
Nazwa |
Opis |
|---|---|
Odrysowania formant siatki właściwości i jego właściwości. |
|
Wywołana przez formant siatki właściwości, aby posortować właściwości. |
|
Wywołana w ramach uruchomienia modyfikowanie właściwości użytkownika. |
|
Nazywane w ramach, gdy użytkownik zatrzyma, modyfikowania właściwości. |
|
Wywołana przez ramy zainicjować formant siatki właściwości. |
|
Wywołana w ramach po zmianie bieżącego zaznaczenia. |
|
Wywołana w ramach po kliknięciu przycisku Właściwości. |
|
Wywołana przez rysowanie obramowania wokół formantu właściwości siatki ramy. |
|
Wywołana przez ramy do rysowania obszaru Opis i wyświetlać tekst opisu. |
|
Wywołana przez ramy do wyświetlania listy właściwości formantu właściwości siatki. |
|
Wywołana przez ramy do wyświetlania właściwości. |
|
Wywołana przez ramy, gdy wartość właściwości zostanie zmieniona. |
|
Wywoływane w ramach, gdy właściwość, która zawiera formant pola kombi jest zaznaczone. |
|
Wywołana w ramach sprawdzania poprawności danych właściwości. |
Uwagi
CMFCPropertyGridCtrl Klasy Wyświetla właściwości formant siatki, który zawiera edytowalne właściwości pochodne CMFCPropertyGridProperty klasy.Każda właściwość może reprezentować typ i może zawierać elementy podrzędne.Formant siatki właściwości obsługuje zmienny rozmiar obszaru w dolnej można wyświetlić opis wybranej właściwości.
Aby użyć siatki właściwości formantu, skonstruować CMFCPropertyGridCtrl obiekt, a następnie wywołać CMFCPropertyGridCtrl::Create metody.Użyj CMFCPropertyGridCtrl::AddProperty metody, aby dodać właściwości do listy.
Wybór właściwości
Reprezentujących wartości, a nie elementu właściwości można uruchomić okno dialogowe, które pozwala użytkownikowi wybrać kolor, pliku lub czcionki.
W poniższej tabeli przedstawiono cztery typy właściwości wyboru:
Klasa |
Opis |
|---|---|
Właściwość ogólnego przeznaczenia, która jest używana do określenia wartości ciągów, wartości logiczne, dat i tak dalej. |
|
Właściwość, która jest używana do wybierz wartość koloru. |
|
Właściwość, która jest używana, aby wybrać plik. |
|
Właściwość, która jest używana, aby wybrać czcionkę. |
Ilustracje
Następujące ilustracje przedstawiają formant siatki właściwości, która wyświetla właściwości na dwa sposoby.Pierwszym rysunku hierarchicznie Wyświetla właściwości i drugi Wyświetla właściwości alfabetycznie.
.png "Lista właściwości — arkusz właściwości")
Przykład
Poniższy przykład ilustruje sposób skonfigurować obiekt formant siatki właściwości przy użyciu różnych metod w CMFCPropertyGridCtrl klasy.Przykład demonstruje, jak włączyć sterowanie nagłówka, włącz w obszarze Opis i ustawić wygląd formantu właściwości siatki.W przykładzie pokazano również, jak ustawić tryb alfabetu dla formantu, według której sortuje formant właściwości, które zawiera nazwy właściwości i sposób ustawić niestandardowe kolory dla różnych elementów sterowania właściwości siatki.W tym przykładzie jest częścią nowych formantów próbki.
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();
Hierarchii dziedziczenia
Wymagania
Nagłówek: afxpropertygridctrl.h