Control.CreateAccessibilityInstance 方法

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

为该控件创建一个新的辅助功能对象。

C#

protected virtual System.Windows.Forms.AccessibleObject CreateAccessibilityInstance ();

返回

AccessibleObject

控件的新 AccessibleObject。

示例

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

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

C#

// Overridden to return the custom AccessibleObject 
// for the entire chart.
protected override AccessibleObject CreateAccessibilityInstance() 
{            
    return new ChartControlAccessibleObject(this);
}

注解

如果不显式调用 CreateAccessibilityInstance 方法，则在引用 AccessibilityObject 属性时将会调用此方法。

备注

若要获取或设置AccessibilityObject属性，必须添加对Accessibility随.NET Framework一起安装的程序集的引用。

继承者说明

在 CreateAccessibilityInstance() 派生类中重写时，请勿调用基类 CreateAccessibilityInstance() 的方法。

适用于

另请参阅

• Control.ControlAccessibleObject
• AccessibleObject