Il presente articolo è stato tradotto automaticamente. Passare il puntatore sulle frasi nell'articolo per visualizzare il testo originale. Ulteriori informazioni.
Traduzione
Originale
Questo argomento non è stato ancora valutato - Valuta questo argomento

Metodo AccessibleObject.GetChild

Recupera la corrispondenza figlio accessibile all'indice specificato.

Spazio dei nomi:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)
public virtual AccessibleObject GetChild(
	int index
)

Parametri

index
Tipo: System.Int32
L'indice in base zero figlio accessibile.

Valore restituito

Tipo: System.Windows.Forms.AccessibleObject
AccessibleObject che rappresenta la corrispondenza figlio accessibile all'indice specificato.

Note per gli eredi

tutti gli oggetti accessibili devono supportare questa proprietà. Se il metodo non viene eseguito l'override di, restituisce null. Eseguire l'override di questo metodo quando deve accessibili di un oggetto di fornire personalizzato figlio accessibili. Se l'indice non è valido, il metodo restituirà null. Quando si esegue l'override di questo metodo, è necessario inoltre eseguire l'override GetChildCount.

Nell'esempio seguente viene illustrata la creazione di un controllo accessibilità-informato del grafico, utilizzando il AccessibleObject e Control.ControlAccessibleObject classi per esporre informazioni accessibili. I campi controversi due curve con una legenda. ChartControlAccessibleObject classe, che deriva da ControlAccessibleObject, viene utilizzato in CreateAccessibilityInstance metodo per fornire personalizzato informazioni accessibili per il controllo del grafico. Poiché la legenda del grafico non è un reale Control il controllo basato, ma viene tracciato dal controllo del grafico, non ha alcuna informazione accessibile incorporata. Per questo motivo, ChartControlAccessibleObject la classe esegue l'override GetChild metodo restituisca CurveLegendAccessibleObject che rappresenta le informazioni accessibili per ogni parte della legenda. Quando un'applicazione accessibile-informata utilizza il controllo, il controllo può fornire informazioni accessibili necessarie.

Questo porzione di codice seguente viene illustrato l'override GetChild metodo. vedere AccessibleObject i cenni preliminari sulle classi per l'esempio di codice completo.


// Inner class ChartControlAccessibleObject represents accessible information associated with the ChartControl.
// The ChartControlAccessibleObject is returned in the ChartControl.CreateAccessibilityInstance override.
public class ChartControlAccessibleObject : ControlAccessibleObject
{
    ChartControl chartControl;

    public ChartControlAccessibleObject(ChartControl ctrl) : base(ctrl) 
    {
        chartControl = ctrl;
    }

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

    // Gets the state for the Chart. This is used by accessibility programs.
    public override AccessibleStates State
    {  
        get {                    
            return AccessibleStates.ReadOnly;
        }
    }

    // The CurveLegend objects are "child" controls in terms of accessibility so 
    // return the number of ChartLengend objects.
    public override int GetChildCount()
    {  
        return chartControl.Legends.Length;
    }

    // Gets the Accessibility object of the child CurveLegend idetified by index.
    public override AccessibleObject GetChild(int index)
    {  
        if (index >= 0 && index < chartControl.Legends.Length) {
            return chartControl.Legends[index].AccessibilityObject;
        }                
        return null;
    }

    // Helper function that is used by the CurveLegend's accessibility object
    // to navigate between sibiling controls. Specifically, this function is used in
    // the CurveLegend.CurveLegendAccessibleObject.Navigate function.
    internal AccessibleObject NavigateFromChild(CurveLegend.CurveLegendAccessibleObject child, 
                                                AccessibleNavigation navdir) 
    {  
        switch(navdir) {
            case AccessibleNavigation.Down:
            case AccessibleNavigation.Next:
                return GetChild(child.ID + 1);

            case AccessibleNavigation.Up:
            case AccessibleNavigation.Previous:
                return GetChild(child.ID - 1);                        
        }
        return null;
    }

    // Helper function that is used by the CurveLegend's accessibility object
    // to select a specific CurveLegend control. Specifically, this function is used
    // in the CurveLegend.CurveLegendAccessibleObject.Select function.
    internal void SelectChild(CurveLegend.CurveLegendAccessibleObject child, AccessibleSelection selection) 
    {   
        int childID = child.ID;

        // Determine which selection action should occur, based on the
        // AccessibleSelection value.
        if ((selection & AccessibleSelection.TakeSelection) != 0) {
            for(int i = 0; i < chartControl.Legends.Length; i++) {
                if (i == childID) {
                    chartControl.Legends[i].Selected = true;                        
                } else {
                    chartControl.Legends[i].Selected = false;
                }
            }

            // AccessibleSelection.AddSelection means that the CurveLegend will be selected.
            if ((selection & AccessibleSelection.AddSelection) != 0) {
                chartControl.Legends[childID].Selected = true;                        
            }

            // AccessibleSelection.AddSelection means that the CurveLegend will be unselected.
            if ((selection & AccessibleSelection.RemoveSelection) != 0) {
                chartControl.Legends[childID].Selected = false;                        
            }
        }            
    }
}


.NET Framework

Supportato in: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supportato in: 4, 3.5 SP1

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (ruoli di base del server non supportati), Windows Server 2008 R2 (ruoli di base del server supportati con SP1 o versione successiva, Itanium non supportato)

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.
Il documento è risultato utile?
(1500 caratteri rimanenti)

Aggiunte alla community

AGGIUNGI
© 2013 Microsoft. Tutti i diritti riservati.