CMFCPropertyGridCtrl – třída

Další podrobnosti najdete ve zdrojovém kódu umístěném mfc ve složce instalace sady Visual Studio. Například %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc.

Podporuje upravitelný ovládací prvek mřížky vlastností, který může zobrazovat vlastnosti v abecedním nebo hierarchickém pořadí.

Syntaxe

class CMFCPropertyGridCtrl : public CWnd

Členové

Veřejné konstruktory

Název	Popis
CMFCPropertyGridCtrl::CMFCPropertyGridCtrl	CMFCPropertyGridCtrl Vytvoří objekt.
CMFCPropertyGridCtrl::~CMFCPropertyGridCtrl	Destruktor.

Veřejné metody

Název	Popis
CMFCPropertyGridCtrl::accHitTest	Volá se rozhraním pro načtení podřízeného elementu nebo podřízeného objektu v daném bodě na obrazovce. (Přepsání CWnd::accHitTest.)
CMFCPropertyGridCtrl::accLocation	Volá se rozhraním pro načtení aktuálního umístění obrazovky zadaného objektu. (Přepsání CWnd::accLocation.)
CMFCPropertyGridCtrl::accSelect	Volá se rozhraním pro úpravu výběru nebo přesunutí fokusu klávesnice zadaného objektu. (Přepsání CWnd::accSelect.)
CMFCPropertyGridCtrl::AddProperty	Přidá novou vlastnost do ovládacího prvku mřížky vlastností.
CMFCPropertyGridCtrl::AlwaysShowUserToolTip
CMFCPropertyGridCtrl::CloseColorPopup	Zavře dialogové okno pro výběr barev.
CMFCPropertyGridCtrl::Create	Vytvoří ovládací prvek mřížky vlastností a připojí ho k objektu ovládacího prvku mřížky vlastností.
CMFCPropertyGridCtrl::DeleteProperty	Odstraní zadanou vlastnost z ovládacího prvku mřížky vlastností.
CMFCPropertyGridCtrl::DrawControlBarColors
CMFCPropertyGridCtrl::EnableDescriptionArea	Povolí nebo zakáže oblast popisu zobrazenou pod seznamem vlastností.
CMFCPropertyGridCtrl::EnableHeaderCtrl	Povolí nebo zakáže ovládací prvek záhlaví v horní části ovládacího prvku mřížky vlastností.
CMFCPropertyGridCtrl::EnsureVisible	Posune ovládací prvek mřížky vlastností a rozbalí položky vlastností, dokud nebude zadaná vlastnost viditelná.
CMFCPropertyGridCtrl::ExpandAll	Rozbalí nebo sbalí všechny uzly ovládacích prvků mřížky vlastností.
CMFCPropertyGridCtrl::FindItemByData	Načte vlastnost přidruženou k uživatelem definované DWORD hodnotě.
CMFCPropertyGridCtrl::get_accChild	Volal rozhraní pro načtení adresy IDispatch rozhraní pro zadané podřízené. (Přepsání CWnd::get_accChild.)
CMFCPropertyGridCtrl::get_accChildCount	Volá se rozhraním k načtení počtu podřízených objektů patřících tomuto objektu. (Přepsání CWnd::get_accChildCount.)
CMFCPropertyGridCtrl::get_accDefaultAction	Volá se rozhraním pro načtení řetězce, který popisuje výchozí akci objektu. (Přepsání CWnd::get_accDefaultAction.)
CMFCPropertyGridCtrl::get_accDescription	Volá se podle architektury k načtení řetězce, který popisuje vizuální vzhled zadaného objektu. (Přepsání CWnd::get_accDescription.)
CMFCPropertyGridCtrl::get_accFocus	Volá se rozhraním pro načtení objektu, který má fokus klávesnice. (Přepsání CWnd::get_accFocus.)
CMFCPropertyGridCtrl::get_accHelp	Volá se rozhraním pro načtení řetězce vlastností objektu Help . (Přepsání CWnd::get_accHelp.)
CMFCPropertyGridCtrl::get_accHelpTopic	Volá se rozhraním pro načtení úplné cesty WinHelp k souboru přidruženému k zadanému objektu a identifikátoru příslušného tématu v daném souboru. (Přepsání CWnd::get_accHelpTopic.)
CMFCPropertyGridCtrl::get_accKeyboardShortcut	Volá se rozhraním pro načtení klávesové zkratky nebo přístupové klávesy zadaného objektu. (Přepsání CWnd::get_accKeyboardShortcut.)
CMFCPropertyGridCtrl::get_accName	Volá se rozhraním pro načtení názvu zadaného objektu. (Přepsání CWnd::get_accName.)
CMFCPropertyGridCtrl::get_accRole	Volá se rozhraním pro načtení informací, které popisují roli zadaného objektu. (Přepsání CWnd::get_accRole.)
CMFCPropertyGridCtrl::get_accSelection	Volá se rozhraním pro načtení vybraných podřízených objektů tohoto objektu. (Přepsání CWnd::get_accSelection.)
CMFCPropertyGridCtrl::get_accState	Volá se rozhraním pro načtení aktuálního stavu zadaného objektu. (Přepsání CWnd::get_accState.)
CMFCPropertyGridCtrl::get_accValue	Volá se rozhraním pro načtení hodnoty zadaného objektu. (Přepsání CWnd::get_accValue.)
CMFCPropertyGridCtrl::GetBkColor	Načte barvu pozadí aktuálního ovládacího prvku mřížky vlastností.
CMFCPropertyGridCtrl::GetBoldFont	Načte písmo Windows textu v aktuálním ovládacím prvku mřížky vlastností tučným stylem.
CMFCPropertyGridCtrl::GetCurSel	Načte aktuálně vybranou vlastnost.
CMFCPropertyGridCtrl::GetCustomColors	Načte vlastní barvy, které jsou aktuálně definovány pro prvky ovládacího prvku mřížky vlastností.
CMFCPropertyGridCtrl::GetDescriptionHeight	Načte výšku oblasti popisu umístěné v dolní části ovládacího prvku mřížky vlastností.
CMFCPropertyGridCtrl::GetDescriptionRows	Načte počet řádků v oblasti popisu aktuálního ovládacího prvku mřížky vlastností.
CMFCPropertyGridCtrl::GetHeaderCtrl	Načte interní CMFCHeaderCtrl objekt, který architektura používá k zobrazení aktuálního ovládacího prvku mřížky vlastností.
CMFCPropertyGridCtrl::GetHeaderHeight	Načte výšku záhlaví ovládacího prvku mřížky vlastností.
CMFCPropertyGridCtrl::GetLeftColumnWidth	Načte šířku levého sloupce aktuálního ovládacího prvku mřížky vlastností, který obsahuje název každé vlastnosti.
CMFCPropertyGridCtrl::GetListRect	Načte ohraničující obdélník ovládacího prvku mřížky vlastností.
CMFCPropertyGridCtrl::GetProperty	Načte ukazatel na objekt vlastnosti, který odpovídá zadanému indexu položky ovládacího prvku mřížky vlastností.
CMFCPropertyGridCtrl::GetPropertyColumnWidth	Načte aktuální šířku sloupce, který obsahuje hodnoty vlastností.
CMFCPropertyGridCtrl::GetPropertyCount	Načte počet vlastností v ovládacím prvku mřížky vlastností.
CMFCPropertyGridCtrl::GetRowHeight	Načte výšku řádku v ovládacím prvku mřížky vlastností.
CMFCPropertyGridCtrl::GetScrollBarCtrl	Načte ukazatel na ovládací prvek posuvníku v ovládacím prvku mřížky vlastností. (Přepsání CWnd::GetScrollBarCtrl.)
CMFCPropertyGridCtrl::GetTextColor	Načte barvu textu položek vlastností v aktuálním ovládacím prvku mřížky vlastností.
CMFCPropertyGridCtrl::GetThisClass	Používá se architekturou k získání ukazatele na CRuntimeClass objekt, který je přidružen k tomuto typu třídy.
CMFCPropertyGridCtrl::HitTest	Načte ukazatel na objekt vlastnosti, který odpovídá položce ovládacího prvku mřížky vlastností, pokud je v položce zadaný bod. Tato metoda také označuje oblast v ovládacím prvku mřížky vlastností, který obsahuje bod.
CMFCPropertyGridCtrl::InitHeader	Inicializuje vnitřní CMFCHeaderCtrl objekt, který architektura používá k zobrazení aktuálního ovládacího prvku mřížky vlastností.
CMFCPropertyGridCtrl::IsAlphabeticMode	Určuje, zda je ovládací prvek mřížky vlastností v abecedním režimu.
CMFCPropertyGridCtrl::IsAlwaysShowUserToolTip
CMFCPropertyGridCtrl::IsDescriptionArea	Určuje, zda je zobrazena oblast popisu ovládacího prvku mřížky vlastností.
CMFCPropertyGridCtrl::IsGroupNameFullWidth	Určuje, zda je každý název skupiny vlastností zobrazen v šířce aktuálního ovládacího prvku mřížky vlastností.
CMFCPropertyGridCtrl::IsHeaderCtrl	Určuje, zda je zobrazen ovládací prvek záhlaví.
CMFCPropertyGridCtrl::IsMarkModifiedProperties	Určuje, jak ovládací prvek mřížky vlastností zobrazuje změněné vlastnosti.
CMFCPropertyGridCtrl::IsShowDragContext	Určuje, zda architektura překresluje sloupce názvů a hodnot aktuálního ovládacího prvku mřížky vlastností, když uživatel změní velikost sloupců.
CMFCPropertyGridCtrl::IsVSDotNetLook	Určuje, zda vzhled ovládacího prvku mřížky vlastností je ve stylu, který používá VS .NET.
CMFCPropertyGridCtrl::MarkModifiedProperties	Určuje, jak zobrazit změněné vlastnosti.
CMFCPropertyGridCtrl::PreTranslateMessage	CWinApp Třída slouží k překladu zpráv oken před jejich odesláním TranslateMessage do funkcí systému Windows a DispatchMessage Windows. (Přepsání CWnd::PreTranslateMessage.)
CMFCPropertyGridCtrl::RemoveAll	Odebere všechny objekty vlastností z ovládacího prvku mřížky vlastností.
CMFCPropertyGridCtrl::ResetOriginalValues	Obnoví původní hodnotu všech vlastností.
CMFCPropertyGridCtrl::SetAlphabeticMode	Nastaví nebo obnoví abecední režim.
CMFCPropertyGridCtrl::SetBoolLabels	Určuje text logických popisků.
CMFCPropertyGridCtrl::SetCurSel	Vybere vlastnost v ovládacím prvku mřížky vlastností.
CMFCPropertyGridCtrl::SetCustomColors	Určuje vlastní barvy pro různé prvky ovládacího prvku mřížky vlastností.
CMFCPropertyGridCtrl::SetDescriptionRows	Určuje počet řádků, které se mají zobrazit v části popisu aktuálního ovládacího prvku mřížky vlastností.
CMFCPropertyGridCtrl::SetGroupNameFullWidth	Určuje, zda se má zobrazit úplná šířka názvu kategorie pro skupinu vlastností v aktuálním ovládacím prvku mřížky vlastností.
CMFCPropertyGridCtrl::SetListDelimiter	Definuje znak, který se použije jako oddělovač v seznamu hodnot vlastností.
CMFCPropertyGridCtrl::SetShowDragContext	Určuje, zda architektura překresluje sloupce názvu a hodnoty aktuálního ovládacího prvku mřížky vlastností, když uživatel změní velikost sloupců.
CMFCPropertyGridCtrl::SetVSDotNetLook	Nastaví vzhled ovládacího prvku mřížky vlastností na styl, který se používá ve VS .NET.
CMFCPropertyGridCtrl::UpdateColor	Nastaví hodnotu barvy aktuálně vybrané vlastnosti barvy.

