Costanti dello stato dell'oggetto

In questo argomento vengono descritti i valori costanti usati per descrivere lo stato degli oggetti in un'interfaccia utente dell'applicazione. Le costanti di stato sono definite in oleacc.h.

Un oggetto è associato a uno o più di questi valori di stato in qualsiasi momento. Le costanti di stato dell'oggetto seguenti non vengono utilizzate: STATE_SYSTEM_ALERT_HIGH, STATE_SYSTEM_ALERT_MEDIUM, STATE_SYSTEM_ALERT_LOW e STATE_SYSTEM_FLOATING.

I client recuperano lo stato di un oggetto chiamando IAccessible::get_accState, che restituisce un numero intero che rappresenta una combinazione dei flag di bit seguenti. I client chiamano GetStateText con il valore di stato per recuperare una stringa localizzata che descrive lo stato dell'oggetto.

Quando lo stato di un oggetto cambia, i server devono chiamare NotifyWinEvent con la costante dell'evento EVENT_OBJECT_STATECHANGE . Tuttavia, gli oggetti con le costanti STATE_SYSTEM_INVISIBLE, STATE_SYSTEM_FOCUSED e STATE_SYSTEM_ state dell'oggetto SELECTED hanno costanti di evento personalizzate. Per questi oggetti, non usare EVENT_OBJECT_STATECHANGE. Usare invece la costante dell'evento singolo.

Di seguito sono riportate le costanti dello stato dell'oggetto:

