HtmlElementEventArgs Klasse

Definition

Stellt Daten für die Ereignisse bereit, die für HtmlDocument und HtmlElement definiert sind.Provides data for the events defined on HtmlDocument and HtmlElement.

public ref class HtmlElementEventArgs sealed : EventArgs
public sealed class HtmlElementEventArgs : EventArgs
type HtmlElementEventArgs = class
    inherit EventArgs
Public NotInheritable Class HtmlElementEventArgs
Inherits EventArgs
Vererbung
HtmlElementEventArgs

Beispiele

Im folgenden Codebeispiel wird die Verwendung dieses Typs veranschaulicht.The following code example demonstrates the use of this type. Im Beispiel meldet ein Ereignishandler das Vorkommen des Click Ereignisses.In the example, an event handler reports on the occurrence of the Click event. Mit diesem Bericht können Sie lernen, wann das Ereignis auftritt und Sie beim Debuggen unterstützen können.This report helps you to learn when the event occurs and can assist you in debugging. Wenn Sie mehrere Ereignisse oder Ereignisse, die häufig auftreten, melden möchten, empfiehlt es sich, durch zu ersetzen Show Console.WriteLine oder die Nachricht an eine mehrzeilige anfügen TextBox .To report on multiple events or on events that occur frequently, consider replacing Show with Console.WriteLine or appending the message to a multiline TextBox.

Um den Beispielcode auszuführen, fügen Sie ihn in ein Projekt ein, das eine Instanz des Typs mit dem HtmlDocument Namen enthält HtmlDocument1 .To run the example code, paste it into a project that contains an instance of type HtmlDocument named HtmlDocument1. Stellen Sie dann sicher, dass der Ereignishandler dem Click Ereignis zugeordnet ist.Then ensure that the event handler is associated with the Click event.

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 window.event Programmieren für das nicht verwaltete HTML-DOM oder beim Schreiben des aktiven Skripts für HTML-Seiten für das-Objekt gefunden wurden.HtmlElementEventArgs encapsulates the same information found on the window.event object when programming against the unmanaged HTML DOM or when writing Active Script for HTML pages.

In den meisten Fällen können Sie verwenden, ToElement um das HTML-Element zu finden, das die Ereignis Aktion empfängt, und FromElement um das HTML-Element zu finden, das von dem aktuellen Ereignis verursacht wird.In most cases, you can use ToElement to find the HTML element that is receiving the event action, and FromElement to find the HTML element that the current event is causing us to leave. Nicht jedes Ereignis liefert jedoch einen Wert für diese Eigenschaften. Weitere Informationen finden Sie in der verwalteten Dokumentation zu einem Ereignis oder in der entsprechenden Dokumentation in der Internet Explorer SDK-Dokumentation, um zu ermitteln, ob das Ereignis dieses Ereignis liefert.However, not every event supplies a value for these properties; see the managed documentation for an event, or the corresponding documentation in the Internet Explorer SDK documentation, to discover if the event supplies it.

Viele Ereignisse im HTML-DOM werden an ihre übergeordneten Elemente gesendet, es sei denn, Sie werden abgebrochen.Many events in the HTML DOM are sent to their parent elements unless they are cancelled. Dies wird als Ereignis Blasen bezeichnet.This is known as event bubbling. Wenn eine SPAN in einer einen DIV Klick erhält, wird ein Click-Ereignis für die SPAN erste, dann für den DIV und schließlich für das-Element der HTML-Seite ausgelöst BODY .If a SPAN inside of a DIV receives a click, then a click event is raised for the SPAN first, then for the DIV, and finally for the HTML page's BODY element. BubbleEvent steuert, ob sich ein Ereignis auf diese Weise verhält.BubbleEvent controls whether an event will behave in this manner or not.

Eigenschaften

AltKeyPressed

Gibt an, ob die ALT-TASTE gedrückt wurde, als dieses Ereignis aufgetreten ist.Indicates whether the ALT key was pressed when this event occurred.

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.Gets or sets a value indicating whether the current event bubbles up through the element hierarchy of the HTML Document Object Model.

ClientMousePosition

Ruft die Position des Mauszeigers im Clientbereich des Dokuments ab oder legt diese fest.Gets or sets the position of the mouse cursor in the document's client area.

CtrlKeyPressed

Gibt an, ob die STRG-TASTE gedrückt wurde, als das Ereignis eingetreten ist.Indicates whether the CTRL key was pressed when this event occurred.

EventType

Ruft den Namen des Ereignisses ab, das ausgelöst wurde.Gets the name of the event that was raised.

FromElement

Ruft das HtmlElement ab, von dem der Mauszeiger wegbewegt wird.Gets the HtmlElement the mouse pointer is moving away from.

KeyPressedCode

Ruft den ASCII-Wert des Tastaturzeichens ab, das in einem der Ereignisse KeyPress, KeyDown oder KeyUp eingegeben wurde.Gets the ASCII value of the keyboard character typed in a KeyPress, KeyDown, or KeyUp event.

MouseButtonsPressed

Ruft die Maustaste ab, auf die während eines MouseDown-Ereignisses oder eines MouseUp-Ereignisses gedrückt wurde.Gets the mouse button that was clicked during a MouseDown or MouseUp event.

MousePosition

Ruft die Position des Mauszeigers in Bezug auf ein relativ positioniertes übergeordnetes Element ab oder legt diese fest.Gets or sets the position of the mouse cursor relative to a relatively positioned parent element.

OffsetMousePosition

Ruft die Position des Mauszeigers in Bezug auf das Element ab, das das Ereignis ausgelöst hat, oder legt diese fest.Gets or sets the position of the mouse cursor relative to the element that raises the event.

ReturnValue

Ruft den Rückgabewert des behandelten Ereignisses ab oder legt diesen fest.Gets or sets the return value of the handled event.

ShiftKeyPressed

Gibt an, ob die UMSCHALTTASTE gedrückt wurde, als dieses Ereignis aufgetreten ist.Indicates whether the SHIFT key was pressed when this event occurred.

ToElement

Ruft das HtmlElement ab, zu dem der Benutzer den Mauszeiger verschiebt.Gets the HtmlElement toward which the user is moving the mouse pointer.

Methoden

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)

Gilt für: