Share via

CMFCPropertySheet-klasse

Opmerking

De Microsoft Foundation Classes-bibliotheek (MFC) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.

De CMFCPropertySheet klasse ondersteunt een eigenschappenvenster waarin elke eigenschappenpagina wordt aangeduid door een paginatab, een werkbalkknop, een structuurbesturingselementknooppunt of een lijstitem.

Syntaxis

class CMFCPropertySheet : public CPropertySheet

Leden

Openbare constructors

Naam Description
CMFCPropertySheet::CMFCPropertySheet Maakt een CMFCPropertySheet object.
CMFCPropertySheet::~CMFCPropertySheet Destructor.

Openbare methoden

Naam Description
CMFCPropertySheet::AddPage Hiermee voegt u een pagina toe aan het eigenschappenvenster.
CMFCPropertySheet::AddPageToTree Hiermee voegt u een nieuwe eigenschappenpagina toe aan het structuurbesturingselement.
CMFCPropertySheet::AddTreeCategory Hiermee voegt u een nieuw knooppunt toe aan het structuurbesturingselement.
CMFCPropertySheet::EnablePageHeader Reserveert ruimte boven aan elke pagina om een aangepaste koptekst te tekenen.
CMFCPropertySheet::GetHeaderHeight Hiermee haalt u de hoogte van de huidige koptekst op.
CMFCPropertySheet::GetLook Hiermee wordt een opsommingswaarde opgehaald die het uiterlijk van het huidige eigenschappenvenster aangeeft.
CMFCPropertySheet::GetNavBarWidth Hiermee wordt de breedte van de navigatiebalk in pixels opnieuw geprobeerd.
CMFCPropertySheet::GetTab Hiermee wordt het interne tabbesturingselementobject opgehaald dat het huidige eigenschappenvensterbesturingselement ondersteunt.
CMFCPropertySheet::GetThisClass Wordt door het framework gebruikt om een aanwijzer te verkrijgen naar het CRuntimeClass-object dat is gekoppeld aan dit klassetype.
CMFCPropertySheet::InitNavigationControl Initialiseert het uiterlijk van het huidige eigenschappenvensterbesturingselement.
CMFCPropertySheet::OnActivatePage Aangeroepen door het framework wanneer een eigenschappenpagina is ingeschakeld.
CMFCPropertySheet::OnDrawPageHeader Wordt aangeroepen door het framework om een aangepaste koptekst van de eigenschappenpagina te tekenen.
CMFCPropertySheet::OnInitDialog Hiermee wordt het WM_INITDIALOG bericht verwerkt. (Overschrijft CPropertySheet::OnInitDialog.)
CMFCPropertySheet::OnRemoveTreePage Aangeroepen door het framework om een eigenschappenpagina te verwijderen uit een structuurbesturingselement.
CMFCPropertySheet::PreTranslateMessage Hiermee worden vensterberichten vertaald voordat ze worden verzonden naar de windows-functies TranslateMessage en DispatchMessage . (Onderdrukkingen CPropertySheet::PreTranslateMessage.)
CMFCPropertySheet::RemoveCategory Hiermee verwijdert u een knooppunt uit het structuurbesturingselement.
CMFCPropertySheet::RemovePage Hiermee verwijdert u een eigenschappenpagina uit het eigenschappenvenster.
CMFCPropertySheet::SetIconsList Hiermee geeft u de lijst met afbeeldingen op die worden gebruikt in het navigatiebeheer van het Outlook-deelvenster.
CMFCPropertySheet::SetLook Hiermee geeft u het uiterlijk van het eigenschappenvenster.

Opmerkingen

De CMFCPropertySheet klasse vertegenwoordigt eigenschappenvensters, ook wel tabbladdialoogvensters genoemd. De CMFCPropertySheet klasse kan een eigenschappenpagina op verschillende manieren weergeven.

