Sdílet prostřednictvím

Třída CMFCPropertyGridProperty

  • Článek

Objekt CMFCPropertyGridProperty představuje položku seznamu v ovládacím prvku seznam vlastností.

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.

Syntaxe

class CMFCPropertyGridProperty : public CObject

Členové

Veřejné konstruktory

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

Veřejné metody

Název Popis
CMFCPropertyGridProperty::AddOption Přidá novou položku seznamu do ovládacího prvku seznam vlastností.
CMFCPropertyGridProperty::AddSubItem Přidá podřízenou položku do vlastnosti.
CMFCPropertyGridProperty::AdjustButtonRect Volá se ovládací prvek seznamu nadřazených vlastností, který vlastnosti řekne, aby změnila velikost ohraničující obdélník vloženého tlačítka.
CMFCPropertyGridProperty::AdjustInPlaceEditRect Načte hranice textového pole a volitelného ovládacího prvku číselníku, který slouží k nastavení hodnoty vlastnosti.
CMFCPropertyGridProperty::AllowEdit Vytvoří vlastnost, která se dá upravit, nebo jen pro čtení.
CMFCPropertyGridProperty::CreateInPlaceEdit Volá se rozhraním pro vytvoření upravitelného ovládacího prvku pro vlastnost.
CMFCPropertyGridProperty::CreateSpinControl Volá se rozhraním pro vytvoření upravitelného ovládacího prvku číselníku.
CMFCPropertyGridProperty::Enable Povolí nebo zakáže vlastnost.
CMFCPropertyGridProperty::EnableSpinControl Povolí nebo zakáže ovládací prvek číselníku, který se používá k úpravě hodnoty vlastnosti.
CMFCPropertyGridProperty::Expand Rozbalí nebo sbalí vlastnost, která obsahuje dílčí výhody.
CMFCPropertyGridProperty::FormatProperty Naformátuje textovou reprezentaci hodnoty vlastnosti.
CMFCPropertyGridProperty::GetData Načte hodnotu DWORD přidruženou k vlastnosti.
CMFCPropertyGridProperty::GetDescription Načte popis vlastnosti.
CMFCPropertyGridProperty::GetExpandedSubItems Načte počet rozbalených dílčích položek.
CMFCPropertyGridProperty::GetHierarchyLevel Načte index založený na nule na úrovni hierarchie vlastnosti.
CMFCPropertyGridProperty::GetName Načte název vlastnosti.
CMFCPropertyGridProperty::GetNameTooltip Volal rozhraní pro zobrazení názvu vlastnosti v popisu.
CMFCPropertyGridProperty::GetOption Načte text možnosti určené indexem.
CMFCPropertyGridProperty::GetOptionCount Načte počet možností, které patří do vlastnosti.
CMFCPropertyGridProperty::GetOriginalValue Načte počáteční hodnotu aktuální vlastnosti.
CMFCPropertyGridProperty::GetParent Načte ukazatel na nadřazenou vlastnost.
CMFCPropertyGridProperty::GetRect Načte ohraničující obdélník vlastnosti.
CMFCPropertyGridProperty::GetSubItem Načte podproperty identifikované indexem založeným na nule.
CMFCPropertyGridProperty::GetSubItemsCount Načte počet dílčích položek.
CMFCPropertyGridProperty::GetThisClass Používá se architekturou k získání ukazatele na CRuntimeClass objekt, který je přidružen k tomuto typu třídy.
CMFCPropertyGridProperty::GetValue Načte hodnotu vlastnosti.
CMFCPropertyGridProperty::GetValueTooltip Volané architekturou k načtení textové reprezentace hodnoty vlastnosti, která se pak zobrazí v popisu.
CMFCPropertyGridProperty::HitTest Odkazuje na objekt vlastnosti, který odpovídá položce seznamu vlastností odpovídající bodu.
CMFCPropertyGridProperty::IsAllowEdit Určuje, zda je vlastnost upravitelná.
CMFCPropertyGridProperty::IsEnabled Určuje, jestli je vlastnost povolená nebo zakázaná.
CMFCPropertyGridProperty::IsExpanded Určuje, zda je vlastnost rozbalená nebo sbalená.
CMFCPropertyGridProperty::IsGroup Určuje, zda aktuální vlastnost představuje skupinu.
CMFCPropertyGridProperty::IsInPlaceEditing Určuje, zda je aktuální vlastnost upravitelná.
CMFCPropertyGridProperty::IsModified Určuje, zda je aktuální vlastnost změněna.
CMFCPropertyGridProperty::IsParentExpanded Určuje, zda jsou nadřazené aktuální vlastnosti rozbalené.
CMFCPropertyGridProperty::IsSelected Určuje, zda je vybrána aktuální vlastnost.
CMFCPropertyGridProperty::IsVisible Určuje, zda je aktuální vlastnost viditelná.
CMFCPropertyGridProperty::OnClickButton Volá se rozhraním, když uživatel vybere tlačítko, které je obsaženo ve vlastnosti.
CMFCPropertyGridProperty::OnClickName Volá se ovládacím prvku seznamu nadřazených vlastností, když uživatel vybere pole názvu vlastnosti.
CMFCPropertyGridProperty::OnClickValue Volá se ovládací prvek seznamu nadřazených vlastností, když uživatel vybere pole hodnoty vlastnosti.
CMFCPropertyGridProperty::OnCloseCombo Volá se rozhraním, pokud je uzavřeno pole se seznamem, které je obsaženo ve vlastnosti.
CMFCPropertyGridProperty::OnDblClk Volá se rozhraním, když uživatel dvakrát klikne na vlastnost.
CMFCPropertyGridProperty::OnDrawButton Volá se rozhraním k vykreslení tlačítka, které je obsaženo ve vlastnosti.
CMFCPropertyGridProperty::OnDrawDescription Volá se rozhraním pro zobrazení popisu vlastnosti.
CMFCPropertyGridProperty::OnDrawExpandBox Volá se rozhraním pro vykreslení ovládacího prvku rozbalení pole u vlastnosti, která obsahuje podproperties.
CMFCPropertyGridProperty::OnDrawName Volá se rozhraním pro zobrazení názvu vlastnosti.
CMFCPropertyGridProperty::OnDrawValue Volá se rozhraním pro zobrazení hodnoty vlastnosti.
CMFCPropertyGridProperty::OnEdit Volá se rozhraním, když se uživatel chystá upravit hodnotu vlastnosti.
CMFCPropertyGridProperty::OnEndEdit Volá se rozhraním, když uživatel dokončí úpravu hodnoty vlastnosti.
CMFCPropertyGridProperty::OnKillSelection
CMFCPropertyGridProperty::OnPosSizeChanged
CMFCPropertyGridProperty::OnRClickName Volá se rozhraním, když uživatel vybere pravé tlačítko myši v oblasti názvu vlastnosti.
CMFCPropertyGridProperty::OnRClickValue Volá se rozhraním, když uživatel vybere pravé tlačítko myši v oblasti hodnoty vlastnosti.
CMFCPropertyGridProperty::OnSelectCombo Volá se podle architektury, když uživatel vybere položku z upravitelného pole se seznamem.
CMFCPropertyGridProperty::OnSetCursor Volá se rozhraním, když se ukazatel myši přesune na položku vlastnosti.
CMFCPropertyGridProperty::OnSetSelection
CMFCPropertyGridProperty::OnUpdateValue Volá se architekturou, když se změnila hodnota upravitelné vlastnosti.
CMFCPropertyGridProperty::PushChar Volána z ovládacího prvku seznam vlastností, když je vlastnost vybrána a uživatel zadá nový znak.
CMFCPropertyGridProperty::Redraw Překreslí vlastnost.
CMFCPropertyGridProperty::RemoveAllOptions Odebere všechny možnosti (položky) z vlastnosti.
CMFCPropertyGridProperty::RemoveSubItem Odebere zadanou dílčí položku.
CMFCPropertyGridProperty::ResetOriginalValue Obnoví původní hodnotu upravené vlastnosti.
CMFCPropertyGridProperty::SetData Přidruží hodnotu DWORD k vlastnosti.
CMFCPropertyGridProperty::SetDescription Určuje text, který popisuje aktuální vlastnost.
CMFCPropertyGridProperty::SetName Nastaví název vlastnosti.
CMFCPropertyGridProperty::SetOriginalValue Nastaví původní hodnotu upravitelné vlastnosti.
CMFCPropertyGridProperty::SetValue Nastaví hodnotu vlastnosti mřížky vlastností.
CMFCPropertyGridProperty::Show Zobrazí nebo skryje vlastnost.