Chráněné metody

Název	Popis
CMFCPropertyGridCtrl::AdjustLayout	Překreslí ovládací prvek mřížky vlastností a jeho vlastnosti.
CMFCPropertyGridCtrl::CompareProps	Volá se ovládací prvek mřížky vlastností pro řazení vlastností.
CMFCPropertyGridCtrl::EditItem	Volá se rozhraním, když uživatel začne upravovat vlastnost.
CMFCPropertyGridCtrl::EndEditItem	Volá se rozhraním, když uživatel přestane upravovat vlastnost.
CMFCPropertyGridCtrl::Init	Volá se rozhraním pro inicializaci ovládacího prvku mřížky vlastností.
CMFCPropertyGridCtrl::OnChangeSelection	Volá se rozhraním při změně aktuálního výběru.
CMFCPropertyGridCtrl::OnClickButton	Volá se rozhraním při kliknutí na tlačítko vlastnosti.
CMFCPropertyGridCtrl::OnDrawBorder	Volá se rozhraním k vykreslení ohraničení kolem ovládacího prvku mřížky vlastností.
CMFCPropertyGridCtrl::OnDrawDescription	Volá se rozhraním pro vykreslení oblasti popisu a zobrazení textu popisu.
CMFCPropertyGridCtrl::OnDrawList	Volá se rozhraním pro zobrazení seznamu vlastností v ovládacím prvku mřížky vlastností.
CMFCPropertyGridCtrl::OnDrawProperty	Volá se rozhraním pro zobrazení vlastnosti.
CMFCPropertyGridCtrl::OnPropertyChanged	Volá se rozhraním při změně hodnoty vlastnosti.
CMFCPropertyGridCtrl::OnSelectCombo	Volá se rozhraním, pokud je vybrána vlastnost, která obsahuje ovládací prvek pole se seznamem.
CMFCPropertyGridCtrl::ValidateItemData	Volá se rozhraním k ověření dat vlastností.

