Condividi tramite


Supporto di automazione interfaccia utente per il tipo di controllo Document

Nota

Questa documentazione è destinata agli sviluppatori .NET Framework che desiderano utilizzare le classi di UI Automation gestite definite nello spazio dei nomi System.Windows.Automation. Per informazioni aggiornate su UI Automation, vedere API di automazione di Windows: UI Automation.

In questo argomento vengono fornite informazioni sul supporto di UI Automation per il tipo di controllo Documento. In UI Automation, un tipo di controllo è un insieme di condizioni che un controllo deve soddisfare per poter utilizzare la proprietà ControlTypeProperty. Le condizioni includono linee guida specifiche per la struttura ad albero di UI Automation, i valori delle proprietà di UI Automation e i criteri di controllo.

I controlli Document consentono a un utente di visualizzare e modificare più pagine di testo. Diversamente dai controlli di modifica che supportano solo una semplice riga di testo non formattato, i controlli documento possono ospitare un testo con formattazione e stili avanzati.

Le seguenti sezioni definiscono la struttura ad albero, le proprietà, i criteri di controllo e gli eventi di UI Automation necessari per il tipo di controllo Documento. I requisiti di UI Automation si applicano a tutti i controlli documento, ovvero Windows Presentation Foundation (WPF), Win32 o Windows Forms.

Struttura ad albero di automazione interfaccia utente obbligatoria

La tabella seguente illustra la visualizzazione controllo e la visualizzazione contenuto dell'albero di UI Automation che riguarda i controlli documento e descrive cosa può essere contenuto in ogni visualizzazione. Per maggiori informazioni sull'albero di UI Automation, vedere Panoramica dell’albero di UI Automation.

Visualizzazione controlli Visualizzazione contenuto
Documento

- Variabile
Documento

- Variabile

Proprietà di automazione interfaccia utente obbligatorie

La seguente tabella elenca le proprietà di UI Automation il cui valore o definizione è particolarmente rilevante per i controlli documento. Per maggiori informazioni sulle proprietà di UI Automation, vedere Proprietà di UI Automation per i client.

Proprietà di automazione interfaccia utente Valore Note
AutomationIdProperty Vedere le note. Il valore di questa proprietà deve essere univoco in tutti i controlli in un'applicazione.
BoundingRectangleProperty Vedere le note. Il rettangolo più esterno che contiene l'intero controllo.
ClickablePointProperty Vedere le note. Il documento ha un punto selezionabile che farà passare lo stato attivo sul documento o su uno degli elementi nel documento contenitore.
ControlTypeProperty Documento Questo valore è uguale per tutti i framework dell'interfaccia utente.
IsContentElementProperty Vero Il controllo documento è sempre incluso nella vista contenuto dell'albero di UI Automation.
IsControlElementProperty Vero Il controllo documento è sempre incluso nella vista controllo dell'albero di UI Automation.
IsKeyboardFocusableProperty Vedere le note. Se il controllo può ricevere lo stato attivo, deve supportare questa proprietà.
LabeledByProperty Vedere le note. Il valore di questa proprietà deve essere l'etichetta del controllo documento. In genere, viene usato il titolo del documento.
LocalizedControlTypeProperty "document" Stringa localizzata corrispondente al tipo di controllo Document.
NameProperty Vedere le note. Il controllo documento in genere ottiene i nomi dal nome file da cui viene caricato. Viene spesso visualizzato nel titolo di una finestra o di un frame contenitore.

Pattern di controllo obbligatori per l'automazione interfaccia utente

La seguente tabella elenca i criteri di controllo di UI Automation che devono essere supportati dai controlli documento. Per altre informazioni sui pattern di controllo, vedere UI Automation Control Patterns Overview.

Pattern di controllo Supporto tecnico Note
IScrollProvider Dipende da Il controllo documento può estendersi oltre il riquadro di visualizzazione. Il controllo deve supportare il pattern di controllo Scroll se il contenuto è scorribile.
ITextProvider Richiesto Il controllo documento può estendersi oltre il riquadro di visualizzazione. Il controllo deve supportare il pattern di controllo Scroll se il contenuto è scorribile.
IValueProvider Mai Il controllo documento non supporta questo pattern di controllo perché i contenuti del controllo spesso si estendono per più di una pagina. I client di automazione interfaccia utente devono usare TextPattern per ottenere le informazioni testuali su un documento.

Eventi di automazione interfaccia utente obbligatori

La seguente tabella elenca gli eventi di UI Automation che devono essere supportati da tutti i controlli documento. Per altre informazioni sugli eventi, vedere UI Automation Events Overview.

Evento di UI Automation Supporto tecnico Note
AutomationFocusChangedEvent Richiesto None
Evento di modifica della proprietàBoundingRectangleProperty . Richiesto None
Evento di modifica della proprietàIsEnabledProperty . Richiesto None
Evento di modifica della proprietàIsOffscreenProperty . Richiesto None
StructureChangedEvent Richiesto None
Evento di modifica della proprietàHorizontallyScrollableProperty . Richiesto None
Evento di modifica della proprietàHorizontalScrollPercentProperty . Richiesto None
Evento di modifica della proprietàHorizontalViewSizeProperty . Richiesto None
Evento di modifica della proprietàVerticalScrollPercentProperty . Richiesto None
Evento di modifica della proprietàVerticallyScrollableProperty . Richiesto None
Evento di modifica della proprietàVerticalViewSizeProperty . Richiesto None
InvalidatedEvent Dipende da Se il controllo supporta il pattern di controllo Selection, deve supportare questo evento.
TextSelectionChangedEvent Richiesto None
TextChangedEvent Richiesto None
Evento di modifica della proprietàValueProperty . Mai None

Vedi anche