Klasa CMFCPropertyGridCtrl

Aby uzyskać więcej informacji, zobacz kod źródłowy znajdujący się w mfc folderze instalacji programu Visual Studio. Na przykład %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc.

Obsługuje edytowalną kontrolkę siatki właściwości, która może wyświetlać właściwości w kolejności alfabetycznej lub hierarchicznej.

Składnia

class CMFCPropertyGridCtrl : public CWnd

Elementy członkowskie

Konstruktory publiczne

Nazwa/nazwisko	opis
CMFCPropertyGridCtrl::CMFCPropertyGridCtrl	CMFCPropertyGridCtrl Tworzy obiekt.
CMFCPropertyGridCtrl::~CMFCPropertyGridCtrl	Destruktor.

Metody publiczne

Nazwa/nazwisko	opis
CMFCPropertyGridCtrl::accHitTest	Wywoływana przez platformę w celu pobrania elementu podrzędnego lub obiektu podrzędnego w danym punkcie na ekranie. (Przesłania CWnd::accHitTest).
CMFCPropertyGridCtrl::accLocation	Wywoływana przez platformę w celu pobrania bieżącej lokalizacji ekranu określonego obiektu. (Przesłania CWnd::accLocation).
CMFCPropertyGridCtrl::accSelect	Wywoływana przez strukturę w celu zmodyfikowania zaznaczenia lub przeniesienia fokusu klawiatury określonego obiektu. (Przesłania CWnd::accSelect).
CMFCPropertyGridCtrl::AddProperty	Dodaje nową właściwość do kontrolki siatki właściwości.
CMFCPropertyGridCtrl::AlwaysShowUserToolTip
CMFCPropertyGridCtrl::CloseColorPopup	Zamyka okno dialogowe wyboru kolorów.
CMFCPropertyGridCtrl::Create	Tworzy kontrolkę siatki właściwości i dołącza ją do obiektu kontrolki siatki właściwości.
CMFCPropertyGridCtrl::DeleteProperty	Usuwa określoną właściwość z kontrolki siatki właściwości.
CMFCPropertyGridCtrl::DrawControlBarColors
CMFCPropertyGridCtrl::EnableDescriptionArea	Włącza lub wyłącza obszar opisu wyświetlany poniżej listy właściwości.
CMFCPropertyGridCtrl::EnableHeaderCtrl	Włącza lub wyłącza kontrolkę nagłówka w górnej części kontrolki siatki właściwości.
CMFCPropertyGridCtrl::EnsureVisible	Przewija kontrolkę siatki właściwości i rozwija elementy właściwości, dopóki określona właściwość nie będzie widoczna.
CMFCPropertyGridCtrl::ExpandAll	Rozwija lub zwija wszystkie węzły kontrolki siatki właściwości.
CMFCPropertyGridCtrl::FindItemByData	Pobiera właściwość skojarzona z wartością zdefiniowaną przez DWORD użytkownika.
CMFCPropertyGridCtrl::get_accChild	Wywoływana przez strukturę w celu pobrania adresu interfejsu IDispatch dla określonego elementu podrzędnego. (Przesłania CWnd::get_accChild).
CMFCPropertyGridCtrl::get_accChildCount	Wywoływana przez strukturę w celu pobrania liczby elementów podrzędnych należących do tego obiektu. (Przesłania CWnd::get_accChildCount).
CMFCPropertyGridCtrl::get_accDefaultAction	Wywoływana przez platformę w celu pobrania ciągu opisującego domyślną akcję obiektu. (Przesłania CWnd::get_accDefaultAction).
CMFCPropertyGridCtrl::get_accDescription	Wywoływana przez platformę w celu pobrania ciągu opisującego wygląd wizualizacji określonego obiektu. (Przesłania CWnd::get_accDescription).
CMFCPropertyGridCtrl::get_accFocus	Wywoływana przez strukturę w celu pobrania obiektu, który ma fokus klawiatury. (Przesłania CWnd::get_accFocus).
CMFCPropertyGridCtrl::get_accHelp	Wywoływana przez platformę w celu pobrania ciągu właściwości obiektu Help . (Przesłania CWnd::get_accHelp).
CMFCPropertyGridCtrl::get_accHelpTopic	Wywoływana przez platformę w celu pobrania pełnej ścieżki WinHelp pliku skojarzonego z określonym obiektem i identyfikatora odpowiedniego tematu w tym pliku. (Przesłania CWnd::get_accHelpTopic).
CMFCPropertyGridCtrl::get_accKeyboardShortcut	Wywoływana przez strukturę w celu pobrania skrótu określonego obiektu lub klucza dostępu. (Przesłania CWnd::get_accKeyboardShortcut).
CMFCPropertyGridCtrl::get_accName	Wywoływana przez strukturę w celu pobrania nazwy określonego obiektu. (Przesłania CWnd::get_accName).
CMFCPropertyGridCtrl::get_accRole	Wywoływana przez platformę w celu pobrania informacji opisujących rolę określonego obiektu. (Przesłania CWnd::get_accRole).
CMFCPropertyGridCtrl::get_accSelection	Wywoływana przez strukturę w celu pobrania wybranych elementów podrzędnych tego obiektu. (Przesłania CWnd::get_accSelection).
CMFCPropertyGridCtrl::get_accState	Wywoływana przez strukturę w celu pobrania bieżącego stanu określonego obiektu. (Przesłania CWnd::get_accState).
CMFCPropertyGridCtrl::get_accValue	Wywoływana przez strukturę w celu pobrania wartości określonego obiektu. (Przesłania CWnd::get_accValue).
CMFCPropertyGridCtrl::GetBkColor	Pobiera kolor tła bieżącej kontrolki siatki właściwości.
CMFCPropertyGridCtrl::GetBoldFont	Pobiera czcionkę systemu Windows z tekstem w bieżącej kontrolce siatki właściwości w stylu pogrubienia.
CMFCPropertyGridCtrl::GetCurSel	Pobiera aktualnie wybraną właściwość.
CMFCPropertyGridCtrl::GetCustomColors	Pobiera kolory niestandardowe, które są obecnie zdefiniowane dla elementów kontrolki siatki właściwości.
CMFCPropertyGridCtrl::GetDescriptionHeight	Pobiera wysokość obszaru opisu znajdującego się w dolnej części kontrolki siatki właściwości.
CMFCPropertyGridCtrl::GetDescriptionRows	Pobiera liczbę wierszy w obszarze opisu bieżącej kontrolki siatki właściwości.
CMFCPropertyGridCtrl::GetHeaderCtrl	Pobiera obiekt wewnętrzny CMFCHeaderCtrl używany przez platformę do wyświetlania bieżącej kontrolki siatki właściwości.
CMFCPropertyGridCtrl::GetHeaderHeight	Pobiera wysokość nagłówka kontrolki siatki właściwości.
CMFCPropertyGridCtrl::GetLeftColumnWidth	Pobiera szerokość lewej kolumny kontrolki siatki właściwości bieżącej, która zawiera nazwę każdej właściwości.
CMFCPropertyGridCtrl::GetListRect	Pobiera prostokąt ograniczenia kontrolki siatki właściwości.
CMFCPropertyGridCtrl::GetProperty	Pobiera wskaźnik do obiektu właściwości odpowiadającego określonemu indeksowi elementu kontrolki siatki właściwości.
CMFCPropertyGridCtrl::GetPropertyColumnWidth	Pobiera bieżącą szerokość kolumny zawierającej wartości właściwości.
CMFCPropertyGridCtrl::GetPropertyCount	Pobiera liczbę właściwości w kontrolce siatki właściwości.
CMFCPropertyGridCtrl::GetRowHeight	Pobiera wysokość wiersza w kontrolce siatki właściwości.
CMFCPropertyGridCtrl::GetScrollBarCtrl	Pobiera wskaźnik do kontrolki paska przewijania w kontrolce siatki właściwości. (Przesłania CWnd::GetScrollBarCtrl).
CMFCPropertyGridCtrl::GetTextColor	Pobiera kolor tekstu elementów właściwości w bieżącej siatce siatki właściwości.
CMFCPropertyGridCtrl::GetThisClass	Używany przez platformę do uzyskiwania wskaźnika do obiektu skojarzonego CRuntimeClass z tym typem klasy.
CMFCPropertyGridCtrl::HitTest	Pobiera wskaźnik do obiektu właściwości odpowiadającego elementowi kontrolki siatki właściwości, jeśli określony punkt znajduje się w elemencie. Ta metoda wskazuje również obszar w kontrolce siatki właściwości, która zawiera punkt.
CMFCPropertyGridCtrl::InitHeader	Inicjuje obiekt wewnętrzny CMFCHeaderCtrl używany przez platformę do wyświetlania bieżącej kontrolki siatki właściwości.
CMFCPropertyGridCtrl::IsAlphabeticMode	Wskazuje, czy kontrolka siatki właściwości jest w trybie alfabetycznym.
CMFCPropertyGridCtrl::IsAlwaysShowUserToolTip
CMFCPropertyGridCtrl::IsDescriptionArea	Wskazuje, czy jest wyświetlany obszar opisu kontrolki siatki właściwości.
CMFCPropertyGridCtrl::IsGroupNameFullWidth	Wskazuje, czy każda nazwa grupy właściwości jest wyświetlana na całej szerokości bieżącej kontrolki siatki właściwości.
CMFCPropertyGridCtrl::IsHeaderCtrl	Wskazuje, czy jest wyświetlana kontrolka nagłówka.
CMFCPropertyGridCtrl::IsMarkModifiedProperties	Wskazuje sposób wyświetlania zmodyfikowanych właściwości kontrolki siatki właściwości.
CMFCPropertyGridCtrl::IsShowDragContext	Wskazuje, czy struktura ponownie rysuje kolumny nazwy i wartości bieżącej kontrolki siatki właściwości, gdy użytkownik zmienia rozmiar kolumn.
CMFCPropertyGridCtrl::IsVSDotNetLook	Wskazuje, czy wygląd kontrolki siatki właściwości jest w stylu używanym przez program VS .NET.
CMFCPropertyGridCtrl::MarkModifiedProperties	Określa sposób wyświetlania zmodyfikowanych właściwości.
CMFCPropertyGridCtrl::PreTranslateMessage	Używany przez klasę CWinApp do tłumaczenia komunikatów okien przed ich wysłaniem do TranslateMessage funkcji systemu Windows i DispatchMessage . (Przesłania CWnd::PreTranslateMessage).
CMFCPropertyGridCtrl::RemoveAll	Usuwa wszystkie obiekty właściwości z kontrolki siatki właściwości.
CMFCPropertyGridCtrl::ResetOriginalValues	Przywraca oryginalną wartość wszystkich właściwości.
CMFCPropertyGridCtrl::SetAlphabeticMode	Ustawia lub resetuje tryb alfabetyczny.
CMFCPropertyGridCtrl::SetBoolLabels	Określa tekst etykiet logicznych.
CMFCPropertyGridCtrl::SetCurSel	Wybiera właściwość w kontrolce siatki właściwości.
CMFCPropertyGridCtrl::SetCustomColors	Określa kolory niestandardowe dla różnych elementów kontrolki siatki właściwości.
CMFCPropertyGridCtrl::SetDescriptionRows	Określa liczbę wierszy do wyświetlenia w sekcji opisu bieżącej kontrolki siatki właściwości.
CMFCPropertyGridCtrl::SetGroupNameFullWidth	Określa, czy wyświetlić pełną szerokość nazwy kategorii dla grupy właściwości w bieżącej siatce właściwości.
CMFCPropertyGridCtrl::SetListDelimiter	Definiuje znak, który będzie używany jako ogranicznik na liście wartości właściwości.
CMFCPropertyGridCtrl::SetShowDragContext	Określa, czy struktura ponownie rysuje kolumny nazwy i wartości bieżącej kontrolki siatki właściwości, gdy użytkownik zmienia rozmiar kolumn.
CMFCPropertyGridCtrl::SetVSDotNetLook	Ustawia wygląd kontrolki siatki właściwości na styl używany w programie VS .NET.
CMFCPropertyGridCtrl::UpdateColor	Ustawia wartość koloru aktualnie wybranej właściwości koloru.

