CMFCPropertyGridCtrl-klass

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.

Stöder en redigerbar egenskapsrutnätskontroll som kan visa egenskaper i alfabetisk eller hierarkisk ordning.

Syntax

class CMFCPropertyGridCtrl : public CWnd

Medlemmar

Offentliga konstruktorer

Offentliga metoder

Skyddade metoder

Anmärkningar

Klassen CMFCPropertyGridCtrl visar en egenskapsrutnätskontroll som innehåller redigerbara egenskaper som härleds från klassen CMFCPropertyGridProperty. Varje egenskap kan representera en typ och den kan innehålla underwebbplatser. Kontrollen för egenskapsrutnät stöder ett storleksbart område längst ned som kan visa beskrivningen av en vald egenskap.

Om du vill använda en egenskapsrutnätskontroll skapar du ett CMFCPropertyGridCtrl objekt och anropar sedan metoden CMFCPropertyGridCtrl::Create. Använd metoden CMFCPropertyGridCtrl::AddProperty för att lägga till egenskaper i listan.

Markeringsegenskaper

I stället för att representera ett värde kan ett egenskapsobjekt starta en dialogruta där användaren kan välja färg, fil eller teckensnitt.

I följande tabell visas fyra urvalsegenskapstyper:

Illustrationer

Följande bilder visar en egenskapsrutnätskontroll som visar egenskaper på två sätt. Den första bilden visar egenskaper hierarkiskt och den andra visar egenskaper alfabetiskt.

Exempel

I följande exempel visas hur du konfigurerar ett kontrollobjekt för egenskapsrutnät med hjälp av olika metoder i klassen CMFCPropertyGridCtrl. Exemplet visar hur du aktiverar rubrikkontrollen, aktiverar beskrivningsområdet och anger utseendet på kontrollen för egenskapsrutnätet. Exemplet visar också hur du anger alfabetiskt läge för kontrollen där kontrollen sorterar alla egenskaper som den innehåller efter deras egenskapsnamn och hur du anger anpassade färger för olika element i egenskapsrutnätkontrollen. Det här exemplet är en del av exemplet Nya kontroller.

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

Arvshierarki

CObject

CCmdTarget

CWnd

CMFCPropertyGridCtrl

Krav

rubrik:afxpropertygridctrl.h

CMFCPropertyGridCtrl::accSelect

virtual HRESULT accSelect(
    long flagsSelect,
    VARIANT varChild);

Parametrar

[i] flagsSelect
[i] varChild

Returvärde

Anmärkningar

CMFCPropertyGridCtrl::AddProperty

Lägger till en ny egenskap i en egenskapsrutnätskontroll.

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

Parametrar

pProp
[i] Pekare till en egenskap.

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

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

Returvärde

Om den här metoden lyckas kommer det nollbaserade indexet för positionen i egenskapsrutnätkontrollen där egenskapen läggs till. annars -1.

Anmärkningar

Den här metoden lägger till en pekare till den angivna egenskapen i slutet av listan med egenskaper i kontrollen för egenskapsrutnät. Förstör inte egenskaperna eller låt dem gå utanför omfånget innan rutnätskontrollen förstörs. När du är klar med kontrollen för egenskapsrutnät anropar du CMFCPropertyGridCtrl::RemoveAll för att ta bort alla tillagda egenskaper. Metoden AddProperty misslyckas om den angivna egenskapen redan har lagts till i listan.

CMFCPropertyGridCtrl::AdjustLayout

Ritar om kontrollen för egenskapsrutnätet och dess egenskaper.

virtual void AdjustLayout();

Anmärkningar

Den här metoden beräknar om hur du ritar hela kontrollen för egenskapsrutnät och dess egenskaper, inklusive bilder, teckensnitt och kontroller.

CMFCPropertyGridCtrl::AlwaysShowUserToolTip

void AlwaysShowUserToolTip(BOOL bShow = TRUE);

Parametrar

[i] bShow

Anmärkningar

CMFCPropertyGridCtrl::CloseColorPopup

Stänger dialogrutan för färgmarkering.

virtual void CloseColorPopup();

Anmärkningar

Mer information om dialogrutan för färgval finns i CMFCPropertyGridColorProperty Class.

CMFCPropertyGridCtrl::CMFCPropertyGridCtrl

Konstruerar ett CMFCPropertyGridCtrl objekt.

CMFCPropertyGridCtrl();

Returvärde

Anmärkningar

CMFCPropertyGridCtrl::CompareProps

Anropas av kontrollen för egenskapsrutnät för att sortera egenskaper.

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

