AccessibleEvents Перечисление

Ссылка

Определение

Пространство имен:: System.Windows.Forms

Сборка:: System.Windows.Forms.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Указывает события, переданные приложениями со специальными возможностями.

public enum class AccessibleEvents

public enum AccessibleEvents

type AccessibleEvents =

Public Enum AccessibleEvents

Наследование: Object

ValueType

Enum
AccessibleEvents

Поля

AcceleratorChange	32786	Свойство KeyboardShortcut объекта изменилось. Серверные приложения отправляют данное событие для объектов со специальными возможностями.
Create	32768	Объект создан. Операционная система отправляет данное событие для следующих элементов пользовательского интерфейса: точка вставки, заголовок, список, вкладка, панель инструментов, дерево и объект окна. Серверные приложения отправляют данное событие для объектов со специальными возможностями. Серверы должны отправлять данное событие для всех дочерних объектов объекта перед его отправкой родительскому объекту. Серверы должны гарантировать, что все дочерние объекты полностью созданы и готовы принимать вызовы от клиентов, когда родительский объект отправляет это событие.
DefaultActionChange	32785	Свойство DefaultAction объекта изменилось. Система отправляет данное событие для диалоговых окон. Серверные приложения отправляют данное событие для объектов со специальными возможностями. Поэтому серверным приложениям не требуется отправлять данное событие для дочерних объектов. В отличие от отображаемых объектов скрытые объекты имеют состояние Invisible. События типа `AccessibleEvents.Hide` показывают, что задано состояние Invisible. Поэтому в данном случае серверам не требуется отправлять событие `AccessibleEvents.StateChange`.
DescriptionChange	32781	Свойство Description объекта изменилось. Серверные приложения отправляют данное событие для объектов со специальными возможностями.
Destroy	32769	Объект был удален. Система отправляет данное событие для следующих элементов пользовательского интерфейса: точка вставки, заголовок, список, вкладка, панель инструментов, дерево и объект окна. Серверные приложения отправляют данное событие для объектов со специальными возможностями. Данное событие не обязательно отправлять для дочерних объектов. Однако, если родительский объект отправляет данное событие, клиенты могут заключить, что все дочерние объекты были уничтожены.
Focus	32773	Объект получил фокус клавиатуры. Система отправляет данное событие для следующих элементов пользовательского интерфейса: список, строка меню, меню быстрого вызова, окно переключения, вкладка, дерево и объект окна. Серверные приложения отправляют данное событие для объектов со специальными возможностями.
HelpChange	32784	Свойство Help объекта изменилось. Серверные приложения отправляют данное событие для объектов со специальными возможностями.
Hide	32771	Объект скрыт. Система отправляет событие для следующих элементов пользовательского интерфейса: точка вставки и курсор. Серверные приложения отправляют данное событие для объектов со специальными возможностями. При генерации события для родительского объекта все дочерние объекты уже скрыты. Поэтому серверным приложениям не требуется отправлять данное событие для дочерних объектов. Система согласованно не отправляет это событие.
LocationChange	32779	У объекта изменилось расположение, форма или размер. Система отправляет данное событие для следующих элементов пользовательского интерфейса: точка вставки и объект окна. Серверные приложения отправляют данное событие для объектов со специальными возможностями. Данное событие генерируется в ответ на изменившийся объект самого высокого уровня в иерархии объектов, а не для дочерних объектов, которые он может содержать. Например, если пользователь изменяет размеры окна, система отправляет данное уведомление для окна, а не для строки меню, строки заголовка, полос прокрутки или других изменившихся объектов. При перемещении родительского окна система не отправляет данное событие для каждого неплавающего дочернего окна. Однако если в результате изменения размеров приложение явно изменяет размеры дочерних окон, система отправляет несколько событий для изменившихся в размерах дочерних окон. Если для свойства State объекта задано значение Floating, серверы должны отправлять событие изменения расположения каждый раз, когда меняется расположение объекта. Если объект не имеет данного состояния, серверы должны вызывать данное событие, когда объект перемещает дочерний объект к родительскому.
NameChange	32780	Свойство Name объекта изменилось. Система отправляет данное событие для следующих элементов пользовательского интерфейса: флажок, курсор, список, кнопка, переключатель, строка состояния, дерево и объект окна. Серверные приложения отправляют данное событие для объектов со специальными возможностями.
ParentChange	32783	У объекта имеется новый родительский объект. Серверные приложения отправляют данное событие для объектов со специальными возможностями.
Reorder	32772	Объект контейнера добавил, удалил или переупорядочил дочерние объекты. Система отправляет данное событие для следующих элементов пользовательского интерфейса: заголовок, список, панель инструментов и объект окна. Серверные приложения при необходимости отправляют данное событие для объектов со специальными возможностями. Кроме того, родительское окно отправляет данное событие при изменении z-последовательности для дочерних окон.
Selection	32774	Выбран доступный объект в объекте контейнера. Данное событие соответствует единичному выделению. Либо был выделен дочерний объект в контейнере, который ранее не содержал каких-либо выделенных дочерних объектов, либо вместо одного дочернего объекта был выбран другой.
SelectionAdd	32775	К выделению был добавлен элемент в объекте контейнера. Система отправляет данное событие для следующих элементов пользовательского интерфейса: окно списка, элемент управления "Список" и элемент управления "Дерево". Серверные приложения отправляют данное событие для объектов со специальными возможностями. Данное событие сообщает о том, что к существующему выделению был добавлен дочерний объект.
SelectionRemove	32776	Из выделения был удален элемент из объекта контейнера. Система отправляет данное событие для следующих элементов пользовательского интерфейса: окно списка, элемент управления "Список" и элемент управления "Дерево". Серверные приложения отправляют данное событие для объектов со специальными возможностями. Данное событие сообщает, что из существующего выделения был удален дочерний объект.
SelectionWithin	32777	В объекте контейнера произошли изменения в выделении. Система отправляет данное событие спискам. Серверные приложения отправляют данное событие для объектов со специальными возможностями. Данное событие может быть послано, если выделенные элементы в элементе управления значительно изменились. Это событие сообщает клиенту, что в выделении произошли изменения. Это предпочтительнее, чем отправлять несколько событий `SelectionAdd` или `SelectionRemove`.
Show	32770	Отображается скрытый объект. Система отправляет данное событие для следующих элементов пользовательского интерфейса: знак вставки, курсор и объект окна. Серверные приложения отправляют данное событие для объектов со специальными возможностями. Если родительским объектом отправляется данное событие, клиенты могут заключить, что все дочерние объекты уже отображены. Поэтому серверным приложениям не требуется отправлять данное событие для дочерних объектов.
StateChange	32778	Состояние объекта изменилось. Система отправляет данное событие для следующих элементов пользовательского интерфейса: флажок, поле со списком, заголовок, кнопка, переключатель, полоса прокрутки, панель инструментов, дерево, стрелки вверх-вниз и объект окна. Серверные приложения отправляют данное событие для объектов со специальными возможностями. Например, изменение состояния может произойти, когда объект кнопки нажали или отпустили, либо включили или выключили объект. Система согласованно не отправляет это событие.
SystemAlert	2	Было сгенерировано предупреждение. Серверные приложения отправляют данное событие, когда происходит значимое изменение пользовательского интерфейса, о котором следует знать пользователю. Система согласованно не отправляет это событие для объектов диалоговых окон.
SystemCaptureEnd	9	Окно потеряло захват мыши. Это сообщение отправляется системой; сервер не отправляет это сообщение.
SystemCaptureStart	8	Происходит изменение размеров окна или его перемещение. Это сообщение отправляется системой; сервер не отправляет это сообщение.
SystemContextHelpEnd	13	Окно вышло из режима контекстной справки. Система согласованно не отправляет это событие.
SystemContextHelpStart	12	Окно вошло в режим контекстной справки. Система согласованно не отправляет это событие.
SystemDialogEnd	17	Диалоговое окно было закрыто. Система не отправляет это событие для стандартных диалоговых окон. Серверы отправляют данное событие для пользовательских диалоговых окон. Система согласованно не отправляет это событие.
SystemDialogStart	16	Диалоговое окно было отображено. Система отправляет данное событие для стандартных диалоговых окон. Серверы отправляют данное событие для пользовательских диалоговых окон. Система согласованно не отправляет это событие.
SystemDragDropEnd	15	Приложение выходит из режима перетаскивания. Приложения, поддерживающие операции перетаскивания, должны отправлять данное событие, а система — нет.
SystemDragDropStart	14	Приложение входит в режим перетаскивания. Приложения, поддерживающие операции перетаскивания, должны отправлять данное событие, а система — нет.
SystemForeground	3	Основное окно изменилось. Система отправляет данное событие, даже если основное окно сменяется другим окном в том же потоке. Серверные приложения никогда не отправляют данное событие.
SystemMenuEnd	5	Меню из строки меню было закрыто. Система отправляет данное событие для стандартных меню. Серверы отправляют данное событие для пользовательских меню.
SystemMenuPopupEnd	7	Меню быстрого вызова было закрыто. Система отправляет данное событие для стандартных меню. Серверы отправляют данное событие для пользовательских меню. При закрытии меню быстрого вызова клиент получает данное сообщение, за которым почти сразу же следует событие `SystemMenuEnd`. Система согласованно не отправляет это событие. Для вызова `TrackPopupMenu()`клиент увидит `EVENT_SYSTEM_MENUSTART` почти сразу после `EVENT_SYSTEM_MENUPOPUPSTART` отображения всплывающего окна.
SystemMenuPopupStart	6	Меню быстрого вызова было отображено. Система отправляет данное событие для стандартных меню. Серверы отправляют данное событие для пользовательских меню. Система согласованно не отправляет это событие. Для вызова `TrackPopupMenu()`клиент увидит `EVENT_SYSTEM_MENUSTART` почти сразу после `EVENT_SYSTEM_MENUPOPUPSTART` отображения всплывающего окна.
SystemMenuStart	4	В строке меню был выделен элемент меню. Система отправляет данное событие для стандартных меню. Серверы отправляют данное событие для пользовательских меню. Система может вызвать несколько событий `MenuStart`, которые не обязательно должны иметь соответствующее событие `MenuEnd`.
SystemMinimizeEnd	23	Объект окна был свернут или развернут во весь экран. Это сообщение отправляется системой; сервер не отправляет это сообщение.
SystemMinimizeStart	22	Объект окна сворачивается или разворачивается во весь экран. Это сообщение отправляется системой; сервер не отправляет это сообщение.
SystemMoveSizeEnd	11	Перемещение или изменение размеров окна завершено. Это сообщение отправляется системой; сервер не отправляет это сообщение.
SystemMoveSizeStart	10	Происходит изменение размеров окна или его перемещение. Это сообщение отправляется системой; сервер не отправляет это сообщение.
SystemScrollingEnd	19	На полосе прокрутки прокрутка закончилась. Система отправляет данное событие для полос прокрутки, прикрепленных к окну, и для стандартных элементов управления полосы прокрутки. Серверы отправляют данное событие для пользовательских полос прокрутки.
SystemScrollingStart	18	На полосе прокрутки началась прокрутка. Система отправляет данное событие для полос прокрутки, прикрепленных к окну, и для стандартных элементов управления полосы прокрутки. Серверы отправляют данное событие для пользовательских полос прокрутки.
SystemSound	1	Был воспроизведен звук. Система отправляет данное событие, когда воспроизводится системный звук, например для меню, даже если звука не слышно. Причиной может быть отсутствие звукового файла или звукового адаптера. Серверы отправляют это событие, если настраиваемый элемент пользовательского интерфейса генерирует звук.
SystemSwitchEnd	21	Пользователь отпустил клавиши ALT+TAB. Сообщение `SwitchEnd` отправляется системой; серверы не отправляют это сообщение. Если только одно приложение было запущено, когда пользователь нажал клавиши ALT+TAB, система отправляет событие `SwitchEnd` без соответствующего события `SwitchStart`.
SystemSwitchStart	20	Пользователь нажал клавиши ALT+TAB, что привело к активации окна переключения. Если в момент, когда пользователь нажал клавиши ALT+TAB, было запущено только одно приложение, система вызывает событие `SwitchEnd` без соответствующего события `SwitchStart`.
ValueChange	32782	Свойство Value объекта изменилось. Система вызывает событие `ValueChange` для следующих элементов пользовательского интерфейса: поле ввода, заголовок, сочетание клавиш, индикатор выполнения, полоса прокрутки, ползунок и стрелки вверх-вниз. Серверные приложения отправляют данное событие для объектов со специальными возможностями.

