Share via

Klasse COleConvertDialog

Opmerking

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

Zie de STRUCTUUR OLEUICONVERT in de Windows SDK voor meer informatie.

Syntaxis

class COleConvertDialog : public COleDialog

Leden

Openbare constructors

Naam Description
COleConvertDialog::COleConvertDialog Maakt een COleConvertDialog object.

Openbare methoden

Naam Description
COleConvertDialog::D oConvert Hiermee wordt de conversie uitgevoerd die is opgegeven in het dialoogvenster.
COleConvertDialog::D oModal Hiermee wordt het dialoogvenster OLE-item wijzigen weergegeven.
COleConvertDialog::GetClassID Hiermee haalt u de CLSID op die is gekoppeld aan het gekozen item.
COleConvertDialog::GetDrawAspect Hiermee geeft u op of u een item als pictogram wilt tekenen.
COleConvertDialog::GetIconicMetafile Hiermee haalt u een ingang op voor het metabestand dat is gekoppeld aan de iconische vorm van dit item.
COleConvertDialog::GetSelectionType Hiermee haalt u het gekozen type selectie op.

Leden van openbare gegevens

Naam Description
COleConvertDialog::m_cv Een structuur waarmee het gedrag van het dialoogvenster wordt bepaald.

Opmerkingen

Opmerking

Toepassingswizard gegenereerde containercode maakt gebruik van deze klasse.

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

Overnamehiërarchie

CObject

CCmdTarget

CWnd

CDialog

CCommonDialog

COleDialog

COleConvertDialog

Requirements

Koptekst: afxodlgs.h

COleConvertDialog::COleConvertDialog

Maakt alleen een COleConvertDialog object.

explicit COleConvertDialog (
    COleClientItem* pItem,
    DWORD dwFlags = CF_SELECTCONVERTTO,
    CLSID* pClassID = NULL,
    CWnd* pParentWnd = NULL);

Parameterwaarden

pItem
Verwijst naar het item dat moet worden geconverteerd of geactiveerd.

dwFlags
Vlag voor maken, die een willekeurig aantal van de volgende waarden bevat, gecombineerd met behulp van de bitsgewijze operator:

  • CF_SELECTCONVERTTO Geeft aan dat het keuzerondje Converteren naar in eerste instantie wordt geselecteerd wanneer het dialoogvenster wordt aangeroepen. Dit is de standaardwaarde.

  • CF_SELECTACTIVATEAS Geeft aan dat het keuzerondje Activeren als in eerste instantie wordt geselecteerd wanneer het dialoogvenster wordt aangeroepen.

  • CF_SETCONVERTDEFAULT Geeft aan dat de klasse waarvan DE CLSID is opgegeven door het clsidConvertDefault lid van de m_cv structuur wordt gebruikt als de standaardselectie in de keuzelijst van de klasse wanneer het keuzerondje Converteren naar is geselecteerd.

  • CF_SETACTIVATEDEFAULT Geeft aan dat de klasse waarvan DE CLSID is opgegeven door het clsidActivateDefault lid van de m_cv structuur wordt gebruikt als de standaardselectie in de klassenlijst wanneer het keuzerondje Activeren als is geselecteerd.

  • CF_SHOWHELPBUTTON Geeft aan dat de knop Help wordt weergegeven wanneer het dialoogvenster wordt aangeroepen.

pClassID
Verwijst naar de CLSID van het item dat moet worden geconverteerd of geactiveerd. Als NULL, wordt de CLSID gebruikt die is gekoppeld aan pItem .

pParentWnd
Verwijst naar het bovenliggende of eigenaarvensterobject (van het type CWnd) waartoe het dialoogvensterobject behoort. Als het NULL is, wordt het bovenliggende venster van het dialoogvenster ingesteld op het hoofdtoepassingsvenster.

Opmerkingen

Als u het dialoogvenster wilt weergeven, roept u de functie DoModal aan.

Zie CLSID Key en de OLEUICONVERT-structuur voor meer informatie.

COleConvertDialog::D oConvert

Roep deze functie aan nadat deze is geretourneerd vanuit DoModal, om een object van het type COleClientItem te converteren of te activeren.

BOOL DoConvert(COleClientItem* pItem);

Parameterwaarden

pItem
Verwijst naar het item dat moet worden geconverteerd of geactiveerd. Kan niet NULL zijn.

Retourwaarde

Niet-nul indien geslaagd; anders 0.

Opmerkingen

Het item wordt geconverteerd of geactiveerd op basis van de informatie die door de gebruiker is geselecteerd in het dialoogvenster Converteren.

COleConvertDialog::D oModal

