Objectstatusconstanten

In dit onderwerp worden de constante waarden beschreven die worden gebruikt om de status van objecten in een toepassingsgebruikersinterface te beschrijven. De statusconstanten worden gedefinieerd in oleacc.h.

Een object is op elk gewenst moment gekoppeld aan een of meer van deze statuswaarden. De volgende objectstatusconstanten worden niet gebruikt: STATE_SYSTEM_ALERT_HIGH, STATE_SYSTEM_ALERT_MEDIUM, STATE_SYSTEM_ALERT_LOW en STATE_SYSTEM_FLOATING.

Clients halen de status van een object op door IAccessible aan te roepen::get_accState, wat een geheel getal retourneert dat een combinatie is van de volgende bitvlagmen. Clients roepen GetStateText- aan met de statuswaarde om een gelokaliseerde tekenreeks op te halen die de status van het object beschrijft.

Wanneer de status van een object wordt gewijzigd, moeten servers NotifyWinEvent- aanroepen met de constante EVENT_OBJECT_STATECHANGE gebeurtenis. Objecten met de STATE_SYSTEM_INVISIBLE, STATE_SYSTEM_FOCUSED en STATE_SYSTEM_ geselecteerde objectstatusconstanten hebben echter hun eigen gebeurtenisconstanten. Gebruik voor deze objecten geen EVENT_OBJECT_STATECHANGE. Gebruik in plaats daarvan de afzonderlijke gebeurtenisconstante.

Hier volgen objectstatusconstanten:

