Konstanty stavu objektu

Toto téma popisuje konstantní hodnoty použité k popisu stavu objektů v uživatelském rozhraní aplikace. Stavové konstanty jsou definovány v oleacc.h.

Objekt je kdykoli přidružen k jedné nebo více z těchto hodnot stavu. Následující konstanty stavu objektu se nepoužívají: STATE_SYSTEM_ALERT_HIGH, STATE_SYSTEM_ALERT_MEDIUM, STATE_SYSTEM_ALERT_LOW a STATE_SYSTEM_FLOATING.

Klienti načtou stav objektu voláním IAccessible::get_accState, která vrátí celé číslo, které je kombinací následujících bitových příznaků. Klienti volají GetStateText s hodnotou stavu k načtení lokalizovaného řetězce, který popisuje stav objektu.

Když se stav objektu změní, servery by měly volat NotifyWinEvent konstantou události EVENT_OBJECT_STATECHANGE. Objekty s konstantami stavu STATE_SYSTEM_INVISIBLE, STATE_SYSTEM_FOCUSED a STATE_SYSTEM_ SELECTED mají však vlastní konstanty událostí. Pro tyto objekty nepoužívejte EVENT_OBJECT_STATECHANGE. Místo toho použijte jednotlivou konstantu události.

Následují konstanty stavu objektu:

