Objektzustandskonstanten
In diesem Thema werden die konstanten Werte beschrieben, die zum Beschreiben des Zustands von Objekten in einer Anwendungsbenutzeroberfläche verwendet werden. Die Zustandskonstanten werden in oleacc.h definiert.
Einem oder mehreren dieser Zustandswerte ist jederzeit ein Objekt zugeordnet. Die folgenden Objektzustandskonstanten werden nicht verwendet: STATE_SYSTEM_ALERT_HIGH, STATE_SYSTEM_ALERT_MEDIUM, STATE_SYSTEM_ALERT_LOW und STATE_SYSTEM_FLOATING.
Clients rufen den Zustand eines Objekts durch Aufrufen von IAccessible::get_accState ab, das eine ganze Zahl zurückgibt, die eine Kombination der folgenden Bitflags ist. Clients rufen GetStateText mit dem Statuswert auf, um eine lokalisierte Zeichenfolge abzurufen, die den Zustand des Objekts beschreibt.
Wenn sich der Zustand eines Objekts ändert, sollten Server NotifyWinEvent mit der EVENT_OBJECT_STATECHANGE Ereigniskonstante aufrufen. Objekte mit den objektzustandskonstanten STATE_SYSTEM_INVISIBLE, STATE_SYSTEM_FOCUSED und STATE_SYSTEM_ SELECTED verfügen jedoch über eigene Ereigniskonstanten. Verwenden Sie für diese Objekte keine EVENT_OBJECT_STATECHANGE. Verwenden Sie stattdessen die einzelne Ereigniskonstante.
Im Folgenden sind Objektzustandskonstanten aufgeführt:
| Konstante | BESCHREIBUNG |
|---|---|
|
(Diese Objektzustandskonstante wird nicht unterstützt.) Gibt wichtige Informationen an, die dem Benutzer sofort übermittelt werden sollen. Wenn ein Akku beispielsweise einen kritisch niedrigen Pegel erreicht, generiert eine Füllstandsanzeige eine warnung auf hoher Ebene. Als Ergebnis gibt ein Blindzugriffstool diese Informationen sofort an den Benutzer an, und ein Bildschirmvergrößerungsprogramm scrollt auf dem Bildschirm, sodass die Akkuanzeige angezeigt wird. Dieser Zustand ist auch für jede Eingabeaufforderung oder Operation geeignet, die abgeschlossen sein muss, bevor der Benutzer fortfahren kann. |
|
(Diese Objektzustandskonstante wird nicht unterstützt.) Gibt wichtige Informationen an, die dem Benutzer nicht sofort übermittelt werden. Wenn ein Akku beispielsweise einen niedrigen Pegel erreicht, generiert eine Füllstandsanzeige eine Warnung auf mittlerer Ebene. Ein Blindzugriffstool erzeugt dann einen Sound, um den Benutzer darüber zu informieren, dass wichtige Informationen verfügbar sind, ohne die Arbeit des Benutzers tatsächlich zu unterbrechen. Der Benutzer kann dann die Warnungsinformationen nach Bedarf abfragen. |
|
(Diese Objektzustandskonstante wird nicht unterstützt.) Gibt Informationen mit niedriger Priorität an, die für den Benutzer nicht wichtig sind. Dieser Zustand wird beispielsweise verwendet, wenn Word die Darstellung der TipWizard-Schaltfläche auf der Symbolleiste ändert, um anzugeben, dass sie einen Hinweis für den Benutzer enthält. |
|
Das Erscheinungsbild des Objekts ändert sich schnell oder ständig. Grafiken, die gelegentlich animiert werden, werden als ROLE_SYSTEM_GRAPHIC beschrieben, wobei die State-Eigenschaft auf STATE_SYSTEM_ANIMATED festgelegt ist. Dieser Zustand wird verwendet, um anzugeben, dass sich der Speicherort des Objekts ändert. |
|
Das Steuerelement kann derzeit keine Eingaben akzeptieren. |
|
Das Kontrollkästchen des Objekts ist aktiviert. |
|
Die untergeordneten Elemente des Objekts, die über die rolle ROLE_SYSTEM_OUTLINEITEM verfügen, sind ausgeblendet. |
|
Dieser Zustand stellt die Standardschaltfläche in einem Fenster dar. |
|
Die untergeordneten Elemente des Objekts, die über die rolle ROLE_SYSTEM_OUTLINEITEM verfügen, werden angezeigt. |
|
Gibt an, dass ein Objekt seine Auswahl erweitert, indem SELFLAG_EXTENDSELECTION in der IAccessible::accSelect-Methode verwendet wird. |
|
(Diese Objektzustandskonstante wird nicht unterstützt.) Das Objekt wird nicht an die Grenze seines übergeordneten Objekts beschnitten und wird nicht automatisch verschoben, wenn das übergeordnete Objekt verschoben wird. |
|
Das Objekt befindet sich im aktiven Fenster und kann den Tastaturfokus erhalten. |
|
Das -Objekt verfügt über den Tastaturfokus. Verwechseln Sie den Objektfokus nicht mit der Objektauswahl. Weitere Informationen finden Sie unter Auswahl- und Fokuseigenschaften und -methoden. Senden Sie bei Objekten mit diesem Objektzustand die EVENT_OBJECT_SHOW oder EVENT_OBJECT_HIDE WinEvents, um Clientanwendungen über Zustandsänderungen zu benachrichtigen. Verwenden Sie nicht EVENT_OBJECT_STATECHANGE. |
|
Beim Aufrufen zeigt das Objekt ein Popupmenü oder ein Fenster an. |
|
Das Objekt wird von der Maus nachverfolgt, was bedeutet, dass sich das Erscheinungsbild des Objekts geändert hat, um anzugeben, dass sich der Mauszeiger darüber befindet. |
|
Das Objekt ist programmgesteuert ausgeblendet. Beispielsweise werden Menüvorgänge programmgesteuert ausgeblendet, bis ein Benutzer das Menü aktiviert. Da Objekte mit diesem Zustand für Benutzer nicht verfügbar sind, dürfen Clientanwendungen benutzern keine Informationen über das Objekt mitteilen. Wenn Clientanwendungen jedoch ein Objekt mit diesem Zustand finden, sollten sie überprüfen, ob auch STATE_SYSTEM_OFFSCREEN festgelegt ist. Wenn dieser zweite Zustand definiert ist, können Clients die Informationen über das Objekt an Benutzer übermitteln. Ein Listenfeld kann beispielsweise sowohl STATE_SYSTEM_INVISIBLE als auch STATE_SYSTEM_OFFSCREEN festgelegt haben. In diesem Fall kann die Clientanwendung alle Elemente in der Liste an Benutzer kommunizieren. Wenn eine Clientanwendung durch eine IAccessible-Struktur navigiert und auf ein übergeordnetes Objekt stößt, das unsichtbar ist, macht Microsoft Active Accessibility keine Informationen zu möglichen untergeordneten Elementen des übergeordneten Elements verfügbar, solange das übergeordnete Objekt unsichtbar ist. |
|
Gibt an, dass das Objekt als Link formatiert ist. Die Rolle des Objekts wird in der Regel ROLE_SYSTEM_TEXT. |
|
Gibt den Bildlauf oder das Verschieben von Text oder Grafiken an. |
|
Gibt an, dass der Status eines Kontrollkästchens mit drei Status oder einer Symbolleistenschaltfläche nicht bestimmt ist. Das Kontrollkästchen ist weder aktiviert noch deaktiviert und befindet sich daher im dritten oder gemischten Zustand. |
|
Gibt an, dass das Objekt verschoben werden kann. Beispielsweise kann ein Benutzer auf die Titelleiste des Objekts klicken und das Objekt an eine neue Position ziehen. |
|
Gibt an, dass das Objekt mehrere ausgewählte Elemente akzeptiert; Das heißt, SELFLAG_ADDSELECTION für die IAccessible::accSelect-Methode ist gültig. |
|
Gibt an, dass dem Objekt kein anderer Zustand zugewiesen ist. |
|
Das Objekt ist beschnitten oder hat einen Bildlauf ausgeführt, ist aber nicht programmgesteuert ausgeblendet. Wenn der Benutzer den Viewport vergrößert, wird ein größerer Teil des Objekts auf dem Computerbildschirm angezeigt. |
|
Das Objekt wird gedrückt. |
|
Das -Objekt ist ein kennwortgeschütztes Bearbeitungssteuerelement. |
|
Das Objekt ist schreibgeschützt. |
|
Das -Objekt akzeptiert eine Auswahl. |
|
Das Objekt ist ausgewählt. |
|
Das Objekt oder untergeordnete Objekt verwendet die TTS-Technologie (Text-to-Speech) zu Beschreibungszwecken. Wenn ein Objekt mit diesem Zustand den Fokus hat, gibt eine sprachbasierte Barrierefreiheitshilfe keine Informationen an, da das Objekt sie automatisch ankündigt. |
|
Die Größe des Objekts kann geändert werden. Beispielsweise kann ein Benutzer die Größe eines Fensters ändern, indem er es durch den Rahmen zieht. |
|
Das Objekt ist ein Link, der von einem Benutzer besucht (zuvor geklickt) wurde. |
|
Das Objekt ist nicht verfügbar. |
Anforderungen
| Anforderung | Wert |
|---|---|
| Header |
|