Chráněné metody

Název Popis
CMFCPropertyGridProperty::CreateCombo Volá se rozhraním pro přidání pole se seznamem do vlastnosti.
CMFCPropertyGridProperty::HasButton Určuje, zda vlastnost obsahuje tlačítko.
CMFCPropertyGridProperty::Init Volá se rozhraním pro inicializaci objektu vlastnosti.
CMFCPropertyGridProperty::IsSubItem Určuje, zda zadaná vlastnost je podsítě aktuální vlastnosti.
CMFCPropertyGridProperty::IsValueChanged Určuje, zda se hodnota aktuální vlastnosti změnila.
CMFCPropertyGridProperty::OnCtlColor Volá se rozhraním, když musí načíst štětec k vyplnění barvy pozadí vlastnosti.
CMFCPropertyGridProperty::OnDestroyWindow Volá se rozhraním, když je vlastnost zničena nebo při úpravách je dokončena.
CMFCPropertyGridProperty::OnKillFocus Volá se rozhraním, když vlastnost ztratí vstupní fokus.

Datové členy

Název Popis
CMFCPropertyGridProperty::m_strFormatDouble Formátovací řetězec pro hodnotu typu double.
CMFCPropertyGridProperty::m_strFormatFloat Formátovací řetězec pro hodnotu typu float
CMFCPropertyGridProperty::m_strFormatLong Formátovací řetězec pro hodnotu typu long.
CMFCPropertyGridProperty::m_strFormatShort Formátovací řetězec pro hodnotu typu short.

Poznámky

CMFCPropertyGridProperty Objekt slouží k reprezentaci vlastnosti, kterou pak přidáte do ovládacího prvku seznam vlastností. Další informace naleznete v tématu CMFCPropertyGridCtrl Třída.

Objekt vlastnosti může představovat datové typy, jako jsou řetězce, kalendářní data a logické hodnoty nebo celočíselné hodnoty. Může obsahovat podřízené vlastnosti nebo může obsahovat ovládací prvek, například pole se seznamem nebo ovládací prvek tlačítka.

Příklad

Následující příklad ukazuje, jak sestavit CMFCPropertyGridProperty objekt. Příklad také ukazuje, jak pomocí různých metod ve CMFCPropertyGridProperty třídě přidat možnost, přidat dílčí položku, povolit vlastnost a zobrazit vlastnost. Tento příklad je součástí ukázky Nové ovládací prvky.

CMFCPropertyGridProperty *pGroup1 = new CMFCPropertyGridProperty(_T("Appearance"));

// construct a COleVariant object.
COleVariant var3DLook((short)VARIANT_FALSE, VT_BOOL);

pGroup1->AddSubItem(new CMFCPropertyGridProperty(_T("3D Look"), var3DLook,
                                                 _T("Specifies the dialog's font will be nonbold and controls will have a 3D border")));

CMFCPropertyGridProperty *pProp = new CMFCPropertyGridProperty(_T("Border"),
                                                               _T("Dialog Frame"), _T("One of: None, Thin, Resizable, or Dialog Frame"));
