Klasse COlePropertyPage

Opmerking

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

Wordt gebruikt om de eigenschappen van een aangepast besturingselement weer te geven in een grafische interface, vergelijkbaar met een dialoogvenster.

Syntaxis

class AFX_NOVTABLE COlePropertyPage : public CDialog

Leden

Openbare constructors

Naam	Description
COlePropertyPage::COlePropertyPage	Maakt een COlePropertyPage object.

Openbare methoden

Naam	Description
COlePropertyPage::GetControlStatus	Geeft aan of de gebruiker de waarde in het besturingselement heeft gewijzigd.
COlePropertyPage::GetObjectArray	Retourneert de matrix van objecten die worden bewerkt door de eigenschappenpagina.
COlePropertyPage::GetPageSite	Hiermee wordt een aanwijzer geretourneerd naar de interface van IPropertyPageSite de eigenschappenpagina.
COlePropertyPage::IgnoreApply	Bepaalt welke besturingselementen de knop Toepassen niet inschakelen.
COlePropertyPage::IsModified	Geeft aan of de gebruiker de eigenschappenpagina heeft gewijzigd.
COlePropertyPage::OnEditProperty	Aangeroepen door het framework wanneer de gebruiker een eigenschap bewerkt.
COlePropertyPage::OnHelp	Aangeroepen door het framework wanneer de gebruiker help aanroept.
COlePropertyPage::OnInitDialog	Aangeroepen door het framework wanneer de eigenschappenpagina wordt geïnitialiseerd.
COlePropertyPage::OnObjectsChanged	Aangeroepen door het framework wanneer een ander OLE-besturingselement, met nieuwe eigenschappen, wordt gekozen.
COlePropertyPage::OnSetPageSite	Aangeroepen door het framework wanneer het eigenschappenframe de site van de pagina levert.
COlePropertyPage::SetControlStatus	Hiermee stelt u een vlag in die aangeeft of de gebruiker de waarde in het besturingselement heeft gewijzigd.
COlePropertyPage::SetDialogResource	Hiermee stelt u de dialoogvensterresource van de eigenschappenpagina in.
COlePropertyPage::SetHelpInfo	Hiermee stelt u de korte Help-tekst van de eigenschappenpagina, de naam van het Help-bestand en de help-context in.
COlePropertyPage::SetModifiedFlag	Hiermee stelt u een vlag in die aangeeft of de gebruiker de eigenschappenpagina heeft gewijzigd.
COlePropertyPage::SetPageName	Hiermee stelt u de naam van de eigenschapspagina (bijschrift) in.

Opmerkingen

Een eigenschappenpagina kan bijvoorbeeld een besturingselement voor bewerken bevatten waarmee de gebruiker de bijschrifteigenschap van het besturingselement kan bekijken en wijzigen.

Elke aangepaste eigenschap of voorraadbesturingselement kan een dialoogvenster hebben waarmee de gebruiker van het besturingselement de huidige eigenschapswaarde kan bekijken en die waarde indien nodig kan wijzigen.

Zie het artikel ActiveX-besturingselementen: Eigenschappenpagina's voor meer informatie over het gebruikCOlePropertyPage.

Overnamehiërarchie

CObject

CCmdTarget

CWnd

CDialog

COlePropertyPage

Requirements

Koptekst: afxctl.h

COlePropertyPage::COlePropertyPage

Maakt een COlePropertyPage object.

COlePropertyPage(
    UINT idDlg,
    UINT idCaption);

Parameterwaarden

idDlg
Resource-id van de dialoogvenstersjabloon.

idCaption
Resource-id van het bijschrift van de eigenschapspagina.

Opmerkingen

Wanneer u een subklasse COlePropertyPageimplementeert, moet de constructor van uw subklasse de COlePropertyPage constructor gebruiken om de dialoogvenstersjabloonresource te identificeren waarop de eigenschappenpagina is gebaseerd en de tekenreeksresource met het bijschrift.

COlePropertyPage::GetControlStatus

Bepaalt of de gebruiker de waarde van het eigenschappenpaginabesturingselement heeft gewijzigd met de opgegeven resource-id.

BOOL GetControlStatus(UINT nID);

Parameterwaarden

nID-
Resource-id van een eigenschapspaginabesturingselement.

