共用方式為

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。