Klasa CDataPathProperty

Implementuje właściwość kontrolki OLE, którą można załadować asynchronicznie.

Składnia

class CDataPathProperty : public CAsyncMonikerFile

Elementy członkowskie

Konstruktory publiczne

Nazwa/nazwisko	opis
CDataPathProperty::CDataPathProperty	CDataPathProperty Tworzy obiekt.

Metody publiczne

Nazwa/nazwisko	opis
CDataPathProperty::GetControl	Pobiera asynchroniczną kontrolkę OLE skojarzona z obiektem CDataPathProperty .
CDataPathProperty::GetPath	Pobiera nazwę ścieżki właściwości.
CDataPathProperty::Open	Inicjuje ładowanie właściwości asynchronicznej dla skojarzonej kontrolki ActiveX (OLE).
CDataPathProperty::ResetData	Wywołania CAsyncMonikerFile::OnDataAvailable w celu powiadomienia kontenera o zmianie właściwości kontrolki.
CDataPathProperty::SetControl	Ustawia asynchroniczną kontrolkę ActiveX (OLE) skojarzona z właściwością.
CDataPathProperty::SetPath	Ustawia nazwę ścieżki właściwości.

Uwagi

Właściwości asynchroniczne są ładowane po synchronicznej inicjacji.

Klasa CDataPathProperty pochodzi z CAysncMonikerFileklasy . Aby zaimplementować właściwości asynchroniczne w kontrolkach OLE, należy utworzyć klasę z CDataPathPropertyklasy i zastąpić wartość OnDataAvailable.

Aby uzyskać więcej informacji na temat używania asynchronicznych kontrolek monikers i ActiveX w aplikacjach internetowych, zobacz następujące artykuły:

• Pierwsze kroki internetowe: kontrolki ActiveX

• Pierwsze kroki internetowe: Asynchroniczne Monikers

Hierarchia dziedziczenia

Obiekt CObject

CFile

COleStreamFile

CMonikerFile

CAsyncMonikerFile

CDataPathProperty

Wymagania

Nagłówek: afxctl.h

CDataPathProperty::CDataPathProperty

CDataPathProperty Tworzy obiekt.

CDataPathProperty(COleControl* pControl = NULL);
CDataPathProperty(LPCTSTR lpszPath, COleControl* pControl = NULL);

Parametry

pControl
Wskaźnik do obiektu kontrolki OLE, który ma być skojarzony z tym CDataPathProperty obiektem.

lpszPath
Ścieżka, która może być bezwzględna lub względna, użyta do utworzenia asynchronicznego monikera odwołującego się do rzeczywistej bezwzględnej lokalizacji właściwości. CDataPathProperty używa adresów URL, a nie nazw plików. Jeśli chcesz, CDataPathProperty aby obiekt dla pliku był poprzedzany file:// ścieżką.

Uwagi

Obiekt COleControl wskazywany przez element pControl jest używany przez Open klasy pochodne i pobierany przez nie. Jeśli pControl ma wartość NULL, kontrolka używana z elementem Open powinna być ustawiona na SetControlwartość . Jeśli parametr lpszPath ma wartość NULL, możesz przekazać ścieżkę przez Open lub ustawić ją za pomocą polecenia SetPath.

CDataPathProperty::GetControl

Wywołaj tę funkcję składową, aby pobrać COleControl obiekt skojarzony z obiektem CDataPathProperty .

COleControl* GetControl();

Wartość zwracana

Zwraca wskaźnik do kontrolki OLE skojarzonej z obiektem CDataPathProperty . Wartość NULL, jeśli nie jest skojarzona kontrolka.

CDataPathProperty::GetPath

Wywołaj tę funkcję składową, aby pobrać ścieżkę, ustawić, kiedy CDataPathProperty obiekt został skonstruowany lub określony w Openelemencie , lub określony w poprzednim wywołaniu funkcji składowej SetPath .

CString GetPath() const;

Wartość zwracana

Zwraca nazwę ścieżki do samej właściwości. Może być pusty, jeśli nie określono żadnej ścieżki.

CDataPathProperty::Open

Wywołaj tę funkcję składową, aby zainicjować ładowanie właściwości asynchronicznej dla skojarzonej kontrolki.

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);

Parametry

pControl
Wskaźnik do obiektu kontrolki OLE, który ma być skojarzony z tym CDataPathProperty obiektem.

pError
Wskaźnik do wyjątku pliku. W przypadku błędu zostanie ustawiona przyczyna.

lpszPath
Ścieżka, która może być bezwzględna lub względna, użyta do utworzenia asynchronicznego monikera odwołującego się do rzeczywistej bezwzględnej lokalizacji właściwości. CDataPathProperty używa adresów URL, a nie nazw plików. Jeśli chcesz, CDataPathProperty aby obiekt dla pliku był poprzedzany file:// ścieżką.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie 0.

Uwagi

Funkcja próbuje uzyskać IBindHost interfejs z kontrolki.

Przed wywołaniem Open bez ścieżki należy ustawić wartość dla ścieżki właściwości. Można to zrobić, gdy obiekt jest skonstruowany lub przez wywołanie funkcji składowej SetPath .

Przed wywołaniem Open bez kontrolki z obiektem może być skojarzona kontrolka ActiveX (wcześniej znana jako kontrolka OLE). Można to zrobić, gdy obiekt jest skonstruowany lub przez wywołanie metody SetControl.

Wszystkie przeciążenia pliku CAsyncMonikerFile::Open są również dostępne w witrynie CDataPathProperty.

CDataPathProperty::ResetData

Wywołaj tę funkcję, aby uzyskać CAsyncMonikerFile::OnDataAvailable powiadomienie kontenera o zmianie właściwości kontrolki, a wszystkie informacje załadowane asynchronicznie nie są już przydatne.

virtual void ResetData();

Uwagi

Otwarcie powinno zostać uruchomione ponownie. Klasy pochodne mogą zastąpić tę funkcję dla różnych wartości domyślnych.

CDataPathProperty::SetControl

Wywołaj tę funkcję składową, aby skojarzyć asynchroniczną kontrolkę OLE z obiektem CDataPathProperty .

void SetControl(COleControl* pControl);

Parametry

pControl
Wskaźnik do asynchronicznej kontrolki OLE, która ma być skojarzona z właściwością.

CDataPathProperty::SetPath

Wywołaj tę funkcję składową, aby ustawić nazwę pathname właściwości.

void SetPath(LPCTSTR lpszPath);

Parametry

lpszPath
Ścieżka, która może być bezwzględna lub względna, do właściwości ładowanej asynchronicznie. CDataPathProperty używa adresów URL, a nie nazw plików. Jeśli chcesz, CDataPathProperty aby obiekt dla pliku był poprzedzany file:// ścieżką.

Zobacz też

Przykładowy obraz MFC
Klasa CAsyncMonikerFile
Wykres hierarchii
Klasa CAsyncMonikerFile