Retourwaarde

WAAR als de waarde van het besturingselement is gewijzigd; anders ONWAAR.

COlePropertyPage::GetObjectArray

Retourneert de matrix van objecten die worden bewerkt door de eigenschappenpagina.

LPDISPATCH* GetObjectArray(ULONG* pnObjects);

Parameterwaarden

pnObjects
Aanwijzer naar een niet-ondertekend lang geheel getal dat het aantal objecten ontvangt dat door de pagina wordt bewerkt.

Retourwaarde

Aanwijzer naar een matrix met IDispatch aanwijzers, die worden gebruikt voor toegang tot de eigenschappen van elk besturingselement op de eigenschappenpagina. De aanroeper mag deze interfacepointers niet vrijgeven.

Opmerkingen

Elk eigenschappenpaginaobject onderhoudt een matrix met aanwijzers naar de IDispatch interfaces van de objecten die door de pagina worden bewerkt. Met deze functie wordt het argument pnObjects ingesteld op het aantal elementen in die matrix en wordt een aanwijzer geretourneerd naar het eerste element van de matrix.

COlePropertyPage::GetPageSite

Hiermee haalt u een aanwijzer op naar de interface van IPropertyPageSite de eigenschappenpagina.

LPPROPERTYPAGESITE GetPageSite();

Retourwaarde

Een aanwijzer naar de interface van IPropertyPageSite de eigenschappenpagina.

Opmerkingen

Besturingselementen en containers werken samen, zodat gebruikers door eigenschappen van besturingselementen kunnen bladeren en bewerken. Het besturingselement bevat eigenschappenpagina's, die elk een OLE-object zijn waarmee de gebruiker een gerelateerde set eigenschappen kan bewerken. De container biedt een eigenschappenframe waarin de eigenschappenpagina's worden weergegeven. Voor elke pagina biedt het eigenschappenframe een paginasite die ondersteuning biedt voor de IPropertyPageSite interface.

COlePropertyPage::IgnoreApply

Bepaalt welke besturingselementen de knop Toepassen niet inschakelen.

void IgnoreApply(UINT nID);

Parameterwaarden

nID-
Id van het besturingselement dat moet worden genegeerd.

Opmerkingen

De knop Toepassen van de eigenschapspagina is alleen ingeschakeld wanneer de waarden van eigenschappenpaginabesturingselementen zijn gewijzigd. Gebruik deze functie om besturingselementen op te geven die ervoor zorgen dat de knop Toepassen niet wordt ingeschakeld wanneer de waarden worden gewijzigd.

COlePropertyPage::IsModified

Bepaalt of de gebruiker waarden op de eigenschappenpagina heeft gewijzigd.

BOOL IsModified();

Retourwaarde

WAAR als de eigenschappenpagina is gewijzigd.

COlePropertyPage::OnEditProperty

In het framework wordt deze functie aangeroepen wanneer een specifieke eigenschap moet worden bewerkt.

virtual BOOL OnEditProperty(DISPID dispid);

Parameterwaarden

ontspied
Verzend-id van de eigenschap die wordt bewerkt.

Retourwaarde

De standaard implementatie retourneert FALSE. Onderdrukkingen van deze functie moeten TRUE retourneren.

Opmerkingen

U kunt deze overschrijven om de focus in te stellen op het juiste besturingselement op de pagina. De standaard implementatie doet niets en retourneert FALSE.

COlePropertyPage::OnHelp

Dit framework roept deze functie aan wanneer de gebruiker online-help vraagt.

virtual BOOL OnHelp(LPCTSTR lpszHelpDir);

Parameterwaarden

lpszHelpDir
Map met het Help-bestand van de eigenschappenpagina.

Retourwaarde

De standaard implementatie retourneert FALSE.

Opmerkingen

Overschrijf deze als de eigenschappenpagina speciale actie moet uitvoeren wanneer de gebruiker hulp nodig heeft. De standaard implementatie doet niets en retourneert FALSE, waardoor het framework WinHelp moet aanroepen.

COlePropertyPage::OnInitDialog

Dit framework roept deze functie aan wanneer het dialoogvenster van de eigenschappenpagina wordt geïnitialiseerd.

virtual BOOL OnInitDialog();

