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 identificação de um elemento HTML.

  • ppdisp
    Um ponteiro de IDispatch ao elemento ou à coleção solicitada de elementos.

  • pbCollection
    BOOL que indica se o objeto é representado pelo ppdisp um único elemento ou uma coleção de elementos.

  • pphtmlElement
    Um ponteiro de IHTMLElement ao elemento aplicativo.

Valor de retorno

Um valor padrão de HRESULT .

Comentários

Use a primeira sobrecarga se você precisar manipular condições em que pode haver mais de um elemento com um certo IDVocê pode usar o último parâmetro para descobrir se o ponteiro retornado da interface é a uma coleção ou a um único item.Se o ponteiro de interface está em uma coleção, você pode consultar IHTMLElementCollection e utilizar a propriedade de item para se referir aos elementos pela posição ordinal.

A segunda sobrecarga falhará se houver mais de um elemento com o mesmo identificação na página.

Requisitos

Cabeçalho: afxdhtml.h

Consulte também

Referência

Classe de CDHtmlDialog

Gráfico de hierarquia

CDHtmlDialog::GetElementInterface

CDHtmlDialog::GetControlDispatch