Roep deze functie aan om het dialoogvenster OLE Converteren weer te geven.

virtual INT_PTR DoModal();

Retourwaarde

Voltooiingsstatus voor het dialoogvenster. Een van de volgende waarden:

  • IDOK als het dialoogvenster is weergegeven.

  • IDCANCEL als de gebruiker het dialoogvenster heeft geannuleerd.

  • IDABORT als er een fout is opgetreden. Als IDABORT wordt geretourneerd, roept u de functie COleDialog::GetLastError-lid aan voor meer informatie over het type fout dat is opgetreden. Zie de functie OleUIConvert in de Windows SDK voor een overzicht van mogelijke fouten.

Opmerkingen

Als u de verschillende dialoogvensterbesturingselementen wilt initialiseren door leden van de m_cv structuur in te stellen, moet u dit doen voordat u aanroept DoModal, maar nadat het dialoogvensterobject is gemaakt.

Als DoModal IDOK wordt geretourneerd, kunt u andere lidfuncties aanroepen om de instellingen of informatie op te halen die door de gebruiker is ingevoerd in het dialoogvenster.

COleConvertDialog::GetClassID

Roep deze functie aan om de CLSID op te halen die is gekoppeld aan het item dat de gebruiker heeft geselecteerd in het dialoogvenster Converteren.

REFCLSID GetClassID() const;

Retourwaarde

De CLSID die is gekoppeld aan het item dat is geselecteerd in het dialoogvenster Converteren.

Opmerkingen

Roep deze functie pas aan nadat DoModal IDOK retourneert.

Zie CLSID-sleutel in de Windows SDK voor meer informatie.

COleConvertDialog::GetDrawAspect

Roep deze functie aan om te bepalen of de gebruiker ervoor heeft gekozen om het geselecteerde item weer te geven als pictogram.

DVASPECT GetDrawAspect() const;

Retourwaarde

De methode die nodig is om het object weer te geven.

  • DVASPECT_CONTENT geretourneerd als het selectievakje Weergeven als-pictogram niet is ingeschakeld.

  • DVASPECT_ICON geretourneerd als het selectievakje Weergeven als is ingeschakeld.

Opmerkingen

Roep deze functie pas aan nadat DoModal IDOK retourneert.

Zie de gegevensstructuur FORMATETC in de Windows SDK voor meer informatie over het tekenaspect.

COleConvertDialog::GetIconicMetafile

Roep deze functie aan om een ingang te krijgen voor het metabestand dat het iconische aspect van het geselecteerde item bevat.

HGLOBAL GetIconicMetafile() const;

Retourwaarde

De ingang naar het metabestand met het iconische aspect van het geselecteerde item, als het selectievakje Weergeven als pictogram is ingeschakeld toen het dialoogvenster werd gesloten door OK te kiezen; anders NULL.

COleConvertDialog::GetSelectionType

Roep deze functie aan om het type conversie te bepalen dat is geselecteerd in het dialoogvenster Converteren.

UINT GetSelectionType() const;

Retourwaarde

Type selectie gemaakt.

Opmerkingen

De retourtypewaarden worden opgegeven door het Selection opsommingstype dat in de COleConvertDialog klasse is gedeclareerd.

enum Selection {
    noConversion,
    convertItem,
    activateAs
    };

Korte beschrijvingen van deze waarden volgen:

  • COleConvertDialog::noConversion Geretourneerd als het dialoogvenster is geannuleerd of de gebruiker geen conversie heeft geselecteerd. Als COleConvertDialog::DoModal IDOK wordt geretourneerd, is het mogelijk dat de gebruiker een ander pictogram heeft geselecteerd dan het pictogram dat eerder is geselecteerd.

  • COleConvertDialog::convertItem Als het keuzerondje Converteren naar is ingeschakeld, heeft de gebruiker een ander item geselecteerd om naar te converteren en DoModal IDOK geretourneerd.

  • COleConvertDialog::activateAs Geretourneerd als het keuzerondje Activeren als is ingeschakeld, heeft de gebruiker een ander item geselecteerd om te activeren en DoModal IDOK geretourneerd.

COleConvertDialog::m_cv

Structuur van het type OLEUICONVERT dat wordt gebruikt om het gedrag van het dialoogvenster Converteren te bepalen.

OLEUICONVERT m_cv;

Opmerkingen

Leden van deze structuur kunnen rechtstreeks of via lidfuncties worden gewijzigd.

Zie de STRUCTUUR OLEUICONVERT in de Windows SDK voor meer informatie.

Zie ook

Klasse COleDialog
Hiërarchiegrafiek
Klasse COleDialog

  • Last updated on