Parametrar

pProp1
En pekare till en egenskap.

pProp2
En pekare till en egenskap.

Returvärde

Anmärkningar

Som standard använder den här metoden metoden CString::Compare för att jämföra CMFCPropertyGridProperty::m_strName medlemmar i de angivna parametrarna.

CMFCPropertyGridCtrl::Create

Skapar en egenskapsrutnätkontroll och kopplar den till kontrollobjektet för egenskapsrutnät.

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

Parametrar

dwStyle
[i] En bitvis kombination "eller" (|) av fönsterformat.

rect
[i] En rektangel för avgränsning som anger fönstrets storlek och position i klientkoordinaterna för pParentWnd.

pParentWnd
[i] Pekare mot det överordnade fönstret. Får inte vara NULL.

nID
[i] ID för det underordnade fönstret.

Returvärde

TRUE om fönstret har skapats. annars FALSE.

Anmärkningar

Om du vill skapa en egenskapsrutnätkontroll anropar du först CMFCPropertyGridCtrl::CMFCPropertyGridCtrl för att konstruera ett egenskapsrutnätobjekt. Anropa sedan CMFCPropertyGridCtrl::Create.

Exempel

I följande exempel visas hur du använder Create-metoden i CMFCPropertyGridCtrl-klassen. Det här exemplet är en del av exemplet Nya kontroller.

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

Tar bort den angivna egenskapen från kontrollen för egenskapsrutnät.

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

Parametrar

pProp
[i] Pekare till en egenskap.

bRedraw
[in] TRUE för att rita om kontrollen för egenskapsrutnätet. annars FALSE. Standardvärdet är TRUE.

bAdjustLayout
[i] TRUE att beräkna om hur du ritar all text, alla bilder och objekt i kontrollen för egenskapsrutnätet och sedan ritar kontrollen. annars FALSE. Standardvärdet är TRUE.

Returvärde

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

Anmärkningar

Använd den här metoden för att ta bort en egenskap och eventuella underobjekt från kontrollen för egenskapsrutnätet.

CMFCPropertyGridCtrl::DrawControlBarColors

BOOL DrawControlBarColors() const;

Returvärde

Anmärkningar

CMFCPropertyGridCtrl::EditItem

Anropas av ramverket när användaren börjar ändra en egenskap.

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

Parametrar

pProp
[i] Pekare till en egenskap.

lptClick
[i] Den punkt i kontrollen för egenskapsrutnätet som användaren klickade på för att påbörja redigeringsåtgärden. Punkten finns i kontrollens klientkoordinater. Standardvärdet är NULL.

Returvärde

TRUE om metoden lyckas. annars FALSE.

Anmärkningar

CMFCPropertyGridCtrl::EnableDescriptionArea

Aktiverar eller inaktiverar beskrivningsområdet som visas under listan över egenskaper i egenskapsrutnätkontrollen.

void EnableDescriptionArea(BOOL bEnable=TRUE);

Parametrar

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

Anmärkningar

Beskrivningsområdet visas längst ned i kontrollen för egenskapsrutnät. Som standard är beskrivningsområdet inaktiverat och inte synligt.

CMFCPropertyGridCtrl::EnableHeaderCtrl

Aktiverar eller inaktiverar rubrikkontrollen överst i kontrollen för egenskapsrutnätet.

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

Parametrar

bEnable
[i] TRUE för att aktivera rubrikkontrollen. FALSE för att inaktivera rubrikkontrollen. Standardvärdet är TRUE.

lpszLeftColumn
[i] Rubriken på den vänstra kolumnen i rubrikkontrollen. Standardvärdet är Property.

lpszRightColumn
[i] Rubriken på den högra kolumnen i rubrikkontrollen. Standardvärdet är Value.

CMFCPropertyGridCtrl::EndEditItem

Anropas av ramverket när användaren har slutfört ändringen av en egenskap.

virtual BOOL EndEditItem(BOOL bUpdateData=TRUE);

Parametrar

bUpdateData
[in] TRUE för att ange att ändrade egenskapsdata måste verifieras när redigeringsåtgärden är klar. annars FALSE. Standardvärdet är TRUE.

Returvärde

TRUE om redigeringsåtgärden avslutas. FALSE om de ändrade egenskapsdata inte är giltiga eller om redigeringsåtgärden ska fortsätta.

Anmärkningar

CMFCPropertyGridCtrl::EnsureVisible

Rullar en egenskapsrutnätskontroll och expanderar egenskapsobjekt tills den angivna egenskapen visas.

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

