CMFCPropertyGridCtrl osztály

További részletekért tekintse meg a Visual Studio telepítésének mfc mappájában található forráskódot. Például %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc.

Olyan szerkeszthető tulajdonságrács-vezérlőt támogat, amely képes a tulajdonságok betűrendben vagy hierarchikus sorrendben való megjelenítésére.

Szintaxis

class CMFCPropertyGridCtrl : public CWnd

Tagok

Nyilvános konstruktorok

Név	Leírás
CMFCPropertyGridCtrl::CMFCPropertyGridCtrl	Egy CMFCPropertyGridCtrl objektumot hoz létre.
CMFCPropertyGridCtrl::~CMFCPropertyGridCtrl	Destruktor.

Nyilvános metódusok

Név	Leírás
CMFCPropertyGridCtrl::accHitTest	A keretrendszer meghívta, hogy lekérje a gyermekelemet vagy a gyermekobjektumot a képernyő egy adott pontján. (Felülbírálások CWnd::accHitTest.)
CMFCPropertyGridCtrl::accLocation	A keretrendszer meghívta a megadott objektum aktuális képernyőhelyének lekéréséhez. (Felülbírálások CWnd::accLocation.)
CMFCPropertyGridCtrl::accSelect	A keretrendszer meghívta a kijelölés módosítására vagy a megadott objektum billentyűzetfókuszának áthelyezésére. (Felülbírálások CWnd::accSelect.)
CMFCPropertyGridCtrl::AddProperty	Új tulajdonságot ad hozzá egy tulajdonságrács-vezérlőhöz.
CMFCPropertyGridCtrl::AlwaysShowUserToolTip
CMFCPropertyGridCtrl::CloseColorPopup	Bezárja a színkijelölés párbeszédpanelt.
CMFCPropertyGridCtrl::Create	Létrehoz egy tulajdonságrács-vezérlőt, és csatolja a tulajdonságrács vezérlőobjektumához.
CMFCPropertyGridCtrl::DeleteProperty	Törli a megadott tulajdonságot a tulajdonságrács vezérlőelemből.
CMFCPropertyGridCtrl::DrawControlBarColors
CMFCPropertyGridCtrl::EnableDescriptionArea	Engedélyezi vagy letiltja a tulajdonságok listája alatt megjelenő leírási területet.
CMFCPropertyGridCtrl::EnableHeaderCtrl	Engedélyezi vagy letiltja a fejlécvezérlőt a tulajdonságrács vezérlőelem tetején.
CMFCPropertyGridCtrl::EnsureVisible	Görget egy tulajdonságrács vezérlőelemet, és kibontja a tulajdonságelemeket, amíg a megadott tulajdonság nem látható.
CMFCPropertyGridCtrl::ExpandAll	Kibontja vagy összecsukja az összes tulajdonságrács-vezérlőcsomópontot.
CMFCPropertyGridCtrl::FindItemByData	Lekéri a felhasználó által definiált DWORD értékkel társított tulajdonságot.
CMFCPropertyGridCtrl::get_accChild	A keretrendszer meghívta, hogy lekérje a megadott gyermek IDispatch felületének címét. (Felülbírálások CWnd::get_accChild.)
CMFCPropertyGridCtrl::get_accChildCount	A keretrendszer meghívta, hogy lekérje az objektumhoz tartozó gyermekek számát. (Felülbírálások CWnd::get_accChildCount.)
CMFCPropertyGridCtrl::get_accDefaultAction	A keretrendszer meghívta az objektum alapértelmezett műveletét leíró sztring lekérésére. (Felülbírálások CWnd::get_accDefaultAction.)
CMFCPropertyGridCtrl::get_accDescription	Keretrendszer által meghívva lekérhet egy sztringet, amely leírja a megadott objektum vizuális megjelenését. (Felülbírálások CWnd::get_accDescription.)
CMFCPropertyGridCtrl::get_accFocus	A keretrendszer meghívta, hogy lekérje a billentyűzetfókuszú objektumot. (Felülbírálások CWnd::get_accFocus.)
CMFCPropertyGridCtrl::get_accHelp	A keretrendszer meghívta egy objektum Help tulajdonságsztringjének lekéréséhez. (Felülbírálások CWnd::get_accHelp.)
CMFCPropertyGridCtrl::get_accHelpTopic	A keretrendszer meghívta a megadott objektumhoz társított WinHelp fájl teljes elérési útját és a fájlban található megfelelő témakör azonosítóját. (Felülbírálások CWnd::get_accHelpTopic.)
CMFCPropertyGridCtrl::get_accKeyboardShortcut	A keretrendszer meghívta a megadott objektum billentyűparancsának vagy hozzáférési kulcsának lekéréséhez. (Felülbírálások CWnd::get_accKeyboardShortcut.)
CMFCPropertyGridCtrl::get_accName	A keretrendszer meghívta a megadott objektum nevét. (Felülbírálások CWnd::get_accName.)
CMFCPropertyGridCtrl::get_accRole	A keretrendszer meghívta a megadott objektum szerepkörét leíró információk lekérésére. (Felülbírálások CWnd::get_accRole.)
CMFCPropertyGridCtrl::get_accSelection	A keretrendszer meghívta, hogy lekérje az objektum kiválasztott gyermekeit. (Felülbírálások CWnd::get_accSelection.)
CMFCPropertyGridCtrl::get_accState	A keretrendszer meghívta a megadott objektum aktuális állapotának lekéréséhez. (Felülbírálások CWnd::get_accState.)
CMFCPropertyGridCtrl::get_accValue	A keretrendszer meghívta a megadott objektum értékének lekéréséhez. (Felülbírálások CWnd::get_accValue.)
CMFCPropertyGridCtrl::GetBkColor	Lekéri az aktuális tulajdonságrács vezérlőelem háttérszínét.
CMFCPropertyGridCtrl::GetBoldFont	Az aktuális tulajdonságrács vezérlőelem szövegének Windows-betűtípusát kéri le félkövér stílusban.
CMFCPropertyGridCtrl::GetCurSel	Lekéri az aktuálisan kijelölt tulajdonságot.
CMFCPropertyGridCtrl::GetCustomColors	Lekéri a tulajdonságrács vezérlőelemeihez jelenleg definiált egyéni színeket.
CMFCPropertyGridCtrl::GetDescriptionHeight	Lekéri a tulajdonságrács vezérlőelem alján található leírási terület magasságát.
CMFCPropertyGridCtrl::GetDescriptionRows	Lekéri az aktuális tulajdonságrács vezérlőelem leírási területén lévő sorok számát.
CMFCPropertyGridCtrl::GetHeaderCtrl	Lekéri a belső CMFCHeaderCtrl objektumot, amelyet a keretrendszer az aktuális tulajdonságrács-vezérlő megjelenítéséhez használ.
CMFCPropertyGridCtrl::GetHeaderHeight	Lekéri a tulajdonságrács vezérlőfejlécének magasságát.
CMFCPropertyGridCtrl::GetLeftColumnWidth	Lekéri az aktuális tulajdonságrács vezérlőelem bal oldali oszlopának szélességét, amely tartalmazza az egyes tulajdonságok nevét.
CMFCPropertyGridCtrl::GetListRect	Lekéri a tulajdonságrács vezérlőelem határoló téglalapját.
CMFCPropertyGridCtrl::GetProperty	Egy tulajdonságrács vezérlőelem adott indexének megfelelő tulajdonságobjektumra mutató mutatót kér le.
CMFCPropertyGridCtrl::GetPropertyColumnWidth	A tulajdonságértékeket tartalmazó oszlop aktuális szélességét kéri le.
CMFCPropertyGridCtrl::GetPropertyCount	A tulajdonságrács vezérlőelem tulajdonságainak számát kéri le.
CMFCPropertyGridCtrl::GetRowHeight	Egy sor magasságát kéri le a tulajdonságrács vezérlőelemben.
CMFCPropertyGridCtrl::GetScrollBarCtrl	A tulajdonságrács vezérlőelem görgetősáv-vezérlőjének mutatója. (Felülbírálások CWnd::GetScrollBarCtrl.)
CMFCPropertyGridCtrl::GetTextColor	A tulajdonságelemek szövegének színét kéri le az aktuális tulajdonságrács vezérlőelemben.
CMFCPropertyGridCtrl::GetThisClass	A keretrendszer az ehhez az osztálytípushoz társított CRuntimeClass objektumra mutató mutató lekéréséhez használható.
CMFCPropertyGridCtrl::HitTest	Egy tulajdonságrács vezérlőelemének megfelelő tulajdonságobjektumra mutató mutatót kér le, ha egy adott pont szerepel az elemben. Ez a módszer azt a területet is jelzi a tulajdonságrács vezérlőelemben, amely a pontot tartalmazza.
CMFCPropertyGridCtrl::InitHeader	Inicializálja a belső CMFCHeaderCtrl objektumot, amelyet a keretrendszer az aktuális tulajdonságrács-vezérlő megjelenítéséhez használ.
CMFCPropertyGridCtrl::IsAlphabeticMode	Azt jelzi, hogy egy tulajdonságrács-vezérlő betűrendes módban van-e.
CMFCPropertyGridCtrl::IsAlwaysShowUserToolTip
CMFCPropertyGridCtrl::IsDescriptionArea	Azt jelzi, hogy megjelenik-e a tulajdonságrács vezérlőelem leírási területe.
CMFCPropertyGridCtrl::IsGroupNameFullWidth	Azt jelzi, hogy az egyes tulajdonságcsoportok neve megjelenik-e az aktuális tulajdonságrács-vezérlő szélességében.
CMFCPropertyGridCtrl::IsHeaderCtrl	Azt jelzi, hogy megjelenik-e a fejlécvezérlő.
CMFCPropertyGridCtrl::IsMarkModifiedProperties	Azt jelzi, hogy a tulajdonságrács vezérlőelem hogyan jeleníti meg a módosított tulajdonságokat.
CMFCPropertyGridCtrl::IsShowDragContext	Azt jelzi, hogy a keretrendszer újrarajzozza-e az aktuális tulajdonságrács vezérlőelem nevét és értékoszlopait, amikor egy felhasználó átméretezi az oszlopokat.
CMFCPropertyGridCtrl::IsVSDotNetLook	Azt jelzi, hogy a tulajdonságrács vezérlőelem megjelenése a VS .NET által használt stílusban van-e.
CMFCPropertyGridCtrl::MarkModifiedProperties	A módosított tulajdonságok megjelenítésének módját adja meg.
CMFCPropertyGridCtrl::PreTranslateMessage	Az osztály CWinApp az ablaküzenetek fordítására szolgál, mielőtt elküldené őket a TranslateMessage és DispatchMessage Windows-függvényekbe. (Felülbírálások CWnd::PreTranslateMessage.)
CMFCPropertyGridCtrl::RemoveAll	Eltávolítja az összes tulajdonságobjektumot egy tulajdonságrács-vezérlőből.
CMFCPropertyGridCtrl::ResetOriginalValues	Visszaállítja az összes tulajdonság eredeti értékét.
CMFCPropertyGridCtrl::SetAlphabeticMode	Betűrendes módot állít be vagy állít vissza.
CMFCPropertyGridCtrl::SetBoolLabels	Logikai címkék szövegét adja meg.
CMFCPropertyGridCtrl::SetCurSel	Kiválaszt egy tulajdonságot egy tulajdonságrács-vezérlőben.
CMFCPropertyGridCtrl::SetCustomColors	Egyéni színeket ad meg a különböző tulajdonságrács-vezérlőelemekhez.
CMFCPropertyGridCtrl::SetDescriptionRows	Az aktuális tulajdonságrács vezérlőelem leírási szakaszában megjelenítendő sorok számát adja meg.
CMFCPropertyGridCtrl::SetGroupNameFullWidth	Megadja, hogy az aktuális tulajdonságrács vezérlőelemben megjelenítse-e a kategórianév teljes szélességét.
CMFCPropertyGridCtrl::SetListDelimiter	A tulajdonságértékek listájában elválasztó karakterként használt karaktert definiál.
CMFCPropertyGridCtrl::SetShowDragContext	Megadja, hogy a keretrendszer újrarajzozza-e az aktuális tulajdonságrács vezérlőelem nevét és értékoszlopait, amikor egy felhasználó átméretezi az oszlopokat.
CMFCPropertyGridCtrl::SetVSDotNetLook	A tulajdonságrács vezérlőelem megjelenését a VS .NET-ben használt stílusra állítja.
CMFCPropertyGridCtrl::UpdateColor	Beállítja az aktuálisan kijelölt színtulajdonság színértékét.

