Compartilhar via


CDHtmlDialog::GetElement

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.

Requisitos

Cabeçalho: afxdhtml.h

Consulte também

Referência

Classe CDHtmlDialog

Gráfico de hierarquia

CDHtmlDialog::GetElementInterface

CDHtmlDialog::GetControlDispatch

Outros recursos

CDHtmlDialog membros