Objektzustandskonstanten

In diesem Thema werden die konstanten Werte beschrieben, die verwendet werden, um den Zustand von Objekten in einer Anwendungsoberfläche zu beschreiben. 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 ab, indem sie IAccessible::get _ accStateaufrufen, der eine ganze Zahl zurückgibt, die eine Kombination der folgenden Bitflags ist. Clients rufen GetStateText mit dem Zustandswert 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 nicht EVENT _ OBJECT _ STATECHANGE. Verwenden Sie stattdessen die einzelne Ereigniskonstante.

Es folgen Objektzustandskonstanten:

Konstante BESCHREIBUNG
_ _ ZUSTANDSSYSTEMWARNUNG _ HOCH
(Diese Objektzustandskonstante wird nicht unterstützt.)
Gibt wichtige Informationen an, die dem Benutzer sofort übermittelt werden sollen. Wenn ein Akku beispielsweise einen kritisch niedrigen Wert erreicht, generiert ein Ebenenindikator eine warnung auf hoher Ebene. Daher gibt ein Tool für den blinden Zugriff diese Informationen dem Benutzer sofort an, und ein Bildschirmvergrößerungsprogramm führt einen Bildlauf auf dem Bildschirm durch, sodass der Akkuindikator angezeigt wird. Dieser Zustand ist auch für jede Eingabeaufforderung oder Operation geeignet, die abgeschlossen sein muss, bevor der Benutzer fortfahren kann.
_ _ _ ZUSTANDSSYSTEMWARNUNGSMEDIUM
(Diese Objektzustandskonstante wird nicht unterstützt.)
Gibt wichtige Informationen an, die dem Benutzer nicht sofort übermittelt werden. Wenn beispielsweise ein Akku einen niedrigen Wert erreicht, generiert ein Ebenenindikator eine Warnung auf mittlerer Ebene. Ein Tool für den blinden Zugriff generiert 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 die Warnungsinformationen dann bei Bedarf abfragen.
_ _ ZUSTANDSSYSTEMWARNUNG _ NIEDRIG
(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 Schaltfläche TipWizard auf der Symbolleiste ändert, um anzugeben, dass sie einen Hinweis für den Benutzer enthält.
ZUSTANDSSYSTEM _ _ ANIMIERT
Die Darstellung 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 die Position des Objekts ändert.
ZUSTANDSSYSTEM _ _ AUSGELASTET
Das Steuerelement kann derzeit keine Eingaben akzeptieren.
STATUSSYSTEM _ _ AKTIVIERT
Das Kontrollkästchen des Objekts ist aktiviert.
STATE _ SYSTEM _ COLLAPSED
Die untergeordneten Elemente des Objekts, die über die ROLE _ SYSTEM _ OUTLINEITEM-Rolle verfügen, werden ausgeblendet.
STATE _ SYSTEM _ DEFAULT
Dieser Zustand stellt die Standardschaltfläche in einem Fenster dar.
ERWEITERTES _ ZUSTANDSSYSTEM _
Die untergeordneten Elemente des Objekts mit der Rolle ROLE _ SYSTEM _ OUTLINEITEM werden angezeigt.
STATUSSYSTEM _ _ EXTSELECTABLE
Gibt an, dass ein Objekt seine Auswahl mit SELFLAG _ EXTENDSELECTION in der IAccessible::accSelect-Methode erweitert.
_UNVERANKERTE ZUSTANDSSYSTEME _
(Diese Objektzustandskonstante wird nicht unterstützt.)
Das -Objekt wird nicht an die Begrenzung des übergeordneten Objekts abgeschnitten, und es wird nicht automatisch verschoben, wenn das übergeordnete Objekt verschoben wird.
STATE _ SYSTEM _ FOCUSABLE
Das Objekt befindet sich im aktiven Fenster und kann den Tastaturfokus erhalten.
_ _ ZUSTANDSSYSTEMORIENTIERT
Das -Objekt hat den Tastaturfokus. Verwechseln Sie den Objektfokus nicht mit der Objektauswahl. Weitere Informationen finden Sie unter Selection and Focus Properties and Methods. Senden Sie für Objekte mit diesem Objektzustand die WinEvents EVENT _ OBJECT _ SHOW oder EVENT OBJECT _ _ HIDE, um Clientanwendungen über Zustandsänderungen zu benachrichtigen. Verwenden Sie EVENT _ OBJECT _ STATECHANGEnicht.
STATE _ SYSTEM _ HASPOPUP
Wenn es aufgerufen wird, zeigt das -Objekt ein Popupmenü oder ein Fenster an.
ZUSTANDSSYSTEM _ _ HOTTRACKED
Das Objekt wird von der Maus im Hottracking verfolgt. Dies bedeutet, dass sich die Darstellung des Objekts geändert hat, um anzugeben, dass sich der Mauszeiger darüber befindet.
STATUSSYSTEM _ _ UNSICHTBAR
Das Objekt wird programmgesteuert ausgeblendet. Beispielsweise werden Menü itmes 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 Status finden, sollten sie überprüfen, ob STATE _ SYSTEM _ OFFSCREEN ebenfalls festgelegt ist. Wenn dieser zweite Zustand definiert ist, können Clients die Informationen über das Objekt benutzern mitteilen. Beispielsweise kann für ein Listenfeld sowohl STATE SYSTEM INVISIBLE als auch _ _ STATE SYSTEM _ _ OFFSCREEN festgelegt sein. In diesem Fall kann die Clientanwendung benutzern alle Elemente in der Liste mitteilen.
Wenn eine Clientanwendung durch eine IAccessible-Struktur navigiert und auf ein nicht sichtbares übergeordnetes Objekt trifft, macht Microsoft Active Accessibility keine Informationen über mögliche untergeordnete Elemente des übergeordneten Elements verfügbar, solange das übergeordnete Objekt unsichtbar ist.
ZUSTANDSSYSTEM _ _ VERKNÜPFT
Gibt an, dass das Objekt als Link formatiert ist. Die Rolle des Objekts ist in der Regel ROLE _ SYSTEM _ TEXT.
STATE _ SYSTEM _ MARQUEED
Gibt das Scrollen oder Verschieben von Text oder Grafiken an.
STATE _ SYSTEM _ MIXED
Gibt an, dass der Status eines Kontrollkästchens mit drei Zuständen oder einer Symbolleistenschaltfläche nicht bestimmt wird. Das Kontrollkästchen ist weder aktiviert noch gelöscht und befindet sich daher im dritten oder gemischten Zustand.
ZUSTANDSSYSTEM _ _ VERSCHIEBEBAR
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.
ZUSTANDSSYSTEM _ _ MEHRFACHAUSWÄHLBAR
Gibt an, dass das -Objekt mehrere ausgewählte Elemente akzeptiert. Das heißt, SELFLAG _ ADDSELECTION für die IAccessible::accSelect-Methode ist gültig.
STATE _ SYSTEM _ NORMAL
Gibt an, dass dem Objekt kein anderer Zustand zugewiesen ist.
OFFSCREEN _ DES ZUSTANDSSYSTEMS _
Das Objekt wird abgeschnitten oder aus der Ansicht gescrollt, ist aber nicht programmgesteuert ausgeblendet. Wenn der Benutzer den Viewport vergrößert, wird ein größerer Teil des Objekts auf dem Computerbildschirm angezeigt.
ZUSTANDSSYSTEM _ _ GEDRÜCKT
Das -Objekt wird gedrückt.
ZUSTANDSSYSTEM _ _ GESCHÜTZT
Das -Objekt ist ein kennwortgeschütztes Bearbeitungssteuerelement.
_ _ SCHREIBGESCHÜTZTES ZUSTANDSSYSTEM
Das -Objekt ist schreibgeschützt.
ZUSTANDSSYSTEM _ _ AUSWÄHLBAR
Das -Objekt akzeptiert die Auswahl.
STATUSSYSTEM _ _ AUSGEWÄHLT
Das Objekt ist ausgewählt.
_SELBSTAUSSTELLUNG DES _ ZUSTANDSSYSTEMS
Das Objekt oder untergeordnete Objekt verwendet TTS-Technologie (Text-to-Speech) zu Beschreibungszwecken. Wenn ein Objekt mit diesem Zustand den Fokus besitzt, gibt eine sprachbasierte Barrierefreiheitshilfe keine Informationen an, da das Objekt dies automatisch ankündigt.
STATE _ SYSTEM _ SIZEABLE
Die Größe des Objekts kann geändert werden. Beispielsweise kann ein Benutzer die Größe eines Fensters ändern, indem er es am Rahmen zieht.
ZUSTANDSSYSTEM _ _ DURCHSUCHT
Das -Objekt ist ein Link, der von einem Benutzer besucht (zuvor angeklickt) wurde.
ZUSTANDSSYSTEM _ _ NICHT VERFÜGBAR
Das -Objekt ist nicht verfügbar.

Anforderungen

Anforderung Wert
Header
Oleacc.h