Metody chronione

Nazwa/nazwisko	opis
CMFCPropertyGridCtrl::AdjustLayout	Ponownie rysuje kontrolkę siatki właściwości i jej właściwości.
CMFCPropertyGridCtrl::CompareProps	Wywoływana przez kontrolkę siatki właściwości w celu sortowania właściwości.
CMFCPropertyGridCtrl::EditItem	Wywoływana przez platformę, gdy użytkownik zacznie modyfikować właściwość.
CMFCPropertyGridCtrl::EndEditItem	Wywoływana przez platformę, gdy użytkownik przestaje modyfikować właściwość.
CMFCPropertyGridCtrl::Init	Wywoływana przez strukturę w celu zainicjowania kontrolki siatki właściwości.
CMFCPropertyGridCtrl::OnChangeSelection	Wywoływana przez strukturę po zmianie bieżącego zaznaczenia.
CMFCPropertyGridCtrl::OnClickButton	Wywoływana przez platformę po kliknięciu przycisku właściwości.
CMFCPropertyGridCtrl::OnDrawBorder	Wywoływana przez strukturę w celu narysowania obramowania wokół kontrolki siatki właściwości.
CMFCPropertyGridCtrl::OnDrawDescription	Wywoływana przez strukturę, aby narysować obszar opisu i wyświetlić tekst opisu.
CMFCPropertyGridCtrl::OnDrawList	Wywoływana przez strukturę w celu wyświetlenia listy właściwości w kontrolce siatki właściwości.
CMFCPropertyGridCtrl::OnDrawProperty	Wywoływana przez strukturę w celu wyświetlenia właściwości.
CMFCPropertyGridCtrl::OnPropertyChanged	Wywoływana przez strukturę, gdy wartość właściwości zostanie zmieniona.
CMFCPropertyGridCtrl::OnSelectCombo	Wywoływana przez platformę, gdy jest zaznaczona właściwość zawierająca kontrolkę pola kombi.
CMFCPropertyGridCtrl::ValidateItemData	Wywoływana przez platformę w celu zweryfikowania danych właściwości.

