HtmlElementEventArgs Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет данные для событий, которые определены в HtmlDocument и HtmlElement.
public ref class HtmlElementEventArgs sealed : EventArgs
public sealed class HtmlElementEventArgs : EventArgs
type HtmlElementEventArgs = class
inherit EventArgs
Public NotInheritable Class HtmlElementEventArgs
Inherits EventArgs
- Наследование
Примеры
В следующем примере кода показано использование этого типа. В этом примере обработчик событий сообщает о возникновении Click события. Этот отчет поможет вам узнать, когда происходит событие, и поможет вам в отладке. Чтобы сообщить о нескольких событиях или о событиях, которые происходят часто, рекомендуется заменить ShowConsole.WriteLine сообщение или добавить его в многостроочный TextBox.
Чтобы выполнить пример кода, вставьте его в проект, содержащий экземпляр типа HtmlDocument с именем HtmlDocument1
. Затем убедитесь, что обработчик событий связан с событием 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
Комментарии
HtmlElementEventArgs инкапсулирует те же сведения, что и в объекте window.event
при программировании на основе неуправляемой модели HTML DOM или при написании активного скрипта для HTML-страниц.
В большинстве случаев можно использовать для ToElement поиска ЭЛЕМЕНТА HTML, получающего действие события, и FromElement для поиска остающегося HTML-элемента. Однако не каждое событие предоставляет значение для этих свойств.
Многие события в HTML DOM отправляются в родительские элементы, если они не отменены. Это называется восходящим событием. Если элемент SPAN
управления DIV
получает щелчок, то событие щелчка возникает для SPAN
первого элемента, затем для DIV
элемента HTML-страницы и, наконец, для элемента HTML-страницы BODY
.
BubbleEvent определяет, ведет ли событие таким образом.
Свойства
AltKeyPressed |
Показывает, была ли нажата клавиша ALT, когда произошло это событие. |
BubbleEvent |
Получает или задает значение, указывающее, проходит ли текущее событие восходящую маршрутизацию по иерархии элементов модели HTML DOM. |
ClientMousePosition |
Получает или задает положение указателя мыши в клиентской области документа. |
CtrlKeyPressed |
Показывает, была ли нажата клавиша CTRL, когда произошло это событие. |
EventType |
Возвращает имя произошедшего события. |
FromElement |
Получает элемент HtmlElement, от которого удаляется указатель мыши. |
KeyPressedCode |
Получает код ASCII для символа, введенного с клавиатуры и вызвавшего событие KeyPress, KeyDown или KeyUp. |
MouseButtonsPressed |
Получает код кнопки мыши, которая была нажата во время события MouseDown или MouseUp. |
MousePosition |
Получает или задает положение указателя мыши относительно родительского элемента с относительным расположением. |
OffsetMousePosition |
Получает или задает положение указателя мыши относительно элемента, который вызывает событие. |
ReturnValue |
Получает или задает возвращаемое значение обрабатываемого события. |
ShiftKeyPressed |
Показывает, была ли нажата клавиша SHIFT в тот момент, когда произошло это событие. |
ToElement |
Получает элемент HtmlElement, к которому пользователь подводит указатель мыши. |
Методы
Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
GetType() |
Возвращает объект Type для текущего экземпляра. (Унаследовано от Object) |
MemberwiseClone() |
Создает неполную копию текущего объекта Object. (Унаследовано от Object) |
ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |