Control.CreateAccessibilityInstance Método

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

Nuevo AccessibleObject del control.A new AccessibleObject for the control.

Ejemplos

En el ejemplo de código siguiente se muestra la creación de un control de gráfico con reconocimiento de accesibilidad mediante las clases AccessibleObject y Control.ControlAccessibleObject 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. La clase ChartControlAccessibleObject, que se deriva de ControlAccessibleObject, se usa en el método CreateAccessibilityInstance para proporcionar información de acceso personalizado 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 control basado en Control real, sino que se dibuja mediante el control Chart, no es ninguna información accesible integrada.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, la clase ChartControlAccessibleObject invalida el método GetChild para devolver el CurveLegendAccessibleObject que representa información accesible para 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 compatible con acceso utiliza este control, el control puede proporcionar la información accesible necesaria.When an accessible-aware application uses this control, the control can provide the necessary accessible information.

Este fragmento de código muestra cómo invalidar el método CreateAccessibilityInstance.This code excerpt demonstrates overriding the CreateAccessibilityInstance method. Vea la información general de la clase AccessibleObject para obtener 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 la propiedad AccessibilityObject, debe agregar una referencia al ensamblado Accessibility instalado con .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

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

Se aplica a

Consulte también: