Freigeben über

COleInsertDialog-Klasse

  • Artikel

Wird für das OLE-Dialogfeld "Objekt einfügen" verwendet.

Syntax

class COleInsertDialog : public COleDialog

Member

Öffentliche Konstruktoren

Name Beschreibung
COleInsertDialog::COleInsertDialog Erstellt ein COleInsertDialog-Objekt.

Öffentliche Methoden

Name Beschreibung
COleInsertDialog::CreateItem Erstellt das im Dialogfeld ausgewählte Element.
COleInsertDialog::D oModal Zeigt das Dialogfeld "OLE-Objekt einfügen" an.
COleInsertDialog::GetClassID Ruft die CLSID ab, die dem ausgewählten Element zugeordnet ist.
COleInsertDialog::GetDrawAspect Gibt an, ob das Element als Symbol gezeichnet werden soll.
COleInsertDialog::GetIconicMetafile Ruft ein Handle für die Metadatei ab, die der ikonischen Form dieses Elements zugeordnet ist.
COleInsertDialog::GetPathName Ruft den vollständigen Pfad zur im Dialogfeld ausgewählten Datei ab.
COleInsertDialog::GetSelectionType Ruft den Typ des ausgewählten Objekts ab.

Öffentliche Datenmember

Name Beschreibung
COleInsertDialog::m_io Eine Struktur vom Typ OLEUIINSERTOBJECT, die das Verhalten des Dialogfelds steuert.

Hinweise

Erstellen Sie ein Klassenobjekt COleInsertDialog , wenn Sie dieses Dialogfeld aufrufen möchten. Nachdem ein COleInsertDialog Objekt erstellt wurde, können Sie die m_io Struktur verwenden, um die Werte oder Zustände von Steuerelementen im Dialogfeld zu initialisieren. Die m_io Struktur ist vom Typ OLEUIINSERTOBJECT. Weitere Informationen zur Verwendung dieser Dialogklasse finden Sie in der DoModal-Memberfunktion .

Hinweis

Der vom Anwendungs-Assistent generierte Containercode verwendet diese Klasse.

Weitere Informationen finden Sie in der OLEUIINSERTOBJECT-Struktur im Windows SDK.

Weitere Informationen zu OLE-spezifischen Dialogfeldern finden Sie im Artikel Dialogfelder in OLE.

Vererbungshierarchie

CObject

CCmdTarget

CWnd

Cdialog

CCommonDialog

COleDialog

COleInsertDialog

Anforderungen

Kopfzeile: afxodlgs.h

COleInsertDialog::COleInsertDialog

Diese Funktion erstellt nur ein COleInsertDialog Objekt.

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

Parameter

dwFlags
Creation flag that contains any number of the following values to be combined using the bitwise-OR operator:

  • IOF_SHOWHELP Gibt an, dass die Schaltfläche "Hilfe" angezeigt wird, wenn das Dialogfeld aufgerufen wird.

  • IOF_SELECTCREATENEW Gibt an, dass das Optionsfeld "Neu erstellen" anfangs ausgewählt wird, wenn das Dialogfeld aufgerufen wird. Dies ist die Standardeinstellung und kann nicht mit IOF_SELECTCREATEFROMFILE verwendet werden.

  • IOF_SELECTCREATEFROMFILE Gibt an, dass das Optionsfeld "Aus Datei erstellen" anfänglich ausgewählt wird, wenn das Dialogfeld aufgerufen wird. Kann nicht mit IOF_SELECTCREATENEW verwendet werden.

  • IOF_CHECKLINK Gibt an, dass das Kontrollkästchen "Verknüpfung" anfangs aktiviert wird, wenn das Dialogfeld aufgerufen wird.

  • IOF_DISABLELINK Gibt an, dass das Kontrollkästchen "Link" deaktiviert wird, wenn das Dialogfeld aufgerufen wird.

  • IOF_CHECKDISPLAYASICON Gibt an, dass das Kontrollkästchen "Als Symbol anzeigen" anfangs aktiviert wird, das aktuelle Symbol angezeigt wird, und die Schaltfläche "Symbol ändern" wird aktiviert, wenn das Dialogfeld aufgerufen wird.

  • IOF_VERIFYSERVERSEXIST Gibt an, dass das Dialogfeld die Klassen überprüfen soll, die dem Listenfeld hinzugefügt werden, indem sichergestellt wird, dass die in der Registrierungsdatenbank angegebenen Server vorhanden sind, bevor das Dialogfeld angezeigt wird. Das Festlegen dieses Flags kann die Leistung erheblich beeinträchtigen.

pParentWnd
Verweist auf das übergeordnete oder Besitzerfensterobjekt (vom Typ CWnd), zu dem das Dialogobjekt gehört. Wenn es NULL ist, wird das übergeordnete Fenster des Dialogfeldobjekts auf das Standard Anwendungsfenster festgelegt.

Hinweise

Rufen Sie zum Anzeigen des Dialogfelds die DoModal-Funktion auf.

COleInsertDialog::CreateItem

Rufen Sie diese Funktion auf, um ein Objekt vom Typ "COleClientItem " nur zu erstellen, wenn DoModal IDOK zurückgibt.

BOOL CreateItem(COleClientItem* pItem);

Parameter

pItem
Verweist auf das zu erstellende Element.

Rückgabewert

Nonzero, wenn das Element erstellt wurde; andernfalls 0.

Hinweise

Sie müssen das COleClientItem Objekt zuordnen, bevor Sie diese Funktion aufrufen können.

COleInsertDialog::D oModal

Rufen Sie diese Funktion auf, um das Dialogfeld OLE-Objekt einfügen anzuzeigen.

virtual INT_PTR
    DoModal();

INT_PTR
    DoModal(DWORD  dwFlags);

