CDataPathProperty 類別

發行項
08/04/2024

實作可以非同步載入的 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:// 。

備註

COleControl pControl 所指向的物件是由 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 類別

共用方式為