Condividi tramite

Barra del titolo (informazioni di riferimento per gli elementi dell'interfaccia utente MSAA)

Nota

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

La barra del titolo nella parte superiore di una finestra visualizza un'icona definita dall'applicazione e una riga di testo. Il testo specifica il nome dell'applicazione e indica lo scopo della finestra. La barra del titolo consente inoltre all'utente di spostare la finestra usando un mouse o un altro dispositivo di puntamento.

Le barre del titolo contengono almeno tre piccoli pulsanti che riducono a icona, ingrandiscino o ripristinano e chiudono la finestra associata alla barra del titolo. Le barre del titolo contengono anche un pulsante Della Guida sensibile al contesto. Le applicazioni in esecuzione nella versione Far-East del sistema operativo Windows possono contenere anche pulsanti IME (Input Method Editor). Microsoft Active Accessibility espone questi pulsanti come elementi figlio della barra del titolo.

Metodi IAccessible

Le barre del titolo supportano i metodi IAccessible seguenti:

Proprietà IAccessible

Le barre del titolo supportano le proprietà IAccessible seguenti:

Proprietà Commenti
get_accChildCount La proprietà ChildCount è cinque. La proprietà ChildCount include i pulsanti IME e guida sensibile al contesto anche quando non vengono visualizzati. I pulsanti non visualizzati hanno la proprietà StateSTATE_SYSTEM_INVISIBLE.
get_accDescription La proprietà Description della barra del titolo è: "Visualizza il nome della finestra e contiene i controlli per modificarla". I pulsanti figlio nella barra del titolo hanno le descrizioni seguenti:
  • "Sposta la finestra all'esterno di
  • "Rende piena la finestra
  • "Inserisce un valore ridotto a icona o
  • "Chiude la finestra"
  • "Entra o lascia contesto-
  • "Visualizza la tastiera quando viene premuta"
get_accName La barra del titolo non supporta la proprietà Name . I pulsanti figlio nella barra del titolo hanno i nomi seguenti:
  • "Riduci a icona"
  • "Ingrandisci" o "Ripristina",
  • "Chiudi"
  • "Guida al contesto"
  • "IME"
get_accParent La proprietà Parent della barra del titolo è la finestra principale dell'applicazione ( ROLE_SYSTEM_WINDOW ) con lo stesso nome della classe finestra definita dall'applicazione della barra del titolo.
get_accRole La proprietà Role è ROLE_SYSTEM_TITLEBAR. I pulsanti figlio nella barra del titolo hanno la proprietà RoleROLE_SYSTEM_PUSHBUTTON.
get_accState La proprietà State per la barra del titolo e i pulsanti figlio possono essere una combinazione di uno o più dei valori seguenti: STATE_SYSTEM_FOCUSABLE
STATE_SYSTEM_INVISIBLE
STATE_SYSTEM_OFFSCREEN
STATE_SYSTEM_UNAVAILABLE
STATE_SYSTEM_PRESSED
get_accValue La proprietà Value è una stringa uguale al testo visualizzato nella barra del titolo.

Note

  • Anche se la barra del titolo di un'applicazione ha il flag della proprietà StateSTATE_SYSTEM_FOCUSABLE, non ha mai il flag StateSTATE_SYSTEM_FOCUSED. L'impostazione dello stato attivo su un oggetto barra del titolo è incentrata sulla finestra dell'applicazione.
  • Poiché l'oggetto barra del titolo non supporta get_accChild, i pulsanti sulla barra del titolo sono elementi semplici. Non supportano l'interfaccia IAccessible stessa. L'oggetto barra del titolo fornisce informazioni su questi pulsanti figlio.
  • Poiché le barre del titolo non ottengono lo stato attivo e non hanno alcuna azione predefinita, i metodi accDoDefaultAction e get_accDefaultAction non sono supportati per questo controllo.

Interfaccia IAccessible