pProp->AddOption(_T("None"));
pProp->AddOption(_T("Thin"));
pProp->AddOption(_T("Resizable"));
pProp->AddOption(_T("Dialog Frame"));
pProp->AllowEdit(FALSE);

pGroup1->AddSubItem(pProp);
pGroup1->AddSubItem(new CMFCPropertyGridProperty(_T("Caption"), (COleVariant) _T("About NewControlsDemo"), _T("Specifies the text that will be displayed in the dialog's title bar")));
pGroup1->AdjustButtonRect();
pGroup1->AllowEdit();
pGroup1->Enable();
pGroup1->Show();
pGroup1->Redraw();

Hierarchie dědičnosti

CObject

CMFCPropertyGridProperty

Požadavky

Záhlaví: afxpropertygridctrl.h

CMFCPropertyGridProperty::AddOption

Přidá novou položku seznamu do ovládacího prvku seznam vlastností.

BOOL AddOption(
    LPCTSTR lpszOption,
    BOOL bInsertUnique=TRUE);

Parametry

lpszOption
[v] Položka seznamu (možnost) pro přidání.

bInsertUnique
[v] TRUE pokud chcete přidat položku seznamu pouze v případě, že ještě neexistuje; v opačném případě . FALSE Výchozí hodnota je TRUE.

Návratová hodnota

TRUE, což znamená, že položka seznamu je přidána. Jinak , což znamená, že položka seznamu není přidána, FALSEprotože parametr je TRUE a položka seznamu zadaná parametrem lpszOption již bInsertUnique existuje.

CMFCPropertyGridProperty::AddSubItem

Přidá podřízenou položku do vlastnosti.

BOOL AddSubItem(CMFCPropertyGridProperty* pProp);

Parametry

pProp
[v] Ukazatel na vlastnost, která se má přidat.

Návratová hodnota

TRUE Pokud je zadaná vlastnost úspěšně přidána jako podřízená vlastnost. FALSE pokud vlastnost není přidána, protože již se vyskytuje v nadřazené vlastnosti.

Poznámky

Tato metoda slouží k vytvoření hierarchického seznamu nadřazených a podřízených vlastností. Po přidání podřízené vlastnosti nadřazená vlastnost automaticky zobrazí ovládací prvek rozbalení pole, který je určen znaménkem plus (+). Když uživatel vybere znaménko plus, nadřazená vlastnost se rozbalí a zobrazí všechny podřízené položky vlastnosti.

CMFCPropertyGridProperty::AdjustButtonRect

Volá se ovládací prvek seznamu nadřazených vlastností, který vlastnosti řekne, aby změnila velikost ohraničující obdélník vloženého tlačítka.

virtual void AdjustButtonRect();

Poznámky

Ve výchozím nastavení tato metoda:

  • Upraví šířku tlačítka, která se rovná výšce tlačítka plus tři pixely.
  • Přesune ohraničující obdélník tlačítka na pravý okraj vlastnosti.
  • Posune tlačítko o 1 pixel pod horní okraj vlastnosti.

CMFCPropertyGridProperty::AdjustInPlaceEditRect

Načte hranice textového pole a volitelného ovládacího prvku číselníku, který slouží k nastavení hodnoty vlastnosti.

virtual void AdjustInPlaceEditRect(
    CRect& rectEdit,
    CRect& rectSpin);

Parametry

rectEdit
[ven] Pokud tato metoda vrátí, obdélník, který určuje hranice textového pole pro hodnotu vlastnosti.

rectSpin
[ven] Pokud tato metoda vrátí, obdélník, který určuje hranice ovládacího prvku číselníku pro hodnotu vlastnosti. Nebo pokud vlastnost nepodporuje číselník, prázdný obdélník.

Poznámky

Oblast hodnot vlastnosti se skládá z textového pole a případně přepínače, například ovládacího prvku číselníku. Tato metoda vypočítá rozměry textového pole a přepínače a pak vrátí tyto hodnoty v zadaných parametrech.

CMFCPropertyGridProperty::AllowEdit

Vytvoří vlastnost, která se dá upravit, nebo jen pro čtení.

void AllowEdit(BOOL bAllow=TRUE);

Parametry

bAllow
[v] TRUE k úpravě vlastnosti; FALSE nastavení vlastnosti jen pro čtení. Výchozí hodnota je TRUE.

CMFCPropertyGridProperty::CMFCPropertyGridProperty

CMFCPropertyGridProperty Vytvoří objekt.

CMFCPropertyGridProperty(
    const CString& strGroupName,
    DWORD_PTR dwData=0,
    BOOL bIsValueList=FALSE);

CMFCPropertyGridProperty(
    const CString& strName,
    const _variant_t& varValue,
    LPCTSTR lpszDescr=NULL,
    DWORD_PTR dwData=0,
    LPCTSTR lpszEditMask=NULL,
    LPCTSTR lpszEditTemplate=NULL,
    LPCTSTR lpszValidChars=NULL);

Parametry

strGroupName
[v] Název skupiny. 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.

dwData
[v] Data specifická pro aplikaci, například celé číslo nebo ukazatel na jiná data přidružená k vlastnosti. Výchozí hodnota je 0.

strName
[v] Název vlastnosti.

varValue
[v] Hodnota vlastnosti.

lpszDescr
[v] Popis vlastnosti. Výchozí hodnota je NULL.

lpszEditMask
[v] Maska úprav, pokud je vlastnost maskovaný ovládací prvek pro úpravy. Výchozí hodnota je NULL.

lpszEditTemplate
[v] Šablona úprav, pokud je vlastnost maskovaný ovládací prvek pro úpravy. Výchozí hodnota je NULL.

lpszValidChars
[v] Seznam platných znaků, pokud je vlastnost maskovaný ovládací prvek pro úpravy. Výchozí hodnota je NULL.

