CMFCPropertySheet osztály

Megjegyzés:

A Microsoft Foundation Classes (MFC) könyvtár továbbra is támogatott. A továbbiakban azonban nem adunk hozzá funkciókat, és nem frissítjük a dokumentációt.

Az CMFCPropertySheet osztály olyan tulajdonságlapot támogat, amelyben az egyes tulajdonságlapokat egy lapfül, egy eszköztárgomb, egy favezérlő csomópont vagy egy listaelem jelöli.

Szemantika

class CMFCPropertySheet : public CPropertySheet

Tagok

Nyilvános konstruktorok

Név	Description
CMFCPropertySheet::CMFCPropertySheet	Egy CMFCPropertySheet objektumot hoz létre.
CMFCPropertySheet::~CMFCPropertySheet	Destruktor.

Nyilvános metódusok

Név	Description
CMFCPropertySheet::AddPage	Hozzáad egy lapot a tulajdonságlaphoz.
CMFCPropertySheet::AddPageToTree	Új tulajdonságlapot ad hozzá a fa vezérlőelemhez.
CMFCPropertySheet::AddTreeCategory	Új csomópontot ad hozzá a favezérlőhöz.
CMFCPropertySheet::EnablePageHeader	Az egyéni fejléc rajzolásához foglal helyet az egyes lapok tetején.
CMFCPropertySheet::GetHeaderHeight	Lekéri az aktuális fejléc magasságát.
CMFCPropertySheet::GetLook	Lekéri az aktuális tulajdonságlap megjelenését meghatározó enumerálási értéket.
CMFCPropertySheet::GetNavBarWidth	A navigációs sáv szélességének újrapróbálkozása képpontban.
CMFCPropertySheet::GetTab	Lekéri az aktuális tulajdonságlap vezérlőelemet támogató belső lapvezérlő objektumot.
CMFCPropertySheet::GetThisClass	A keretrendszer az ehhez az osztálytípushoz társított CRuntimeClass objektumra mutató mutató lekéréséhez használja.
CMFCPropertySheet::InitNavigationControl	Inicializálja az aktuális tulajdonságlap vezérlőelem megjelenését.
CMFCPropertySheet::OnActivatePage	A keretrendszer meghívja, ha engedélyezve van egy tulajdonságlap.
CMFCPropertySheet::OnDrawPageHeader	A keretrendszer meghívta, hogy egyéni tulajdonságlapfejlécet rajzoljon.
CMFCPropertySheet::OnInitDialog	Kezeli a WM_INITDIALOG üzenetet. (Felülbírálások CPropertySheet::OnInitDialog.)
CMFCPropertySheet::OnRemoveTreePage	A keretrendszer meghívta, hogy eltávolítson egy tulajdonságlapot egy fa vezérlőelemből.
CMFCPropertySheet::PreTranslateMessage	Lefordítja az ablaküzeneteket, mielőtt elküldené őket a TranslateMessage és a DispatchMessage Windows függvénybe. (Felülbírálások CPropertySheet::PreTranslateMessage.)
CMFCPropertySheet::RemoveCategory	Eltávolít egy csomópontot a fa vezérlőelemből.
CMFCPropertySheet::RemovePage	Eltávolít egy tulajdonságlapot a tulajdonságlapról.
CMFCPropertySheet::SetIconsList	Megadja az Outlook ablaktábla navigációs vezérlőjében használt képek listáját.
CMFCPropertySheet::SetLook	A tulajdonságlap megjelenését adja meg.

Megjegyzések

Az CMFCPropertySheet osztály tulajdonságlapokat, más néven tabulátor párbeszédpaneleket jelöl. Az CMFCPropertySheet osztály számos módon megjeleníthet egy tulajdonságlapot.

Az osztály alkalmazásbeli használatához hajtsa végre a CMFCPropertySheet következő lépéseket:

1. Az osztályt az CMFCPropertySheet osztályból származtatva nevezze el az osztályt, például CMyPropertySheet.

2. Hozzon létre egy CMFCPropertyPage objektumot minden tulajdonságlaphoz.

3. Hívja meg a CMFCPropertySheet::SetLook metódust a CMyPropertySheet konstruktorban. Ennek a módszernek a paramétere azt határozza meg, hogy a tulajdonságlapok lapfülként jelenjenek meg a tulajdonságlap tetején vagy bal oldalán; a Microsoft OneNote tulajdonságlapjának stílusában lévő lapok; gombok a Microsoft Outlook eszköztárvezérlőjén; csomópontok egy favezérlőn; vagy a tulajdonságlap bal oldalán található elemek listájaként.

