HtmlElementEventArgs Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Fournit les données des événements ayant la valeur HtmlDocument et 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
Exemples
L’exemple de code suivant illustre l’utilisation de ce type. Dans l’exemple, un gestionnaire d’événements signale l’occurrence de l’événement Click . Ce rapport vous aide à savoir quand l’événement se produit et peut vous aider dans le débogage. Pour signaler plusieurs événements ou événements qui se produisent fréquemment, envisagez de ShowConsole.WriteLine remplacer par ou d’ajouter le message à un message multiligne TextBox.
Pour exécuter l’exemple de code, collez-le dans un projet qui contient un instance de type HtmlDocument nommé HtmlDocument1
. Vérifiez ensuite que le gestionnaire d’événements est associé à l’événement 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
Remarques
HtmlElementEventArgs encapsule les mêmes informations que celles trouvées sur l’objet lors de la window.event
programmation sur le DOM HTML non managé ou lors de l’écriture d’un script actif pour les pages HTML.
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 qui est laissé. Toutefois, tous les événements ne fournissent pas de valeur pour ces propriétés.
De nombreux événements dans le DOM HTML sont envoyés à leurs éléments parents, sauf s’ils sont annulés. C’est ce qu’on appelle le bouillonnement d’événements. Si un SPAN
à l’intérieur d’un DIV
reçoit un clic, un événement de clic est déclenché pour le SPAN
premier, puis pour l’élément DIV
et enfin pour l’élément de BODY
la page HTML.
BubbleEvent contrôle si un événement se comporte de cette manière ou non.
Propriétés
AltKeyPressed |
Indique si la touche ALT était activée lorsque cet événement s'est produit. |
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. |
ClientMousePosition |
Obtient ou définit la position du pointeur de souris dans la zone cliente du document. |
CtrlKeyPressed |
Indique si la touche CTRL était activée lorsque cet événement s'est produit. |
EventType |
Obtient le nom de l'événement qui a été déclenché. |
FromElement |
Obtient le HtmlElement dont le pointeur de la souris s'éloigne. |
KeyPressedCode |
Obtient la valeur ASCII du caractère tapé au clavier dans un événement KeyPress, KeyDown ou KeyUp. |
MouseButtonsPressed |
Obtient le bouton de la souris sur lequel l'utilisateur a cliqué pendant un événement MouseDown ou MouseUp. |
MousePosition |
Obtient ou définit la position du pointeur de souris par rapport à un élément parent positionné de façon relative. |
OffsetMousePosition |
Obtient ou définit la position du pointeur de souris par rapport à l'élément qui déclenche l'événement. |
ReturnValue |
Obtient ou définit la valeur de retour de l'événement géré. |
ShiftKeyPressed |
Indique si la touche MAJ était activée lorsque cet événement s'est produit. |
ToElement |
Obtient le HtmlElement vers lequel l'utilisateur déplace le pointeur de la souris. |
Méthodes
Equals(Object) |
Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object) |
GetHashCode() |
Fait office de fonction de hachage par défaut. (Hérité de Object) |
GetType() |
Obtient le Type de l'instance actuelle. (Hérité de Object) |
MemberwiseClone() |
Crée une copie superficielle du Object actuel. (Hérité de Object) |
ToString() |
Retourne une chaîne qui représente l'objet actuel. (Hérité de Object) |