Parametrar

pProp
[i] Pekare till en egenskap.

bExpandParents
[i] TRUE för att expandera överordnade objekt för att göra den angivna egenskapen synlig. annars FALSE. Standardvärdet är FALSE.

Anmärkningar

CMFCPropertyGridCtrl::ExpandAll

Expanderar eller döljer alla kontrollnoder för egenskapsrutnät.

void ExpandAll(BOOL bExpand=TRUE);

Parametrar

bExpand
[i] TRUE för att expandera alla noder. FALSE minimera alla noder. Standardvärdet är TRUE.

Anmärkningar

CMFCPropertyGridCtrl::FindItemByData

Hämtar egenskapen som är associerad med ett användardefinierat DWORD värde.

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

Parametrar

dwData
[i] Ett DWORD värde.

bSearchSubItems
[i] TRUE för att söka efter egenskapsunderobjekt; annars FALSE. Standardvärdet är TRUE.

Returvärde

En pekare till det associerade egenskapsobjektet om den här metoden lyckas. annars NULL.

Anmärkningar

Använd metoden CMFCPropertyGridCtrl::CMFCPropertyGridCtrl konstruktor eller CMFCPropertyGridProperty::SetData för att associera en DWORD med en egenskap.

CMFCPropertyGridCtrl::get_accChildCount

virtual HRESULT get_accChildCount(long* pcountChildren);

Parametrar

[i] pcountChildren

Returvärde

Anmärkningar

CMFCPropertyGridCtrl::get_accFocus

virtual HRESULT get_accFocus(VARIANT* pvarChild);

Parametrar

[i] pvarChild

Returvärde

Anmärkningar

CMFCPropertyGridCtrl::get_accHelp

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

Parametrar

[i] varChild
[i] pszHelp

Returvärde

Anmärkningar

CMFCPropertyGridCtrl::get_accHelpTopic

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

Parametrar

[i] pszHelpFile
[i] varChild
[i] pidTopic

Returvärde

Anmärkningar

CMFCPropertyGridCtrl::get_accKeyboardShortcut

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

Parametrar

[i] varChild
[i] pszKeyboardShortcut

Returvärde

Anmärkningar

CMFCPropertyGridCtrl::get_accSelection

virtual HRESULT get_accSelection(VARIANT* pvarChildren);

Parametrar

[i] pvarChildren

Returvärde

Anmärkningar

CMFCPropertyGridCtrl::GetBkColor

Hämtar bakgrundsfärgen för den aktuella egenskapsrutnätkontrollen.

COLORREF GetBkColor() const;

Returvärde

Ett RGB-färgvärde.

Anmärkningar

Den här metoden hämtar den färg som ramverket använder för att rita bakgrunden till den aktuella egenskapsrutnätskontrollen. Metoden CMFCPropertyGridCtrl::GetTextColor hämtar förgrundsfärgen.

CMFCPropertyGridCtrl::GetBoldFont

Hämtar det Windows-teckensnitt som används för att rita text i den aktuella egenskapsrutnätkontrollen i fetstil.

CFont& GetBoldFont();

Returvärde

En referens till ett CFont objekt som beskriver egenskaperna för ett fetstilt teckensnitt.

CMFCPropertyGridCtrl::GetCurSel

Hämtar den markerade egenskapen.

CMFCPropertyGridProperty* GetCurSel() const;

Returvärde

En pekare till egenskapsobjektet som motsvarar det markerade objektet i kontrollen för egenskapsrutnät.

Anmärkningar

CMFCPropertyGridCtrl::GetCustomColors

Hämtar de anpassade färger som för närvarande har definierats för kontrollelement för egenskapsrutnät.

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

Parametrar

clrBackground
[ut] Bakgrundsfärgen för egenskapsvärden.

clrText
[ut] Färgen på egenskapsnamn och egenskapsvärdetext.

clrGroupBackground
[ut] Bakgrundsfärgen för en egenskapsgrupp.

clrGroupText
[ut] Textfärgen i egenskapsgruppen.

clrDescriptionBackground
[ut] Bakgrundsfärgen för beskrivningsområdet.

clrDescriptionText
[ut] Textfärgen i beskrivningsområdet.

clrLine
[ut] Färgen på linjer som ritas mellan egenskaper.

Anmärkningar

Använd metoden CMFCPropertyGridCtrl::SetCustomColors för att ange anpassade färger.

CMFCPropertyGridCtrl::GetDescriptionHeight