bIsValueList
[v] TRUE pokud vlastnost představuje seznam hodnot; FALSE pokud vlastnost představuje jednu hodnotu. Výchozí hodnota je FALSE.

CMFCPropertyGridProperty::CreateCombo

Volá se rozhraním pro přidání pole se seznamem do vlastnosti.

virtual CComboBox* CreateCombo(
    CWnd* pWndParent,
    CRect rect);

Parametry

pWndParent
[v] Ukazatel na nadřazené okno pole se seznamem

rect
[v] Ohraničující obdélník pole se seznamem.

Návratová hodnota

Ukazatel na nový CComboBox objekt.

CMFCPropertyGridProperty::CreateInPlaceEdit

Volá se rozhraním pro vytvoření upravitelného ovládacího prvku pro vlastnost.

virtual CWnd* CreateInPlaceEdit(
    CRect rectEdit,
    BOOL& bDefaultFormat);

Parametry

rectEdit
[v] Ohraničující obdélník upravitelného ovládacího prvku.

bDefaultFormat
[v] TRUE použít výchozí formát vlastnosti k nastavení textu upravitelného ovládacího prvku; v opačném případě . FALSE

Návratová hodnota

Ukazatel na upravitelný ovládací prvek, pokud tato metoda úspěšně; v opačném případě . NULL

Poznámky

Tato metoda používá hodnoty varValue, , lpszEditMasklpszEditTemplatea lpszValidChars parametry, které jsou zadány v konstruktoru CMFCPropertyGridProperty třídy. Ve výchozím nastavení tato metoda podporuje varValue typy variant. To zahrnuje VT_BSTR, , VT_R4, VT_R8, VT_I2VT_I4VT_UI1VT_UINTVT_UI2VT_INT, VT_UI4, a .VT_BOOL

Tato metoda vytvoří CMFCMaskedEdit ovládací prvek, pokud je zadán jeden nebo více z lpszEditMask, lpszEditTemplatenebo lpszValidChars parametry; jinak vytvoří CEdit ovládací prvek.

CMFCPropertyGridProperty::CreateSpinControl

Volá se rozhraním pro vytvoření upravitelného ovládacího prvku číselníku.

virtual CSpinButtonCtrl* CreateSpinControl(CRect rectSpin);

Parametry

rectSpin
[v] Obdélník, který definuje, kde je vytvořen upravitelný ovládací prvek číselníku.

Návratová hodnota

Ukazatel na nový CMFCSpinButtonCtrl objekt, který se přetypuje jako ukazatel na CSpinButtonCtrl objekt.

Poznámky

CMFCPropertyGridProperty::EnableSpinControl Voláním metody zobrazíte upravitelný ovládací prvek číselníku na pravém okraji vlastnosti.

CMFCPropertyGridProperty::Enable

Povolí nebo zakáže vlastnost.

void Enable(BOOL bEnable=TRUE);

Parametry

bEnable
[v] TRUE povolení vlastnosti; FALSE zakázat vlastnost. Zakázané vlastnosti nereagují na vstup myši nebo klávesnice. Výchozí hodnota je TRUE.

CMFCPropertyGridProperty::EnableSpinControl

Povolí nebo zakáže ovládací prvek číselníku, který se používá k úpravě hodnoty vlastnosti.

void EnableSpinControl(
    BOOL bEnable=TRUE,
    int nMin=0,
    int nMax=0);

Parametry

bEnable
[v] TRUE pro povolení ovládání číselníku; FALSE a zakažte ovládací prvek číselníku. Výchozí hodnota je TRUE.

nMin
[v] Minimální hodnota ovládacího prvku číselníku. Výchozí hodnota je 0.

nMax
[v] Maximální hodnota ovládacího prvku číselníku. Výchozí hodnota je 0.

Poznámky

Architektura automaticky vytvoří ovládací prvek číselníku, když se chystáte upravit vlastnost.

Typ vlastnosti, který je určen varValue parametrem konstruktoru CMFCPropertyGridProperty::CMFCPropertyGridProperty , musí být podporovaným typem varianty. V opačném případě se tato metoda uplatňuje v režimu ladění. Mezi podporované typy patří VT_INT, , VT_I2VT_UINT, VT_I4, VT_UI2, a VT_UI4.

CMFCPropertyGridProperty::Expand

Rozbalí nebo sbalí vlastnost, která obsahuje dílčí výhody.

void Expand(BOOL bExpand=TRUE);

Parametry

bExpand
[v] TRUE rozbalení vlastnosti; FALSE vlastnost sbalíte. Výchozí hodnota je TRUE.

CMFCPropertyGridProperty::FormatProperty

Naformátuje textovou reprezentaci hodnoty vlastnosti.

virtual CString FormatProperty();

Návratová hodnota

Textová reprezentace hodnoty vlastnosti.

Poznámky

Tato metoda je volána architekturou před zobrazením hodnoty vlastnosti.

CMFCPropertyGridProperty::GetData

DWORD Načte hodnotu přidruženou k vlastnosti.

DWORD_PTR GetData() const;

Návratová hodnota

Hodnota DWORD .

Poznámky

Vrácená data jsou hodnota specifická pro aplikaci, například číslo nebo ukazatel na jiná data. Zadejte hodnotu dat při vytváření vlastnosti nebo při volání CMFCPropertyGridProperty::SetData metody.

CMFCPropertyGridProperty::GetDescription

Načte popis vlastnosti.

const CString& GetDescription() const;

Návratová hodnota

Textový řetězec, který obsahuje popis vlastnosti.

Poznámky

Ovládací prvek Seznam vlastností také používá tuto metodu k zobrazení popisu vlastnosti.

CMFCPropertyGridProperty::GetExpandedSubItems

Načte počet rozbalených dílčích položek.

int GetExpandedSubItems(BOOL bIncludeHidden=TRUE) const;

