Dela via

CMFCPropertyGridProperty klass

Ett CMFCPropertyGridProperty-objekt representerar ett listobjekt i en egenskapslista.

Mer information finns i källkoden som finns i mappen mfc i Visual Studio-installationen. Till exempel %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc.

Syntax

class CMFCPropertyGridProperty : public CObject

Medlemmar

Offentliga konstruktorer

Namn Beskrivning
CMFCPropertyGridProperty::CMFCPropertyGridProperty Konstruerar ett CMFCPropertyGridProperty objekt.
CMFCPropertyGridProperty::~CMFCPropertyGridProperty Destructor.

Offentliga metoder

Namn Beskrivning
CMFCPropertyGridProperty::AddOption Lägger till ett nytt listobjekt i en egenskapslista.
CMFCPropertyGridProperty::AddSubItem Lägger till ett underordnat objekt i en egenskap.
CMFCPropertyGridProperty::AdjustButtonRect Anropas av kontrollen över den överordnade egenskapslistan för att tala om för en egenskap att ändra storlek på avgränsningsrektangeln för en inbäddad knapp.
CMFCPropertyGridProperty::AdjustInPlaceEditRect Hämtar gränserna för textrutan och den valfria rotationsknappen som används för att ange ett egenskapsvärde.
CMFCPropertyGridProperty::AllowEdit Gör en egenskap antingen redigerbar eller skrivskyddad.
CMFCPropertyGridProperty::CreateInPlaceEdit Anropas av ramverket för att skapa en redigerbar kontroll för en egenskap.
CMFCPropertyGridProperty::CreateSpinControl Anropas av ramverket för att skapa en redigerbar rotationsknappskontroll.
CMFCPropertyGridProperty::Enable Aktiverar eller inaktiverar en egenskap.
CMFCPropertyGridProperty::EnableSpinControl Aktiverar eller inaktiverar en rotationsknappskontroll som används för att ändra ett egenskapsvärde.
CMFCPropertyGridProperty::Expand Expanderar eller döljer en egenskap som innehåller underegenskaper.
CMFCPropertyGridProperty::FormatProperty Formaterar textrepresentationen av ett egenskapsvärde.
CMFCPropertyGridProperty::GetData Hämtar ett DWORD-värde som är associerat med en egenskap.
CMFCPropertyGridProperty::GetDescription Hämtar en egenskapsbeskrivning.
CMFCPropertyGridProperty::GetExpandedSubItems Hämtar antalet expanderade underwebbplatser.
CMFCPropertyGridProperty::GetHierarchyLevel Hämtar det nollbaserade indexet för egenskapens hierarkinivå.
CMFCPropertyGridProperty::GetName Hämtar namnet på egenskapen.
CMFCPropertyGridProperty::GetNameTooltip Anropas av ramverket för att visa namnet på egenskapen i en knappbeskrivning.
CMFCPropertyGridProperty::GetOption Hämtar texten i det alternativ som anges av ett index.
CMFCPropertyGridProperty::GetOptionCount Hämtar antalet alternativ som tillhör en egenskap.
CMFCPropertyGridProperty::GetOriginalValue Hämtar det ursprungliga värdet för den aktuella egenskapen.
CMFCPropertyGridProperty::GetParent Hämtar en pekare till en överordnad egenskap.
CMFCPropertyGridProperty::GetRect Hämtar avgränsningsrektangeln för en egenskap.
CMFCPropertyGridProperty::GetSubItem Hämtar en underproperty som identifieras av ett nollbaserat index.
CMFCPropertyGridProperty::GetSubItemsCount Hämtar antalet underwebbplatser.
CMFCPropertyGridProperty::GetThisClass Används av ramverket för att hämta en pekare till det CRuntimeClass objekt som är associerat med den här klasstypen.
CMFCPropertyGridProperty::GetValue Hämtar ett egenskapsvärde.
CMFCPropertyGridProperty::GetValueTooltip Anropas av ramverket för att hämta textrepresentationen av egenskapsvärdet som sedan visas i en knappbeskrivning.
CMFCPropertyGridProperty::HitTest Pekar på egenskapsobjektet som motsvarar det egenskapslistobjekt som motsvarar en punkt.
CMFCPropertyGridProperty::IsAllowEdit Anger om en egenskap kan redigeras.
CMFCPropertyGridProperty::IsEnabled Anger om en egenskap är aktiverad eller inaktiverad.
CMFCPropertyGridProperty::IsExpanded Anger om en egenskap expanderas eller döljs.
CMFCPropertyGridProperty::IsGroup Anger om den aktuella egenskapen representerar en grupp.
CMFCPropertyGridProperty::IsInPlaceEditing Anger om den aktuella egenskapen kan redigeras.
CMFCPropertyGridProperty::IsModified Anger om den aktuella egenskapen ändras.
CMFCPropertyGridProperty::IsParentExpanded Anger om överordnade för den aktuella egenskapen expanderas.
CMFCPropertyGridProperty::IsSelected Anger om den aktuella egenskapen är markerad.
CMFCPropertyGridProperty::IsVisible Anger om den aktuella egenskapen är synlig.
CMFCPropertyGridProperty::OnClickButton Anropas av ramverket när användaren väljer en knapp som finns i en egenskap.
CMFCPropertyGridProperty::OnClickName Anropas av en överordnad egenskapslista när en användare väljer namnfältet för en egenskap.
CMFCPropertyGridProperty::OnClickValue Anropas av en överordnad egenskapslista när en användare väljer värdefältet för en egenskap.
CMFCPropertyGridProperty::OnCloseCombo Anropas av ramverket när en kombinationsruta som finns i en egenskap stängs.
CMFCPropertyGridProperty::OnDblClk Anropas av ramverket när användaren dubbelklickar på en egenskap.
CMFCPropertyGridProperty::OnDrawButton Anropas av ramverket för att rita en knapp som finns i en egenskap.
CMFCPropertyGridProperty::OnDrawDescription Anropas av ramverket för att visa egenskapsbeskrivningen.
CMFCPropertyGridProperty::OnDrawExpandBox Anropas av ramverket för att rita en expanderingsrutekontroll nära en egenskap som innehåller underegenskaper.
CMFCPropertyGridProperty::OnDrawName Anropas av ramverket för att visa egenskapsnamnet.
CMFCPropertyGridProperty::OnDrawValue Anropas av ramverket för att visa egenskapsvärdet.
CMFCPropertyGridProperty::OnEdit Anropas av ramverket när användaren håller på att ändra ett egenskapsvärde.
CMFCPropertyGridProperty::OnEndEdit Anropas av ramverket när användaren har ändrat ett egenskapsvärde.
CMFCPropertyGridProperty::OnKillSelection
CMFCPropertyGridProperty::OnPosSizeChanged
CMFCPropertyGridProperty::OnRClickName Anropas av ramverket när användaren väljer höger musknapp i området egenskapsnamn.
CMFCPropertyGridProperty::OnRClickValue Anropas av ramverket när användaren väljer höger musknapp i egenskapsvärdeområdet.
CMFCPropertyGridProperty::OnSelectCombo Anropas av ramverket när användaren väljer ett objekt från den redigerbara kombinationsrutan.
CMFCPropertyGridProperty::OnSetCursor Anropas av ramverket när muspekaren flyttas till ett egenskapsobjekt.
CMFCPropertyGridProperty::OnSetSelection
CMFCPropertyGridProperty::OnUpdateValue Anropas av ramverket när värdet för en redigerbar egenskap har ändrats.
CMFCPropertyGridProperty::PushChar Anropas från egenskapslistans kontroll när egenskapen har valts och användaren anger ett nytt tecken.
CMFCPropertyGridProperty::Redraw Ritar om egenskapen.
CMFCPropertyGridProperty::RemoveAllOptions Tar bort alla alternativ (objekt) från en egenskap.
CMFCPropertyGridProperty::RemoveSubItem Tar bort den angivna underwebbplatsen.
CMFCPropertyGridProperty::ResetOriginalValue Återställer det ursprungliga värdet för en redigerad egenskap.
CMFCPropertyGridProperty::SetData Associerar ett DWORD-värde med en egenskap.
CMFCPropertyGridProperty::SetDescription Anger den text som beskriver den aktuella egenskapen.
CMFCPropertyGridProperty::SetName Anger namnet på en egenskap.
CMFCPropertyGridProperty::SetOriginalValue Anger det ursprungliga värdet för en redigerbar egenskap.
CMFCPropertyGridProperty::SetValue Anger värdet för en egenskapsrutnätegenskap.
CMFCPropertyGridProperty::Show Visar eller döljer en egenskap.