Hämtar höjden på beskrivningsområdet, som finns längst ned i kontrollen för egenskapsrutnätet.

int GetDescriptionHeight() const;

Returvärde

Höjden på beskrivningsområdet i bildpunkter.

Anmärkningar

Höjden på beskrivningsområdet beräknas automatiskt och anges till 1/4 höjden på kontrollen för egenskapsrutnätet.

Använd metoden CMFCPropertyGridCtrl::EnableDescriptionArea för att visa eller dölja beskrivningsområdet. Använd metoden CMFCPropertyGridCtrl::IsDescriptionArea för att avgöra om beskrivningsområdet visas eller döljs.

CMFCPropertyGridCtrl::GetDescriptionRows

Hämtar antalet rader i beskrivningsområdet för den aktuella egenskapsrutnätkontrollen.

int GetDescriptionRows() const;

Returvärde

Antalet rader i beskrivningsområdet för den aktuella egenskapsrutnätkontrollen.

Anmärkningar

Konstruktorn CMFCPropertyGridCtrl::CMFCPropertyGridCtrl initierar beskrivningsområdet till 3 rader.

CMFCPropertyGridCtrl::GetHeaderCtrl

Hämtar det interna CMFCHeaderCtrl objekt som ramverket använder för att visa den aktuella egenskapsrutnätskontrollen.

virtual CMFCHeaderCtrl& GetHeaderCtrl();

Returvärde

En referens till ett CMFCHeaderCtrl objekt.

CMFCPropertyGridCtrl::GetHeaderHeight

Hämtar höjden på rubriken för en egenskapsrutnätkontroll.

int GetHeaderHeight() const;

Returvärde

Rubrikens höjd, i bildpunkter.

Anmärkningar

CMFCPropertyGridCtrl::GetLeftColumnWidth

Hämtar bredden på den vänstra kolumnen i den aktuella egenskapsrutnätkontrollen, som innehåller namnet på varje egenskap.

int GetLeftColumnWidth() const;

Returvärde

Namnkolumnens bredd.

Anmärkningar

Den högra kolumnen i en egenskapsrutnätkontroll innehåller värdet för varje egenskap.

CMFCPropertyGridCtrl::GetListRect

Hämtar avgränsningsrektangeln för egenskapsrutnätkontrollen.

CRect GetListRect() const;

Returvärde

Rektangeln för egenskapsrutnätets avgränsning. Den här rektangeln innehåller inte beskrivningsområdet och huvudet.

Anmärkningar

CMFCPropertyGridCtrl::GetProperty

Hämtar en pekare till egenskapsobjektet som motsvarar det angivna indexet för ett objekt i en egenskapsrutnätskontroll.

CMFCPropertyGridProperty* GetProperty(int nIndex) const;

Parametrar

nIndex
[i] Det nollbaserade indexet för ett egenskapsrutnätkontrollobjekt.

Den här metoden anger om parametern nIndex är mindre än noll eller större än eller lika med antalet egenskaper.

Returvärde

En pekare till egenskapsobjektet som motsvarar det angivna indexet om den här metoden lyckas. annars NULL.

Anmärkningar

CMFCPropertyGridCtrl::GetPropertyColumnWidth

Hämtar den aktuella bredden för kolumnen som innehåller egenskapsvärden.

int GetPropertyColumnWidth() const;

Returvärde

Den aktuella bredden på kolumnen som innehåller egenskapsvärden.

Anmärkningar

Kolumnen till höger i kontrollen för egenskapsrutnät innehåller egenskapsvärdena. En kund kan använda delningsrutan i kontrollen för egenskapsrutnät för att ändra bredden på kolumnen värden.

CMFCPropertyGridCtrl::GetPropertyCount

Hämtar antalet egenskaper i en egenskapsrutnätkontroll.

int GetPropertyCount() const;

Returvärde

Antalet egenskaper.

Anmärkningar

CMFCPropertyGridCtrl::GetRowHeight

Hämtar höjden på en rad i egenskapsrutnätkontrollen.

int GetRowHeight() const;

Returvärde

Höjden på en rad.

Anmärkningar

Höjden på en rad är lika med den aktuella teckenhöjden plus 4 bildpunkter.

CMFCPropertyGridCtrl::GetScrollBarCtrl

Hämtar en pekare till rullningslistkontrollen i egenskapsrutnätkontrollen.

virtual CScrollBar* GetScrollBarCtrl(int nBar) const;

Parametrar

nBar
[i] Rullningslistens orientering, som måste vara SB_VERT.

Returvärde

