Freigeben über


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
STATE_SYSTEM_ALERT_HIGH
(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.
STATE_SYSTEM_ALERT_MEDIUM
(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.
STATE_SYSTEM_ALERT_LOW
(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.
STATE_SYSTEM_ANIMATED
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.
STATE_SYSTEM_BUSY
Das Steuerelement kann derzeit keine Eingaben akzeptieren.
STATE_SYSTEM_CHECKED
Das Kontrollkästchen des Objekts ist aktiviert.
STATE_SYSTEM_COLLAPSED
Die untergeordneten Elemente des Objekts, die über die rolle ROLE_SYSTEM_OUTLINEITEM verfügen, sind ausgeblendet.
STATE_SYSTEM_DEFAULT
Dieser Zustand stellt die Standardschaltfläche in einem Fenster dar.
STATE_SYSTEM_EXPANDED
Die untergeordneten Elemente des Objekts, die über die rolle ROLE_SYSTEM_OUTLINEITEM verfügen, werden angezeigt.
STATE_SYSTEM_EXTSELECTABLE
Gibt an, dass ein Objekt seine Auswahl erweitert, indem SELFLAG_EXTENDSELECTION in der IAccessible::accSelect-Methode verwendet wird.
STATE_SYSTEM_FLOATING
(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.
STATE_SYSTEM_FOCUSABLE
Das Objekt befindet sich im aktiven Fenster und kann den Tastaturfokus erhalten.
STATE_SYSTEM_FOCUSED
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.
STATE_SYSTEM_HASPOPUP
Beim Aufrufen zeigt das Objekt ein Popupmenü oder ein Fenster an.
STATE_SYSTEM_HOTTRACKED
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.
STATE_SYSTEM_INVISIBLE
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.
STATE_SYSTEM_LINKED
Gibt an, dass das Objekt als Link formatiert ist. Die Rolle des Objekts wird in der Regel ROLE_SYSTEM_TEXT.
STATE_SYSTEM_MARQUEED
Gibt den Bildlauf oder das Verschieben von Text oder Grafiken an.
STATE_SYSTEM_MIXED
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.
STATE_SYSTEM_MOVEABLE
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.
STATE_SYSTEM_MULTISELECTABLE
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.
STATE_SYSTEM_OFFSCREEN
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.
STATE_SYSTEM_PRESSED
Das Objekt wird gedrückt.
STATE_SYSTEM_PROTECTED
Das -Objekt ist ein kennwortgeschütztes Bearbeitungssteuerelement.
STATE_SYSTEM_READONLY
Das Objekt ist schreibgeschützt.
STATE_SYSTEM_SELECTABLE
Das -Objekt akzeptiert eine Auswahl.
STATE_SYSTEM_SELECTED
Das Objekt ist ausgewählt.
STATE_SYSTEM_SELFVOICING
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.
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 durch den Rahmen zieht.
STATE_SYSTEM_TRAVERSED
Das Objekt ist ein Link, der von einem Benutzer besucht (zuvor geklickt) wurde.
STATE_SYSTEM_UNAVAILABLE
Das Objekt ist nicht verfügbar.

Anforderungen

Anforderung Wert
Header
Oleacc.h