Примеры

В следующем примере кода показано создание элемента управления диаграммы с поддержкой специальных возможностей с помощью AccessibleObject классов и Control.ControlAccessibleObject предоставления доступной информации. Элемент управления отображает две кривые вместе с условным обозначениями. Класс ChartControlAccessibleObject , производный от ControlAccessibleObjectэтого, используется в CreateAccessibilityInstance методе для предоставления настраиваемых доступных сведений для элемента управления диаграммой. Так как условные обозначения диаграммы не являются фактическим Control элементом управления на основе, а рисуются элементом управления диаграммы, он не содержит встроенных доступных сведений. Из-за этого ChartControlAccessibleObject класс переопределяет GetChild метод, возвращающий CurveLegendAccessibleObject доступную информацию для каждой части условных обозначений. Если приложение, поддерживающее доступ, использует этот элемент управления, элемент управления может предоставить необходимую информацию.

В этом примере показано использование AccessibleEvents перечисления с методом AccessibilityNotifyClients . Полный пример кода см. в обзоре AccessibleObject класса.

   // Gets or sets the location for the curve legend.
   Point get()
   {
      return location;
   }

   void set( Point value )
   {
      location = value;
      chart->Invalidate();
      
      // Notifies the chart of the location change. This is used for
      // the accessibility information. AccessibleEvents::LocationChange
      // tells the chart the reason for the notification.
      chart->AccessibilityNotifyClients( AccessibleEvents::LocationChange, (dynamic_cast<CurveLegendAccessibleObject^>(AccessibilityObject))->ID );
   }

}

