AccessibleEvents 枚举
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
指定由辅助性应用程序报告的事件。
public enum class AccessibleEvents
public enum AccessibleEvents
type AccessibleEvents =
Public Enum AccessibleEvents
- 继承
字段
AcceleratorChange | 32786 | 对象的 KeyboardShortcut 属性已更改。 服务器应用程序为它们的辅助性对象发送该事件。 |
Create | 32768 | 对象已创建。 操作系统为下列用户界面元素发送该事件:插入符号、标头控件、列表视图控件、选项卡控件、工具栏控件、树视图控件和窗口对象。 服务器应用程序为它们的辅助性对象发送该事件。 服务器必须在为父对象发送该对象之前为对象的所有子对象发送该事件。 服务器必须确保所有的子对象都已完全创建,并且已准备好在父对象发送事件时接受来自客户端的呼叫。 |
DefaultActionChange | 32785 | 对象的 DefaultAction 属性已更改。 操作系统为对话框发送该事件。 服务器应用程序为它们的辅助性对象发送该事件。 因此,服务器应用程序不需要为子对象发送该事件。 隐藏的对象具有状态 Invisible,而显示的对象没有此状态。 |
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 | 容器对象中发生了多次选择内容更改。 系统为列表框发送此事件。 服务器应用程序为它们的辅助性对象发送该事件。 如果控件中的选定项已发生重大更改,则会发送此事件。 此事件通知客户端已发生大量选择内容更改。 最好发送若干 |
Show | 32770 | 正在显示隐藏对象。 系统为下列用户界面元素发送此事件:插入符号、光标和窗口对象。 服务器应用程序为它们的辅助性对象发送该事件。 客户端可以得出结论:当事件由父对象发送时,所有子对象均已显示。 因此,服务器应用程序不需要为子对象发送该事件。 |
StateChange | 32778 | 对象的状态已更改。 系统为下列用户界面元素发送此事件:复选框、组合框、标头控件、下压按钮、单选按钮、滚动条、工具栏控件、树视图控件、up-down 控件和窗口对象。 服务器应用程序为它们的辅助性对象发送该事件。 例如,当已按下或松开按钮对象时,或者当正在启用或禁用对象时,可发生状态更改。 系统并不一贯发送该事件。 |
SystemAlert | 2 | 警报已生成。 每当发生重要的用户界面更改且用户可能需要知道这一更改发生时,服务器应用程序就会发送此事件。 系统并不一贯为对话框对象发送该事件。 |
SystemCaptureEnd | 9 | 窗口已丢失鼠标捕获。 系统发送该事件;服务器从不发送该事件。 |
SystemCaptureStart | 8 | 正在移动窗口或调整窗口的大小。 系统发送该事件;服务器从不发送该事件。 |
SystemContextHelpEnd | 13 | 窗口退出了区分上下文的帮助模式。 系统并不一贯发送该事件。 |
SystemContextHelpStart | 12 | 窗口进入了区分上下文的帮助模式。 系统并不一贯发送该事件。 |
SystemDialogEnd | 17 | 对话框已关闭。 系统不为标准对话框发送该事件。 服务器为自定义对话框发送该事件。 系统并不一贯发送该事件。 |
SystemDialogStart | 16 | 对话框已显示。 系统为标准对话框发送该事件。 服务器为自定义对话框发送该事件。 系统并不一贯发送该事件。 |
SystemDragDropEnd | 15 | 应用程序将退出拖放模式。 支持拖放操作的应用程序必须发送该事件;系统不发送该事件。 |
SystemDragDropStart | 14 | 应用程序将进入拖放模式。 支持拖放操作的应用程序必须发送该事件;系统不发送该事件。 |
SystemForeground | 3 | 前景窗口已更改。 如果前景窗口更改为同一线程中的另一窗口,系统就会发送该事件。 服务器应用程序从不发送该事件。 |
SystemMenuEnd | 5 | 菜单栏中的菜单已关闭。 系统为标准菜单发送该事件。 服务器为自定义菜单发送该事件。 |
SystemMenuPopupEnd | 7 | 快捷菜单已关闭。 系统为标准菜单发送该事件。 服务器为自定义菜单发送该事件。 当快捷菜单关闭时,客户端会收到此消息,其后紧接着是 对于 |
SystemMenuPopupStart | 6 | 快捷菜单已显示。 系统为标准菜单发送该事件。 服务器为自定义菜单发送该事件。 系统并不一贯发送该事件。 对于 |
SystemMenuStart | 4 | 菜单栏上的菜单项已选定。 系统为标准菜单发送该事件。 服务器为自定义菜单发送该事件。 系统可能会引发多个 |
SystemMinimizeEnd | 23 | 窗口对象已最小化或最大化。 系统发送该事件;服务器从不发送该事件。 |
SystemMinimizeStart | 22 | 窗口对象将最小化或最大化。 系统发送该事件;服务器从不发送该事件。 |
SystemMoveSizeEnd | 11 | 已完成窗口的移动或大小调整。 系统发送该事件;服务器从不发送该事件。 |
SystemMoveSizeStart | 10 | 正在移动窗口或调整窗口的大小。 系统发送该事件;服务器从不发送该事件。 |
SystemScrollingEnd | 19 | 滚动条上的滚动已经结束。 系统为窗口所附加的滚动条和标准滚动条控件发送该事件。 服务器为自定义滚动条发送该事件。 |
SystemScrollingStart | 18 | 滚动条上的滚动已经开始。 系统为窗口附加的滚动条和标准滚动条控件发送该事件。 服务器为自定义滚动条发送该事件。 |
SystemSound | 1 | 声音已播放。 系统会在播放系统声音(例如用于菜单的声音)时发送该事件,即使听不到任何声音。 这有可能是由于缺少声音文件或声卡造成的。 如果自定义的用户界面元素生成声音,服务器将发送此事件。 |
SystemSwitchEnd | 21 | 用户松开了 Alt+Tab 组合键。 系统发送 |
SystemSwitchStart | 20 | 用户按下了激活切换窗口的 Alt+Tab 组合键。 如果当用户按下 Alt+Tab 组合键时只有一个应用程序在运行,系统就在没有对应的 |
ValueChange | 32782 | 对象的 Value 属性已更改。 系统为下列用户界面元素引发 |
示例
下面的代码示例演示了如何使用 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 Accessibility。