AccessibleNavigation 列舉

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

指定要用於在可存取物件中巡覽的數值。

C#

public enum AccessibleNavigation

繼承

Object

ValueType

Enum

AccessibleNavigation

欄位

名稱	值	Description
Down	2	巡覽到位在開始物件下的同層級 (Sibling) 物件。
FirstChild	7	巡覽到物件的第一個子系。
LastChild	8	巡覽到物件的最後一個子系。
Left	3	巡覽到位在開始物件左方的同層級物件。
Next	5	巡覽到下一個邏輯物件，一般是從同層級物件巡覽到開始的物件。
Previous	6	巡覽到上一個邏輯物件，一般是從同層級物件巡覽到開始的物件。
Right	4	巡覽到位在開始物件右方的同層級物件。
Up	1	巡覽到位在開始物件上方的同層級物件。

範例

下列程式碼範例示範如何使用 AccessibleObject 和 Control.ControlAccessibleObject 類別來公開無障礙資訊，建立協助工具感知圖表控制項。 控制項會繪製兩條曲線以及圖例。 衍生 ChartControlAccessibleObject 自 ControlAccessibleObject 的 類別用於 方法中 CreateAccessibilityInstance ，以提供圖表控制項的自訂可存取訊號。 由於圖表圖例不是實際的 Control 控制項，而是由圖表控制項繪製，因此它不會有任何內建的可存取訊號。 因此，類別會 ChartControlAccessibleObjectGetChild 覆寫 方法，以傳回 CurveLegendAccessibleObject ，代表圖例每個部分的可存取訊號。 當可存取感知應用程式使用此控制項時，控制項可以提供必要的可存取訊號。

此範例示範如何搭配 Navigate 方法使用 AccessibleNavigation 列舉。 如需完整的程式碼範例， 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