Właściwość roli

Właściwość Rola opisuje element interfejsu użytkownika obiektu. Wszystkie obiekty obsługują właściwość Role.

W wielu przypadkach rola obiektu jest oczywista. Na przykład okna mają rolę ROLE_SYSTEM_WINDOW i przyciski ROLE_SYSTEM_PUSHBUTTON.

Właściwość roli jest pobierana przez wywołanie metody IAccessible::get_accRole.

Identyfikowanie roli obiektu

Usługa Microsoft Active Accessibility zapewnia stałe ról , zdefiniowane w pliku oleacc.h, które identyfikują typowe role obiektów. Zaleca się, aby deweloperzy serwerów używali tych wstępnie zdefiniowanych wartości ról. Jeśli zostanie zwrócona wstępnie zdefiniowana stała roli, klienci używają funkcji GetRoleText w celu pobrania zlokalizowanego ciągu opisującego rolę.

W przypadku kontrolek animacji, takich jak kontrolka animacji wyświetlana podczas kopiowania plików, użyj ROLE_SYSTEM_ANIMATION. Grafika, która jest od czasu do czasu animowana, jest opisywana jako ROLE_SYSTEM_GRAPHIC z właściwościąstateustawioną na wartość STATE_SYSTEM_ANIMATED.

Pamiętaj, że niektóre role nie są łatwe do opisania. Na przykład widok dużej ikony folderu umożliwia dowolne rozmieszczenie ikon, więc jego rola może być opisana jako ROLE_SYSTEM_GROUPING. Lub kontrolka, która udostępnia elementy w stałych wierszach i kolumnach, może mieć rolę ROLE_SYSTEM_TABLE. Ponieważ rola jest używana do przekazywania modelu użycia użytkownikowi końcowemu, ważne jest, aby użyć odpowiedniej roli. Jeśli na przykład kontrolka działa jak przycisk, użyj ROLE_SYSTEM_PUSHBUTTON.