4. Ha egy Microsoft Outlook-eszköztár stílusában hoz létre tulajdonságlapot, hívja meg a CMFCPropertySheet::SetIconsList metódust a képlisták és a tulajdonságlapok társításához.

5. Hívja meg a CMFCPropertySheet::AddPage metódust minden tulajdonságlaphoz.

6. Hozzon létre egy vezérlőt CMFCPropertySheet , és hívja meg a metódusát DoModal .

Illusztrációk

Az alábbi ábra egy beágyazott Microsoft Outlook-eszköztár stílusában található tulajdonságlapot ábrázol. Az Outlook eszköztár a tulajdonságlap bal oldalán jelenik meg.

Az alábbi ábra egy CMFCPropertyGridCtrl osztályobjektumot tartalmazó tulajdonságlapot ábrázol. Ez az objektum egy szabványos közös vezérlő tulajdonságlap stílusában lévő tulajdonságlap.

Az alábbi ábra egy fa vezérlőelem stílusában található tulajdonságlapot ábrázol.

Öröklési hierarchia

CObject

CCmdTarget

CWnd

CPropertySheet

CMFCPropertySheet

Requirements

Fejléc: afxpropertysheet.h

CMFCPropertySheet::AddPage

Hozzáad egy lapot a tulajdonságlaphoz.

void AddPage(CPropertyPage* pPage);

Paraméterek

pPage
[in] Mutató egy lapobjektumra. Ez a paraméter nem lehet NULL értékű.

Megjegyzések

Ez a metódus a tulajdonságlap jobb szélső lapjaként adja hozzá a megadott tulajdonságlapot. Ezért ezzel a módszerrel balról jobbra haladva adhat hozzá oldalakat.

Ha a tulajdonságlap a Microsoft Outlook stílusában van, a keretrendszer megjeleníti a navigációs gombok listáját a tulajdonságlap bal oldalán. Miután ezzel a módszerrel hozzáad egy tulajdonságlapot, hozzáad egy megfelelő gombot a listához. Tulajdonságlap megjelenítéséhez kattintson a megfelelő gombra. További információ a tulajdonságlapok stílusairól: CMFCPropertySheet::SetLook.

CMFCPropertySheet::AddPageToTree

Új tulajdonságlapot ad hozzá a fa vezérlőelemhez.

void AddPageToTree(
    CMFCPropertySheetCategoryInfo* pCategory,
    CMFCPropertyPage* pPage,
    int nIconNum=-1,
    int nSelIconNum=-1);

Paraméterek

pCategory
[in] Mutasson egy szülőfacsomópontra vagy NULL értékre a megadott lap legfelső szintű csomóponthoz való társításához. Hívja meg a CMFCPropertySheet::AddTreeCategory metódust a mutató beszerzéséhez.

pPage
[in] Mutató egy tulajdonságlap-objektumra.

nIconNum
[in] Ikon nullaalapú indexe, vagy -1, ha nincs ikon. Az ikon akkor jelenik meg a fa vezérlőelem tulajdonságlapja mellett, ha a lap nincs kijelölve. Az alapértelmezett érték -1.

nSelIconNum
[in] Ikon nullaalapú indexe, vagy -1, ha nincs ikon. Az ikon a fa vezérlőelem tulajdonságlapja mellett jelenik meg, amikor a lap ki van jelölve. Az alapértelmezett érték -1.

Megjegyzések

Ez a metódus egy tulajdonságlapot ad hozzá egy fa vezérlőelem levélként. Tulajdonságlap hozzáadásához hozzon létre egy CMFCPropertySheet objektumot, hívja meg a CMFCPropertySheet::SetLook metódust, amelynek a keresési paramétere be van állítva CMFCPropertySheet::PropSheetLook_Tree, majd ezzel a módszerrel adja hozzá a tulajdonságlapot.

CMFCPropertySheet::AddTreeCategory

Új csomópontot ad hozzá a favezérlőhöz.

CMFCPropertySheetCategoryInfo* AddTreeCategory(
    LPCTSTR lpszLabel,
    int nIconNum=-1,
    int nSelectedIconNum=-1,
    const CMFCPropertySheetCategoryInfo* pParentCategory=NULL);

Paraméterek

