AccessibleObject.Name Proprietà

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Origine:

AccessibleObject.cs

Ottiene o imposta il nome dell'oggetto.

C#

public virtual string? Name { get; set; }

Valore della proprietà

String

Nome dell'oggetto oppure null se la proprietà non è stata impostata.

Eccezioni

COMException

Non è possibile recuperare o impostare il nome del controllo.

Esempio

Nell'esempio seguente viene illustrata la creazione di un controllo grafico a conoscenza 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 dispone di 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 della Name proprietà. Vedere la panoramica della classe per l'esempio AccessibleObject di codice completo.

C#

// Inner class CurveLegendAccessibleObject represents accessible information 
// associated with the CurveLegend object.
public class CurveLegendAccessibleObject : AccessibleObject
{
    private CurveLegend curveLegend;

    public CurveLegendAccessibleObject(CurveLegend curveLegend) : base() 
    {
        this.curveLegend = curveLegend;                    
    }                

    // Private property that helps get the reference to the parent ChartControl.
    private ChartControlAccessibleObject ChartControl
    {   
        get {
            return Parent as ChartControlAccessibleObject;
        }
    }

    // Internal helper function that returns the ID for this CurveLegend.
    internal int ID
    {
        get {
            for(int i = 0; i < ChartControl.GetChildCount(); i++) {
                if (ChartControl.GetChild(i) == this) {
                    return i;
                }
            }
            return -1;
        }
    }

    // Gets the Bounds for the CurveLegend. This is used by accessibility programs.
    public override Rectangle Bounds
    {
        get {                        
            // The bounds is in screen coordinates.
            Point loc = curveLegend.Location;
            return new Rectangle(curveLegend.chart.PointToScreen(loc), curveLegend.Size);
        }
    }

    // Gets or sets the Name for the CurveLegend. This is used by accessibility programs.
    public override string Name
    {
        get {
            return curveLegend.Name;
        }
        set {
            curveLegend.Name = value;                        
        }
    }

    // Gets the Curve Legend Parent's Accessible object.
    // This is used by accessibility programs.
    public override AccessibleObject Parent
    {
        get {
            return curveLegend.chart.AccessibilityObject;
        }
    }

    // Gets the role for the CurveLegend. This is used by accessibility programs.
    public override AccessibleRole Role 
    {
        get {
            return AccessibleRole.StaticText;
        }
    }

    // Gets the state based on the selection for the CurveLegend. 
    // This is used by accessibility programs.
    public override AccessibleStates State 
    {
        get {
            AccessibleStates state = AccessibleStates.Selectable;
            if (curveLegend.Selected) 
            {
                state |= AccessibleStates.Selected;
            }
            return state;
        }
    }

    // Navigates through siblings of this CurveLegend. This is used by accessibility programs.
    public override AccessibleObject Navigate(AccessibleNavigation navdir) 
    {
        // Uses the internal NavigateFromChild helper function that exists
        // on ChartControlAccessibleObject.
        return ChartControl.NavigateFromChild(this, navdir);
    }

    // Selects or unselects this CurveLegend. This is used by accessibility programs.
    public override void Select(AccessibleSelection selection) 
    {
        // Uses the internal SelectChild helper function that exists
        // on ChartControlAccessibleObject.
        ChartControl.SelectChild(this, selection);
    }
}

Commenti

La Name proprietà è una stringa utilizzata dai client per identificare, trovare o annunciare un oggetto per l'utente. Per accedere al nome di un oggetto figlio, è necessario prima chiamare GetChild con l'indice del figlio il cui nome viene recuperato.

Note per gli eredi

Tutti gli oggetti devono supportare questa proprietà. Il nome di un oggetto deve essere intuitivo in modo che gli utenti comprendano il significato o lo scopo dell'oggetto. Assicurarsi inoltre che la Name proprietà sia univoca rispetto a tutti gli oggetti di pari livello nell'elemento padre. La navigazione all'interno di tabelle presenta problemi particolarmente difficili per alcuni utenti. Pertanto, gli sviluppatori del server devono creare nomi di cella di tabella il più descrittivo possibile. Ad esempio, è possibile creare un nome di cella combinando i nomi della riga e della colonna che occupa, ad esempio "A1". Tuttavia, è generalmente meglio usare nomi più descrittivi, ad esempio "Karin, febbraio". Molti oggetti, ad esempio icone, menu, caselle di controllo, caselle di controllo, caselle combinate e altri controlli, hanno etichette visualizzate agli utenti. Qualsiasi etichetta visualizzata agli utenti deve essere usata per la proprietà dell'oggetto Name . Per altre informazioni, vedere la Name proprietà.

Se si usa il testo del menu o del pulsante per la Name proprietà, rimuovere gli amperandi (&) che contrassegnano i tasti di accesso della tastiera.

Si applica a

Vedi anche

• Bounds
• DefaultAction
• Description
• Help
• KeyboardShortcut
• Parent
• Role
• State
• Value