Védett metódusok

Név	Leírás
CMFCPropertyGridCtrl::AdjustLayout	Újrarajzozza a tulajdonságrács vezérlőjét és tulajdonságait.
CMFCPropertyGridCtrl::CompareProps	A tulajdonságrács vezérlőelem meghívja a tulajdonságok rendezésére.
CMFCPropertyGridCtrl::EditItem	A keretrendszer meghívja, amikor a felhasználó elkezd módosítani egy tulajdonságot.
CMFCPropertyGridCtrl::EndEditItem	A keretrendszer meghívja, amikor a felhasználó nem módosít egy tulajdonságot.
CMFCPropertyGridCtrl::Init	A keretrendszer meghívta egy tulajdonságrács-vezérlő inicializálásához.
CMFCPropertyGridCtrl::OnChangeSelection	A keretrendszer meghívja az aktuális kijelölés módosításakor.
CMFCPropertyGridCtrl::OnClickButton	A keretrendszer meghívja, amikor egy tulajdonság gombra kattint.
CMFCPropertyGridCtrl::OnDrawBorder	A keretrendszer meghívta, hogy szegélyt rajzoljon egy tulajdonságrács-vezérlő köré.
CMFCPropertyGridCtrl::OnDrawDescription	A keretrendszer meghívta a leírási terület rajzolásához és a leírás szövegének megjelenítéséhez.
CMFCPropertyGridCtrl::OnDrawList	A keretrendszer meghívta, hogy megjelenítse a tulajdonságok listáját a tulajdonságrács-vezérlőben.
CMFCPropertyGridCtrl::OnDrawProperty	A keretrendszer meghívta egy tulajdonság megjelenítésére.
CMFCPropertyGridCtrl::OnPropertyChanged	A keretrendszer meghívja, amikor egy tulajdonság értéke megváltozik.
CMFCPropertyGridCtrl::OnSelectCombo	A keretrendszer meghívja, ha egy kombinált lista vezérlőelemet tartalmazó tulajdonság van kiválasztva.
CMFCPropertyGridCtrl::ValidateItemData	A keretrendszer meghívta a tulajdonságadatok érvényesítéséhez.

Megjegyzések

A CMFCPropertyGridCtrl osztály a CMFCPropertyGridProperty osztályból származó szerkeszthető tulajdonságokat tartalmazó tulajdonságrács-vezérlőt jelenít meg. Minden tulajdonság egy típust jelölhet, és alelemeket is tartalmazhat. A tulajdonságrács vezérlőelem alul egy átméretezhető területet támogat, amely megjelenítheti a kijelölt tulajdonság leírását.

Tulajdonságrács-vezérlő használatához hozzon létre egy CMFCPropertyGridCtrl objektumot, majd hívja meg a CMFCPropertyGridCtrl::Create metódust. A CMFCPropertyGridCtrl::AddProperty metódus használatával adjon hozzá tulajdonságokat a listához.

Kijelölés tulajdonságai

Érték helyett a tulajdonságelemek elindíthatnak egy párbeszédpanelt, amely lehetővé teszi a felhasználó számára, hogy színt, fájlt vagy betűtípust válasszon.

Az alábbi táblázat négy kijelölési tulajdonságtípust sorol fel:

Osztály	Leírás
CMFCPropertyGridProperty osztály	Általános célú tulajdonság, amely a sztringek, logikai értékek, dátumok stb. értékének megadására szolgál.
CMFCPropertyGridColorProperty osztály	Egy színérték kiválasztására használt tulajdonság.
CMFCPropertyGridFileProperty osztály	Egy fájl kiválasztásához használt tulajdonság.
CMFCPropertyGridFontProperty osztály	Egy betűtípus kiválasztásához használt tulajdonság.

Illusztrációk

Az alábbi ábrák egy tulajdonságrács vezérlőelemet ábrázolnak, amely kétféleképpen jeleníti meg a tulajdonságokat. Az első ábra hierarchikusan jeleníti meg a tulajdonságokat, a második pedig betűrendben jeleníti meg a tulajdonságokat.

Példa

Az alábbi példa bemutatja, hogyan konfigurálhat egy tulajdonságrács-vezérlőobjektumot a CMFCPropertyGridCtrl osztály különböző metódusaival. A példa bemutatja, hogyan engedélyezheti a fejlécvezérlőt, hogyan engedélyezheti a leírási területet, és hogyan állíthatja be a tulajdonságrács vezérlőelem megjelenését. A példa azt is bemutatja, hogyan állíthatja be a vezérlőelem betűrendes módját, amellyel a vezérlőelem rendezi az összes tulajdonságot a tulajdonságnév alapján, és hogyan állíthatja be az egyéni színeket a tulajdonságrács vezérlőelem különböző elemeihez. Ez a példa az Új vezérlők mintarésze.

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

Öröklési hierarchia

CObject

CCmdTarget

CWnd

CMFCPropertyGridCtrl

Követelmények

fejléc:afxpropertygridctrl.h

CMFCPropertyGridCtrl::accSelect

virtual HRESULT accSelect(
    long flagsSelect,
    VARIANT varChild);

Paraméterek

[in] flagsSelect
[in] varChild

Visszaadott érték

Megjegyzések

CMFCPropertyGridCtrl::AddProperty

Új tulajdonságot ad hozzá egy tulajdonságrács-vezérlőhöz.

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

Paraméterek

pProp
[in] Mutató egy tulajdonságra.

bRedraw
[in] TRUE, hogy azonnal újrarajzolva a tulajdonságot; ellenkező esetben FALSE. Az alapértelmezett érték a TRUE.

bAdjustLayout
[in] TRUE a tulajdonság szövegének és értékének újraszámításához, majd a tulajdonság rajzolásához; FALSE meglévő számítások használatával rajzolja meg a tulajdonságot. Az alapértelmezett érték a TRUE.

Visszaadott érték

Ha ez a módszer sikeres, a tulajdonságrácsban lévő pozíció nullaalapú indexe szabályozza a tulajdonság hozzáadásának helyét; ellenkező esetben -1.

Megjegyzések

Ez a metódus egy mutatót ad hozzá a megadott tulajdonsághoz a tulajdonságrács vezérlőelem tulajdonságok listájának végéhez. Ne pusztítsa el a tulajdonságokat, és ne engedje, hogy kimenjenek a hatókörből, mielőtt a rácsvezérlő megsemmisül. Ha végzett a tulajdonságrács-vezérlővel, hívja meg a CMFCPropertyGridCtrl::RemoveAll, hogy törölje az összes hozzáadott tulajdonságot. Az AddProperty metódus meghiúsul, ha a megadott tulajdonság már hozzá lett adva a listához.

CMFCPropertyGridCtrl::AdjustLayout

Újrarajzozza a tulajdonságrács vezérlőjét és tulajdonságait.

virtual void AdjustLayout();

Megjegyzések

Ez a metódus újraszámítja, hogyan rajzolhatja meg a teljes tulajdonságrács-vezérlőt és annak tulajdonságait, beleértve a képeket, betűtípusokat és vezérlőket.

CMFCPropertyGridCtrl::AlwaysShowUserToolTip

void AlwaysShowUserToolTip(BOOL bShow = TRUE);

Paraméterek

[in] bShow

Megjegyzések

CMFCPropertyGridCtrl::CloseColorPopup

Bezárja a színkijelölés párbeszédpanelt.

virtual void CloseColorPopup();

Megjegyzések

A színkijelölési párbeszédpanelről további információt CMFCPropertyGridColorProperty Osztálycímű témakörben talál.

CMFCPropertyGridCtrl::CMFCPropertyGridCtrl

Egy CMFCPropertyGridCtrl objektumot hoz létre.

CMFCPropertyGridCtrl();

Visszaadott érték

Megjegyzések

CMFCPropertyGridCtrl::CompareProps

A tulajdonságrács vezérlőelem meghívja a tulajdonságok rendezésére.

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

Paraméterek

pProp1
Mutató egy tulajdonságra.

pProp2
Mutató egy tulajdonságra.

Visszaadott érték

Visszaadott érték	Leírás
< 0	A pProp1 paraméter neve kisebb, mint a pProp2 paraméter neve.
0	A pProp1 paraméter neve megegyezik a pProp2 paraméter nevével.
> 0	A pProp1 objektum neve nagyobb, mint a pProp2 paraméter neve.

Megjegyzések

Ez a metódus alapértelmezés szerint a CString::Compare metódussal hasonlítja össze a megadott paraméterek CMFCPropertyGridProperty::m_strName tagjait.