En pekare till ett rullningslistobjekt eller NULL om det inte finns någon rullningslist eller om rullningslistens orientering är SB_HORZ.

Anmärkningar

Använd den här metoden för att få direkt åtkomst till den lodräta rullningslistkontrollen.

CMFCPropertyGridCtrl::GetTextColor

Hämtar den färg som används för att rita texten för egenskapsobjekt i den aktuella kontrollen för egenskapsrutnät.

COLORREF GetTextColor() const;

Returvärde

Ett RGB-färgvärde.

Anmärkningar

Den här metoden hämtar den färg som ramverket använder för att rita förgrunden för den aktuella egenskapsrutnätkontrollen. Metoden CMFCPropertyGridCtrl::GetBkColor hämtar bakgrundsfärgen.

CMFCPropertyGridCtrl::HitTest

Hämtar en pekare till egenskapsobjektet som motsvarar ett kontrollobjekt för egenskapsrutnät om en angiven punkt finns i objektet. Den här metoden anger också området i egenskapsrutnätkontrollen som innehåller punkten.

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

Parametrar

pt
[i] En punkt i klientkoordinater.

pnArea
[in, ut] En pekare till en ClickArea variabel. När den här metoden returnerar anger variabeln egenskapsområde som innehåller den angivna punkten. Mer information om ett egenskapsområde finns i Anmärkningar.

bPropsOnly
[in] TRUE att endast testa egenskapsområdet; FALSE för att testa beskrivningsområdet om den angivna punkten inte finns i egenskapsområdet. Standardvärdet är FALSE. Mer information om beskrivningsområdet finns i Anmärkningar.

Returvärde

Om parametern bPropsOnly är TRUE och den angivna punkten finns i ett egenskapsområde, är returvärdet en pekare till motsvarande egenskapsobjekt. Dessutom anges parametern pnArea till det specifika område som innehåller den angivna punkten. Annars är returvärdet NULL och parametern pnArea ändras inte.

Om parametern bPropsOnly är FALSEär returvärdet alltid NULL. Men om den angivna punkten finns i beskrivningsområdet är parametern pnArea inställd på CMFCPropertyGridProperty::ClickDescription.

Anmärkningar

Termen egenskapsområde refererar till något av namn- eller värderutorna i ett kontrollobjekt för egenskapsrutnät. Det beskrivningsområdet är zonen längst ned i en egenskapsrutnätskontroll. När du väljer ett kontrollobjekt för egenskapsrutnät visar beskrivningsområdet en beskrivning av motsvarande egenskap.

Den här metoden anger värdet för variabeln som parametern pnArea pekar på. I följande tabell visas möjliga värden och motsvarande områden.

CMFCPropertyGridCtrl::Init

Anropas av ramverket för att initiera en egenskapsrutnätskontroll.

virtual void Init();

Anmärkningar

CMFCPropertyGridCtrl::InitHeader

Initierar det interna CMFCHeaderCtrl objekt som ramverket använder för att visa den aktuella egenskapsrutnätskontrollen.

virtual void InitHeader();

CMFCPropertyGridCtrl::IsAlphabeticMode

Anger om en egenskapsrutnätkontroll är i alfabetiskt läge.

BOOL IsAlphabeticMode() const;

Returvärde

TRUE om kontrollen för egenskapsrutnätet är i alfabetiskt läge. annars FALSE.

Anmärkningar

När kontrollen för egenskapsrutnät är i alfabetiskt läge sorteras alla egenskaper alfabetiskt efter deras namn. Annars grupperas egenskaper under sina överordnade noder.

Använd metoden CMFCPropertyGridCtrl::SetAlphabeticMode för att aktivera eller inaktivera alfabetiskt läge.

CMFCPropertyGridCtrl::IsAlwaysShowUserToolTip

BOOL IsAlwaysShowUserToolTip() const;

Returvärde

Anmärkningar

CMFCPropertyGridCtrl::IsDescriptionArea

Anger om beskrivningsområdet för kontrollen för egenskapsrutnätet visas.

BOOL IsDescriptionArea() const;

Returvärde

TRUE om beskrivningsområdet visas; annars FALSE.

Anmärkningar

Använd metoden CMFCPropertyGridCtrl::EnableDescriptionArea för att dölja eller visa beskrivningsområdet.

CMFCPropertyGridCtrl::IsGroupNameFullWidth

Anger om varje egenskapsgruppsnamn visas över bredden på den aktuella egenskapsrutnätkontrollen.

BOOL IsGroupNameFullWidth() const;

Returvärde