Skyddade metoder

Namn Beskrivning
CMFCPropertyGridProperty::CreateCombo Anropas av ramverket för att lägga till en kombinationsruta i en egenskap.
CMFCPropertyGridProperty::HasButton Anger om en egenskap innehåller en knapp.
CMFCPropertyGridProperty::Init Anropas av ramverket för att initiera ett egenskapsobjekt.
CMFCPropertyGridProperty::IsSubItem Anger om den angivna egenskapen är en underwebbplats för den aktuella egenskapen.
CMFCPropertyGridProperty::IsValueChanged Anger om värdet för den aktuella egenskapen har ändrats.
CMFCPropertyGridProperty::OnCtlColor Anropas av ramverket när den måste hämta en pensel för att fylla bakgrundsfärgen för en egenskap.
CMFCPropertyGridProperty::OnDestroyWindow Anropas av ramverket när en egenskap förstörs eller när redigeringen är klar.
CMFCPropertyGridProperty::OnKillFocus Anropas av ramverket när egenskapen förlorar indatafokuset.

Datamedlemmar

Namn Beskrivning
CMFCPropertyGridProperty::m_strFormatDouble Formatera sträng för ett värde av typen double.
CMFCPropertyGridProperty::m_strFormatFloat Formatera sträng för ett värde av typen float.
CMFCPropertyGridProperty::m_strFormatLong Formatera sträng för ett värde av typen long.
CMFCPropertyGridProperty::m_strFormatShort Formatera strängen för ett kort värde av typen .

Anmärkningar

Använd ett CMFCPropertyGridProperty objekt för att representera en egenskap som du sedan lägger till i en egenskapslista. Mer information finns i CMFCPropertyGridCtrl Class.

Ett egenskapsobjekt kan representera datatyper som strängar, datum och booleska värden eller heltalsvärden. Den kan innehålla underordnade egenskaper eller innehålla en kontroll, till exempel en kombinationsruta eller en knappkontroll.

Exempel

