Condividi tramite

Tipo di controllo Hyperlink

  • Articolo

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

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
  • Hyperlink
  • Hyperlink

 

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.

Informazioni concettuali

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

Cenni preliminari su automazione interfaccia utente