物件角色

本主題描述用來描述應用程式中各種 UI 物件角色的常數值。 角色常數定義于 Oleacc.h 檔案中。

您應該只使用此處所列的角色常數;請勿新增未預先定義的自訂角色或角色。

使用這些物件角色之前，用戶端應用程式的開發人員必須使用 檢查 工具來確認 UI 元素正在使用物件角色。

若要擷取物件的角色，用戶端會呼叫 IAccessible：：get_accRole 方法，這個方法必須傳回資料表中所述的其中一個值。 若要擷取描述物件角色的當地語系化字串，用戶端會使用角色值呼叫 GetRoleText 函式。 角色值的當地語系化字串位於oleaccrc.dll檔案中。

常數	描述
ROLE_SYSTEM_ALERT	物件代表應通知使用者的警示或條件。 此角色僅適用于包含警示但未與另一個使用者介面元素相關聯的物件，例如訊息方塊、圖形、文字或音效。
ROLE_SYSTEM_ANIMATION	物件代表內容隨著時間變更的動畫控制項，例如顯示一系列點陣圖畫面的控制項。 複製檔案或執行一些其他耗時的工作時，會顯示動畫控制項。
ROLE_SYSTEM_APPLICATION	物件代表應用程式的主視窗。
ROLE_SYSTEM_BORDER	物件代表視窗框線。 整個框線是由單一物件表示，而不是由每個側邊的個別物件表示。
ROLE_SYSTEM_BUTTONDROPDOWN	物件代表展開專案清單的按鈕。
ROLE_SYSTEM_BUTTONDROPDOWNGRID	物件代表展開方格的按鈕。
ROLE_SYSTEM_BUTTONMENU	物件代表展開功能表的按鈕。
ROLE_SYSTEM_CARET	物件代表系統插入號。
ROLE_SYSTEM_CELL	物件代表表格內的儲存格。
ROLE_SYSTEM_CHARACTER	物件代表類似卡通的繪圖物件，例如 Microsoft Office Assistant，其會顯示為應用程式的使用者提供協助。
ROLE_SYSTEM_CHART	物件代表用來圖表資料的圖形影像。
ROLE_SYSTEM_CHECKBUTTON	物件代表核取方塊控制項：與其他選項分開選取或清除的選項。
ROLE_SYSTEM_CLIENT	物件代表視窗的工作區。 如果 UI 元素的角色有問題，Microsoft Active Accessibility 會使用此角色做為預設值。
ROLE_SYSTEM_CLOCK	物件代表顯示時間的控制項。
ROLE_SYSTEM_COLUMN	物件代表表格中儲存格的資料行。
ROLE_SYSTEM_COLUMNHEADER	物件代表資料行標頭，提供資料表中資料行的視覺標籤。
ROLE_SYSTEM_COMBOBOX	物件代表下拉式方塊：具有相關聯清單方塊的編輯控制項，可提供一組預先定義的選項。
ROLE_SYSTEM_CURSOR	物件代表系統的滑鼠指標。
ROLE_SYSTEM_DIAGRAM	物件代表用來圖表資料的圖形影像。
ROLE_SYSTEM_DIAL	物件代表撥號或 Knob。
ROLE_SYSTEM_DIALOG	物件代表對話方塊或訊息方塊。
ROLE_SYSTEM_DOCUMENT	物件代表文件視窗。 文件視窗一律包含在應用程式視窗中。 此角色僅適用于 MDI 視窗，並參考包含 MDI 標題列的物件。
ROLE_SYSTEM_DROPLIST	物件代表行事曆控制項 SysDateTimePick32。 Microsoft Active Accessibility 執行時間元件會使用此角色來指出找到日期或行事曆控制項。
ROLE_SYSTEM_EQUATION	物件代表數學方程式。
ROLE_SYSTEM_GRAPHIC	物件代表圖片。
ROLE_SYSTEM_GRIP	物件代表特殊的滑鼠指標，可讓使用者操作使用者介面元素，例如視窗。 其中一個範例牽涉到拖曳視窗右下角來調整視窗大小。
ROLE_SYSTEM_GROUPING	物件會以邏輯方式分組其他物件。 群組物件與其包含的物件之間不一定有父子關聯性。
ROLE_SYSTEM_HELPBALLOON	物件會以工具提示或說明方塊的形式顯示說明主題。
ROLE_SYSTEM_HOTKEYFIELD	物件代表鍵盤快速鍵欄位，可讓使用者輸入按鍵的組合或序列。
ROLE_SYSTEM_INDICATOR	物件代表指向目前專案的指標圖形，例如指標圖形。
ROLE_SYSTEM_IPADDRESS	物件代表專為 IP 位址設計的編輯控制項。 編輯控制項分為各區段，每個區段都是 IP 位址的特定部分。
ROLE_SYSTEM_LINK	物件代表其他專案的連結。 這個物件看起來像是文字或圖形，但動作卻像是按鈕。
ROLE_SYSTEM_LIST	物件代表清單方塊，允許使用者選取一或多個專案。
ROLE_SYSTEM_LISTITEM	物件代表清單方塊或下拉式方塊、下拉式清單方塊或下拉式方塊清單部分的專案。
ROLE_SYSTEM_MENUBAR	物件代表 (位於使用者選取功能表之視窗標題列下方的功能表列) 。
ROLE_SYSTEM_MENUITEM	物件代表功能表項目：使用者可以選擇執行命令、選取選項或顯示另一個功能表的功能表項目。 功能上，功能表項目相當於按鈕、選項按鈕、核取方塊或功能表。
ROLE_SYSTEM_MENUPOPUP	物件代表功能表：選項清單，每個都有特定動作。 所有功能表類型都必須具有角色，包括從功能表列選取時所顯示的下拉式功能表;和快顯功能表，按一下滑鼠右鍵即可顯示。
ROLE_SYSTEM_OUTLINE	物件代表大綱或樹狀結構，例如樹狀檢視控制項，顯示階層式清單，並允許使用者展開和折迭分支。
ROLE_SYSTEM_OUTLINEBUTTON	物件代表類似大綱專案巡覽的專案。 向上鍵和向下鍵可用來巡覽外框。 不過，當按下向左鍵和向右鍵時，這些功能表會展開或折迭，而不是在按下空格鍵或 ENTER 鍵且專案具有焦點時展開或折迭。
ROLE_SYSTEM_OUTLINEITEM	物件代表大綱或樹狀結構中的專案。
ROLE_SYSTEM_PAGETAB	物件代表頁面索引標籤。頁面索引標籤控制項的唯一子系是具有相關聯頁面內容的ROLE_SYSTEM_GROUPING物件。
ROLE_SYSTEM_PAGETABLIST	物件代表頁面索引標籤控制項的容器。
ROLE_SYSTEM_PANE	物件代表框架或文件視窗內的窗格。 使用者可在窗格之間和目前窗格的內容之內巡覽，但無法在不同窗格內的項目之間巡覽。 因此，窗格代表低於框架或文件視窗但高於個別控制項的群組層級。 使用者在窗格之間巡覽的方式是依照內容而定，可按下 TAB、F6 或 CTRL+TAB 鍵。
ROLE_SYSTEM_PROGRESSBAR	物件代表進度列，以動態方式顯示進行中的作業已完成多少。 此控制項不接受任何使用者輸入。
ROLE_SYSTEM_PROPERTYPAGE	物件代表屬性工作表。
ROLE_SYSTEM_PUSHBUTTON	物件代表按鈕控制項。
ROLE_SYSTEM_RADIOBUTTON	物件代表先前 (選項按鈕) 。 它是互斥選項的其中一組。 共用相同父系且具有此屬性的所有物件都會假設為單一互斥群組的一部分。 若要將這些物件分割成不同的群組，請使用 ROLE_SYSTEM_GROUPING 物件。
ROLE_SYSTEM_ROW	物件代表表格中的儲存格列。
ROLE_SYSTEM_ROWHEADER	物件代表資料列標頭，提供資料表資料列的視覺標籤。
ROLE_SYSTEM_SCROLLBAR	物件代表垂直或水準捲軸，這是工作區的一部分，或用於 控制項。
ROLE_SYSTEM_SEPARATOR	物件用來以視覺化方式將空間分割成兩個區域。 分隔符號物件的範例包括分隔符號功能表項目，以及分割視窗內分割窗格的列。
ROLE_SYSTEM_SLIDER	物件代表滑杆，可讓使用者調整最小值和最大值之間的特定增量設定。
ROLE_SYSTEM_SOUND	物件代表與各種系統事件相關聯的系統音效。
ROLE_SYSTEM_SPINBUTTON	物件代表微調方塊，這是一個控制項，可讓使用者遞增或遞減與微調方塊相關聯的個別「精精」控制項中顯示的值。
ROLE_SYSTEM_SPLITBUTTON	物件代表工具列上的按鈕，該工具列上具有與按鈕直接連續的下拉式清單圖示。
ROLE_SYSTEM_STATICTEXT	物件代表唯讀文字，例如對話方塊中其他控制項或指令的標籤。 靜態文字不能修改或者選取。
ROLE_SYSTEM_STATUSBAR	物件代表狀態列，這是視窗底部的區域，並顯示目前作業、應用程式狀態或選取物件的相關資訊。 狀態列有多個欄位，可顯示不同類型的資訊。
ROLE_SYSTEM_TABLE	物件代表資料表，其中包含儲存格的資料列和資料行，以及選擇性地包含資料列標頭和資料行行首。
ROLE_SYSTEM_TEXT	物件代表允許編輯或指定為唯讀的可選取文字。
ROLE_SYSTEM_TITLEBAR	物件代表視窗的標題或標題列。
ROLE_SYSTEM_TOOLBAR	物件代表工具列，這是一組控制項，可讓您輕鬆存取常用功能。
ROLE_SYSTEM_TOOLTIP	物件代表提供實用提示的工具提示。
ROLE_SYSTEM_WHITESPACE	物件代表其他物件之間的空白。
ROLE_SYSTEM_WINDOW	物件代表視窗框架，其中包含子物件，例如標題列、用戶端和其他視窗物件。

規格需求

需求	值
標頭	Oleacc.h