CDataPathProperty-Klasse

  • Artikel

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

CObject

Cfile

COleStreamFile

CMonikerFile

CAsyncMonikerFile

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