property String^ Name 
{

   // Gets or sets the Name for the curve legend.
   String^ get()
   {
      return name;
   }

   void set( String^ value )
   {
      if ( name != value )
      {
         name = value;
         chart->Invalidate();
         
         // Notifies the chart of the name change. This is used for
         // the accessibility information. AccessibleEvents::NameChange
         // tells the chart the reason for the notification.
         chart->AccessibilityNotifyClients( AccessibleEvents::NameChange, (dynamic_cast<CurveLegendAccessibleObject^>(AccessibilityObject))->ID );
      }
   }

}

property bool Selected 
{

   // Gets or sets the Selected state for the curve legend.
   bool get()
   {
      return selected;
   }

   void set( bool value )
   {
      if ( selected != value )
      {
         selected = value;
         chart->Invalidate();
         
         // Notifies the chart of the selection value change. This is used for
         // the accessibility information. The AccessibleEvents value depends upon
         // if the selection is true (AccessibleEvents::SelectionAdd) or
         // false (AccessibleEvents::SelectionRemove).
         chart->AccessibilityNotifyClients( selected ? AccessibleEvents::SelectionAdd : AccessibleEvents::SelectionRemove, (dynamic_cast<CurveLegendAccessibleObject^>(AccessibilityObject))->ID );
      }
   }

    // Gets or sets the location for the curve legend.
    public Point Location
    {   
        get {
            return location;
        }
        set {
            location = value;
            chart.Invalidate();

            // Notifies the chart of the location change. This is used for
            // the accessibility information. AccessibleEvents.LocationChange
            // tells the chart the reason for the notification.

            chart.AccessibilityNotifyClients(AccessibleEvents.LocationChange, 
                ((CurveLegendAccessibleObject)AccessibilityObject).ID);
        }
    }            

    // Gets or sets the Name for the curve legend.
    public string Name
    {   
        get {
            return name;
        }
        set {
            if (name != value) 
            {
                name = value;
                chart.Invalidate();

                // Notifies the chart of the name change. This is used for
                // the accessibility information. AccessibleEvents.NameChange
                // tells the chart the reason for the notification.

                chart.AccessibilityNotifyClients(AccessibleEvents.NameChange, 
                    ((CurveLegendAccessibleObject)AccessibilityObject).ID);
            }
        }
    }

    // Gets or sets the Selected state for the curve legend.
    public bool Selected
    {   
        get {
            return selected;
        }
        set {
            if (selected != value) 
            {
                selected = value;
                chart.Invalidate();

                // Notifies the chart of the selection value change. This is used for
                // the accessibility information. The AccessibleEvents value depends upon
                // if the selection is true (AccessibleEvents.SelectionAdd) or 
                // false (AccessibleEvents.SelectionRemove).
                chart.AccessibilityNotifyClients(
                    selected ? AccessibleEvents.SelectionAdd : AccessibleEvents.SelectionRemove, 
                    ((CurveLegendAccessibleObject)AccessibilityObject).ID);
            }
        }
    }

' Gets or sets the location for the curve legend.            
Public Property Location() As Point
    Get
        Return m_location
    End Get
    Set
        m_location = value
        chart.Invalidate()

        ' Notifies the chart of the location change. This is used for
        ' the accessibility information. AccessibleEvents.LocationChange
        ' tells the chart the reason for the notification.
        chart.ExposeAccessibilityNotifyClients(AccessibleEvents.LocationChange, _
                CType(AccessibilityObject, CurveLegendAccessibleObject).ID)
    End Set
End Property

' Gets or sets the Name for the curve legend.            
Public Property Name() As String
    Get
        Return m_name
    End Get
    Set
        If m_name <> value Then
            m_name = value
            chart.Invalidate()

            ' Notifies the chart of the name change. This is used for
            ' the accessibility information. AccessibleEvents.NameChange
            ' tells the chart the reason for the notification. 
            chart.ExposeAccessibilityNotifyClients(AccessibleEvents.NameChange, _
                    CType(AccessibilityObject, CurveLegendAccessibleObject).ID)
        End If
    End Set
End Property

' Gets or sets the Selected state for the curve legend.            
Public Property Selected() As Boolean
    Get
        Return m_selected
    End Get
    Set
        If m_selected <> value Then
            m_selected = value
            chart.Invalidate()

            ' Notifies the chart of the selection value change. This is used for
            ' the accessibility information. The AccessibleEvents value varies
            ' on whether the selection is true (AccessibleEvents.SelectionAdd) or 
            ' false (AccessibleEvents.SelectionRemove). 
            If m_selected Then
                chart.ExposeAccessibilityNotifyClients(AccessibleEvents.SelectionAdd, _
                        CType(AccessibilityObject, CurveLegendAccessibleObject).ID) 
            Else
                chart.ExposeAccessibilityNotifyClients(AccessibleEvents.SelectionRemove, _
                        CType(AccessibilityObject, CurveLegendAccessibleObject).ID) 
            End If
        End If
    End Set
End Property

Операционная система и приложения сервера специальных возможностей создают события специальных возможностей в ответ на изменения в пользовательском интерфейсе.

Это перечисление используется AccessibleObject и Control.

Дополнительные сведения см. в статье "Специальные возможности Microsoft Active".

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

AccessibleEvents Перечисление

Определение

Поля

Примеры

Комментарии

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

См. также раздел

Дополнительные ресурсы