HtmlElementEventArgs Класс

Определение

Предоставляет данные для событий, которые определены в HtmlDocument и 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
Наследование
HtmlElementEventArgs

Примеры

В следующем примере кода демонстрируется использование этого типа.The following code example demonstrates the use of this type. В этом примере обработчик событий сообщает о возникновении события Click.In the example, an event handler reports on the occurrence of the Click event. Этот отчет поможет вам узнать, когда происходит событие и может помочь при отладке.This report helps you to learn when the event occurs and can assist you in debugging. Чтобы сообщить о нескольких событиях или о событиях, которые происходят часто, рассмотрите возможность замены Show на Console.WriteLine или Добавление сообщения в многострочный 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.

Чтобы выполнить пример кода, вставьте его в проект, содержащий экземпляр типа HtmlDocument с именем HtmlDocument1.To run the example code, paste it into a project that contains an instance of type HtmlDocument named HtmlDocument1. Затем убедитесь, что обработчик событий связан с событием 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

Комментарии

HtmlElementEventArgs инкапсулирует ту же информацию, что и объект window.event, при программировании на неуправляемую модель DOM HTML или при написании активного скрипта для 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.

В большинстве случаев можно использовать ToElement, чтобы найти HTML-элемент, который получает действие события, и FromElement, чтобы найти HTML-элемент, который не вызывается текущим событием.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. Однако не каждое событие предоставляет значение для этих свойств. см. документацию по управляемой документации для события или соответствующую документацию в документации пакета SDK для Internet Explorer, чтобы узнать, поставляет ли это событие.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.

Многие события в HTML DOM отправляются в свои родительские элементы, если они не отменены.Many events in the HTML DOM are sent to their parent elements unless they are cancelled. Это называется восходящей маршрутизацией событий.This is known as event bubbling. Если SPAN в DIV получает щелчок, то сначала вызывается событие Click для SPAN, затем для DIVи, наконец, для элемента BODY 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 определяет, будет ли событие работать таким образом.BubbleEvent controls whether an event will behave in this manner or not.

Свойства

AltKeyPressed

Показывает, была ли нажата клавиша ALT, когда произошло это событие.Indicates whether the ALT key was pressed when this event occurred.

BubbleEvent

Получает или задает значение, указывающее, проходит ли текущее событие восходящую маршрутизацию по иерархии элементов модели HTML DOM.Gets or sets a value indicating whether the current event bubbles up through the element hierarchy of the HTML Document Object Model.

ClientMousePosition

Получает или задает положение указателя мыши в клиентской области документа.Gets or sets the position of the mouse cursor in the document's client area.

CtrlKeyPressed

Показывает, была ли нажата клавиша CTRL, когда произошло это событие.Indicates whether the CTRL key was pressed when this event occurred.

EventType

Возвращает имя произошедшего события.Gets the name of the event that was raised.

FromElement

Получает элемент HtmlElement, от которого удаляется указатель мыши.Gets the HtmlElement the mouse pointer is moving away from.

KeyPressedCode

Получает код ASCII для символа, введенного с клавиатуры и вызвавшего событие KeyPress, KeyDown или KeyUp.Gets the ASCII value of the keyboard character typed in a KeyPress, KeyDown, or KeyUp event.

MouseButtonsPressed

Получает код кнопки мыши, которая была нажата во время события MouseDown или MouseUp.Gets the mouse button that was clicked during a MouseDown or MouseUp event.

MousePosition

Получает или задает положение указателя мыши относительно родительского элемента с относительным расположением.Gets or sets the position of the mouse cursor relative to a relatively positioned parent element.

OffsetMousePosition

Получает или задает положение указателя мыши относительно элемента, который вызывает событие.Gets or sets the position of the mouse cursor relative to the element that raises the event.

ReturnValue

Получает или задает возвращаемое значение обрабатываемого события.Gets or sets the return value of the handled event.

ShiftKeyPressed

Показывает, была ли нажата клавиша SHIFT в тот момент, когда произошло это событие.Indicates whether the SHIFT key was pressed when this event occurred.

ToElement

Получает элемент HtmlElement, к которому пользователь подводит указатель мыши.Gets the HtmlElement toward which the user is moving the mouse pointer.

Методы

Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)

Применяется к

Дополнительно