COleChangeSourceDialog-Klasse
Wird für das OLE-Dialogfeld "Quelle ändern" verwendet.
Syntax
class COleChangeSourceDialog : public COleDialog
Member
Öffentliche Konstruktoren
| Name | Beschreibung |
|---|---|
| COleChangeSourceDialog::COleChangeSourceDialog | Erstellt ein COleChangeSourceDialog-Objekt. |
Öffentliche Methoden
| Name | Beschreibung |
|---|---|
| COleChangeSourceDialog::D oModal | Zeigt das Dialogfeld "OLE-Quelle ändern" an. |
| COleChangeSourceDialog::GetDisplayName | Ruft den vollständigen Quellanzeigenamen ab. |
| COleChangeSourceDialog::GetFileName | Ruft den Dateinamen aus dem Quellnamen ab. |
| COleChangeSourceDialog::GetFromPrefix | Ruft das Präfix der vorherigen Quelle ab. |
| COleChangeSourceDialog::GetItemName | Ruft den Elementnamen aus dem Quellnamen ab. |
| COleChangeSourceDialog::GetToPrefix | Ruft das Präfix der neuen Quelle ab. |
| COleChangeSourceDialog::IsValidSource | Gibt an, ob die Quelle gültig ist. |
Öffentliche Datenmember
| Name | Beschreibung |
|---|---|
| COleChangeSourceDialog::m_cs | Eine Struktur, die das Verhalten des Dialogfelds steuert. |
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
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:
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.