Klasse COlePropertiesDialog

Opmerking

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

Hiermee wordt het dialoogvenster Algemene OLE-objecteigenschappen van Windows ingekapseld.

Syntaxis

class COlePropertiesDialog : public COleDialog

Leden

Openbare constructors

Naam	Description
COlePropertiesDialog::COlePropertiesDialog	Maakt een COlePropertiesDialog object.

Openbare methoden

Naam	Description
COlePropertiesDialog::D oModal	Hiermee wordt het dialoogvenster weergegeven en kan de gebruiker een selectie maken.
COlePropertiesDialog::OnApplyScale	Aangeroepen door het framework wanneer het schalen van het documentitem is gewijzigd.

Leden van openbare gegevens

Naam	Description
COlePropertiesDialog::m_gp	Een structuur die wordt gebruikt om de pagina Algemeen van een COlePropertiesDialog object te initialiseren.
COlePropertiesDialog::m_lp	Een structuur die wordt gebruikt om de pagina Koppeling van een COlePropertiesDialog object te initialiseren.
COlePropertiesDialog::m_op	Een structuur die wordt gebruikt om het COlePropertiesDialog object te initialiseren.
COlePropertiesDialog::m_psh	Een structuur die wordt gebruikt om extra aangepaste eigenschappenpagina's toe te voegen.
COlePropertiesDialog::m_vp	Een structuur die wordt gebruikt om de pagina Weergave van een COlePropertiesDialog object aan te passen.

Opmerkingen

Algemene dialoogvensters ole-objecteigenschappen bieden een eenvoudige manier om de eigenschappen van een OLE-documentitem weer te geven en te wijzigen op een manier die consistent is met Windows-standaarden. Deze eigenschappen omvatten onder andere informatie over het bestand dat wordt vertegenwoordigd door het documentitem, opties voor het weergeven van het pictogram en het schalen van afbeeldingen en informatie over de koppeling van het item (als het item is gekoppeld).

Als u een COlePropertiesDialog object wilt gebruiken, maakt u eerst het object met behulp van de COlePropertiesDialog constructor. Nadat het dialoogvenster is gemaakt, roept u de DoModal lidfunctie aan om het dialoogvenster weer te geven en kan de gebruiker alle eigenschappen van het item wijzigen. DoModal retourneert of de gebruiker de knop OK (IDOK) of Annuleren (IDCANCEL) heeft geselecteerd. Naast de knoppen OK en Annuleren is er een knop Toepassen. Wanneer de gebruiker Toepassen selecteert, worden alle wijzigingen in de eigenschappen van het documentitem toegepast op het item en wordt de bijbehorende afbeelding automatisch bijgewerkt, maar blijft actief.

Het m_psh gegevenslid is een verwijzing naar een PROPSHEETHEADER structuur en in de meeste gevallen hoeft u deze niet expliciet te openen. Een uitzondering hierop is wanneer u meer eigenschappenpagina's nodig hebt dan de standaardpagina's Algemeen, Weergave en Koppeling. In dit geval kunt u het m_psh gegevenslid wijzigen zodat deze uw aangepaste pagina's bevat voordat u de DoModal lidfunctie aanroept.

Zie het artikel Dialoogvensters in OLE voor meer informatie over OLE-dialoogvensters.

Overnamehiërarchie

CObject

CCmdTarget

CWnd

CDialog

CCommonDialog

COleDialog

COlePropertiesDialog

Requirements

Koptekst: afxodlgs.h

COlePropertiesDialog::COlePropertiesDialog

Hiermee maakt u een COlePropertiesDialog object.

COlePropertiesDialog(
    COleClientItem* pItem,
    UINT nScaleMin = 10,
    UINT nScaleMax = 500,
    CWnd* pParentWnd = NULL);

Parameterwaarden

pItem
Wijs het documentitem aan waarvan de eigenschappen worden geopend.

nScaleMin
Minimaal schaalpercentage voor de afbeelding van het documentitem.

nScaleMax
Maximumschalingspercentage voor de afbeelding van het documentitem.

pParentWnd
Wijs de bovenliggende of eigenaar van het dialoogvenster aan.

Opmerkingen

De algemene dialoogvensterklasse OLE-objecteigenschappen afleiden van COlePropertiesDialog waaruit u schaalaanpassing voor uw documentitems wilt implementeren. Dialoogvensters die door een exemplaar van deze klasse worden geïmplementeerd, bieden geen ondersteuning voor het schalen van het documentitem.

Standaard bevat het dialoogvenster Algemene OLE-objecteigenschappen drie standaardpagina's:

• General

  Deze pagina bevat systeeminformatie voor het bestand dat wordt vertegenwoordigd door het geselecteerde documentitem. Op deze pagina kan de gebruiker het geselecteerde item converteren naar een ander type.

• Bekijk

  Deze pagina bevat opties voor het weergeven van het item, het wijzigen van het pictogram en het wijzigen van de schaal van de afbeelding.

• Koppeling

  Deze pagina bevat opties voor het wijzigen van de locatie van het gekoppelde item en het bijwerken van het gekoppelde item. Op deze pagina kan de gebruiker de koppeling van het geselecteerde item verbreken.

