Objektrollen

In diesem Thema werden die konstanten Werte beschrieben, mit denen die Rollen verschiedener Benutzeroberflächenobjekte in einer Anwendung beschrieben werden. Die Rollenkonstanten werden in der Datei Oleacc.h definiert.

Sie sollten nur die hier aufgeführten Rollenkonstanten 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 Inspect-Tool verwenden, um zu überprüfen, ob Objektrollen von UI-Elementen 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 Animationssteuerelement 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 Standard Fenster 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.
ROLE_SYSTEM_BUTTONDROPDOWN	Das -Objekt stellt eine Schaltfläche dar, die eine Liste von Elementen erweitert.
ROLE_SYSTEM_BUTTONDROPDOWNGRID	Das -Objekt stellt eine Schaltfläche dar, die ein Raster erweitert.
ROLE_SYSTEM_BUTTONMENU	Das -Objekt stellt eine Schaltfläche dar, die ein Menü erweitert.
ROLE_SYSTEM_CARET	Das -Objekt stellt das System caret dar.
ROLE_SYSTEM_CELL	Das -Objekt stellt eine Zelle in einer Tabelle dar.
ROLE_SYSTEM_CHARACTER	Das -Objekt stellt ein cartoonähnliches Grafikobjekt dar, z. B. microsoft Office Assistant, das angezeigt wird, um Benutzern einer Anwendung Hilfe zu bieten.
ROLE_SYSTEM_CHART	Das -Objekt stellt ein grafisches Bild dar, das zum Darstellen von Daten verwendet wird.
ROLE_SYSTEM_CHECKBUTTON	Das -Objekt stellt ein Kontrollkästchen-Steuerelement dar: eine Option, die unabhängig von anderen Optionen ausgewählt oder gelöscht wird.
ROLE_SYSTEM_CLIENT	Das -Objekt stellt den Clientbereich eines Fensters dar. Microsoft Active Accessibility verwendet diese Rolle als Standard, wenn es eine Frage zur Rolle eines UI-Elements gibt.
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 eine Spaltenüberschrift dar, die eine visuelle Bezeichnung für eine Spalte in einer Tabelle bereitstellt.
ROLE_SYSTEM_COMBOBOX	Das -Objekt stellt ein Kombinationsfeld dar: ein Bearbeitungssteuerelement mit einem zugeordneten Listenfeld, das eine Reihe vordefinierter Auswahlmöglichkeiten bereitstellt.
ROLE_SYSTEM_CURSOR	Das -Objekt stellt den Mauszeiger des Systems dar.
ROLE_SYSTEM_DIAGRAM	Das -Objekt stellt ein grafisches Bild dar, das zum Darstellen von Daten verwendet wird.
ROLE_SYSTEM_DIAL	Das -Objekt stellt ein Wähl oder einen Regler dar.
ROLE_SYSTEM_DIALOG	Das -Objekt stellt ein Dialogfeld oder ein Meldungsfeld dar.
ROLE_SYSTEM_DOCUMENT	Das -Objekt stellt ein Dokumentfenster dar. Ein Dokumentfenster ist immer in einem Anwendungsfenster enthalten. Diese Rolle gilt nur für MDI-Fenster und bezieht sich auf das Objekt, das die MDI-Titelleiste enthält.
ROLE_SYSTEM_DROPLIST	Das -Objekt stellt das Kalendersteuerelement SysDateTimePick32 dar. Die Microsoft Active Accessibility Runtime-Komponente verwendet diese Rolle, um anzugeben, dass ein Datums- oder Kalendersteuerelement gefunden wurde.
ROLE_SYSTEM_EQUATION	Das -Objekt stellt eine mathematische Gleichung dar.
ROLE_SYSTEM_GRAPHIC	Das -Objekt stellt ein Bild dar.
ROLE_SYSTEM_GRIP	Das -Objekt stellt einen speziellen Mauszeiger dar, mit dem benutzeroberflächenelemente wie Fenster bearbeitet werden können. Ein Beispiel hierfür ist das Ändern der Größe eines Fensters durch Ziehen der unteren rechten Ecke.
ROLE_SYSTEM_GROUPING	Das -Objekt gruppiert andere Objekte logisch. Zwischen dem Gruppierungsobjekt und den darin enthaltenen Objekten besteht nicht immer eine über- und untergeordnete Beziehung.
ROLE_SYSTEM_HELPBALLOON	Das -Objekt zeigt ein Hilfethema in Form einer QuickInfo oder Hilfesprechblase an.
ROLE_SYSTEM_HOTKEYFIELD	Das -Objekt stellt ein Tastenkombinationsfeld dar, das es dem Benutzer ermöglicht, eine Kombination oder Sequenz von Tastenanschlägen einzugeben.
ROLE_SYSTEM_INDICATOR	Das -Objekt stellt einen Indikator dar, z. B. eine Zeigergrafik, die auf das aktuelle Element zeigt.
ROLE_SYSTEM_IPADDRESS	Das -Objekt stellt ein Bearbeitungssteuerelement dar, das für eine IP-Adresse konzipiert ist. Das Bearbeitungssteuerelement ist in Abschnitte unterteilt, die jeweils für einen bestimmten Teil der IP-Adresse gelten.
ROLE_SYSTEM_LINK	Das -Objekt stellt einen Link zu etwas anderem dar. Dieses Objekt kann wie ein Text oder eine Grafik aussehen, funktioniert jedoch wie eine Schaltfläche.
ROLE_SYSTEM_LIST	Das -Objekt stellt ein Listenfeld dar, das es dem Benutzer ermöglicht, ein oder mehrere Elemente auszuwählen.
ROLE_SYSTEM_LISTITEM	Das -Objekt stellt ein Element in einem Listenfeld oder im Listenbereich eines Kombinationsfelds, eines Dropdownlistenfelds oder eines Dropdownkombinationsfelds dar.
ROLE_SYSTEM_MENUBAR	Das -Objekt stellt die Menüleiste (unterhalb der Titelleiste eines Fensters) dar, aus der Benutzer Menüs auswählen.
ROLE_SYSTEM_MENUITEM	Das -Objekt stellt ein Menüelement dar: einen 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 einer Drucktaste, einem Optionsfeld, einem Kontrollkästchen oder einem Menü.
ROLE_SYSTEM_MENUPOPUP	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 mit der rechten Maustaste angezeigt werden.
ROLE_SYSTEM_OUTLINE	Das -Objekt stellt eine Gliederung oder eine Struktur wie ein Strukturansichtssteuerelement dar, das eine hierarchische Liste anzeigt und dem Benutzer das Erweitern und Reduzieren von Verzweigungen ermöglicht.
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 Gliederung 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 DIE EINGABETASTE gedrückt wird und das Element den Fokus hat.
ROLE_SYSTEM_OUTLINEITEM	Das -Objekt stellt ein Element in einer Gliederung oder Struktur dar.
ROLE_SYSTEM_PAGETAB	Das -Objekt stellt eine Seitenregisterkarte dar. Das einzige untergeordnete Element eines Seitenregister-Steuerelements ist ein ROLE_SYSTEM_GROUPING-Objekt, das den Inhalt der zugeordneten Seite enthält.
ROLE_SYSTEM_PAGETABLIST	Das -Objekt stellt einen Container von Seitenregisterkarten-Steuerelementen dar.
ROLE_SYSTEM_PANE	Das -Objekt stellt einen Bereich innerhalb eines Rahmens oder eines 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.
ROLE_SYSTEM_PROGRESSBAR	Das -Objekt stellt eine Statusanzeige dar, die dynamisch anzeigt, wie viel eines laufenden Vorgangs abgeschlossen wurde. Dieses Steuerelement nimmt keine Benutzereingaben an.
ROLE_SYSTEM_PROPERTYPAGE	Das -Objekt stellt ein Eigenschaftenblatt dar.
ROLE_SYSTEM_PUSHBUTTON	Das -Objekt stellt ein Drucktasten-Steuerelement dar.
ROLE_SYSTEM_RADIOBUTTON	Das -Objekt stellt eine Optionsschaltfläche (früher ein Optionsfeld) dar. Es ist eine Gruppe von sich gegenseitig ausschließenden Optionen. Es wird davon ausgegangen, dass alle Objekte, die dasselbe übergeordnete Element verwenden und über dieses Attribut verfügen, Teil einer einzelnen sich gegenseitig ausschließenden Gruppe sind. Um diese Objekte in separate Gruppen zu unterteilen, verwenden Sie ROLE_SYSTEM_GROUPING-Objekte.
ROLE_SYSTEM_ROW	Das -Objekt stellt eine Zeile von Zellen innerhalb einer Tabelle dar.
ROLE_SYSTEM_ROWHEADER	Das -Objekt stellt eine Zeilenüberschrift dar, die eine visuelle Bezeichnung für eine Tabellenzeile bereitstellt.
ROLE_SYSTEM_SCROLLBAR	Das -Objekt stellt eine vertikale oder horizontale Bildlaufleiste dar, die Teil des Clientbereichs ist oder in einem Steuerelement verwendet wird.
ROLE_SYSTEM_SEPARATOR	Das -Objekt wird verwendet, um einen Raum visuell in zwei Bereiche zu unterteilen. Beispiele für Trennzeichenobjekte sind ein Trennzeichenmenüelement und eine Leiste, die geteilte Bereiche innerhalb eines Fensters teilt.
ROLE_SYSTEM_SLIDER	Das -Objekt stellt einen Schieberegler dar, der es dem Benutzer ermöglicht, eine Einstellung in bestimmten Inkrementen zwischen minimalen und maximalen Werten anzupassen.
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, das es dem Benutzer ermöglicht, den Wert zu erhöhen oder zu verringern, der in einem separaten , dem Drehfeld zugeordneten "Buddy"-Steuerelement angezeigt wird.
ROLE_SYSTEM_SPLITBUTTON	Das -Objekt stellt eine Schaltfläche auf einer Symbolleiste dar, die über ein Dropdownlistensymbol direkt neben der Schaltfläche verfügt.
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.
ROLE_SYSTEM_STATUSBAR	Das -Objekt stellt einen status-Balken dar, bei dem es sich um einen Bereich am unteren Rand eines Fensters handelt, der Informationen über den aktuellen Vorgang, den Status der Anwendung oder das ausgewählte Objekt anzeigt. Die status Leiste enthält mehrere Felder, die verschiedene Arten von Informationen anzeigen.
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 gekennzeichnet ist.
ROLE_SYSTEM_TITLEBAR	Das -Objekt stellt einen Titel oder Untertitel Leiste für ein Fenster dar.
ROLE_SYSTEM_TOOLBAR	Das -Objekt stellt eine Symbolleiste dar, bei der es sich um eine Gruppierung von Steuerelementen handelt, die einfachen Zugriff auf häufig verwendete Features ermöglicht.
ROLE_SYSTEM_TOOLTIP	Das -Objekt stellt eine QuickInfo dar, die hilfreiche Hinweise enthält.
ROLE_SYSTEM_WHITESPACE	Das -Objekt stellt einen leeren Abstand zwischen anderen Objekten dar.
ROLE_SYSTEM_WINDOW	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