Control.CreateAccessibilityInstance Method

Definition

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

Returns

AccessibleObject

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

Examples

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 utiliza 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.

En este fragmento de código se muestra cómo invalidar el método CreateAccessibilityInstance.This code excerpt demonstrates overriding the CreateAccessibilityInstance method. Vea la información general sobre 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 

Remarks

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.

Note

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

Notes to Inheritors

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.

Applies to

See also