CMFCPropertyGridCtrl::Create

Létrehoz egy tulajdonságrács-vezérlőt, és csatolja a tulajdonságrács vezérlőobjektumához.

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

Paraméterek

dwStyle
[in] ablakstílusok bitenkénti "vagy" (|) kombinációja.

rect
[in] Határolókeret, amely meghatározza az ablak méretét és pozícióját a pParentWndügyfélkoordinátáiban.

pParentWnd
[in] Mutasson a szülőablakra. Nem lehet NULL.

nID
[in] A gyermekablak azonosítója.

Visszaadott érték

TRUE, hogy az ablak sikeresen létrejött-e; ellenkező esetben FALSE.

Megjegyzések

Tulajdonságrács-vezérlő létrehozásához először hívja meg CMFCPropertyGridCtrl::CMFCPropertyGridCtrl egy tulajdonságrács-objektum létrehozásához. Ezután hívja meg CMFCPropertyGridCtrl::Create.

Példa

Az alábbi példa bemutatja, hogyan használható a Create metódus CMFCPropertyGridCtrl osztályban. Ez a példa az Új vezérlők mintarésze.

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

Törli a megadott tulajdonságot a tulajdonságrács vezérlőelemből.

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

Paraméterek

pProp
[in] Mutató egy tulajdonságra.

bRedraw
[in] TRUE a tulajdonságrács-vezérlő újraírásához; ellenkező esetben FALSE. Az alapértelmezett érték a TRUE.

bAdjustLayout
[in] TRUE, hogy újraszámolja, hogyan rajzolhatja meg az összes szöveget, képet és elemet a tulajdonságrács vezérlőelemben, majd rajzolja meg a vezérlőt; ellenkező esetben FALSE. Az alapértelmezett érték a TRUE.

Visszaadott érték

TRUE, hogy ez a módszer sikeres-e; ellenkező esetben FALSE.

Megjegyzések

Ezzel a módszerrel törölhet egy tulajdonságot és minden alelemet a tulajdonságrács vezérlőelemből.

CMFCPropertyGridCtrl::DrawControlBarColors

BOOL DrawControlBarColors() const;

Visszaadott érték

Megjegyzések

CMFCPropertyGridCtrl::EditItem

A keretrendszer meghívja, amikor a felhasználó elkezd módosítani egy tulajdonságot.

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

Paraméterek

pProp
[in] Mutató egy tulajdonságra.

lptClick
[in] A tulajdonságrács azon pontja, amellyel a felhasználó rákattintott a szerkesztési művelet megkezdéséhez. A pont a vezérlő ügyfélkoordinátáiban van. Az alapértelmezett érték a NULL.

Visszaadott érték

TRUE, hogy a metódus sikeres-e; ellenkező esetben FALSE.

Megjegyzések

CMFCPropertyGridCtrl::EnableDescriptionArea

Engedélyezi vagy letiltja a tulajdonságrács vezérlőelem tulajdonságok listája alatt megjelenő leírási területet.

void EnableDescriptionArea(BOOL bEnable=TRUE);

Paraméterek

bEnable
[in] TRUE a leírási terület engedélyezéséhez; FALSE a leírási terület letiltásához. Az alapértelmezett érték a TRUE.

Megjegyzések

A leírási terület a tulajdonságrács vezérlőelem alján jelenik meg. Alapértelmezés szerint a leírási terület le van tiltva, és nem látható.

CMFCPropertyGridCtrl::EnableHeaderCtrl

Engedélyezi vagy letiltja a fejlécvezérlőt a tulajdonságrács vezérlőelem tetején.

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

Paraméterek

bEnable
[in] TRUE a fejlécvezérlő engedélyezéséhez; FALSE a fejlécvezérlő letiltásához. Az alapértelmezett érték a TRUE.

lpszLeftColumn
[in] A fejlécvezérlő bal oldali oszlopának címe. Az alapértelmezett érték a Property.

lpszRightColumn
[in] A fejléc vezérlőelem jobb oldali oszlopának címe. Az alapértelmezett érték a Value.

CMFCPropertyGridCtrl::EndEditItem

A keretrendszer meghívja, amikor a felhasználó befejezi egy tulajdonság módosítását.

virtual BOOL EndEditItem(BOOL bUpdateData=TRUE);

Paraméterek

bUpdateData
[in] TRUE annak megadásához, hogy a módosított tulajdonságadatokat ellenőrizni kell a szerkesztési művelet befejezésekor; ellenkező esetben FALSE. Az alapértelmezett érték a TRUE.

Visszaadott érték

TRUE, hogy a szerkesztési művelet sikeresen befejeződik-e; FALSE, hogy a módosított tulajdonságadatok érvénytelenek-e, vagy ha a szerkesztési műveletnek folytatódnia kell.

Megjegyzések

CMFCPropertyGridCtrl::EnsureVisible

Görget egy tulajdonságrács vezérlőelemet, és kibontja a tulajdonságelemeket, amíg a megadott tulajdonság nem látható.

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

Paraméterek

pProp
[in] Mutató egy tulajdonságra.

bExpandParents
[in] TRUE a szülőelemek kibontásához a megadott tulajdonság láthatóvá tételéhez; ellenkező esetben FALSE. Az alapértelmezett érték a FALSE.

Megjegyzések

CMFCPropertyGridCtrl::ExpandAll

Kibontja vagy összecsukja az összes tulajdonságrács-vezérlőcsomópontot.

void ExpandAll(BOOL bExpand=TRUE);

Paraméterek

bExpand
[in] TRUE az összes csomópont kibontásához; FALSE az összes csomópont összecsukásához. Az alapértelmezett érték a TRUE.

Megjegyzések

CMFCPropertyGridCtrl::FindItemByData

Lekéri a felhasználó által definiált DWORD értékkel társított tulajdonságot.

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

Paraméterek

dwData
[in] Egy DWORD érték.

bSearchSubItems
[in] TRUE a tulajdonság alelemeinek kereséséhez; ellenkező esetben FALSE. Az alapértelmezett érték a TRUE.

Visszaadott érték

Mutató a társított tulajdonságobjektumra, ha ez a módszer sikeres; ellenkező esetben NULL.

Megjegyzések

A CMFCPropertyGridCtrl::CMFCPropertyGridCtrl konstruktor vagy CMFCPropertyGridProperty::SetData metódussal társíthat DWORD egy tulajdonsághoz.

CMFCPropertyGridCtrl::get_accChildCount

virtual HRESULT get_accChildCount(long* pcountChildren);

Paraméterek

[in] pcountChildren

Visszaadott érték

Megjegyzések

CMFCPropertyGridCtrl::get_accFocus

virtual HRESULT get_accFocus(VARIANT* pvarChild);

Paraméterek

[in] pvarChild

Visszaadott érték

Megjegyzések

CMFCPropertyGridCtrl::get_accHelp

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

Paraméterek

[in] varChild
[in] pszHelp

Visszaadott érték

Megjegyzések

CMFCPropertyGridCtrl::get_accHelpTopic

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

Paraméterek

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

Visszaadott érték

Megjegyzések

CMFCPropertyGridCtrl::get_accKeyboardShortcut

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

Paraméterek

[in] varChild
[in] pszKeyboardShortcut

Visszaadott érték

Megjegyzések

CMFCPropertyGridCtrl::get_accSelection

virtual HRESULT get_accSelection(VARIANT* pvarChildren);

Paraméterek

[in] pvarChildren

Visszaadott érték

Megjegyzések

CMFCPropertyGridCtrl::GetBkColor

Lekéri az aktuális tulajdonságrács vezérlőelem háttérszínét.

COLORREF GetBkColor() const;

Visszaadott érték

RGB-színérték.

Megjegyzések

Ez a metódus lekéri a keretrendszer által az aktuális tulajdonságrács-vezérlő hátterének rajzolásához használt színt. A CMFCPropertyGridCtrl::GetTextColor metódus lekéri az előtérszínt.

CMFCPropertyGridCtrl::GetBoldFont

Lekéri az aktuális tulajdonságrács vezérlőelem szövegének félkövér stílusban történő rajzolásához használt Windows-betűtípust.

CFont& GetBoldFont();

Visszaadott érték

Egy félkövér betűtípus jellemzőit leíró CFont objektumra mutató hivatkozás.

CMFCPropertyGridCtrl::GetCurSel

Lekéri az aktuálisan kijelölt tulajdonságot.

CMFCPropertyGridProperty* GetCurSel() const;

Visszaadott érték

Mutató a tulajdonságrács vezérlőelem kijelölt elemének megfelelő tulajdonságobjektumra.

Megjegyzések

CMFCPropertyGridCtrl::GetCustomColors

Lekéri a tulajdonságrács vezérlőelemeihez jelenleg definiált egyéni színeket.

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

Paraméterek

clrBackground
[kifelé] A tulajdonságértékek háttérszíne.

clrText
[kifelé] A tulajdonságnevek és a tulajdonságérték szövegének színe.

clrGroupBackground
[kifelé] Egy tulajdonságcsoport háttérszíne.

clrGroupText
[kifelé] A tulajdonságcsoport szövegének színe.

clrDescriptionBackground
[kifelé] A leírási terület háttérszíne.

clrDescriptionText
[kifelé] A szöveg színe a leírási területen.

clrLine
[kifelé] A tulajdonságok között rajzolt vonalak színe.

Megjegyzések

Az egyéni színek beállításához használja a CMFCPropertyGridCtrl::SetCustomColors metódust.

CMFCPropertyGridCtrl::GetDescriptionHeight

Lekéri a tulajdonságrács vezérlőelem alján található leírási terület magasságát.

int GetDescriptionHeight() const;

Visszaadott érték

A leírási terület magassága képpontban.

Megjegyzések

A leírási terület magasságának kiszámítása automatikusan történik, és a tulajdonságrács-vezérlő magasságának 1/4-ére van beállítva.

A leírási terület megjelenítéséhez vagy elrejtéséhez használja a CMFCPropertyGridCtrl::EnableDescriptionArea metódust. A CMFCPropertyGridCtrl::IsDescriptionArea metódus használatával állapítsa meg, hogy a leírási terület megjelenik-e vagy rejtve van-e.

CMFCPropertyGridCtrl::GetDescriptionRows

Lekéri az aktuális tulajdonságrács vezérlőelem leírási területén lévő sorok számát.

int GetDescriptionRows() const;

Visszaadott érték

Az aktuális tulajdonságrács vezérlőelem leírási területén lévő sorok száma.

Megjegyzések

A CMFCPropertyGridCtrl::CMFCPropertyGridCtrl konstruktor 3 sorra inicializálja a leírási területet.

CMFCPropertyGridCtrl::GetHeaderCtrl

Lekéri a belső CMFCHeaderCtrl objektumot, amelyet a keretrendszer az aktuális tulajdonságrács-vezérlő megjelenítéséhez használ.

virtual CMFCHeaderCtrl& GetHeaderCtrl();

Visszaadott érték

Hivatkozás egy CMFCHeaderCtrl objektumra.

CMFCPropertyGridCtrl::GetHeaderHeight

Egy tulajdonságrács vezérlőelem fejlécének magasságát kéri le.

int GetHeaderHeight() const;

Visszaadott érték

Az élőfej magassága képpontban.

Megjegyzések

CMFCPropertyGridCtrl::GetLeftColumnWidth

Az aktuális tulajdonságrács vezérlőelem bal oldali oszlopának szélességét kéri le, amely tartalmazza az egyes tulajdonságok nevét.

int GetLeftColumnWidth() const;

Visszaadott érték

A névoszlop szélessége.

Megjegyzések

A tulajdonságrács vezérlőelem jobb oszlopa az egyes tulajdonságok értékét tartalmazza.

CMFCPropertyGridCtrl::GetListRect

Lekéri a tulajdonságrács vezérlőelem határoló téglalapját.

CRect GetListRect() const;

Visszaadott érték

A tulajdonságrács vezérlőelem határoló téglalapja. Ez a téglalap nem tartalmazza a leírási területet és az élőfejet.

Megjegyzések

CMFCPropertyGridCtrl::GetProperty

Egy tulajdonságrács vezérlőelemben lévő elem adott indexének megfelelő tulajdonságobjektumra mutató mutatót kér le.

CMFCPropertyGridProperty* GetProperty(int nIndex) const;

Paraméterek

nIndex
[in] Egy tulajdonságrács vezérlőelem nullaalapú indexe.

Ez a módszer azt állítja, hogy a nIndex paraméter nullánál kisebb vagy nagyobb, mint a tulajdonságok száma.

Visszaadott érték

A megadott indexnek megfelelő tulajdonságobjektumra mutató mutató, ha ez a módszer sikeres; ellenkező esetben NULL.

Megjegyzések

CMFCPropertyGridCtrl::GetPropertyColumnWidth

A tulajdonságértékeket tartalmazó oszlop aktuális szélességét kéri le.

int GetPropertyColumnWidth() const;

Visszaadott érték

A tulajdonságértékeket tartalmazó oszlop aktuális szélessége.

Megjegyzések

A tulajdonságrács vezérlőelem jobb oldalán lévő oszlop tartalmazza a tulajdonságértékeket. Az ügyfél a tulajdonságrács vezérlőelem osztott mezőjével módosíthatja az értékek oszlopának szélességét.

CMFCPropertyGridCtrl::GetPropertyCount

A tulajdonságrács vezérlőelem tulajdonságainak számát kéri le.

int GetPropertyCount() const;

Visszaadott érték

A tulajdonságok száma.

Megjegyzések

CMFCPropertyGridCtrl::GetRowHeight

Egy sor magasságát kéri le a tulajdonságrács vezérlőelemben.

int GetRowHeight() const;

Visszaadott érték

Egy sor magassága.

Megjegyzések

A sorok magassága megegyezik az aktuális betűtípus magasságával és 4 képponttal.

CMFCPropertyGridCtrl::GetScrollBarCtrl

A tulajdonságrács vezérlőelem görgetősáv-vezérlőjének mutatója.

virtual CScrollBar* GetScrollBarCtrl(int nBar) const;