Voer de volgende stappen uit om de CMFCPropertySheet klasse in uw toepassing te gebruiken:

  1. Leid een klasse af van de CMFCPropertySheet klasse en geef de klasse een naam, bijvoorbeeld CMyPropertySheet.

  2. Maak een CMFCPropertyPage-object voor elke eigenschappenpagina.

  3. Roep de CMFCPropertySheet::SetLook-methode aan in de CMyPropertySheet-constructor. Een parameter van die methode geeft aan dat eigenschappenpagina's moeten worden weergegeven als tabbladen boven of links van het eigenschappenvenster; tabbladen in de stijl van een Microsoft OneNote-eigenschappenvenster; knoppen op een Besturingselement voor de Microsoft Outlook-werkbalk; knooppunten in een boomstructuur; of als een lijst met items aan de linkerkant van het eigenschappenvenster.

  4. Als u een eigenschappenvenster maakt in de stijl van een Microsoft Outlook-werkbalk, roept u de methode CMFCPropertySheet::SetIconsList aan om een lijst met afbeeldingen te koppelen aan de eigenschappenpagina's.

  5. Roep de CMFCPropertySheet::AddPage-methode aan voor elke eigenschappenpagina.

  6. Maak een CMFCPropertySheet besturingselement en roep de DoModal bijbehorende methode aan.

Illustraties

In de volgende afbeelding ziet u een eigenschappenvenster in de stijl van een ingesloten Microsoft Outlook-werkbalk. De Outlook-werkbalk wordt aan de linkerkant van het eigenschappenvenster weergegeven.

CMFCPropertySheet-kleurenbesturingselementen.

In de volgende afbeelding ziet u een eigenschappenvenster met een CMFCPropertyGridCtrl-klasseobject . Dat object is een eigenschappenvenster in de stijl van een standaard gemeenschappelijk eigenschappenvenster voor besturingselementen.

CmFCPropertySheet-lijst- en eigenschapsbesturingselementen.

In de volgende afbeelding ziet u een eigenschappenvenster in de stijl van een structuurbesturingselement.

Eigenschapsstructuur.

Overnamehiërarchie

CObject

CCmdTarget

CWnd

CPropertySheet

CMFCPropertySheet

Requirements

Koptekst: afxpropertysheet.h

CMFCPropertySheet::AddPage

Hiermee voegt u een pagina toe aan het eigenschappenvenster.

void AddPage(CPropertyPage* pPage);

Parameterwaarden

pPage
[in] Aanwijzer naar een paginaobject. Deze parameter kan niet NULL zijn.

Opmerkingen

Met deze methode wordt de opgegeven eigenschappenpagina toegevoegd als het meest rechtse tabblad in het eigenschappenvenster. Gebruik deze methode daarom om pagina's toe te voegen in volgorde van links naar rechts.

Als het eigenschappenvenster de stijl van Microsoft Outlook heeft, wordt in het framework links van het eigenschappenvenster een lijst met navigatieknoppen weergegeven. Nadat deze methode een eigenschappenpagina heeft toegevoegd, wordt er een bijbehorende knop aan de lijst toegevoegd. Als u een eigenschappenpagina wilt weergeven, klikt u op de bijbehorende knop. Zie CMFCPropertySheet::SetLook voor meer informatie over stijlen van eigenschappenvensters.

CMFCPropertySheet::AddPageToTree

Hiermee voegt u een nieuwe eigenschappenpagina toe aan het structuurbesturingselement.

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

Parameterwaarden

pCategory
[in] Wijs een bovenliggend structuurknooppunt of NULL aan om de opgegeven pagina te koppelen aan het knooppunt op het hoogste niveau. Roep de METHODE CMFCPropertySheet::AddTreeCategory aan om deze aanwijzer te verkrijgen.

pPage
[in] Aanwijzer naar een eigenschapspaginaobject.

nIconNum
[in] Op nul gebaseerde index van een pictogram of -1 als er geen pictogram wordt gebruikt. Het pictogram wordt weergegeven naast de eigenschappenpagina van het structuurbesturingselement wanneer de pagina niet is geselecteerd. De standaardwaarde is 1.

nSelIconNum
[in] Op nul gebaseerde index van een pictogram of -1 als er geen pictogram wordt gebruikt. Het pictogram wordt weergegeven naast de eigenschappenpagina van het structuurbesturingselement wanneer de pagina is geselecteerd. De standaardwaarde is 1.

Opmerkingen

Met deze methode wordt een eigenschappenpagina toegevoegd als een blad van een structuurbesturingselement. Als u een eigenschappenpagina wilt toevoegen, maakt u een CMFCPropertySheet object, roept u de methode CMFCPropertySheet::SetLook aan met de look-parameter ingesteld CMFCPropertySheet::PropSheetLook_Treeop en gebruikt u deze methode om de eigenschappenpagina toe te voegen.

CMFCPropertySheet::AddTreeCategory

Hiermee voegt u een nieuw knooppunt toe aan het structuurbesturingselement.

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

