Objekttillståndskonstanter

Det här avsnittet beskriver de konstanta värden som används för att beskriva tillståndet för objekt i ett programgränssnitt. Tillståndskonstanterna definieras i oleacc.h.

Ett objekt associeras med ett eller flera av dessa tillståndsvärden när som helst. Följande objekttillståndskonstanter används inte: STATE_SYSTEM_ALERT_HIGH, STATE_SYSTEM_ALERT_MEDIUM, STATE_SYSTEM_ALERT_LOW och STATE_SYSTEM_FLOATING.

Klienter hämtar ett objekts tillstånd genom att anropa IAccessible::get_accState, som returnerar ett heltal som är en kombination av följande bitflaggor. Klienter anropar GetStateText- med tillståndsvärdet för att hämta en lokaliserad sträng som beskriver objektets tillstånd.

När tillståndet för ett objekt ändras bör servrar anropa NotifyWinEvent med EVENT_OBJECT_STATECHANGE händelsekonstant. Objekt med konstanterna STATE_SYSTEM_INVISIBLE, STATE_SYSTEM_FOCUSED och STATE_SYSTEM_ SELECTED-objekttillstånd har dock sina egna händelsekonstanter. Använd inte EVENT_OBJECT_STATECHANGEför dessa objekt. Använd i stället den enskilda händelsekonstanten.

Följande är objekttillståndskonstanter:

