Control.CreateAccessibilityInstance 方法

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

Source:

Control.cs

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

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 功能。

示例

下面的代码示例演示如何使用 AccessibleObject 和 Control.ControlAccessibleObject 类公开可访问性信息来创建可访问的图表控件。 控件绘制两条曲线以及图例。 ChartControlAccessibleObject类派生自ControlAccessibleObject，在CreateAccessibilityInstance方法中用于为图表控件提供自定义可访问信息。 由于图表图例不是实际的 Control -based 控件，而是由图表控件绘制，因此它没有任何内置的可访问信息。 因此， 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() 的方法。

另请参阅

• Control.ControlAccessibleObject
• AccessibleObject