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 saber 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 por ou acrescentar a mensagem a uma multilinha TextBox.

Para executar o código de exemplo, cole-o em um projeto que contém uma instância do tipo HtmlDocument chamada 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 em relação ao 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 propagação de eventos. Se um SPAN dentro de um DIV receber um clique, um evento de clique será gerado para o SPAN primeiro e, por fim, para o DIVelemento da BODY página HTML. BubbleEvent controla se um evento se comporta dessa maneira ou não.

Propriedades

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 sobe pela hierarquia de elementos do Modelo de Objeto do Documento HTML.

ClientMousePosition

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

CtrlKeyPressed

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

EventType

Obtém o nome do evento que foi acionado.

FromElement

Obtém o HtmlElement para longe do qual o ponteiro do mouse está se movendo.

KeyPressedCode

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

MouseButtonsPressed

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

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 aciona 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 o HtmlElement em direção ao qual o usuário está movendo o ponteiro do mouse.

Métodos

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Aplica-se a

Confira também