Control.CreateAccessibilityInstance Control.CreateAccessibilityInstance Control.CreateAccessibilityInstance Control.CreateAccessibilityInstance Method

Definition

Erstellt ein neues Objekt für die Barrierefreiheit für das Steuerelement.Creates a new accessibility object for the control.

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

Beispiele

Das folgende Codebeispiel veranschaulicht die Erstellung eines Barrierefreiheits fähigen Diagramm Steuer Elements mithilfe der- AccessibleObject Klasse Control.ControlAccessibleObject und der-Klasse, um Barrierefreie Informationen verfügbar zu machen.The following code example demonstrates the creation of an accessibility-aware chart control, using the AccessibleObject and Control.ControlAccessibleObject classes to expose accessible information. Das-Steuerelement zeichnet zwei Kurven zusammen mit einer Legende.The control plots two curves along with a legend. Die ChartControlAccessibleObject -Klasse, die von ControlAccessibleObjectabgeleitet wird, wird in CreateAccessibilityInstance der-Methode verwendet, um benutzerdefinierte Informationen für das Diagramm Steuerelement bereitzustellen.The ChartControlAccessibleObject class, which derives from ControlAccessibleObject, is used in the CreateAccessibilityInstance method to provide custom accessible information for the chart control. Da die Diagramm Legende kein tatsächliches Control Steuerelement ist, sondern durch das Diagramm Steuerelement gezeichnet wird, sind keine integrierten zugänglichen Informationen verfügbar.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. Aus diesem Grund überschreibt ChartControlAccessibleObject die-Klasse die GetChild -Methode, um CurveLegendAccessibleObject das-Element zurückzugeben, das barrierefreie Informationen für jeden Teil der Legende darstellt.Because of this, the ChartControlAccessibleObject class overrides the GetChild method to return the CurveLegendAccessibleObject that represents accessible information for each part of the legend. Wenn eine barrierefreie Anwendung dieses Steuerelement verwendet, kann das Steuerelement die erforderlichen zugänglichen Informationen bereitstellen.When an accessible-aware application uses this control, the control can provide the necessary accessible information.

Dieser Code Ausschnitt veranschaulicht das über CreateAccessibilityInstance Schreiben der-Methode.This code excerpt demonstrates overriding the CreateAccessibilityInstance method. Das gesamte AccessibleObject Codebeispiel finden Sie in der Übersicht über die-Klasse.See the AccessibleObject class overview for the complete code example.

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.If you do not explicitly call the CreateAccessibilityInstance method, it will be called when the AccessibilityObject property is referenced.

Hinweis

Um die AccessibilityObject -Eigenschaft zu erhalten oder festzulegen, müssen Sie einen Verweis Accessibility auf die Assembly hinzu .NET Framework.NET Frameworkfügen, die mit dem installiert wurde.To get or set the AccessibilityObject property, you must add a reference to the Accessibility assembly installed with the .NET Framework.NET Framework.

Hinweise für Vererber

Wenn Sie CreateAccessibilityInstance() in einer abgeleiteten Klasse überschreiben, sollten Sie die-Methode der Basisklasse nicht aufzurufen. CreateAccessibilityInstance()When overriding CreateAccessibilityInstance() in a derived class, do not call the base class's CreateAccessibilityInstance() method.

Gilt für:

Siehe auch