HtmlElementEventArgs Klasse

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Stellt Daten für die Ereignisse bereit, die für HtmlDocument und HtmlElement definiert sind.

public ref class HtmlElementEventArgs sealed : EventArgs

public sealed class HtmlElementEventArgs : EventArgs

type HtmlElementEventArgs = class
    inherit EventArgs

Public NotInheritable Class HtmlElementEventArgs
Inherits EventArgs

Vererbung

Object

EventArgs

HtmlElementEventArgs

Beispiele

Im folgenden Codebeispiel wird die Verwendung dieses Typs veranschaulicht. Im Beispiel meldet ein Ereignishandler das Auftreten des Ereignisses Click . Dieser Bericht hilft Ihnen, zu erfahren, wann das Ereignis eintritt, und kann Ihnen beim Debuggen helfen. Um über mehrere Ereignisse oder ereignisse zu berichten, die häufig auftreten, sollten Sie erwägen, die Nachricht durch Console.WriteLine ein mehrzeilesiges TextBoxzu ersetzen Show oder anzufügen.

Um den Beispielcode auszuführen, fügen Sie ihn in ein Projekt ein, das eine instance vom Typ HtmlDocument enthältHtmlDocument1. Stellen Sie dann sicher, dass der Ereignishandler dem Click Ereignis zugeordnet ist.

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

Hinweise

HtmlElementEventArgs kapselt die gleichen Informationen, die beim Programmieren mit dem window.event nicht verwalteten HTML-DOM oder beim Schreiben von Active Script für HTML-Seiten auf dem Objekt gefunden werden.

In den meisten Fällen können Sie verwenden ToElement , um das HTML-Element zu finden, das die Ereignisaktion empfängt, und FromElement um das HTML-Element zu finden, das verlassen wird. Allerdings liefert nicht jedes Ereignis einen Wert für diese Eigenschaften.

Viele Ereignisse im HTML-DOM werden an ihre übergeordneten Elemente gesendet, es sei denn, sie werden abgebrochen. Dies wird als Ereignisbubbling bezeichnet. Wenn ein SPAN in einem DIV einen Klick empfängt, wird ein Klickereignis für das SPAN erste ausgelöst, dann für das DIV- und schließlich für das -Element der HTML-Seite BODY . BubbleEvent steuert, ob sich ein Ereignis auf diese Weise verhält oder nicht.

Eigenschaften

AltKeyPressed	Gibt an, ob die ALT-TASTE gedrückt wurde, als dieses Ereignis aufgetreten ist.
BubbleEvent	Ruft einen Wert ab, der angibt, ob das aktuelle Ereignis Bubbles nach oben durch die Hierarchie der Elemente des HTML-DOM (Document Object Model) weiterleitet, oder legt diesen fest.
ClientMousePosition	Ruft die Position des Mauszeigers im Clientbereich des Dokuments ab oder legt diese fest.
CtrlKeyPressed	Gibt an, ob die STRG-TASTE gedrückt wurde, als das Ereignis eingetreten ist.
EventType	Ruft den Namen des Ereignisses ab, das ausgelöst wurde.
FromElement	Ruft das HtmlElement ab, von dem der Mauszeiger wegbewegt wird.
KeyPressedCode	Ruft den ASCII-Wert des Tastaturzeichens ab, das in einem der Ereignisse KeyPress, KeyDown oder KeyUp eingegeben wurde.
MouseButtonsPressed	Ruft die Maustaste ab, auf die während eines MouseDown-Ereignisses oder eines MouseUp-Ereignisses gedrückt wurde.
MousePosition	Ruft die Position des Mauszeigers in Bezug auf ein relativ positioniertes übergeordnetes Element ab oder legt diese fest.
OffsetMousePosition	Ruft die Position des Mauszeigers in Bezug auf das Element ab, das das Ereignis ausgelöst hat, oder legt diese fest.
ReturnValue	Ruft den Rückgabewert des behandelten Ereignisses ab oder legt diesen fest.
ShiftKeyPressed	Gibt an, ob die UMSCHALTTASTE gedrückt wurde, als dieses Ereignis aufgetreten ist.
ToElement	Ruft das HtmlElement ab, zu dem der Benutzer den Mauszeiger verschiebt.

Methoden

Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Weitere Informationen

• event-Objekt