Parameter

dwFlags
Einer der folgenden Werte:

COleInsertDialog::DocObjectsOnly fügt nur DocObjects ein.

COleInsertDialog::ControlsOnly Fügt nur ActiveX-Steuerelemente ein.

Null fügt weder ein DocObject noch ein ActiveX-Steuerelement ein. Dieser Wert führt zu derselben Implementierung wie der erste oben aufgeführte Prototyp.

Rückgabewert

Abschlussstatus für das Dialogfeld. Einer der folgenden Werte:

  • IDOK, wenn das Dialogfeld erfolgreich angezeigt wurde.

  • IDCANCEL, wenn der Benutzer das Dialogfeld abgebrochen hat.

  • IDABORT, wenn ein Fehler aufgetreten ist. Wenn IDABORT zurückgegeben wird, rufen Sie die COleDialog::GetLastError-Memberfunktion auf, um weitere Informationen zum Typ des aufgetretenen Fehlers zu erhalten. Eine Auflistung möglicher Fehler finden Sie in der OleUIInsertObject-Funktion im Windows SDK.

Hinweise

Wenn Sie die verschiedenen Dialogfeldsteuerelemente initialisieren möchten, indem Sie Elemente der m_io-Struktur festlegen, sollten Sie dies vor dem Aufrufen DoModalausführen, aber nach dem Erstellen des Dialogobjekts.

Wenn DoModal IDOK zurückgegeben wird, können Sie andere Memberfunktionen aufrufen, um die Einstellungen oder Informationseingaben vom Benutzer in das Dialogfeld abzurufen.

COleInsertDialog::GetClassID

Rufen Sie diese Funktion auf, um die CLSID abzurufen, die dem ausgewählten Element zugeordnet ist, nur wenn DoModal IDOK zurückgibt und der Auswahltyp lautet COleInsertDialog::createNewItem.

REFCLSID GetClassID() const;

Rückgabewert

Gibt die CLSID zurück, die dem ausgewählten Element zugeordnet ist.

Hinweise

Weitere Informationen finden Sie unter CLSID-Schlüssel im Windows SDK.

COleInsertDialog::GetDrawAspect

Rufen Sie diese Funktion auf, um festzustellen, ob der Benutzer das ausgewählte Element als Symbol anzeigt.

DVASPECT GetDrawAspect() const;

Rückgabewert

Die Methode, die zum Rendern des Objekts erforderlich ist.

  • DVASPECT_CONTENT zurückgegeben, wenn das Kontrollkästchen "Als Symbol anzeigen" nicht aktiviert wurde.

  • DVASPECT_ICON zurückgegeben, wenn das Kontrollkästchen "Als Symbol anzeigen" aktiviert wurde.

Hinweise

Rufen Sie diese Funktion nur auf, wenn DoModal IDOK zurückgibt.

Weitere Informationen zum Zeichnungsaspekt finden Sie unter FORMATTC-Datenstruktur im Windows SDK.

COleInsertDialog::GetIconicMetafile

Rufen Sie diese Funktion auf, um ein Handle für die Metadatei abzurufen, die den ikonischen Aspekt des ausgewählten Elements enthält.

HGLOBAL GetIconicMetafile() const;

Rückgabewert

Das Handle für die Metadatei, die den ikonischen Aspekt des ausgewählten Elements enthält, wenn das Kontrollkästchen "Als Symbol anzeigen" aktiviert wurde, wenn das Dialogfeld durch Auswahl von "OK" geschlossen wurde; andernfalls NULL.

COleInsertDialog::GetPathName

Rufen Sie diese Funktion auf, um den vollständigen Pfad der ausgewählten Datei nur abzurufen, wenn DoModal IDOK zurückgibt und der Auswahltyp nicht COleInsertDialog::createNewItemist.

CString GetPathName() const;

Rückgabewert

Der vollständige Pfad zur im Dialogfeld ausgewählten Datei. Wenn der Auswahltyp lautet createNewItem, gibt diese Funktion im Releasemodus eine bedeutungslose CString Funktion zurück oder verursacht eine Assertion im Debugmodus.

COleInsertDialog::GetSelectionType

Rufen Sie diese Funktion auf, um den Auswahltyp abzurufen, der beim Schließen des Dialogfelds "Objekt einfügen" durch Auswählen von "OK" ausgewählt wurde.

UINT GetSelectionType() const;

Rückgabewert

Art der getroffenen Auswahl.

Hinweise

Die Rückgabetypwerte werden durch den Selection in der COleInsertDialog Klasse deklarierten Enumerationstyp angegeben.

enum Selection {
    createNewItem,
    insertFromFile,
    linkToFile
    };

Kurze Beschreibungen dieser Werte folgen:

  • COleInsertDialog::createNewItem Das Optionsfeld "Neu erstellen" wurde ausgewählt.

  • COleInsertDialog::insertFromFile Das Optionsfeld "Aus Datei erstellen" wurde aktiviert, und das Kontrollkästchen "Link" wurde nicht aktiviert.

  • COleInsertDialog::linkToFile Das Optionsfeld "Aus Datei erstellen" wurde aktiviert, und das Kontrollkästchen "Link" wurde aktiviert.

COleInsertDialog::m_io

Struktur des Typs OLEUIINSERTOBJECT zum Steuern des Verhaltens des Dialogfelds "Objekt einfügen".

OLEUIINSERTOBJECT m_io;

Hinweise

Elemente dieser Struktur können entweder direkt oder über Memberfunktionen geändert werden.

Weitere Informationen finden Sie in der OLEUIINSERTOBJECT-Struktur im Windows SDK.

Siehe auch

MFC-Beispiel-OCLIENT
COleDialog-Klasse
Hierarchiediagramm
COleDialog-Klasse