lpszLabel
[in] A csomópont neve.

nIconNum
[in] Ikon nullaalapú indexe, vagy -1, ha nincs ikon. Az ikon akkor jelenik meg a fa vezérlőelem tulajdonságlapja mellett, ha a lap nincs kijelölve. Az alapértelmezett érték -1.

nSelectedIconNum
[in] Ikon nullaalapú indexe, vagy -1, ha nincs ikon. Az ikon a fa vezérlőelem tulajdonságlapja mellett jelenik meg, amikor a lap ki van jelölve. Az alapértelmezett érték -1.

pParentCategory
[in] Mutasson egy szülőfacsomópontra vagy NULL értékre a megadott lap legfelső szintű csomóponthoz való társításához. Állítsa be ezt a paramétert a CMFCPropertySheet::AddTreeCategory metódussal.

Visszaadott érték

Mutató az új csomópontra a fa vezérlőelemben.

Megjegyzések

Ezzel a módszerrel hozzáadhat egy új csomópontot, amelyet kategóriaként is neveznek a fa vezérlőelemhez. Csomópont hozzáadásához hozzon létre egy CMFCPropertySheet objektumot, hívja meg a CMFCPropertySheet::SetLook metódust, amelynek a look paramétere be van állítva CMFCPropertySheet::PropSheetLook_Tree, majd ezzel a módszerrel adja hozzá a csomópontot.

Használja a metódus visszatérési értékét a CMFCPropertySheet::AddPageToTree és CMFCPropertySheet::AddTreeCategory hívásaiban.

CMFCPropertySheet::CMFCPropertySheet

Egy CMFCPropertySheet objektumot hoz létre.

CMFCPropertySheet(
    UINT nIDCaption,
    CWnd* pParentWnd=NULL,
    UINT iSelectPage=0);

CMFCPropertySheet(
    LPCTSTR pszCaption,
    CWnd* pParentWnd=NULL,
    UINT iSelectPage=0);

Paraméterek

pszCaption
[in] A tulajdonságlap feliratát tartalmazó sztring. Nem lehet NULL.

nIDCaption
[in] A tulajdonságlap feliratát tartalmazó erőforrás-azonosító.

pParentWnd
[in] Mutasson a tulajdonságlap szülőablakára, vagy null értékűre, ha a szülőablak az alkalmazás főablaka. Az alapértelmezett érték NULL.

iSelectPage
[in] A legfelső tulajdonságlap nulla alapú indexe. Az alapértelmezett érték 0.

Megjegyzések

További információkért tekintse meg a CPropertySheet::CPropertySheet konstruktor paramétereit.

CMFCPropertySheet::EnablePageHeader

Az egyéni fejléc rajzolásához foglal helyet az egyes lapok tetején.

void EnablePageHeader(int nHeaderHeight);

Paraméterek

nHeaderHeight
[in] Az élőfej magassága képpontban.

Megjegyzések

Ha az nHeaderHeight paraméter értékét szeretné használni egy egyéni fejléc rajzolásához, felülbírálja a CMFCPropertySheet::OnDrawPageHeader metódust .

CMFCPropertySheet::GetHeaderHeight

Lekéri az aktuális fejléc magasságát.

int GetHeaderHeight() const;

Visszaadott érték

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

Megjegyzések

Hívja meg a CMFCPropertySheet::EnablePageHeader metódust , mielőtt meghívja ezt a metódust.

CMFCPropertySheet::GetLook

Lekéri az aktuális tulajdonságlap megjelenését meghatározó enumerálási értéket.

PropSheetLook GetLook() const;

Visszaadott érték

A tulajdonságlap megjelenését meghatározó enumerálási értékek egyike. A lehetséges értékek listáját a CMFCPropertySheet:SetLook megjegyzések szakaszában találja.

CMFCPropertySheet::GetNavBarWidth

Lekéri a navigációs sáv szélességét.

int GetNavBarWidth() const;

Visszaadott érték

A navigációs sáv szélessége képpontban.

CMFCPropertySheet::GetTab

Lekéri az aktuális tulajdonságlap vezérlőelemet támogató belső lapvezérlő objektumot.

CMFCTabCtrl& GetTab() const;

Visszaadott érték

Belső lapvezérlő objektum.

Megjegyzések

Beállíthatja, hogy a tulajdonságlap különböző stílusokban jelenjen meg, például fa vezérlőelemben, navigációs gombok listájában vagy többlapos lapokban.

