CDHtmlDialog::GetElement

Artigo
08/25/2010

Retorna uma interface no elemento HTML especificado por szElementId.

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

Parâmetros

szElementId
A ID de um elemento HTML.
ppdisp
An IDispatch ponteiro para o elemento solicitado ou a coleção de elementos.
pbCollection
A BOOL indicando se o objeto representado por ppdisp é um único elemento ou uma coleção de elementos.
pphtmlElement
An IHTMLElement aponta para o elemento solicitado.

Valor de retorno

Um padrão HRESULT valor.

Comentários

Use a primeira sobrecarga se você precisar manipular condições em que pode haver mais de um elemento com a ID especificado.Você pode usar o último parâmetro para descobrir se o ponteiro de interface retornado é uma coleção ou um único item.Se o ponteiro de interface está em uma coleção, é possível consultar o IHTMLElementCollection e usar sua itempropriedade para se referir a elementos pela posição ordinal.

A segunda sobrecarga irá falhar se houver mais de um elemento com a mesma ID na página.