Control.CreateAccessibilityInstance Method

Definition

Crée un objet d'accessibilité pour le contrôle.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

Returns

AccessibleObject

Nouveau AccessibleObject pour le contrôle.A new AccessibleObject for the control.

Examples

L’exemple de code suivant illustre la création d’un contrôle de graphique prenant en charge l’accessibilité, à l’aide des classes AccessibleObject et Control.ControlAccessibleObject pour exposer des informations accessibles.The following code example demonstrates the creation of an accessibility-aware chart control, using the AccessibleObject and Control.ControlAccessibleObject classes to expose accessible information. Le contrôle trace deux courbes avec une légende.The control plots two curves along with a legend. La classe ChartControlAccessibleObject, qui dérive de ControlAccessibleObject, est utilisée dans la méthode CreateAccessibilityInstance pour fournir des informations accessibles personnalisées pour le contrôle Chart.The ChartControlAccessibleObject class, which derives from ControlAccessibleObject, is used in the CreateAccessibilityInstance method to provide custom accessible information for the chart control. Étant donné que la légende du graphique n’est pas un contrôle réel à base de Control, mais qu’elle est dessinée par le contrôle Chart, elle ne contient pas d’informations accessibles intégrées.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. Pour cette raison, la classe ChartControlAccessibleObject substitue la méthode GetChild pour retourner la CurveLegendAccessibleObject qui représente des informations accessibles pour chaque partie de la légende.Because of this, the ChartControlAccessibleObject class overrides the GetChild method to return the CurveLegendAccessibleObject that represents accessible information for each part of the legend. Lorsqu’une application qui prend en charge l’accès utilise ce contrôle, le contrôle peut fournir les informations accessibles nécessaires.When an accessible-aware application uses this control, the control can provide the necessary accessible information.

Cet extrait de code montre comment substituer la méthode CreateAccessibilityInstance.This code excerpt demonstrates overriding the CreateAccessibilityInstance method. Consultez la vue d’ensemble de la classe AccessibleObject pour obtenir un exemple de code complet.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 

Remarks

Si vous n'avez pas explicitement appelé la méthode CreateAccessibilityInstance, elle sera appelée lorsque la propriété AccessibilityObject sera référencée.If you do not explicitly call the CreateAccessibilityInstance method, it will be called when the AccessibilityObject property is referenced.

Note

Pour obtenir ou définir la propriété AccessibilityObject, vous devez ajouter une référence à l’assembly Accessibility installé avec le .NET Framework.NET Framework.To get or set the AccessibilityObject property, you must add a reference to the Accessibility assembly installed with the .NET Framework.NET Framework.

Notes to Inheritors

Lors de la substitution d' CreateAccessibilityInstance() dans une classe dérivée, n’appelez pas la méthode CreateAccessibilityInstance() de la classe de base.When overriding CreateAccessibilityInstance() in a derived class, do not call the base class's CreateAccessibilityInstance() method.

Applies to

See also