Als u pagina's wilt toevoegen buiten de standaardvariabele, wijzigt u de m_psh lidvariabele voordat u de constructor van uw COlePropertiesDialog-afgeleide klasse afsluit. Dit is een geavanceerde implementatie van de COlePropertiesDialog constructor.

COlePropertiesDialog::D oModal

Roep deze lidfunctie aan om het dialoogvenster Algemene OLE-objecteigenschappen van Windows weer te geven en de gebruiker de verschillende eigenschappen van het documentitem te laten weergeven en/of te wijzigen.

virtual INT_PTR DoModal();

Retourwaarde

IDOK of IDCANCEL indien geslaagd; anders 0. IDOK en IDCANCEL zijn constanten die aangeven of de gebruiker de knop OK of Annuleren heeft geselecteerd.

Als IDCANCEL wordt geretourneerd, kunt u de functie Windows CommDlgExtendedError aanroepen om te bepalen of er een fout is opgetreden.

COlePropertiesDialog::m_gp

Een structuur van het type OLEUIGNRLPROPS, die wordt gebruikt om de pagina Algemeen van het dialoogvenster OLE-objecteigenschappen te initialiseren.

OLEUIGNRLPROPS m_gp;

Opmerkingen

Op deze pagina ziet u het type en de grootte van een insluiting en heeft de gebruiker toegang tot het dialoogvenster Converteren. Op deze pagina wordt ook het koppelingsdoel weergegeven als het object een koppeling is.

Zie de Windows SDK voor meer informatie over de OLEUIGNRLPROPS structuur.

COlePropertiesDialog::m_lp

Een structuur van het type OLEUILINKPROPS, die wordt gebruikt om de pagina Koppeling van het dialoogvenster OLE-objecteigenschappen te initialiseren.

OLEUILINKPROPS m_lp;

Opmerkingen

Op deze pagina ziet u de locatie van het gekoppelde item en kan de gebruiker de koppeling naar het item bijwerken of verbreken.

Zie de Windows SDK voor meer informatie over de OLEUILINKPROPS structuur.

COlePropertiesDialog::m_op

Een structuur van het type OLEUIOBJECTPROPS, die wordt gebruikt om het algemene dialoogvenster OLE-objecteigenschappen te initialiseren.

OLEUIOBJECTPROPS m_op;

Opmerkingen

Deze structuur bevat leden die worden gebruikt om de pagina's Algemeen, Koppeling en Weergave te initialiseren.

Zie de structuren OLEUIOBJECTPROPS en OLEUILINKPROPS in de Windows SDK voor meer informatie.

COlePropertiesDialog::m_psh

Een structuur van het type PROPSHEETHEADER, waarvan leden de kenmerken van het dialoogvensterobject opslaan.

PROPSHEETHEADER m_psh;

Opmerkingen

Nadat u een COlePropertiesDialog object hebt gemaakt, kunt m_psh u verschillende aspecten van het dialoogvenster instellen voordat u de DoModal lidfunctie aanroept.

Als u het m_psh gegevenslid rechtstreeks wijzigt, overschrijft u het standaardgedrag.

Zie de Windows SDK voor meer informatie over de PROPSHEETHEADER structuur.

COlePropertiesDialog::m_vp

Een structuur van het type OLEUIVIEWPROPS, die wordt gebruikt om de weergavepagina van het dialoogvenster OLE-objecteigenschappen te initialiseren.

OLEUIVIEWPROPS m_vp;

Opmerkingen

Op deze pagina kan de gebruiker schakelen tussen 'inhoud' en 'iconische' weergaven van het object en kan de schaal binnen de container worden gewijzigd. Hiermee heeft de gebruiker ook toegang tot het dialoogvenster Pictogram wijzigen wanneer het object wordt weergegeven als pictogram.

Zie de Windows SDK voor meer informatie over de OLEUIVIEWPROPS structuur.

COlePropertiesDialog::OnApplyScale

Aangeroepen door het framework wanneer de schaalwaarde is gewijzigd en OK of Toepassen is geselecteerd.

virtual BOOL OnApplyScale(
    COleClientItem* pItem,
    int nCurrentScale,
    BOOL bRelativeToOrig);

Parameterwaarden

pItem
Wijs het documentitem aan waarvan de eigenschappen worden geopend.

nCurrentScale
Numerieke waarde van de dialoogvensterschaal.

bRelativeToOrig
Hiermee wordt aangegeven of schalen van toepassing is op de oorspronkelijke grootte van het documentitem.

Retourwaarde

Niet-nul indien verwerkt; anders 0.

Opmerkingen

De standaard implementatie doet niets. U moet deze functie overschrijven om de besturingselementen voor schalen in te schakelen.

Opmerking

Voordat het dialoogvenster Algemene OLE-objecteigenschappen wordt weergegeven, roept het framework deze functie aan met een NULL voor pItem en a - 1 voor nCurrentScale. Dit wordt gedaan om te bepalen of de schaalbesturingselementen moeten worden ingeschakeld.

Zie ook

MFC-voorbeeld-CIRC
Klasse COleDialog
Hiërarchiegrafiek
Klasse COleDialog
Klasse CPropertyPage