AccessibleSelection 枚举

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

指定选择辅助性对象的方式或该对象接收焦点的方式。

此枚举支持其成员值的按位组合。

C#

[System.Flags]
public enum AccessibleSelection

继承

Object

ValueType

Enum

AccessibleSelection

属性

FlagsAttribute

字段

名称	值	说明
AddSelection	8	将对象添至所选内容。
ExtendSelection	4	选择定位点和选定对象件之间的所有对象。
None	0	对象的选择或焦点不更改。
RemoveSelection	16	从所选内容中移除对象。
TakeFocus	1	将焦点分配到对象并使其作为定位点，即选择的起始点。 可与 TakeSelection、ExtendSelection、AddSelection 或 RemoveSelection 结合使用。
TakeSelection	2	选择该对象并取消对容器内所有其他对象的选择。

示例

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

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

C#

// Inner class ChartControlAccessibleObject represents accessible information associated with the ChartControl.
// The ChartControlAccessibleObject is returned in the ChartControl.CreateAccessibilityInstance override.
public class ChartControlAccessibleObject : ControlAccessibleObject
{
    ChartControl chartControl;

    public ChartControlAccessibleObject(ChartControl ctrl) : base(ctrl) 
    {
        chartControl = ctrl;
    }

    // Gets the role for the Chart. This is used by accessibility programs.
    public override AccessibleRole Role
    {  
        get {
            return AccessibleRole.Chart;
        }
    }

    // Gets the state for the Chart. This is used by accessibility programs.
    public override AccessibleStates State
    {  
        get {                    
            return AccessibleStates.ReadOnly;
        }
    }

    // The CurveLegend objects are "child" controls in terms of accessibility so 
    // return the number of ChartLengend objects.
    public override int GetChildCount()
    {  
        return chartControl.Legends.Length;
    }

    // Gets the Accessibility object of the child CurveLegend idetified by index.
    public override AccessibleObject GetChild(int index)
    {  
        if (index >= 0 && index < chartControl.Legends.Length) {
            return chartControl.Legends[index].AccessibilityObject;
        }                
        return null;
    }

    // Helper function that is used by the CurveLegend's accessibility object
    // to navigate between sibiling controls. Specifically, this function is used in
    // the CurveLegend.CurveLegendAccessibleObject.Navigate function.
    internal AccessibleObject NavigateFromChild(CurveLegend.CurveLegendAccessibleObject child, 
                                                AccessibleNavigation navdir) 
    {  
        switch(navdir) {
            case AccessibleNavigation.Down:
            case AccessibleNavigation.Next:
                return GetChild(child.ID + 1);
                
            case AccessibleNavigation.Up:
            case AccessibleNavigation.Previous:
                return GetChild(child.ID - 1);                        
        }
        return null;
    }

    // Helper function that is used by the CurveLegend's accessibility object
    // to select a specific CurveLegend control. Specifically, this function is used
    // in the CurveLegend.CurveLegendAccessibleObject.Select function.
    internal void SelectChild(CurveLegend.CurveLegendAccessibleObject child, AccessibleSelection selection) 
    {   
        int childID = child.ID;

        // Determine which selection action should occur, based on the
        // AccessibleSelection value.
        if ((selection & AccessibleSelection.TakeSelection) != 0) {
            for(int i = 0; i < chartControl.Legends.Length; i++) {
                if (i == childID) {
                    chartControl.Legends[i].Selected = true;                        
                } else {
                    chartControl.Legends[i].Selected = false;
                }
            }

            // AccessibleSelection.AddSelection means that the CurveLegend will be selected.
            if ((selection & AccessibleSelection.AddSelection) != 0) {
                chartControl.Legends[childID].Selected = true;                        
            }

            // AccessibleSelection.AddSelection means that the CurveLegend will be unselected.
            if ((selection & AccessibleSelection.RemoveSelection) != 0) {
                chartControl.Legends[childID].Selected = false;                        
            }
        }            
    }
}

注解

焦点对象是接收键盘输入的一个对象。 具有键盘焦点的对象是活动窗口或活动窗口的子对象。 所选对象被标记为参与某种类型的组操作。

此枚举由 AccessibleObject.Select使用。

有关辅助功能应用程序的其他信息，请在 Microsoft 开发人员网络 (MSDN) 库中搜索“Microsoft Active Accessibility”。

适用于

另请参阅

• AccessibleEvents
• AccessibleNavigation
• AccessibleObject
• AccessibleRole
• AccessibleStates