Parameterwaarden

lpszLabel
[in] De naam van het knooppunt.

nIconNum
[in] Op nul gebaseerde index van een pictogram of -1 als er geen pictogram wordt gebruikt. Het pictogram wordt weergegeven naast de eigenschappenpagina van het structuurbesturingselement wanneer de pagina niet is geselecteerd. De standaardwaarde is 1.

nSelectedIconNum
[in] Op nul gebaseerde index van een pictogram of -1 als er geen pictogram wordt gebruikt. Het pictogram wordt weergegeven naast de eigenschappenpagina van het structuurbesturingselement wanneer de pagina is geselecteerd. De standaardwaarde is 1.

pParentCategory
[in] Wijs een bovenliggend structuurknooppunt of NULL aan om de opgegeven pagina te koppelen aan het knooppunt op het hoogste niveau. Stel deze parameter in met de methode CMFCPropertySheet::AddTreeCategory .

Retourwaarde

Een aanwijzer naar het nieuwe knooppunt in het structuurbesturingselement.

Opmerkingen

Gebruik deze methode om een nieuw knooppunt, ook wel een categorie genoemd, toe te voegen aan het structuurbesturingselement. Als u een knooppunt wilt toevoegen, maakt u een CMFCPropertySheet object, roept u de METHODE CMFCPropertySheet::SetLook aan met de look-parameter ingesteld CMFCPropertySheet::PropSheetLook_Treeop en gebruikt u deze methode om het knooppunt toe te voegen.

Gebruik de retourwaarde van deze methode in volgende aanroepen naar CMFCPropertySheet::AddPageToTree en CMFCPropertySheet::AddTreeCategory.

CMFCPropertySheet::CMFCPropertySheet

Maakt een CMFCPropertySheet object.

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

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

Parameterwaarden

pszCaption
[in] Een tekenreeks die het bijschrift van het eigenschappenvenster bevat. Kan niet NULL zijn.

nIDCaption
[in] Een resource-id die het bijschrift van het eigenschappenvenster bevat.

pParentWnd
[in] Wijs het bovenliggende venster van het eigenschappenvenster of NULL aan als het bovenliggende venster het hoofdvenster van de toepassing is. De standaardwaarde is NULL.

iSelectPage
[in] De op nul gebaseerde index van de bovenste eigenschappenpagina. De standaardwaarde is 0.

Opmerkingen

Zie de parameters voor de CPropertySheet::CPropertySheet-constructor voor meer informatie.

CMFCPropertySheet::EnablePageHeader

Reserveert ruimte boven aan elke pagina om een aangepaste koptekst te tekenen.

void EnablePageHeader(int nHeaderHeight);

Parameterwaarden

nHeaderHeight
[in] De hoogte van de koptekst, in pixels.

Opmerkingen

Als u de waarde van de parameter nHeaderHeight wilt gebruiken om een aangepaste header te tekenen, overschrijft u de methode CMFCPropertySheet::OnDrawPageHeader .

CMFCPropertySheet::GetHeaderHeight

Hiermee haalt u de hoogte van de huidige koptekst op.

int GetHeaderHeight() const;

Retourwaarde

De hoogte van de koptekst, in pixels.

Opmerkingen

Roep de methode CMFCPropertySheet::EnablePageHeader aan voordat u deze methode aanroept.

CMFCPropertySheet::GetLook

Hiermee wordt een opsommingswaarde opgehaald die het uiterlijk van het huidige eigenschappenvenster aangeeft.

PropSheetLook GetLook() const;

Retourwaarde

Een van de opsommingswaarden die het uiterlijk van het eigenschappenvenster aangeeft. Zie de opsommingstabel in de sectie Opmerkingen van CMFCPropertySheet::SetLook voor een lijst met mogelijke waarden.

CMFCPropertySheet::GetNavBarWidth

Hiermee haalt u de breedte van de navigatiebalk op.

int GetNavBarWidth() const;

Retourwaarde

De breedte van de navigatiebalk in pixels.

CMFCPropertySheet::GetTab

Hiermee wordt het interne tabbesturingselementobject opgehaald dat het huidige eigenschappenvensterbesturingselement ondersteunt.

CMFCTabCtrl& GetTab() const;

Retourwaarde

Een intern besturingselementobject voor tabbladen.

Opmerkingen