Poznámky

Třída CMFCPropertyGridCtrl zobrazí ovládací prvek mřížky vlastností, který obsahuje upravitelné vlastnosti odvozené z CMFCPropertyGridProperty třídy. Každá vlastnost může představovat typ a může obsahovat dílčí položky. Ovládací prvek mřížky vlastností podporuje měnitelnou oblast v dolní části, která může zobrazit popis vybrané vlastnosti.

Chcete-li použít ovládací prvek mřížky vlastností, vytvořte CMFCPropertyGridCtrl objekt a potom volejte metodu CMFCPropertyGridCtrl::Create . CMFCPropertyGridCtrl::AddProperty Metoda slouží k přidání vlastností do seznamu.

Vlastnosti výběru

Místo toho, aby představovala hodnotu, může položka vlastnosti spustit dialogové okno, které uživateli umožňuje vybrat barvu, soubor nebo písmo.

Následující tabulka obsahuje čtyři typy vlastností výběru:

Třída	Popis
CMFCPropertyGridProperty Třída	Vlastnost pro obecné účely, která se používá k určení hodnoty řetězců, logických hodnot, kalendářních dat atd.
CMFCPropertyGridColorProperty Třída	Vlastnost, která slouží k výběru hodnoty barvy.
CMFCPropertyGridFileProperty Třída	Vlastnost, která slouží k výběru souboru.
CMFCPropertyGridFontProperty Třída	Vlastnost, která slouží k výběru písma.

Ilustrace

Následující ilustrace znázorňují ovládací prvek mřížky vlastností, který zobrazuje vlastnosti dvěma způsoby. První obrázek zobrazuje vlastnosti hierarchicky a druhý zobrazuje vlastnosti abecedně.

Příklad

Následující příklad ukazuje, jak nakonfigurovat objekt ovládacího prvku mřížky vlastností pomocí různých metod ve CMFCPropertyGridCtrl třídě. Příklad ukazuje, jak povolit ovládací prvek záhlaví, povolit oblast popisu a nastavit vzhled ovládacího prvku mřížky vlastností. Příklad také ukazuje, jak nastavit abecední režim pro ovládací prvek, kde ovládací prvek seřadí všechny vlastnosti, které obsahuje podle názvu vlastnosti, a jak nastavit vlastní barvy pro různé prvky ovládacího prvku mřížky vlastností. Tento příklad je součástí ukázky Nové ovládací prvky.

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

Hierarchie dědičnosti

CObject

CCmdTarget

CWnd

CMFCPropertyGridCtrl

Požadavky

Záhlaví: afxpropertygridctrl.h

CMFCPropertyGridCtrl::accSelect

virtual HRESULT accSelect(
    long flagsSelect,
    VARIANT varChild);

Parametry

[v] flagsSelect
[v] varChild\

Návratová hodnota

Poznámky

CMFCPropertyGridCtrl::AddProperty

Přidá novou vlastnost do ovládacího prvku mřížky vlastností.

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

Parametry

pProp
[v] Ukazatel na vlastnost.

bRedraw
[v] TRUE překreslit vlastnost okamžitě; v opačném případě . FALSE Výchozí hodnota je TRUE.

bAdjustLayout
[v] TRUE chcete-li přepočítat, jak nakreslit text a hodnotu vlastnosti a potom nakreslit vlastnost; FALSE použít existující výpočty k vykreslení vlastnosti. Výchozí hodnota je TRUE.

Návratová hodnota

Pokud je tato metoda úspěšná, index založený na nule pozice v ovládacího prvku mřížky vlastností, kde je vlastnost přidána; jinak, -1.

Poznámky

Tato metoda přidá ukazatel na zadanou vlastnost na konec seznamu vlastností v ovládacím prvku mřížky vlastností. Nezničte vlastnosti nebo je nedovolte, aby před zničením ovládacího prvku mřížky přešly mimo rozsah. Po dokončení ovládacího prvku mřížky vlastností voláním CMFCPropertyGridCtrl::RemoveAll odstraňte všechny přidané vlastnosti. Metoda AddProperty selže, pokud zadaná vlastnost již byla přidána do seznamu.

CMFCPropertyGridCtrl::AdjustLayout

Překreslí ovládací prvek mřížky vlastností a jeho vlastnosti.

virtual void AdjustLayout();

Poznámky

Tato metoda přepočítá, jak nakreslit celý ovládací prvek mřížky vlastností a jeho vlastnosti, včetně obrázků, písem a ovládacích prvků.

CMFCPropertyGridCtrl::AlwaysShowUserToolTip

void AlwaysShowUserToolTip(BOOL bShow = TRUE);

Parametry

[v] bShow\

Poznámky

CMFCPropertyGridCtrl::CloseColorPopup

Zavře dialogové okno pro výběr barev.

virtual void CloseColorPopup();

Poznámky

Další informace o dialogovém okně pro výběr barev naleznete v tématu CMFCPropertyGridColorProperty Třída.

CMFCPropertyGridCtrl::CMFCPropertyGridCtrl

CMFCPropertyGridCtrl Vytvoří objekt.

CMFCPropertyGridCtrl();

Návratová hodnota

Poznámky

CMFCPropertyGridCtrl::CompareProps

Volá se ovládací prvek mřížky vlastností pro řazení vlastností.

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

Parametry

pProp1
Ukazatel na vlastnost.

pProp2
Ukazatel na vlastnost.

Návratová hodnota

Návratová hodnota	Popis
< 0	Název parametru pProp1 je menší než název parametru pProp2 .
0	Název parametru pProp1 se rovná názvu parametru pProp2 .
> 0	Název objektu pProp1 je větší než název parametru pProp2 .

Poznámky

Ve výchozím nastavení tato metoda používá metodu CString::Compare k porovnání CMFCPropertyGridProperty::m_strName členů zadaných parametrů.

CMFCPropertyGridCtrl::Create

Vytvoří ovládací prvek mřížky vlastností a připojí ho k objektu ovládacího prvku mřížky vlastností.

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

Parametry

dwStyle
[v] Bitové kombinace "or" (|) stylů oken.

rect
[v] Ohraničující obdélník, který určuje velikost a umístění okna v souřadnicích pParentWndklienta .

pParentWnd
[v] Ukazatel na nadřazené okno Nesmí být NULL.

nID
[v] ID podřízeného okna.

Návratová hodnota

TRUEpokud bylo okno úspěšně vytvořeno; v opačném případě . FALSE

Poznámky

Chcete-li vytvořit ovládací prvek mřížky vlastností, nejprve volání CMFCPropertyGridCtrl::CMFCPropertyGridCtrl sestavení objektu mřížky vlastností. Pak zavolejte CMFCPropertyGridCtrl::Create.

Příklad

Následující příklad ukazuje, jak použít metodu Create ve CMFCPropertyGridCtrl třídě. Tento příklad je součástí ukázky Nové ovládací prvky.

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

Odstraní zadanou vlastnost z ovládacího prvku mřížky vlastností.

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

Parametry

pProp
[v] Ukazatel na vlastnost.

bRedraw
[v] TRUE překreslit ovládací prvek mřížky vlastností; v opačném případě . FALSE Výchozí hodnota je TRUE.

bAdjustLayout
[v] TRUE chcete-li přepočítat, jak nakreslit veškerý text, obrázky a položky v ovládacím prvku mřížky vlastností a pak nakreslit ovládací prvek; v opačném případě . FALSE Výchozí hodnota je TRUE.

Návratová hodnota

TRUEpokud je tato metoda úspěšná; v opačném případě . FALSE

Poznámky

Tuto metodu použijte k odstranění vlastnosti a všech dílčích položek z ovládacího prvku mřížky vlastností.

CMFCPropertyGridCtrl::DrawControlBarColors

BOOL DrawControlBarColors() const;

Návratová hodnota

Poznámky

CMFCPropertyGridCtrl::EditItem

Volá se rozhraním, když uživatel začne upravovat vlastnost.

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

Parametry

pProp
[v] Ukazatel na vlastnost.

lptClick
[v] Bod v ovládacím prvku mřížky vlastností, na který uživatel klikl, zahájí operaci úprav. Bod je v souřadnicích klienta ovládacího prvku. Výchozí hodnota je NULL.

Návratová hodnota

TRUEpokud je metoda úspěšná; v opačném případě . FALSE

Poznámky

CMFCPropertyGridCtrl::EnableDescriptionArea

Povolí nebo zakáže oblast popisu zobrazenou pod seznamem vlastností v ovládacím prvku mřížky vlastností.

void EnableDescriptionArea(BOOL bEnable=TRUE);

Parametry

bEnable
[v] TRUE povolit oblast popisu; FALSE a zakázat oblast popisu. Výchozí hodnota je TRUE.

Poznámky

Oblast popisu se zobrazí v dolní části ovládacího prvku mřížky vlastností. Ve výchozím nastavení je oblast popisu zakázaná a není viditelná.

CMFCPropertyGridCtrl::EnableHeaderCtrl

Povolí nebo zakáže ovládací prvek záhlaví v horní části ovládacího prvku mřížky vlastností.

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

Parametry

bEnable
[v] TRUE povolení ovládacího prvku záhlaví; FALSE a zakažte ovládací prvek záhlaví. Výchozí hodnota je TRUE.

lpszLeftColumn
[v] Název levého sloupce ovládacího prvku záhlaví. Výchozí hodnota je Property.

lpszRightColumn
[v] Název pravého sloupce ovládacího prvku záhlaví Výchozí hodnota je Value.

CMFCPropertyGridCtrl::EndEditItem

Volá se rozhraním, když uživatel dokončí úpravu vlastnosti.

virtual BOOL EndEditItem(BOOL bUpdateData=TRUE);

Parametry

bUpdateData
[v] TRUE k určení, že upravená data vlastností musí být ověřena po dokončení operace úprav; v opačném případě . FALSE Výchozí hodnota je TRUE.

Návratová hodnota

TRUE pokud operace úprav úspěšně skončí; FALSE pokud upravená data vlastností nejsou platná nebo pokud by operace úprav měla pokračovat.

Poznámky

CMFCPropertyGridCtrl::EnsureVisible

Posune ovládací prvek mřížky vlastností a rozbalí položky vlastností, dokud nebude zadaná vlastnost viditelná.

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

Parametry

pProp
[v] Ukazatel na vlastnost.

bExpandParents
[v] TRUE chcete-li rozbalit nadřazené položky, aby byla zadaná vlastnost viditelná; v opačném případě . FALSE Výchozí hodnota je FALSE.

Poznámky

CMFCPropertyGridCtrl::ExpandAll

Rozbalí nebo sbalí všechny uzly ovládacích prvků mřížky vlastností.

void ExpandAll(BOOL bExpand=TRUE);

Parametry

bExpand
[v] TRUE rozbalení všech uzlů; FALSE a sbalit všechny uzly. Výchozí hodnota je TRUE.

Poznámky

CMFCPropertyGridCtrl::FindItemByData

Načte vlastnost přidruženou k uživatelem definované DWORD hodnotě.

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

Parametry

dwData
[v] Hodnota DWORD .

bSearchSubItems
[v] TRUE pro vyhledávání dílčích položek vlastností; v opačném případě . FALSE Výchozí hodnota je TRUE.

Návratová hodnota

Ukazatel na přidružený objekt vlastnosti, pokud tato metoda úspěšně; v opačném případě . NULL

Poznámky

Pomocí konstruktoru CMFCPropertyGridCtrl::CMFCPropertyGridCtrl nebo CMFCPropertyGridProperty::SetData metody přidružte vlastnost DWORD .

CMFCPropertyGridCtrl::get_accChildCount

virtual HRESULT get_accChildCount(long* pcountChildren);

Parametry

[v] pcountChildren\

Návratová hodnota

Poznámky

CMFCPropertyGridCtrl::get_accFocus

virtual HRESULT get_accFocus(VARIANT* pvarChild);

Parametry

[v] pvarChild\

Návratová hodnota

Poznámky

CMFCPropertyGridCtrl::get_accHelp

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

Parametry

[v] varChild
[v] pszHelp\

Návratová hodnota

Poznámky

CMFCPropertyGridCtrl::get_accHelpTopic

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

Parametry

[v] pszHelpFile
[v] varChild
[v] pidTopic\

Návratová hodnota

Poznámky

CMFCPropertyGridCtrl::get_accKeyboardShortcut

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

