HtmlElementEventArgs Classe

Definição

Fornece dados para os eventos definidos em HtmlDocument e HtmlElement.

public ref class HtmlElementEventArgs sealed : EventArgs
public sealed class HtmlElementEventArgs : EventArgs
type HtmlElementEventArgs = class
    inherit EventArgs
Public NotInheritable Class HtmlElementEventArgs
Inherits EventArgs
Herança
HtmlElementEventArgs

Exemplos

O exemplo de código a seguir demonstra o uso desse tipo. No exemplo, um manipulador de eventos relata a ocorrência do Click evento. Este relatório ajuda você a aprender quando o evento ocorre e pode ajudá-lo na depuração. Para relatar vários eventos ou eventos que ocorrem com frequência, considere substituir ShowConsole.WriteLine ou acrescentar a mensagem a uma linha TextBoxmúltipla.

Para executar o código de exemplo, cole-o em um projeto que contém uma instância do tipo HtmlDocument chamado HtmlDocument1. Em seguida, verifique se o manipulador de eventos está associado ao Click evento.

private void HtmlDocument1_Click(Object sender, HtmlElementEventArgs e) {

System.Text.StringBuilder messageBoxCS = new System.Text.StringBuilder();
messageBoxCS.AppendFormat("{0} = {1}", "MouseButtonsPressed", e.MouseButtonsPressed );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "ClientMousePosition", e.ClientMousePosition );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "OffsetMousePosition", e.OffsetMousePosition );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "MousePosition", e.MousePosition );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "BubbleEvent", e.BubbleEvent );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "KeyPressedCode", e.KeyPressedCode );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "AltKeyPressed", e.AltKeyPressed );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "CtrlKeyPressed", e.CtrlKeyPressed );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "ShiftKeyPressed", e.ShiftKeyPressed );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "EventType", e.EventType );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "ReturnValue", e.ReturnValue );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "FromElement", e.FromElement );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "ToElement", e.ToElement );
messageBoxCS.AppendLine();
MessageBox.Show(messageBoxCS.ToString(), "Click Event" );
}
Private Sub HtmlDocument1_Click(sender as Object, e as HtmlElementEventArgs) _ 
     Handles HtmlDocument1.Click

    Dim messageBoxVB as New System.Text.StringBuilder()
    messageBoxVB.AppendFormat("{0} = {1}", "MouseButtonsPressed", e.MouseButtonsPressed)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "ClientMousePosition", e.ClientMousePosition)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "OffsetMousePosition", e.OffsetMousePosition)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "MousePosition", e.MousePosition)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "BubbleEvent", e.BubbleEvent)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "KeyPressedCode", e.KeyPressedCode)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "AltKeyPressed", e.AltKeyPressed)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "CtrlKeyPressed", e.CtrlKeyPressed)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "ShiftKeyPressed", e.ShiftKeyPressed)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "EventType", e.EventType)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "ReturnValue", e.ReturnValue)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "FromElement", e.FromElement)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "ToElement", e.ToElement)
    messageBoxVB.AppendLine()
    MessageBox.Show(messageBoxVB.ToString(),"Click Event")

End Sub

Comentários

HtmlElementEventArgs encapsula as mesmas informações encontradas no window.event objeto ao programar no DOM HTML não gerenciado ou ao escrever o Script Ativo para páginas HTML.

Na maioria dos casos, você pode usar ToElement para localizar o elemento HTML que está recebendo a ação de evento e FromElement para localizar o elemento HTML que está sendo deixado. No entanto, nem todo evento fornece um valor para essas propriedades.

Muitos eventos no DOM HTML são enviados para seus elementos pai, a menos que sejam cancelados. Isso é conhecido como borbulha de evento. Se um SPAN dentro de um DIV receber um clique, um evento de clique será gerado para o SPAN primeiro, depois para o DIVelemento da página HTML e, por fim, para o elemento da BODY página HTML. BubbleEvent controla se um evento se comporta dessa maneira ou não.

Propriedades

Nome Description
AltKeyPressed

Indica se a tecla ALT foi pressionada quando esse evento ocorreu.

BubbleEvent

Obtém ou define um valor que indica se o evento atual é visualizado por meio da hierarquia de elementos do Modelo de Objeto de Documento HTML.

ClientMousePosition

Obtém ou define a posição do cursor do mouse na área do cliente do documento.

CtrlKeyPressed

Indica se a tecla CTRL foi pressionada quando esse evento ocorreu.

EventType

Obtém o nome do evento que foi gerado.

FromElement

Obtém o HtmlElement ponteiro do mouse que está se afastando.

KeyPressedCode

Obtém o valor ASCII do caractere de teclado digitado em um KeyPress, KeyDownou KeyUp evento.

MouseButtonsPressed

Obtém o botão do mouse que foi clicado durante um evento ou MouseUp eventoMouseDown.

MousePosition

Obtém ou define a posição do cursor do mouse em relação a um elemento pai relativamente posicionado.

OffsetMousePosition

Obtém ou define a posição do cursor do mouse em relação ao elemento que gera o evento.

ReturnValue

Obtém ou define o valor retornado do evento manipulado.

ShiftKeyPressed

Indica se a tecla SHIFT foi pressionada quando esse evento ocorreu.

ToElement

Obtém a HtmlElement direção para a qual o usuário está movendo o ponteiro do mouse.

Métodos

Nome Description
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como a função hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Objectatual.

(Herdado de Object)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Aplica-se a

Confira também