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

对象的状态已更改。 系统为下列用户界面元素发送此事件:复选框、组合框、标头控件、下压按钮、单选按钮、滚动条、工具栏控件、树视图控件、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

快捷菜单已关闭。 系统为标准菜单发送该事件。 服务器为自定义菜单发送该事件。 当快捷菜单关闭时,客户端会收到此消息,其后紧接着是 SystemMenuEnd 事件。 系统并不一贯发送该事件。

对于对 TrackPopupMenu () 的调用,客户端将几乎立即EVENT_SYSTEM_MENUPOPUPSTART看到EVENT_SYSTEM_MENUSTART显示弹出窗口。

SystemMenuPopupStart 6

快捷菜单已显示。 系统为标准菜单发送该事件。 服务器为自定义菜单发送该事件。 系统并不一贯发送该事件。

对于对 TrackPopupMenu () 的调用,客户端将几乎立即EVENT_SYSTEM_MENUPOPUPSTART看到EVENT_SYSTEM_MENUSTART显示弹出窗口。

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 事件:编辑控件、标头控件、热键控件、进度栏控件、滚动条、滑块控件和 up-down 控件。 服务器应用程序为它们的辅助性对象发送该事件。

示例

下面的代码示例演示了如何使用 AccessibleObjectControl.ControlAccessibleObject 类公开可访问性图表控件来创建辅助功能感知图表控件。 该控件绘制两条曲线以及图例。 派 ChartControlAccessibleObject 生自 ControlAccessibleObjectCreateAccessibilityInstance 类用于提供图表控件的自定义可访问信息。 由于图表图例不是基于实际 Control 控件,而是由图表控件绘制,因此它没有任何内置可访问信息。 因此,类 ChartControlAccessibleObject 会重写 GetChild 该方法以返回 CurveLegendAccessibleObject 表示图例的每个部分的可访问信息的方法。 当可访问感知应用程序使用此控件时,该控件可以提供必要的可访问信息。

此示例演示如何将 AccessibleEvents 枚举与方法结合使用 AccessibilityNotifyClientsAccessibleObject有关完整的代码示例,请参阅类概述。

   // 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

注解

操作系统和辅助功能服务器应用程序生成辅助功能事件,以响应用户界面中的更改。

此枚举由 AccessibleObjectControl..

有关详细信息,请参阅 Microsoft Active Accessibility

适用于

另请参阅