AccessibleObject.Navigate(AccessibleNavigation) 方法

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

Source:

AccessibleObject.cs

定位到另一个辅助性对象。

C#

public virtual System.Windows.Forms.AccessibleObject? Navigate(System.Windows.Forms.AccessibleNavigation navdir);

参数

navdir

AccessibleNavigation

AccessibleNavigation 值之一。

返回

AccessibleObject

表示 AccessibleObject 值之一的 AccessibleNavigation。

例外

COMException

导航尝试失败。

示例

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

此代码演示了如何重写 Navigate 方法。 有关完整的代码示例， AccessibleObject 请参阅类概述。

C#

// Inner class CurveLegendAccessibleObject represents accessible information 
// associated with the CurveLegend object.
public class CurveLegendAccessibleObject : AccessibleObject
{
    private CurveLegend curveLegend;

    public CurveLegendAccessibleObject(CurveLegend curveLegend) : base() 
    {
        this.curveLegend = curveLegend;                    
    }                

    // Private property that helps get the reference to the parent ChartControl.
    private ChartControlAccessibleObject ChartControl
    {   
        get {
            return Parent as ChartControlAccessibleObject;
        }
    }

    // Internal helper function that returns the ID for this CurveLegend.
    internal int ID
    {
        get {
            for(int i = 0; i < ChartControl.GetChildCount(); i++) {
                if (ChartControl.GetChild(i) == this) {
                    return i;
                }
            }
            return -1;
        }
    }

    // Gets the Bounds for the CurveLegend. This is used by accessibility programs.
    public override Rectangle Bounds
    {
        get {                        
            // The bounds is in screen coordinates.
            Point loc = curveLegend.Location;
            return new Rectangle(curveLegend.chart.PointToScreen(loc), curveLegend.Size);
        }
    }

    // Gets or sets the Name for the CurveLegend. This is used by accessibility programs.
    public override string Name
    {
        get {
            return curveLegend.Name;
        }
        set {
            curveLegend.Name = value;                        
        }
    }

    // Gets the Curve Legend Parent's Accessible object.
    // This is used by accessibility programs.
    public override AccessibleObject Parent
    {
        get {
            return curveLegend.chart.AccessibilityObject;
        }
    }

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

    // Gets the state based on the selection for the CurveLegend. 
    // This is used by accessibility programs.
    public override AccessibleStates State 
    {
        get {
            AccessibleStates state = AccessibleStates.Selectable;
            if (curveLegend.Selected) 
            {
                state |= AccessibleStates.Selected;
            }
            return state;
        }
    }

    // Navigates through siblings of this CurveLegend. This is used by accessibility programs.
    public override AccessibleObject Navigate(AccessibleNavigation navdir) 
    {
        // Uses the internal NavigateFromChild helper function that exists
        // on ChartControlAccessibleObject.
        return ChartControl.NavigateFromChild(this, navdir);
    }

    // Selects or unselects this CurveLegend. This is used by accessibility programs.
    public override void Select(AccessibleSelection selection) 
    {
        // Uses the internal SelectChild helper function that exists
        // on ChartControlAccessibleObject.
        ChartControl.SelectChild(this, selection);
    }
}

注解

导航（空间和逻辑）始终仅限于容器中的用户界面元素。 使用空间导航，客户端只能导航到起始对象的同级。 根据用于逻辑导航的导航标志，客户端可以导航到起始对象的子级或同级。 此方法不会更改所选内容或焦点。 若要更改焦点或选择对象，请使用 Select。 方法 Navigate 仅检索具有定义屏幕位置的用户界面元素。

继承者说明

所有视觉对象都必须支持此方法。 如果对象具有 状态 Invisible，则导航到此隐藏对象可能会失败。 某些系统定义的界面元素（如菜单、菜单项和弹出菜单）允许导航到不可见的对象。 但是，其他系统定义的用户界面元素不支持此功能。 如果可能，服务器应支持导航到不可见的对象，但不需要此支持，客户端不应期望它。

适用于