Control.CreateAccessibilityInstance Methode

Definition

Erstellt ein neues Barrierefreiheitsobjekt 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

AccessibleObject

Ein neues AccessibleObject für das Steuerelement.A new AccessibleObject for the control.

Beispiele

Das folgende Codebeispiel veranschaulicht die Erstellung eines Barrierefreiheits fähigen Diagramm Steuer Elements mithilfe der AccessibleObject-und Control.ControlAccessibleObject Klassen, 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 der CreateAccessibilityInstance-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 basiertes Steuerelement ist, sondern stattdessen vom 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 die ChartControlAccessibleObject Klasse die GetChild-Methode, um die CurveLegendAccessibleObject zurückzugeben, die 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 Überschreiben der CreateAccessibilityInstance-Methode.This code excerpt demonstrates overriding the CreateAccessibilityInstance method. Das gesamte Codebeispiel finden Sie in der Übersicht über AccessibleObject-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 auf die mit dem .NET Framework.NET Frameworkinstallierte Accessibility Assembly hinzufügen.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, müssen Sie die CreateAccessibilityInstance()-Methode der Basisklasse nicht aufzurufen.When overriding CreateAccessibilityInstance() in a derived class, do not call the base class's CreateAccessibilityInstance() method.

Gilt für:

Siehe auch