Uwagi

Klasa CMFCPropertyGridCtrl wyświetla kontrolkę siatki właściwości zawierającą edytowalne właściwości pochodzące z CMFCPropertyGridProperty klasy. Każda właściwość może reprezentować typ i może zawierać subitems. Kontrolka siatki właściwości obsługuje obszar z możliwością zmiany rozmiaru u dołu, który może wyświetlać opis wybranej właściwości.

Aby użyć kontrolki siatki właściwości, skonstruuj CMFCPropertyGridCtrl obiekt, a następnie wywołaj metodę CMFCPropertyGridCtrl::Create . CMFCPropertyGridCtrl::AddProperty Użyj metody , aby dodać właściwości do listy.

Właściwości zaznaczenia

Zamiast reprezentować wartość, element właściwości może uruchomić okno dialogowe, które umożliwia użytkownikowi wybranie koloru, pliku lub czcionki.

W poniższej tabeli wymieniono cztery typy właściwości wyboru:

Klasa	opis
CMFCPropertyGridProperty Klasa	Właściwość ogólnego przeznaczenia, która służy do określania wartości ciągów, wartości logicznych, dat itd.
CMFCPropertyGridColorProperty Klasa	Właściwość używana do wybierania wartości koloru.
CMFCPropertyGridFileProperty Klasa	Właściwość używana do wybierania pliku.
CMFCPropertyGridFontProperty Klasa	Właściwość używana do wybierania czcionki.

Ilustracje

Na poniższych ilustracjach przedstawiono kontrolkę siatki właściwości, która wyświetla właściwości na dwa sposoby. Pierwsza ilustracja przedstawia właściwości hierarchicznie, a druga wyświetla właściwości alfabetycznie.

Przykład

W poniższym przykładzie pokazano, jak skonfigurować obiekt kontrolki siatki właściwości przy użyciu różnych metod w CMFCPropertyGridCtrl klasie. W przykładzie pokazano, jak włączyć kontrolkę nagłówka, włączyć obszar opisu i ustawić wygląd kontrolki siatki właściwości. W przykładzie pokazano również, jak ustawić tryb alfabetyczny dla kontrolki, w której kontrolka sortuje wszystkie właściwości, które zawiera według ich nazwy właściwości, oraz jak ustawić kolory niestandardowe dla różnych elementów kontrolki siatki właściwości. Ten przykład jest częścią przykładu Nowe kontrolki.

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

Hierarchia dziedziczenia

CObject

CCmdTarget

CWnd

CMFCPropertyGridCtrl

Wymagania

Nagłówek: afxpropertygridctrl.h

CMFCPropertyGridCtrl::accSelect

virtual HRESULT accSelect(
    long flagsSelect,
    VARIANT varChild);

Parametry

[in] flagsSelect
[in] varChild\

Wartość zwracana

Uwagi

CMFCPropertyGridCtrl::AddProperty

Dodaje nową właściwość do kontrolki siatki właściwości.

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

Parametry

pProp
[in] Wskaźnik do właściwości.

bRedraw
[in] TRUE aby od razu ponownie wyrysować właściwość; w przeciwnym razie, FALSE. Domyślna wartość to TRUE.

bAdjustLayout
[in] TRUE aby ponownie obliczyć, jak narysować tekst i wartość właściwości, a następnie narysować właściwość; FALSE aby użyć istniejących obliczeń, aby narysować właściwość. Domyślna wartość to TRUE.

Wartość zwracana

Jeśli ta metoda powiedzie się, indeks na podstawie zera pozycji w kontrolce siatki właściwości, w której jest dodawana właściwość; w przeciwnym razie, -1.

Uwagi

Ta metoda dodaje wskaźnik do określonej właściwości na końcu listy właściwości w kontrolce siatki właściwości. Nie usuwaj właściwości ani nie zezwalaj na wyjście z zakresu przed zniszczeniem kontrolki siatki. Po zakończeniu pracy z kontrolką siatki właściwości wywołaj metodę CMFCPropertyGridCtrl::RemoveAll , aby usunąć wszystkie dodane właściwości. Metoda AddProperty kończy się niepowodzeniem, jeśli określona właściwość została już dodana do listy.

CMFCPropertyGridCtrl::AdjustLayout

Ponownie rysuje kontrolkę siatki właściwości i jej właściwości.

virtual void AdjustLayout();

Uwagi

Ta metoda ponownie oblicza sposób rysowania całej kontrolki siatki właściwości i jej właściwości, w tym obrazów, czcionek i kontrolek.

CMFCPropertyGridCtrl::AlwaysShowUserToolTip

void AlwaysShowUserToolTip(BOOL bShow = TRUE);

Parametry

[in] bShow\

Uwagi

CMFCPropertyGridCtrl::CloseColorPopup

Zamyka okno dialogowe wyboru kolorów.

virtual void CloseColorPopup();

Uwagi

Aby uzyskać więcej informacji na temat okna dialogowego wyboru kolorów, zobacz CMFCPropertyGridColorProperty Klasa.

CMFCPropertyGridCtrl::CMFCPropertyGridCtrl

CMFCPropertyGridCtrl Tworzy obiekt.

CMFCPropertyGridCtrl();

Wartość zwracana

Uwagi

CMFCPropertyGridCtrl::CompareProps

Wywoływana przez kontrolkę siatki właściwości w celu sortowania właściwości.

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

Parametry

pProp1
Wskaźnik do właściwości.

pProp2
Wskaźnik do właściwości.

Wartość zwracana

Wartość zwracana	opis
< 0	Nazwa parametru pProp1 jest mniejsza niż nazwa parametru pProp2 .
0	Nazwa parametru pProp1 jest równa nazwie parametru pProp2 .
> 0	Nazwa pProp1 obiektu jest większa niż nazwa parametru pProp2 .

Uwagi

Domyślnie ta metoda używa CString::Compare metody do porównywania CMFCPropertyGridProperty::m_strName elementów członkowskich określonych parametrów.

CMFCPropertyGridCtrl::Create

