HtmlElementEventArgs Classe

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Fornisce i dati per gli eventi definiti in 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

Ereditarietà

Object

EventArgs

HtmlElementEventArgs

Esempio

Nell'esempio di codice seguente viene illustrato l'uso di questo tipo. Nell'esempio un gestore eventi segnala l'occorrenza dell'evento Click . Questo report consente di apprendere quando si verifica l'evento e può essere utile per eseguire il debug. Per segnalare più eventi o eventi che si verificano spesso, è consigliabile sostituire Show con Console.WriteLine o aggiungere il messaggio a una multilinea TextBox.

Per eseguire il codice di esempio, incollarlo in un progetto contenente un'istanza di tipo HtmlDocument denominata HtmlDocument1. Assicurarsi quindi che il gestore eventi sia associato all'evento Click .

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

Commenti

HtmlElementEventArgs incapsula le stesse informazioni trovate nell'oggetto durante la programmazione rispetto al window.event DOM HTML non gestito o durante la scrittura di Script attivo per le pagine HTML.

Nella maggior parte dei casi, è possibile usare ToElement per trovare l'elemento HTML che riceve l'azione dell'evento e FromElement per trovare l'elemento HTML lasciato. Tuttavia, non tutti gli eventi forniscono un valore per queste proprietà.

Molti eventi nel DOM HTML vengono inviati agli elementi padre, a meno che non vengano annullati. Questo è noto come bubbling evento. Se un SPAN oggetto all'interno di un DIV oggetto riceve un clic, viene generato un evento click per il SPAN primo, quindi per l'elemento e infine per l'elemento DIVdella BODY pagina HTML. BubbleEvent controlla se un evento si comporta in questo modo o meno.

Proprietà

AltKeyPressed	Indica se è stato premuto il tasto ALT al verificarsi di questo evento.
BubbleEvent	Ottiene o imposta un valore che indica se l'evento corrente viene propagato attraverso la gerarchia degli elementi di HTML DOM.
ClientMousePosition	Ottiene o imposta la posizione del cursore del mouse nell'area client del documento.
CtrlKeyPressed	Indica se è stato premuto il tasto CTRL al verificarsi di questo evento.
EventType	Ottiene il nome dell'evento che è stato generato.
FromElement	Ottiene l'oggetto HtmlElement dal quale il puntatore del mouse si sta allontanando.
KeyPressedCode	Ottiene il valore ASCII del tasto digitato in un evento KeyPress, KeyDown o KeyUp.
MouseButtonsPressed	Ottiene il pulsante del mouse su cui è stato fatto clic durante un evento MouseDown o MouseUp.
MousePosition	Ottiene o imposta la posizione del cursore del mouse rispetto a un elemento padre posizionato in modalità relativa.
OffsetMousePosition	Ottiene o imposta la posizione del cursore del mouse rispetto all'elemento che genera l'evento.
ReturnValue	Ottiene o imposta il nome restituito dell'evento gestito.
ShiftKeyPressed	Indica se è stato premuto il tasto MAIUSC al verificarsi di questo evento.
ToElement	Ottiene l'oggetto HtmlElement verso il quale l'utente sta spostando il puntatore del mouse.

Metodi

Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Vedi anche

• oggetto event