Parametry

bIncludeHidden
[v] TRUE zahrnout skryté dílčí položky do počtu; v opačném případě . FALSE Výchozí hodnota je TRUE.

Návratová hodnota

Počet rozbalených podnabídek.

CMFCPropertyGridProperty::GetHierarchyLevel

Načte index založený na nule na úrovni hierarchie vlastnosti.

int GetHierarchyLevel() const;

Návratová hodnota

Hierarchická úroveň vlastnosti.

CMFCPropertyGridProperty::GetName

Načte název vlastnosti.

LPCTSTR GetName() const;

Návratová hodnota

Ukazatel na řetězec, který obsahuje název vlastnosti.

CMFCPropertyGridProperty::GetNameTooltip

Volal rozhraní pro zobrazení názvu vlastnosti v popisu.

virtual CString GetNameTooltip();

Návratová hodnota

Řetězec, který obsahuje název vlastnosti. Ve výchozím nastavení je návratová hodnota prázdný řetězec.

CMFCPropertyGridProperty::GetOption

Načte text možnosti určené indexem.

LPCTSTR GetOption(int nIndex) const;

Parametry

nIndex
Index seznamu vlastností (možnost) na základě nuly, který se má načíst.

Návratová hodnota

Ukazatel na řetězec, který obsahuje text možnosti.

CMFCPropertyGridProperty::GetOptionCount

Načte počet možností, které patří do vlastnosti.

int GetOptionCount() const;

Návratová hodnota

Počet položek seznamu vlastností (možnosti), které jsou obsaženy v ovládacím prvku vlastnosti.

Poznámky

CMFCPropertyGridProperty::AddOption Volání metody pro přidání položek do seznamu vlastností. CMFCPropertyGridProperty::RemoveAllOptions Voláním metody odeberte všechny položky.

CMFCPropertyGridProperty::GetOriginalValue

Načte počáteční hodnotu aktuální vlastnosti.

const COleVariant& GetOriginalValue() const;

Návratová hodnota

Původní hodnota aktuální vlastnosti.

Poznámky

Tato metoda slouží k vrácení efektu operace úpravy, která změní hodnotu aktuální vlastnosti.

Původní hodnota aktuální vlastnosti je nastavena CMFCPropertyGridProperty::CMFCPropertyGridProperty konstruktorem, změněna metodou CMFCPropertyGridProperty::SetOriginalValue a resetovat metodou CMFCPropertyGridProperty::ResetOriginalValue .

CMFCPropertyGridProperty::GetParent

Načte ukazatel na nadřazenou vlastnost.

CMFCPropertyGridProperty* GetParent() const;

Návratová hodnota

Ukazatel na nadřazený objekt vlastnosti nebo NULL vlastnost nejvyšší úrovně.

CMFCPropertyGridProperty::GetRect

Načte ohraničující obdélník vlastnosti.

CRect GetRect() const;

Návratová hodnota

Objekt CRect , který popisuje ohraničující obdélník.

CMFCPropertyGridProperty::GetSubItem

Načte podproperty identifikované indexem založeným na nule.

CMFCPropertyGridProperty* GetSubItem(int nIndex) const;

Parametry

nIndex
[v] Index vlastnosti založený na nule, který se má načíst. Tento parametr je neplatný, pokud je menší než nula nebo větší nebo roven počtu dílčích období.

Návratová hodnota

Ukazatel na objekt vlastnosti, který je podřízenou položkou této vlastnosti.

nebo

Pokud je parametr v maloobchodním nIndex režimu NULL neplatný. V režimu ladění tato metoda asserts.

CMFCPropertyGridProperty::GetSubItemsCount

Načte počet dílčích položek.

int GetSubItemsCount() const;

Návratová hodnota

Počet podřízených položek.

CMFCPropertyGridProperty::GetValue

Načte hodnotu vlastnosti.

virtual const _variant_t& GetValue() const;

Návratová hodnota

Varianta, která obsahuje hodnotu vlastnosti.

CMFCPropertyGridProperty::GetValueTooltip

Volané architekturou k načtení textové reprezentace hodnoty vlastnosti, která se pak zobrazí v popisu.

virtual CString GetValueTooltip();

Návratová hodnota

Objekt CString obsahující textovou reprezentaci hodnoty vlastnosti. Ve výchozím nastavení je tato hodnota prázdný řetězec.

CMFCPropertyGridProperty::HasButton

Určuje, zda vlastnost obsahuje tlačítko.

virtual BOOL HasButton() const;

Návratová hodnota

TRUEpokud vlastnost obsahuje tlačítko (nebo seznam vlastností); v opačném případě . FALSE

CMFCPropertyGridProperty::HitTest

Odkazuje na objekt vlastnosti, který odpovídá položce seznamu vlastností odpovídající bodu.

CMFCPropertyGridProperty* HitTest(
    CPoint point,
    CMFCPropertyGridProperty::ClickArea* pnArea=NULL);

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

Parametry

point
[v] Bod k otestování v souřadnicích klienta. Tento parametr je obvykle aktuální umístění ukazatele myši.

pt
[v] Bod k otestování v souřadnicích klienta.

pnArea
[ven] Když tato metoda vrátí, označuje oblast, která obsahuje zadaný bod. Další informace naleznete v tématu Poznámky. Výchozí hodnota je NULL.

bPropsOnly
[v] TRUE otestování libovolné oblasti v ovládacím prvku vlastnosti; FALSE k otestování pouze oblasti popisu. Výchozí hodnota je FALSE.

Návratová hodnota

Ukazatel na objekt vlastnosti nebo NULL.

Poznámky

Ve výchozím nastavení tato metoda testuje dílčí položky vlastnosti, pokud zadaný bod nebyl nalezen v žádné z položek vlastnosti.

Následující tabulka uvádí hodnoty, které lze vrátit do parametru pnArea .