Tworzy kontrolkę siatki właściwości i dołącza ją do obiektu kontrolki siatki właściwości.

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

Parametry

dwStyle
[in] Bitowa kombinacja "lub" (|) stylów okna.

rect
[in] Prostokąt ograniczenia określający rozmiar i położenie okna we współrzędnych pParentWndklienta .

pParentWnd
[in] Wskaźnik do okna nadrzędnego. Nie może być .NULL

nID
[in] Identyfikator okna podrzędnego.

Wartość zwracana

TRUE jeśli okno zostało utworzone pomyślnie; w przeciwnym razie, FALSE.

Uwagi

Aby utworzyć kontrolkę siatki właściwości, najpierw wywołaj metodę CMFCPropertyGridCtrl::CMFCPropertyGridCtrl konstruowania obiektu siatki właściwości. Następnie wywołaj metodę CMFCPropertyGridCtrl::Create.

Przykład

W poniższym przykładzie pokazano, jak używać Create metody w CMFCPropertyGridCtrl klasie. Ten przykład jest częścią przykładu Nowe kontrolki.

// 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

Usuwa określoną właściwość z kontrolki siatki właściwości.

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

Parametry

pProp
[in] Wskaźnik do właściwości.

bRedraw
[in] TRUE aby ponownie wyrysować kontrolkę siatki właściwości; w przeciwnym razie, FALSE. Domyślna wartość to TRUE.

bAdjustLayout
[in] TRUE aby ponownie obliczyć, jak narysować cały tekst, obrazy i elementy w kontrolce siatki właściwości, a następnie narysować kontrolkę; w przeciwnym razie, FALSE. Domyślna wartość to TRUE.

Wartość zwracana

TRUE jeśli ta metoda zakończy się pomyślnie; w przeciwnym razie, FALSE.

Uwagi

Użyj tej metody, aby usunąć właściwość i wszystkie elementy podrzędne z kontrolki siatki właściwości.

CMFCPropertyGridCtrl::DrawControlBarColors

BOOL DrawControlBarColors() const;

Wartość zwracana

Uwagi

CMFCPropertyGridCtrl::EditItem

Wywoływana przez platformę, gdy użytkownik zacznie modyfikować właściwość.

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

Parametry

pProp
[in] Wskaźnik do właściwości.

lptClick
[in] Punkt kontrolki siatki właściwości, który użytkownik kliknął, aby rozpocząć operację edycji. Punkt znajduje się we współrzędnych klienta kontrolki. Domyślna wartość to NULL.

Wartość zwracana

TRUE jeśli metoda zakończy się powodzeniem; w przeciwnym razie, FALSE.

Uwagi

CMFCPropertyGridCtrl::EnableDescriptionArea

Włącza lub wyłącza obszar opisu wyświetlany poniżej listy właściwości w kontrolce siatki właściwości.

void EnableDescriptionArea(BOOL bEnable=TRUE);

Parametry

bEnable
[in] TRUE aby włączyć obszar opisu; FALSE aby wyłączyć obszar opisu. Domyślna wartość to TRUE.

Uwagi

Obszar opisu jest wyświetlany w dolnej części kontrolki siatki właściwości. Domyślnie obszar opisu jest wyłączony i niewidoczny.

CMFCPropertyGridCtrl::EnableHeaderCtrl

Włącza lub wyłącza kontrolkę nagłówka w górnej części kontrolki siatki właściwości.

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

Parametry

bEnable
[in] TRUE aby włączyć kontrolkę nagłówka; FALSE aby wyłączyć kontrolkę nagłówka. Domyślna wartość to TRUE.

lpszLeftColumn
[in] Tytuł lewej kolumny kontrolki nagłówka. Domyślna wartość to Property.

lpszRightColumn
[in] Tytuł prawej kolumny kontrolki nagłówka. Domyślna wartość to Value.

CMFCPropertyGridCtrl::EndEditItem

Wywoływana przez platformę po zakończeniu modyfikowania właściwości przez użytkownika.

virtual BOOL EndEditItem(BOOL bUpdateData=TRUE);

Parametry

bUpdateData
[in] TRUE aby określić, że zmodyfikowane dane właściwości muszą być weryfikowane po zakończeniu operacji edycji; w przeciwnym razie, FALSE. Domyślna wartość to TRUE.

Wartość zwracana

TRUE jeśli operacja edycji zakończy się pomyślnie; FALSE jeśli zmodyfikowane dane właściwości są nieprawidłowe lub czy operacja edycji powinna być kontynuowana.

Uwagi

CMFCPropertyGridCtrl::EnsureVisible

Przewija kontrolkę siatki właściwości i rozwija elementy właściwości, dopóki określona właściwość nie będzie widoczna.

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

Parametry

pProp
[in] Wskaźnik do właściwości.

bExpandParents
[in] TRUE aby rozwinąć elementy nadrzędne, aby ustawić określoną właściwość jako widoczną; w przeciwnym razie, FALSE. Wartość domyślna to FALSE.

Uwagi

CMFCPropertyGridCtrl::ExpandAll

Rozwija lub zwija wszystkie węzły kontrolki siatki właściwości.

void ExpandAll(BOOL bExpand=TRUE);

Parametry

bExpand
[in] TRUE aby rozwinąć wszystkie węzły; FALSE aby zwinąć wszystkie węzły. Domyślna wartość to TRUE.

Uwagi

CMFCPropertyGridCtrl::FindItemByData

Pobiera właściwość skojarzona z wartością zdefiniowaną przez DWORD użytkownika.

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

Parametry

dwData
[in] DWORD Wartość.

bSearchSubItems
[in] TRUE aby wyszukać elementy podrzędne właściwości; w przeciwnym razie, FALSE. Domyślna wartość to TRUE.

Wartość zwracana

Wskaźnik do skojarzonego obiektu właściwości, jeśli ta metoda powiedzie się; w przeciwnym razie, NULL.

Uwagi

Użyj konstruktora CMFCPropertyGridCtrl::CMFCPropertyGridCtrl lub CMFCPropertyGridProperty::SetData metody, aby skojarzyć DWORD obiekt z właściwością.

CMFCPropertyGridCtrl::get_accChildCount

virtual HRESULT get_accChildCount(long* pcountChildren);

Parametry

[in] pcountChildren\

Wartość zwracana

Uwagi

CMFCPropertyGridCtrl::get_accFocus

virtual HRESULT get_accFocus(VARIANT* pvarChild);

Parametry

[in] pvarChild\

Wartość zwracana

Uwagi

CMFCPropertyGridCtrl::get_accHelp

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

Parametry

[in] varChild
[in] pszHelp\

Wartość zwracana

Uwagi

CMFCPropertyGridCtrl::get_accHelpTopic

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

Parametry

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

Wartość zwracana

Uwagi

