Role-Eigenschaft

Die Role-Eigenschaft beschreibt das Benutzeroberflächenelement eines Objekts. Alle Objekte unterstützen die Role-Eigenschaft .

In vielen Fällen ist die Rolle des Objekts offensichtlich. Beispielsweise verfügen Fenster über die rolle "ROLE_SYSTEM_WINDOW" , und Schaltflächen verfügen über die Rolle "ROLE_SYSTEM_PUSHBUTTON" .

Die Role-Eigenschaft wird durch Aufrufen von IAccessible::get_accRole abgerufen.

Identifizieren der Rolle eines Objekts

Microsoft Active Accessibility stellt Rollenkonstanten bereit, die in oleacc.h definiert sind und allgemeine Objektrollen identifizieren. Es wird empfohlen, dass Serverentwickler diese vordefinierten Rollenwerte verwenden. Wenn eine vordefinierte Rollenkonstante zurückgegeben wird, verwenden Clients die GetRoleText-Funktion , um eine lokalisierte Zeichenfolge abzurufen, die die Rolle beschreibt.

Verwenden Sie für Animationssteuerelemente, z. B. das Beim Kopieren von Dateien angezeigte Animationssteuerelement, ROLE_SYSTEM_ANIMATION. Grafiken, die gelegentlich animiert werden, werden als ROLE_SYSTEM_GRAPHIC beschrieben, wobei die State-Eigenschaft auf STATE_SYSTEM_ANIMATED festgelegt ist.

Beachten Sie, dass einige Rollen nicht einfach zu beschreiben sind. Die Ansicht mit großen Symbolen eines Ordners ermöglicht beispielsweise die beliebige Anordnung von Symbolen, sodass seine Rolle als ROLE_SYSTEM_GROUPING beschrieben werden kann. Oder ein Steuerelement, das Elemente in festen Zeilen und Spalten bereitstellt, könnte die Rolle ROLE_SYSTEM_TABLE haben. Da eine Rolle verwendet wird, um einem Endbenutzer das Nutzungsmodell mitzuteilen, ist es wichtig, die entsprechende Rolle zu verwenden. Wenn ihr Steuerelement beispielsweise wie eine Schaltfläche fungiert, verwenden Sie ROLE_SYSTEM_PUSHBUTTON.