Objektstatuskonstanten

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.

Ein Objekt ist einem oder mehreren dieser Statuswerte jederzeit zugeordnet. Die folgenden Objektstatuskonstanten werden nicht verwendet: STATE_SYSTEM_ALERT_HIGH, STATE_SYSTEM_ALERT_MEDIUM, STATE_SYSTEM_ALERT_LOW und STATE_SYSTEM_FLOATING.

Clients rufen den Status eines Objekts durch Aufrufen von IAccessible::get_accState ab, wodurch eine ganze Zahl zurückgegeben wird, die eine Kombination der folgenden Bitkennzeichnungen darstellt. Clients rufen GetStateText mit dem Statuswert auf, um eine lokalisierte Zeichenfolge abzurufen, die den Zustand des Objekts beschreibt.

Wenn sich der Status eines Objekts ändert, sollten Server NotifyWinEvent mit der EVENT_OBJECT_STATECHANGE-Ereigniskonstante aufrufen. Objekte mit den STATE_SYSTEM_INVISIBLE, STATE_SYSTEM_FOCUSED und STATE_SYSTEM_ SELECTED-Objektstatuskonstanten verfügen jedoch über eigene Ereigniskonstanten. Verwenden Sie für diese Objekte nicht EVENT_OBJECT_STATECHANGE. Verwenden Sie stattdessen die einzelne Ereigniskonstante.

Im Folgenden sind Objektstatuskonstanten aufgeführt:

Konstante BESCHREIBUNG
STATE_SYSTEM_ALERT_HIGH
(Diese Objektstatuskonstante wird nicht unterstützt.)
Gibt wichtige Informationen an, die dem Benutzer sofort übermittelt werden sollen. Wenn z. B. ein Akku einen kritischen niedrigen Level erreicht, generiert ein Levelindikator eine Warnung auf hoher Ebene. Daher liest ein Blindzugriffstool sofort diese Informationen für den Benutzer vor, und ein Bildschirmvergrößerungsprogramm scrollt den Bildschirm, 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.
STATE_SYSTEM_ALERT_MEDIUM
(Diese Objektstatuskonstante wird nicht unterstützt.)
Gibt wichtige Informationen an, die dem Benutzer nicht sofort übermittelt werden. Wenn z. B. ein Akku mit einem niedrigen Niveau beginnt, generiert ein Levelindikator eine Benachrichtigung auf mittlerer Ebene. Ein Blindzugriffstool generiert dann einen Sound, um dem Benutzer mitzuteilen, dass wichtige Informationen verfügbar sind, ohne die Arbeit des Benutzers tatsächlich zu unterbrechen. Der Benutzer kann dann die Warnungsinformationen bei praktischer Verwendung abfragen.
STATE_SYSTEM_ALERT_LOW
(Diese Objektstatuskonstante wird nicht unterstützt.)
Gibt Informationen mit niedriger Priorität an, die für den Benutzer nicht wichtig sind. Dieser Zustand wird z. B. verwendet, wenn Word die Darstellung der Schaltfläche "TipWizard" auf der Symbolleiste ändert, um anzugeben, dass er einen Hinweis für den Benutzer hat.
STATE_SYSTEM_ANIMATED
Das Aussehen 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.
STATE_SYSTEM_BUSY
Das Steuerelement kann zurzeit keine Eingabe annehmen.
STATE_SYSTEM_CHECKED
Das Kontrollkästchen des Objekts ist aktiviert.
STATE_SYSTEM_COLLAPSED
Die untergeordneten Elemente des Objekts, die die ROLE_SYSTEM_OUTLINEITEM Rolle aufweisen, sind ausgeblendet.
STATE_SYSTEM_DEFAULT
Dieser Zustand stellt die Standardschaltfläche in einem Fenster dar.
STATE_SYSTEM_EXPANDED
Die untergeordneten Elemente des Objekts, die die ROLE_SYSTEM_OUTLINEITEM Rolle aufweisen, 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 Objektstatuskonstante wird nicht unterstützt.)
Das Objekt wird nicht auf die Grenze des übergeordneten Objekts zugeschnitten 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 empfangen.
STATE_SYSTEM_FOCUSED
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 Objektstatus die EVENT_OBJECT_SHOW oder EVENT_OBJECT_HIDE WinEvents, um Clientanwendungen über Zustandsänderungen zu benachrichtigen. Verwenden Sie EVENT_OBJECT_STATECHANGE nicht.
STATE_SYSTEM_HASPOPUP
Beim Aufrufen zeigt das Objekt ein Popupmenü oder ein Fenster an.
STATE_SYSTEM_HOTTRACKED
Das Objekt wird von der Maus heiß nachverfolgt, was bedeutet, dass sich die Darstellung des Objekts geändert hat, um anzugeben, dass sich der Mauszeiger darüber befindet.
STATE_SYSTEM_INVISIBLE
Das Objekt wird programmgesteuert ausgeblendet. Menü itmes werden beispielsweise programmgesteuert ausgeblendet, bis ein Benutzer das Menü aktiviert. Da Objekte mit diesem Zustand für Benutzer nicht verfügbar sind, dürfen Clientanwendungen keine Informationen über das Objekt an Benutzer kommunizieren. 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 kommunizieren. Beispielsweise kann ein Listenfeld 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 trifft, das unsichtbar ist, macht Microsoft Active Accessibility keine Informationen zu möglichen untergeordneten Elementen des übergeordneten Elements verfügbar, solange das übergeordnete Objekt nicht sichtbar ist.
STATE_SYSTEM_LINKED
Gibt an, dass das Objekt als Hyperlink formatiert ist. Die Rolle des Objekts wird in der Regel ROLE_SYSTEM_TEXT.
STATE_SYSTEM_MARQUEED
Gibt einen Bildlauf oder verschieben von Text oder Grafiken an.
STATE_SYSTEM_MIXED
Gibt an, dass der Status eines Drei-Zustands-Kontrollkästchens oder einer Symbolleistenschaltfläche nicht bestimmt wird. 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. Ein Benutzer kann beispielsweise 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 wird abgeschnitten oder hat aus der Ansicht gescrollt, ist aber nicht programmgesteuert ausgeblendet. Wenn der Benutzer den Viewport größer macht, wird mehr 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 die Auswahl.
STATE_SYSTEM_SELECTED
Das Objekt ist ausgewählt.
STATE_SYSTEM_SELFVOICING
Das Objekt oder untergeordnete Objekt verwendet die TTS-Technologie (Text-to-Speech) für Beschreibungszwecke. Wenn ein Objekt mit diesem Zustand den Fokus hat, liest eine sprachbasierte Barrierefreiheitshilfe keine Informationen vor, da das Objekt sie automatisch vorliest.
STATE_SYSTEM_SIZEABLE
Das Objekt kann geändert werden. Beispielsweise könnte ein Benutzer die Größe eines Fensters ändern, indem er durch Ziehen durch den Rahmen gezogen wird.
STATE_SYSTEM_TRAVERSED
Das Objekt ist ein Hyperlink, der von einem Benutzer besucht (zuvor geklickt) wurde.
STATE_SYSTEM_UNAVAILABLE
Das Objekt ist nicht verfügbar.

Requirements (Anforderungen)

Anforderung Wert
Header
Oleacc.h