COleConvertDialog-Klasse

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

Syntax

class COleConvertDialog : public COleDialog

Member

Öffentliche Konstruktoren

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

Öffentliche Methoden

Name	Beschreibung
COleConvertDialog::D oConvert	Führt die im Dialogfeld angegebene Konvertierung aus.
COleConvertDialog::D oModal	Zeigt das Dialogfeld "OLE-Änderungselement" an.
COleConvertDialog::GetClassID	Ruft die CLSID ab, die dem ausgewählten Element zugeordnet ist.
COleConvertDialog::GetDrawAspect	Gibt an, ob ein Element als Symbol gezeichnet werden soll.
COleConvertDialog::GetIconicMetafile	Ruft ein Handle für die Metadatei ab, die der ikonischen Form dieses Elements zugeordnet ist.
COleConvertDialog::GetSelectionType	Ruft den ausgewählten Auswahltyp ab.

Öffentliche Datenmember

Name	Beschreibung
COleConvertDialog::m_cv	Eine Struktur, die das Verhalten des Dialogfelds steuert.

Hinweise

Hinweis

Der vom Anwendungs-Assistent generierte Containercode verwendet diese Klasse.

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

Vererbungshierarchie

CObject

CCmdTarget

CWnd

Cdialog

CCommonDialog

COleDialog

COleConvertDialog

Anforderungen

Kopfzeile: afxodlgs.h

COleConvertDialog::COleConvertDialog

Erstellt nur ein COleConvertDialog Objekt.

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

Parameter

pItem
Verweist auf das zu konvertierende oder aktivierte Element.

dwFlags
Creation flag, which contains any number of the following values combined using the bitwise-or operator:

• CF_SELECTCONVERTTO Gibt an, dass das Optionsfeld "Konvertieren in" anfangs ausgewählt wird, wenn das Dialogfeld aufgerufen wird. Dies ist die Standardeinstellung.

• CF_SELECTACTIVATEAS Gibt an, dass das Optionsfeld "Aktivieren unter" anfangs ausgewählt wird, wenn das Dialogfeld aufgerufen wird.

• CF_SETCONVERTDEFAULT Gibt an, dass die Klasse, deren CLSID vom clsidConvertDefault Element der m_cv Struktur angegeben wird, als Standardauswahl im Klassenlistenfeld verwendet wird, wenn das Optionsfeld "Konvertieren in" ausgewählt ist.

• CF_SETACTIVATEDEFAULT Gibt an, dass die Klasse, deren CLSID durch das clsidActivateDefault Element der m_cv Struktur angegeben wird, als Standardauswahl im Klassenlistenfeld verwendet wird, wenn das Optionsfeld "Aktivieren unter" ausgewählt ist.

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

pClassID
Verweist auf die CLSID des zu konvertierenden oder aktivierten Elements. Wenn NULL, wird die mit pItem verknüpfte CLSID verwendet.

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 Dialogfelds auf das Standard Anwendungsfenster festgelegt.

Hinweise

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

Weitere Informationen finden Sie unter CLSID-Schlüssel und der OLEUICONVERT-Struktur .

COleConvertDialog::D oConvert

Rufen Sie diese Funktion auf, nachdem sie erfolgreich von DoModal zurückgegeben wurde, um entweder ein Objekt vom Typ COleClientItem zu konvertieren oder zu aktivieren.

BOOL DoConvert(COleClientItem* pItem);

Parameter

pItem
Verweist auf das zu konvertierende oder aktivierte Element. Lässt keine NULL-Werte zu.

Rückgabewert

Ungleich Null, wenn erfolgreich, andernfalls 0 (Null).

Hinweise

Das Element wird entsprechend den vom Benutzer im Dialogfeld "Konvertieren" ausgewählten Informationen konvertiert oder aktiviert.

COleConvertDialog::D oModal

Rufen Sie diese Funktion auf, um das Dialogfeld "OLE-Konvertierung" anzuzeigen.

virtual INT_PTR DoModal();

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 OleUIConvert-Funktion im Windows SDK.

Hinweise

Wenn Sie die verschiedenen Dialogfeldsteuerelemente initialisieren möchten, indem Sie Elemente der m_cv 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 Informationen abzurufen, die vom Benutzer in das Dialogfeld eingegeben wurden.

COleConvertDialog::GetClassID

Rufen Sie diese Funktion auf, um die CLSID abzurufen, die dem Element zugeordnet ist, das der Benutzer im Dialogfeld "Konvertieren" ausgewählt hat.

REFCLSID GetClassID() const;

Rückgabewert

Die CLSID, die dem Element zugeordnet ist, das im Dialogfeld "Konvertieren" ausgewählt wurde.

Hinweise

Rufen Sie diese Funktion nur auf, nachdem DoModal IDOK zurückgegeben hat.

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

COleConvertDialog::GetDrawAspect

Rufen Sie diese Funktion auf, um zu bestimmen, 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, nachdem DoModal IDOK zurückgegeben hat.

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

COleConvertDialog::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, als das Dialogfeld durch Auswahl von "OK" geschlossen wurde; andernfalls NULL.

COleConvertDialog::GetSelectionType

Rufen Sie diese Funktion auf, um den im Dialogfeld "Konvertieren" ausgewählten Konvertierungstyp zu ermitteln.

UINT GetSelectionType() const;

Rückgabewert

Art der getroffenen Auswahl.

Hinweise

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

enum Selection {
    noConversion,
    convertItem,
    activateAs
    };

Kurze Beschreibungen dieser Werte folgen:

• COleConvertDialog::noConversion Wird zurückgegeben, wenn entweder das Dialogfeld abgebrochen wurde oder der Benutzer keine Konvertierung ausgewählt hat. Wenn COleConvertDialog::DoModal IDOK zurückgegeben wird, ist es möglich, dass der Benutzer ein anderes Symbol als das zuvor ausgewählte ausgewählt hat.

• COleConvertDialog::convertItem Wird zurückgegeben, wenn das Optionsfeld "Konvertieren in" aktiviert wurde, hat der Benutzer ein anderes Zu konvertierende Element ausgewählt und DoModal IDOK zurückgegeben.

• COleConvertDialog::activateAs Wird zurückgegeben, wenn das Optionsfeld "Aktivieren als" aktiviert wurde, hat der Benutzer ein anderes Zu aktivierende Element ausgewählt und DoModal IDOK zurückgegeben.

COleConvertDialog::m_cv

Struktur des Typs OLEUICONVERT zum Steuern des Verhaltens des Dialogfelds "Konvertieren".

OLEUICONVERT m_cv;

Hinweise

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

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

Siehe auch

COleDialog-Klasse
Hierarchiediagramm
COleDialog-Klasse