CDataPathProperty クラス
非同期で読み込める OLE コントロール プロパティを実装します。
構文
class CDataPathProperty : public CAsyncMonikerFile
メンバー
パブリック コンストラクター
| 名前 | 説明 |
|---|---|
| CDataPathProperty::CDataPathProperty | CDataPathProperty オブジェクトを構築します。 |
パブリック メソッド
| 名前 | 説明 |
|---|---|
| CDataPathProperty::GetControl | オブジェクトに関連付けられている非同期 OLE コントロールを CDataPathProperty 取得します。 |
| CDataPathProperty::GetPath | プロパティのパス名を取得します。 |
| CDataPathProperty::Open | 関連付けられている ActiveX (OLE) コントロールの非同期プロパティの読み込みを開始します。 |
| CDataPathProperty::ResetData | コントロールのプロパティが変更されたことをコンテナーに通知する呼び出し CAsyncMonikerFile::OnDataAvailable 。 |
| CDataPathProperty::SetControl | プロパティに関連付けられている非同期 ActiveX (OLE) コントロールを設定します。 |
| CDataPathProperty::SetPath | プロパティのパス名を設定します。 |
解説
非同期のプロパティは、同期の開始後に読み込まれます。
このクラスCDataPathPropertyは 、CAysncMonikerFile OLE コントロールに非同期プロパティを実装するには、OnDataAvailable からCDataPathPropertyクラスを派生させ、オーバーライドします。
インターネット アプリケーションで非同期モニカーと ActiveX コントロールを使用する方法の詳細については、次の記事を参照してください。
継承階層
CDataPathProperty
必要条件
ヘッダー: afxctl.h
CDataPathProperty::CDataPathProperty
CDataPathProperty オブジェクトを構築します。
CDataPathProperty(COleControl* pControl = NULL);
CDataPathProperty(LPCTSTR lpszPath, COleControl* pControl = NULL);
パラメーター
pControl
この CDataPathProperty オブジェクトに関連付ける OLE コントロール オブジェクトへのポインター。
lpszPath
絶対パスまたは相対パスは、プロパティの実際の絶対位置を参照する非同期モニカーを作成するために使用されます。 CDataPathProperty では、ファイル名ではなく URL が使用されます。 ファイルのオブジェクトが必要な CDataPathProperty 場合は、パスの前に追加 file:// します。
解説
COleControl pControl が指すオブジェクトは、派生クラスによってOpen使用され、取得されます。 pControl が NULL の場合、使用Openされるコントロールは 〘 でSetControl設定する必要があります。 lpszPath が NULL の場合は、パスを渡すか、 を使用してOpenSetPath設定できます。
CDataPathProperty::GetControl
このメンバー関数を呼び出して、オブジェクトに COleControl 関連付けられているオブジェクトを CDataPathProperty 取得します。
COleControl* GetControl();
戻り値
オブジェクトに関連付けられている OLE コントロールへのポインターを CDataPathProperty 返します。 制御が関連付けられていない場合は NULL。
CDataPathProperty::GetPath
このメンバー関数を呼び出して、パスを取得し、オブジェクトが構築されたとき、またはメンバー関数の以前の呼び出しSetPathでOpen指定されたときに設定CDataPathPropertyします。
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
ファイル例外へのポインター。 エラーが発生した場合は、原因に設定されます。
lpszPath
絶対パスまたは相対パスは、プロパティの実際の絶対位置を参照する非同期モニカーを作成するために使用されます。 CDataPathProperty では、ファイル名ではなく URL が使用されます。 ファイルのオブジェクトが必要な CDataPathProperty 場合は、パスの前に追加 file:// します。
戻り値
正常終了した場合は 0 以外を返します。それ以外の場合は 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 クラス
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示