CMFCPropertyGridCtrl::get_accKeyboardShortcut

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

Parametry

[in] varChild
[in] pszKeyboardShortcut\

Wartość zwracana

Uwagi

CMFCPropertyGridCtrl::get_accSelection

virtual HRESULT get_accSelection(VARIANT* pvarChildren);

Parametry

[in] pvarChildren\

Wartość zwracana

Uwagi

CMFCPropertyGridCtrl::GetBkColor

Pobiera kolor tła bieżącej kontrolki siatki właściwości.

COLORREF GetBkColor() const;

Wartość zwracana

Wartość koloru RGB.

Uwagi

Ta metoda pobiera kolor używany przez strukturę do rysowania tła bieżącej kontrolki siatki właściwości. Metoda CMFCPropertyGridCtrl::GetTextColor pobiera kolor pierwszego planu.

CMFCPropertyGridCtrl::GetBoldFont

Pobiera czcionkę systemu Windows używaną do rysowania tekstu w bieżącej siatce właściwości w stylu pogrubienia.

CFont& GetBoldFont();

Wartość zwracana

Odwołanie do CFont obiektu opisującego cechy czcionki pogrubionej.

CMFCPropertyGridCtrl::GetCurSel

Pobiera aktualnie wybraną właściwość.

CMFCPropertyGridProperty* GetCurSel() const;

Wartość zwracana

Wskaźnik do obiektu właściwości, który odpowiada wybranemu elementowi w kontrolce siatki właściwości.

Uwagi

CMFCPropertyGridCtrl::GetCustomColors

Pobiera kolory niestandardowe, które są obecnie zdefiniowane dla elementów kontrolki siatki właściwości.

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

Parametry

clrBackground
[out] Kolor tła wartości właściwości.

clrText
[out] Kolor nazw właściwości i tekstu wartości właściwości.

clrGroupBackground
[out] Kolor tła grupy właściwości.

clrGroupText
[out] Kolor tekstu w grupie właściwości.

clrDescriptionBackground
[out] Kolor tła obszaru opisu.

clrDescriptionText
[out] Kolor tekstu w obszarze opisu.

clrLine
[out] Kolor linii, które są rysowane między właściwościami.

Uwagi

CMFCPropertyGridCtrl::SetCustomColors Użyj metody , aby ustawić kolory niestandardowe.

CMFCPropertyGridCtrl::GetDescriptionHeight

Pobiera wysokość obszaru opisu, który znajduje się w dolnej części kontrolki siatki właściwości.

int GetDescriptionHeight() const;

Wartość zwracana

Wysokość obszaru opisu w pikselach.

Uwagi

Wysokość obszaru opisu jest obliczana automatycznie i jest ustawiona na 1/4 wysokość kontrolki siatki właściwości.

CMFCPropertyGridCtrl::EnableDescriptionArea Użyj metody , aby wyświetlić lub ukryć obszar opisu. CMFCPropertyGridCtrl::IsDescriptionArea Użyj metody , aby określić, czy obszar opisu jest wyświetlany, czy ukryty.

CMFCPropertyGridCtrl::GetDescriptionRows

Pobiera liczbę wierszy w obszarze opisu bieżącej kontrolki siatki właściwości.

int GetDescriptionRows() const;

Wartość zwracana

Liczba wierszy w obszarze opisu bieżącej kontrolki siatki właściwości.

Uwagi

Konstruktor CMFCPropertyGridCtrl::CMFCPropertyGridCtrl inicjuje obszar opisu do 3 wierszy.

CMFCPropertyGridCtrl::GetHeaderCtrl

Pobiera obiekt wewnętrzny CMFCHeaderCtrl używany przez platformę do wyświetlania bieżącej kontrolki siatki właściwości.

virtual CMFCHeaderCtrl& GetHeaderCtrl();

Wartość zwracana

Odwołanie do CMFCHeaderCtrl obiektu.

CMFCPropertyGridCtrl::GetHeaderHeight

Pobiera wysokość nagłówka kontrolki siatki właściwości.

int GetHeaderHeight() const;

Wartość zwracana

Wysokość nagłówka w pikselach.

Uwagi

CMFCPropertyGridCtrl::GetLeftColumnWidth

Pobiera szerokość lewej kolumny kontrolki siatki właściwości bieżącej, która zawiera nazwę każdej właściwości.

int GetLeftColumnWidth() const;

Wartość zwracana

Szerokość kolumny nazwy.

Uwagi

Prawa kolumna kontrolki siatki właściwości zawiera wartość każdej właściwości.

CMFCPropertyGridCtrl::GetListRect

Pobiera prostokąt ograniczenia kontrolki siatki właściwości.

CRect GetListRect() const;

Wartość zwracana

Prostokąt ograniczenia kontrolki siatki właściwości. Ten prostokąt nie zawiera obszaru opisu i nagłówka.

Uwagi

CMFCPropertyGridCtrl::GetProperty

Pobiera wskaźnik do obiektu właściwości odpowiadającego określonemu indeksowi elementu w kontrolce siatki właściwości.

CMFCPropertyGridProperty* GetProperty(int nIndex) const;

Parametry

nIndex
[in] Indeks zerowy elementu kontrolki siatki właściwości.

Ta metoda potwierdza, czy nIndex parametr jest mniejszy niż zero lub większy niż lub równy liczbie właściwości.

Wartość zwracana

Wskaźnik do obiektu właściwości, który odpowiada określonemu indeksowi, jeśli ta metoda zakończy się pomyślnie; w przeciwnym razie, NULL.

Uwagi

CMFCPropertyGridCtrl::GetPropertyColumnWidth

Pobiera bieżącą szerokość kolumny zawierającej wartości właściwości.

int GetPropertyColumnWidth() const;

Wartość zwracana

Bieżąca szerokość kolumny zawierającej wartości właściwości.

Uwagi

Kolumna po prawej stronie kontrolki siatki właściwości zawiera wartości właściwości. Klient może użyć pola podziału kontrolki siatki właściwości, aby zmienić szerokość kolumny wartości.

CMFCPropertyGridCtrl::GetPropertyCount

Pobiera liczbę właściwości w kontrolce siatki właściwości.

int GetPropertyCount() const;

Wartość zwracana

Liczba właściwości.

Uwagi

CMFCPropertyGridCtrl::GetRowHeight

Pobiera wysokość wiersza w kontrolce siatki właściwości.

int GetRowHeight() const;

Wartość zwracana

Wysokość wiersza.

Uwagi

Wysokość wiersza jest równa bieżącej wysokości czcionki i 4 pikseli.

CMFCPropertyGridCtrl::GetScrollBarCtrl

Pobiera wskaźnik do kontrolki paska przewijania w kontrolce siatki właściwości.

virtual CScrollBar* GetScrollBarCtrl(int nBar) const;

