Vlastnost role

Vlastnost Role popisuje prvek uživatelského rozhraní objektu. Všechny objekty podporují vlastnost role.

V mnohapřípadechch Například okna mají ROLE_SYSTEM_WINDOW roli a tlačítka push mají ROLE_SYSTEM_PUSHBUTTON roli.

Vlastnost role se načte voláním IAccessible::get_accRole.

Identifikace role objektu

Microsoft Active Accessibility poskytuje konstanty rolí, definované v oleacc.h, které identifikují běžné role objektů. Doporučuje se, aby vývojáři serveru používali tyto předdefinované hodnoty rolí. Pokud se vrátí předdefinovaná konstanta role, klienti používají funkci GetRoleText k načtení lokalizovaného řetězce, který tuto roli popisuje.

U animačních ovládacích prvků, jako je ovládací prvek animace zobrazený při kopírování souborů, použijte ROLE_SYSTEM_ANIMATION. Grafika, které jsou příležitostně animované, jsou popsány jako ROLE_SYSTEM_GRAPHIC s vlastností State nastavenou na STATE_SYSTEM_ANIMATED.

Všimněte si, že některé role nejsou snadné popsat. Například zobrazení velké ikony složky umožňuje libovolné uspořádání ikon, takže jeho role by mohla být popsána jako ROLE_SYSTEM_GROUPING. Nebo může mít ovládací prvek, který poskytuje položky v pevných řádcích a sloupcích ROLE_SYSTEM_TABLE roli. Vzhledem k tomu, že se role používá ke komunikaci modelu použití koncovému uživateli, je důležité použít příslušnou roli. Pokud například ovládací prvek funguje jako tlačítko, použijte ROLE_SYSTEM_PUSHBUTTON.