HtmlElementEventArgs Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
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) |