Paraméterek

nBar
[in] A görgetősáv tájolása, amelynek SB_VERTkell lennie.

Visszaadott érték

Görgetősáv-objektumra mutató mutató, vagy NULL, ha nincs görgetősáv, vagy a görgetősáv tájolása SB_HORZ.

Megjegyzések

Ezzel a módszerrel közvetlen hozzáférést kaphat a függőleges görgetősáv-vezérlőhöz.

CMFCPropertyGridCtrl::GetTextColor

Lekéri a tulajdonságelemek szövegének rajzolásához használt színt az aktuális tulajdonságrács vezérlőelemben.

COLORREF GetTextColor() const;

Visszaadott érték

RGB-színérték.

Megjegyzések

Ez a metódus lekéri azt a színt, amelyet a keretrendszer az aktuális tulajdonságrács-vezérlő előterének rajzolásához használ. A CMFCPropertyGridCtrl::GetBkColor metódus lekéri a háttérszínt.

CMFCPropertyGridCtrl::HitTest

Egy tulajdonságrács vezérlőelemének megfelelő tulajdonságobjektumra mutató mutatót kér le, ha egy adott pont szerepel az elemben. Ez a módszer azt a területet is jelzi a tulajdonságrács vezérlőelemben, amely a pontot tartalmazza.

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

Paraméterek

pt
[in] Pont az ügyfélkoordinátákban.

pnArea
[be, ki] Egy ClickArea változóra mutató mutató. A metódus visszatérésekor a változó a megadott pontot tartalmazó tulajdonságterületet jelzi. A tulajdonságterülettel kapcsolatos további információkért lásd a Megjegyzések című témakört.

bPropsOnly
[in] TRUE, hogy csak a tulajdonságterületet tesztelje; FALSE a leírási terület teszteléséhez, ha a megadott pont nincs a tulajdonságterületen. Az alapértelmezett érték a FALSE. A leírási területtel kapcsolatos további információkért lásd: Megjegyzések.

Visszaadott érték

Ha a bPropsOnly paraméter TRUE, és a megadott pont egy tulajdonságterületen van, a visszatérési érték a megfelelő tulajdonságobjektumra mutató mutató. Emellett a pnArea paraméter a megadott pontot tartalmazó adott területre van beállítva. Ellenkező esetben a visszatérési érték NULL, és a pnArea paraméter nem módosul.

Ha a bPropsOnly paraméter FALSE, a visszatérési érték mindig NULL. Ha azonban a megadott pont a leírási területen van, a pnArea paraméter CMFCPropertyGridProperty::ClickDescriptionértékre van állítva.

Megjegyzések

A tulajdonságterület kifejezés a tulajdonságrács vezérlőelemének bármely nevére, értékére vagy kibontására utal. A leírási terület a tulajdonságrács vezérlőelem alján lévő zóna. Amikor kiválaszt egy tulajdonságrács-vezérlőelemet, a leírási terület megjeleníti a megfelelő tulajdonság leírását.

Ez a metódus annak a változónak az értékét állítja be, amelyre a pnArea paraméter mutat. Az alábbi táblázat a lehetséges értékeket és a hozzájuk tartozó területeket sorolja fel.

Érték	Terület
ClickArea::ClickExpandBox	Tulajdonság kibontása mező vezérlőelem.
ClickArea::ClickName	Tulajdonságnév.
ClickArea::ClickValue	Tulajdonságérték.
CMFCPropertyGridProperty::ClickDescription	Tulajdonságrács vezérlőelem leírási területe.

CMFCPropertyGridCtrl::Init

A keretrendszer meghívta egy tulajdonságrács-vezérlő inicializálásához.

virtual void Init();

Megjegyzések

CMFCPropertyGridCtrl::InitHeader

Inicializálja a belső CMFCHeaderCtrl objektumot, amelyet a keretrendszer az aktuális tulajdonságrács-vezérlő megjelenítéséhez használ.

virtual void InitHeader();

CMFCPropertyGridCtrl::IsAlphabeticMode

Azt jelzi, hogy egy tulajdonságrács-vezérlő betűrendes módban van-e.

BOOL IsAlphabeticMode() const;

Visszaadott érték

TRUE, hogy a tulajdonságrács vezérlőelem betűrendes módban van-e; egyéb esetben FALSE.

Megjegyzések

Ha a tulajdonságrács vezérlőelem betűrendes módban van, az összes tulajdonság betűrendben lesz rendezve a nevük alapján. Ellenkező esetben a tulajdonságok a szülőcsomópontok alatt vannak csoportosítva.

A betűrendes mód engedélyezéséhez vagy letiltásához használja a CMFCPropertyGridCtrl::SetAlphabeticMode metódust.

CMFCPropertyGridCtrl::IsAlwaysShowUserToolTip

BOOL IsAlwaysShowUserToolTip() const;

Visszaadott érték

Megjegyzések

CMFCPropertyGridCtrl::IsDescriptionArea

Azt jelzi, hogy megjelenik-e a tulajdonságrács vezérlőelem leírási területe.

BOOL IsDescriptionArea() const;

Visszaadott érték

TRUE, hogy megjelenik-e a leírási terület; ellenkező esetben FALSE.

Megjegyzések

A leírási terület elrejtéséhez vagy megjelenítéséhez használja a CMFCPropertyGridCtrl::EnableDescriptionArea metódust.

CMFCPropertyGridCtrl::IsGroupNameFullWidth

Azt jelzi, hogy az egyes tulajdonságcsoportok neve megjelenik-e az aktuális tulajdonságrács-vezérlő szélességében.

BOOL IsGroupNameFullWidth() const;

Visszaadott érték

TRUE, ha a csoportnevek a tulajdonságrács vezérlőelem szélessége alatt jelennek meg; FALSE ha a vezérlőelem jobb oldali (érték) oszlopa csonkolja a csoportneveket.

Megjegyzések

A csoport egy tulajdonságrács vezérlőelem kapcsolódó tulajdonságainak gyűjteménye. Ha a vezérlő hierarchikusan jelenik meg, a csoport neve kategóriacímként jelenik meg a csoport fölötti sorban.

CMFCPropertyGridCtrl::IsHeaderCtrl

Azt jelzi, hogy megjelenik-e a fejlécvezérlő.

BOOL IsHeaderCtrl() const;

Visszaadott érték

TRUE, hogy megjelenik-e a fejlécvezérlő; egyéb esetben FALSE.

Megjegyzések

A CMFCPropertyGridCtrl::EnableHeaderCtrl metódus használatával elrejtheti vagy megjelenítheti a fejlécvezérlőt.

CMFCPropertyGridCtrl::IsMarkModifiedProperties

Azt jelzi, hogy a tulajdonságrács vezérlőelem hogyan jeleníti meg a módosított tulajdonságokat.

BOOL IsMarkModifiedProperties() const;

Visszaadott érték

TRUE ha félkövér stílust használ a módosított tulajdonságok megjelenítéséhez; FALSE, ha a normál stílus a módosított tulajdonságok megjelenítésére szolgál.

Megjegyzések