Parametry

nBar
[in] Orientacja paska przewijania, który musi mieć wartość SB_VERT.

Wartość zwracana

Wskaźnik do obiektu paska przewijania lub NULL jeśli nie ma paska przewijania lub orientacja paska przewijania to SB_HORZ.

Uwagi

Użyj tej metody, aby uzyskać bezpośredni dostęp do kontrolki pionowego paska przewijania.

CMFCPropertyGridCtrl::GetTextColor

Pobiera kolor używany do rysowania tekstu elementów właściwości w bieżącej siatce właściwości.

COLORREF GetTextColor() const;

Wartość zwracana

Wartość koloru RGB.

Uwagi

Ta metoda pobiera kolor używany przez platformę do narysowania pierwszego planu kontrolki siatki właściwości bieżącej. Metoda CMFCPropertyGridCtrl::GetBkColor pobiera kolor tła.

CMFCPropertyGridCtrl::HitTest

Pobiera wskaźnik do obiektu właściwości odpowiadającego elementowi kontrolki siatki właściwości, jeśli określony punkt znajduje się w elemencie. Ta metoda wskazuje również obszar w kontrolce siatki właściwości, która zawiera punkt.

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

Parametry

pt
[in] Punkt we współrzędnych klienta.

pnArea
[in, out] Wskaźnik do zmiennej ClickArea . Gdy ta metoda zwraca, zmienna wskazuje obszar właściwości, który zawiera określony punkt. Aby uzyskać więcej informacji na temat obszaru właściwości, zobacz Uwagi.

bPropsOnly
[in] TRUE do testowania tylko obszaru właściwości; FALSE aby przetestować obszar opisu, jeśli określony punkt nie znajduje się w obszarze właściwości. Domyślna wartość to FALSE. Aby uzyskać więcej informacji na temat obszaru opisu, zobacz Uwagi.

Wartość zwracana

bPropsOnly Jeśli parametr jest TRUE i określony punkt znajduje się w obszarze właściwości, wartość zwracana jest wskaźnikiem do odpowiedniego obiektu właściwości. Ponadto pnArea parametr jest ustawiony na określony obszar zawierający określony punkt. W przeciwnym razie wartość zwracana jest NULL i pnArea parametr nie jest modyfikowany.

bPropsOnly Jeśli parametr ma FALSEwartość , zwracana wartość to zawsze NULL. Jeśli jednak określony punkt znajduje się w obszarze opisu, pnArea parametr jest ustawiony na CMFCPropertyGridProperty::ClickDescriptionwartość .

Uwagi

Termin obszar właściwości odnosi się do dowolnej nazwy, wartości lub rozwijania obszarów pola elementu kontrolki siatki właściwości. Obszar opisu jest strefą w dolnej części kontrolki siatki właściwości. Po wybraniu elementu kontrolki siatki właściwości obszar opisu wyświetla opis odpowiedniej właściwości.

Ta metoda ustawia wartość zmiennej wskazywanej przez pnArea parametr . W poniższej tabeli wymieniono możliwe wartości i odpowiednie obszary.

Wartość	Obszar
ClickArea::ClickExpandBox	Właściwość rozwiń kontrolkę pola.
ClickArea::ClickName	Nazwa właściwości.
ClickArea::ClickValue	Wartość właściwości.
CMFCPropertyGridProperty::ClickDescription	Obszar opisu kontrolki siatki właściwości.

CMFCPropertyGridCtrl::Init

Wywoływana przez strukturę w celu zainicjowania kontrolki siatki właściwości.

virtual void Init();

Uwagi

CMFCPropertyGridCtrl::InitHeader

Inicjuje obiekt wewnętrzny CMFCHeaderCtrl używany przez platformę do wyświetlania bieżącej kontrolki siatki właściwości.

virtual void InitHeader();

CMFCPropertyGridCtrl::IsAlphabeticMode

Wskazuje, czy kontrolka siatki właściwości jest w trybie alfabetycznym.

BOOL IsAlphabeticMode() const;

Wartość zwracana

TRUE jeśli kontrolka siatki właściwości jest w trybie alfabetycznym; w przeciwnym razie FALSE.

Uwagi

Gdy kontrolka siatki właściwości jest w trybie alfabetycznym, wszystkie właściwości są sortowane alfabetycznie według ich nazw. W przeciwnym razie właściwości są grupowane w węzłach nadrzędnych.

CMFCPropertyGridCtrl::SetAlphabeticMode Użyj metody , aby włączyć lub wyłączyć tryb alfabetyczny.

CMFCPropertyGridCtrl::IsAlwaysShowUserToolTip

BOOL IsAlwaysShowUserToolTip() const;

Wartość zwracana

Uwagi

CMFCPropertyGridCtrl::IsDescriptionArea

Wskazuje, czy jest wyświetlany obszar opisu kontrolki siatki właściwości.

BOOL IsDescriptionArea() const;

Wartość zwracana

TRUE jeśli zostanie wyświetlony obszar opisu; w przeciwnym razie, FALSE.

Uwagi

CMFCPropertyGridCtrl::EnableDescriptionArea Użyj metody , aby ukryć lub wyświetlić obszar opisu.

CMFCPropertyGridCtrl::IsGroupNameFullWidth

Wskazuje, czy każda nazwa grupy właściwości jest wyświetlana na całej szerokości bieżącej kontrolki siatki właściwości.

BOOL IsGroupNameFullWidth() const;

Wartość zwracana

TRUE jeśli nazwy grup są wyświetlane w całej szerokości kontrolki siatki właściwości; FALSE jeśli nazwy grup są obcinane przez prawą kolumnę (wartość) kontrolki.

Uwagi

Grupa jest kolekcją powiązanych właściwości w kontrolce siatki właściwości. Jeśli kontrolka jest wyświetlana hierarchicznie, nazwa grupy jest wyświetlana jako tytuł kategorii w wierszu powyżej grupy.

CMFCPropertyGridCtrl::IsHeaderCtrl

Wskazuje, czy jest wyświetlana kontrolka nagłówka.

BOOL IsHeaderCtrl() const;

Wartość zwracana

TRUE jeśli jest wyświetlana kontrolka nagłówka; w przeciwnym razie FALSE.

Uwagi

CMFCPropertyGridCtrl::EnableHeaderCtrl Użyj metody , aby ukryć lub wyświetlić kontrolkę nagłówka.

CMFCPropertyGridCtrl::IsMarkModifiedProperties

Wskazuje sposób wyświetlania zmodyfikowanych właściwości kontrolki siatki właściwości.

BOOL IsMarkModifiedProperties() const;

Wartość zwracana

TRUE jeśli styl pogrubiony jest używany do wyświetlania zmodyfikowanych właściwości; FALSE jeśli styl regularny jest używany do wyświetlania zmodyfikowanych właściwości.

