Control.CreateAccessibilityInstance Metodo

Definizione

Crea un nuovo oggetto accessibilità per il controllo.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

Restituisce

Nuovo oggetto AccessibleObject per il controllo.A new AccessibleObject for the control.

Esempi

Nell'esempio di codice riportato di seguito viene illustrata la creazione di un controllo Chart in grado di riconoscere l'accessibilità utilizzando le classi AccessibleObject e Control.ControlAccessibleObject per esporre le informazioni accessibili.The following code example demonstrates the creation of an accessibility-aware chart control, using the AccessibleObject and Control.ControlAccessibleObject classes to expose accessible information. Il controllo traccia due curve insieme a una legenda.The control plots two curves along with a legend. La classe ChartControlAccessibleObject, che deriva da ControlAccessibleObject, viene utilizzata nel metodo CreateAccessibilityInstance per fornire informazioni personalizzate accessibili per il controllo Chart.The ChartControlAccessibleObject class, which derives from ControlAccessibleObject, is used in the CreateAccessibilityInstance method to provide custom accessible information for the chart control. Poiché la legenda del grafico non è un controllo effettivo basato su Control, ma viene invece disegnato dal controllo Chart, non vengono fornite informazioni incorporate accessibili.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. Per questo motivo, la classe ChartControlAccessibleObject esegue l'override del metodo GetChild per restituire il CurveLegendAccessibleObject che rappresenta le informazioni accessibili per ogni parte della legenda.Because of this, the ChartControlAccessibleObject class overrides the GetChild method to return the CurveLegendAccessibleObject that represents accessible information for each part of the legend. Quando un'applicazione in grado di riconoscere accessibilità utilizza questo controllo, il controllo può fornire le informazioni accessibili necessarie.When an accessible-aware application uses this control, the control can provide the necessary accessible information.

Questo estratto di codice illustra l'override del metodo CreateAccessibilityInstance.This code excerpt demonstrates overriding the CreateAccessibilityInstance method. Per l'esempio di codice completo, vedere Cenni preliminari sulla classe AccessibleObject.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 

Commenti

Se non si chiama in modo esplicito il metodo CreateAccessibilityInstance, verrà chiamato quando si crea un riferimento alla proprietà AccessibilityObject.If you do not explicitly call the CreateAccessibilityInstance method, it will be called when the AccessibilityObject property is referenced.

Nota

Per ottenere o impostare la proprietà AccessibilityObject, è necessario aggiungere un riferimento all'assembly Accessibility installato con il .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.

Note per gli eredi

Quando si esegue l'override di CreateAccessibilityInstance() in una classe derivata, non chiamare il metodo CreateAccessibilityInstance() della classe base.When overriding CreateAccessibilityInstance() in a derived class, do not call the base class's CreateAccessibilityInstance() method.

Si applica a

Vedi anche