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 ID Você 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 CDHtmlDialog

Gráfico da hierarquia

CDHtmlDialog::GetElementInterface

CDHtmlDialog::GetControlDispatch