A metódus meghívása előtt hívja meg a CMFCPropertySheet::SetLook metódust a tulajdonságlap vezérlőelem megjelenésének beállításához. Ezután hívja meg a CMFCPropertySheet::InitNavigationControl metódust a belső lapvezérlő objektum inicializálásához. Ezzel a módszerrel lekérheti a tabulátorvezérlő objektumot, majd ezzel az objektummal dolgozhat a tulajdonságlap lapjaival.

Ez a módszer hibakeresési módban érvényes, ha a tulajdonságlap vezérlőelem nincs beállítva a Microsoft OneNote stílusában.

CMFCPropertySheet::InitNavigationControl

Inicializálja az aktuális tulajdonságlap vezérlőelem megjelenését.

virtual CWnd* InitNavigationControl();

Visszaadott érték

A tulajdonságlap vezérlőelem ablakára mutató mutató.

Megjegyzések

A tulajdonságlap vezérlőelemek több különböző formában is megjelenhetnek, például többlapos lapok, fa vezérlőelemek vagy navigációs gombok listája. Használja a CMFCPropertySheet::SetLook metódust a tulajdonságlap vezérlőelem megjelenésének megadásához.

CMFCPropertySheet::OnActivatePage

A keretrendszer meghívja, ha engedélyezve van egy tulajdonságlap.

virtual void OnActivatePage(CPropertyPage* pPage);

Paraméterek

pPage
[in] Mutasson egy tulajdonságlapobjektumra, amely az engedélyezett tulajdonságlapot jelöli.

Megjegyzések

Ez a módszer alapértelmezés szerint biztosítja, hogy az engedélyezett tulajdonságlap a nézetbe görgessen. Ha az aktuális tulajdonságlap stílusa tartalmaz Egy Microsoft Outlook-panelt, ez a metódus a megfelelő Outlook-gombot bejelölt állapotra állítja.

CMFCPropertySheet::OnDrawPageHeader

A keretrendszer meghívta, hogy megrajzolja egy egyéni tulajdonságlap fejlécét.

virtual void OnDrawPageHeader(
    CDC* pDC,
    int nPage,
    CRect rectHeader);

Paraméterek

Pdc
[in] Mutasson egy eszközkörnyezetre.

nPage
[in] A nulla alapú tulajdonság oldalszáma.

rectHeader
[in] Határolókeret, amely meghatározza, hogy hol kell rajzolni az élőfejet.

Megjegyzések

Alapértelmezés szerint ez a metódus nem tesz semmit. Ha felülbírálja ezt a metódust, hívja meg a CMFCPropertySheet::EnablePageHeader metódust , mielőtt a keretrendszer meghívja ezt a metódust.

CMFCPropertySheet::OnRemoveTreePage

A keretrendszer meghívta, hogy eltávolítson egy tulajdonságlapot egy fa vezérlőelemből.

virtual BOOL OnRemoveTreePage(CPropertyPage* pPage);

Paraméterek

pPage
[in] Mutasson egy tulajdonságlapobjektumra, amely az eltávolítani kívánt tulajdonságlapot jelöli.

Visszaadott érték

IGAZ, ha ez a módszer sikeres; egyéb esetben HAMIS.

CMFCPropertySheet::RemoveCategory

Eltávolít egy csomópontot a fa vezérlőelemből.

void RemoveCategory(CMFCPropertySheetCategoryInfo* pCategory);

Paraméterek

pCategory
[in] Az eltávolításhoz mutasson egy kategóriára (csomópontra).

Megjegyzések

Ezzel a módszerrel eltávolíthat egy csomópontot, amelyet kategóriaként is neveznek egy favezérlőből. A CMFCPropertySheet::AddTreeCategory metódussal csomópontot adhat hozzá egy favezérlőhöz.

CMFCPropertySheet::RemovePage

Eltávolít egy tulajdonságlapot a tulajdonságlapról.

void RemovePage(CPropertyPage* pPage);
void RemovePage(int nPage);

Paraméterek

pPage
[in] Mutasson az eltávolítandó tulajdonságlapot jelképező tulajdonságlap-objektumra. Nem lehet NULL.

nPage
[in] Az eltávolítandó oldal nullaalapú indexe.

Megjegyzések