Uwagi

CMFCPropertyGridCtrl::IsShowDragContext

Wskazuje, czy struktura ponownie rysuje kolumny nazwy i wartości bieżącej kontrolki siatki właściwości, gdy użytkownik zmienia rozmiar kolumn.

BOOL IsShowDragContext() const;

Wartość zwracana

TRUE jeśli struktura ponownie wyrysuje kolumny nazwy i wartości podczas operacji zmiany rozmiaru; FALSE jeśli struktura ponownie rysuje kolumny po zakończeniu operacji przeciągania.

Uwagi

Użytkownik może zmienić rozmiar kolumn nazwy i wartości kontrolki siatki właściwości, przeciągając pasek podziału między kolumnami. Jeśli kontekst przeciągania jest wyświetlany, rozmiar kolumn nazwy i wartości jest zmieniany tak długo, jak użytkownik przeciąga pasek podziału. W przeciwnym razie pasek podziału jest przesuwany, ale kolumny nie są ponownie rysowane do momentu zakończenia operacji przeciągania.

CMFCPropertyGridCtrl::IsVSDotNetLook

Wskazuje, czy wygląd kontrolki siatki właściwości jest w stylu programu Visual Studio .NET.

BOOL IsVSDotNetLook() const;

Wartość zwracana

TRUE jeśli kontrolka siatki właściwości jest w stylu programu Visual Studio .NET; w przeciwnym razie, FALSE.

Uwagi

CMFCPropertyGridCtrl::SetVSDotNetLook Użyj metody , aby ustawić kontrolkę siatki właściwości na styl programu Visual Studio .NET.

CMFCPropertyGridCtrl::MarkModifiedProperties

Określa sposób wyświetlania zmodyfikowanych właściwości.

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

Parametry

bMark
[in] TRUE do wyświetlania zmodyfikowanych właściwości w stylu pogrubienia; FALSE aby wyświetlić zmodyfikowane właściwości w regularnym stylu. Domyślna wartość to TRUE.

bRedraw
[in] TRUE aby natychmiast ponownie narysować kontrolkę siatki właściwości; w przeciwnym razie, FALSE. Domyślna wartość to TRUE.

Uwagi

CMFCPropertyGridCtrl::OnChangeSelection

Wywoływana przez strukturę po zmianie bieżącego zaznaczenia.

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

Parametry

pNewSel
[in] Wskaźnik do nowo wybranej właściwości.

pOldSel
[in] Wskaźnik do wcześniej wybranej właściwości.

Uwagi

Domyślna implementacja tej metody nic nie robi.

CMFCPropertyGridCtrl::OnClickButton

Wywoływana przez platformę po kliknięciu przycisku właściwości.

virtual void OnClickButton(CPoint point);

Parametry

point
[in] Punkt we współrzędnych klienta.

Uwagi

Domyślnie ta metoda aktualizuje bieżącą wartość właściwości.

CMFCPropertyGridCtrl::OnDrawBorder

Wywoływana przez strukturę w celu narysowania obramowania wokół kontrolki siatki właściwości.

virtual void OnDrawBorder(CDC* pDC);

Parametry

pDC
[in] Wskaźnik do kontekstu urządzenia.

Uwagi

CMFCPropertyGridCtrl::OnDrawDescription

Wywoływana przez strukturę, aby narysować obszar opisu i wyświetlić tekst opisu.

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

Parametry

pDC
[in] Wskaźnik do kontekstu urządzenia.

rect
[in] Prostokąt określający, gdzie narysować obszar opisu.

Uwagi

CMFCPropertyGridCtrl::EnableDescriptionArea Użyj metody , aby wyświetlić obszar opisu.

CMFCPropertyGridCtrl::OnDrawList

Wywoływana przez strukturę w celu wyświetlenia listy właściwości w kontrolce siatki właściwości.

virtual void OnDrawList(CDC* pDC);

Parametry

pDC
[in] Wskaźnik do kontekstu urządzenia.

Uwagi

CMFCPropertyGridCtrl::OnDrawProperty

Wywoływana przez strukturę w celu wyświetlenia właściwości.

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

Parametry

pDC
[in] Wskaźnik do kontekstu urządzenia.

pProp
[in] Wskaźnik do obiektu właściwości.

Wartość zwracana

TRUE jeśli ta metoda zakończy się pomyślnie; w przeciwnym razie, FALSE.

Uwagi

CMFCPropertyGridCtrl::OnPropertyChanged

Wywoływana przez strukturę, gdy wartość właściwości zostanie zmieniona.

virtual void OnPropertyChanged(CMFCPropertyGridProperty* pProp) const;

Parametry

pProp
[in] Wskaźnik do obiektu właściwości, którego wartość uległa zmianie.

Uwagi

Domyślnie ta metoda wysyła AFX_WM_PROPERTY_CHANGED komunikat do właściciela kontrolki siatki właściwości.

CMFCPropertyGridCtrl::OnSelectCombo

Wywoływana przez platformę, gdy jest zaznaczona właściwość zawierająca kontrolkę pola kombi.

void OnSelectCombo();

Uwagi

CMFCPropertyGridCtrl::RemoveAll

Usuwa wszystkie obiekty właściwości z kontrolki siatki właściwości.

void RemoveAll();

Uwagi

CMFCPropertyGridCtrl::ResetOriginalValues

Przywraca oryginalne wartości wszystkich właściwości.

void ResetOriginalValues(BOOL bRedraw=TRUE);

Parametry

bRedraw
[in] TRUE aby ponownie narysować listę właściwości; w przeciwnym razie, FALSE. Domyślna wartość to TRUE.

Uwagi

CMFCPropertyGridCtrl::SetAlphabeticMode

Ustawia lub resetuje tryb alfabetyczny.

void SetAlphabeticMode(BOOL bSet=TRUE);

Parametry

bSet
[in] TRUE aby ustawić tryb alfabetyczny; FALSE resetuj tryb alfabetyczny. Domyślna wartość to TRUE.

Uwagi

Gdy kontrolka siatki właściwości jest w trybie alfabetycznym, kontrolka sortuje wszystkie właściwości, które zawiera według ich nazwy właściwości.

CMFCPropertyGridCtrl::SetBoolLabels

Określa tekst etykiet logicznych.

void SetBoolLabels(
    LPCTSTR lpszTrue,
    LPCTSTR lpszFalse);

Parametry

lpszTrue
[in] Ciąg tekstowy do wyświetlenia dla wartości logicznej true.

lpszFalse
[in] Ciąg tekstowy do wyświetlenia dla wartości logicznej false.

Uwagi

CMFCPropertyGridCtrl::SetCurSel

Wybiera właściwość w kontrolce siatki właściwości.

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

Parametry

pProp
[in] Wskaźnik do obiektu właściwości.