Parametry

[v] varChild
[v] pszKeyboardShortcut\

Návratová hodnota

Poznámky

CMFCPropertyGridCtrl::get_accSelection

virtual HRESULT get_accSelection(VARIANT* pvarChildren);

Parametry

[v] pvarChildren\

Návratová hodnota

Poznámky

CMFCPropertyGridCtrl::GetBkColor

Načte barvu pozadí aktuálního ovládacího prvku mřížky vlastností.

COLORREF GetBkColor() const;

Návratová hodnota

Hodnota barvy RGB.

Poznámky

Tato metoda načte barvu, kterou rozhraní používá k vykreslení pozadí aktuálního ovládacího prvku mřížky vlastností. Metoda CMFCPropertyGridCtrl::GetTextColor načte barvu popředí.

CMFCPropertyGridCtrl::GetBoldFont

Načte písmo Systému Windows, které slouží k kreslení textu v aktuálním ovládacím prvku mřížky vlastností tučným stylem.

CFont& GetBoldFont();

Návratová hodnota

Odkaz na CFont objekt, který popisuje vlastnosti tučného písma.

CMFCPropertyGridCtrl::GetCurSel

Načte aktuálně vybranou vlastnost.

CMFCPropertyGridProperty* GetCurSel() const;

Návratová hodnota

Ukazatel na objekt vlastnosti, který odpovídá vybrané položce v ovládacím prvku mřížky vlastností.

Poznámky

CMFCPropertyGridCtrl::GetCustomColors

Načte vlastní barvy, které jsou aktuálně definovány pro prvky ovládacího prvku mřížky vlastností.

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

Parametry

clrBackground
[ven] Barva pozadí hodnot vlastností.

clrText
[ven] Barva názvů vlastností a textu hodnoty vlastnosti.

clrGroupBackground
[ven] Barva pozadí skupiny vlastností.

clrGroupText
[ven] Barva textu ve skupině vlastností.

clrDescriptionBackground
[ven] Barva pozadí oblasti popisu.

clrDescriptionText
[ven] Barva textu v oblasti popisu

clrLine
[ven] Barva čar, které jsou nakresleny mezi vlastnostmi.

Poznámky

Použijte metodu CMFCPropertyGridCtrl::SetCustomColors k nastavení vlastních barev.

CMFCPropertyGridCtrl::GetDescriptionHeight

Načte výšku oblasti popisu, která se nachází v dolní části ovládacího prvku mřížky vlastností.

int GetDescriptionHeight() const;

Návratová hodnota

Výška oblasti popisu v pixelech.

Poznámky

Výška oblasti popisu se vypočítá automaticky a nastaví se na 1/4 výšku ovládacího prvku mřížky vlastností.

Použijte metodu CMFCPropertyGridCtrl::EnableDescriptionArea k zobrazení nebo skrytí oblasti popisu. CMFCPropertyGridCtrl::IsDescriptionArea Pomocí metody určete, zda je oblast popisu zobrazena nebo skrytá.

CMFCPropertyGridCtrl::GetDescriptionRows

Načte počet řádků v oblasti popisu aktuálního ovládacího prvku mřížky vlastností.

int GetDescriptionRows() const;

Návratová hodnota

Počet řádků v oblasti popisu aktuálního ovládacího prvku mřížky vlastností.

Poznámky

Konstruktor CMFCPropertyGridCtrl::CMFCPropertyGridCtrl inicializuje oblast popisu na 3 řádky.

CMFCPropertyGridCtrl::GetHeaderCtrl

Načte interní CMFCHeaderCtrl objekt, který architektura používá k zobrazení aktuálního ovládacího prvku mřížky vlastností.

virtual CMFCHeaderCtrl& GetHeaderCtrl();

Návratová hodnota

Odkaz na CMFCHeaderCtrl objekt.

CMFCPropertyGridCtrl::GetHeaderHeight

Načte výšku záhlaví ovládacího prvku mřížky vlastností.

int GetHeaderHeight() const;

Návratová hodnota

Výška záhlaví v pixelech.

Poznámky

CMFCPropertyGridCtrl::GetLeftColumnWidth

Načte šířku levého sloupce aktuálního ovládacího prvku mřížky vlastností, který obsahuje název každé vlastnosti.

int GetLeftColumnWidth() const;

Návratová hodnota

Šířka sloupce s názvem.

Poznámky

Pravý sloupec ovládacího prvku mřížky vlastností obsahuje hodnotu každé vlastnosti.

CMFCPropertyGridCtrl::GetListRect

Načte ohraničující obdélník ovládacího prvku mřížky vlastností.

CRect GetListRect() const;

Návratová hodnota

Ohraničující obdélník ovládacího prvku mřížky vlastností. Tato funkce neobsahuje oblast popisu a záhlaví.

Poznámky

CMFCPropertyGridCtrl::GetProperty

Načte ukazatel na objekt vlastnosti, který odpovídá zadanému indexu položky v ovládacím prvku mřížky vlastností.

CMFCPropertyGridProperty* GetProperty(int nIndex) const;

Parametry

nIndex
[v] Nulový index položky ovládacího prvku mřížky vlastností.

Tato metoda se používá, nIndex pokud je parametr menší než nula nebo větší nebo rovna počtu vlastností.

Návratová hodnota

Ukazatel na objekt vlastnosti, který odpovídá zadanému indexu, pokud je tato metoda úspěšná; v opačném případě . NULL

Poznámky

CMFCPropertyGridCtrl::GetPropertyColumnWidth

Načte aktuální šířku sloupce, který obsahuje hodnoty vlastností.

int GetPropertyColumnWidth() const;

Návratová hodnota

Aktuální šířka sloupce, který obsahuje hodnoty vlastností.

Poznámky

Sloupec vpravo v ovládacím prvku mřížky vlastností obsahuje hodnoty vlastností. Zákazník může změnit šířku sloupce hodnot pomocí rozděleného pole ovládacího prvku mřížky vlastností.

CMFCPropertyGridCtrl::GetPropertyCount

Načte počet vlastností v ovládacím prvku mřížky vlastností.

int GetPropertyCount() const;

Návratová hodnota

Počet vlastností.

Poznámky

CMFCPropertyGridCtrl::GetRowHeight

Načte výšku řádku v ovládacím prvku mřížky vlastností.

int GetRowHeight() const;

Návratová hodnota

Výška řádku.

Poznámky

Výška řádku se rovná aktuální výšce písma plus 4 pixely.

CMFCPropertyGridCtrl::GetScrollBarCtrl

