Control.CreateAccessibilityInstance 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
为该控件创建一个新的辅助功能对象。
protected:
virtual System::Windows::Forms::AccessibleObject ^ CreateAccessibilityInstance();
protected virtual System.Windows.Forms.AccessibleObject CreateAccessibilityInstance ();
abstract member CreateAccessibilityInstance : unit -> System.Windows.Forms.AccessibleObject
override this.CreateAccessibilityInstance : unit -> System.Windows.Forms.AccessibleObject
Protected Overridable Function CreateAccessibilityInstance () As AccessibleObject
返回
控件的新 AccessibleObject。
示例
下面的代码示例演示了如何使用 AccessibleObject 和 Control.ControlAccessibleObject 类公开可访问性图表控件来创建辅助功能感知图表控件。 该控件绘制两条曲线以及图例。 派 ChartControlAccessibleObject
生自 ControlAccessibleObject
的 CreateAccessibilityInstance 类用于提供图表控件的自定义可访问信息。 由于图表图例不是基于实际 Control 控件,而是由图表控件绘制,因此它没有任何内置可访问信息。 因此,类 ChartControlAccessibleObject
会重写 GetChild 该方法以返回 CurveLegendAccessibleObject
表示图例的每个部分的可访问信息的方法。 当可访问感知应用程序使用此控件时,该控件可以提供必要的可访问信息。
此代码摘录演示了 CreateAccessibilityInstance 重写方法。 AccessibleObject有关完整的代码示例,请参阅类概述。
protected:
// Overridden to return the custom AccessibleObject
// for the entire chart.
virtual AccessibleObject^ CreateAccessibilityInstance() override
{
return gcnew ChartControlAccessibleObject( this );
}
// Overridden to return the custom AccessibleObject
// for the entire chart.
protected override AccessibleObject CreateAccessibilityInstance()
{
return new ChartControlAccessibleObject(this);
}
' Overridden to return the custom AccessibleObject
' for the entire chart.
Protected Overrides Function CreateAccessibilityInstance() As AccessibleObject
Return New ChartControlAccessibleObject(Me)
End Function
注解
如果不显式调用 CreateAccessibilityInstance 方法,则在引用 AccessibilityObject 属性时将会调用此方法。
备注
若要获取或设置AccessibilityObject属性,必须添加对Accessibility
随.NET Framework一起安装的程序集的引用。
继承者说明
在 CreateAccessibilityInstance() 派生类中重写时,请勿调用基类 CreateAccessibilityInstance() 的方法。