CDataPathProperty-Klasse
Implementiert eine OLE-Steuerelementeigenschaft, die asynchron geladen werden kann.
Syntax
class CDataPathProperty : public CAsyncMonikerFile
Member
Öffentliche Konstruktoren
| Name | Beschreibung |
|---|---|
| CDataPathProperty::CDataPathProperty | Erstellt ein CDataPathProperty-Objekt. |
Öffentliche Methoden
| Name | Beschreibung |
|---|---|
| CDataPathProperty::GetControl | Ruft das asynchrone OLE-Steuerelement ab, das dem CDataPathProperty Objekt zugeordnet ist. |
| CDataPathProperty::GetPath | Ruft den Pfadnamen der Eigenschaft ab. |
| CDataPathProperty::Open | Initiiert das Laden der asynchronen Eigenschaft für das zugeordnete ActiveX -Steuerelement (OLE). |
| CDataPathProperty::ResetData | Aufrufe CAsyncMonikerFile::OnDataAvailable zum Benachrichtigen des Containers, dass sich die Steuerelementeigenschaften geändert haben. |
| CDataPathProperty::SetControl | Legt das asynchrone ActiveX-Steuerelement (OLE) fest, das der Eigenschaft zugeordnet ist. |
| CDataPathProperty::SetPath | Legt den Pfadnamen der Eigenschaft fest. |
Hinweise
Asynchrone Eigenschaften werden nach synchroner Initiierung geladen.
Die Klasse CDataPathProperty wird von CAysncMonikerFile. Um asynchrone Eigenschaften in Ihren OLE-Steuerelementen zu implementieren, leiten Sie eine Klasse ab CDataPathProperty, und überschreiben Sie OnDataAvailable.
Weitere Informationen zur Verwendung asynchroner Moniker und ActiveX-Steuerelemente in Internetanwendungen finden Sie in den folgenden Artikeln:
Vererbungshierarchie
CDataPathProperty
Anforderungen
Kopfzeile: afxctl.h
CDataPathProperty::CDataPathProperty
Erstellt ein CDataPathProperty-Objekt.
CDataPathProperty(COleControl* pControl = NULL);
CDataPathProperty(LPCTSTR lpszPath, COleControl* pControl = NULL);
Parameter
pControl
Ein Zeiger auf das OLE-Steuerelementobjekt, das diesem CDataPathProperty Objekt zugeordnet werden soll.
lpszPath
Der Pfad, der absolut oder relativ sein kann, um einen asynchronen Moniker zu erstellen, der auf die tatsächliche absolute Position der Eigenschaft verweist. CDataPathProperty verwendet URLs, nicht Dateinamen. Wenn Sie ein CDataPathProperty Objekt für eine Datei verwenden möchten, stellen file:// Sie dem Pfad voran.
Hinweise
Das COleControl objekt, auf das von pControl verwiesen wird, wird von Open abgeleiteten Klassen verwendet und abgerufen. Wenn pControl NULL ist, sollte das verwendete Open Steuerelement mit SetControlfestgelegt werden. Wenn lpszPath NULL ist, können Sie den Pfad durchlaufen Open oder mit SetPath.
CDataPathProperty::GetControl
Rufen Sie diese Memberfunktion auf, um das COleControl dem CDataPathProperty Objekt zugeordnete Objekt abzurufen.
COleControl* GetControl();
Rückgabewert
Gibt einen Zeiger auf das OLE-Steuerelement zurück, das dem CDataPathProperty Objekt zugeordnet ist. NULL, wenn kein Steuerelement zugeordnet ist.
CDataPathProperty::GetPath
Rufen Sie diese Memberfunktion auf, um den Pfad abzurufen, festzulegen, wann das CDataPathProperty Objekt erstellt oder angegeben oder in einem vorherigen Aufruf der SetPath Memberfunktion angegeben Openwurde.
CString GetPath() const;
Rückgabewert
Gibt den Pfadnamen an die Eigenschaft selbst zurück. Kann leer sein, wenn kein Pfad angegeben wurde.
CDataPathProperty::Open
Rufen Sie diese Memberfunktion auf, um das Laden der asynchronen Eigenschaft für das zugeordnete Steuerelement zu initiieren.
virtual BOOL Open(
COleControl* pControl,
CFileException* pError = NULL);
virtual BOOL Open(
LPCTSTR lpszPath,
COleControl* pControl,
CFileException* pError = NULL);
virtual BOOL Open(
LPCTSTR lpszPath,
CFileException* pError = NULL);
virtual BOOL Open(CFileException* pError = NULL);
Parameter
pControl
Ein Zeiger auf das OLE-Steuerelementobjekt, das diesem CDataPathProperty Objekt zugeordnet werden soll.
pError
Ein Zeiger auf eine Datei exception. Im Falle eines Fehlers wird auf die Ursache festgelegt.
lpszPath
Der Pfad, der absolut oder relativ sein kann, um einen asynchronen Moniker zu erstellen, der auf die tatsächliche absolute Position der Eigenschaft verweist. CDataPathProperty verwendet URLs, nicht Dateinamen. Wenn Sie ein CDataPathProperty Objekt für eine Datei verwenden möchten, stellen file:// Sie dem Pfad voran.
Rückgabewert
Ungleich Null, wenn erfolgreich, andernfalls 0 (Null).
Hinweise
Die Funktion versucht, die IBindHost Schnittstelle vom Steuerelement abzurufen.
Vor dem Aufrufen Open ohne Pfad muss der Wert für den Pfad der Eigenschaft festgelegt werden. Dies kann beim Erstellen des Objekts oder durch Aufrufen der SetPath Memberfunktion erfolgen.
Vor dem Aufrufen Open ohne ein Steuerelement kann dem Objekt ein ActiveX-Steuerelement (früher als OLE-Steuerelement bezeichnet) zugeordnet werden. Dies kann beim Erstellen des Objekts oder durch Aufrufen SetControlerfolgen.
Alle Überladungen von CAsyncMonikerFile::Open sind ebenfalls verfügbar von CDataPathProperty.
CDataPathProperty::ResetData
Rufen Sie diese Funktion auf CAsyncMonikerFile::OnDataAvailable , um den Container zu benachrichtigen, dass sich die Steuerelementeigenschaften geändert haben, und alle asynchron geladenen Informationen sind nicht mehr nützlich.
virtual void ResetData();
Hinweise
Das Öffnen sollte neu gestartet werden. Abgeleitete Klassen können diese Funktion für unterschiedliche Standardwerte überschreiben.
CDataPathProperty::SetControl
Rufen Sie diese Memberfunktion auf, um dem Objekt ein asynchrones OLE-Steuerelement CDataPathProperty zuzuordnen.
void SetControl(COleControl* pControl);
Parameter
pControl
Ein Zeiger auf das asynchrone OLE-Steuerelement, das der Eigenschaft zugeordnet werden soll.
CDataPathProperty::SetPath
Rufen Sie diese Memberfunktion auf, um den Pfadnamen der Eigenschaft festzulegen.
void SetPath(LPCTSTR lpszPath);
Parameter
lpszPath
Ein Pfad, der absolut oder relativ zu der Eigenschaft sein kann, die asynchron geladen wird. CDataPathProperty verwendet URLs, nicht Dateinamen. Wenn Sie ein CDataPathProperty Objekt für eine Datei verwenden möchten, stellen file:// Sie dem Pfad voran.
Siehe auch
MFC-Beispielbild
CAsyncMonikerFile-Klasse
Hierarchiediagramm
CAsyncMonikerFile-Klasse