AccessibleEvents Перечисление
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Указывает события, сообщаемые приложениями со специальными возможностями.
public enum class AccessibleEventspublic enum AccessibleEventstype AccessibleEvents = Public Enum AccessibleEvents- Наследование
Поля
| Имя | Значение | Описание |
|---|---|---|
| SystemSound | 1 | Звук был воспроизведен. Система отправляет это событие, когда системный звук, например для меню, воспроизводится, даже если звук не слышен. Это может быть вызвано отсутствием звукового файла или звуковой карты. Серверы отправляют это событие, если пользовательский элемент пользовательского интерфейса создает звук. |
| SystemAlert | 2 | Было создано оповещение. Серверные приложения отправляют это событие всякий раз, когда произошло важное изменение пользовательского интерфейса, о том, что пользователю может потребоваться знать об этом. Система не отправляет событие последовательно для объектов диалогового окна. |
| SystemForeground | 3 | Окно переднего плана изменилось. Система отправляет это событие, даже если окно переднего плана изменяется на другое окно в том же потоке. Серверные приложения никогда не отправляют это событие. |
| SystemMenuStart | 4 | Выбран элемент меню в строке меню. Система отправляет это событие для стандартных меню. Серверы отправляют это событие для пользовательских меню. Система может вызвать несколько |
| SystemMenuEnd | 5 | Меню из строки меню было закрыто. Система отправляет это событие для стандартных меню. Серверы отправляют это событие для пользовательских меню. |
| SystemMenuPopupStart | 6 | Отображалось контекстное меню. Система отправляет это событие для стандартных меню. Серверы отправляют это событие для пользовательских меню. Система не отправляет событие последовательно. Для вызова |
| SystemMenuPopupEnd | 7 | Контекстное меню было закрыто. Система отправляет это событие для стандартных меню. Серверы отправляют это событие для пользовательских меню. При закрытии контекстного меню клиент получает это сообщение почти сразу после Для вызова |
| SystemCaptureStart | 8 | Окно перемещается или изменяется. Система отправляет событие; серверы никогда не отправляют это событие. |
| SystemCaptureEnd | 9 | Окно потеряло запись мыши. Система отправляет событие; серверы никогда не отправляют это событие. |
| SystemMoveSizeStart | 10 | Окно перемещается или изменяется. Система отправляет событие; серверы никогда не отправляют это событие. |
| SystemMoveSizeEnd | 11 | Перемещение или изменение размера окна завершено. Система отправляет событие; серверы никогда не отправляют это событие. |
| SystemContextHelpStart | 12 | Окно ввело режим справки с учетом контекста. Система не отправляет событие последовательно. |
| SystemContextHelpEnd | 13 | Окно завершило режим справки с учетом контекста. Система не отправляет событие последовательно. |
| SystemDragDropStart | 14 | Приложение будет входить в режим перетаскивания. Приложения, поддерживающие операции перетаскивания, должны отправлять это событие; Система не поддерживается. |
| SystemDragDropEnd | 15 | Приложение будет выходить из режима перетаскивания. Приложения, поддерживающие операции перетаскивания, должны отправлять это событие; Система не поддерживается. |
| SystemDialogStart | 16 | Откроется диалоговое окно. Система отправляет событие для стандартных диалоговых окон. Серверы отправляют это событие для пользовательских диалоговых окон. Система не отправляет событие последовательно. |
| SystemDialogEnd | 17 | Диалоговое окно было закрыто. Система не отправляет событие для стандартных диалоговых окон. Серверы отправляют это событие для пользовательских диалоговых окон. Система не отправляет событие последовательно. |
| SystemScrollingStart | 18 | Прокрутка началась на полосе прокрутки. Система отправляет событие для полос прокрутки, подключенных к окну, и для стандартных элементов управления полосой прокрутки. Серверы отправляют это событие для пользовательских полос прокрутки. |
| SystemScrollingEnd | 19 | Прокрутка закончилась на полосе прокрутки. Система отправляет это событие для полос прокрутки, подключенных к окну, и для стандартных элементов управления полосой прокрутки. Серверы отправляют это событие для пользовательских полос прокрутки. |
| SystemSwitchStart | 20 | Пользователь нажимал клавиши ALT+TAB, которая активирует окно переключателя. Если только одно приложение выполняется, когда пользователь нажимает |
| SystemSwitchEnd | 21 | Пользователь выпустил ALT+TAB. Система отправляет |
| SystemMinimizeStart | 22 | Объект окна будет свернут или развернут. Система отправляет событие; серверы никогда не отправляют это событие. |
| SystemMinimizeEnd | 23 | Объект окна был свернут или развернут. Система отправляет событие; серверы никогда не отправляют это событие. |
| Create | 32768 | Был создан объект. Операционная система отправляет событие для следующих элементов пользовательского интерфейса: курсор, элемент управления заголовком, элемент управления представлением списка, элемент управления табуля, элемент управления панелью инструментов, элемент управления представлением дерева и объект окна. Серверные приложения отправляют это событие для своих доступных объектов. Серверы должны отправлять это событие для всех дочерних объектов объекта перед отправкой события для родительского объекта. Серверы должны убедиться, что все дочерние объекты полностью созданы и готовы принимать вызовы от клиентов, когда родительский объект отправляет событие. |
| Destroy | 32769 | Объект был уничтожен. Система отправляет это событие для следующих элементов пользовательского интерфейса: caret, заголовка, элемента управления представлением списка, элемента управления табуля, элемента управления панелью инструментов, элемента управления представлением дерева и объекта окна. Серверные приложения отправляют это событие для своих доступных объектов. Это событие может отправляться или не отправляться для дочерних объектов. Однако клиенты могут заключить, что все дочерние элементы объекта были уничтожены при отправке этого события родительского объекта. |
| Show | 32770 | Отображается скрытый объект. Система отправляет это событие для следующих элементов пользовательского интерфейса: курсора, курсора и объекта окна. Серверные приложения отправляют это событие для своих доступных объектов. Клиенты могут заключить, что, когда это событие отправляется родительским объектом, все дочерние объекты уже отображаются. Поэтому серверные приложения не должны отправлять это событие для дочерних объектов. |
| Hide | 32771 | Объект скрыт. Система отправляет событие для следующих элементов пользовательского интерфейса: caret и cursor. Серверные приложения отправляют событие для своих доступных объектов. Когда событие создается для родительского объекта, все дочерние объекты уже скрыты. Поэтому серверные приложения не должны отправлять событие для дочерних объектов. Система не отправляет событие последовательно. |
| Reorder | 32772 | Объект контейнера добавил, удалил или переупорядочение дочерних элементов. Система отправляет это событие для следующих элементов пользовательского интерфейса: элемент управления заголовком, элемент управления представлением списка, элемент управления панели инструментов и объект окна. Серверные приложения отправляют это событие соответствующим образом для своих доступных объектов. Это событие также отправляется родительским окном при изменении порядка z дочерних окон. |
| Focus | 32773 | Объект получил фокус клавиатуры. Система отправляет это событие для следующих элементов пользовательского интерфейса: элемент управления представлением списка, панель меню, контекстное меню, переключение окна, элемент управления вкладками, элемент управления представлением дерева и объект окна. Серверные приложения отправляют это событие для своих доступных объектов. |
| Selection | 32774 | Выбран доступный объект в объекте контейнера. Это событие сигнализирует об одном выборе. Либо дочерний элемент был выбран в контейнере, который ранее не содержал выбранных дочерних элементов, либо выбор изменился с одного дочернего на другой. |
| SelectionAdd | 32775 | Элемент в объекте контейнера был добавлен в выборку. Система отправляет это событие для следующих элементов пользовательского интерфейса: список, элемент управления представлением списка и элемент управления представлением дерева. Серверные приложения отправляют это событие для своих доступных объектов. Это событие сигнализирует о добавлении дочернего элемента в существующий выбор. |
| SelectionRemove | 32776 | Элемент в объекте контейнера был удален из выделенного фрагмента. Система отправляет это событие для следующих элементов пользовательского интерфейса: список, элемент управления представлением списка и элемент управления представлением дерева. Серверные приложения отправляют это событие для своих доступных объектов. Это событие сигнализирует о том, что дочерний элемент был удален из существующего выбора. |
| SelectionWithin | 32777 | В объекте контейнера произошли многочисленные изменения выбора. Система отправляет это событие для списков. Серверные приложения отправляют это событие для своих доступных объектов. Это событие можно отправить, когда выбранные элементы в элементе управления изменились существенно. Это событие сообщает клиенту о том, что произошло много изменений выбора. Это предпочтительнее для отправки нескольких |
| StateChange | 32778 | Состояние объекта изменилось. Система отправляет событие для следующих элементов пользовательского интерфейса: флажок, поле со списком, элемент управления заголовком, кнопка нажатия, переключатель, полоса прокрутки, панель инструментов, элемент управления представлением дерева, элемент управления вверх вниз и объект окна. Серверные приложения отправляют событие для своих доступных объектов. Например, изменение состояния может произойти при нажатии или освобождении объекта кнопки, а также при включении или отключении объекта. Система не отправляет событие последовательно. |
| LocationChange | 32779 | Объект изменил расположение, фигуру или размер. Система отправляет это событие для следующих элементов пользовательского интерфейса: курсор и объект окна. Серверные приложения отправляют это событие для своих доступных объектов. Это событие создается в ответ на объект верхнего уровня в иерархии объектов, который изменился, а не для каких-либо дочерних элементов. Например, если пользователь изменяет размер окна, система отправляет это уведомление для окна, но не для строки меню, заголовка, полос прокрутки или других объектов, которые также изменились. Система не отправляет это событие для каждого не плавающего дочернего окна при перемещении родительского элемента. Однако если приложение явно изменяет размер дочерних окон в результате изменения размера, система отправляет несколько событий для измененных дочерних элементов. Если для свойства объекта State задано Floatingзначение, серверы должны отправлять событие изменения расположения всякий раз, когда объект изменяет расположение. Если объект не имеет этого состояния, серверы должны вызывать это событие при перемещении объекта относительно родительского объекта. |
| NameChange | 32780 | Свойство объекта Name изменилось. Система отправляет это событие для следующих элементов пользовательского интерфейса: флажок, курсор, элемент управления представлением списка, кнопка нажатия, переключатель, элемент управления строкой состояния, элемент управления представлением дерева и объект окна. Серверные приложения отправляют это событие для своих доступных объектов. |
| DescriptionChange | 32781 | Свойство объекта Description изменилось. Серверные приложения отправляют это событие для своих доступных объектов. |
| ValueChange | 32782 | Свойство объекта Value изменилось. Система вызывает |
| ParentChange | 32783 | Объект имеет новый родительский объект. Серверные приложения отправляют это событие для своих доступных объектов. |
| HelpChange | 32784 | Свойство объекта Help изменилось. Серверные приложения отправляют это событие для своих доступных объектов. |
| DefaultActionChange | 32785 | Свойство объекта DefaultAction изменилось. Система отправляет это событие для диалоговых окон. Серверные приложения отправляют это событие для своих доступных объектов. Поэтому серверные приложения не должны отправлять это событие для дочерних объектов. Скрытые объекты имеют состояние Invisibleи не отображаются. События типа |
| AcceleratorChange | 32786 | Свойство объекта KeyboardShortcut изменилось. Серверные приложения отправляют событие для своих доступных объектов. |
Примеры
В следующем примере кода показано создание элемента управления диаграммы с поддержкой специальных возможностей с помощью AccessibleObject и Control.ControlAccessibleObject классов для предоставления доступной информации. Элемент управления отображает две кривые вместе с условным обозначениям. Класс ChartControlAccessibleObject , производный от ControlAccessibleObjectэтого, используется в методе CreateAccessibilityInstance для предоставления пользовательских доступных сведений для элемента управления диаграммой. Так как условные обозначения диаграммы не являются фактическим Control элементом управления -based, но вместо этого рисуется элементом управления диаграммы, он не имеет встроенных доступных сведений. Из-за этого 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 Accessibility.
