Condividi tramite


Casella combinata (informazioni di riferimento per gli elementi dell'interfaccia utente MSAA)

Nota

In questo argomento vengono descritti gli oggetti Combo Box ai fini del riferimento agli elementi dell'interfaccia utente MSAA. La procedura per creare oggetti Combo Box in vari framework dell'interfaccia utente non è descritta qui. Vedere la documentazione di riferimento sulle API per il framework dell'interfaccia utente in uso.

 

Una casella combinata è un casella di riepilogo combinata con un controllo statico o un controllo di modifica che visualizza l'elemento attualmente selezionato nel componente casella di riepilogo della casella combinata. La parte della casella di riepilogo del controllo viene visualizzata sempre o solo quando l'utente seleziona la freccia a discesa (che è un pulsante di scelta rapida) accanto al controllo. Se il campo di selezione è un controllo di modifica, l'utente può immettere informazioni non presenti nell'elenco; in caso contrario, l'utente può selezionare solo gli elementi nell'elenco.

Il nome della classe della finestra per una casella combinata è "COMBOBOX".

Il contenuto delle proprietà IAccessible dipende da quale delle parti seguenti della casella combinata viene eseguita una query dal client:

  • Finestra della casella combinata
  • Controllo di modifica o controllo testo statico
  • Freccia a discesa (che è un pulsante di pressione)
  • Casella di riepilogo
  • Voci di elenco nella casella di riepilogo

Metodi IAccessible

Le caselle combinate supportano i metodi IAccessible seguenti:

Proprietà IAccessible

Le caselle combinate supportano le proprietà IAccessible seguenti:

  • get_accChild

  • get_accChildCount: la tabella seguente mostra il valore del conteggio figlio per diverse parti della casella combinata.

    Parte casella combinata ChildCount
    Finestra casella combinata 3
    Controllo Edit 0
    Freccia a discesa 0
    Casella di riepilogo Numero di elementi dell'elenco
    Elemento elenco 0

     

  • get_accDefaultAction: nella tabella seguente viene illustrata la proprietà DefaultAction per diverse parti di una casella combinata.

    Parte casella combinata Defaultaction
    Finestra casella combinata Nessuno
    Controllo Edit Nessuno
    Freccia a discesa "Apri" o "Chiudi" a seconda dello stato dell'elenco a discesa
    Casella di riepilogo Nessuno
    Elemento elenco "Doppio clic"

     

  • get_accDescription

  • get_accFocus

  • get_accHelp

  • get_accHelpTopic

  • get_accKeyboardShortcut: nella tabella seguente viene illustrata la proprietà KeyboardShortcut per diverse parti di una casella combinata.

    Parte casella combinata KeyboardShortcut
    Finestra casella combinata Chiave di accesso dell'etichetta associata
    Controllo Edit Nessuno
    Freccia a discesa "ALT+Freccia GIÙ"
    Casella di riepilogo Nessuno
    Elemento elenco Nessuno

     

    Il tasto di scelta per una casella combinata è il carattere sottolineato nel testo da un controllo di testo statico associato che etichetta la casella combinata. Ad esempio, in una finestra di dialogo Apri standard che apre file, ad esempio in Microsoft WordPad, la casella combinata con etichetta "File di tipo:" ha KeyboardShortcut "Alt+t".

  • get_accName: nella tabella seguente viene illustrata la proprietà Name per diverse parti di una casella combinata.

    Parte casella combinata Nome
    Finestra casella combinata Controllo testo statico usato come etichetta
    Controllo Edit Controllo testo statico usato come etichetta
    Freccia a discesa "Apri" o "Chiudi" a seconda dello stato dell'elenco a discesa
    Casella di riepilogo Etichetta associata
    Elemento elenco Testo dell'elemento dell'elenco

     

    La proprietà Name di una casella combinata, il controllo di modifica figlio e la relativa casella di riepilogo figlio è il testo di un controllo testo statico associato che etichetta la casella combinata. Ad esempio, in una finestra di dialogo Apri standard che apre i file, ad esempio in WordPad, le proprietà Name per le due caselle combinate sono "Look in:" e "Files of type:".

  • get_accParent: nella tabella seguente viene illustrato il valore padre per diverse parti di una casella combinata.

    Parte casella combinata Parent
    Finestra casella combinata Finestra con la proprietà Role di ROLE_SYSTEM_WINDOW che circonda la casella combinata e ha lo stesso nome della proprietà Name e della classe della finestra della casella combinata.
    Controllo Modifica (o controllo testo statico) Finestra della casella combinata.
    Freccia a discesa Finestra della casella combinata.
    Finestra padre casella di riepilogo Finestra della casella combinata. Questa finestra racchiude la casella di riepilogo.
    Casella di riepilogo Finestra padre della casella di riepilogo.
    Elemento elenco Casella di riepilogo.

     

  • get_accRole: nella tabella seguente viene illustrata la proprietà Role per diverse parti di una casella combinata.

    Parte casella combinata Ruolo
    Finestra casella combinata ROLE_SYSTEM_COMBOBOX
    Controllo Modifica (o controllo testo statico) ROLE_SYSTEM_TEXT o ROLE_SYSTEM_STATICTEXT
    Freccia a discesa ROLE_SYSTEM_PUSHBUTTON
    Casella di riepilogo ROLE_SYSTEM_LIST
    Elemento elenco ROLE_SYSTEM_LISTITEM

     

  • get_accState: nella tabella seguente viene illustrata la proprietà State per diverse parti di una casella combinata.

    Parte casella combinata Stati possibili
    Finestra casella combinata | STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_NORMAL | STATE_SYSTEM_EXPANDED STATE_SYSTEM_COLLAPSED
    Controllo Edit | STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE STATE_SYSTEM_NORMAL
    Freccia a discesa 0, il che significa che il pulsante è visibile e non premuto; o STATE_SYSTEM_PRESSED STATE_SYSTEM_INVISIBLE | | STATE_SYSTEM_NORMAL
    Casella di riepilogo | STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_FLOATING STATE_SYSTEM_NORMAL
    Elemento elenco | STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_SELECTABLE | STATE_SYSTEM_SELECTED STATE_SYSTEM_NORMAL

     

  • get_accValue: nella tabella seguente viene illustrata la proprietà Value per diverse parti di una casella combinata.

    Parte casella combinata Valore
    Finestra casella combinata Testo della voce di elenco attualmente selezionata
    Controllo Edit Testo della voce di elenco attualmente selezionata
    Freccia a discesa Nessuno
    Casella di riepilogo Nessuno
    Elemento elenco Nessuno

     

Note

  • Quando accNavigate viene chiamato con il flag NAVDIR_NEXT nella parte della casella di riepilogo di una casella combinata, passa erroneamente alla finestra della barra quando deve restituire VT_EMPTY.

Interfaccia IAccessible