匯出 (0) 列印
全部展開
Expand Minimize
本文章是由機器翻譯。 將指標移到文章內的文字上方即可查看原文。 其他資訊。
譯文
原文

AccessibleRole 列舉類型

指定數值,代表可能的角色可存取物件。

命名空間:  System.Windows.Forms
組件:  System.Windows.Forms (在 System.Windows.Forms.dll 中)

public enum AccessibleRole

成員名稱描述
Alert警示或您可以通知使用者有關的條件。 您可以使用這個角色僅適用於具現化的警示,但沒有其他的使用者介面項目,例如訊息方塊、 圖形、 文字或聲音與相關聯的物件。
Animation動畫控制項,其中包含會隨時間變更,例如顯示一連串點陣圖框架,影片的方式類似,控制項的內容。 正在複製檔案,或正在執行其他費時的工作時,動畫控制項通常會顯示。
Application應用程式主視窗。
Border視窗的框線。 整個框線都會由單一物件,而非個別為每一邊的物件。
ButtonDropDown可下拉項目清單的按鈕。
ButtonDropDownGrid可下拉格線的按鈕。
ButtonMenu可下拉功能表的按鈕。
Caret插入號,也就是閃爍的線條、 區塊或標記的視窗工作區中的插入點位置的點陣圖。
Cell在資料表中儲存格。
Character卡通式圖形物件,例如 Microsoft Office 助理,它通常會顯示以提供給使用者的應用程式的說明。
Chart用來代表資料的圖形影像。
CheckButton核取方塊控制項,一個可以開啟或關閉不受影響的其他選項的選項。
Client視窗的 [使用者] 區域。
Clock這種控制項顯示的時間。
Column在資料表中的儲存格的資料行。
ColumnHeader資料行行首,提供資料表的資料行的視覺標籤。
ComboBox下拉式方塊中,也就是編輯控制項提供一組預先定義的選項相關聯的清單方塊。
Cursor滑鼠指標。
Default系統提供的角色。
Diagram用來構圖資料的圖形影像。
Dial撥號盤或旋鈕。 這也可以是唯讀的物件,例如速率計。
Dialog對話方塊或訊息方塊中。
Document文件視窗,一定會包含應用程式視窗中。 這個角色只適用於多重文件介面 (MDI) 視窗,並參考包含 MDI 標題列的物件。
DropList下拉式清單方塊中。 這個控制項會顯示一個項目,並允許使用者選取和顯示其他替代選項清單中。
Equation數學方程式。
Graphic一張圖片。
Grip特殊的滑鼠指標,可讓使用者操作使用者介面項目,例如視窗。 比方說,使用者可以按一下並拖曳以調整其大小的視窗右下角的調整大小底框。
Grouping以邏輯方式群組的物件。 可以有群組物件和它所包含的物件之間的父子式關聯性。
HelpBalloon在 [工具提示或說明汽球,其中包含按鈕和標籤,使用者可以按一下以開啟 [自訂 [說明] 主題的形式來顯示。
HotkeyField可讓使用者輸入組合或做為便捷鍵,可讓使用者迅速執行動作的按鍵輸入 [快速鍵] 欄位中。 熱鍵控制項會顯示使用者輸入的按鍵,並確保使用者選取有效的按鍵組合。
Indicator指示器,例如指標的圖片,指向 [目前的項目。
IpAddress這種控制項設計用來輸入網際網路通訊協定 (IP) 位址。
Link連結,也就是來源文件和目的文件之間的連接。 這個物件看起來像是文字或圖形,但動作卻像是按鈕。
List清單方塊,可讓使用者選取一或多個項目。
ListItem在 [清單方塊或下拉式方塊、 下拉式清單方塊或下拉式清單方塊的清單部份項目。
MenuBar功能表列,通常在視窗中,使用者可從中選取功能表的標題列下方。
MenuItem功能表項目,也就是使用者可以選擇要執行某一指令的功能表中的項目,請選取一個選項,或顯示其他的功能表。 在功能上,功能表項目可說是相當按鈕、 選項按鈕、 核取方塊,或功能表。
MenuPopup功能表上,會看到一份則使用者只能從中進行選取項目執行動作的選項。 所有的功能表類型必須有這個角色,包括依選取範圍,從功能表列,顯示下拉式功鄋瞴和快顯功能表按一下滑鼠右鍵時顯示。
None沒有角色。
Outline大綱或樹狀結構,例如樹狀檢視控制項,顯示階層式清單,且通常允許使用者展開和摺疊分支。
OutlineButton像大綱項目一樣巡覽的控制項。
OutlineItem大綱或樹狀結構中的項目。
PageTab屬性頁可讓使用者檢視網頁,例如網頁的標題、 它是否為首頁、 頁面是否已經修改的屬性。 一般來說,這個控制項的唯一子系是群組的物件,包含 [關聯] 頁面的內容。
PageTabList頁面索引標籤控制項的容器。
Pane圖文框、 分割文件視窗或可以用來顯示資訊的狀態列的長方形區域中的個別區域。 使用者可以瀏覽窗格之間和目前窗格中,內容中,但不能在不同窗格中的項目之間巡覽。 因此,窗格代表群組低於框架視窗或文件,但高於個別控制項層的級。 一般而言,使用者會藉由按下 TAB、 f6 鍵或 CTRL + tab 鍵,取決於內容窗格之間巡覽。
ProgressBar進度列,顯示水平的矩形內部的彩色的線條表示的長時間作業的進度。 列與矩形的長度的長度會對應到作業的完成百分比。 這個控制項不接受使用者輸入。
PropertyPage屬性頁,是對話方塊,讓控制項的外觀和行為的物件,例如檔案或資源。 屬性頁的外觀會隨著它的目的而有所不同。
PushButton按鈕控制項,也就是使用者可以開啟或關閉的小矩形控制項。 按鈕,也就是指令按鈕,在關閉狀態下凹的外觀及其預設具有升高的外觀時就會亮起來。
RadioButton選項按鈕,也就是一個選項按鈕。 所有物件共用單一的父代的這個屬性會都假設為單一的互斥群組的一部份。 將選項按鈕分成不同的群組,在必要時,您可以使用一組的物件。
Row在資料表中的儲存格的資料列。
RowHeader資料列標頭,資料表中的某一列中提供的視覺標籤。
ScrollBar垂直或水平捲軸列,可以是工作區的一部分,或是用於控制項中。
Separator空間,以視覺上分為兩個區域,例如分隔符號功能表項目或視窗中將分割來區隔。
Slider一個控制項,有時稱為 trackbar 可讓使用者能夠調整的設定以提供藉由移動滑桿的最小和最大值之間的遞增值。 磁碟區中的控制項與 Windows 作業系統是滑桿控制項。
Sound系統音效,也就是各種系統事件相關聯。
SpinButton微調方塊中,也稱為上下按鈕控制項,包含一對箭號按鈕。 使用者按一下箭號按鈕,使用滑鼠來遞增或遞減數值。 微調按鈕控制項最常配合附屬控制項稱為協同視窗,顯示目前的值的位置中。
SplitButton具有下拉式清單圖示緊鄰按鈕的工具列按鈕。
StaticText唯讀文字,例如在標籤,而其他的控制項或對話方塊中的指示進行。 無法修改靜態文字,或選取。
StatusBar狀態列,它是一個通常會顯示目前的作業,應用程式,或選取物件的狀態資訊的應用程式視窗底部的區域。 [狀態] 列可以有多個欄位顯示不同類型的資訊,像是在狀態列中目前選取的功能表命令的說明。
Table資料表包含資料列和資料行的儲存格,並選擇性地資料列行首。
Text選取的文字可以是可編輯或唯讀的。
TitleBar視窗標題或標題列。
ToolBar工具列,也就是一群控制項,讓您輕鬆存取常用的功能。
ToolTip工具提示,也就是小矩形快顯視窗顯示出按鈕用途之簡短說明。
WhiteSpace其他物件之間的空白區域。
Window視窗外框,通常包含子物件,例如標題列、 用戶端及其他物件一般會包含在視窗中。

物件的角色會描述物件的功能,並協助工具應用程式所使用。

這個列舉型別由AccessibleObjectControl.AccessibleRole

如需其他有關協助工具應用程式的詳細資訊,請搜尋 「 Microsoft 協助使用中工具 」 在 Microsoft 開發人員網路 (MSDN) 程式庫中。

下列程式碼範例示範的協助工具感知的圖表建立控制,請使用AccessibleObjectControl.ControlAccessibleObject類別公開 (expose) 可存取的資訊。 控制項會繪製兩條包含圖例的曲線。 ChartControlAccessibleObject類別是衍生自ControlAccessibleObject,用於CreateAccessibilityInstance方法,以提供自訂的圖表控制項的可存取資訊。 因為圖表圖例不是實際Control -基礎控制項,但改為繪製圖表控制項,它不會不是任何內建的可存取資訊。 有鑑於此, ChartControlAccessibleObject類別覆寫GetChild方法來傳回CurveLegendAccessibleObject ,代表可存取的資訊,每個部分的圖例。 當可存取感知的應用程式使用這個控制項時,控制項可以提供必要的可存取資訊。

本範例將示範如何使用AccessibleRole列舉型別與Role屬性。 請參閱AccessibleObject類別的完整程式碼範例的概觀。


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

支援版本:4.5、4、3.5、3.0、2.0、1.1、1.0

.NET Framework Client Profile

支援版本:4、3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (不支援伺服器核心角色), Windows Server 2008 R2 (SP1 (含) 以後版本支援伺服器核心角色,不支援 Itanium)

此.NET Framework 並不支援各種平台的所有版本。如需支援版本的清單,請參閱.NET Framework 系統需求.

社群新增項目

新增
顯示:
© 2015 Microsoft