CMFCPropertyGridCtrl::IsShowDragContext

Azt jelzi, hogy a keretrendszer újrarajzozza-e az aktuális tulajdonságrács vezérlőelem nevét és értékoszlopait, amikor egy felhasználó átméretezi az oszlopokat.

BOOL IsShowDragContext() const;

Visszaadott érték

TRUE, ha a keretrendszer újrarajzolva a nevet és az értékoszlopokat egy átméretezési művelet során; FALSE, ha a keretrendszer újrarajzozza az oszlopokat az húzási művelet befejezése után.

Megjegyzések

A felhasználó átméretezheti egy tulajdonságrács vezérlőelem nevét és értékoszlopait az oszlopok közötti felosztósáv húzásával. Ha megjelenik a húzási környezet, a rendszer átméretezi a nevet és az értékoszlopokat, amíg a felhasználó az osztott sávot húzza. Ellenkező esetben a felosztott sáv elmozdul, de az oszlopok nem lesznek újrarajzolódva, amíg a húzási művelet be nem fejeződik.

CMFCPropertyGridCtrl::IsVSDotNetLook

Azt jelzi, hogy a tulajdonságrács vezérlőelem megjelenése a Visual Studio .NET stílusában van-e.

BOOL IsVSDotNetLook() const;

Visszaadott érték

TRUE, hogy a tulajdonságrács vezérlőelem a Visual Studio .NET stílusában van-e; ellenkező esetben FALSE.

Megjegyzések

A CMFCPropertyGridCtrl::SetVSDotNetLook metódussal állítsa a tulajdonságrács vezérlőelemet a Visual Studio .NET stílusára.

CMFCPropertyGridCtrl::MarkModifiedProperties

A módosított tulajdonságok megjelenítésének módját adja meg.

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

Paraméterek

bMark
[in] TRUE a módosított tulajdonságok félkövér stílusban való megjelenítéséhez; FALSE a módosított tulajdonságok normál stílusban való megjelenítéséhez. Az alapértelmezett érték a TRUE.

bRedraw
[in] TRUE a tulajdonságrács-vezérlő azonnali újraírásához; ellenkező esetben FALSE. Az alapértelmezett érték a TRUE.

Megjegyzések

CMFCPropertyGridCtrl::OnChangeSelection

A keretrendszer meghívja az aktuális kijelölés módosításakor.

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

Paraméterek

pNewSel
[in] Mutasson az újonnan kijelölt tulajdonságra.

pOldSel
[in] Mutasson a korábban kijelölt tulajdonságra.

Megjegyzések

A metódus alapértelmezett implementációja nem tesz semmit.

CMFCPropertyGridCtrl::OnClickButton

A keretrendszer meghívja, amikor egy tulajdonság gombra kattint.

virtual void OnClickButton(CPoint point);

Paraméterek

point
[in] Pont az ügyfélkoordinátákban.

Megjegyzések

Ez a módszer alapértelmezés szerint frissíti az aktuális tulajdonságértéket.

CMFCPropertyGridCtrl::OnDrawBorder

A keretrendszer meghívta, hogy szegélyt rajzoljon egy tulajdonságrács-vezérlő köré.

virtual void OnDrawBorder(CDC* pDC);

Paraméterek

pDC
[in] Egy eszközkörnyezetre mutató mutató.

Megjegyzések

CMFCPropertyGridCtrl::OnDrawDescription

A keretrendszer meghívta a leírási terület rajzolásához és a leírás szövegének megjelenítéséhez.

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

Paraméterek

pDC
[in] Egy eszközkörnyezetre mutató mutató.

rect
[in] Egy téglalap, amely meghatározza, hogy hol kell rajzolni a leírási területet.

Megjegyzések

A leírási terület megjelenítéséhez használja a CMFCPropertyGridCtrl::EnableDescriptionArea metódust.

CMFCPropertyGridCtrl::OnDrawList

A keretrendszer meghívta, hogy megjelenítse a tulajdonságok listáját a tulajdonságrács-vezérlőben.

virtual void OnDrawList(CDC* pDC);

Paraméterek

pDC
[in] Egy eszközkörnyezetre mutató mutató.

Megjegyzések

CMFCPropertyGridCtrl::OnDrawProperty

A keretrendszer meghívta egy tulajdonság megjelenítésére.

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

Paraméterek

pDC
[in] Egy eszközkörnyezetre mutató mutató.

pProp
[in] Egy tulajdonságobjektumra mutató mutató.

Visszaadott érték

TRUE, hogy ez a módszer sikeres-e; ellenkező esetben FALSE.

Megjegyzések

CMFCPropertyGridCtrl::OnPropertyChanged

A keretrendszer meghívja, amikor egy tulajdonság értéke megváltozik.

virtual void OnPropertyChanged(CMFCPropertyGridProperty* pProp) const;

Paraméterek

pProp
[in] Egy olyan tulajdonságobjektumra mutató mutató, amelynek az értéke megváltozott.

Megjegyzések

Alapértelmezés szerint ez a metódus elküldi a AFX_WM_PROPERTY_CHANGED üzenetet a tulajdonságrács-vezérlő tulajdonosának.

CMFCPropertyGridCtrl::OnSelectCombo

A keretrendszer meghívja, ha egy kombinált lista vezérlőelemet tartalmazó tulajdonság van kiválasztva.

void OnSelectCombo();

Megjegyzések

CMFCPropertyGridCtrl::RemoveAll

Eltávolítja az összes tulajdonságobjektumot egy tulajdonságrács-vezérlőből.

void RemoveAll();

Megjegyzések

CMFCPropertyGridCtrl::ResetOriginalValues

Visszaállítja az összes tulajdonság eredeti értékeit.

void ResetOriginalValues(BOOL bRedraw=TRUE);

Paraméterek

bRedraw
[in] TRUE a tulajdonságlista újraírásához; ellenkező esetben FALSE. Az alapértelmezett érték a TRUE.

Megjegyzések

CMFCPropertyGridCtrl::SetAlphabeticMode

Betűrendes módot állít be vagy állít vissza.

void SetAlphabeticMode(BOOL bSet=TRUE);

Paraméterek

bSet
[in] TRUE betűrendes mód beállításához; FALSE betűrendes mód alaphelyzetbe állítása. Az alapértelmezett érték a TRUE.

Megjegyzések

Ha a tulajdonságrács vezérlőelem betűrendes módban van, a vezérlőelem a tulajdonságnév alapján rendezi az összes tulajdonságot.

CMFCPropertyGridCtrl::SetBoolLabels

Logikai címkék szövegét adja meg.

void SetBoolLabels(
    LPCTSTR lpszTrue,
    LPCTSTR lpszFalse);

Paraméterek

lpszTrue
[in] Az igaz logikai értékhez megjelenítendő szöveges sztring.

lpszFalse
[in] A hamis logikai értékhez megjelenítendő szöveges sztring.

Megjegyzések

CMFCPropertyGridCtrl::SetCurSel

Kiválaszt egy tulajdonságot egy tulajdonságrács-vezérlőben.

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

Paraméterek

pProp
[in] Egy tulajdonságobjektumra mutató mutató.

