Control.CreateAccessibilityInstance Metodo

Definizione

Crea un nuovo oggetto di accessibilità per il controllo.

C#
protected virtual System.Windows.Forms.AccessibleObject CreateAccessibilityInstance ();

Restituisce

AccessibleObject

Nuovo oggetto AccessibleObject per il controllo.

Esempio

Nell'esempio di codice seguente viene illustrata la creazione di un controllo grafico con riconoscimento dell'accessibilità usando le AccessibleObject classi e Control.ControlAccessibleObject per esporre informazioni accessibili. Il controllo traccia due curve insieme a una legenda. La ChartControlAccessibleObject classe, che deriva da ControlAccessibleObject, viene usata nel CreateAccessibilityInstance metodo per fornire informazioni accessibili personalizzate per il controllo grafico. Poiché la legenda del grafico non è un controllo effettivo Control basato su base, ma viene invece disegnato dal controllo grafico, non contiene informazioni accessibili predefinite. A causa di questo, la ChartControlAccessibleObject classe esegue l'override GetChild del metodo per restituire le CurveLegendAccessibleObject informazioni accessibili per ogni parte della legenda. Quando un'applicazione con riconoscimento accessibile usa questo controllo, il controllo può fornire le informazioni accessibili necessarie.

Questo estratto di codice illustra l'override del CreateAccessibilityInstance metodo. Vedere la panoramica della classe per l'esempio AccessibleObject di codice completo.

C#
// Overridden to return the custom AccessibleObject 
// for the entire chart.
protected override AccessibleObject CreateAccessibilityInstance() 
{            
    return new ChartControlAccessibleObject(this);
}

Commenti

Se non si chiama in modo esplicito il metodo CreateAccessibilityInstance, verrà chiamato quando si crea un riferimento alla proprietà AccessibilityObject.

Nota

Per ottenere o impostare la AccessibilityObject proprietà, è necessario aggiungere un riferimento all'assembly Accessibility installato con .NET Framework.

Note per gli eredi

Quando si esegue l'override CreateAccessibilityInstance() in una classe derivata, non chiamare il metodo della classe di CreateAccessibilityInstance() base.

Si applica a

Prodotto Versioni
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
Windows Desktop 3.0, 3.1, 5, 6, 7

Vedi anche