Costante	Descrizione
STATE_SYSTEM_ALERT_HIGH	Questa costante dello stato dell'oggetto non è supportata. Indica informazioni importanti da trasmettere immediatamente all'utente. Ad esempio, quando una batteria raggiunge un livello critico basso, un indicatore di livello genera un avviso di alto livello. Di conseguenza, uno strumento di accesso cieco annuncia immediatamente queste informazioni all'utente e un programma di ingrandimento dello schermo scorre lo schermo in modo che l'indicatore della batteria sia visualizzato. Questo stato è appropriato anche per i messaggi di richiesta o le operazioni che devono essere completate prima di proseguire.
STATE_SYSTEM_ALERT_MEDIUM	Questa costante dello stato dell'oggetto non è supportata. Indica informazioni importanti che non vengono trasmesse immediatamente all'utente. Ad esempio, quando una batteria inizia a raggiungere un livello basso, un indicatore di livello genera un avviso di livello medio. Uno strumento di accesso cieco genera quindi un suono per informare l'utente che le informazioni importanti sono disponibili, senza interrompere effettivamente il lavoro dell'utente. L'utente potrebbe quindi eseguire una query sulle informazioni sull'avviso quando è utile.
STATE_SYSTEM_ALERT_LOW	Questa costante dello stato dell'oggetto non è supportata. Indica informazioni con priorità bassa che non sono importanti per l'utente. Questo stato viene usato, ad esempio, quando Word modifica l'aspetto del pulsante TipWizard sulla barra degli strumenti per indicare che ha un hint per l'utente.
STATE_SYSTEM_ANIMATED	L'aspetto dell'oggetto cambia rapidamente o costantemente. Gli elementi grafici animati occasionalmente vengono descritti come ROLE_SYSTEM_GRAPHIC con la proprietà State impostata su STATE_SYSTEM_ANIMATED. Questo stato viene utilizzato per indicare che la posizione dell'oggetto cambia.
STATE_SYSTEM_BUSY	Il controllo non può accettare l'input in questo momento.
STATE_SYSTEM_CHECKED	La casella di controllo dell'oggetto è selezionata.
STATE_SYSTEM_COLLAPSED	Gli elementi figlio dell'oggetto con il ruolo ROLE_SYSTEM_OUTLINEITEM sono nascosti.
STATE_SYSTEM_DEFAULT	Questo stato rappresenta il pulsante predefinito in una finestra.
STATE_SYSTEM_EXPANDED	Vengono visualizzati gli elementi figlio dell'oggetto con il ruolo ROLE_SYSTEM_OUTLINEITEM .
STATE_SYSTEM_EXTSELECTABLE	Indica che un oggetto estende la selezione utilizzando SELFLAG_EXTENDSELECTION nel metodo IAccessible::accSelect.
STATE_SYSTEM_FLOATING	Questa costante dello stato dell'oggetto non è supportata. L'oggetto non viene ritagliato al limite dell'oggetto padre e non viene spostato automaticamente quando l'elemento padre viene spostato.
STATE_SYSTEM_FOCUSABLE	L'oggetto si trova nella finestra attiva ed è pronto per ricevere lo stato attivo della tastiera.
STATE_SYSTEM_FOCUSED	L'oggetto ha lo stato attivo della tastiera. Non confondere lo stato attivo dell'oggetto con la selezione dell'oggetto. Per altre informazioni, vedere Proprietà e metodi di selezione e messa a fuoco. Per gli oggetti con questo stato dell'oggetto, inviare il EVENT_OBJECT_SHOW o EVENT_OBJECT_HIDE WinEvents per notificare alle applicazioni client le modifiche dello stato. Non usare EVENT_OBJECT_STATECHANGE.
STATE_SYSTEM_HASPOPUP	Quando viene richiamato, l'oggetto visualizza un menu a comparsa o una finestra.
STATE_SYSTEM_HOTTRACKED	L'oggetto viene rilevato a caldo dal mouse, il che significa che l'aspetto dell'oggetto è cambiato per indicare che il puntatore del mouse si trova su di esso.
STATE_SYSTEM_INVISIBLE	L'oggetto è nascosto a livello di codice. Ad esempio, i menu vengono nascosti a livello di codice fino a quando un utente non attiva il menu. Poiché gli oggetti con questo stato non sono disponibili per gli utenti, le applicazioni client non devono comunicare informazioni sull'oggetto agli utenti. Tuttavia, se le applicazioni client trovano un oggetto con questo stato, devono verificare se è impostato anche STATE_SYSTEM_OFFSCREEN. Se questo secondo stato è definito, i client possono comunicare le informazioni sull'oggetto agli utenti. Ad esempio, una casella di riepilogo può avere sia STATE_SYSTEM_INVISIBLE che STATE_SYSTEM_OFFSCREEN impostato. In questo caso, l'applicazione client può comunicare tutti gli elementi dell'elenco agli utenti. Se un'applicazione client passa attraverso un albero IAccessible e rileva un oggetto padre invisibile, Microsoft Active Accessibility non espone informazioni su eventuali elementi figlio dell'elemento padre purché l'elemento padre sia invisibile.
STATE_SYSTEM_LINKED	Indica che l'oggetto è formattato come collegamento ipertestuale. Il ruolo dell'oggetto sarà in genere ROLE_SYSTEM_TEXT.
STATE_SYSTEM_MARQUEED	Indica lo scorrimento o lo spostamento di testo o grafica.
STATE_SYSTEM_MIXED	Indica che lo stato di una casella di controllo o di un pulsante della barra degli strumenti a tre stati non è determinato. La casella di controllo non è selezionata né deselezionata ed è quindi nello stato terzo o misto .
STATE_SYSTEM_MOVEABLE	Indica che l'oggetto può essere spostato. Ad esempio, un utente può fare clic sulla barra del titolo dell'oggetto e trascinare l'oggetto in una nuova posizione.
STATE_SYSTEM_MULTISELECTABLE	Indica che l'oggetto accetta più elementi selezionati; vale a dire, SELFLAG_ADDSELECTION per il metodo IAccessible::accSelect è valido.
STATE_SYSTEM_NORMAL	Indica che all'oggetto non è assegnato un altro stato.
STATE_SYSTEM_OFFSCREEN	L'oggetto viene ritagliato o ha eseguito lo scorrimento all'esterno della visualizzazione, ma non è nascosto a livello di codice. Se l'utente rende il riquadro di visualizzazione più grande, più dell'oggetto sarà visibile sullo schermo del computer.
STATE_SYSTEM_PRESSED	L'oggetto viene premuto.
STATE_SYSTEM_PROTECTED	L'oggetto è un controllo di modifica protetto da password.
STATE_SYSTEM_READONLY	L'oggetto è designato in sola lettura.
STATE_SYSTEM_SELECTABLE	L'oggetto accetta la selezione.
STATE_SYSTEM_SELECTED	L'oggetto è selezionato.
STATE_SYSTEM_SELFVOICING	L'oggetto o l'elemento figlio usa la tecnologia di sintesi vocale (TTS) a scopo di descrizione. Quando un oggetto con questo stato ha lo stato attivo, un aiuto di accessibilità basato sul riconoscimento vocale non annuncia le informazioni perché l'oggetto lo annuncia automaticamente.
STATE_SYSTEM_SIZEABLE	L'oggetto può essere ridimensionato. Ad esempio, un utente può modificare le dimensioni di una finestra trascinandolo in base al bordo.
STATE_SYSTEM_TRAVERSED	L'oggetto è un collegamento ipertestuale visitato (precedentemente selezionato) da un utente.
STATE_SYSTEM_UNAVAILABLE	L'oggetto non è disponibile.

Requisiti

Requisito	Valore
Intestazione	Oleacc.h