Konstant	Beskrivning
STATE_SYSTEM_ALERT_HIGH 0x10000000	(Den här objekttillståndskonstanten stöds inte.) Anger viktig information som omedelbart ska förmedlas till användaren. När ett batteri till exempel når en kritiskt låg nivå genererar en nivåindikator en avisering på hög nivå. Därför meddelar ett verktyg för blindåtkomst omedelbart denna information till användaren, och ett skärmförstoringsprogram rullar skärmen så att batteriindikatorn visas. Det här tillståndet är också lämpligt för alla frågor eller åtgärder som måste slutföras innan användaren kan fortsätta.
STATE_SYSTEM_ALERT_MEDIUM 0x8000000	(Den här objekttillståndskonstanten stöds inte.) Anger viktig information som inte förmedlas direkt till användaren. När ett batteri till exempel börjar nå en låg nivå genererar en nivåindikator en avisering på medelhög nivå. Ett verktyg för blindåtkomst genererar sedan ett ljud för att låta användaren veta att viktig information är tillgänglig, utan att faktiskt avbryta användarens arbete. Användaren kan sedan fråga efter aviseringsinformationen när det är praktiskt.
STATE_SYSTEM_ALERT_LOW 0x4000000	(Den här objekttillståndskonstanten stöds inte.) Anger information med låg prioritet som inte är viktig för användaren. Det här tillståndet används till exempel när Word ändrar utseendet på tipwizard-knappen i verktygsfältet för att indikera att den har ett tips för användaren.
STATE_SYSTEM_ANIMATED 0x4000	Objektets utseende ändras snabbt eller ständigt. Grafik som animerats ibland beskrivs som ROLE_SYSTEM_GRAPHIC med egenskapen State inställd på STATE_SYSTEM_ANIMATED. Det här tillståndet används för att indikera att objektets plats ändras.
STATE_SYSTEM_BUSY 0x800	Kontrollen kan inte acceptera indata just nu.
STATE_SYSTEM_CHECKED 0x10	Kryssrutan för objektet är markerad.
STATE_SYSTEM_COLLAPSED 0x400	Objektets underordnade objekt som har rollen ROLE_SYSTEM_OUTLINEITEM är dolda.
STATE_SYSTEM_DEFAULT 0x100	Det här tillståndet representerar standardknappen i ett fönster.
STATE_SYSTEM_EXPANDED 0x200	Objektets underordnade objekt som har rollen ROLE_SYSTEM_OUTLINEITEM visas.
STATE_SYSTEM_EXTSELECTABLE 0x2000000	Anger att ett objekt utökar markeringen med hjälp av SELFLAG_EXTENDSELECTION i metoden IAccessible::accSelect.
STATE_SYSTEM_FLOATING 0x1000	(Den här objekttillståndskonstanten stöds inte.) Objektet klipps inte till gränsen för det överordnade objektet och flyttas inte automatiskt när det överordnade objektet flyttas.
STATE_SYSTEM_FOCUSABLE 0x100000	Objektet är i det aktiva fönstret och är redo att ta emot tangentbordsfokus.
STATE_SYSTEM_FOCUSED 0x4	Objektet har tangentbordsfokus. Blanda inte ihop objektfokus med objektmarkering. Mer information finns i markerings- och fokusegenskaper och -metoder. För objekt med det här objekttillståndet skickar du EVENT_OBJECT_SHOW eller EVENT_OBJECT_HIDE WinEvents för att meddela klientprogram om tillståndsändringar. Använd inte EVENT_OBJECT_STATECHANGE.
STATE_SYSTEM_HASPOPUP 0x40000000	När det anropas visar objektet en popup-meny eller ett fönster.
STATE_SYSTEM_HOTTRACKED 0x80	Objektet spåras av musen, vilket innebär att objektets utseende har ändrats för att indikera att muspekaren finns över det.
STATE_SYSTEM_INVISIBLE 0x8000	Objektet är programmatiskt dolt. Till exempel döljs meny-itmes programmatiskt tills en användare aktiverar menyn. Eftersom objekt med det här tillståndet inte är tillgängliga för användare får klientprogram inte kommunicera information om objektet till användare. Men om klientprogram hittar ett objekt med det här tillståndet bör de kontrollera om STATE_SYSTEM_OFFSCREEN också har angetts. Om det andra tillståndet har definierats kan klienterna kommunicera informationen om objektet till användarna. En listruta kan till exempel ha både STATE_SYSTEM_INVISIBLE och STATE_SYSTEM_OFFSCREEN angivna. I det här fallet kan klientprogrammet kommunicera alla objekt i listan till användare. Om ett klientprogram navigerar genom ett IAccessible- träd och stöter på ett överordnat objekt som är osynligt, exponerar Microsoft Active Accessibility inte information om eventuella underordnade objekt till den överordnade så länge den överordnade filen är osynlig.
STATE_SYSTEM_LINKED 0x400000	Anger att objektet är formaterat som en hyperlänk. Objektets roll är vanligtvis ROLE_SYSTEM_TEXT.
STATE_SYSTEM_MARQUEED 0x2000	Anger rullning eller flytt av text eller grafik.
STATE_SYSTEM_MIXED 0x20	Anger att tillståndet för en kryssruta eller verktygsfältsknapp med tre tillstånd inte har fastställts. Kryssrutan är varken markerad eller avmarkerad och är därför i det tredje eller blandade tillstånd.
STATE_SYSTEM_MOVEABLE 0x40000	Anger att objektet kan flyttas. En användare kan till exempel klicka på objektets namnlist och dra objektet till en ny plats.
STATE_SYSTEM_MULTISELECTABLE 0x1000000	Anger att objektet accepterar flera markerade objekt. det vill: SELFLAG_ADDSELECTION för metoden IAccessible::accSelect är giltig.
STATE_SYSTEM_NORMAL 0	Anger att objektet inte har tilldelats något annat tillstånd.
STATE_SYSTEM_OFFSCREEN 0x10000	Objektet är klippt eller har rullats ur vyn, men det är inte programmatiskt dolt. Om användaren gör visningsporten större visas mer av objektet på datorskärmen.
STATE_SYSTEM_PRESSED 0x8	Objektet trycks in.
STATE_SYSTEM_PROTECTED 0x20000000	Objektet är en lösenordsskyddad redigeringskontroll.
STATE_SYSTEM_READONLY 0x40	Objektet är skrivskyddat.
STATE_SYSTEM_SELECTABLE 0x200000	Objektet accepterar markeringen.
STATE_SYSTEM_SELECTED 0x2	Objektet är markerat.
STATE_SYSTEM_SELFVOICING 0x80000	Objektet eller det underordnade objektet använder text-till-tal-teknik (TTS) i beskrivningssyfte. När ett objekt med det här tillståndet har fokus meddelar inte ett talbaserat hjälpmedel information eftersom objektet automatiskt meddelar det.
STATE_SYSTEM_SIZEABLE 0x20000	Objektet kan ändras. En användare kan till exempel ändra storleken på ett fönster genom att dra det efter kantlinjen.
STATE_SYSTEM_TRAVERSED 0x800000	Objektet är en hyperlänk som har besökts (tidigare klickat) av en användare.
STATE_SYSTEM_UNAVAILABLE 0x1	Objektet är inte tillgängligt.

Krav

Krav	Värde
Rubrik	Oleacc.h