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 Zustandswerte 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 ab, indem IAccessible::get_accStateaufgerufen wird, wodurch eine ganze Zahl zurückgegeben wird, die eine Kombination der folgenden Bitkennzeichnungen ist. Clients rufen GetStateText- mit dem Statuswert auf, um eine lokalisierte Zeichenfolge abzurufen, die den Status des Objekts beschreibt.

Wenn sich der Status eines Objekts ändert, sollten Server NotifyWinEvent- mit der EVENT_OBJECT_STATECHANGE-Ereigniskonstante aufrufen. Objekte mit der STATE_SYSTEM_INVISIBLE, STATE_SYSTEM_FOCUSED und STATE_SYSTEM_ SELECTED-Objektzustandskonstanten weisen jedoch eigene Ereigniskonstanten auf. 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 0x10000000	(Diese Objektstatuskonstante wird nicht unterstützt.) Gibt wichtige Informationen an, die dem Benutzer sofort vermittelt werden sollen. Wenn z. B. eine Batterie einen kritisch niedrigen Level erreicht, generiert ein Levelindikator eine Warnung auf hoher Ebene. Daher liest ein Tool für den Blindzugriff dem Benutzer sofort diese Informationen vor, und ein Bildschirmvergrößerungsprogramm führt einen Bildlauf auf den Bildschirm durch, sodass die Akkuanzeige angezeigt wird. Dieser Zustand eignet sich auch für alle Eingabeaufforderungen oder Vorgänge, die abgeschlossen werden müssen, bevor der Benutzer fortfahren kann.
STATE_SYSTEM_ALERT_MEDIUM 0x8000000	(Diese Objektstatuskonstante wird nicht unterstützt.) Gibt wichtige Informationen an, die dem Benutzer nicht sofort vermittelt werden. Wenn z. B. ein Akku mit einem niedrigen Level beginnt, generiert ein Levelindikator eine Warnung auf mittlerer Ebene. Ein Blindzugriffstool generiert dann einen Sound, um dem Benutzer mitzuteilen, dass wichtige Informationen verfügbar sind, ohne die Arbeit des Benutzers zu unterbrechen. Der Benutzer kann dann die Warnungsinformationen bei Bedarf abfragen.
STATE_SYSTEM_ALERT_LOW 0x4000000	(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 TipWizard-Schaltfläche auf der Symbolleiste ändert, um anzugeben, dass er einen Hinweis für den Benutzer hat.
STATE_SYSTEM_ANIMATED 0x4000	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 0x800	Das Steuerelement kann zurzeit keine Eingabe annehmen.
STATE_SYSTEM_CHECKED 0x10	Das Kontrollkästchen des Objekts ist aktiviert.
STATE_SYSTEM_COLLAPSED 0x400	Die untergeordneten Elemente des Objekts, die die ROLE_SYSTEM_OUTLINEITEM Rolle aufweisen, sind ausgeblendet.
STATE_SYSTEM_DEFAULT 0x100	Dieser Zustand stellt die Standardschaltfläche in einem Fenster dar.
STATE_SYSTEM_EXPANDED 0x200	Die untergeordneten Elemente des Objekts, die über die rolle ROLE_SYSTEM_OUTLINEITEM verfügen, werden angezeigt.
STATE_SYSTEM_EXTSELECTABLE 0x2000000	Gibt an, dass ein Objekt seine Auswahl mithilfe von SELFLAG_EXTENDSELECTION in der IAccessible::accSelect -Methode erweitert.
STATE_SYSTEM_FLOATING 0x1000	(Diese Objektstatuskonstante wird nicht unterstützt.) Das Objekt wird nicht an die Grenze des übergeordneten Objekts abgeschnitten, und es wird nicht automatisch verschoben, wenn das übergeordnete Objekt verschoben wird.
STATE_SYSTEM_FOCUSABLE 0x100000	Das Objekt befindet sich im aktiven Fenster und kann den Tastaturfokus erhalten.
STATE_SYSTEM_FOCUSED 0x4	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_STATECHANGEnicht.
STATE_SYSTEM_HASPOPUP 0x40000000	Beim Aufrufen zeigt das Objekt ein Popupmenü oder ein Fenster an.
STATE_SYSTEM_HOTTRACKED 0x80	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 0x8000	Das Objekt ist 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 übermitteln. 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. 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 mit Benutzern 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 Element nicht sichtbar ist.
STATE_SYSTEM_LINKED 0x400000	Gibt an, dass das Objekt als Link formatiert ist. Die Rolle des Objekts wird in der Regel ROLE_SYSTEM_TEXT.
STATE_SYSTEM_MARQUEED 0x2000	Gibt den Bildlauf oder verschieben von Text oder Grafiken an.
STATE_SYSTEM_MIXED 0x20	Gibt an, dass der Status eines Kontrollkästchens mit drei Status 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 0x40000	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 0x1000000	Gibt an, dass das Objekt mehrere ausgewählte Elemente akzeptiert; d. h. SELFLAG_ADDSELECTION für die IAccessible::accSelect Methode ist gültig.
STATE_SYSTEM_NORMAL 0	Gibt an, dass dem Objekt kein anderer Zustand zugewiesen ist.
STATE_SYSTEM_OFFSCREEN 0x10000	Das Objekt ist abgeschnitten oder hat einen Bildlauf außerhalb der Ansicht ausgeführt, ist aber nicht programmgesteuert ausgeblendet. Wenn der Benutzer den Viewport größer macht, wird mehr des Objekts auf dem Computerbildschirm angezeigt.
STATE_SYSTEM_PRESSED 0x8	Das Objekt wird gedrückt.
STATE_SYSTEM_PROTECTED 0x20000000	Das Objekt ist ein kennwortgeschütztes Bearbeitungssteuerelement.
STATE_SYSTEM_READONLY 0x40	Das Objekt ist schreibgeschützt.
STATE_SYSTEM_SELECTABLE 0x200000	Das Objekt akzeptiert die Auswahl.
STATE_SYSTEM_SELECTED 0x2	Das Objekt ist ausgewählt.
STATE_SYSTEM_SELFVOICING 0x80000	Das Objekt oder untergeordnete Objekt verwendet die TTS-Technologie (Text-to-Speech) für Beschreibungszwecke. Wenn ein Objekt mit diesem Zustand den Fokus hat, gibt eine sprachbasierte Barrierefreiheitshilfe keine Informationen an, da das Objekt es automatisch angibt.
STATE_SYSTEM_SIZEABLE 0x20000	Die Größe des Objekts 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 0x800000	Das Objekt ist ein Hyperlink, der von einem Benutzer besucht (zuvor geklickt) wurde.
STATE_SYSTEM_UNAVAILABLE 0x1	Das Objekt ist nicht verfügbar.

Anforderungen

Anforderung	Wert
Kopfball	Oleacc.h