U kunt een eigenschappenvenster zo instellen dat het in verschillende stijlen wordt weergegeven, zoals een structuurbesturingselement, een lijst met navigatieknoppen of een set pagina's met tabbladen.

Voordat u deze methode aanroept, roept u de methode CMFCPropertySheet::SetLook aan om het uiterlijk van het eigenschappenvensterbesturingselement in te stellen. Roep vervolgens de methode CMFCPropertySheet::InitNavigationControl aan om het interne tabbeheerobject te initialiseren. Gebruik deze methode om het tabbesturingselementobject op te halen en gebruik dat object vervolgens om met de tabbladen in het eigenschappenvenster te werken.

Deze methode wordt in de foutopsporingsmodus toegepast als het eigenschappenvensterbesturingselement niet is ingesteld op weergave in de stijl van Microsoft OneNote.

CMFCPropertySheet::InitNavigationControl

Initialiseert het uiterlijk van het huidige eigenschappenvensterbesturingselement.

virtual CWnd* InitNavigationControl();

Retourwaarde

Een aanwijzer naar het venster van het besturingselement eigenschappenvenster.

Opmerkingen

Een besturingselement voor het eigenschappenvenster kan worden weergegeven in verschillende formulieren, zoals een set pagina's met tabbladen, een structuurbesturingselement of een lijst met navigatieknoppen. Gebruik de methode CMFCPropertySheet::SetLook om het uiterlijk van het eigenschappenvensterbesturingselement op te geven.

CMFCPropertySheet::OnActivatePage

Aangeroepen door het framework wanneer een eigenschappenpagina is ingeschakeld.

virtual void OnActivatePage(CPropertyPage* pPage);

Parameterwaarden

pPage
[in] Wijs een eigenschapspaginaobject aan dat de pagina met ingeschakelde eigenschappen vertegenwoordigt.

Opmerkingen

Deze methode zorgt er standaard voor dat de ingeschakelde eigenschappenpagina wordt weergegeven. Als de stijl van het huidige eigenschappenvenster een Microsoft Outlook-deelvenster bevat, wordt met deze methode de bijbehorende Outlook-knop ingesteld op de ingeschakelde status.

CMFCPropertySheet::OnDrawPageHeader

Aangeroepen door het framework om de koptekst te tekenen voor een aangepaste eigenschappenpagina.

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

Parameterwaarden

Pdc
[in] Aanwijzer naar een apparaatcontext.

nPagina
[in] Het paginanummer van de eigenschap op basis van nul.

rectHeader
[in] Een begrenzingsrechthoek die aangeeft waar de koptekst moet worden getekend.

Opmerkingen

Deze methode doet standaard niets. Als u deze methode overschrijft, roept u de methode CMFCPropertySheet::EnablePageHeader aan voordat dit framework deze methode aanroept.

CMFCPropertySheet::OnRemoveTreePage

Aangeroepen door het framework om een eigenschappenpagina te verwijderen uit een structuurbesturingselement.

virtual BOOL OnRemoveTreePage(CPropertyPage* pPage);

Parameterwaarden

pPage
[in] Wijs een eigenschapspaginaobject aan dat de eigenschappenpagina vertegenwoordigt die u wilt verwijderen.

Retourwaarde

WAAR als deze methode is geslaagd; anders, ONWAAR.

CMFCPropertySheet::RemoveCategory

Hiermee verwijdert u een knooppunt uit het structuurbesturingselement.

void RemoveCategory(CMFCPropertySheetCategoryInfo* pCategory);

Parameterwaarden

pCategory
[in] Wijs een categorie (knooppunt) aan die u wilt verwijderen.

Opmerkingen

Gebruik deze methode om een knooppunt, ook wel een categorie genoemd, te verwijderen uit een structuurbesturingselement. Gebruik de methode CMFCPropertySheet::AddTreeCategory om een knooppunt toe te voegen aan een structuurbesturingselement.

CMFCPropertySheet::RemovePage

Hiermee verwijdert u een eigenschappenpagina uit het eigenschappenvenster.

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

Parameterwaarden

pPage
[in] Aanwijzer naar eigenschappenpaginaobject dat de eigenschappenpagina vertegenwoordigt die u wilt verwijderen. Kan niet NULL zijn.

nPagina
[in] Op nul gebaseerde index van de pagina die u wilt verwijderen.

Opmerkingen