bRedraw
[in] TRUE a tulajdonságrács-vezérlő azonnali újraírásához; ellenkező esetben FALSE. Az alapértelmezett érték a TRUE.

Megjegyzések

Ezzel a módszerrel megszakíthatja az aktuális elem kijelölését a tulajdonságrács vezérlőelemben, majd kiválaszthatja a megadott tulajdonságnak megfelelő elemet.

CMFCPropertyGridCtrl::SetCustomColors

Egyéni színeket ad meg a tulajdonságrács vezérlőelem különböző elemeihez.

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

Paraméterek

clrBackground
[in] A tulajdonságértékek háttérszíne.

clrText
[in] A tulajdonságnevek és a tulajdonságérték szövegének színe.

clrGroupBackground
[in] Egy tulajdonságcsoport háttérszíne.

clrGroupText
[in] A tulajdonságcsoport új szövegszíne.

clrDescriptionBackground
[in] A leírási terület háttérszíne.

clrDescriptionText
[in] A szöveg színe a leírási területen.

clrLine
[in] A tulajdonságok között rajzolt vonalak színe.

Megjegyzések

Bármely paraméternél adja meg a ((COLORREF)-1) színértéket, amely a tulajdonságrács vezérlőelem adott elemének alapértelmezett színét szeretné használni.

Egy adott tulajdonság megjelenésének testreszabásához származtassunk egy osztályt a CMFCPropertyGridProperty osztályból, majd felülbíráljuk a CMFCPropertyGridProperty::OnDrawName, CMFCPropertyGridProperty::OnDrawValue, CMFCPropertyGridProperty::OnDrawExpandBoxés CMFCPropertyGridProperty::OnDrawButton metódusokat.

CMFCPropertyGridCtrl::SetDescriptionRows

Az aktuális tulajdonságrács vezérlőelem leírási szakaszában megjelenítendő sorok számát adja meg.

void SetDescriptionRows(int nDescRows);

Paraméterek

nDescRows
[in] A tulajdonság leírásában megjelenítendő sorok száma.

CMFCPropertyGridCtrl::SetGroupNameFullWidth

Megadja, hogy az aktuális tulajdonságrács vezérlőelemben megjelenítse-e a kategórianév teljes szélességét.

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

Paraméterek

bGroupNameFullWidth
A(z) [in] TRUE a kategórianév teljes szélességének megjelenítéséhez a tulajdonságnév oszlop szélességétől függetlenül. FALSE a kategórianév szélességének a tulajdonságnév oszlop szélességére való korlátozásához. Az alapértelmezett érték a TRUE.

bRedraw
[in] TRUE a tulajdonságrács-vezérlő azonnali frissítéséhez; FALSE frissíteni a vezérlőt a következő újraírási esemény bekövetkezésekor. Az alapértelmezett érték a TRUE.

Megjegyzések

A tulajdonságrács vezérlőelem egy átméretezhető tulajdonságnévből oszlopból és egy tulajdonságértékből oszlopból áll. A névoszlop vége egyben az értékoszlop kezdete is. Az oszlopok átméretezéséhez húzza a szegélyt az oszlopok közé.

Ebben a metódusban a csoportnév és kategórianév kifejezéseket használjuk fel. A kategória neve egy olyan sorban jelenik meg, amely a kapcsolódó tulajdonságok és értékek egy csoportját vezeti. Ez a metódus azt határozza meg, hogy a tulajdonságnév oszlop szélessége a megjelenített kategórianév szélességét is meghatározza-e.

CMFCPropertyGridCtrl::SetListDelimiter

A tulajdonságértékek listájában elválasztóként használt karaktert definiál.

void SetListDelimiter(TCHAR c);

Paraméterek

c
[in] Egy karakter, amely elválasztóként szolgál.

Megjegyzések

Ezzel a módszerrel elválasztó karaktert definiálhat a CMFCPropertyGridProperty::CMFCPropertyGridProperty konstruktorban használt tulajdonságértékek listájában. Ebben a konstruktorban állítsa a bIsValueList paramétert TRUE.

A CMFCPropertyGridCtrl::CMFCPropertyGridCtrl konstruktor alapértelmezés szerint vesszőre (',') állítja be a határoló karaktert.

CMFCPropertyGridCtrl::SetShowDragContext

Megadja, hogy a keretrendszer újrarajzozza-e az aktuális tulajdonságrács vezérlőelem nevét és értékoszlopait, amikor egy felhasználó átméretezi az oszlopokat.

void SetShowDragContext(BOOL bShowDragContext = TRUE);

Paraméterek

bShowDragContext
[in] TRUE a név- és értékoszlopok újraírására egy átméretezési művelet során; FALSE a húzási művelet befejezése után újrarajzolva az oszlopokat. Az alapértelmezett érték a TRUE.

Megjegyzések

A felhasználó átméretezheti egy tulajdonságrács vezérlőelem nevét és értékoszlopait az oszlopok közötti felosztósáv húzásával. Ha megjelenik a húzási környezet, a rendszer átméretezi a nevet és az értékoszlopokat, amíg a felhasználó az osztott sávot húzza. Ellenkező esetben a felosztott sáv elmozdul, de az oszlopok nem lesznek újrarajzolódva, amíg a húzási művelet be nem fejeződik.

CMFCPropertyGridCtrl::SetVSDotNetLook

A tulajdonságrács vezérlőelem megjelenését a Visual Studio .NET-ben használt stílusra állítja.

void SetVSDotNetLook(BOOL bSet=TRUE);

Paraméterek

bSet
[in] TRUE, hogy a tulajdonságrács vezérlője a Visual Studio .NET-ben használt stílusra legyen állítva; ellenkező esetben FALSE. Az alapértelmezett érték a TRUE.

Megjegyzések

CMFCPropertyGridCtrl::UpdateColor

Beállítja az aktuálisan kijelölt színtulajdonság színértékét.

virtual void UpdateColor(COLORREF color);

Paraméterek

color
[in] RGB-színérték.

Megjegyzések

Ez a módszer hibakeresési módban érvényes, ha a tulajdonságrács vezérlőelem jelenleg kijelölt tulajdonsága nem színtulajdonság.

CMFCPropertyGridCtrl::ValidateItemData

A keretrendszer meghívta a tulajdonságadatok érvényesítéséhez.

virtual BOOL ValidateItemData(CMFCPropertyGridProperty* pProp);

Paraméterek

pProp
[in] Mutató egy tulajdonságra. Ezt a paramétert nem használja a rendszer.

Visszaadott érték

Mindig TRUE.

Megjegyzések

A CMFCPropertyGridCtrl::EndEditItem metódus az adatok ellenőrzésére hívja meg ezt a metódust. Alapértelmezés szerint ez a metódus nem használja a pProp paraméterét, és a visszatérési értéke mindig TRUE.

Ha felülbírálja ezt a módszert, TRUE adja vissza, ha a megadott tulajdonságadatok érvényesek. Ellenkező esetben adja vissza a FALSE, amely esetben a keretrendszer nem frissíti a tulajdonságot.

Lásd még:

hierarchiadiagram
osztályok