I följande exempel visas hur du skapar ett CMFCPropertyGridProperty objekt. Exemplet visar också hur du använder olika metoder i klassen CMFCPropertyGridProperty för att lägga till ett alternativ, lägga till en underwebbplats, aktivera en egenskap och visa en egenskap. Det här exemplet är en del av exemplet Nya kontroller.

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

Arvshierarki

CObject

CMFCPropertyGridProperty

Krav

rubrik:afxpropertygridctrl.h

CMFCPropertyGridProperty::AddOption

Lägger till ett nytt listobjekt i en egenskapslista.

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

Parametrar

lpszOption
[i] Listobjektet (alternativet) som ska läggas till.

bInsertUnique
[i] TRUE att bara lägga till listobjektet om det inte redan finns. annars FALSE. Standardvärdet är TRUE.

Returvärde

TRUE, vilket innebär att listobjektet läggs till. Annars FALSE, vilket innebär att listobjektet inte läggs till eftersom parametern bInsertUnique är TRUE och listobjektet som anges av parametern lpszOption redan finns.

CMFCPropertyGridProperty::AddSubItem

Lägger till ett underordnat objekt i en egenskap.

BOOL AddSubItem(CMFCPropertyGridProperty* pProp);

Parametrar

pProp
[i] Pekare till en egenskap som ska läggas till.

Returvärde

TRUE om den angivna egenskapen har lagts till som en underordnad egenskap. FALSE om egenskapen inte läggs till eftersom den redan finns i den överordnade egenskapen.

Anmärkningar

Använd den här metoden för att skapa en hierarkisk lista över överordnade och underordnade egenskaper. När en underordnad egenskap har lagts till visar den överordnade egenskapen automatiskt en expanderingsrutekontroll som anges av ett plustecken (+). När användaren väljer plustecknet expanderar den överordnade egenskapen och visar eventuella underordnade egenskapsobjekt.

CMFCPropertyGridProperty::AdjustButtonRect

Anropas av kontrollen över den överordnade egenskapslistan för att tala om för en egenskap att ändra storlek på avgränsningsrektangeln för en inbäddad knapp.

virtual void AdjustButtonRect();

Anmärkningar

Den här metoden är som standard:

  • Justerar knappens bredd lika med knappens höjd plus tre bildpunkter.
  • Flyttar avgränsningsrektangeln för knappen till högerkanten av egenskapen.
  • Flyttar knappen 1 bildpunkt under egenskapens övre kant.

CMFCPropertyGridProperty::AdjustInPlaceEditRect

Hämtar gränserna för textrutan och den valfria rotationsknappen som används för att ange ett egenskapsvärde.

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

Parametrar

rectEdit
[ut] När den här metoden returnerar en rektangel som anger gränserna för textrutan för egenskapsvärdet.

rectSpin
[ut] När den här metoden returnerar en rektangel som anger gränserna för rotationsknappens kontroll för egenskapsvärdet. Eller, om egenskapen inte stöder en rotationsknapp, en tom rektangel.

Anmärkningar

Värdeområdet för en egenskap består av en textruta och eventuellt en alternativknapp, till exempel en rotationsknappskontroll. Den här metoden beräknar textrutans och alternativknappens dimensioner och returnerar sedan dessa värden i de angivna parametrarna.

CMFCPropertyGridProperty::AllowEdit

Gör en egenskap antingen redigerbar eller skrivskyddad.

void AllowEdit(BOOL bAllow=TRUE);

Parametrar

bAllow
[in] TRUE för att göra egenskapen redigerbar. FALSE att göra egenskapen skrivskyddad. Standardvärdet är TRUE.

CMFCPropertyGridProperty::CMFCPropertyGridProperty

Konstruerar ett CMFCPropertyGridProperty 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);

Parametrar

strGroupName
[i] Gruppnamnet. En grupp är en samling relaterade egenskaper i en egenskapsrutnätskontroll. Om kontrollen visas hierarkiskt visas gruppnamn som en kategorirubrik på raden ovanför gruppen.

dwData
[i] Programspecifika data, till exempel ett heltal eller en pekare till andra data som är associerade med egenskapen. Standardvärdet är 0.

strName
[i] Namnet på egenskapen.

varValue
[i] Egenskapsvärdet.

lpszDescr
[i] Egenskapsbeskrivningen. Standardvärdet är NULL.

lpszEditMask
[i] Redigeringsmasken, om egenskapen är en maskerad redigeringskontroll. Standardvärdet är NULL.

lpszEditTemplate
[i] Redigeringsmallen, om egenskapen är en maskerad redigeringskontroll. Standardvärdet är NULL.

lpszValidChars
[i] En lista med giltiga tecken, om egenskapen är en maskerad redigeringskontroll. Standardvärdet är NULL.

bIsValueList
[i] TRUE om egenskapen representerar en lista med värden; FALSE om egenskapen representerar ett enda värde. Standardvärdet är FALSE.

CMFCPropertyGridProperty::CreateCombo

Anropas av ramverket för att lägga till en kombinationsruta i en egenskap.

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

Parametrar

pWndParent
[i] Pekare mot kombinationsrutans överordnade fönster.

rect
[i] Kombinationsrutans avgränsningsrektangel.

Returvärde

Pekare till ett nytt CComboBox objekt.

CMFCPropertyGridProperty::CreateInPlaceEdit

Anropas av ramverket för att skapa en redigerbar kontroll för en egenskap.

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

Parametrar

rectEdit
[i] Den redigerbara kontrollens avgränsningsrektangel.