Načte ukazatel na ovládací prvek posuvníku v ovládacím prvku mřížky vlastností.

virtual CScrollBar* GetScrollBarCtrl(int nBar) const;

Parametry

nBar
[v] Orientace posuvníku, který musí být SB_VERT.

Návratová hodnota

Ukazatel na objekt posuvníku nebo NULL pokud není k dispozici posuvník nebo orientace posuvníku je SB_HORZ.

Poznámky

Pomocí této metody získáte přímý přístup k ovládacímu prvku svislého posuvníku.

CMFCPropertyGridCtrl::GetTextColor

Načte barvu použitou k vykreslení textu položek vlastností v aktuálním ovládacím prvku mřížky vlastností.

COLORREF GetTextColor() const;

Návratová hodnota

Hodnota barvy RGB.

Poznámky

Tato metoda načte barvu, kterou architektura používá k vykreslení popředí aktuálního ovládacího prvku mřížky vlastností. Metoda CMFCPropertyGridCtrl::GetBkColor načte barvu pozadí.

CMFCPropertyGridCtrl::HitTest

Načte ukazatel na objekt vlastnosti, který odpovídá položce ovládacího prvku mřížky vlastností, pokud je v položce zadaný bod. Tato metoda také označuje oblast v ovládacím prvku mřížky vlastností, který obsahuje bod.

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

Parametry

pt
[v] Bod v souřadnicích klienta.

pnArea
[in, out] Ukazatel na proměnnou ClickArea . Pokud tato metoda vrátí, proměnná označuje oblast vlastnosti, která obsahuje zadaný bod. Další informace o oblasti vlastností naleznete v tématu Poznámky.

bPropsOnly
[v] TRUE testovat pouze oblast vlastností; FALSE pokud zadaný bod není v oblasti vlastnosti, otestujte oblast popisu. Výchozí hodnota je FALSE. Další informace o oblasti popisu naleznete v tématu Poznámky.

Návratová hodnota

bPropsOnly Pokud je TRUE parametr a zadaný bod je v oblasti vlastnosti, návratová hodnota je ukazatel na odpovídající objekt vlastnosti. Parametr je navíc pnArea nastaven na konkrétní oblast, která obsahuje zadaný bod. V opačném případě je NULL vrácená hodnota a pnArea parametr se nezmění.

bPropsOnly Pokud je FALSEparametr , návratová hodnota je vždy NULL. Pokud je však zadaný bod v oblasti popisu, pnArea parametr je nastaven na CMFCPropertyGridProperty::ClickDescription.

Poznámky

Oblast vlastností termínu odkazuje na libovolnou z oblastí názvu, hodnoty nebo rozbalení oblasti ovládacího prvku mřížky vlastností. Oblast popisu je zóna v dolní části ovládacího prvku mřížky vlastností. Když vyberete položku ovládacího prvku mřížky vlastností, oblast popisu zobrazí popis odpovídající vlastnosti.

Tato metoda nastaví hodnotu proměnné, na kterou pnArea parametr odkazuje. Následující tabulka uvádí možné hodnoty a odpovídající oblasti.

Hodnota	Plocha
ClickArea::ClickExpandBox	Vlastnost rozbalit pole ovládacího prvku.
ClickArea::ClickName	Název vlastnosti.
ClickArea::ClickValue	Hodnota vlastnosti
CMFCPropertyGridProperty::ClickDescription	Oblast popisu ovládacího prvku mřížky vlastností

CMFCPropertyGridCtrl::Init

Volá se rozhraním pro inicializaci ovládacího prvku mřížky vlastností.

virtual void Init();

Poznámky

CMFCPropertyGridCtrl::InitHeader

Inicializuje vnitřní CMFCHeaderCtrl objekt, který architektura používá k zobrazení aktuálního ovládacího prvku mřížky vlastností.

virtual void InitHeader();

CMFCPropertyGridCtrl::IsAlphabeticMode

Určuje, zda je ovládací prvek mřížky vlastností v abecedním režimu.

BOOL IsAlphabeticMode() const;

Návratová hodnota

TRUE pokud je ovládací prvek mřížky vlastností v abecedním režimu; jinak FALSE.

Poznámky

Pokud je ovládací prvek mřížky vlastností v abecedním režimu, všechny vlastnosti jsou seřazeny abecedně podle jejich názvů. V opačném případě jsou vlastnosti seskupené pod nadřazenými uzly.

CMFCPropertyGridCtrl::SetAlphabeticMode Pomocí této metody můžete povolit nebo zakázat režim abecedy.

CMFCPropertyGridCtrl::IsAlwaysShowUserToolTip

BOOL IsAlwaysShowUserToolTip() const;

Návratová hodnota

Poznámky

CMFCPropertyGridCtrl::IsDescriptionArea

Určuje, zda je zobrazena oblast popisu ovládacího prvku mřížky vlastností.

BOOL IsDescriptionArea() const;

Návratová hodnota

TRUEje-li zobrazena oblast popisu; v opačném případě . FALSE

Poznámky

CMFCPropertyGridCtrl::EnableDescriptionArea Pomocí metody skryjte nebo zobrazte oblast popisu.

CMFCPropertyGridCtrl::IsGroupNameFullWidth

Určuje, zda je každý název skupiny vlastností zobrazen v šířce aktuálního ovládacího prvku mřížky vlastností.

BOOL IsGroupNameFullWidth() const;

Návratová hodnota

TRUE pokud jsou názvy skupin zobrazeny přes šířku ovládacího prvku mřížky vlastností; FALSE Pokud jsou názvy skupin zkráceny pravým sloupcem (hodnota) ovládacího prvku.

Poznámky

Skupina je kolekce souvisejících vlastností v ovládacím prvku mřížky vlastností. Pokud se ovládací prvek zobrazí hierarchicky, název skupiny se zobrazí jako název kategorie v řádku nad skupinou.

CMFCPropertyGridCtrl::IsHeaderCtrl

Určuje, zda je zobrazen ovládací prvek záhlaví.

BOOL IsHeaderCtrl() const;

Návratová hodnota

TRUE je-li zobrazen ovládací prvek záhlaví; jinak FALSE.

Poznámky

Použijte metodu CMFCPropertyGridCtrl::EnableHeaderCtrl ke skrytí nebo zobrazení ovládacího prvku záhlaví.

CMFCPropertyGridCtrl::IsMarkModifiedProperties

Určuje, jak ovládací prvek mřížky vlastností zobrazuje změněné vlastnosti.

BOOL IsMarkModifiedProperties() const;

Návratová hodnota

TRUE pokud se k zobrazení upravených vlastností používá tučný styl; FALSE pokud se k zobrazení upravených vlastností používá běžný styl.

