Control.CreateAccessibilityInstance Control.CreateAccessibilityInstance Control.CreateAccessibilityInstance Control.CreateAccessibilityInstance Method

定义

为该控件创建一个新的辅助功能对象。Creates a new accessibility object for the control.

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并使用和Control.ControlAccessibleObject类公开可访问的信息。The following code example demonstrates the creation of an accessibility-aware chart control, using the AccessibleObject and Control.ControlAccessibleObject classes to expose accessible information. 控件将两条曲线与图例一起绘制。The control plots two curves along with a legend. CreateAccessibilityInstanceChartControlAccessibleObject 派生的类在方法中用于为图表控件提供自定义的可访问信息。ControlAccessibleObjectThe ChartControlAccessibleObject class, which derives from ControlAccessibleObject, is used in the CreateAccessibilityInstance method to provide custom accessible information for the chart control. 因为图表图例不是实际Control的控件,而是由图表控件绘制的,所以它不是任何内置的可访问信息。Since the chart legend is not an actual Control -based control, but instead is drawn by the chart control, it does not any built-in accessible information. 因此, ChartControlAccessibleObjectCurveLegendAccessibleObjectGetChild重写方法以返回,该方法表示图例的每个部分的可访问信息。Because of this, the ChartControlAccessibleObject class overrides the GetChild method to return the CurveLegendAccessibleObject that represents accessible information for each part of the legend. 当可访问感知的应用程序使用此控件时,控件可以提供必需的可访问信息。When an accessible-aware application uses this control, the control can provide the necessary accessible information.

此代码摘录演示了如何CreateAccessibilityInstance重写方法。This code excerpt demonstrates overriding the CreateAccessibilityInstance method. 有关完整的代码示例,请参阅类概述。AccessibleObjectSee the AccessibleObject class overview for the complete code example.

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 属性时将会调用此方法。If you do not explicitly call the CreateAccessibilityInstance method, it will be called when the AccessibilityObject property is referenced.

备注

若要获取或设置AccessibilityObject属性,必须添加Accessibility对随.NET Framework.NET Framework安装的程序集的引用。To get or set the AccessibilityObject property, you must add a reference to the Accessibility assembly installed with the .NET Framework.NET Framework.

继承者说明

当在CreateAccessibilityInstance()派生类中重写时,请勿调用基类的CreateAccessibilityInstance()方法。When overriding CreateAccessibilityInstance() in a derived class, do not call the base class's CreateAccessibilityInstance() method.

适用于

另请参阅