bDefaultFormat
[in] TRUE att använda standardegenskapsformatet för att ange texten i den redigerbara kontrollen. annars FALSE.

Returvärde

En pekare till den redigerbara kontrollen om den här metoden lyckas. annars NULL.

Anmärkningar

Den här metoden använder värdena för parametrarna varValue, lpszEditMask, lpszEditTemplateoch lpszValidChars som anges i CMFCPropertyGridProperty-klasskonstruktorn. Som standard stöder den här metoden varValue varianttyper. Detta inkluderar VT_BSTR, VT_R4, VT_R8, VT_UI1, VT_I2, VT_INT, VT_UINT, VT_I4, VT_UI2, VT_UI4och VT_BOOL.

Den här metoden skapar en CMFCMaskedEdit kontroll om en eller flera av parametrarna lpszEditMask, lpszEditTemplateeller lpszValidChars anges. annars skapas en CEdit kontroll.

CMFCPropertyGridProperty::CreateSpinControl

Anropas av ramverket för att skapa en redigerbar rotationsknappskontroll.

virtual CSpinButtonCtrl* CreateSpinControl(CRect rectSpin);

Parametrar

rectSpin
[i] En rektangel som definierar var den redigerbara rotationsknappen ska skapas.

Returvärde

En pekare till ett nytt CMFCSpinButtonCtrl objekt som är gjutet som en pekare till ett CSpinButtonCtrl objekt.

Anmärkningar

Anropa metoden CMFCPropertyGridProperty::EnableSpinControl för att visa en redigerbar rotationsknappkontroll till höger i egenskapen.

CMFCPropertyGridProperty::Enable

Aktiverar eller inaktiverar en egenskap.

void Enable(BOOL bEnable=TRUE);

Parametrar

bEnable
[i] TRUE för att aktivera egenskapen; FALSE för att inaktivera egenskapen. Inaktiverade egenskaper svarar inte på mus- eller tangentbordsindata. Standardvärdet är TRUE.

CMFCPropertyGridProperty::EnableSpinControl

Aktiverar eller inaktiverar en rotationsknappskontroll som används för att ändra ett egenskapsvärde.

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

Parametrar

bEnable
[in] TRUE för att aktivera rotationsknappen. FALSE för att inaktivera rotationsknappen. Standardvärdet är TRUE.

nMin
[i] Minsta värde för rotationsknappens kontroll. Standardvärdet är 0.

nMax
[i] Det maximala värdet för rotationsknappens kontroll. Standardvärdet är 0.

Anmärkningar

Ramverket skapar automatiskt en rotationsknappkontroll när en egenskap håller på att redigeras.

Egenskapstypen, som anges av parametern varValue för CMFCPropertyGridProperty::CMFCPropertyGridProperty konstruktorn, måste vara en varianttyp som stöds. I annat fall hävdar den här metoden i felsökningsläge. De typer som stöds är VT_INT, VT_UINT, VT_I2, VT_I4, VT_UI2och VT_UI4.

CMFCPropertyGridProperty::Expand

Expanderar eller döljer en egenskap som innehåller underegenskaper.

void Expand(BOOL bExpand=TRUE);

Parametrar

bExpand
[i] TRUE för att expandera egenskapen; FALSE för att dölja egenskapen. Standardvärdet är TRUE.

CMFCPropertyGridProperty::FormatProperty

Formaterar textrepresentationen av ett egenskapsvärde.

virtual CString FormatProperty();

Returvärde

Textrepresentationen av egenskapsvärdet.

Anmärkningar

Den här metoden anropas av ramverket innan egenskapsvärdet visas.

CMFCPropertyGridProperty::GetData

Hämtar ett DWORD värde som är associerat med en egenskap.

DWORD_PTR GetData() const;

Returvärde

Ett DWORD värde.

Anmärkningar

De data som returneras är ett programspecifikt värde, till exempel ett tal eller en pekare till andra data. Ange datavärdet när du skapar egenskapen eller när du anropar metoden CMFCPropertyGridProperty::SetData.

CMFCPropertyGridProperty::GetDescription

Hämtar en egenskapsbeskrivning.

const CString& GetDescription() const;

Returvärde

En textsträng som innehåller egenskapsbeskrivningen.

Anmärkningar

Egenskapslistekontrollen använder också den här metoden för att visa beskrivningen av egenskapen.

CMFCPropertyGridProperty::GetExpandedSubItems

Hämtar antalet expanderade underwebbplatser.

int GetExpandedSubItems(BOOL bIncludeHidden=TRUE) const;

Parametrar

bIncludeHidden
[i] TRUE att inkludera dolda underwebbplatser i antalet. annars FALSE. Standardvärdet är TRUE.

Returvärde

Antalet expanderade underwebbplatser.

CMFCPropertyGridProperty::GetHierarchyLevel

Hämtar det nollbaserade indexet för egenskapens hierarkinivå.

int GetHierarchyLevel() const;

Returvärde

Egenskapens hierarkiska nivå.

CMFCPropertyGridProperty::GetName

Hämtar namnet på egenskapen.

LPCTSTR GetName() const;

Returvärde

Pekare till en sträng som innehåller namnet på egenskapen.

CMFCPropertyGridProperty::GetNameTooltip

Anropas av ramverket för att visa namnet på egenskapen i en knappbeskrivning.

virtual CString GetNameTooltip();

Returvärde

