Objektumállapot-állandók

Ez a témakör az alkalmazások felhasználói felületén található objektumok állapotának leírására használt állandó értékeket ismerteti. Az állapotállandók az oleacc.h fájlban vannak definiálva.

Egy objektum bármikor társítva van egy vagy több ilyen állapotértékkel. A következő objektumállapot-állandók nem használhatók: STATE_SYSTEM_ALERT_HIGH, STATE_SYSTEM_ALERT_MEDIUM, STATE_SYSTEM_ALERT_LOW és STATE_SYSTEM_FLOATING.

Az ügyfelek az IAccessible::get_accStatemeghívásával kérik le az objektum állapotát, amely egy egész számot ad vissza, amely a következő bitjelölők kombinációját adja vissza. Az ügyfelek meghívják GetStateText állapotértékkel, hogy lekérjenek egy honosított sztringet, amely leírja az objektum állapotát.

Amikor egy objektum állapota megváltozik, a kiszolgálóknak NotifyWinEvent kell hívniuk az EVENT_OBJECT_STATECHANGE eseményállandóval. A STATE_SYSTEM_INVISIBLE, STATE_SYSTEM_FOCUSED és STATE_SYSTEM_ SELECTED objektumállapot-állandókkal rendelkező objektumok azonban saját eseményállandókkal rendelkeznek. Ezekhez az objektumokhoz ne használja a EVENT_OBJECT_STATECHANGE. Ehelyett használja az egyéni eseményállandót.

Az alábbi objektumállapot-állandók:

