HtmlElementEventArgs Classe

Definição

Espaço de Nomes:
System.Windows.Forms
Assemblagem:
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 seguinte exemplo de código demonstra o uso deste tipo. No exemplo, um gestor de eventos reporta a ocorrência do Click evento. Este relatório ajuda-o a saber quando o evento ocorre e pode ajudá-lo na depuração. Para reportar múltiplos eventos ou eventos que ocorrem frequentemente, considere substituir Show ou Console.WriteLine anexar a mensagem a uma multilinha TextBox.

Para executar o código de exemplo, cole-o num projeto que contenha uma instância do tipo HtmlDocument chamada HtmlDocument1. Depois, certifique-se de que o gestor 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

Observações

HtmlElementEventArgs encapsula a mesma informação encontrada no window.event objeto ao programar contra o DOM HTML não gerido ou ao escrever o Active Script para páginas HTML.

Na maioria dos casos, podes usar ToElement para encontrar o elemento HTML que está a receber a ação do evento e FromElement para encontrar o elemento HTML que está a ser deixado. No entanto, nem todos os eventos oferecem um valor para estas propriedades.

Muitos eventos no DOM HTML são enviados para os seus elementos-mãe, a menos que sejam cancelados. Isto é conhecido como borbulhar de eventos. Se um SPAN inside of a DIV receber um clique, então é criado um evento de clique para o SPAN primeiro, depois para o DIV, e finalmente para o elemento da BODY página HTML. BubbleEvent controla se um evento se comporta desta forma ou não.

Propriedades

Name Description
AltKeyPressed

Indica se a tecla ALT foi pressionada quando este evento ocorreu.
BubbleEvent

Recebe ou define um valor que indica se o evento atual surge através da hierarquia de elementos do Modelo de Objetos do Documento HTML.
ClientMousePosition

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

Indica se a tecla CTRL foi pressionada quando este evento ocorreu.
EventType

Recebe o nome do evento que foi levantado.
FromElement

Obtém que HtmlElement o ponteiro do rato está a afastar-se.
KeyPressedCode

Obtém o valor ASCII do carácter do teclado escrito num KeyPress, KeyDown, ou KeyUp evento.
MouseButtonsPressed

Obtém o botão do rato que foi clicado durante um MouseDown evento do OR MouseUp .
MousePosition

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

Obtém ou define a posição do cursor do rato em relação ao elemento que eleva o evento.
ReturnValue

Recebe ou define o valor de retorno do evento tratado.
ShiftKeyPressed

Indica se a tecla SHIFT foi pressionada quando este evento ocorreu.
ToElement

Obtém a HtmlElement direção para onde o utilizador está a mover o ponteiro do rato.

Métodos

Name Description
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

Aplica-se a

Ver também