Oblast Popis
ClickArea::ClickExpandBox Ovládací prvek rozbalení pole, který je určen znaménkem plus (+).
ClickArea::ClickName Název vlastnosti
ClickArea::ClickValue Hodnota vlastnosti.

CMFCPropertyGridProperty::Init

Volá se rozhraním pro inicializaci objektu vlastnosti.

void Init();

CMFCPropertyGridProperty::IsAllowEdit

Určuje, zda je vlastnost upravitelná.

BOOL IsAllowEdit() const;

Návratová hodnota

TRUE pokud je vlastnost upravitelná; jinak FALSE.

CMFCPropertyGridProperty::IsEnabled

Určuje, jestli je vlastnost povolená nebo zakázaná.

BOOL IsEnabled() const;

Návratová hodnota

TRUE pokud je vlastnost povolena; FALSE pokud je vlastnost zakázaná.

Poznámky

Určuje, jestli je vlastnost povolená nebo zakázaná.

CMFCPropertyGridProperty::IsExpanded

Určuje, zda je vlastnost rozbalená nebo sbalená.

BOOL IsExpanded() const;

Návratová hodnota

TRUE je-li vlastnost rozšířena; FALSE pokud je vlastnost sbalená.

CMFCPropertyGridProperty::IsGroup

Určuje, zda aktuální vlastnost představuje skupinu.

BOOL IsGroup() const;

Návratová hodnota

TRUE pokud aktuální objekt vlastnosti představuje skupinu; FALSE pokud vlastnost představuje hodnotu.

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.

CMFCPropertyGridProperty::IsInPlaceEditing

Určuje, zda je aktuální vlastnost upravitelná.

BOOL IsInPlaceEditing() const;

Návratová hodnota

TRUEpokud je aktuální vlastnost upravitelná; v opačném případě . FALSE

CMFCPropertyGridProperty::IsModified

Určuje, zda je aktuální vlastnost změněna.

BOOL IsModified() const;

Návratová hodnota

TRUEpokud je vlastnost změněna; v opačném případě . FALSE

CMFCPropertyGridProperty::IsParentExpanded

Určuje, zda jsou nadřazené aktuální vlastnosti rozbalené.

BOOL IsParentExpanded() const;

Návratová hodnota

TRUE jsou-li všechny nadřazené aktuální vlastnosti rozšířeny; FALSE pokud jsou nadřazené vlastnosti sbalené.

CMFCPropertyGridProperty::IsSelected

Určuje, zda je vybrána aktuální vlastnost.

virtual BOOL IsSelected() const;

Návratová hodnota

TRUEje-li vybrána aktuální vlastnost; v opačném případě . FALSE

CMFCPropertyGridProperty::IsSubItem

Určuje, zda zadaná vlastnost je podsítě aktuální vlastnosti.

BOOL IsSubItem(CMFCPropertyGridProperty* pProp) const;

Parametry

pProp
[v] Ukazatel na vlastnost.

Návratová hodnota

TRUEje-li zadaná vlastnost podpoložkou aktuální vlastnosti; v opačném případě . FALSE

CMFCPropertyGridProperty::IsValueChanged

Určuje, zda se hodnota aktuální vlastnosti změnila.

virtual BOOL IsValueChanged() const;

Návratová hodnota

TRUEpokud se hodnota aktuální vlastnosti změnila; v opačném případě . FALSE

CMFCPropertyGridProperty::IsVisible

Určuje, zda je aktuální vlastnost viditelná.

BOOL IsVisible() const;

Návratová hodnota

TRUE pokud je aktuální vlastnost viditelná; jinak; FALSE.

CMFCPropertyGridProperty::m_strFormatDouble

Obsahuje formátovací řetězec pro hodnotu typu double.

static CString m_strFormatDouble;

CMFCPropertyGridProperty::m_strFormatFloat

Obsahuje formátovací řetězec pro hodnotu typu float.

static CString m_strFormatFloat;

CMFCPropertyGridProperty::m_strFormatLong

Obsahuje formátovací řetězec pro hodnotu typu long.

static CString m_strFormatLong;

CMFCPropertyGridProperty::m_strFormatShort

Obsahuje formátovací řetězec pro hodnotu typu short.

static CString m_strFormatShort;

CMFCPropertyGridProperty::OnClickButton

Volá se rozhraním, když uživatel vybere tlačítko, které je obsaženo ve vlastnosti.

virtual void OnClickButton(CPoint point);

Parametry

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

Poznámky

Ve výchozím nastavení tato metoda nedělá nic.

CMFCPropertyGridProperty::OnClickName

Volá se ovládacím prvku seznamu nadřazených vlastností, když uživatel vybere pole názvu vlastnosti.

virtual void OnClickName(CPoint C);

Parametry

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

Poznámky

Ve výchozím nastavení tato metoda nedělá nic.

CMFCPropertyGridProperty::OnClickValue

Volá se ovládací prvek seznamu nadřazených vlastností, když uživatel vybere pole hodnoty vlastnosti.

virtual BOOL OnClickValue(
    UINT uiMsg,
    CPoint point);

Parametry

uiMsg
[v] Zpráva myši.

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

Návratová hodnota

TRUEpokud je zadaná zpráva myši zpracována touto metodou; v opačném případě . FALSE

Poznámky

Ve výchozím nastavení tato metoda vrátí FALSE , pokud aktuální vlastnost není možné upravovat. V opačném případě edit nebo číselník ovládací prvek, který je přidružen k této vlastnosti zpracovává zadanou zprávu myši, a pak tato metoda vrátí TRUE.

CMFCPropertyGridProperty::OnCloseCombo

Volá se rozhraním, pokud je uzavřeno pole se seznamem, které je obsaženo ve vlastnosti.

virtual void OnCloseCombo();

CMFCPropertyGridProperty::OnCtlColor

