Control.CreateAccessibilityInstance Methode

  • Referenz

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Erstellt ein neues Objekt für die Barrierefreiheit für das Steuerelement.

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

Gibt zurück

AccessibleObject

Ein neues AccessibleObject für das Steuerelement.

Beispiele

Im folgenden Codebeispiel wird die Erstellung eines Barrierefreiheits-Diagrammsteuerelements mithilfe der AccessibleObject klassen Control.ControlAccessibleObject veranschaulicht, um barrierefreie Informationen verfügbar zu machen. Das Steuerelement zeichnet zwei Kurven zusammen mit einer Legende. Die ChartControlAccessibleObject Klasse, von ControlAccessibleObjectder abgeleitet wird, wird in der CreateAccessibilityInstance Methode verwendet, um benutzerdefinierte barrierefreie Informationen für das Diagrammsteuerelement bereitzustellen. Da die Diagrammlegende kein tatsächliches Control -basiertes Steuerelement ist, sondern vom Diagrammsteuerelement gezeichnet wird, werden keine integrierten barrierefreien Informationen verwendet. Aus diesem Grund überschreibt die ChartControlAccessibleObject Klasse die Methode, um die GetChild CurveLegendAccessibleObject barrierefreien Informationen für jeden Teil der Legende zurückzugeben. Wenn eine barrierefreie Anwendung dieses Steuerelements verwendet, kann das Steuerelement die erforderlichen barrierefreien Informationen bereitstellen.

Dieser Codeauszug veranschaulicht das Außerkraftsetzen der CreateAccessibilityInstance Methode. Weitere Informationen finden Sie in der AccessibleObject Klassenübersicht für das vollständige Codebeispiel.

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

Hinweise

Wenn Sie die CreateAccessibilityInstance-Methode nicht explizit aufrufen, wird sie beim Verweis auf die AccessibilityObject-Eigenschaft aufgerufen.

Hinweis

Um die AccessibilityObject Eigenschaft abzurufen oder festzulegen, müssen Sie einen Verweis auf die Assembly hinzufügen, die Accessibility mit dem .NET Framework installiert ist.

Hinweise für Vererber

Wenn sie in einer abgeleiteten Klasse außer Kraft CreateAccessibilityInstance() gesetzt werden, rufen Sie die Methode der Basisklasse CreateAccessibilityInstance() nicht auf.

Gilt für

Siehe auch