AccessibleNavigation 列挙型

定義

名前空間:

System.Windows.Forms

アセンブリ:

System.Windows.Forms.dll

ユーザー補助オブジェクト間を移動するための値を指定します。

C#

public enum AccessibleNavigation

継承

Object

ValueType

Enum

AccessibleNavigation

フィールド

名前	値	説明
Down	2	開始オブジェクトの下にある兄弟オブジェクトへの移動。
FirstChild	7	オブジェクトの最初の子への移動。
LastChild	8	オブジェクトの最後の子への移動。
Left	3	開始オブジェクトの左側にある兄弟オブジェクトへの移動。
Next	5	次の論理オブジェクトへの移動。通常は、兄弟オブジェクトから開始オブジェクトへの移動。
Previous	6	前の論理オブジェクトへの移動。通常は、兄弟オブジェクトから開始オブジェクトへの移動。
Right	4	開始オブジェクトの右側にある兄弟オブジェクトへの移動。
Up	1	開始オブジェクトの上にある兄弟オブジェクトへの移動。

例

次のコード例では、 クラスと Control.ControlAccessibleObject クラスを使用してアクセシビリティ対応のグラフ コントロールを作成しAccessibleObject、アクセシビリティ対応の情報を公開する方法を示します。 コントロールは、凡例と共に 2 つの曲線をプロットします。 からControlAccessibleObject派生した クラスはChartControlAccessibleObject、 メソッドでCreateAccessibilityInstance使用され、グラフ コントロールのユーザー設定のアクセス可能な情報を提供します。 グラフの凡例は実際 Control のベースのコントロールではなく、グラフ コントロールによって描画されるため、組み込みのアクセス可能な情報はありません。 このため、 クラスは ChartControlAccessibleObject メソッドを GetChild オーバーライドして、凡例の各部分のアクセス可能な情報を表す を返 CurveLegendAccessibleObject します。 アクセシビリティ対応アプリケーションがこのコントロールを使用する場合、コントロールは必要なアクセス可能な情報を提供できます。

この例では、 メソッドで 列挙型を AccessibleNavigation 使用する方法を Navigate 示します。 完全な AccessibleObject コード例については、クラスの概要を参照してください。

C#

// 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;                        
            }
        }            
    }
}

注釈

アクセス可能なナビゲーションの方向は、空間 (上、下、左、右) または論理 (最初の子、最後の子、次、前) のいずれかです。 論理的な方向は、クライアントがあるユーザー インターフェイス要素から同じコンテナー内の別のユーザー インターフェイス要素に移動するときに使用されます。

AccessibleObject では、この列挙を使用します。

詳細については、「Microsoft Active Accessibility」を参照してください。

適用対象

こちらもご覧ください

• AccessibleEvents
• AccessibleObject
• AccessibleRole
• AccessibleSelection
• AccessibleStates