Konstanta	Popis
STATE_SYSTEM_ALERT_HIGH 0x10000000	(Tato konstanta stavu objektu není podporována.) Označuje důležité informace, které se mají uživateli okamžitě sdělit. Když například baterie dosáhne kritické nízké úrovně, vygeneruje indikátor úrovně výstrahu vysoké úrovně. V důsledku toho nástroj pro nevidomý přístup okamžitě oznámí uživateli tyto informace a program pro zvětšení obrazovky posune obrazovku tak, aby byl indikátor baterie v zobrazení. Tento stav je také vhodný pro všechny výzvy nebo operace, které musí být dokončeny, aby uživatel mohl pokračovat.
STATE_SYSTEM_ALERT_MEDIUM 0x8000000	(Tato konstanta stavu objektu není podporována.) Označuje důležité informace, které se uživateli nesdělují okamžitě. Například když se baterie začíná dostat na nízkou úroveň, vygeneruje indikátor úrovně výstrahu střední úrovně. Nástroj pro nevidomý přístup pak vygeneruje zvuk, který uživateli dá vědět, že jsou k dispozici důležité informace, aniž by skutečně přerušil práci uživatele. Uživatel by se pak mohl dotazovat na informace výstrahy, pokud je to vhodné.
STATE_SYSTEM_ALERT_LOW 0x4000000	(Tato konstanta stavu objektu není podporována.) Označuje informace s nízkou prioritou, které nejsou pro uživatele důležité. Tento stav se používá například v případě, že Word změní vzhled tlačítka TipWizard na panelu nástrojů, aby označil, že má nápovědu pro uživatele.
STATE_SYSTEM_ANIMATED 0x4000	Vzhled objektu se rychle nebo neustále mění. Obrázky, které jsou občas animované, jsou popsány jako ROLE_SYSTEM_GRAPHIC s vlastností State nastavenou na STATE_SYSTEM_ANIMATED. Tento stav slouží k označení, že se umístění objektu mění.
STATE_SYSTEM_BUSY 0x800	Ovládací prvek v tuto chvíli nemůže přijmout vstup.
STATE_SYSTEM_CHECKED 0x10	Je zaškrtnuto políčko objektu.
STATE_SYSTEM_COLLAPSED 0x400	Podřízené objektu, které mají roli ROLE_SYSTEM_OUTLINEITEM, jsou skryté.
STATE_SYSTEM_DEFAULT 0x100	Tento stav představuje výchozí tlačítko v okně.
STATE_SYSTEM_EXPANDED 0x200	Zobrazí se podřízené objekty, které mají roli ROLE_SYSTEM_OUTLINEITEM.
STATE_SYSTEM_EXTSELECTABLE 0x2000000	Označuje, že objekt rozšiřuje svůj výběr pomocí SELFLAG_EXTENDSELECTION v IAccessible::accSelect metoda.
STATE_SYSTEM_FLOATING 0x1000	(Tato konstanta stavu objektu není podporována.) Objekt není oříznut na hranici nadřazeného objektu a při přesunutí nadřazeného objektu se nepřesune automaticky.
STATE_SYSTEM_FOCUSABLE 0x100000	Objekt je v aktivním okně a je připravený na příjem fokusu klávesnice.
STATE_SYSTEM_FOCUSED 0x4	Objekt má fokus klávesnice. Nezaměňujte fokus objektu s výběrem objektu. Další informace naleznete v tématu Výběr a Detailní vlastnosti a metody. U objektů s tímto stavem objektu odešlete EVENT_OBJECT_SHOW nebo EVENT_OBJECT_HIDE WinEvents, aby klientské aplikace informovaly o změnách stavu. Nepoužívejte EVENT_OBJECT_STATECHANGE.
STATE_SYSTEM_HASPOPUP 0x40000000	Při vyvolání objekt zobrazí místní nabídku nebo okno.
STATE_SYSTEM_HOTTRACKED 0x80	Objekt je sledován myší, což znamená, že vzhled objektu se změnil tak, aby indikoval, že ukazatel myši je umístěn nad ním.
STATE_SYSTEM_INVISIBLE 0x8000	Objekt je programově skrytý. Například itme nabídky jsou programově skryté, dokud uživatel nabídku neaktivuje. Vzhledem k tomu, že objekty s tímto stavem nejsou uživatelům k dispozici, klientské aplikace nesmí sdělit informace o objektu uživatelům. Pokud však klientské aplikace najdou objekt s tímto stavem, měli by zkontrolovat, jestli je také nastaven STATE_SYSTEM_OFFSCREEN. Pokud je tento druhý stav definovaný, můžou klienti sdělit informace o objektu uživatelům. Seznam může mít například STATE_SYSTEM_INVISIBLE i STATE_SYSTEM_OFFSCREEN sadu. V takovém případě klientská aplikace může komunikovat všechny položky v seznamu uživatelům. Pokud klientská aplikace prochází nepřístupný strom a narazí na nadřazený objekt, který je neviditelný, microsoft Active Accessibility nezpřístupní informace o žádných možných podřízených objektech nadřazeného objektu, pokud je nadřazený objekt neviditelný.
STATE_SYSTEM_LINKED 0x400000	Označuje, že objekt je formátován jako hypertextový odkaz. Role objektu bude obvykle ROLE_SYSTEM_TEXT.
STATE_SYSTEM_MARQUEED 0x2000	Označuje posouvání nebo přesouvání textu nebo grafiky.
STATE_SYSTEM_MIXED 0x20	Označuje, že stav třístavového zaškrtávacího políčka nebo tlačítka panelu nástrojů není určen. Zaškrtávací políčko není zaškrtnuté ani nezaškrtané, a proto je ve třetím nebo smíšeném stavu.
STATE_SYSTEM_MOVEABLE 0x40000	Označuje, že objekt lze přesunout. Uživatel může například kliknout na záhlaví objektu a přetáhnout objekt do nového umístění.
STATE_SYSTEM_MULTISELECTABLE 0x1000000	Označuje, že objekt přijímá více vybraných položek; to znamená, SELFLAG_ADDSELECTION pro IAccessible::accSelect metoda je platná.
STATE_SYSTEM_NORMAL 0	Označuje, že objekt nemá přiřazen jiný stav.
STATE_SYSTEM_OFFSCREEN 0x10000	Objekt je oříznutý nebo se vysouval ze zobrazení, ale není programově skrytý. Pokud uživatel zvětší oblast zobrazení, bude na obrazovce počítače vidět více objektu.
STATE_SYSTEM_PRESSED 0x8	Objekt se stiskne.
STATE_SYSTEM_PROTECTED 0x20000000	Objekt je ovládací prvek pro úpravy chráněný heslem.
STATE_SYSTEM_READONLY 0x40	Objekt je určen jen pro čtení.
STATE_SYSTEM_SELECTABLE 0x200000	Objekt přijímá výběr.
STATE_SYSTEM_SELECTED 0x2	Objekt je vybrán.
STATE_SYSTEM_SELFVOICING 0x80000	Objekt nebo podřízený objekt používá technologii převodu textu na řeč (TTS) pro účely popisu. Pokud má objekt s tímto stavem fokus, nápověda pro usnadnění přístupu na základě řeči neoznámí informace, protože objekt ji automaticky oznámí.
STATE_SYSTEM_SIZEABLE 0x20000	Velikost objektu lze změnit. Uživatel může například změnit velikost okna přetažením ohraničení.
STATE_SYSTEM_TRAVERSED 0x800000	Objekt je hypertextový odkaz, který uživatel navštívil (dříve kliknul).
STATE_SYSTEM_UNAVAILABLE 0x1	Objekt není k dispozici.

Požadavky

Požadavek	Hodnota
Záhlaví	Oleacc.h