CDHtmlDialog::GetElement

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

szElementId で指定した HTML 要素のインターフェイスを返します。

HRESULT GetElement(
   LPCTSTR szElementId,
   IDispatch **ppdisp,
   BOOL *pbCollection = NULL 
);
HRESULT GetElement(
   LPCTSTR szElementId,
   IHTMLElement **pphtmlElement 
);

パラメータ

szElementId
HTML 要素の ID。
ppdisp
要求された要素、または要求された要素のコレクションへの IDispatch ポインタ。
pbCollection
ppdisp で表されたオブジェクトが、単一の要素であるか、要素のコレクションであるかを示す BOOL。
pphtmlElement
要求された要素への IHTMLElement ポインタ。

戻り値

標準の HRESULT 値を返します。

解説

指定された ID を持つ要素が複数存在する場合は、最初のオーバーロードを使用して処理します。返されたインターフェイスポインタがコレクションと単一の項目のどちらを指しているかを確認するには、最後のパラメータを使用します。インターフェイスポインタがコレクションを指している場合は、IHTMLElementCollection を照会し、その item プロパティを使用して要素のコレクションを位置によって参照できます。

ページ内に同じ ID の要素が複数存在している場合、2 番目のオーバーロードは失敗します。