En sträng som innehåller egenskapsnamnet. Som standard är returvärdet den tomma strängen.

CMFCPropertyGridProperty::GetOption

Hämtar texten i det alternativ som anges av ett index.

LPCTSTR GetOption(int nIndex) const;

Parametrar

nIndex
Det nollbaserade indexet för egenskapslistobjektet (alternativet) som ska hämtas.

Returvärde

Pekare till en sträng som innehåller alternativtexten.

CMFCPropertyGridProperty::GetOptionCount

Hämtar antalet alternativ som tillhör en egenskap.

int GetOptionCount() const;

Returvärde

Antalet egenskapslistobjekt (alternativ) som finns i egenskapskontrollen.

Anmärkningar

Anropa metoden CMFCPropertyGridProperty::AddOption för att lägga till objekt i egenskapslistan. Anropa metoden CMFCPropertyGridProperty::RemoveAllOptions för att ta bort alla objekt.

CMFCPropertyGridProperty::GetOriginalValue

Hämtar det ursprungliga värdet för den aktuella egenskapen.

const COleVariant& GetOriginalValue() const;

Returvärde

Det ursprungliga värdet för den aktuella egenskapen.

Anmärkningar

Använd den här metoden för att ångra effekten av en redigeringsåtgärd som ändrar värdet för den aktuella egenskapen.

Det ursprungliga värdet för den aktuella egenskapen anges av CMFCPropertyGridProperty::CMFCPropertyGridProperty konstruktorn, ändras av metoden CMFCPropertyGridProperty::SetOriginalValue och återställs av metoden CMFCPropertyGridProperty::ResetOriginalValue.

CMFCPropertyGridProperty::GetParent

Hämtar en pekare till en överordnad egenskap.

CMFCPropertyGridProperty* GetParent() const;

Returvärde

En pekare till ett överordnat egenskapsobjekt eller NULL för egenskapen på den översta nivån.

CMFCPropertyGridProperty::GetRect

Hämtar avgränsningsrektangeln för en egenskap.

CRect GetRect() const;

Returvärde

Ett CRect objekt som beskriver avgränsningsrektangeln.

CMFCPropertyGridProperty::GetSubItem

Hämtar en underproperty som identifieras av ett nollbaserat index.

CMFCPropertyGridProperty* GetSubItem(int nIndex) const;

Parametrar

nIndex
[i] Det nollbaserade indexet för egenskapen som ska hämtas. Den här parametern är ogiltig om den är mindre än noll eller större än eller lika med antalet underegenskaper.

Returvärde

En pekare till ett egenskapsobjekt som är ett underordnat objekt i den här egenskapen.

-eller-

I detaljhandelsläge NULL om parametern nIndex är ogiltig. I felsökningsläge hävdar den här metoden.

CMFCPropertyGridProperty::GetSubItemsCount

Hämtar antalet underwebbplatser.

int GetSubItemsCount() const;

Returvärde

Antalet underordnade objekt.

CMFCPropertyGridProperty::GetValue

Hämtar ett egenskapsvärde.

virtual const _variant_t& GetValue() const;

Returvärde

En variant som innehåller egenskapsvärdet.

CMFCPropertyGridProperty::GetValueTooltip

Anropas av ramverket för att hämta textrepresentationen av egenskapsvärdet som sedan visas i en knappbeskrivning.

virtual CString GetValueTooltip();

Returvärde

Ett CString objekt som innehåller textrepresentationen av egenskapsvärdet. Som standard är det här värdet den tomma strängen.

CMFCPropertyGridProperty::HasButton

Anger om en egenskap innehåller en knapp.

virtual BOOL HasButton() const;

Returvärde

TRUE om en egenskap innehåller en knapp (eller egenskapslista); annars FALSE.

CMFCPropertyGridProperty::HitTest

Pekar på egenskapsobjektet som motsvarar det egenskapslistobjekt som motsvarar en punkt.

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

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

Parametrar

point
[i] Poängen att testa i klientkoordinater. Den här parametern är vanligtvis den aktuella muspekarens plats.

pt
[i] Poängen att testa i klientkoordinater.

pnArea
[ut] När den här metoden returneras anger det område som innehåller den angivna punkten. Mer information finns i Anmärkningar. Standardvärdet är NULL.

bPropsOnly
[i] TRUE för att testa ett område i egenskapskontrollen. FALSE att endast testa beskrivningsområdet. Standardvärdet är FALSE.

Returvärde

En pekare till ett egenskapsobjekt eller NULL.

Anmärkningar

Som standard testar den här metoden egenskapsunderwebbplatser om den angivna punkten inte hittas i något av egenskapsobjekten.

I följande tabell visas de värden som kan returneras till parametern pnArea.

Område Beskrivning
ClickArea::ClickExpandBox Kontrollen expandera ruta, som anges med ett plustecken (+).
ClickArea::ClickName Egenskapsnamnet.
ClickArea::ClickValue Egenskapsvärdet.

CMFCPropertyGridProperty::Init

Anropas av ramverket för att initiera ett egenskapsobjekt.

void Init();

CMFCPropertyGridProperty::IsAllowEdit

Anger om en egenskap kan redigeras.

BOOL IsAllowEdit() const;

Returvärde

TRUE om egenskapen kan redigeras. annars FALSE.

CMFCPropertyGridProperty::IsEnabled

Anger om en egenskap är aktiverad eller inaktiverad.

