Ruoli oggetto

In questo argomento vengono descritti i valori costanti usati per descrivere i ruoli di vari oggetti dell'interfaccia utente in un'applicazione. Le costanti del ruolo sono definite nel file Oleacc.h.

È consigliabile usare solo le costanti del ruolo elencate qui; non aggiungere ruoli o ruoli personalizzati non predefiniti.

Prima di usare questi ruoli oggetto, gli sviluppatori di applicazioni client devono usare lo strumento Inspect per verificare che i ruoli oggetto vengano usati dagli elementi dell'interfaccia utente.

Per recuperare il ruolo di un oggetto, i client chiamano il metodo IAccessible::get_accRole , che deve restituire uno dei valori descritti nella tabella. Per recuperare una stringa localizzata che descrive il ruolo dell'oggetto, i client chiamano la funzione GetRoleText con il valore del ruolo. Le stringhe localizzate per i valori del ruolo si trovano nel file oleaccrc.dll.

Costante	Descrizione
ROLE_SYSTEM_ALERT	L'oggetto rappresenta un avviso o una condizione che un utente deve ricevere una notifica. Questo ruolo viene usato solo per gli oggetti che incorporano un avviso, ma non sono associati a un altro elemento dell'interfaccia utente, ad esempio una finestra di messaggio, un elemento grafico, un testo o un suono.
ROLE_SYSTEM_ANIMATION	L'oggetto rappresenta un controllo animazione il cui contenuto cambia nel tempo, ad esempio un controllo che visualizza una serie di fotogrammi bitmap. I controlli di animazione vengono visualizzati quando i file vengono copiati o quando viene eseguita un'altra attività dispendiosa in termini di tempo.
ROLE_SYSTEM_APPLICATION	L'oggetto rappresenta una finestra principale per un'applicazione.
ROLE_SYSTEM_BORDER	L'oggetto rappresenta un bordo finestra. L'intero bordo è rappresentato da un singolo oggetto anziché da oggetti separati per ogni lato.
ROLE_SYSTEM_BUTTONDROPDOWN	L'oggetto rappresenta un pulsante che espande un elenco di elementi.
ROLE_SYSTEM_BUTTONDROPDOWNGRID	L'oggetto rappresenta un pulsante che espande una griglia.
ROLE_SYSTEM_BUTTONMENU	L'oggetto rappresenta un pulsante che espande un menu.
ROLE_SYSTEM_CARET	L'oggetto rappresenta il cursore di sistema.
ROLE_SYSTEM_CELL	L'oggetto rappresenta una cella all'interno di una tabella.
ROLE_SYSTEM_CHARACTER	L'oggetto rappresenta un oggetto grafico simile a un cartone animato, ad esempio Assistente di Microsoft Office, che viene visualizzato per fornire assistenza agli utenti di un'applicazione.
ROLE_SYSTEM_CHART	L'oggetto rappresenta un'immagine grafica utilizzata per i dati del grafico.
ROLE_SYSTEM_CHECKBUTTON	L'oggetto rappresenta un controllo casella di controllo: un'opzione selezionata o deselezionata indipendentemente da altre opzioni.
ROLE_SYSTEM_CLIENT	L'oggetto rappresenta l'area client di una finestra. Microsoft Active Accessibility usa questo ruolo come impostazione predefinita se è presente una domanda sul ruolo di un elemento dell'interfaccia utente.
ROLE_SYSTEM_CLOCK	L'oggetto rappresenta un controllo che visualizza l'ora.
ROLE_SYSTEM_COLUMN	L'oggetto rappresenta una colonna di celle all'interno di una tabella.
ROLE_SYSTEM_COLUMNHEADER	L'oggetto rappresenta un'intestazione di colonna, fornendo un'etichetta visiva per una colonna in una tabella.
ROLE_SYSTEM_COMBOBOX	L'oggetto rappresenta una casella combinata: un controllo di modifica con una casella di riepilogo associata che fornisce un set di scelte predefinite.
ROLE_SYSTEM_CURSOR	L'oggetto rappresenta il puntatore del mouse del sistema.
ROLE_SYSTEM_DIAGRAM	L'oggetto rappresenta un'immagine grafica utilizzata per i dati del diagramma.
ROLE_SYSTEM_DIAL	L'oggetto rappresenta un quadrante o una manopola.
ROLE_SYSTEM_DIALOG	L'oggetto rappresenta una finestra di dialogo o una finestra di messaggio.
ROLE_SYSTEM_DOCUMENT	L'oggetto rappresenta una finestra del documento. Una finestra del documento è sempre contenuta all'interno di una finestra dell'applicazione. Questo ruolo si applica solo alle finestre MDI e fa riferimento all'oggetto che contiene la barra del titolo MDI.
ROLE_SYSTEM_DROPLIST	L'oggetto rappresenta il controllo calendario SysDateTimePick32. Il componente runtime microsoft Active Accessibility usa questo ruolo per indicare che è stata trovata una data o un controllo calendario.
ROLE_SYSTEM_EQUATION	L'oggetto rappresenta un'equazione matematica.
ROLE_SYSTEM_GRAPHIC	L'oggetto rappresenta un'immagine.
ROLE_SYSTEM_GRIP	L'oggetto rappresenta un puntatore del mouse speciale che consente a un utente di modificare elementi dell'interfaccia utente, ad esempio finestre. Un esempio di questo comporta il ridimensionamento di una finestra trascinando l'angolo inferiore destro.
ROLE_SYSTEM_GROUPING	L'oggetto raggruppa logicamente altri oggetti. Non esiste sempre una relazione padre-figlio tra l'oggetto di raggruppamento e gli oggetti in esso contenuti.
ROLE_SYSTEM_HELPBALLOON	L'oggetto visualizza un argomento della Guida sotto forma di descrizione comando o area guida.
ROLE_SYSTEM_HOTKEYFIELD	L'oggetto rappresenta un campo di scelta rapida da tastiera che consente all'utente di immettere una combinazione o una sequenza di tasti.
ROLE_SYSTEM_INDICATOR	L'oggetto rappresenta un indicatore, ad esempio un elemento grafico puntatore, che punta all'elemento corrente.
ROLE_SYSTEM_IPADDRESS	L'oggetto rappresenta un controllo di modifica progettato per un indirizzo IP. Il controllo di modifica è suddiviso in sezioni, ognuna per una parte specifica dell'indirizzo IP.
ROLE_SYSTEM_LINK	L'oggetto rappresenta un collegamento a un altro elemento. Questo oggetto può essere costituito da una stringa di testo o da un grafico ed ha la funzione di pulsante.
ROLE_SYSTEM_LIST	L'oggetto rappresenta una casella di riepilogo, consentendo all'utente di selezionare uno o più elementi.
ROLE_SYSTEM_LISTITEM	L'oggetto rappresenta un elemento in una casella di riepilogo o nella parte di elenco di una casella combinata, una casella di riepilogo a discesa o una casella combinata a discesa.
ROLE_SYSTEM_MENUBAR	L'oggetto rappresenta la barra dei menu (posizionata sotto la barra del titolo di una finestra) da cui gli utenti selezionano i menu.
ROLE_SYSTEM_MENUITEM	L'oggetto rappresenta una voce di menu: una voce di menu che l'utente può scegliere di eseguire un comando, selezionare un'opzione o visualizzare un altro menu. Dal punto di vista funzionale, una voce di menu equivale a un pulsante di scelta rapida, a un pulsante di opzione, a una casella di controllo o a un menu.
ROLE_SYSTEM_MENUPOPUP	L'oggetto rappresenta un menu: un elenco di opzioni, ognuna con un'azione specifica. Tutti i tipi di menu devono avere un ruolo, inclusi i menu a discesa che vengono visualizzati quando selezionati da una barra dei menu; e menu di scelta rapida, visualizzati facendo clic sul pulsante destro del mouse.
ROLE_SYSTEM_OUTLINE	L'oggetto rappresenta una struttura struttura ad albero, ad esempio un controllo visualizzazione albero, che visualizza un elenco gerarchico e consente all'utente di espandere e comprimere i rami.
ROLE_SYSTEM_OUTLINEBUTTON	L'oggetto rappresenta un elemento che passa come un elemento struttura. I tasti FRECCIA SU e GIÙ vengono usati per spostarsi attraverso la struttura. Tuttavia, invece di espandere e comprimere quando viene premuto il tasto LEFT e FRECCIA DESTRA, questi menu si espandono o comprimono quando viene premuto il tasto SPACEBAR o INVIO e l'elemento ha lo stato attivo.
ROLE_SYSTEM_OUTLINEITEM	L'oggetto rappresenta un elemento in una struttura o albero.
ROLE_SYSTEM_PAGETAB	L'oggetto rappresenta una scheda di pagina. L'unico elemento figlio di un controllo scheda pagina è un oggetto ROLE_SYSTEM_GROUPING con il contenuto della pagina associata.
ROLE_SYSTEM_PAGETABLIST	L'oggetto rappresenta un contenitore di controlli scheda pagina.
ROLE_SYSTEM_PANE	L'oggetto rappresenta un riquadro all'interno di una cornice o di una finestra del documento. È possibile spostarsi tra i riquadri e all'interno del contenuto del riquadro corrente, ma non tra gli elementi di riquadri diversi. Pertanto, i riquadri rappresentano un livello di raggruppamento inferiore a fotogrammi o finestre documento, ma superiore ai singoli controlli. L'utente si sposta tra i riquadri premendo TAB, F6 o CTRL+TAB, a seconda del contesto.
ROLE_SYSTEM_PROGRESSBAR	L'oggetto rappresenta una barra di stato, che mostra in modo dinamico la quantità di un'operazione in corso. Questo controllo non accetta alcun input utente.
ROLE_SYSTEM_PROPERTYPAGE	L'oggetto rappresenta un foglio delle proprietà.
ROLE_SYSTEM_PUSHBUTTON	L'oggetto rappresenta un controllo pulsante push.
ROLE_SYSTEM_RADIOBUTTON	L'oggetto rappresenta un pulsante di opzione (in precedenza un pulsante di opzione). È uno di un gruppo di opzioni reciprocamente esclusive. Tutti gli oggetti che condividono lo stesso elemento padre e che hanno questo attributo vengono considerati parte di un singolo gruppo esclusivo a vicenda. Per dividere questi oggetti in gruppi separati, usare oggetti ROLE_SYSTEM_GROUPING.
ROLE_SYSTEM_ROW	L'oggetto rappresenta una riga di celle all'interno di una tabella.
ROLE_SYSTEM_ROWHEADER	L'oggetto rappresenta un'intestazione di riga, che fornisce un'etichetta visiva per una riga di tabella.
ROLE_SYSTEM_SCROLLBAR	L'oggetto rappresenta una barra di scorrimento verticale o orizzontale, che fa parte dell'area client o viene usata in un controllo.
ROLE_SYSTEM_SEPARATOR	L'oggetto viene usato per dividere visivamente uno spazio in due aree. Esempi di oggetti separatori includono una voce di menu separatore e una barra che divide i riquadri suddivisi all'interno di una finestra.
ROLE_SYSTEM_SLIDER	L'oggetto rappresenta un dispositivo di scorrimento che consente all'utente di modificare un'impostazione in particolare incrementi tra valori minimi e massimi.
ROLE_SYSTEM_SOUND	L'oggetto rappresenta un suono di sistema, associato a vari eventi di sistema.
ROLE_SYSTEM_SPINBUTTON	L'oggetto rappresenta una casella di rotazione, ovvero un controllo che consente all'utente di aumentare o decrerere il valore visualizzato in un controllo "buddy" separato associato alla casella di selezione.
ROLE_SYSTEM_SPLITBUTTON	L'oggetto rappresenta un pulsante su una barra degli strumenti con un'icona elenco a discesa adiacente al pulsante.
ROLE_SYSTEM_STATICTEXT	L'oggetto rappresenta testo di sola lettura, ad esempio etichette per altri controlli o istruzioni in una finestra di dialogo. Non è possibile modificare o selezionare il testo statico.
ROLE_SYSTEM_STATUSBAR	L'oggetto rappresenta una barra di stato, che è un'area nella parte inferiore di una finestra e che visualizza informazioni sull'operazione corrente, sullo stato dell'applicazione o sull'oggetto selezionato. La barra di stato include più campi, che visualizzano diversi tipi di informazioni.
ROLE_SYSTEM_TABLE	L'oggetto rappresenta una tabella che contiene righe e colonne di celle e, facoltativamente, intestazioni di riga e intestazioni di colonna.
ROLE_SYSTEM_TEXT	L'oggetto rappresenta il testo selezionabile che consente modifiche o è designato come di sola lettura.
ROLE_SYSTEM_TITLEBAR	L'oggetto rappresenta un titolo o una barra didascalia per una finestra.
ROLE_SYSTEM_TOOLBAR	L'oggetto rappresenta una barra degli strumenti, ovvero un raggruppamento di controlli che consente di accedere facilmente alle funzionalità usate di frequente.
ROLE_SYSTEM_TOOLTIP	L'oggetto rappresenta una descrizione comando che fornisce hint utili.
ROLE_SYSTEM_WHITESPACE	L'oggetto rappresenta lo spazio vuoto tra altri oggetti.
ROLE_SYSTEM_WINDOW	L'oggetto rappresenta la cornice della finestra, che contiene oggetti figlio, ad esempio una barra del titolo, un client e altri oggetti di una finestra.

Requisiti

Requisito	Valore
Intestazione	Oleacc.h