Control.CreateAccessibilityInstance メソッドとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

Control.CreateAccessibilityInstance メソッド

コントロールの新しいユーザー補助オブジェクトを作成します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Protected Overridable Function
 CreateAccessibilityInstance As AccessibleObject

Visual Basic (使用法)

Dim returnValue As AccessibleObject

returnValue = Me.CreateAccessibilityInstance

protected virtual AccessibleObject CreateAccessibilityInstance
 ()

C++

protected:
virtual AccessibleObject^ CreateAccessibilityInstance ()

protected AccessibleObject CreateAccessibilityInstance ()

JScript

protected function CreateAccessibilityInstance
 () : AccessibleObject

戻り値
コントロールの新しい AccessibleObject。

解説

明示的に CreateAccessibilityInstance メソッドを呼び出さない場合は、AccessibilityObject プロパティが参照されると呼び出されます。

メモ
AccessibilityObject プロパティを取得または設定するには、.NET Framework と一緒にインストールされている Accessibility アセンブリへの参照を追加する必要があります。

継承時の注意 派生クラスで CreateAccessibilityInstance をオーバーライドする場合は、基本クラスの CreateAccessibilityInstance メソッドを呼び出さないでください。

使用例

ユーザー補助情報を公開する AccessibleObject クラスおよび Control.ControlAccessibleObject クラスを使用して、ユーザー補助対応のグラフコントロールを作成するコード例を次に示します。コントロールは、凡例に沿って 2 つの曲線をプロットします。ControlAccessibleObject から派生された ChartControlAccessibleObject クラスは、チャートコントロールの独自のユーザー補助情報を提供することを目的として、CreateAccessibilityInstance メソッドで使用します。チャートの凡例は実際の Control ベースのコントロールではなく、チャートコントロールによって描画されるため、組み込みのユーザー補助情報は含まれていません。このため、ChartControlAccessibleObject クラスは、GetChild メソッドをオーバーライドして、凡例の各部分のユーザー補助情報を表す CurveLegendAccessibleObject を返します。ユーザー補助対応のアプリケーションでこのコントロールが使用された場合、このコントロールは必要なユーザー補助情報を提供できます。

CreateAccessibilityInstance メソッドをオーバーライドする例を次に示します。コード例全体については、AccessibleObject クラスの概要を参照してください。

Visual Basic

' Overridden to return the custom AccessibleObject 
' for the entire chart.
Protected Overrides Function
 CreateAccessibilityInstance() As AccessibleObject
    Return New ChartControlAccessibleObject(Me)
End Function

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

C++

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 AccessibleObject CreateAccessibilityInstance()
{
    return new ChartControlAccessibleObject(this);
} //CreateAccessibilityInstance