Control.CreateAccessibilityInstance メソッド


コントロールの新しいユーザー補助オブジェクトを作成します。Creates a new accessibility object for the control.

 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


コントロールの新しい AccessibleObjectA new AccessibleObject for the control.

次のコード例は、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. コントロールは、凡例と共に2つの曲線をプロットします。The control plots two curves along with a legend. ControlAccessibleObjectから派生した ChartControlAccessibleObject クラスは、CreateAccessibilityInstance メソッドでグラフコントロールにカスタムのユーザー補助情報を提供するために使用されます。The 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. このため、ChartControlAccessibleObject クラスは GetChild メソッドをオーバーライドして、凡例の各部分のアクセス可能な情報を表す CurveLegendAccessibleObject を返します。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. 完全なコード例については、AccessibleObject クラスの概要を参照してください。See the AccessibleObject class overview for the complete code example.

   // 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 プロパティを取得または設定するには、.NET Framework.NET Frameworkと共にインストールされた Accessibility アセンブリへの参照を追加する必要があります。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.