HtmlElementEventArgs Classe

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

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

Object

EventArgs

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)

Confira também

• objeto event