TRUE om gruppnamn visas över bredden på kontrollen för egenskapsrutnätet. FALSE om gruppnamn trunkeras av kontrollens högra kolumn (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.

CMFCPropertyGridCtrl::IsHeaderCtrl

Anger om rubrikkontrollen visas.

BOOL IsHeaderCtrl() const;

Returvärde

TRUE om rubrikkontrollen visas. annars FALSE.

Anmärkningar

Använd metoden CMFCPropertyGridCtrl::EnableHeaderCtrl för att dölja eller visa rubrikkontrollen.

CMFCPropertyGridCtrl::IsMarkModifiedProperties

Anger hur kontrollen för egenskapsrutnät visar ändrade egenskaper.

BOOL IsMarkModifiedProperties() const;

Returvärde

TRUE om fetstil används för att visa ändrade egenskaper. FALSE om vanligt format används för att visa ändrade egenskaper.

Anmärkningar

CMFCPropertyGridCtrl::IsShowDragContext

Anger om ramverket ritar om namn- och värdekolumnerna i den aktuella egenskapsrutnätskontrollen när en användare ändrar storlek på kolumnerna.

BOOL IsShowDragContext() const;

Returvärde

TRUE om ramverket ritar om namn- och värdekolumnerna under en storleksändringsåtgärd. FALSE om ramverket ritar om kolumnerna när dragåtgärden har slutförts.

Anmärkningar

Användaren kan ändra storlek på namn- och värdekolumnerna i en egenskapsrutnätskontroll genom att dra det delade fältet mellan kolumnerna. Om dragkontexten visas ändras namn- och värdekolumnerna så länge användaren drar i delningsfältet. Annars flyttas delningsfältet, men kolumnerna ritas inte om förrän dragåtgärden har slutförts.

CMFCPropertyGridCtrl::IsVSDotNetLook

Anger om utseendet på kontrollen för egenskapsrutnätet är i formatet Visual Studio .NET.

BOOL IsVSDotNetLook() const;

Returvärde

TRUE om kontrollen för egenskapsrutnätet är i formatet Visual Studio .NET; annars FALSE.

Anmärkningar

Använd metoden CMFCPropertyGridCtrl::SetVSDotNetLook för att ange kontrollen för egenskapsrutnät till formatet Visual Studio .NET.

CMFCPropertyGridCtrl::MarkModifiedProperties

Anger hur du visar ändrade egenskaper.

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

Parametrar

bMark
[i] TRUE för att visa ändrade egenskaper i fetstil. FALSE för att visa ändrade egenskaper i vanligt format. Standardvärdet är TRUE.

bRedraw
[in] TRUE att rita om kontrollen för egenskapsrutnätet omedelbart. annars FALSE. Standardvärdet är TRUE.

Anmärkningar

CMFCPropertyGridCtrl::OnChangeSelection

Anropas av ramverket när den aktuella markeringen ändras.

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

Parametrar

pNewSel
[i] Pekare till den nyligen valda egenskapen.

pOldSel
[i] Pekare till den tidigare valda egenskapen.

Anmärkningar

Standardimplementeringen av den här metoden gör ingenting.

CMFCPropertyGridCtrl::OnClickButton

Anropas av ramverket när en egenskapsknapp klickas.

virtual void OnClickButton(CPoint point);

Parametrar

point
[i] En punkt i klientkoordinater.

Anmärkningar

Som standard uppdaterar den här metoden det aktuella egenskapsvärdet.

CMFCPropertyGridCtrl::OnDrawBorder

Anropas av ramverket för att rita en kantlinje runt en egenskapsrutnätkontroll.

virtual void OnDrawBorder(CDC* pDC);

Parametrar

pDC
[i] En pekare till en enhetskontext.

Anmärkningar

CMFCPropertyGridCtrl::OnDrawDescription

Anropas av ramverket för att rita beskrivningsområdet och visa beskrivningstexten.

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

Parametrar

pDC
[i] En pekare till en enhetskontext.

rect
[i] En rektangel som anger var beskrivningsområdet ska ritas.

Anmärkningar

Använd metoden CMFCPropertyGridCtrl::EnableDescriptionArea för att visa beskrivningsområdet.

CMFCPropertyGridCtrl::OnDrawList

Anropas av ramverket för att visa listan över egenskaper i egenskapsrutnätkontrollen.

virtual void OnDrawList(CDC* pDC);

Parametrar

pDC
[i] En pekare till en enhetskontext.

Anmärkningar

CMFCPropertyGridCtrl::OnDrawProperty

Anropas av ramverket för att visa en egenskap.

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

Parametrar

pDC
[i] En pekare till en enhetskontext.

pProp
[i] En pekare till ett egenskapsobjekt.

Returvärde

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

Anmärkningar

CMFCPropertyGridCtrl::OnPropertyChanged

Anropas av ramverket när värdet för en egenskap ändras.

virtual void OnPropertyChanged(CMFCPropertyGridProperty* pProp) const;

Parametrar

pProp
[i] En pekare till ett egenskapsobjekt vars värde har ändrats.

Anmärkningar

Som standard skickar den här metoden meddelandet AFX_WM_PROPERTY_CHANGED till ägaren av kontrollen för egenskapsrutnätet.

CMFCPropertyGridCtrl::OnSelectCombo

Anropas av ramverket när en egenskap som innehåller en kombinationsrutekontroll väljs.

void OnSelectCombo();

Anmärkningar

CMFCPropertyGridCtrl::RemoveAll

Tar bort alla egenskapsobjekt från en egenskapsrutnätskontroll.

void RemoveAll();

Anmärkningar

CMFCPropertyGridCtrl::ResetOriginalValues

Återställer de ursprungliga värdena för alla egenskaper.

void ResetOriginalValues(BOOL bRedraw=TRUE);

Parametrar

bRedraw
[i] TRUE för att rita om egenskapslistan. annars FALSE. Standardvärdet är TRUE.

Anmärkningar

CMFCPropertyGridCtrl::SetAlphabeticMode

Anger eller återställer alfabetiskt läge.

void SetAlphabeticMode(BOOL bSet=TRUE);

Parametrar

bSet
[in] TRUE för att ange alfabetiskt läge; FALSE återställ alfabetiskt läge. Standardvärdet är TRUE.

Anmärkningar

När kontrollen för egenskapsrutnätet är i alfabetiskt läge sorterar kontrollen alla egenskaper som den innehåller efter deras egenskapsnamn.

CMFCPropertyGridCtrl::SetBoolLabels

Anger texten i booleska etiketter.

void SetBoolLabels(
    LPCTSTR lpszTrue,
    LPCTSTR lpszFalse);

Parametrar

lpszTrue
[i] Textsträngen som ska visas för det booleska värdet true.

lpszFalse
[i] Textsträngen som ska visas för det booleska värdet false.

Anmärkningar

CMFCPropertyGridCtrl::SetCurSel

Väljer en egenskap i en egenskapsrutnätskontroll.

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

Parametrar

pProp
[i] En pekare till ett egenskapsobjekt.

bRedraw
[in] TRUE att rita om kontrollen för egenskapsrutnätet omedelbart. annars FALSE. Standardvärdet är TRUE.

Anmärkningar

Använd den här metoden för att avbryta markeringen av det aktuella objektet i kontrollen för egenskapsrutnät och välj sedan det objekt som motsvarar den angivna egenskapen.

CMFCPropertyGridCtrl::SetCustomColors

Anger anpassade färger för olika element i egenskapsrutnätkontrollen.

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

Parametrar

clrBackground
[i] Bakgrundsfärgen för egenskapsvärden.

clrText
[i] Färgen på egenskapsnamn och egenskapsvärdetext.

clrGroupBackground
[i] Bakgrundsfärgen för en egenskapsgrupp.

clrGroupText
[i] Den nya textfärgen för egenskapsgruppen.

clrDescriptionBackground
[i] Bakgrundsfärgen för beskrivningsområdet.

clrDescriptionText
[i] Textfärgen i beskrivningsområdet.

clrLine
[i] Färgen på linjer som ritas mellan egenskaper.

Anmärkningar

För valfri parameter anger du ((COLORREF)-1) färgvärde för att använda standardfärgen för elementet i kontrollen för egenskapsrutnätet.

Om du vill anpassa utseendet på en specifik egenskap härleder du en klass från klassen CMFCPropertyGridProperty och åsidosätter sedan metoderna CMFCPropertyGridProperty::OnDrawName, CMFCPropertyGridProperty::OnDrawValue, CMFCPropertyGridProperty::OnDrawExpandBoxoch CMFCPropertyGridProperty::OnDrawButton.

CMFCPropertyGridCtrl::SetDescriptionRows

Anger antalet rader som ska visas i beskrivningsavsnittet i den aktuella egenskapsrutnätkontrollen.

void SetDescriptionRows(int nDescRows);

Parametrar

nDescRows
[i] Antalet rader som ska visas i egenskapsbeskrivningen.

CMFCPropertyGridCtrl::SetGroupNameFullWidth

Anger om du vill visa hela bredden på kategorinamnet för en grupp med egenskaper i den aktuella egenskapsrutnätkontrollen.

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

Parametrar

bGroupNameFullWidth
[i] TRUE för att visa hela bredden på kategorinamnet oavsett bredden på kolumnen egenskapsnamn. FALSE för att begränsa bredden på kategorinamnet till bredden på egenskapsnamnkolumnen. Standardvärdet är TRUE.

bRedraw
[in] TRUE att uppdatera kontrollen för egenskapsrutnätet omedelbart. FALSE för att uppdatera kontrollen när nästa redraw-händelse inträffar. Standardvärdet är TRUE.

Anmärkningar

Kontrollen för egenskapsrutnät består av ett storleksbart egenskapsnamn kolumn och ett egenskapsvärde kolumn. Slutet på namnkolumnen är också början på värdekolumnen. Om du vill ändra storlek på kolumnerna drar du kantlinjen mellan kolumnerna.

Termerna gruppnamn och kategorinamn används omväxlande i den här metoden. Kategorinamnet visas på en rad som leder en uppsättning relaterade egenskaper och värden. Den här metoden anger om bredden på kolumnen egenskapsnamn också anger bredden på det visade kategorinamnet.

CMFCPropertyGridCtrl::SetListDelimiter

Definierar ett tecken som används som avgränsare i en lista med egenskapsvärden.

void SetListDelimiter(TCHAR c);

Parametrar

c
[i] Ett tecken som ska fungera som avgränsare.

Anmärkningar

Använd den här metoden för att definiera ett avgränsartecken i en lista med egenskapsvärden som används i CMFCPropertyGridProperty::CMFCPropertyGridProperty konstruktorn. I konstruktorn anger du parametern bIsValueList till TRUE.

Som standard anger CMFCPropertyGridCtrl::CMFCPropertyGridCtrl konstruktorn avgränsarens tecken till kommatecken (',').

CMFCPropertyGridCtrl::SetShowDragContext

Anger om ramverket ritar om namn- och värdekolumnerna i den aktuella egenskapsrutnätskontrollen när en användare ändrar storlek på kolumnerna.

void SetShowDragContext(BOOL bShowDragContext = TRUE);

Parametrar

bShowDragContext
[i] TRUE för att rita om namn- och värdekolumnerna under en storleksändringsåtgärd. FALSE för att rita om kolumnerna när dragåtgärden har slutförts. Standardvärdet är TRUE.

Anmärkningar

Användaren kan ändra storlek på namn- och värdekolumnerna i en egenskapsrutnätskontroll genom att dra det delade fältet mellan kolumnerna. Om dragkontexten visas ändras namn- och värdekolumnerna så länge användaren drar i delningsfältet. Annars flyttas delningsfältet, men kolumnerna ritas inte om förrän dragåtgärden har slutförts.

CMFCPropertyGridCtrl::SetVSDotNetLook

Anger utseendet på kontrollen för egenskapsrutnätet till det format som används i Visual Studio .NET.

void SetVSDotNetLook(BOOL bSet=TRUE);

Parametrar

bSet
[in] TRUE för att ställa in kontrollen för egenskapsrutnät till det format som används i Visual Studio .NET; annars FALSE. Standardvärdet är TRUE.

Anmärkningar

CMFCPropertyGridCtrl::UpdateColor

Anger färgvärdet för den markerade färgegenskapen.

virtual void UpdateColor(COLORREF color);

Parametrar

color
[i] Ett RGB-färgvärde.

Anmärkningar

Den här metoden anger i felsökningsläge om den valda egenskapen för kontrollen för egenskapsrutnätet inte är en färgegenskap.

CMFCPropertyGridCtrl::ValidateItemData

Anropas av ramverket för att verifiera egenskapsdata.

virtual BOOL ValidateItemData(CMFCPropertyGridProperty* pProp);

Parametrar

pProp
[i] Pekare till en egenskap. Den här parametern används inte.

Returvärde

Alltid TRUE.

Anmärkningar

Metoden CMFCPropertyGridCtrl::EndEditItem anropar den här metoden för att verifiera data. Som standard använder den här metoden inte parametern pProp och dess returvärde är alltid TRUE.

Om du åsidosätter den här metoden returnerar du TRUE om de angivna egenskapsdata är giltiga. Annars returnerar du FALSE, i vilket fall ramverket inte uppdaterar egenskapen.

Se även

hierarkidiagram
klasser