HtmlElementEventArgs Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Dostarcza dane dla zdarzeń zdefiniowanych w systemach HtmlDocument i HtmlElement.
public ref class HtmlElementEventArgs sealed : EventArgs
public sealed class HtmlElementEventArgs : EventArgs
type HtmlElementEventArgs = class
inherit EventArgs
Public NotInheritable Class HtmlElementEventArgs
Inherits EventArgs
- Dziedziczenie
Przykłady
W poniższym przykładzie kodu pokazano użycie tego typu. W tym przykładzie program obsługi zdarzeń zgłasza wystąpienie Click zdarzenia. Ten raport pomaga dowiedzieć się, kiedy wystąpi zdarzenie, i może pomóc w debugowaniu. Aby zgłosić wiele zdarzeń lub często występujących zdarzeń, rozważ zastąpienie Show komunikatu ciągiem Console.WriteLine lub dołączenie go do wielowierszowego TextBoxelementu .
Aby uruchomić przykładowy kod, wklej go w projekcie zawierającym wystąpienie typu HtmlDocument o nazwie HtmlDocument1
. Następnie upewnij się, że program obsługi zdarzeń jest skojarzony ze zdarzeniem 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
Uwagi
HtmlElementEventArgs Hermetyzuje te same informacje znajdujące się na window.event
obiekcie podczas programowania względem niezarządzanych modelu DOM HTML lub podczas pisania aktywnego skryptu dla stron HTML.
W większości przypadków można użyć ToElement polecenia , aby znaleźć element HTML odbierający akcję zdarzenia i FromElement znaleźć element HTML, który jest pozostawiony. Jednak nie każde zdarzenie dostarcza wartość dla tych właściwości.
Wiele zdarzeń w modelu DOM HTML jest wysyłanych do elementów nadrzędnych, chyba że zostaną anulowane. Jest to znane jako bubbling zdarzenia. Jeśli wewnątrz SPAN
obiektu DIV
zostanie odebrane kliknięcie, najpierw zostanie zgłoszone SPAN
zdarzenie kliknięcia, a następnie dla DIV
elementu , i na koniec dla elementu strony BODY
HTML.
BubbleEvent określa, czy zdarzenie zachowuje się w ten sposób, czy nie.
Właściwości
AltKeyPressed |
Wskazuje, czy klawisz ALT został naciśnięty po wystąpieniu tego zdarzenia. |
BubbleEvent |
Pobiera lub ustawia wartość wskazującą, czy bieżące zdarzenie jest bąbelkowe w górę przez hierarchię elementów modelu obiektów dokumentów HTML. |
ClientMousePosition |
Pobiera lub ustawia położenie kursora myszy w obszarze klienta dokumentu. |
CtrlKeyPressed |
Wskazuje, czy klawisz CTRL został naciśnięty po wystąpieniu tego zdarzenia. |
EventType |
Pobiera nazwę zdarzenia, które zostało podniesione. |
FromElement |
HtmlElement Pobiera wskaźnik myszy odchodzi. |
KeyPressedCode |
Pobiera wartość ASCII znaku klawiatury wpisanego KeyPressw zdarzeniu , KeyDownlub KeyUp . |
MouseButtonsPressed |
Pobiera przycisk myszy kliknięty podczas zdarzenia MouseDown lub MouseUp . |
MousePosition |
Pobiera lub ustawia położenie kursora myszy względem stosunkowo ustawionego elementu nadrzędnego. |
OffsetMousePosition |
Pobiera lub ustawia położenie kursora myszy względem elementu, który wywołuje zdarzenie. |
ReturnValue |
Pobiera lub ustawia wartość zwracaną obsłużonego zdarzenia. |
ShiftKeyPressed |
Wskazuje, czy klawisz SHIFT został naciśnięty po wystąpieniu tego zdarzenia. |
ToElement |
Pobiera wskaźnik HtmlElement myszy, w kierunku którego użytkownik przesuwa wskaźnik myszy. |
Metody
Equals(Object) |
Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object) |
GetHashCode() |
Służy jako domyślna funkcja skrótu. (Odziedziczone po Object) |
GetType() |
Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object) |
MemberwiseClone() |
Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object) |
ToString() |
Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object) |