Klasse COleInsertDialog

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 voor het dialoogvenster OLE-object invoegen.

Syntaxis

class COleInsertDialog : public COleDialog

Leden

Openbare constructors

Naam	Description
COleInsertDialog::COleInsertDialog	Maakt een COleInsertDialog object.

Openbare methoden

Naam	Description
COleInsertDialog::CreateItem	Hiermee maakt u het item dat in het dialoogvenster is geselecteerd.
COleInsertDialog::D oModal	Hiermee wordt het dialoogvenster OLE-object invoegen weergegeven.
COleInsertDialog::GetClassID	Hiermee haalt u de CLSID op die is gekoppeld aan het gekozen item.
COleInsertDialog::GetDrawAspect	Hiermee wordt aangegeven of het item moet worden getekend als pictogram.
COleInsertDialog::GetIconicMetafile	Hiermee haalt u een ingang op voor het metabestand dat is gekoppeld aan de iconische vorm van dit item.
COleInsertDialog::GetPathName	Hiermee haalt u het volledige pad op naar het bestand dat u in het dialoogvenster hebt gekozen.
COleInsertDialog::GetSelectionType	Hiermee wordt het type object opgehaald dat is geselecteerd.

Leden van openbare gegevens

Naam	Description
COleInsertDialog::m_io	Een structuur van het type OLEUIINSERTOBJECT waarmee het gedrag van het dialoogvenster wordt bepaald.

Opmerkingen

Maak een object van klasse COleInsertDialog wanneer u dit dialoogvenster wilt aanroepen. Nadat een COleInsertDialog object is gemaakt, kunt u de m_io structuur gebruiken om de waarden of statussen van besturingselementen in het dialoogvenster te initialiseren. De m_io structuur is van het type OLEUIINSERTOBJECT. Zie de functie DoModal-lid voor meer informatie over het gebruik van deze dialoogvensterklasse.

Opmerking

Toepassingswizard gegenereerde containercode maakt gebruik van deze klasse.

Zie de structuur OLEUIINSERTOBJECT in de Windows SDK voor meer informatie.

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

Overnamehiërarchie

CObject

CCmdTarget

CWnd

CDialog

CCommonDialog

COleDialog

COleInsertDialog

Requirements

Koptekst: afxodlgs.h

COleInsertDialog::COleInsertDialog

Met deze functie wordt alleen een COleInsertDialog object samengesteld.

COleInsertDialog (
    DWORD dwFlags = IOF_SELECTCREATENEW,
    CWnd* pParentWnd = NULL);

Parameterwaarden

dwFlags
Vlag maken die een willekeurig aantal van de volgende waarden bevat die moeten worden gecombineerd met behulp van de operator bitwise-OR:

• IOF_SHOWHELP Geeft aan dat de Knop Help wordt weergegeven wanneer het dialoogvenster wordt aangeroepen.

• IOF_SELECTCREATENEW Geeft aan dat het keuzerondje Nieuw maken in eerste instantie wordt geselecteerd wanneer het dialoogvenster wordt aangeroepen. Dit is de standaardinstelling en kan niet worden gebruikt met IOF_SELECTCREATEFROMFILE.

• IOF_SELECTCREATEFROMFILE Geeft aan dat het keuzerondje Bestand maken in eerste instantie wordt geselecteerd wanneer het dialoogvenster wordt aangeroepen. Kan niet worden gebruikt met IOF_SELECTCREATENEW.

• IOF_CHECKLINK Geeft aan dat het selectievakje Koppeling in eerste instantie wordt ingeschakeld wanneer het dialoogvenster wordt aangeroepen.

• IOF_DISABLELINK Geeft aan dat het selectievakje Koppeling wordt uitgeschakeld wanneer het dialoogvenster wordt aangeroepen.

• IOF_CHECKDISPLAYASICON Geeft aan dat het selectievakje Weergeven als-pictogram in eerste instantie wordt ingeschakeld, wordt het huidige pictogram weergegeven en wordt de knop Pictogram wijzigen ingeschakeld wanneer het dialoogvenster wordt aangeroepen.

