Condividi tramite

Tipo di controllo Collegamento ipertestuale

  • Articolo

In questo argomento vengono fornite informazioni sul supporto di Automazione interfaccia utente Microsoft per il tipo di controllo collegamento ipertestuale.

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 per il collegamento ipertestuale tipo di controllo. I requisiti di automazione interfaccia utente si applicano a tutti i controlli dei collegamenti ipertestuali 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

La tabella seguente illustra un controllo tipico e una visualizzazione contenuto dell'albero di 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 ui Automation Tree Overview.

Visualizzazione controlli Visualizzazione contenuto
  • Collegamento ipertestuale
  • Collegamento ipertestuale

 

Proprietà pertinenti

Nella tabella seguente sono elencate le proprietà di 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 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 in tutti i controlli di un'applicazione.
UIA_BoundingRectanglePropertyId Vedere le note. 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 VERO Il controllo collegamento ipertestuale è sempre incluso nella visualizzazione contenuto dell'albero di automazione interfaccia utente.
UIA_IsControlElementPropertyId VERO Il controllo collegamento ipertestuale è sempre incluso nella visualizzazione controllo dell'albero di automazione interfaccia utente.
UIA_IsKeyboardFocusablePropertyId Vedere le note. Se il controllo può ricevere lo stato attivo della tastiera, deve supportare questa proprietà.
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 collegamento ipertestuale. Il valore predefinito è "hyperlink" per en-US o inglese (Stati Uniti).
UIA_NamePropertyId Vedere le note. Il nome del controllo collegamento ipertestuale è il testo visualizzato sullo schermo come sottolineato.

 

Modelli di controllo obbligatori

Nella tabella seguente sono elencati i modelli di controllo di automazione interfaccia utente necessari per supportare i controlli collegamento ipertestuale. 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
IInvokeProvider Obbligatorio Tutti i controlli collegamento ipertestuale devono supportare il pattern di controllo Invoke.
IValueProvider Dipende 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 di automazione interfaccia utente necessari per supportare i controlli collegamento ipertestuale. Per altre informazioni sugli eventi, vedere Panoramica degli eventi di automazione interfaccia utente .

Evento di automazione interfaccia utente Note
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId evento di modifica delle proprietà.
UIA_Invoke_InvokedEventId
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_StructureChangedEventId

 

Osservazioni

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 gli "hot spot" selezionabili all'interno di una mappa immagine devono avere il tipo di controllo Collegamento ipertestuale. Lo stesso vale per i collegamenti ipertestuali in un campo di testo o in un contenitore di documenti. In questo caso, solo il testo o l'immagine del collegamento ipertestuale deve avere il collegamento ipertestuale tipo di controllo, non il contenitore.

Il pattern di controllo testo è ideale per supportare collegamenti ipertestuali incorporati in elementi di testo o documento.

concettuale

panoramica dei tipi di controllo di automazione interfaccia utente

panoramica dell'automazione interfaccia utente