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 屬性,您必須新增與 .NET Framework 一起安裝的元件參考 Accessibility
。
給繼承者的注意事項
在 CreateAccessibilityInstance() 衍生類別中覆寫時,請勿呼叫基類的 CreateAccessibilityInstance() 方法。