Ez a metódus eltávolítja a megadott tulajdonságlapot, és megsemmisíti a hozzá tartozó ablakot. A pPage paraméter által megadott tulajdonságlap-objektum nem lesz megsemmisítve, amíg a CMFCPropertySheet ablak be nem záródik.

CMFCPropertySheet::SetIconsList

Megadja az Outlook ablaktábla navigációs vezérlőjében használt képek listáját.

BOOL SetIconsList(
    UINT uiImageListResID,
    int cx,
    COLORREF clrTransparent=RGB(255, 0, 255));
void SetIconsList(HIMAGELIST hIcons);

Paraméterek

uiImageListResID
[in] Egy képlista erőforrás-azonosítója.

Cx
[in] A képlistában lévő ikonok szélessége képpontban.

clrTransparent
[in] Az áttetsző kép színe. Az ilyen színű képrészek átlátszóak lesznek. Az alapértelmezett érték a színmágnes, RGB(255,0,255).

hIcons
[in] Egy meglévő képlista leírója.

Visszaadott érték

Az első metódus túlterhelési szintaxisa igaz, ha ez a módszer sikeres; egyéb esetben HAMIS.

Megjegyzések

Ha a tulajdonságlap a Microsoft Outlook stílusában van, a keretrendszer a tulajdonságlap bal oldalán megjeleníti az Outlook panel vezérlőelemnek nevezett navigációs gombok listáját. Ezzel a módszerrel állíthatja be a képlistát, amelyet az Outlook panel vezérlőeleme használ.

A metódust támogató metódusokról további információt a CImageList::Create and CImageList::Add című témakörben talál. A tulajdonságlap stílusának beállításáról további információt a CMFCPropertySheet::SetLook című témakörben talál.

CMFCPropertySheet::SetLook

A tulajdonságlap megjelenését adja meg.

void SetLook(
    PropSheetLook look,
    int nNavControlWidth=100);

Paraméterek

nézd
[in] A tulajdonságlap megjelenését meghatározó enumerálási értékek egyike. A tulajdonságlap alapértelmezett stílusa a következő CMFCPropertySheet::PropSheetLook_Tabs: . További információkért tekintse meg a témakör Megjegyzések szakaszában található táblázatot.

nNavControlWidth
[in] A navigációs vezérlő szélessége képpontban. Az alapértelmezett érték 100.

Megjegyzések

Ha nem az alapértelmezett stílusban szeretne megjeleníteni egy tulajdonságlapot, hívja meg ezt a metódust a tulajdonságlap ablakának létrehozása előtt.

Az alábbi táblázat a look paraméterben megadható enumerálási értékeket sorolja fel.

Érték	Description
CMFCPropertySheet::PropSheetLook_Tabs	(Alapértelmezett) Minden tulajdonságlaphoz megjelenít egy lapot. A lapok a tulajdonságlap tetején jelennek meg, és halmozódnak, ha több lap van, mint amennyi egyetlen sorban elfér.
CMFCPropertySheet::PropSheetLook_OutlookBar	Megjeleníti a navigációs gombok listáját a Microsoft Outlook sávjának stílusában, a tulajdonságlap bal oldalán. A lista minden gombja egy tulajdonságlapnak felel meg. A keretrendszer görgetőnyilakat jelenít meg, ha több gomb van, mint amennyi elfér a lista látható területén.
CMFCPropertySheet::PropSheetLook_Tree	Egy fa vezérlőelemet jelenít meg a tulajdonságlap bal oldalán. A fa vezérlőelem minden szülő- vagy gyermekcsomópontja egy tulajdonságlapnak felel meg. A keretrendszer görgetőnyilakat jelenít meg, ha több csomópont van, mint amennyi elfér a fa vezérlőelem látható területén.
CMFCPropertySheet::PropSheetLook_OneNoteTabs	Megjeleníti a Microsoft OneNote stílusában az egyes tulajdonságok lapjainak lapját. A keretrendszer lapfüleket jelenít meg a tulajdonságlap tetején, és görgető nyilakat jelenít meg, ha több lap van, mint amennyi egyetlen sorban elfér.
CMFCPropertySheet::PropSheetLook_List	Megjelenít egy listát a tulajdonságlap bal oldalán. Minden listaelem egy tulajdonságlapnak felel meg. A keretrendszer görgetőnyilakat jelenít meg, ha több listaelem van, mint amennyi elfér a lista látható területén.

Lásd még

hierarchiadiagram
osztályok
CMFCPropertyPage osztály
CMFCOutlookBar osztály