Tipo di controllo SemanticZoom

  • Articolo

Questo argomento fornisce informazioni sul supporto di Automazione interfaccia utente per il tipo di controllo SemanticZoom.

Zoom semantico è una tecnica introdotta in Windows 8 per presentare e esplorare grandi set di dati o contenuti correlati all'interno di una singola visualizzazione, ad esempio un album fotografico, un elenco di app o una rubrica. Zoom semantico usa due modalità distinte di classificazione o livelli di zoom, per organizzare e presentare il contenuto. La modalità a basso livello (o ingrandita) visualizza gli elementi in una struttura "all-up" piatta; e la modalità ad alto livello (o ingrandita) visualizza gli elementi nei gruppi, consentendo all'utente di spostarsi rapidamente e esplorare il contenuto. Ad esempio, lo zoom su un elenco di città potrebbe cambiare in un elenco di stati contenenti tali città. Lo zoom su un elenco di programmi potrebbe cambiare in un elenco di gruppi di programmi logici.

Per altre informazioni su Zoom semantico in modo specifico come usato per le app di Windows Store, vedere Linee guida per Zoom semantico.

Il modello di utilizzo per il tipo di controllo SemanticZoom è insolito in quanto esiste principalmente per l'accesso a livello di codice. I client microsoft Automazione interfaccia utente possono monitorare e modificare il controllo Zoom semantico per controllare lo stato ingrandita dell'elenco. Gli utenti che non usano la tecnologia assistive modificano in genere il controllo Zoom semantico direttamente tramite movimenti di tocco o tasti di scelta rapida.

Le sezioni seguenti definiscono la struttura ad albero Automazione interfaccia utente, le proprietà, i modelli di controllo e gli eventi necessari per il tipo di controllo SemanticZoom. I requisiti di Automazione interfaccia utente si applicano a tutti i controlli Zoom semantico in cui il framework dell'interfaccia utente/piattaforma integra Automazione interfaccia utente supporto per i tipi di controllo e i modelli di controllo.

In questo argomento sono contenute le sezioni seguenti.

Struttura ad albero tipica

La tabella seguente illustra una visualizzazione tipica del controllo e del contenuto dell'albero Automazione interfaccia utente che riguarda il tipo di controllo SemanticZoom e descrive cosa può essere contenuto in ogni visualizzazione. Per altre informazioni sull'albero Automazione interfaccia utente, vedere Panoramica dell'albero Automazione interfaccia utente.

Visualizzazione controlli Visualizzazione contenuto
  • Elenco
    • [SemanticZoom]
      • ListItem (0 o più)
  • Elenco
    • ListItem (0 o più)

Oppure:

Visualizzazione controlli Visualizzazione contenuto
  • [SemanticZoom]
    • Elenco
      • ListItem (0 o più)
  • Elenco
    • ListItem (0 o più)

Proprietà pertinenti

Nella tabella seguente sono elencate le proprietà Automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per i controlli che implementano il tipo di controllo SemanticZoom. Per altre informazioni sulle proprietà Automazione interfaccia utente, vedere Recupero delle proprietà da elementi Automazione interfaccia utente.

Proprietà di automazione interfaccia utente Valore Note
UIA_AutomationIdPropertyId Vedere le note. Il valore di questa proprietà deve essere univoco tra tutti gli elementi peer nella visualizzazione non elaborata dell'albero Automazione interfaccia utente.
UIA_BoundingRectanglePropertyId Vedere le note. Il rettangolo più esterno che contiene l'intero controllo.
UIA_ClickablePointPropertyId Vedere le note. Se il controllo elenco ha un punto selezionabile (un punto che può essere fatto clic per causare l'attivazione dello stato attivo dell'elenco), tale punto deve essere esposto tramite questa proprietà. Se il valore della proprietà UIA_IsOffscreenPropertyId è TRUE, tentare di recuperare questa proprietà genera l'errore di UIA_E_NOCLICKABLEPOINT .
UIA_ControlTypePropertyId SemanticZoom
UIA_IsContentElementPropertyId true
UIA_IsControlElementPropertyId true
UIA_IsKeyboardFocusablePropertyId FALSE
UIA_LabeledByPropertyId Vedere le note. Se è presente un'etichetta di testo statica, questa proprietà deve esporre un riferimento a tale controllo.
UIA_LocalizedControlTypePropertyId Vedere le note. Stringa localizzata corrispondente al tipo di controllo SemanticZoom . Il valore predefinito è "zoom semantico" per en-US o inglese (Stati Uniti). Nota: Alcuni framework concatenarono questo come "semanticzoom".
UIA_NamePropertyId Vedere le note. Una stringa vuota è accettabile o un nome più utile può essere fornito, purché non contenga lo zoom semantico termine , che renderebbe la combinazione di tipo di controllo e nome confusa.

Modelli di controllo e proprietà richiesti

La tabella seguente elenca i modelli di controllo Automazione interfaccia utente necessari per essere supportati da tutti i controlli Zoom semantico. Per altre informazioni sui pattern di controllo, vedere UI Automation Control Patterns Overview.

Pattern di controllo/proprietà del pattern Supporto/valore Note
IToggleProvider Dipende da I controlli Zoom semantico supportano il modello di controllo Disattiva per consentire l'abilitazione o la disattivazione dello zoom. ToggleState_Off corrisponde allo stato flat, all-up e ToggleState_On corrisponde alla visualizzazione con zoom indietro di alto livello.

Eventi obbligatori

Nella tabella seguente sono elencati gli eventi Automazione interfaccia utente necessari per il supporto dei controlli Zoom semantico. Per altre informazioni sugli eventi, vedere UI Automation Events Overview.

evento Automazione interfaccia utente Note
UIA_BoundingRectanglePropertyId evento di modifica della proprietà.
UIA_IsEnabledPropertyId evento di modifica della proprietà. Se il controllo supporta la proprietà IsEnabled , deve supportare questo evento.
UIA_IsOffscreenPropertyId evento di modifica della proprietà. Se il controllo supporta la proprietà IsOffscreen , deve supportare questo evento.
UIA_ToggleToggleStatePropertyId evento di modifica della proprietà.

Commenti

Se un'interfaccia utente ha un pulsante visibile per attivare o disattivare il comportamento del controllo Zoom semantico, questo pulsante non deve avere un tipo di controllo SemanticZoom . Questo comportamento è contro-intuitivo, ma il tipo di controllo SemanticZoom caratterizza il contenitore del contenuto di zoom, non un pulsante che controlla lo zoom. Un pulsante di questo tipo può essere rappresentato semplicemente come tipo di controllo Button con il pattern di controllo Attiva/Disattiva .

Cenni preliminari sui tipi di controllo per l'automazione interfaccia utente

Cenni preliminari su automazione interfaccia utente