COleChangeSourceDialog-Klasse

Wird für das OLE-Dialogfeld "Quelle ändern" verwendet.

Syntax

class COleChangeSourceDialog : public COleDialog

Member

Öffentliche Konstruktoren

Öffentliche Methoden

Öffentliche Datenmember

Hinweise

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

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

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

Vererbungshierarchie

CObject

CCmdTarget

CWnd

CDialog

CCommonDialog

COleDialog

COleChangeSourceDialog

Anforderungen

Kopfzeile: afxodlgs.h

COleChangeSourceDialog::COleChangeSourceDialog

Diese Funktion erstellt ein COleChangeSourceDialog Objekt.

explicit COleChangeSourceDialog(
    COleClientItem* pItem,
    CWnd* pParentWnd = NULL);

Parameter

pItem
Zeiger auf das verknüpfte COleClientItem-Objekt , dessen Quelle aktualisiert werden soll.

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 Hauptanwendungsfenster festgelegt.

Hinweise

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

Weitere Informationen finden Sie in der OLEUICHANGESOURCE-Struktur und der OleUIChangeSource-Funktion im Windows SDK.

COleChangeSourceDialog::D oModal

Rufen Sie diese Funktion auf, um das Dialogfeld "OLE-Quelle ändern" 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 OleUIChangeSource-Funktion im Windows SDK.

Hinweise

Wenn Sie die verschiedenen Dialogfeldsteuerelemente initialisieren möchten, indem Sie Elemente der m_cs 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 Memberfunktionen aufrufen, um vom Benutzer eingegebene Einstellungen oder Informationen aus dem Dialogfeld abzurufen. Die folgende Liste benennt typische Abfragefunktionen:

• GetFileName

• GetDisplayName

• GetItemName

COleChangeSourceDialog::GetDisplayName

Rufen Sie diese Funktion auf, um den vollständigen Anzeigenamen für das verknüpfte Clientelement abzurufen.

CString GetDisplayName();

Rückgabewert

Der vollständige Quellanzeigename (Moniker) für das im Konstruktor angegebene COleClientItem.The complete source display name (moniker) for the COleClientItem specified in the constructor.

COleChangeSourceDialog::GetFileName

Rufen Sie diese Funktion auf, um den Dateimonikerteil des Anzeigenamens für das verknüpfte Clientelement abzurufen.

CString GetFileName();

Rückgabewert

Der Dateimoniker-Teil des Quellanzeigenamens für das im Konstruktor angegebene COleClientItem .

Hinweise

Der Dateimoniker zusammen mit dem Element moniker gibt den vollständigen Anzeigenamen.

COleChangeSourceDialog::GetFromPrefix

Rufen Sie diese Funktion auf, um die vorherige Präfixzeichenfolge für die Quelle abzurufen.

CString GetFromPrefix();

Rückgabewert

Die vorherige Präfixzeichenfolge der Quelle.

Hinweise

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

Dieser Wert stammt direkt aus dem lpszFrom Element der OLEUICHANGESOURCE-Struktur .

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

COleChangeSourceDialog::GetItemName

Rufen Sie diese Funktion auf, um den Elementmonikerteil des Anzeigenamens für das verknüpfte Clientelement abzurufen.

CString GetItemName();

Rückgabewert

Der Elementmonikerteil des Quellanzeigenamens für das im Konstruktor angegebene COleClientItem.The item moniker portion of the source display name for the COleClientItem specified in the constructor.

Hinweise

Der Dateimoniker zusammen mit dem Element moniker gibt den vollständigen Anzeigenamen.

COleChangeSourceDialog::GetToPrefix

Rufen Sie diese Funktion auf, um die neue Präfixzeichenfolge für die Quelle abzurufen.

CString GetToPrefix();

Rückgabewert

Die neue Präfixzeichenfolge der Quelle.

Hinweise

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

Dieser Wert stammt direkt aus dem lpszTo Element der OLEUICHANGESOURCE-Struktur .

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

COleChangeSourceDialog::m_cs

Dieses Datenelement ist eine Struktur vom Typ OLEUICHANGESOURCE.

OLEUICHANGESOURCE m_cs;

Hinweise

OLEUICHANGESOURCE wird verwendet, um das Verhalten des Dialogfelds "OLE-Quelle ändern" zu steuern. Elemente dieser Struktur können direkt geändert werden.

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

COleChangeSourceDialog::IsValidSource

Rufen Sie diese Funktion auf, um zu ermitteln, ob die neue Quelle gültig ist.

BOOL IsValidSource();

Rückgabewert

Nonzero, wenn die neue Quelle gültig ist, andernfalls 0.

Hinweise

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

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

Siehe auch

COleDialog-Klasse
Hierarchiediagramm
COleDialog-Klasse