Volá se rozhraním, když musí načíst štětec k vyplnění barvy pozadí vlastnosti.

virtual HBRUSH OnCtlColor(
    CDC* pDC,
    UINT nCtlColor);

Parametry

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

nCtlColor
[v] (Tento parametr se nepoužívá.)

Návratová hodnota

Popisovač štětce, pokud je tato metoda úspěšná; v opačném případě . NULL

CMFCPropertyGridProperty::OnDblClk

Volá se rozhraním, když uživatel dvakrát klikne na vlastnost.

virtual BOOL OnDblClk(CPoint point);

Parametry

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

Návratová hodnota

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

Poznámky

Ve výchozím nastavení tato metoda vybere další položku vlastnosti v ovládacím prvku seznam vlastností.

CMFCPropertyGridProperty::OnDestroyWindow

Volá se rozhraním, když je vlastnost zničena nebo při úpravách je dokončena.

virtual void OnDestroyWindow();

CMFCPropertyGridProperty::OnDrawButton

Volá se rozhraním k vykreslení tlačítka, které je obsaženo ve vlastnosti.

virtual void OnDrawButton(
    CDC* pDC,
    CRect rectButton);

Parametry

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

rectButton
[v] Ohraničující obdélník, který určuje, kam se má tlačítko nakreslit.

CMFCPropertyGridProperty::OnDrawDescription

Volá se rozhraním pro vykreslení popisu vlastnosti.

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

Parametry

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

rect
[v] Ohraničující obdélník, který určuje, kam se má nakreslit popis vlastnosti.

Poznámky

Ve výchozím nastavení tato metoda nakreslí název a popis vlastnosti v písmu používaném ovládacím prvku seznam nadřazených vlastností. Popis vlastnosti je vykreslen v běžném stylu a název vlastnosti je vykreslen tučným stylem.

CMFCPropertyGridProperty::OnDrawExpandBox

Volá se rozhraním pro vykreslení ovládacího prvku rozbalení pole u vlastnosti, která obsahuje podproperties.

virtual void OnDrawExpandBox(
    CDC* pDC,
    CRect rectExpand);

Parametry

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

rectExpand
[v] Ohraničující obdélník, který určuje, kam se má nakreslit ovládací prvek rozbalení pole.

Poznámky

Výběrem ovládacího prvku Rozbalit pole rozbalte nebo sbalte seznam dílčích vlastností. Ovládací prvek rozbalení pole je určen čtvercem, který obsahuje znaménko plus (+) nebo minus (-). Znaménko plus označuje, že vlastnost lze rozbalit a zobrazit seznam dílčích vlastností. Znaménko mínus označuje, že seznam lze sbalit, aby se zobrazila pouze vlastnost.

CMFCPropertyGridProperty::OnDrawName

Volá se rozhraním pro zobrazení názvu vlastnosti.

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

Parametry

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

rect
[v] Ohraničující obdélník, který určuje, kam se má nakreslit název vlastnosti.

CMFCPropertyGridProperty::OnDrawValue

Volá se rozhraním pro zobrazení hodnoty vlastnosti.

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

Parametry

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

rect
[v] Ohraničující obdélník, který určuje, kam se má nakreslit hodnota vlastnosti.

CMFCPropertyGridProperty::OnEdit

Volá se rozhraním, když se uživatel chystá upravit hodnotu vlastnosti.

virtual BOOL OnEdit(LPPOINT lptClick);

Parametry

lptClick
[v] (Tento parametr se nepoužívá.) Ukazatel na bod v souřadnicích klienta.

Návratová hodnota

TRUEpokud se operace úprav úspěšně spustí; v opačném případě . FALSE

Poznámky

Tato funkce je volána architekturou, když se uživatel chystá upravit hodnotu vlastnosti. Ve výchozím nastavení tato metoda spustí příslušný editor pro ovládací prvek pole se seznamem nebo číselník.

CMFCPropertyGridProperty::OnEndEdit

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

virtual BOOL OnEndEdit();

Návratová hodnota

Tato metoda vždy vrátí TRUE.

Poznámky

Ve výchozím nastavení tato metoda zničí aktuální editační ovládací prvek a poté vrátí TRUE.

CMFCPropertyGridProperty::OnKillFocus

Volá se rozhraním, když vlastnost ztratí vstupní fokus.

virtual BOOL OnKillFocus(CWnd*);

Parametry

CWnd
[v] (Nepoužívá se.) Ukazatel na okno

Návratová hodnota

Tato metoda vždy vrátí TRUE.

Poznámky

Ve výchozím nastavení tato metoda nic nedělá a poté vrátí TRUE. Pokud tuto metodu přepíšete, vraťte TRUE se, pokud rozhraní může ukončit operaci úprav, když vlastnost ztratí vstupní fokus.

CMFCPropertyGridProperty::OnKillSelection

virtual void OnKillSelection(CMFCPropertyGridProperty*);

Parametry

[v] CMFCPropertyGridProperty*\

Poznámky

Ve výchozím nastavení tato metoda nedělá nic.

CMFCPropertyGridProperty::OnPosSizeChanged

virtual void OnPosSizeChanged(CRect);

Parametry

[v] CRect\

Poznámky

Ve výchozím nastavení tato metoda nedělá nic.

CMFCPropertyGridProperty::OnRClickName

Volá se rozhraním, když uživatel vybere pravé tlačítko myši v oblasti názvu vlastnosti.

virtual void OnRClickName(CPoint C);

Parametry

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

Poznámky

Ve výchozím nastavení tato metoda nedělá nic.

CMFCPropertyGridProperty::OnRClickValue

Volá se rozhraním, když uživatel vybere pravé tlačítko myši v oblasti hodnoty vlastnosti.

virtual void OnRClickValue(
    CPoint C,
    BOOL B);

Parametry

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

B
[v] Logická hodnota.

