Tipo di controllo Hyperlink
In questo argomento vengono fornite informazioni sul supporto di Microsoft Automazione interfaccia utente per il tipo di controllo Hyperlink.
I controlli collegamento ipertestuale creano collegamenti che consentono agli utenti di spostarsi all'interno della stessa pagina o da una pagina a un'altra.
Le sezioni seguenti definiscono la struttura ad albero, le proprietà, i pattern di controllo e gli eventi necessari Automazione interfaccia utente per il tipo di controllo Hyperlink. I requisiti Automazione interfaccia utente si applicano a tutti i controlli collegamento ipertestuale in cui il framework o la piattaforma dell'interfaccia utente si integra Automazione interfaccia utente supporto per i tipi di controllo e i pattern di controllo.
In questo argomento sono contenute le sezioni seguenti.
- Struttura ad albero tipica
- Proprietà pertinenti
- Pattern di controllo obbligatori
- Eventi obbligatori
- Osservazioni:
- Argomenti correlati
Struttura ad albero tipica
La tabella seguente illustra un controllo e una visualizzazione contenuto tipici dell'albero Automazione interfaccia utente che riguarda i controlli collegamento ipertestuale e descrive cosa può essere contenuto in ogni visualizzazione. Per altre informazioni sull'albero di Automazione interfaccia utente, vedere Panoramica dell'albero di Automazione interfaccia utente.
| Visualizzazione controlli | Visualizzazione contenuto |
|---|---|
|
|
Proprietà pertinenti
Nella tabella seguente sono elencate le proprietà Automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per i controlli collegamento ipertestuale. Per altre informazioni sulle proprietà di Automazione interfaccia utente, vedere Recupero di 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 in tutti i controlli di un'applicazione. |
| UIA_BoundingRectanglePropertyId | Vedere le note. | Il rettangolo più esterno che contiene l'intero controllo. |
| UIA_ClickablePointPropertyId | Vedere le note. | Il punto selezionabile del controllo collegamento ipertestuale deve essere un punto che avvia il collegamento ipertestuale se si fa clic con un puntatore del mouse. |
| UIA_ControlTypePropertyId | Collegamento ipertestuale | |
| UIA_IsContentElementPropertyId | TRUE | Il controllo collegamento ipertestuale viene sempre incluso nella visualizzazione contenuto dell'albero Automazione interfaccia utente. |
| UIA_IsControlElementPropertyId | TRUE | Il controllo collegamento ipertestuale viene sempre incluso nella visualizzazione controllo dell'albero Automazione interfaccia utente. |
| UIA_IsKeyboardFocusablePropertyId | Vedere le note. | Se il controllo può ricevere lo stato attivo, deve supportare questa proprietà. |
| UIA_LabeledByPropertyId | Vedere le note. | Se è presente un'etichetta di testo statico, questa proprietà deve esporre un riferimento a tale controllo. |
| UIA_LocalizedControlTypePropertyId | Vedere le note. | Stringa localizzata corrispondente al tipo di controllo Hyperlink . Il valore predefinito è "hyperlink" per en-US o english (Stati Uniti). |
| UIA_NamePropertyId | Vedere le note. | Il nome del controllo collegamento ipertestuale è il testo visualizzato sullo schermo come sottolineato. |
Pattern di controllo obbligatori
Nella tabella seguente sono elencati i pattern di controllo Automazione interfaccia utente necessari per supportare i controlli collegamento ipertestuale. Per altre informazioni sui pattern di controllo, vedere UI Automation Control Patterns Overview.
| Pattern di controllo/proprietà del pattern | Supporto/valore | Note |
|---|---|---|
| IInvokeProvider | Necessario | Tutti i controlli collegamento ipertestuale devono supportare il pattern di controllo Invoke . |
| IValueProvider | Dipende da | I controlli Collegamento ipertestuale devono supportare il pattern di controllo Valore quando il collegamento contiene informazioni utilizzabili e significative per l'utente. |
| Valore | Ad esempio, "https://www..." | Un URL per un indirizzo Internet o Intranet è un esempio di collegamento ipertestuale che contiene informazioni significative per l'utente. Un collegamento a livello di codice, tuttavia, è significativo solo per un'applicazione e non è consigliato per la proprietà Value . |
Eventi obbligatori
Nella tabella seguente sono elencati gli eventi Automazione interfaccia utente necessari per il supporto dei controlli collegamento ipertestuale. Per altre informazioni sugli eventi, vedere UI Automation Events Overview.
| evento Automazione interfaccia utente | Note |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId evento di modifica della proprietà. | |
| UIA_Invoke_InvokedEventId | |
| 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_StructureChangedEventId |
Commenti
Il tipo di controllo Hyperlink deve essere applicato solo a un oggetto che, quando si fa clic, fa sì che si verifichi lo spostamento; non deve essere applicato al contenitore del collegamento ipertestuale. Ad esempio, solo le aree sensibili selezionabili all'interno di una mappa immagine devono avere il tipo di controllo Hyperlink . Lo stesso vale per i collegamenti ipertestuali in un campo di testo o in un contenitore di documenti. In questo caso, solo il testo del collegamento ipertestuale o l'immagine deve avere il tipo di controllo Hyperlink , non il contenitore.
Il pattern di controllo Testo è ideale per supportare collegamenti ipertestuali incorporati in elementi di testo o documento.
Argomenti correlati
-
Informazioni concettuali
-
Cenni preliminari sui tipi di controllo per l'automazione interfaccia utente