Kelas CDataPathProperty

Menerapkan properti kontrol OLE yang dapat dimuat secara asinkron.

Sintaks

class CDataPathProperty : public CAsyncMonikerFile

Anggota

Konstruktor Publik

Nama	Deskripsi
CDataPathProperty::CDataPathProperty	Membuat CDataPathProperty objek.

Metode Publik

Nama	Deskripsi
CDataPathProperty::GetControl	Mengambil kontrol OLE asinkron yang terkait dengan CDataPathProperty objek.
CDataPathProperty::GetPath	Mengambil nama jalur properti.
CDataPathProperty::Open	Memulai pemuatan properti asinkron untuk kontrol ActiveX (OLE) terkait.
CDataPathProperty::ResetData	CAsyncMonikerFile::OnDataAvailable Panggilan untuk memberi tahu kontainer bahwa properti kontrol telah berubah.
CDataPathProperty::SetControl	Mengatur kontrol ActiveX asinkron (OLE) yang terkait dengan properti .
CDataPathProperty::SetPath	Mengatur nama jalur properti.

Keterangan

Properti asinkron dimuat setelah inisiasi sinkron.

Kelas CDataPathProperty ini berasal dari CAysncMonikerFile. Untuk menerapkan properti asinkron dalam kontrol OLE Anda, dapatkan kelas dari CDataPathProperty, dan ambil alih OnDataAvailable.

Untuk informasi selengkapnya tentang cara menggunakan moniker asinkron dan kontrol ActiveX di aplikasi Internet, lihat artikel berikut ini:

• Langkah Pertama Internet: Kontrol ActiveX

• Langkah Pertama Internet: Monikers Asinkron

Hierarki Warisan

CObject

CFile

COleStreamFile

CMonikerFile

CAsyncMonikerFile

CDataPathProperty

Persyaratan

Header: afxctl.h

CDataPathProperty::CDataPathProperty

Membuat CDataPathProperty objek.

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

Parameter

pControl
Penunjuk ke objek kontrol OLE yang akan dikaitkan dengan objek ini CDataPathProperty .

lpszPath
Jalur, yang mungkin absolut atau relatif, digunakan untuk membuat moniker asinkron yang mereferensikan lokasi absolut aktual properti. CDataPathProperty menggunakan URL, bukan nama file. Jika Anda menginginkan CDataPathProperty objek untuk file, prepend file:// ke jalur.

Keterangan

Objek COleControl yang ditunjukkan oleh pControl digunakan oleh Open dan diambil oleh kelas turunan. Jika pControl ADALAH NULL, kontrol yang digunakan dengan Open harus diatur dengan SetControl. Jika lpszPath NULL, Anda dapat melewati jalur Open atau mengaturnya dengan SetPath.

CDataPathProperty::GetControl

Panggil fungsi anggota ini untuk mengambil objek yang COleControl terkait dengan CDataPathProperty objek.

COleControl* GetControl();

Tampilkan Nilai

Mengembalikan penunjuk ke kontrol OLE yang CDataPathProperty terkait dengan objek. NULL jika tidak dikaitkan dengan kontrol.

CDataPathProperty::GetPath

Panggil fungsi anggota ini untuk mengambil jalur, mengatur kapan CDataPathProperty objek dibangun, atau ditentukan dalam Open, atau ditentukan dalam panggilan sebelumnya ke SetPath fungsi anggota.

CString GetPath() const;

Tampilkan Nilai

Mengembalikan nama jalur ke properti itu sendiri. Dapat kosong jika tidak ada jalur yang ditentukan.

CDataPathProperty::Open

Panggil fungsi anggota ini untuk memulai pemuatan properti asinkron untuk kontrol terkait.

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
Penunjuk ke objek kontrol OLE yang akan dikaitkan dengan objek ini CDataPathProperty .

pError
Penunjuk ke pengecualian file. Jika terjadi kesalahan, akan diatur ke penyebabnya.

lpszPath
Jalur, yang mungkin absolut atau relatif, digunakan untuk membuat moniker asinkron yang mereferensikan lokasi absolut aktual properti. CDataPathProperty menggunakan URL, bukan nama file. Jika Anda menginginkan CDataPathProperty objek untuk file, prepend file:// ke jalur.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, 0.

Keterangan

Fungsi ini mencoba untuk mendapatkan IBindHost antarmuka dari kontrol.

Sebelum memanggil Open tanpa jalur, nilai untuk jalur properti harus diatur. Ini dapat dilakukan ketika objek dibangun, atau dengan memanggil SetPath fungsi anggota.

Sebelum memanggil Open tanpa kontrol, kontrol ActiveX (sebelumnya dikenal sebagai kontrol OLE) dapat dikaitkan dengan objek. Ini dapat dilakukan ketika objek dibangun, atau dengan memanggil SetControl.

Semua kelebihan beban CAsyncMonikerFile::Open juga tersedia dari CDataPathProperty.

CDataPathProperty::ResetData

Panggil fungsi ini untuk mendapatkan CAsyncMonikerFile::OnDataAvailable pemberitahuan kontainer bahwa properti kontrol telah berubah, dan semua informasi yang dimuat secara asinkron tidak lagi berguna.

virtual void ResetData();

Keterangan

Pembukaan harus dimulai ulang. Kelas turunan dapat mengambil alih fungsi ini untuk default yang berbeda.

CDataPathProperty::SetControl

Panggil fungsi anggota ini untuk mengaitkan kontrol OLE asinkron dengan CDataPathProperty objek .

void SetControl(COleControl* pControl);

Parameter

pControl
Penunjuk ke kontrol OLE asinkron yang akan dikaitkan dengan properti .

CDataPathProperty::SetPath

Panggil fungsi anggota ini untuk mengatur nama jalur properti.

void SetPath(LPCTSTR lpszPath);

Parameter

lpszPath
Jalur, yang mungkin absolut atau relatif, ke properti yang dimuat secara asinkron. CDataPathProperty menggunakan URL, bukan nama file. Jika Anda menginginkan CDataPathProperty objek untuk file, prepend file:// ke jalur.

Lihat juga

Gambar Sampel MFC
Kelas CAsyncMonikerFile
Bagan Hierarki
Kelas CAsyncMonikerFile