BOOL IsEnabled() const;

Returvärde

TRUE om egenskapen är aktiverad. FALSE om egenskapen är inaktiverad.

Anmärkningar

Anger om en egenskap är aktiverad eller inaktiverad.

CMFCPropertyGridProperty::IsExpanded

Anger om en egenskap expanderas eller döljs.

BOOL IsExpanded() const;

Returvärde

TRUE om egenskapen expanderas. FALSE om egenskapen är komprimerad.

CMFCPropertyGridProperty::IsGroup

Anger om den aktuella egenskapen representerar en grupp.

BOOL IsGroup() const;

Returvärde

TRUE om det aktuella egenskapsobjektet representerar en grupp. FALSE om egenskapen representerar ett värde.

Anmärkningar

En grupp är en samling relaterade egenskaper i en egenskapsrutnätskontroll. Om kontrollen visas hierarkiskt visas gruppnamn som en kategorirubrik på raden ovanför gruppen.

CMFCPropertyGridProperty::IsInPlaceEditing

Anger om den aktuella egenskapen kan redigeras.

BOOL IsInPlaceEditing() const;

Returvärde

TRUE om den aktuella egenskapen kan redigeras. annars FALSE.

CMFCPropertyGridProperty::IsModified

Anger om den aktuella egenskapen ändras.

BOOL IsModified() const;

Returvärde

TRUE om egenskapen ändras. annars FALSE.

CMFCPropertyGridProperty::IsParentExpanded

Anger om överordnade för den aktuella egenskapen expanderas.

BOOL IsParentExpanded() const;

Returvärde

TRUE om alla föräldrar till den aktuella egenskapen utökas; FALSE om de överordnade egenskaperna är komprimerade.

CMFCPropertyGridProperty::IsSelected

Anger om den aktuella egenskapen är markerad.

virtual BOOL IsSelected() const;

Returvärde

TRUE om den aktuella egenskapen är markerad. annars FALSE.

CMFCPropertyGridProperty::IsSubItem

Anger om den angivna egenskapen är en underwebbplats för den aktuella egenskapen.

BOOL IsSubItem(CMFCPropertyGridProperty* pProp) const;

Parametrar

pProp
[i] En pekare till en egenskap.

Returvärde

TRUE om den angivna egenskapen är en underwebbplats för den aktuella egenskapen. annars FALSE.

CMFCPropertyGridProperty::IsValueChanged

Anger om värdet för den aktuella egenskapen har ändrats.

virtual BOOL IsValueChanged() const;

Returvärde

TRUE om värdet för den aktuella egenskapen har ändrats. annars FALSE.

CMFCPropertyGridProperty::IsVisible

Anger om den aktuella egenskapen är synlig.

BOOL IsVisible() const;

Returvärde

TRUE om den aktuella egenskapen är synlig. annars; FALSE.

CMFCPropertyGridProperty::m_strFormatDouble

Innehåller en formatsträng för ett värde av typen double.

static CString m_strFormatDouble;

CMFCPropertyGridProperty::m_strFormatFloat

Innehåller en formatsträng för ett värde av typen float.

static CString m_strFormatFloat;

CMFCPropertyGridProperty::m_strFormatLong

Innehåller en formatsträng för ett värde av typen long.

static CString m_strFormatLong;

CMFCPropertyGridProperty::m_strFormatShort

Innehåller en formatsträng för ett kort värde av typen .

static CString m_strFormatShort;

CMFCPropertyGridProperty::OnClickButton

Anropas av ramverket när användaren väljer en knapp som finns i en egenskap.

virtual void OnClickButton(CPoint point);

Parametrar

point
[i] En punkt i klientkoordinater.

Anmärkningar

Som standard gör den här metoden ingenting.

CMFCPropertyGridProperty::OnClickName

Anropas av en överordnad egenskapslista när en användare väljer namnfältet för en egenskap.

virtual void OnClickName(CPoint C);

Parametrar

C
[i] En punkt i klientkoordinater.

Anmärkningar

Som standard gör den här metoden ingenting.

CMFCPropertyGridProperty::OnClickValue

Anropas av en överordnad egenskapslista när en användare väljer värdefältet för en egenskap.

virtual BOOL OnClickValue(
    UINT uiMsg,
    CPoint point);

Parametrar

uiMsg
[i] Ett musmeddelande.

point
[i] En punkt i klientkoordinater.

Returvärde

TRUE om det angivna musmeddelandet bearbetas med den här metoden. annars FALSE.

Anmärkningar

Som standard returnerar den här metoden FALSE om den aktuella egenskapen inte kan redigeras. Annars bearbetar redigerings- eller spinnkontrollen som är associerad med den här egenskapen det angivna musmeddelandet, och sedan returnerar den här metoden TRUE.

CMFCPropertyGridProperty::OnCloseCombo

Anropas av ramverket när en kombinationsruta som finns i en egenskap stängs.

virtual void OnCloseCombo();

CMFCPropertyGridProperty::OnCtlColor

Anropas av ramverket när den måste hämta en pensel för att fylla bakgrundsfärgen för en egenskap.

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

Parametrar

pDC
[i] Pekare mot en enhetskontext.

nCtlColor
[i] (Den här parametern används inte.)

Returvärde

Handtaget till en pensel om den här metoden lyckas. annars NULL.

CMFCPropertyGridProperty::OnDblClk

