Rollegenskap

Egenskapen Role beskriver ett objekts användargränssnittselement. Alla objekt stöder egenskapen Role.

I många fall är objektets roll uppenbar. Till exempel har windows rollen ROLE_SYSTEM_WINDOW och push-knapparna har ROLE_SYSTEM_PUSHBUTTON roll.

Egenskapen Role hämtas genom att anropa IAccessible::get_accRole.

Identifiera ett objekts roll

Microsoft Active Accessibility tillhandahåller rollkonstanter, som definieras i oleacc.h, som identifierar vanliga objektroller. Vi rekommenderar att serverutvecklare använder dessa fördefinierade rollvärden. Om en fördefinierad rollkonstant returneras använder klienter funktionen GetRoleText för att hämta en lokaliserad sträng som beskriver rollen.

För animeringskontroller, till exempel animeringskontrollen som visas vid kopiering av filer, använder du ROLE_SYSTEM_ANIMATION. Grafik som ibland animerad beskrivs som ROLE_SYSTEM_GRAPHIC med egenskapen State inställd på STATE_SYSTEM_ANIMATED.

Observera att vissa roller inte är lätta att beskriva. Till exempel tillåter en mapps stora ikonvy godtyckliga arrangemang av ikoner, så dess roll kan beskrivas som ROLE_SYSTEM_GROUPING. Eller en kontroll som tillhandahåller objekt i fasta rader och kolumner kan ha ROLE_SYSTEM_TABLE roll. Eftersom en roll används för att kommunicera användningsmodellen till en slutanvändare är det viktigt att använda lämplig roll. Om kontrollen till exempel fungerar som en knapp använder du ROLE_SYSTEM_PUSHBUTTON.