Poznámky

CMFCPropertyGridCtrl::IsShowDragContext

Určuje, zda architektura překresluje sloupce názvů a hodnot aktuálního ovládacího prvku mřížky vlastností, když uživatel změní velikost sloupců.

BOOL IsShowDragContext() const;

Návratová hodnota

TRUE pokud architektura překresluje sloupce názvu a hodnoty během operace změny velikosti; FALSE Pokud architektura překreslí sloupce po dokončení operace přetažení.

Poznámky

Uživatel může změnit velikost sloupců názvu a hodnoty ovládacího prvku mřížky vlastností přetažením rozdělovače, který je mezi sloupci. Pokud se zobrazí kontext přetažení, změní se velikost sloupců názvu a hodnoty, pokud uživatel přetáhne rozdělovač. Jinak se rozdělovač přesune, ale sloupce se nepřekreslí, dokud se operace přetažení nedokončí.

CMFCPropertyGridCtrl::IsVSDotNetLook

Určuje, zda vzhled ovládacího prvku mřížky vlastností je ve stylu sady Visual Studio .NET.

BOOL IsVSDotNetLook() const;

Návratová hodnota

TRUEpokud je ovládací prvek mřížky vlastností ve stylu sady Visual Studio .NET; v opačném případě . FALSE

Poznámky

Použijte metodu CMFCPropertyGridCtrl::SetVSDotNetLook k nastavení ovládacího prvku mřížky vlastností na styl sady Visual Studio .NET.

CMFCPropertyGridCtrl::MarkModifiedProperties

Určuje, jak zobrazit změněné vlastnosti.

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

Parametry

bMark
[v] TRUE zobrazení upravených vlastností tučným stylem; FALSE zobrazení upravených vlastností v běžném stylu. Výchozí hodnota je TRUE.

bRedraw
[v] TRUE k okamžitému překreslení ovládacího prvku mřížky vlastností; v opačném případě . FALSE Výchozí hodnota je TRUE.

Poznámky

CMFCPropertyGridCtrl::OnChangeSelection

Volá se rozhraním při změně aktuálního výběru.

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

Parametry

pNewSel
[v] Ukazatel na nově vybranou vlastnost

pOldSel
[v] Ukazatel na dříve vybranou vlastnost.

Poznámky

Výchozí implementace této metody nic nedělá.

CMFCPropertyGridCtrl::OnClickButton

Volá se rozhraním při kliknutí na tlačítko vlastnosti.

virtual void OnClickButton(CPoint point);

Parametry

point
[v] Bod v souřadnicích klienta.

Poznámky

Ve výchozím nastavení tato metoda aktualizuje aktuální hodnotu vlastnosti.

CMFCPropertyGridCtrl::OnDrawBorder

Volá se rozhraním k vykreslení ohraničení kolem ovládacího prvku mřížky vlastností.

virtual void OnDrawBorder(CDC* pDC);

Parametry

pDC
[v] Ukazatel na kontext zařízení.

Poznámky

CMFCPropertyGridCtrl::OnDrawDescription

Volá se rozhraním pro vykreslení oblasti popisu a zobrazení textu popisu.

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

Parametry

pDC
[v] Ukazatel na kontext zařízení.

rect
[v] Obdélník, který určuje, kam se má nakreslit oblast popisu.

Poznámky

CMFCPropertyGridCtrl::EnableDescriptionArea K zobrazení oblasti popisu použijte metodu.

CMFCPropertyGridCtrl::OnDrawList

Volá se rozhraním pro zobrazení seznamu vlastností v ovládacím prvku mřížky vlastností.

virtual void OnDrawList(CDC* pDC);

Parametry

pDC
[v] Ukazatel na kontext zařízení.

Poznámky

CMFCPropertyGridCtrl::OnDrawProperty

Volá se rozhraním pro zobrazení vlastnosti.

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

Parametry

pDC
[v] Ukazatel na kontext zařízení.

pProp
[v] Ukazatel na objekt vlastnosti.

Návratová hodnota

TRUEpokud je tato metoda úspěšná; v opačném případě . FALSE

Poznámky

CMFCPropertyGridCtrl::OnPropertyChanged

Volá se rozhraním při změně hodnoty vlastnosti.

virtual void OnPropertyChanged(CMFCPropertyGridProperty* pProp) const;

Parametry

pProp
[v] Ukazatel na objekt vlastnosti, jehož hodnota se změnila.

Poznámky

Ve výchozím nastavení tato metoda odešle AFX_WM_PROPERTY_CHANGED zprávu vlastníkovi ovládacího prvku mřížky vlastností.

CMFCPropertyGridCtrl::OnSelectCombo

Volá se rozhraním, pokud je vybrána vlastnost, která obsahuje ovládací prvek pole se seznamem.

void OnSelectCombo();

Poznámky

CMFCPropertyGridCtrl::RemoveAll

Odebere všechny objekty vlastností z ovládacího prvku mřížky vlastností.

void RemoveAll();

Poznámky

CMFCPropertyGridCtrl::ResetOriginalValues

Obnoví původní hodnoty všech vlastností.

void ResetOriginalValues(BOOL bRedraw=TRUE);

Parametry

bRedraw
[v] TRUE překreslit seznam vlastností; v opačném případě . FALSE Výchozí hodnota je TRUE.

Poznámky

CMFCPropertyGridCtrl::SetAlphabeticMode

Nastaví nebo resetuje abecední režim.

void SetAlphabeticMode(BOOL bSet=TRUE);

Parametry

bSet
[v] TRUE nastavit abecední režim; FALSE resetovat abecední režim. Výchozí hodnota je TRUE.

Poznámky

Pokud je ovládací prvek mřížky vlastností v abecedním režimu, ovládací prvek seřadí všechny vlastnosti, které obsahuje podle názvu vlastnosti.

CMFCPropertyGridCtrl::SetBoolLabels

Určuje text logických popisků.

void SetBoolLabels(
    LPCTSTR lpszTrue,
    LPCTSTR lpszFalse);

Parametry

lpszTrue
[v] Textový řetězec, který se má zobrazit pro logickou hodnotu true.

lpszFalse
[v] Textový řetězec, který se má zobrazit pro logickou hodnotu false.

Poznámky

CMFCPropertyGridCtrl::SetCurSel

Vybere vlastnost v ovládacím prvku mřížky vlastností.

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

Parametry

pProp
[v] Ukazatel na objekt vlastnosti.

bRedraw
[v] TRUE k okamžitému překreslení ovládacího prvku mřížky vlastností; v opačném případě . FALSE Výchozí hodnota je TRUE.