Konstans	Leírás
STATE_SYSTEM_ALERT_HIGH 0x10000000	(Ez az objektumállapot-állandó nem támogatott.) A felhasználónak azonnal továbbítandó fontos információkat jelzi. Ha például egy akkumulátor eléri a kritikusan alacsony szintet, a szintjelző magas szintű riasztást hoz létre. Ennek eredményeképpen egy vakelérési eszköz azonnal felolvassa ezeket az információkat a felhasználónak, és egy képernyőnagyító program görgeti a képernyőt, hogy az akkumulátorjelző látható legyen. Ez az állapot minden olyan kéréshez vagy művelethez is megfelelő, amelyet a felhasználónak folytatnia kell.
STATE_SYSTEM_ALERT_MEDIUM 0x8000000	(Ez az objektumállapot-állandó nem támogatott.) Olyan fontos információkat jelez, amelyek nem kerülnek azonnal a felhasználóhoz. Ha például egy akkumulátor kezd alacsony szintre lépni, egy szintjelző közepes szintű riasztást hoz létre. A vakelérési eszköz ezután hangot hoz létre, amely tudatja a felhasználóval, hogy fontos információk állnak rendelkezésre, anélkül, hogy ténylegesen megszakítanák a felhasználó munkáját. A felhasználó ezután kényelmesen lekérdezheti a riasztási adatokat.
STATE_SYSTEM_ALERT_LOW 0x4000000	(Ez az objektumállapot-állandó nem támogatott.) Alacsony prioritású információkat jelez, amelyek nem fontosak a felhasználó számára. Ez az állapot például akkor használatos, ha a Word módosítja a TipWizard gomb megjelenését az eszköztárán, hogy jelezze, hogy a felhasználónak van egy tippje.
STATE_SYSTEM_ANIMATED 0x4000	Az objektum megjelenése gyorsan vagy folyamatosan változik. Az időnként animált ábrák ROLE_SYSTEM_GRAPHIC jelennek meg, és az Állapot tulajdonság értéke STATE_SYSTEM_ANIMATED. Ez az állapot azt jelzi, hogy az objektum helye megváltozik.
STATE_SYSTEM_BUSY 0x800	A vezérlő jelenleg nem tud bemenetet fogadni.
STATE_SYSTEM_CHECKED 0x10	Az objektum jelölőnégyzete be van jelölve.
STATE_SYSTEM_COLLAPSED 0x400	Az objektum ROLE_SYSTEM_OUTLINEITEM szerepkörű gyermekei rejtve vannak.
STATE_SYSTEM_DEFAULT 0x100	Ez az állapot az alapértelmezett gombot jelöli az ablakban.
STATE_SYSTEM_EXPANDED 0x200	Megjelenik az objektum ROLE_SYSTEM_OUTLINEITEM szerepkörű gyermekei.
STATE_SYSTEM_EXTSELECTABLE 0x2000000	Azt jelzi, hogy egy objektum kibővíti a kijelölést az IAccessible::accSelect metódus SELFLAG_EXTENDSELECTION használatával.
STATE_SYSTEM_FLOATING 0x1000	(Ez az objektumállapot-állandó nem támogatott.) A rendszer nem vágja ki az objektumot a szülőobjektum határához, és a szülő áthelyezésekor nem lép automatikusan.
STATE_SYSTEM_FOCUSABLE 0x100000	Az objektum az aktív ablakban van, és készen áll a billentyűzetfókusz fogadására.
STATE_SYSTEM_FOCUSED 0x4	Az objektum fókusza a billentyűzeten van. Ne keverje össze az objektumfókuszt az objektumkijelöléssel. További információ: Kijelölés és fókusz tulajdonságai és módszerei. Az ilyen objektumállapotú objektumok esetén küldje el a EVENT_OBJECT_SHOW vagy EVENT_OBJECT_HIDE WinEvents-t, hogy értesítse az ügyfélalkalmazásokat az állapotváltozásokról. Ne használja a EVENT_OBJECT_STATECHANGE.
STATE_SYSTEM_HASPOPUP 0x40000000	A meghíváskor az objektum megjelenít egy előugró menüt vagy egy ablakot.
STATE_SYSTEM_HOTTRACKED 0x80	Az objektumot az egér gyakran követi, ami azt jelenti, hogy az objektum megjelenése megváltozott, és azt jelzi, hogy az egérmutató rajta található.
STATE_SYSTEM_INVISIBLE 0x8000	Az objektum programozott módon rejtett. A menü itmes-jei például programozott módon el vannak rejtve, amíg egy felhasználó nem aktiválja a menüt. Mivel az ilyen állapotú objektumok nem érhetők el a felhasználók számára, az ügyfélalkalmazások nem közölhetik az objektummal kapcsolatos információkat a felhasználókkal. Ha azonban az ügyfélalkalmazások ilyen állapotú objektumot találnak, ellenőrizniük kell, hogy STATE_SYSTEM_OFFSCREEN is be van-e állítva. Ha ez a második állapot definiálva van, az ügyfelek közölhetik az objektummal kapcsolatos információkat a felhasználókkal. Egy listamezőben például STATE_SYSTEM_INVISIBLE és STATE_SYSTEM_OFFSCREEN is lehet. Ebben az esetben az ügyfélalkalmazás képes kommunikálni a listában szereplő összes elemet a felhasználókkal. Ha egy ügyfélalkalmazás egy IAccessible-fán navigál, és láthatatlan szülőobjektummal találkozik, a Microsoft Active Accessibility nem tesz közzé információt a szülő esetleges gyermekeiről, amíg a szülő láthatatlan.
STATE_SYSTEM_LINKED 0x400000	Azt jelzi, hogy az objektum hivatkozásként van formázva. Az objektum szerepköre általában ROLE_SYSTEM_TEXTlesz.
STATE_SYSTEM_MARQUEED 0x2000	Szöveg vagy grafika görgetését vagy áthelyezését jelzi.
STATE_SYSTEM_MIXED 0x20	Azt jelzi, hogy a háromállapotú jelölőnégyzet vagy eszköztárgomb állapota nincs meghatározva. A jelölőnégyzet nincs bejelölve és nincs bejelölve, ezért a harmadik vagy vegyes állapotban van.
STATE_SYSTEM_MOVEABLE 0x40000	Azt jelzi, hogy az objektum áthelyezhető. A felhasználó például rákattinthat az objektum címsorára, és áthúzhatja az objektumot egy új helyre.
STATE_SYSTEM_MULTISELECTABLE 0x1000000	Azt jelzi, hogy az objektum több kijelölt elemet is elfogad; vagyis SELFLAG_ADDSELECTION az IAccessible::accSelect metódus érvényes.
STATE_SYSTEM_NORMAL 0	Azt jelzi, hogy az objektumhoz nincs hozzárendelve másik állapot.
STATE_SYSTEM_OFFSCREEN 0x10000	Az objektum ki van vágva vagy ki van görgetve a nézetből, de programozott módon nem rejtette el. Ha a felhasználó nagyobbá teszi a nézetportot, az objektum nagyobb része látható lesz a számítógép képernyőjén.
STATE_SYSTEM_PRESSED 0x8	Az objektum be van nyomva.
STATE_SYSTEM_PROTECTED 0x20000000	Az objektum jelszóval védett szerkesztési vezérlő.
STATE_SYSTEM_READONLY 0x40	Az objektum írásvédett.
STATE_SYSTEM_SELECTABLE 0x200000	Az objektum elfogadja a kijelölést.
STATE_SYSTEM_SELECTED 0x2	Az objektum ki van jelölve.
STATE_SYSTEM_SELFVOICING 0x80000	Az objektum vagy gyermek szövegfelolvasási (TTS) technológiát használ leírási célokra. Ha egy ilyen állapotú objektum a fókuszban van, a beszédalapú akadálymentességi segéd nem jelenti be az információkat, mert az objektum automatikusan felolvassa.
STATE_SYSTEM_SIZEABLE 0x20000	Az objektum átméretezhető. Egy felhasználó például a szegély húzásával módosíthatja az ablak méretét.
STATE_SYSTEM_TRAVERSED 0x800000	Az objektum egy hivatkozás, amelyet egy felhasználó meglátogatott (korábban rákattintott).
STATE_SYSTEM_UNAVAILABLE 0x1	Az objektum nem érhető el.

Követelmények

Követelmény	Érték
Fejléc	Oleacc.h