Retourwaarde

De standaard implementatie retourneert FALSE.

Opmerkingen

Overschrijven als een speciale actie is vereist wanneer het dialoogvenster wordt geïnitialiseerd. De standaard-implementatie roept CDialog::OnInitDialog aan en retourneert FALSE.

COlePropertyPage::OnObjectsChanged

Aangeroepen door het framework wanneer een ander OLE-besturingselement, met nieuwe eigenschappen, wordt gekozen.

virtual void OnObjectsChanged();

Opmerkingen

Wanneer u de eigenschappen van een OLE-besturingselement in de ontwikkelaarsomgeving bekijkt, wordt een modusloos dialoogvenster gebruikt om de eigenschappenpagina's weer te geven. Als een ander besturingselement is geselecteerd, moet er een andere set eigenschappenpagina's worden weergegeven voor de nieuwe set eigenschappen. Dit framework roept deze functie aan om de eigenschappenpagina van de wijziging op de hoogte te stellen.

Overschrijf deze functie om een melding van deze actie te ontvangen en speciale acties uit te voeren.

COlePropertyPage::OnSetPageSite

Dit framework roept deze functie aan wanneer het eigenschappenframe de paginasite van de eigenschappenpagina levert.

virtual void OnSetPageSite();

Opmerkingen

De standaard implementatie laadt het bijschrift van de pagina en probeert de grootte van de pagina te bepalen vanuit de dialoogvensterresource. Overschrijf deze functie als uw eigenschappenpagina verdere actie vereist; uw onderdrukking moet de basisklasse-implementatie aanroepen.

COlePropertyPage::SetControlStatus

Hiermee wijzigt u de status van een eigenschappenpaginabesturingselement.

BOOL SetControlStatus(
    UINT nID,
    BOOL bDirty);

Parameterwaarden

nID-
Bevat de id van een eigenschapspaginabesturingselement.

bDirty
Hiermee geeft u op of een veld van de eigenschappenpagina is gewijzigd. Ingesteld op TRUE als het veld is gewijzigd, ONWAAR als het niet is gewijzigd.

Retourwaarde

WAAR, als het opgegeven besturingselement is ingesteld; anders ONWAAR.

Opmerkingen

Als de status van een eigenschappenpaginabesturingselement vuil is wanneer de eigenschappenpagina wordt gesloten of als de knop Toepassen is gekozen, wordt de eigenschap van het besturingselement bijgewerkt met de juiste waarde.

COlePropertyPage::SetDialogResource

Hiermee stelt u de dialoogvensterresource van de eigenschappenpagina in.

void SetDialogResource(HGLOBAL hDialog);

Parameterwaarden

hDialog
Verwerken naar de dialoogvensterresource van de eigenschappenpagina.

COlePropertyPage::SetHelpInfo

Hiermee geeft u informatie over knopinfo, de bestandsnaam van de Help en de Help-context voor uw eigenschappenpagina.

void SetHelpInfo(
    LPCTSTR lpszDocString,
    LPCTSTR lpszHelpFile = NULL,
    DWORD dwHelpContext = 0);

Parameterwaarden

lpszDocString
Een tekenreeks met korte Help-informatie voor weergave op een statusbalk of een andere locatie.

lpszHelpFile
Naam van het Help-bestand van de eigenschappenpagina.

dwHelpContext
Help-context voor de eigenschappenpagina.

COlePropertyPage::SetModifiedFlag

Geeft aan of de gebruiker de eigenschappenpagina heeft gewijzigd.

void SetModifiedFlag(BOOL bModified = TRUE);

Parameterwaarden

bModified
Hiermee geeft u de nieuwe waarde op voor de gewijzigde vlag van de eigenschappenpagina.

COlePropertyPage::SetPageName

Hiermee stelt u de naam van de eigenschappenpagina in, die doorgaans wordt weergegeven op het tabblad van de pagina.

void SetPageName(LPCTSTR lpszPageName);

Parameterwaarden

lpszPageName
Wijs een tekenreeks aan die de naam van de eigenschapspagina bevat.

Zie ook

MFC-voorbeeld CIRC3
MFC-voorbeeldTESTHELP
CDialog-klasse
Hiërarchiegrafiek
CDialog-klasse