Poznámky

Tuto metodu použijte ke zrušení výběru aktuální položky v ovládacím prvku mřížky vlastností a pak vyberte položku, která odpovídá zadané vlastnosti.

CMFCPropertyGridCtrl::SetCustomColors

Určuje vlastní barvy pro různé prvky ovládacího prvku mřížky vlastností.

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

Parametry

clrBackground
[v] Barva pozadí hodnot vlastností.

clrText
[v] Barva názvů vlastností a textu hodnoty vlastnosti.

clrGroupBackground
[v] Barva pozadí skupiny vlastností.

clrGroupText
[v] Nová barva textu skupiny vlastností.

clrDescriptionBackground
[v] Barva pozadí oblasti popisu.

clrDescriptionText
[v] Barva textu v oblasti popisu

clrLine
[v] Barva čar, které jsou nakresleny mezi vlastnostmi.

Poznámky

Pro libovolný parametr zadejte ((COLORREF)-1) hodnotu barvy, která má použít výchozí barvu pro tento prvek ovládacího prvku mřížky vlastností.

Chcete-li přizpůsobit vzhled konkrétní vlastnosti, odvodit třídu z CMFCPropertyGridProperty třídy a pak přepsat CMFCPropertyGridProperty::OnDrawName, , CMFCPropertyGridProperty::OnDrawValueCMFCPropertyGridProperty::OnDrawExpandBoxa CMFCPropertyGridProperty::OnDrawButton metody.

CMFCPropertyGridCtrl::SetDescriptionRows

Určuje počet řádků, které se mají zobrazit v části popisu aktuálního ovládacího prvku mřížky vlastností.

void SetDescriptionRows(int nDescRows);

Parametry

nDescRows
[v] Počet řádků, které se mají zobrazit v popisu vlastnosti.

CMFCPropertyGridCtrl::SetGroupNameFullWidth

Určuje, zda se má zobrazit úplná šířka názvu kategorie pro skupinu vlastností v aktuálním ovládacím prvku mřížky vlastností.

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

Parametry

bGroupNameFullWidth
[v] TRUE pro zobrazení úplné šířky názvu kategorie bez ohledu na šířku sloupce názvu vlastnosti. FALSE pro omezení šířky názvu kategorie na šířku sloupce názvu vlastnosti. Výchozí hodnota je TRUE.

bRedraw
[v] TRUE k okamžité aktualizaci ovládacího prvku mřížky vlastností; FALSE chcete-li aktualizovat ovládací prvek, když dojde k další události překreslení. Výchozí hodnota je TRUE.

Poznámky

Ovládací prvek mřížky vlastností se skládá ze sloupce názvu vlastnosti s možností změny velikosti a sloupce hodnoty vlastnosti. Konec sloupce s názvem je také začátek sloupce s hodnotou. Pokud chcete změnit velikost sloupců, přetáhněte ohraničení mezi sloupci.

Název skupiny termínů a název kategorie se v této metodě používají zaměnitelně. Název kategorie se zobrazí na řádku, který vede sadu souvisejících vlastností a hodnot. Tato metoda určuje, zda šířka sloupce názvu vlastnosti určuje také šířku zobrazovaného názvu kategorie.

CMFCPropertyGridCtrl::SetListDelimiter

Definuje znak, který se používá jako oddělovač v seznamu hodnot vlastností.

void SetListDelimiter(TCHAR c);

Parametry

c
[v] Znak, který má sloužit jako oddělovač.

Poznámky

Tato metoda slouží k definování znak oddělovače v seznamu hodnot vlastností, které se používají v konstruktoru CMFCPropertyGridProperty::CMFCPropertyGridProperty . V daném konstruktoru bIsValueList nastavte parametr na TRUE.

Ve výchozím nastavení CMFCPropertyGridCtrl::CMFCPropertyGridCtrl konstruktor nastaví znak oddělovače na čárku (',').

CMFCPropertyGridCtrl::SetShowDragContext

Určuje, zda architektura překresluje sloupce názvu a hodnoty aktuálního ovládacího prvku mřížky vlastností, když uživatel změní velikost sloupců.

void SetShowDragContext(BOOL bShowDragContext = TRUE);

Parametry

bShowDragContext
[v] TRUE překreslit sloupce názvu a hodnoty během operace změny velikosti; FALSE chcete-li překreslit sloupce po dokončení operace přetažení. Výchozí hodnota je TRUE.

Poznámky

Uživatel může změnit velikost sloupců názvu a hodnoty ovládacího prvku mřížky vlastností přetažením rozdělovače, který je mezi sloupci. Pokud se zobrazí kontext přetažení, změní se velikost sloupců názvu a hodnoty, pokud uživatel přetáhne rozdělovač. Jinak se rozdělovač přesune, ale sloupce se nepřekreslí, dokud se operace přetažení nedokončí.

CMFCPropertyGridCtrl::SetVSDotNetLook

Nastaví vzhled ovládacího prvku mřížky vlastností na styl, který se používá v sadě Visual Studio .NET.

void SetVSDotNetLook(BOOL bSet=TRUE);

Parametry

bSet
[v] TRUE nastavení ovládacího prvku mřížky vlastností na styl, který se používá v sadě Visual Studio .NET; v opačném případě . FALSE Výchozí hodnota je TRUE.

Poznámky

CMFCPropertyGridCtrl::UpdateColor

Nastaví hodnotu barvy aktuálně vybrané vlastnosti barvy.

virtual void UpdateColor(COLORREF color);

Parametry

color
[v] Hodnota barvy RGB.

Poznámky

Tato metoda se v režimu ladění používá, pokud aktuálně vybraná vlastnost ovládacího prvku mřížky vlastností není barevná vlastnost.

CMFCPropertyGridCtrl::ValidateItemData

Volá se rozhraním k ověření dat vlastností.

virtual BOOL ValidateItemData(CMFCPropertyGridProperty* pProp);

Parametry

pProp
[v] Ukazatel na vlastnost. Tento parametr se nepoužívá.

Návratová hodnota

Vždy hodnota TRUE.

Poznámky

Metoda CMFCPropertyGridCtrl::EndEditItem volá tuto metodu k ověření dat. Ve výchozím nastavení tato metoda nepoužívá jeho pProp parametr a jeho návratová hodnota je vždy TRUE.

Pokud tuto metodu přepíšete, vraťte TRUE se, pokud jsou zadaná data vlastností platná. V opačném případě vraťte FALSEhodnotu , v takovém případě rozhraní neaktualizuje vlastnost.

Viz také

Graf hierarchie
Třídy