Met deze methode wordt de opgegeven eigenschappenpagina verwijderd en wordt het bijbehorende venster vernietigd. Het eigenschappenpaginaobject dat door de parameter pPage wordt opgegeven, wordt pas vernietigd nadat het venster CMFCPropertySheet is gesloten.

CMFCPropertySheet::SetIconsList

Hiermee geeft u de lijst met afbeeldingen op die worden gebruikt in het navigatiebeheer van het Outlook-deelvenster.

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

Parameterwaarden

uiImageListResID
[in] De resource-id van een lijst met installatiekopieën.

Cx
[in] De breedte, in pixels, van pictogrammen in de lijst met afbeeldingen.

clrTransparent
[in] De transparante afbeeldingskleur. De delen van de afbeelding die deze kleur zijn, zijn transparant. De standaardwaarde is de kleur magenta, RGB(255,0,255).

hIcons
[in] Een ingang naar een bestaande lijst met installatiekopieën.

Retourwaarde

In de syntaxis voor overbelasting van de eerste methode is TRUE als deze methode is geslaagd; anders, ONWAAR.

Opmerkingen

Als het eigenschappenvenster de stijl van Microsoft Outlook heeft, wordt in het framework een lijst met navigatieknoppen weergegeven, het besturingselement van het Outlook-deelvenster, aan de linkerkant van het eigenschappenvenster. Gebruik deze methode om de lijst met afbeeldingen in te stellen die moet worden gebruikt door het besturingselement van het Outlook-deelvenster.

Zie CImageList::Create and CImageList::Add voor meer informatie over de methoden die deze methode ondersteunen. Zie CMFCPropertySheet::SetLook voor meer informatie over het instellen van de stijl van een eigenschappenvenster.

CMFCPropertySheet::SetLook

Hiermee geeft u het uiterlijk van het eigenschappenvenster.

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

Parameterwaarden

Kijken
[in] Een van de opsommingswaarden die het uiterlijk van het eigenschappenvenster aangeeft. De standaardstijl voor een eigenschappenvenster is CMFCPropertySheet::PropSheetLook_Tabs. Zie de tabel in de sectie Opmerkingen van dit onderwerp voor meer informatie.

nNavControlWidth
[in] De breedte van het navigatie-besturingselement, in pixels. De standaardwaarde is 100.

Opmerkingen

Als u een eigenschappenvenster in een andere stijl dan de standaardstijl wilt weergeven, roept u deze methode aan voordat u het eigenschappenvenster maakt.

De volgende tabel bevat de opsommingswaarden die kunnen worden opgegeven in de look-parameter .

Waarde Description
CMFCPropertySheet::PropSheetLook_Tabs (Standaard) Geeft een tabblad weer voor elke eigenschappenpagina. Tabbladen worden boven aan het eigenschappenvenster weergegeven en worden gestapeld als er meer tabbladen zijn dan in één rij past.
CMFCPropertySheet::PropSheetLook_OutlookBar Hiermee wordt een lijst met navigatieknoppen weergegeven, in de stijl van de Microsoft Outlook-balk, aan de linkerkant van het eigenschappenvenster. Elke knop in de lijst komt overeen met een eigenschappenpagina. In het framework worden schuifpijlen weergegeven als er meer knoppen zijn dan in het zichtbare gebied van de lijst past.
CMFCPropertySheet::PropSheetLook_Tree Geeft een structuurbesturingselement aan de linkerkant van het eigenschappenvenster weer. Elk bovenliggend of onderliggend knooppunt van het structuurbesturingselement komt overeen met een eigenschappenpagina. In het framework worden schuifpijlen weergegeven als er meer knooppunten zijn dan in het zichtbare gebied van het structuurbesturingselement past.
CMFCPropertySheet::PropSheetLook_OneNoteTabs Geeft een tabblad weer, in de stijl van Microsoft OneNote, voor elke eigenschappenpagina. In het framework worden tabbladen boven aan het eigenschappenvenster weergegeven en schuifpijlen als er meer tabbladen zijn dan in één rij past.
CMFCPropertySheet::PropSheetLook_List Geeft een lijst aan de linkerkant van het eigenschappenvenster weer. Elk lijstitem komt overeen met een eigenschappenpagina. In het framework worden schuifpijlen weergegeven als er meer lijstitems zijn dan past in het zichtbare gebied van de lijst.

Zie ook

Hiërarchiegrafiek
Klassen
CMFCPropertyPage-klasse
KLASSE CMFCOutlookBar

  • Last updated on