Role 屬性

Role屬性描述物件的使用者介面專案。 所有物件都支援 Role 屬性。

在許多情況下,物件的角色很明顯。 例如,windows 具有 ROLE_SYSTEM_WINDOW 角色,而按鈕具有 ROLE_SYSTEM_PUSHBUTTON 角色。

Role屬性是藉由呼叫IAccessible::get_accRole來擷取。

識別物件的角色

Microsoft Active Accessibility 提供在 oleacc.h 中定義 的角色常數,可識別常見的物件角色。 建議伺服器開發人員使用這些預先定義的角色值。 如果傳回預先定義的角色常數,用戶端會使用 GetRoleText 函式來擷取描述角色的當地語系化字串。

對於動畫控制項,例如複製檔案時顯示的動畫控制項,請使用 ROLE_SYSTEM_ANIMATION。 偶爾產生動畫效果的圖形會描述為[狀態] 屬性設定為[STATE_SYSTEM_ANIMATED] ROLE_SYSTEM_GRAPHIC

請注意,有些角色不容易描述。 例如,資料夾的大型圖示檢視允許任意排列圖示,因此其角色可以描述為 ROLE_SYSTEM_GROUPING。 或者,提供固定資料列和資料行中專案的控制項可能會具有 ROLE_SYSTEM_TABLE 角色。 由於角色是用來將使用模型傳達給終端使用者,因此請務必使用適當的角色。 例如,如果您的控制項就像按鈕一樣,請使用 ROLE_SYSTEM_PUSHBUTTON