Constant	Beschrijving
STATE_SYSTEM_ALERT_HIGH 0x10000000	(Deze objectstatusconstante wordt niet ondersteund.) Geeft belangrijke informatie aan die onmiddellijk aan de gebruiker moet worden overgebracht. Wanneer een batterij bijvoorbeeld een kritiek laag niveau bereikt, genereert een niveauindicator een waarschuwing op hoog niveau. Als gevolg hiervan meldt een hulpprogramma voor blinde toegang deze informatie onmiddellijk aan de gebruiker, en een schermvergrotingsprogramma schuift het scherm zodat de batterijindicator in beeld is. Deze status is ook geschikt voor elke prompt of bewerking die moet worden voltooid voordat de gebruiker kan doorgaan.
STATE_SYSTEM_ALERT_MEDIUM 0x8000000	(Deze objectstatusconstante wordt niet ondersteund.) Geeft belangrijke informatie aan die niet onmiddellijk aan de gebruiker wordt overgebracht. Wanneer een batterij bijvoorbeeld een laag niveau bereikt, genereert een niveauindicator een waarschuwing op gemiddeld niveau. Een hulpprogramma voor blinde toegang genereert vervolgens een geluid om de gebruiker te laten weten dat belangrijke informatie beschikbaar is, zonder het werk van de gebruiker daadwerkelijk te onderbreken. De gebruiker kan vervolgens de waarschuwingsgegevens opvragen wanneer dit handig is.
STATE_SYSTEM_ALERT_LOW 0x4000000	(Deze objectstatusconstante wordt niet ondersteund.) Geeft informatie met een lage prioriteit aan die niet belangrijk is voor de gebruiker. Deze status wordt bijvoorbeeld gebruikt wanneer Word het uiterlijk van de knop TipWizard op de werkbalk wijzigt om aan te geven dat de gebruiker een hint heeft.
STATE_SYSTEM_ANIMATED 0x4000	Het uiterlijk van het object verandert snel of voortdurend. Afbeeldingen die af en toe worden geanimeerd, worden beschreven als ROLE_SYSTEM_GRAPHIC met de eigenschap State ingesteld op STATE_SYSTEM_ANIMATED. Deze status wordt gebruikt om aan te geven dat de locatie van het object wordt gewijzigd.
STATE_SYSTEM_BUSY 0x800	Het besturingselement kan momenteel geen invoer accepteren.
STATE_SYSTEM_CHECKED 0x10	Het selectievakje van het object is ingeschakeld.
STATE_SYSTEM_COLLAPSED 0x400	De onderliggende objecten met de ROLE_SYSTEM_OUTLINEITEM rol zijn verborgen.
STATE_SYSTEM_DEFAULT 0x100	Deze status vertegenwoordigt de standaardknop in een venster.
STATE_SYSTEM_EXPANDED 0x200	De onderliggende elementen van het object met de rol ROLE_SYSTEM_OUTLINEITEM worden weergegeven.
STATE_SYSTEM_EXTSELECTABLE 0x2000000	Geeft aan dat een object de selectie uitbreidt met behulp van SELFLAG_EXTENDSELECTION in de methode IAccessible::accSelect.
STATE_SYSTEM_FLOATING 0x1000	(Deze objectstatusconstante wordt niet ondersteund.) Het object wordt niet geknipt naar de grens van het bovenliggende object en wordt niet automatisch verplaatst wanneer het bovenliggende object wordt verplaatst.
STATE_SYSTEM_FOCUSABLE 0x100000	Het object bevindt zich in het actieve venster en is klaar om de toetsenbordfocus te ontvangen.
STATE_SYSTEM_FOCUSED 0x4	Het object heeft de toetsenbordfocus. Verwar objectfocus niet met objectselectie. Zie eigenschappen en methoden voor selectie en focusvoor meer informatie. Voor objecten met deze objectstatus verzendt u de EVENT_OBJECT_SHOW of EVENT_OBJECT_HIDE WinEvents om clienttoepassingen op de hoogte te stellen van statuswijzigingen. Gebruik EVENT_OBJECT_STATECHANGEniet.
STATE_SYSTEM_HASPOPUP 0x40000000	Wanneer het object wordt aangeroepen, wordt een snelmenu of een venster weergegeven.
STATE_SYSTEM_HOTTRACKED 0x80	Het object wordt dynamisch bijgehouden door de muis, wat betekent dat het uiterlijk van het object is gewijzigd om aan te geven dat de muis aanwijzer zich erboven bevindt.
STATE_SYSTEM_INVISIBLE 0x8000	Het object is programmatisch verborgen. Menu itmes zijn bijvoorbeeld programmatisch verborgen totdat een gebruiker het menu activeert. Omdat objecten met deze status niet beschikbaar zijn voor gebruikers, mogen clienttoepassingen geen informatie over het object aan gebruikers doorgeven. Als clienttoepassingen echter een object met deze status vinden, moeten ze controleren of STATE_SYSTEM_OFFSCREEN ook is ingesteld. Als deze tweede status is gedefinieerd, kunnen clients de informatie over het object doorgeven aan gebruikers. Een keuzelijst kan bijvoorbeeld zowel STATE_SYSTEM_INVISIBLE als STATE_SYSTEM_OFFSCREEN zijn ingesteld. In dit geval kan de clienttoepassing alle items in de lijst doorgeven aan gebruikers. Als een clienttoepassing door een ontoegankelijke boomstructuur navigeert en een bovenliggend object tegenkomt dat onzichtbaar is, wordt in Microsoft Active Accessibility geen informatie weergegeven over mogelijke onderliggende items van het bovenliggende item zolang het bovenliggende object onzichtbaar is.
STATE_SYSTEM_LINKED 0x400000	Geeft aan dat het object is opgemaakt als een hyperlink. De rol van het object wordt meestal ROLE_SYSTEM_TEXT.
STATE_SYSTEM_MARQUEED 0x2000	Hiermee wordt aangegeven hoe u tekst of afbeeldingen schuift of verplaatst.
STATE_SYSTEM_MIXED 0x20	Hiermee wordt aangegeven dat de status van een selectievakje met drie statussen of werkbalkknoppen niet wordt bepaald. Het selectievakje is niet ingeschakeld of uitgeschakeld en bevindt zich daarom in de derde of gemengde status.
STATE_SYSTEM_MOVEABLE 0x40000	Geeft aan dat het object kan worden verplaatst. Een gebruiker kan bijvoorbeeld op de titelbalk van het object klikken en het object naar een nieuwe locatie slepen.
STATE_SYSTEM_MULTISELECTABLE 0x1000000	Geeft aan dat het object meerdere geselecteerde items accepteert; Dat wil gezegd, SELFLAG_ADDSELECTION voor de methode IAccessible::accSelect geldig is.
STATE_SYSTEM_NORMAL 0	Geeft aan dat er geen andere status aan het object is toegewezen.
STATE_SYSTEM_OFFSCREEN 0x10000	Het object is geknipt of is niet zichtbaar, maar is niet programmatisch verborgen. Als de gebruiker de viewport groter maakt, is meer van het object zichtbaar op het computerscherm.
STATE_SYSTEM_PRESSED 0x8	Het object wordt ingedrukt.
STATE_SYSTEM_PROTECTED 0x20000000	Het object is een besturingselement voor bewerken dat met een wachtwoord is beveiligd.
STATE_SYSTEM_READONLY 0x40	Het object is aangewezen als alleen-lezen.
STATE_SYSTEM_SELECTABLE 0x200000	Het object accepteert selectie.
STATE_SYSTEM_SELECTED 0x2	Het object is geselecteerd.
STATE_SYSTEM_SELFVOICING 0x80000	Het object of onderliggend object maakt gebruik van TTS-technologie (text-to-speech) voor beschrijvingsdoeleinden. Wanneer een object met deze status de focus heeft, kondigt een op spraak gebaseerde toegankelijkheidshulp geen informatie aan omdat het object dit automatisch aankondigt.
STATE_SYSTEM_SIZEABLE 0x20000	Het formaat van het object kan worden gewijzigd. Een gebruiker kan bijvoorbeeld de grootte van een venster wijzigen door het te slepen aan de rand.
STATE_SYSTEM_TRAVERSED 0x800000	Het object is een hyperlink die is bezocht (eerder geklikt) door een gebruiker.
STATE_SYSTEM_UNAVAILABLE 0x1	Het object is niet beschikbaar.

Eisen

Eis	Waarde
Rubriek	Oleacc.h