• IOF_VERIFYSERVERSEXIST Geeft aan dat het dialoogvenster de klassen moet valideren die het aan de keuzelijst toevoegt door ervoor te zorgen dat de servers die zijn opgegeven in de registratiedatabase bestaan voordat het dialoogvenster wordt weergegeven. Als u deze vlag instelt, kunnen de prestaties aanzienlijk afnemen.

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 dialoogvensterobject ingesteld op het hoofdtoepassingsvenster.

Opmerkingen

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

COleInsertDialog::CreateItem

Roep deze functie aan om alleen een object van het type COleClientItem te maken als DoModal IDOK retourneert.

BOOL CreateItem(COleClientItem* pItem);

Parameterwaarden

pItem
Verwijst naar het item dat moet worden gemaakt.

Retourwaarde

Niet-nul als item is gemaakt; anders 0.

Opmerkingen

U moet het COleClientItem object toewijzen voordat u deze functie kunt aanroepen.

COleInsertDialog::D oModal

Roep deze functie aan om het dialoogvenster OLE-object invoegen weer te geven.

virtual INT_PTR
    DoModal();

INT_PTR
    DoModal(DWORD  dwFlags);

Parameterwaarden

dwFlags
Een van de volgende waarden:

COleInsertDialog::DocObjectsOnly voegt alleen DocObjects in.

COleInsertDialog::ControlsOnly voegt alleen ActiveX-besturingselementen in.

Nul voegt geen DocObject of een ActiveX-besturingselement in. Deze waarde resulteert in dezelfde implementatie als het eerste prototype dat hierboven wordt vermeld.

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 OleUIInsertObject in de Windows SDK voor een lijst met mogelijke fouten.

Opmerkingen

Als u de verschillende dialoogvensterbesturingselementen wilt initialiseren door leden van de m_io 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-invoer op te halen in het dialoogvenster door de gebruiker.

COleInsertDialog::GetClassID

Roep deze functie aan om de CLSID alleen aan het geselecteerde item te koppelen als DoModal IDOK retourneert en het selectietype is COleInsertDialog::createNewItem.

REFCLSID GetClassID() const;

Retourwaarde

Retourneert de CLSID die is gekoppeld aan het geselecteerde item.

Opmerkingen

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

COleInsertDialog::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 alleen aan als DoModal IDOK retourneert.

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

COleInsertDialog::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.

COleInsertDialog::GetPathName

Roep deze functie aan om het volledige pad van het geselecteerde bestand alleen op te halen als DoModal IDOK retourneert en het selectietype niet COleInsertDialog::createNewItemis.

CString GetPathName() const;

Retourwaarde

Het volledige pad naar het bestand dat is geselecteerd in het dialoogvenster. Als het selectietype is createNewItem, retourneert deze functie een betekenisloos CString in de releasemodus of veroorzaakt deze een verklaring in de foutopsporingsmodus.

COleInsertDialog::GetSelectionType

Roep deze functie aan om het gekozen selectietype op te halen wanneer het dialoogvenster Object invoegen is gesloten door OK te kiezen.

UINT GetSelectionType() const;

Retourwaarde

Type selectie gemaakt.

Opmerkingen

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

enum Selection {
    createNewItem,
    insertFromFile,
    linkToFile
    };

Korte beschrijvingen van deze waarden volgen:

• COleInsertDialog::createNewItem Het keuzerondje Nieuwe maken is geselecteerd.

• COleInsertDialog::insertFromFile Het keuzerondje Bestand maken is ingeschakeld en het selectievakje Koppeling is niet ingeschakeld.

• COleInsertDialog::linkToFile Het keuzerondje Bestand maken is geselecteerd en het selectievakje Koppeling is ingeschakeld.

COleInsertDialog::m_io

Structuur van het type OLEUIINSERTOBJECT dat wordt gebruikt om het gedrag van het dialoogvenster Object invoegen te bepalen.

OLEUIINSERTOBJECT m_io;

Opmerkingen

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

Zie de structuur OLEUIINSERTOBJECT in de Windows SDK voor meer informatie.

Zie ook

MFC-voorbeeld-OCLIENT
Klasse COleDialog
Hiërarchiegrafiek
Klasse COleDialog