bRedraw
[in] TRUE aby natychmiast ponownie narysować kontrolkę siatki właściwości; w przeciwnym razie, FALSE. Domyślna wartość to TRUE.

Uwagi

Użyj tej metody, aby anulować wybór bieżącego elementu w kontrolce siatki właściwości, a następnie wybrać element, który odpowiada określonej właściwości.

CMFCPropertyGridCtrl::SetCustomColors

Określa kolory niestandardowe dla różnych elementów kontrolki siatki właściwości.

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

Parametry

clrBackground
[in] Kolor tła wartości właściwości.

clrText
[in] Kolor nazw właściwości i tekstu wartości właściwości.

clrGroupBackground
[in] Kolor tła grupy właściwości.

clrGroupText
[in] Nowy kolor tekstu grupy właściwości.

clrDescriptionBackground
[in] Kolor tła obszaru opisu.

clrDescriptionText
[in] Kolor tekstu w obszarze opisu.

clrLine
[in] Kolor linii, które są rysowane między właściwościami.

Uwagi

Dla dowolnego parametru ((COLORREF)-1) określ wartość koloru, aby użyć domyślnego koloru dla tego elementu kontrolki siatki właściwości.

Aby dostosować wygląd określonej właściwości, należy utworzyć klasę z CMFCPropertyGridProperty klasy, a następnie zastąpić CMFCPropertyGridProperty::OnDrawNamemetody , CMFCPropertyGridProperty::OnDrawValue, CMFCPropertyGridProperty::OnDrawExpandBoxi CMFCPropertyGridProperty::OnDrawButton .

CMFCPropertyGridCtrl::SetDescriptionRows

Określa liczbę wierszy do wyświetlenia w sekcji opisu bieżącej kontrolki siatki właściwości.

void SetDescriptionRows(int nDescRows);

Parametry

nDescRows
[in] Liczba wierszy do wyświetlenia w opisie właściwości.

CMFCPropertyGridCtrl::SetGroupNameFullWidth

Określa, czy wyświetlić pełną szerokość nazwy kategorii dla grupy właściwości w bieżącej siatce właściwości.

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

Parametry

bGroupNameFullWidth
[in] TRUE aby wyświetlić pełną szerokość nazwy kategorii niezależnie od szerokości kolumny nazwy właściwości. FALSE aby ograniczyć szerokość nazwy kategorii do szerokości kolumny nazwa właściwości. Domyślna wartość to TRUE.

bRedraw
[in] TRUE aby natychmiast zaktualizować kontrolkę siatki właściwości; FALSE w celu zaktualizowania kontrolki po wystąpieniu następnego zdarzenia ponownego rysowania. Domyślna wartość to TRUE.

Uwagi

Kontrolka siatki właściwości składa się z kolumny nazwy właściwości z możliwością zmiany rozmiaru i kolumny wartości właściwości. Koniec kolumny name jest również początkiem kolumny wartości. Aby zmienić rozmiar kolumn, przeciągnij obramowanie między kolumnami.

Terminy nazwa grupy i nazwa kategorii są używane zamiennie w tej metodzie. Nazwa kategorii jest wyświetlana w wierszu, który kieruje zestawem powiązanych właściwości i wartości. Ta metoda określa, czy szerokość kolumny nazwa właściwości określa również szerokość wyświetlanej nazwy kategorii.

CMFCPropertyGridCtrl::SetListDelimiter

Definiuje znak, który jest używany jako ogranicznik na liście wartości właściwości.

void SetListDelimiter(TCHAR c);

Parametry

c
[in] Znak służący jako ogranicznik.

Uwagi

Użyj tej metody, aby zdefiniować znak ogranicznika na liście wartości właściwości używanych w konstruktorze CMFCPropertyGridProperty::CMFCPropertyGridProperty . W tym konstruktorze bIsValueList ustaw parametr na TRUEwartość .

Domyślnie CMFCPropertyGridCtrl::CMFCPropertyGridCtrl konstruktor ustawia znak ogranicznika na przecinek (',').

CMFCPropertyGridCtrl::SetShowDragContext

Określa, czy struktura ponownie rysuje kolumny nazwy i wartości bieżącej kontrolki siatki właściwości, gdy użytkownik zmienia rozmiar kolumn.

void SetShowDragContext(BOOL bShowDragContext = TRUE);

Parametry

bShowDragContext
[in] TRUE aby ponownie wyrysować kolumny nazwy i wartości podczas operacji zmiany rozmiaru; FALSE aby ponownie narysować kolumny po zakończeniu operacji przeciągania. Domyślna wartość to TRUE.

Uwagi

Użytkownik może zmienić rozmiar kolumn nazwy i wartości kontrolki siatki właściwości, przeciągając pasek podziału między kolumnami. Jeśli kontekst przeciągania jest wyświetlany, rozmiar kolumn nazwy i wartości jest zmieniany tak długo, jak użytkownik przeciąga pasek podziału. W przeciwnym razie pasek podziału jest przesuwany, ale kolumny nie są ponownie rysowane do momentu zakończenia operacji przeciągania.

CMFCPropertyGridCtrl::SetVSDotNetLook

Ustawia wygląd kontrolki siatki właściwości na styl używany w programie Visual Studio .NET.

void SetVSDotNetLook(BOOL bSet=TRUE);

Parametry

bSet
[in] TRUE aby ustawić kontrolkę siatki właściwości na styl używany w programie Visual Studio .NET; w przeciwnym razie, FALSE. Domyślna wartość to TRUE.

Uwagi

CMFCPropertyGridCtrl::UpdateColor

Ustawia wartość koloru aktualnie wybranej właściwości koloru.

virtual void UpdateColor(COLORREF color);

Parametry

color
[in] Wartość koloru RGB.

Uwagi

Ta metoda jest asercyjna w trybie debugowania, jeśli aktualnie wybrana właściwość kontrolki siatki właściwości nie jest właściwością color.

CMFCPropertyGridCtrl::ValidateItemData

Wywoływana przez platformę w celu zweryfikowania danych właściwości.

virtual BOOL ValidateItemData(CMFCPropertyGridProperty* pProp);

Parametry

pProp
[in] Wskaźnik do właściwości. Ten parametr nie jest używany.

Wartość zwracana

Zawsze wartość TRUE.

Uwagi

Metoda CMFCPropertyGridCtrl::EndEditItem wywołuje tę metodę w celu zweryfikowania danych. Domyślnie ta metoda nie używa parametru pProp , a jej wartość zwracana jest zawsze TRUE.

Jeśli zastąpisz tę metodę, zwróć TRUE , czy określone dane właściwości są prawidłowe. W przeciwnym razie zwróć wartość FALSE, w którym przypadku platforma nie aktualizuje właściwości .

Zobacz też

Wykres hierarchii
Klasy