HtmlElementEventArgs Classe

Définition

Fournit les données des événements ayant la valeur HtmlDocument et HtmlElement.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
Héritage
HtmlElementEventArgs

Exemples

L’exemple de code suivant illustre l’utilisation de ce type.The following code example demonstrates the use of this type. Dans l’exemple, un gestionnaire d’événements signale l’occurrence de l’événement Click.In the example, an event handler reports on the occurrence of the Click event. Ce rapport vous aide à savoir quand l’événement se produit et peut vous aider à effectuer un débogage.This report helps you to learn when the event occurs and can assist you in debugging. Pour signaler plusieurs événements ou sur des événements qui se produisent fréquemment, envisagez de remplacer Show par Console.WriteLine ou d’ajouter le message à un TextBox multiligne.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.

Pour exécuter l’exemple de code, collez-le dans un projet qui contient une instance de type HtmlDocument nommée HtmlDocument1.To run the example code, paste it into a project that contains an instance of type HtmlDocument named HtmlDocument1. Assurez-vous ensuite que le gestionnaire d’événements est associé à l’événement Click.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

Remarques

HtmlElementEventArgs encapsule les mêmes informations trouvées sur l’objet window.event lors de la programmation par rapport au modèle DOM HTML non managé ou lors de l’écriture d’un script actif pour les pages HTML.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.

Dans la plupart des cas, vous pouvez utiliser ToElement pour Rechercher l’élément HTML qui reçoit l’action d’événement, et FromElement pour Rechercher l’élément HTML que l’événement actuel nous amène à sortir.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. Toutefois, tous les événements ne fournissent pas une valeur pour ces propriétés ; consultez la documentation gérée d’un événement ou la documentation correspondante dans la documentation du kit de développement logiciel (SDK) d’Internet Explorer pour déterminer si l’événement le fournit.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.

De nombreux événements dans le DOM HTML sont envoyés à leurs éléments parents, sauf s’ils sont annulés.Many events in the HTML DOM are sent to their parent elements unless they are cancelled. C’est ce que l’on appelle la propagation d’événements.This is known as event bubbling. Si un SPAN à l’intérieur d’un DIV reçoit un clic, un événement Click est déclenché pour la SPAN en premier, puis pour la DIVet enfin pour l’élément BODY de la page HTML.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 contrôle si un événement se comportera de cette manière ou non.BubbleEvent controls whether an event will behave in this manner or not.

Propriétés

AltKeyPressed

Indique si la touche ALT était activée lorsque cet événement s'est produit.Indicates whether the ALT key was pressed when this event occurred.

BubbleEvent

Obtient ou définit une valeur indiquant si l'événement actuel se propage à travers la hiérarchie des éléments du modèle objet de document HTML.Gets or sets a value indicating whether the current event bubbles up through the element hierarchy of the HTML Document Object Model.

ClientMousePosition

Obtient ou définit la position du pointeur de souris dans la zone cliente du document.Gets or sets the position of the mouse cursor in the document's client area.

CtrlKeyPressed

Indique si la touche CTRL était activée lorsque cet événement s'est produit.Indicates whether the CTRL key was pressed when this event occurred.

EventType

Obtient le nom de l'événement qui a été déclenché.Gets the name of the event that was raised.

FromElement

Obtient le HtmlElement dont le pointeur de la souris s'éloigne.Gets the HtmlElement the mouse pointer is moving away from.

KeyPressedCode

Obtient la valeur ASCII du caractère tapé au clavier dans un événement KeyPress, KeyDown ou KeyUp.Gets the ASCII value of the keyboard character typed in a KeyPress, KeyDown, or KeyUp event.

MouseButtonsPressed

Obtient le bouton de la souris sur lequel l'utilisateur a cliqué pendant un événement MouseDown ou MouseUp.Gets the mouse button that was clicked during a MouseDown or MouseUp event.

MousePosition

Obtient ou définit la position du pointeur de souris par rapport à un élément parent positionné de façon relative.Gets or sets the position of the mouse cursor relative to a relatively positioned parent element.

OffsetMousePosition

Obtient ou définit la position du pointeur de souris par rapport à l'élément qui déclenche l'événement.Gets or sets the position of the mouse cursor relative to the element that raises the event.

ReturnValue

Obtient ou définit la valeur de retour de l'événement géré.Gets or sets the return value of the handled event.

ShiftKeyPressed

Indique si la touche MAJ était activée lorsque cet événement s'est produit.Indicates whether the SHIFT key was pressed when this event occurred.

ToElement

Obtient le HtmlElement vers lequel l'utilisateur déplace le pointeur de la souris.Gets the HtmlElement toward which the user is moving the mouse pointer.

Méthodes

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
GetHashCode()

Sert de fonction de hachage par défaut.Serves as the default hash function.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
ToString()

Retourne une chaîne qui représente l'objet actif.Returns a string that represents the current object.

(Hérité de Object)

S’applique à

Voir aussi