Tipo di controllo SemanticZoom
Questo argomento fornisce informazioni sul supporto dell'automazione interfaccia utente per il tipo di controllo SemanticZoom.
Lo zoom semantico è una tecnica introdotta in Windows 8 per presentare ed 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à di basso livello (o ingrandita in) visualizza gli elementi in una struttura "all-up" piatta; e la modalità di alto livello (o ingrandita) visualizza gli elementi in gruppi, consentendo all'utente di spostarsi e esplorare rapidamente il contenuto. Ad esempio, lo zoom di un elenco di città potrebbe cambiare in un elenco di stati contenenti tali città. Lo zoom di un elenco di programmi potrebbe passare a un elenco di gruppi di programmi logici.
Per altre informazioni su Zoom semantico in modo specifico come usato per le app di Windows Store, vedi linee guida per zoom semantico.
Il modello di utilizzo per il tipo di controllo SemanticZoom è insolito perché esiste principalmente per l'accesso a livello di codice. I client di automazione interfaccia utente Microsoft possono monitorare e modificare il controllo Zoom semantico per controllare lo stato ingrandita dell'elenco. Gli utenti che non usano la tecnologia di assistive technology in genere modificano il controllo Zoom semantico direttamente tramite movimenti di tocco o tasti di scelta rapida.
Le sezioni seguenti definiscono la struttura ad albero di automazione interfaccia utente, le proprietà, i pattern 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 o la piattaforma dell'interfaccia utente integra il supporto di Automazione interfaccia utente per i tipi di controllo e i pattern di controllo.
Questo argomento contiene le sezioni seguenti.
- struttura ad albero tipica
- proprietà rilevanti
- proprietà e modelli di controllo necessari
- eventi obbligatori
- osservazioni
- argomenti correlati
Struttura ad albero tipica
La tabella seguente illustra un controllo e una visualizzazione contenuto tipici dell'albero di automazione interfaccia utente relativo al tipo di controllo SemanticZoom e descrive cosa può essere contenuto in ogni visualizzazione. Per altre informazioni sull'albero di automazione interfaccia utente, vedere ui Automation Tree Overview.
| Visualizzazione controlli | Visualizzazione contenuto |
|---|---|
|
|
O:
| Visualizzazione controlli | Visualizzazione contenuto |
|---|---|
|
|
Proprietà pertinenti
Nella tabella seguente sono elencate le proprietà di 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à di automazione interfaccia utente, vedere Recupero delle proprietà dagli elementi di automazione interfaccia utente.
| Ui Automation, proprietà | 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 di automazione interfaccia utente. |
| UIA_BoundingRectanglePropertyId | Vedere le note. | Rettangolo più esterno che contiene l'intero controllo. |
| UIA_ClickablePointPropertyId | Vedere le note. | Se il controllo elenco dispone di un punto selezionabile (un punto su cui è possibile fare clic per fare in modo che l'elenco prenda lo stato attivo), tale punto deve essere esposto tramite questa proprietà. Se il valore della proprietà UIA_IsOffscreenPropertyId è TRUE, il tentativo di recuperare questa proprietà genera l'errore UIA_E_NOCLICKABLEPOINT. |
| UIA_ControlTypePropertyId | SemanticZoom | |
| UIA_IsContentElementPropertyId | VERO | |
| UIA_IsControlElementPropertyId | VERO | |
| UIA_IsKeyboardFocusablePropertyId | FALSO | |
| 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 concatenati come "semanticzoom". |
| UIA_NamePropertyId | Vedere le note. | Una stringa vuota è accettabile o è possibile specificare un nome più utile, purché non contenga lo zoom semantico del termine , che renderebbe la combinazione di tipo di controllo e nome confusa. |
Schemi di controllo e proprietà obbligatori
La tabella seguente elenca i pattern di controllo di 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.For more information on control patterns, see UI Automation Control Patterns Overview.
| Pattern di controllo/pattern, proprietà | Supporto/valore | Note |
|---|---|---|
| IToggleProvider | Dipende | I controlli Zoom semantico supportano l'interruttore pattern di controllo per consentire l'abilitazione o la disabilitazione dello zoom. ToggleState_Off corrisponde allo stato flat, all-up e ToggleState_On corrisponde alla visualizzazione con zoom indietro di alto livello. |
Eventi obbligatori
La tabella seguente elenca gli eventi di automazione interfaccia utente necessari per supportare i controlli Zoom semantico. Per altre informazioni sugli eventi, vedere Panoramica degli eventi di automazione interfaccia utente .
| Evento di automazione interfaccia utente | Note |
|---|---|
| UIA_BoundingRectanglePropertyId evento di modifica delle proprietà. | |
| UIA_IsEnabledPropertyId evento di modifica delle proprietà. | Se il controllo supporta la proprietàIsEnabled, deve supportare questo evento. |
| UIA_IsOffscreenPropertyId evento di modifica delle proprietà. | Se il controllo supporta la proprietàIsOffscreen, deve supportare questo evento. |
| UIA_ToggleToggleStatePropertyId evento di modifica delle proprietà. |
Osservazioni
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 semantico SemanticZoom. Questo comportamento è anti-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 Pulsante con il pattern di controllo Attiva/Disattiva.