CDHtmlDialog::GetElement

2011-08-09

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 番目のオーバーロードは失敗します。