Бөлісу құралы:


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

Определение

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

public enum class AccessibleEvents
public enum AccessibleEvents
type AccessibleEvents = 
Public Enum AccessibleEvents
Наследование
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".

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

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