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 |