Condividi tramite

Supporto dell'automazione dell'interfaccia utente per il controllo di tipo Collegamento ipertestuale

Annotazioni

Questa documentazione è destinata agli sviluppatori .NET Framework che vogliono usare le classi di automazione interfaccia utente gestite definite nello spazio dei nomi System.Windows.Automation. Per le informazioni più recenti sull'automazione interfaccia utente, vedere API di automazione di Windows: Automazione interfaccia utente.

Questo argomento fornisce informazioni sul supporto dell'Automazione interfaccia utente per il tipo di controllo Collegamento ipertestuale. In Automazione interfaccia utente un tipo di controllo è un set di condizioni che un controllo deve soddisfare per usare la ControlTypeProperty proprietà . Le condizioni includono linee guida specifiche per la struttura ad albero di automazione interfaccia utente, i valori delle proprietà di automazione interfaccia utente e i pattern di controllo.

I controlli collegamento ipertestuale consentono a un utente di spostarsi all'interno di una pagina, da una pagina a un'altra e di aprire finestre.

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 Hyperlink. I requisiti di automazione interfaccia utente si applicano a tutti i controlli dei collegamenti ipertestuali, ovvero Windows Presentation Foundation (WPF), Win32 o Windows Form.

Struttura ad albero necessaria per l'automazione UI

La tabella seguente illustra la visualizzazione di controllo e la visualizzazione del contenuto dell'albero di Automazione UI che riguarda i controlli di collegamento ipertestuale e descrive cosa può essere contenuto in ciascuna visualizzazione. Per altre informazioni sull'albero di automazione interfaccia utente, vedere ui Automation Tree Overview.

Vista di controllo Visualizzazione contenuto
Collegamento ipertestuale Collegamento ipertestuale

Proprietà di automazione interfaccia utente necessarie

La tabella seguente elenca le proprietà di Automazione dell'interfaccia utente il cui valore o la cui definizione è particolarmente rilevante per il tipo di controllo Collegamento ipertestuale. Per altre informazioni sulle proprietà di automazione interfaccia utente, vedere Proprietà di automazione interfaccia utente per i client.

Ui Automation, proprietà Valore Note
AutomationIdProperty Vedere le note. Il valore di questa proprietà deve essere univoco in tutti i controlli di un'applicazione.
BoundingRectangleProperty Vedere le note. Rettangolo più esterno che contiene l'intero controllo.
ClickablePointProperty Vedere le note. Supportato se è presente un rettangolo di delimitazione. Se non tutti i punti all'interno del rettangolo di delimitazione sono selezionabili e si eseguono hit testing specializzati, eseguire l'override e fornire un punto selezionabile.
IsKeyboardFocusableProperty Vedere le note. Se il controllo può ricevere lo stato attivo della tastiera, deve supportare questa proprietà.
NameProperty Vedere le note. Il nome del controllo collegamento ipertestuale è il testo visualizzato sullo schermo come sottolineato.
ClickablePointProperty 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.
LabeledByProperty Vedere le note. Se è presente un'etichetta di testo statica, questa proprietà deve esporre un riferimento a tale controllo.
ControlTypeProperty Collegamento ipertestuale Questo valore è lo stesso per tutti i framework dell'interfaccia utente.
LocalizedControlTypeProperty "collegamento ipertestuale" Stringa localizzata corrispondente al tipo di controllo Hyperlink.
IsContentElementProperty Vero Il controllo collegamento ipertestuale è sempre incluso nella visualizzazione contenuto dell'albero di automazione interfaccia utente.
IsControlElementProperty Vero Il controllo collegamento ipertestuale è sempre incluso nella visualizzazione controllo dell'albero di automazione interfaccia utente.

Schemi di controllo e proprietà necessari per l'automazione interfaccia utente

La tabella seguente elenca i modelli di controllo di automazione interfaccia utente necessari per essere supportati da tutti 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/proprietà del pattern Supporto/valore Note
IInvokeProvider Sì Tutti i controlli collegamento ipertestuale devono supportare il modello Invoke.
IValueProvider Dipende da I controlli di collegamento ipertestuale devono supportare il modello di controllo Valore quando il collegamento contiene informazioni utilizzabili e significative per l'utente.
Value 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 di automazione interfaccia utente necessari

La tabella seguente elenca gli eventi di automazione interfaccia utente necessari per essere supportati da tutti i controlli collegamento ipertestuale. Per altre informazioni sugli eventi, vedere Panoramica degli eventi di automazione interfaccia utente .

Evento di automazione interfaccia utente Assistenza Note
InvokedEvent Obbligatorio Nessuno
Evento di cambiamento della proprietà BoundingRectangleProperty. Obbligatorio Nessuno
Evento di cambiamento della proprietà IsOffscreenProperty. Obbligatorio Nessuno
Evento di cambiamento della proprietà IsEnabledProperty. Obbligatorio Nessuno
AutomationFocusChangedEvent Obbligatorio Nessuno
StructureChangedEvent Obbligatorio Nessuno

Vedere anche