Control.CreateAccessibilityInstance Metodo

Definizione

Crea un nuovo oggetto di 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

AccessibleObject

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

Esempio

Nell'esempio di codice seguente viene illustrata la creazione di un controllo Chart compatibile con l'accessibilità, utilizzando le AccessibleObject Control.ControlAccessibleObject classi e 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 ChartControlAccessibleObject classe, che deriva da ControlAccessibleObject , viene utilizzata nel CreateAccessibilityInstance metodo 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 Control controllo basato su effettivi, ma viene invece disegnata 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 ChartControlAccessibleObject classe esegue l'override del GetChild metodo per restituire l'oggetto 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 CreateAccessibilityInstance metodo.This code excerpt demonstrates overriding the CreateAccessibilityInstance method. AccessibleObjectPer l'esempio di codice completo, vedere Cenni preliminari sulla classe.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 AccessibilityObject proprietà, è necessario aggiungere un riferimento all' Accessibility assembly installato con la .NET Framework.To get or set the AccessibilityObject property, you must add a reference to the Accessibility assembly installed with the .NET Framework.

Note per gli eredi

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

Si applica a

Vedi anche