Anropas av ramverket när användaren dubbelklickar på en egenskap.

virtual BOOL OnDblClk(CPoint point);

Parametrar

point
[i] En punkt i klientkoordinater.

Returvärde

TRUE om den här metoden lyckas. annars FALSE.

Anmärkningar

Som standard väljer den här metoden nästa egenskapsobjekt i egenskapslistekontrollen.

CMFCPropertyGridProperty::OnDestroyWindow

Anropas av ramverket när en egenskap förstörs eller när redigeringen är klar.

virtual void OnDestroyWindow();

CMFCPropertyGridProperty::OnDrawButton

Anropas av ramverket för att rita en knapp som finns i en egenskap.

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

Parametrar

pDC
[i] En pekare till en enhetskontext.

rectButton
[i] En rektangel för avgränsning som anger var en knapp ska ritas.

CMFCPropertyGridProperty::OnDrawDescription

Anropas av ramverket för att rita egenskapsbeskrivningen.

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

Parametrar

pDC
[i] En pekare till en enhetskontext.

rect
[i] En rektangel för avgränsning som anger var egenskapsbeskrivningen ska ritas.

Anmärkningar

Som standard ritar den här metoden egenskapsnamnet och beskrivningen i det teckensnitt som används av kontrollen över den överordnade egenskapslistan. Egenskapsbeskrivningen ritas i vanligt format och egenskapsnamnet ritas i fetstil.

CMFCPropertyGridProperty::OnDrawExpandBox

Anropas av ramverket för att rita en expanderingsrutekontroll nära en egenskap som innehåller underegenskaper.

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

Parametrar

pDC
[i] En pekare till en enhetskontext.

rectExpand
[i] En rektangel för avgränsning som anger var du vill rita kontrollen för expanderande rutor.

Anmärkningar

Välj kontrollen expandera kryssruta för att expandera eller dölja en lista med underegenskaper. Kontrollen för att expandera rutan anges av en fyrkant som innehåller ett plustecken (+) eller minus (-). Ett plustecken anger att egenskapen kan expanderas för att visa en lista över underegenskaper. Ett minustecken anger att listan kan komprimeras för att endast visa egenskapen.

CMFCPropertyGridProperty::OnDrawName

Anropas av ramverket för att visa egenskapsnamnet.

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

Parametrar

pDC
[i] En pekare till en enhetskontext.

rect
[i] En avgränsningsrektangel som anger var egenskapsnamnet ska ritas.

CMFCPropertyGridProperty::OnDrawValue

Anropas av ramverket för att visa egenskapsvärdet.

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

Parametrar

pDC
[i] En pekare till en enhetskontext.

rect
[i] En rektangel för avgränsning som anger var egenskapsvärdet ska ritas.

CMFCPropertyGridProperty::OnEdit

Anropas av ramverket när användaren håller på att ändra ett egenskapsvärde.

virtual BOOL OnEdit(LPPOINT lptClick);

Parametrar

lptClick
[i] (Den här parametern används inte.) En pekare till en punkt i klientkoordinater.

Returvärde

TRUE om redigeringsåtgärden startar. annars FALSE.

Anmärkningar

Den här funktionen anropas av ramverket när användaren håller på att ändra ett egenskapsvärde. Som standard startar den här metoden rätt redigerare för en kombinationsrutekontroll eller en rotationskontroll.

CMFCPropertyGridProperty::OnEndEdit

Anropas av ramverket när användaren har ändrat ett egenskapsvärde.

virtual BOOL OnEndEdit();

Returvärde

Den här metoden returnerar alltid TRUE.

Anmärkningar

Som standard förstör den här metoden den aktuella redigeringskontrollen och returnerar sedan TRUE.

CMFCPropertyGridProperty::OnKillFocus

Anropas av ramverket när egenskapen förlorar indatafokuset.

virtual BOOL OnKillFocus(CWnd*);

Parametrar

CWnd
[i] (Används inte.) Pekare mot ett fönster.

Returvärde

Den här metoden returnerar alltid TRUE.

Anmärkningar

Som standard gör den här metoden ingenting och returnerar sedan TRUE. Om du åsidosätter den här metoden returnerar du TRUE om ramverket kan avsluta redigeringsåtgärden när egenskapen förlorar indatafokuset.

CMFCPropertyGridProperty::OnKillSelection

virtual void OnKillSelection(CMFCPropertyGridProperty*);

Parametrar

[i] CMFCPropertyGridProperty*

Anmärkningar

Som standard gör den här metoden ingenting.

CMFCPropertyGridProperty::OnPosSizeChanged

virtual void OnPosSizeChanged(CRect);

Parametrar

[i] CRect

Anmärkningar

Som standard gör den här metoden ingenting.

CMFCPropertyGridProperty::OnRClickName

Anropas av ramverket när användaren väljer höger musknapp i området egenskapsnamn.

virtual void OnRClickName(CPoint C);

Parametrar

C
[i] En punkt i klientkoordinater.

Anmärkningar

Som standard gör den här metoden ingenting.

CMFCPropertyGridProperty::OnRClickValue

Anropas av ramverket när användaren väljer höger musknapp i egenskapsvärdeområdet.

virtual void OnRClickValue(
    CPoint C,
    BOOL B);

Parametrar

C
[i] En punkt i klientkoordinater.

B
[i] En boolesk.

Anmärkningar

Som standard gör den här metoden ingenting och parametern B har inget fördefinierat syfte.

CMFCPropertyGridProperty::OnSelectCombo

Anropas av ramverket när användaren väljer ett objekt från den redigerbara kombinationsrutan.

virtual void OnSelectCombo();

Anmärkningar

Som standard använder den här metoden texten i det markerade objektet för att uppdatera egenskapsvärdet.

CMFCPropertyGridProperty::OnSetCursor

Anropas av ramverket när muspekaren flyttas till ett egenskapsobjekt.

virtual BOOL OnSetCursor() const;

Returvärde

TRUE om den aktuella egenskapen är en varianttyp eller en lista med värden, och den här metoden läser in markören för insättningspunkten (I-beam). annars FALSE.

Anmärkningar

Den här metoden stöder följande varianttyper: VT_INT, VT_I2, VT_I4, VT_UINT, VT_UI1, VT_UI2, VT_UI4, VT_R4, VT_R8och VT_BSTR.

CMFCPropertyGridProperty::OnSetSelection

virtual void OnSetSelection(CMFCPropertyGridProperty*);

Parametrar

[i] CMFCPropertyGridProperty*

Anmärkningar

Som standard gör den här metoden ingenting.

CMFCPropertyGridProperty::OnUpdateValue

Anropas av ramverket när värdet för en redigerbar egenskap har ändrats.

virtual BOOL OnUpdateValue();

Returvärde

TRUE om den här metoden lyckas. annars FALSE.

CMFCPropertyGridProperty::PushChar

Anropas från egenskapslistans kontroll när egenskapen har valts och användaren anger ett nytt tecken.

virtual BOOL PushChar(UINT nChar);

Parametrar

nChar
[i] Ett tecken.

Returvärde

TRUE om redigeringsåtgärden fortsätter. annars FALSE.

Anmärkningar

Den här metoden stöder en egenskap som antingen är en lista med värden eller någon av följande varianttyper: VT_INT, VT_I2, VT_I4, VT_UINT, VT_UI1, VT_UI2, VT_UI4, VT_R4, VT_R8och VT_BSTR.

CMFCPropertyGridProperty::Redraw

Ritar om egenskapen.

void Redraw();

CMFCPropertyGridProperty::RemoveAllOptions

Tar bort alla alternativ (objekt) från en egenskap.

void RemoveAllOptions();

Anmärkningar

Alternativ kallas även listobjekt för en egenskapslista.

CMFCPropertyGridProperty::RemoveSubItem

Tar bort den angivna underwebbplatsen.

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

Parametrar

pProp
[i] Pekare till en egenskapsunderwebbplats.

bDelete
[in] TRUE för att ta bort egenskapsobjektet som anges av parametern pProp. annars FALSE. Standardvärdet är TRUE.

Returvärde

Anmärkningar

Ange FALSE för parametern bDelete om du tänker flytta den angivna underwebbplatsen. d.v.s. ta bort underwebbplatsen och lägg sedan till den någon annanstans.

CMFCPropertyGridProperty::ResetOriginalValue

Återställer det ursprungliga värdet för en redigerad egenskap.

virtual void ResetOriginalValue();

CMFCPropertyGridProperty::SetData

Associerar ett DWORD värde med en egenskap.

void SetData(DWORD_PTR dwData);

Parametrar

dwData
[i] Ett programspecifikt 32-bitarsvärde, till exempel ett heltal eller en pekare till andra data.

Anmärkningar

Använd metoden CMFCPropertyGridProperty::GetData för att hämta värdet för DWORD. Använd metoden CMFCPropertyGridCtrl::FindItemByData för att hitta egenskapslistobjektet som är associerat med det angivna DWORD värdet.

CMFCPropertyGridProperty::SetDescription

Anger den text som beskriver den aktuella egenskapen.

void SetDescription(const CString& strDescr);

Parametrar

strDescr
[i] Text som beskriver den aktuella egenskapen.

CMFCPropertyGridProperty::SetName

Anger namnet på en egenskap.

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

Parametrar

lpszName
[i] Egenskapsnamnet.

bRedraw
[i] TRUE att rita om egenskapen omedelbart; annars FALSE. Standardvärdet är TRUE.

CMFCPropertyGridProperty::SetOriginalValue

Anger det ursprungliga värdet för en redigerbar egenskap.

virtual void SetOriginalValue(const COleVariant& varValue);

Parametrar

varValue
[i] Ett värde.

Anmärkningar

Använd metoden CMFCPropertyGridProperty::ResetOriginalValue för att återställa det ursprungliga värdet för en redigerad egenskap.

CMFCPropertyGridProperty::SetValue

Anger värdet för en egenskapsrutnätegenskap.

virtual void SetValue(const _variant_t& varValue);

Parametrar

varValue
[i] En referens till värdet som egenskapen ska anges till.

Exempel: 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

Visar eller döljer en egenskap.

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

Parametrar

bShow
[i] TRUE för att visa den aktuella egenskapen och dess underwebbplatser. FALSE för att dölja den aktuella egenskapen och dess underwebbplatser. Standardvärdet är TRUE.

bAdjustLayout
[i] TRUE för att beräkna om hur du ritar en egenskaps etikett och värde och sedan ritar egenskapen. FALSE att använda befintliga beräkningar för att rita egenskapen. Standardvärdet är TRUE.

Se även

hierarkidiagram
klasser
CMFCPropertyGridCtrl klass

  • Last updated on