Poznámky

Ve výchozím nastavení tato metoda nedělá nic a B parametr nemá žádný předdefinovaný účel.

CMFCPropertyGridProperty::OnSelectCombo

Volá se podle architektury, když uživatel vybere položku z upravitelného pole se seznamem.

virtual void OnSelectCombo();

Poznámky

Ve výchozím nastavení tato metoda používá text vybrané položky k aktualizaci hodnoty vlastnosti.

CMFCPropertyGridProperty::OnSetCursor

Volá se rozhraním, když se ukazatel myši přesune na položku vlastnosti.

virtual BOOL OnSetCursor() const;

Návratová hodnota

TRUEpokud je aktuální vlastnost typu variant nebo seznam hodnot a tato metoda úspěšně načte kurzoru (I-beam). v opačném případě . FALSE

Poznámky

Tato metoda podporuje následující typy variant: VT_INT, , VT_I2VT_I4, VT_UINT, VT_UI1, VT_UI2, VT_UI4, , VT_R4, , VT_R8, , a VT_BSTR.

CMFCPropertyGridProperty::OnSetSelection

virtual void OnSetSelection CMFCPropertyGridProperty*);

Parametry

[v] CMFCPropertyGridProperty*\

Poznámky

Ve výchozím nastavení tato metoda nedělá nic.

CMFCPropertyGridProperty::OnUpdateValue

Volá se architekturou, když se změnila hodnota upravitelné vlastnosti.

virtual BOOL OnUpdateValue();

Návratová hodnota

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

CMFCPropertyGridProperty::PushChar

Volána z ovládacího prvku seznam vlastností, když je vlastnost vybrána a uživatel zadá nový znak.

virtual BOOL PushChar(UINT nChar);

Parametry

nChar
[v] Znak.

Návratová hodnota

TRUEpokud operace úprav pokračuje; v opačném případě . FALSE

Poznámky

Tato metoda podporuje vlastnost, která je buď seznamem hodnot, nebo jedním z následujících typů variant: VT_INT, , VT_I2VT_I4, VT_UINT, , VT_UI1, VT_UI2, VT_UI4, VT_R4VT_R8a VT_BSTR.

CMFCPropertyGridProperty::Redraw

Překreslí vlastnost.

void Redraw();

CMFCPropertyGridProperty::RemoveAllOptions

Odebere všechny možnosti (položky) z vlastnosti.

void RemoveAllOptions();

Poznámky

Možnosti se také označují jako položky seznamu ovládacího prvku seznam vlastností.

CMFCPropertyGridProperty::RemoveSubItem

Odebere zadanou dílčí položku.

BOOL RemoveSubItem(
    CMFCPropertyGridProperty*& pProp,
    BOOL bDelete=TRUE);

Parametry

pProp
[v] Ukazatel na dílčí položku vlastnosti.

bDelete
[v] TRUE k odstranění objektu vlastnosti, který je určen parametrempProp; v opačném případě . FALSE Výchozí hodnota je TRUE.

Návratová hodnota

Poznámky

Zadejte FALSE parametr bDelete , pokud chcete přesunout zadanou dílčí položku. To znamená, že subitem odeberte a pak ho přidejte jinam.

CMFCPropertyGridProperty::ResetOriginalValue

Obnoví původní hodnotu upravené vlastnosti.

virtual void ResetOriginalValue();

CMFCPropertyGridProperty::SetData

Přidruží DWORD hodnotu k vlastnosti.

void SetData(DWORD_PTR dwData);

Parametry

dwData
[v] 32bitová hodnota specifická pro aplikaci, například celé číslo nebo ukazatel na jiná data.

Poznámky

CMFCPropertyGridProperty::GetData K načtení hodnoty použijte metoduDWORD. CMFCPropertyGridCtrl::FindItemByData Pomocí metody vyhledejte položku seznamu vlastností, která je přidružena k zadané DWORD hodnotě.

CMFCPropertyGridProperty::SetDescription

Určuje text, který popisuje aktuální vlastnost.

void SetDescription(const CString& strDescr);

Parametry

strDescr
[v] Text, který popisuje aktuální vlastnost.

CMFCPropertyGridProperty::SetName

Nastaví název vlastnosti.

void SetName(
    LPCTSTR lpszName,
    BOOL bRedraw=TRUE);

Parametry

lpszName
[v] Název vlastnosti.

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

CMFCPropertyGridProperty::SetOriginalValue

Nastaví původní hodnotu upravitelné vlastnosti.

virtual void SetOriginalValue(const COleVariant& varValue);

Parametry

varValue
[v] Hodnota.

Poznámky

Použijte metodu CMFCPropertyGridProperty::ResetOriginalValue k resetování původní hodnoty editované vlastnosti.

CMFCPropertyGridProperty::SetValue

Nastaví hodnotu vlastnosti mřížky vlastností.

virtual void SetValue(const _variant_t& varValue);

Parametry

varValue
[v] Odkaz na hodnotu, na kterou chcete nastavit vlastnost.

Příklad: SetValue

void SetPropBarValue(UINT propId, const DWORD& barPropDwordValue)
{
  auto property = propertiesGridCtrlList.FindItemByData(propId);
  if (property != nullptr)
  {
    property->SetValue(static_cast<_variant_t >(barPropDwordValue == 1)); // set value to true or false depending on dword value
  }
}

CMFCPropertyGridProperty::Show

Zobrazí nebo skryje vlastnost.

void Show(
    BOOL bShow=TRUE,
    BOOL bAdjustLayout=TRUE);

Parametry

bShow
[v] TRUE zobrazení aktuální vlastnosti a jejích dílčích položek; FALSE pro skrytí aktuální vlastnosti a jejích dílčích položek. Výchozí hodnota je TRUE.

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

Viz také

Graf hierarchie
Třídy
Třída CMFCPropertyGridCtrl