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() 方法。
產品 | 版本 |
---|---|
.NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8 |
Windows Desktop | 3.0, 3.1, 5, 6, 7 |