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

Definición

Crea un nuevo objeto de accesibilidad para el control.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

Devoluciones

Ejemplos

En el ejemplo de código siguiente se muestra la creación de un gráfico de accesibilidad para controlar, mediante el AccessibleObject y Control.ControlAccessibleObject clases para exponer información accesible.The following code example demonstrates the creation of an accessibility-aware chart control, using the AccessibleObject and Control.ControlAccessibleObject classes to expose accessible information. El control traza dos curvas junto con una leyenda.The control plots two curves along with a legend. El ChartControlAccessibleObject (clase), que se deriva de ControlAccessibleObject, se usa en el CreateAccessibilityInstance método para proporcionar información personalizada accesible para el control chart.The ChartControlAccessibleObject class, which derives from ControlAccessibleObject, is used in the CreateAccessibilityInstance method to provide custom accessible information for the chart control. Dado que la leyenda del gráfico no es un real Control -control basado en, pero en su lugar se dibuja mediante el control chart, lo hace no ninguna información accesible.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. Por este motivo, el ChartControlAccessibleObject clase invalida el GetChild método para devolver el CurveLegendAccessibleObject que representa la información accesible de cada parte de la leyenda.Because of this, the ChartControlAccessibleObject class overrides the GetChild method to return the CurveLegendAccessibleObject that represents accessible information for each part of the legend. Cuando una aplicación accesible para usa este control, el control puede proporcionar la información de acceso necesaria.When an accessible-aware application uses this control, the control can provide the necessary accessible information.

Este fragmento de código se muestra cómo reemplazar el CreateAccessibilityInstance método.This code excerpt demonstrates overriding the CreateAccessibilityInstance method. Consulte la AccessibleObject información general de clases para el ejemplo de código completo.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 

Comentarios

Si no se llama de forma explícita al método CreateAccessibilityInstance, se llamará a este método al hacer referencia a la propiedad AccessibilityObject.If you do not explicitly call the CreateAccessibilityInstance method, it will be called when the AccessibilityObject property is referenced.

Nota

Para obtener o establecer el AccessibilityObject propiedad, debe agregar una referencia a la Accessibility ensamblado instalado con el .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.

Notas a los desarrolladores de herederos

Cuando se reemplaza CreateAccessibilityInstance() en una clase derivada, no llame a la clase base CreateAccessibilityInstance() método.When overriding CreateAccessibilityInstance() in a derived class, do not call the base class's CreateAccessibilityInstance() method.

Se aplica a

Consulte también: