CDataPathProperty 類別

發行項
10/12/2023

實作可以非同步載入的 OLE 控制項屬性。

語法

class CDataPathProperty : public CAsyncMonikerFile

成員

公用建構函式

名稱	描述
CDataPathProperty：：CDataPathProperty	建構 `CDataPathProperty` 物件。

公用方法

名稱	描述
CDataPathProperty：：GetControl	擷取與 `CDataPathProperty` 物件相關聯的非同步 OLE 控制項。
CDataPathProperty：：GetPath	擷取屬性的路徑名稱。
CDataPathProperty：：Open	起始相關聯 ActiveX （OLE）控制項之非同步屬性的載入。
CDataPathProperty：：ResetData	呼叫 `CAsyncMonikerFile::OnDataAvailable` 以通知容器控制項屬性已變更。
CDataPathProperty：：SetControl	設定與屬性相關聯的非同步 ActiveX （OLE）控制項。
CDataPathProperty：：SetPath	設定屬性的路徑名稱。

備註

非同步屬性會在同步初始之後載入。

類別 CDataPathProperty 衍生自 CAysncMonikerFile 。若要在 OLE 控制項中實作非同步屬性，請從 CDataPathProperty 衍生類別，並覆寫 OnDataAvailable 。

如需如何在網際網路應用程式中使用非同步 Moniker 和 ActiveX 控制項的詳細資訊，請參閱下列文章：

繼承階層架構

CDataPathProperty

需求

標頭： afxctl.h

CDataPathProperty：：CDataPathProperty

建構 CDataPathProperty 物件。

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

參數

pControl
要與此 CDataPathProperty 物件關聯的 OLE 控制項物件的指標。

lpszPath
路徑，可能是絕對或相對路徑，用來建立異步 Moniker，參考屬性的實際絕對位置。 CDataPathProperty 會使用 URL，而非檔案名。如果您想要檔案 CDataPathProperty 的物件，請在路徑前面加上 file:// 。

備註

COleControlpControl 所指向的物件是由 Open 衍生類別所使用和擷取。如果 pControl 為 Null，則搭配 Open 使用的控制項應該設定為 SetControl 。如果 lpszPath 為 Null，您可以透過 Open 傳入路徑，或使用加以設定 SetPath 。

CDataPathProperty：：GetControl

呼叫這個成員函式，以擷取 COleControl 與 CDataPathProperty 物件相關聯的物件。

COleControl* GetControl();

傳回值

傳回與 CDataPathProperty 物件相關聯的 OLE 控制項指標。如果不是控制項，則為 Null。

CDataPathProperty：：GetPath

呼叫這個成員函式來擷取路徑、在建構物件時 CDataPathProperty 設定，或在之前對成員函式的呼叫 SetPath 中指定 Open 。

CString GetPath() const;

傳回值

傳回屬性本身的路徑名稱。如果沒有指定路徑，則可以是空的。

CDataPathProperty：：Open

呼叫這個成員函式，以起始相關聯控制項的非同步屬性載入。

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

參數

pControl
要與此 CDataPathProperty 物件關聯的 OLE 控制項物件的指標。

pError
檔案例外狀況的指標。發生錯誤時，將會設定為原因。

傳回值

如果成功則為非零；否則為 0。

備註

函式會嘗試從控制項取得 IBindHost 介面。

在呼叫 Open 不含路徑之前，必須設定屬性路徑的值。在建構物件時，或藉由呼叫 SetPath 成員函式，即可完成此動作。

在呼叫 Open 沒有控制項之前，ActiveX 控制項（先前稱為 OLE 控制項）可以與物件相關聯。在建構物件時，或藉由呼叫 SetControl ，即可完成此動作。

CAsyncMonikerFile：：Open 的所有多載也可從 CDataPathProperty 取得。

CDataPathProperty：：ResetData

呼叫此函式以 CAsyncMonikerFile::OnDataAvailable 通知容器控制項屬性已變更，且所有以非同步方式載入的資訊已不再有用。

virtual void ResetData();

備註

開啟應該重新開機。衍生類別可以覆寫此函式的不同預設值。

CDataPathProperty：：SetControl

呼叫這個成員函式，將非同步 OLE 控制項與 CDataPathProperty 物件產生關聯。

void SetControl(COleControl* pControl);

參數

pControl
要與屬性相關聯之非同步 OLE 控制項的指標。

CDataPathProperty：：SetPath

呼叫這個成員函式以設定屬性的路徑名稱。

void SetPath(LPCTSTR lpszPath);

參數

lpszPath
路徑，可能是絕對或相對路徑，以非同步方式載入屬性。 CDataPathProperty 會使用 URL，而非檔案名。如果您想要檔案 CDataPathProperty 的物件，請在路徑前面加上 file:// 。

另請參閱

MFC 範例影像
 CAsyncMonikerFile 類別
 階層架構圖表
 CAsyncMonikerFile 類別

共用方式為