Objektrollen

In diesem Thema werden die konstanten Werte beschrieben, die verwendet werden, um die Rollen verschiedener Benutzeroberflächenobjekte in einer Anwendung zu beschreiben. Die Rollenkonst constants werden in der Datei Oleacc.h definiert.

Sie sollten nur die hier aufgeführten Rollenkonst constants verwenden. Fügen Sie keine benutzerdefinierten Rollen oder Rollen hinzu, die nicht vordefiniert sind.

Vor der Verwendung dieser Objektrollen müssen Entwickler von Clientanwendungen das Tool Überprüfen verwenden, um zu überprüfen, ob Objektrollen von Benutzeroberflächenelementen verwendet werden.

Um die Rolle eines Objekts abzurufen, rufen Clients die IAccessible::get _ accRole-Methode auf, die einen der in der Tabelle beschriebenen Werte zurückgeben muss. Um eine lokalisierte Zeichenfolge abzurufen, die die Rolle des Objekts beschreibt, rufen Clients die GetRoleText-Funktion mit dem Rollenwert auf. Die lokalisierten Zeichenfolgen für die Rollenwerte befinden sich in der oleaccrc.dll Datei.

Konstante BESCHREIBUNG
ROLE _ SYSTEM _ ALERT
Das -Objekt stellt eine Warnung oder eine Bedingung dar, über die ein Benutzer benachrichtigt werden soll. Diese Rolle wird nur für Objekte verwendet, die eine Warnung verkörpern, aber nicht einem anderen Benutzeroberflächenelement zugeordnet sind, z. B. einem Meldungsfeld, einer Grafik, einem Text oder einem Sound.
ROLE _ SYSTEM _ ANIMATION
Das -Objekt stellt ein Animationssteuerobjekt dar, dessen Inhalt sich im Laufe der Zeit ändert, z. B. ein Steuerelement, das eine Reihe von Bitmapframes anzeigt. Animationssteuerelemente werden angezeigt, wenn Dateien kopiert werden oder wenn eine andere zeitaufwändige Aufgabe ausgeführt wird.
ROLE _ SYSTEM _ APPLICATION
Das -Objekt stellt ein Hauptfenster für eine Anwendung dar.
ROLE _ SYSTEM _ BORDER
Das -Objekt stellt einen Fensterrahmen dar. Der gesamte Rahmen wird durch ein einzelnes Objekt und nicht durch separate Objekte für jede Seite dargestellt.
_ _ ROLLENSYSTEMSCHALTFLÄCHEDROPDOWN
Das -Objekt stellt eine Schaltfläche dar, die eine Liste von Elementen erweitert.
_ _ ROLLENSYSTEMSCHALTFLÄCHEDROPDOWNGRID
Das -Objekt stellt eine Schaltfläche dar, die ein Raster erweitert.
SCHALTFLÄCHE _ _ "ROLLENSYSTEM"MENU
Das -Objekt stellt eine Schaltfläche dar, die ein Menü erweitert.
_ _ ROLLENSYSTEM-CARET
Das -Objekt stellt das System caret dar.
_ _ ROLLENSYSTEMZELLE
Das -Objekt stellt eine Zelle innerhalb einer Tabelle dar.
_ _ ROLLENSYSTEMZEICHEN
Das -Objekt stellt ein grafikbasiertes Objekt dar, z. B. Microsoft Office Assistent, das angezeigt wird, um Benutzern einer Anwendung Hilfe zu bieten.
_ _ ROLLENSYSTEMDIAGRAMM
Das -Objekt stellt ein grafisches Bild dar, das zum Diagramm von Daten verwendet wird.
_CHECKBUTTON DES _ ROLLENSYSTEMS
Das -Objekt stellt ein Kontrollkästchen-Steuerelement dar: eine Option, die unabhängig von anderen Optionen ausgewählt oder wieder aktiviert ist.
_ _ ROLLENSYSTEMCLIENT
Das -Objekt stellt den Clientbereich eines Fensters dar. Microsoft Active Accessibility wird diese Rolle als Standard verwendet, wenn eine Frage zur Rolle eines Benutzeroberflächenelements besteht.
ROLE _ SYSTEM _ CLOCK
Das -Objekt stellt ein Steuerelement dar, das die Zeit anzeigt.
ROLE _ SYSTEM _ COLUMN
Das -Objekt stellt eine Spalte von Zellen innerhalb einer Tabelle dar.
ROLE _ SYSTEM _ COLUMNHEADER
Das -Objekt stellt einen Spaltenheader dar und stellt eine visuelle Bezeichnung für eine Spalte in einer Tabelle zur Verfügung.
KOMBINATIONSFELD _ _ "ROLLENSYSTEM"
Das -Objekt stellt ein Kombinationsfeld dar: ein Bearbeitungssteuerfeld mit einem zugeordneten Listenfeld, das eine Reihe vordefinierter Optionen bietet.
_ _ ROLLENSYSTEMCURSOR
Das -Objekt stellt den Mauszeiger des Systems dar.
_ _ ROLLENSYSTEMDIAGRAMM
Das -Objekt stellt ein grafisches Bild dar, das zum Diagramm von Daten verwendet wird.
_ _ ROLLENSYSTEMWAHL
Das -Objekt stellt einen Wähl- oder Regler dar.
DIALOGFELD _ _ "ROLLENSYSTEM"
Das -Objekt stellt ein Dialogfeld oder ein Meldungsfeld dar.
ROLE _ SYSTEM DOCUMENT (ROLLENSYSTEMDOKUMENT) _
Das -Objekt stellt ein Dokumentfenster dar. Ein Dokumentfenster ist immer in einem Anwendungsfenster enthalten. Diese Rolle gilt nur für MDI-Fenster und verweist auf das Objekt, das die MDI-Titelleiste enthält.
ROLE _ SYSTEM _ DROPLIST
Das -Objekt stellt das Kalendersteuerobjekt SysDateTimePick32 dar. Die Microsoft Active Accessibility Laufzeitkomponente verwendet diese Rolle, um anzugeben, dass ein Datums- oder Kalendersteuerelement gefunden wurde.
_ _ ROLLENSYSTEMGLEICHUNG
Das -Objekt stellt eine mathematische Gleichung dar.
GRAFIK _ ZUM _ ROLLENSYSTEM
Das -Objekt stellt ein Bild dar.
ROLE _ _ SYSTEM-GREIFER
Das -Objekt stellt einen speziellen Mauszeiger dar, mit dem ein Benutzer Benutzeroberflächenelemente wie Fenster bearbeiten kann. Ein Beispiel hierfür ist das Ändern der Größe eines Fensters durch Ziehen der unteren rechten Ecke.
_ _ ROLLENSYSTEMGRUPPEN
Das -Objekt gruppent andere Objekte logisch. Es gibt nicht immer eine Über-/Unter-/Unter-Beziehung zwischen dem Gruppierungsobjekt und den objekten, die es enthält.
ROLE _ SYSTEM _ HELPBALLOON
Das -Objekt zeigt ein Hilfethema in Form einer QuickInfo oder eines Hilfesprechblasens an.
ROLE _ SYSTEM _ HOTKEYFIELD
Das -Objekt stellt ein Tastenkombinationsfeld dar, mit dem der Benutzer eine Kombination oder Sequenz von Tastatureingaben eingeben kann.
_ _ ROLLENSYSTEMINDIKATOR
Das -Objekt stellt einen Indikator dar, z. B. eine Zeigergrafik, der auf das aktuelle Element zeigt.
_ _ ROLLENSYSTEM-IPADDRESS
Das -Objekt stellt ein Bearbeitungssteuerobjekt dar, das für eine IP-Adresse entworfen wurde. Das Bearbeitungssteuerteil ist in Abschnitte unterteilt, die jeweils für einen bestimmten Teil der IP-Adresse verwendet werden.
ROLE _ SYSTEM _ LINK
Das -Objekt stellt einen Link zu einem anderen Objekt dar. Dieses Objekt kann wie ein Text oder eine Grafik aussehen, funktioniert jedoch wie eine Schaltfläche.
_ _ ROLLENSYSTEMLISTE
Das -Objekt stellt ein Listenfeld dar, mit dem der Benutzer ein oder mehrere Elemente auswählen kann.
ROLE _ SYSTEM _ LISTITEM
Das -Objekt stellt ein Element in einem Listenfeld oder im Listenteil eines Kombinationsfelds, Dropdownlistenfelds oder Dropdown-Kombinationsfelds dar.
MENÜLEISTE _ _ "ROLLENSYSTEM"
Das -Objekt stellt die Menüleiste dar (positioniert unter der Titelleiste eines Fensters), in der Benutzer Menüs auswählen.
MENÜELEMENT _ _ "ROLLENSYSTEM"
Das -Objekt stellt ein Menüelement dar: ein Menüeintrag, den der Benutzer auswählen kann, um einen Befehl auszuführen, eine Option auszuwählen oder ein anderes Menü anzuzeigen. Funktionell entspricht ein Menüelement einem Pushschaltfeld, einem Optionsfeld, einem Kontrollkästchen oder einem Menü.
MENÜ _ _ "ROLLENSYSTEM"POPUP
Das -Objekt stellt ein Menü dar: eine Liste von Optionen mit jeweils einer bestimmten Aktion. Alle Menütypen müssen eine Rolle haben, einschließlich der Dropdownmenüs, die angezeigt werden, wenn sie in einer Menüleiste ausgewählt werden. und Kontextmenüs, die durch Klicken auf die rechte Maustaste angezeigt werden.
_ _ ROLLENSYSTEMGLIEDERUNG
Das -Objekt stellt eine Gliederung oder eine Struktur dar, z. B. ein Strukturansichtssteuerelement, das eine hierarchische Liste anzeigt und es dem Benutzer ermöglicht, Verzweigungen zu erweitern und zu reduzieren.
ROLE _ SYSTEM _ OUTLINEBUTTON
Das -Objekt stellt ein Element dar, das wie ein Gliederungselement navigiert. Die NACH-OBEN- und NACH-UNTEN-TASTE werden verwendet, um durch die Kontur zu navigieren. Anstatt jedoch zu erweitern und zu reduzieren, wenn die NACH-LINKS- und NACH-RECHTS-TASTE gedrückt wird, werden diese Menüs erweitert oder reduziert, wenn die LEERTASTE oder EINGABETASTE gedrückt wird und das Element den Fokus besitzt.
ROLE _ SYSTEM _ OUTLINEITEM
Das -Objekt stellt ein Element in einer Kontur oder Struktur dar.
ROLE _ SYSTEM _ PAGETAB
Das -Objekt stellt eine Seitenregisterkarte dar. Das einzige untergeordnete Element eines Seitenregisterkarten-Steuerelements ist ein ROLE _ SYSTEM _ GROUPING-Objekt, das über den Inhalt der zugeordneten Seite verfügt.
ROLE _ SYSTEM _ PAGETABLIST
Das -Objekt stellt einen Container von Seitenregisterkarten-Steuerelementen dar.
_BEREICH _ "ROLLENSYSTEM"
Das -Objekt stellt einen Bereich innerhalb eines Rahmens oder Dokumentfensters dar. Benutzer können zwischen Bereichen und innerhalb des Inhalts des aktuellen Bereichs navigieren, jedoch nicht zwischen Elementen in unterschiedlichen Bereichen. Daher stellen Bereiche eine Gruppierungsebene dar, die niedriger als Frames oder Dokumentfenster, aber höher als einzelne Steuerelemente ist. Der Benutzer kann je nach Kontext durch Drücken von TAB, F6 oder STRG+TAB zwischen den Bereichen navigieren.
STATUSLEISTE _ DES ROLLENSYSTEMS _
Das -Objekt stellt eine Statusanzeige dar, die dynamisch anzeigt, wie viel eines ausgeführten Vorgangs abgeschlossen wurde. Dieses Steuerelement nimmt keine Benutzereingaben entgegen.
ROLE _ SYSTEM _ PROPERTYPAGE
Das -Objekt stellt ein Eigenschaftenblatt dar.
_ _ ROLLENSYSTEM-PUSHBUTTON
Das -Objekt stellt ein Schaltflächen-Steuerelement dar.
ROLE _ SYSTEM _ RADIOBUTTON
Das -Objekt stellt eine Optionsschaltfläche (früher ein Optionsfeld) dar. Es handelt sich um eine Gruppe von Sich gegenseitig ausschließenden Optionen. Alle Objekte, die dasselbe übergeordnete Element und dieses Attribut aufweisen, werden als Teil einer einzelnen sich gegenseitig ausschließenden Gruppe angenommen. Verwenden Sie ROLE _ SYSTEM GROUPING-Objekte, um diese Objekte in separate Gruppen _ aufzuteilen.
ROLE _ SYSTEM _ ROW
Das -Objekt stellt eine Zeile von Zellen innerhalb einer Tabelle dar.
ROLE _ SYSTEM _ ROWHEADER
Das -Objekt stellt einen Zeilenheader dar, der eine visuelle Bezeichnung für eine Tabellenzeile bereitstellt.
_SCROLLLEISTE DES ROLLENSYSTEMS _
Das -Objekt stellt eine vertikale oder horizontale Scrollleiste dar, die Teil des Clientbereichs ist oder in einem -Steuerelement verwendet wird.
_ _ ROLLENSYSTEMTRENNZEICHEN
Das -Objekt wird verwendet, um ein Leerzeichen visuell in zwei Bereiche zu unterteilen. Beispiele für Trennzeichenobjekte sind ein Trennzeichenmenüelement und eine Leiste, die geteilte Bereiche innerhalb eines Fensters teilt.
_ _ ROLLENSYSTEMSCHIEBEREGLER
Das -Objekt stellt einen Schieberegler dar, mit dem der Benutzer eine Einstellung in bestimmten Schritten zwischen minimalen und maximalen Werten anpassen kann.
ROLE _ SYSTEM _ SOUND
Das -Objekt stellt einen Systemsound dar, der verschiedenen Systemereignissen zugeordnet ist.
ROLE _ SYSTEM _ SPINBUTTON
Das -Objekt stellt ein Drehfeld dar, bei dem es sich um ein Steuerelement handelt, mit dem der Benutzer den Wert erhöhen oder dekrementieren kann, der in einem separaten "Versatz"-Steuerelement angezeigt wird, das dem Drehfeld zugeordnet ist.
ROLE _ SYSTEM _ SPLITBUTTON
Das -Objekt stellt eine Schaltfläche auf einer Symbolleiste dar, die über ein Dropdownlistensymbol verfügt, das direkt neben der Schaltfläche steht.
ROLE _ SYSTEM _ STATICTEXT
Das -Objekt stellt schreibgeschützten Text dar, z. B. Bezeichnungen für andere Steuerelemente oder Anweisungen in einem Dialogfeld. Statischer Text kann nicht geändert oder ausgewählt werden.
_ _ ROLLENSYSTEMSTATUSLEISTE
Das -Objekt stellt eine Statusleiste dar. Dabei handelt es sich um einen Bereich am unteren Rand eines Fensters, in dem Informationen zum aktuellen Vorgang, zum Status der Anwendung oder zum ausgewählten Objekt angezeigt werden. Die Statusleiste verfügt über mehrere Felder, in denen verschiedene Arten von Informationen angezeigt werden.
ROLE _ SYSTEM _ TABLE
Das -Objekt stellt eine Tabelle dar, die Zeilen und Spalten von Zellen sowie optional Zeilen- und Spaltenüberschriften enthält.
ROLE _ SYSTEM _ TEXT
Das -Objekt stellt auswählbaren Text dar, der Bearbeitungen zulässt oder als schreibgeschützt festgelegt ist.
ROLE _ SYSTEM _ TITLEBAR
Das -Objekt stellt einen Titel oder eine Beschriftungsleiste für ein Fenster dar.
_SYMBOLLEISTE DES ROLLENSYSTEMS _
Das -Objekt stellt eine Symbolleiste dar, bei der es sich um eine Gruppierung von Steuerelementen handelt, die den einfachen Zugriff auf häufig verwendete Features ermöglicht.
ROLE _ SYSTEM _ TOOLTIP
Das -Objekt stellt eine QuickInfo dar, die hilfreiche Hinweise bereitstellt.
LEERRAUM _ DES ROLLENSYSTEMS _
Das -Objekt stellt leerzeichen zwischen anderen -Objekten dar.
_ _ ROLLENSYSTEMFENSTER
Das -Objekt stellt den Fensterrahmen dar, der untergeordnete Objekte wie eine Titelleiste, einen Client und andere Objekte eines Fensters enthält.

Anforderungen

Anforderung Wert
Header
Oleacc.h