Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
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.
In questo argomento vengono fornite informazioni sul supporto dell'Automazione dell'interfaccia utente per il tipo di controllo "Documento". 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 documento consentono a un utente di visualizzare e modificare più pagine di testo. A differenza dei controlli di modifica che supportano solo una semplice riga di testo non formattato, i controlli documento possono ospitare testo con stili avanzati e formattati.
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 Document. I requisiti di automazione interfaccia utente si applicano a tutti i controlli del documento, 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 nell'albero di automazione dell'interfaccia utente relativa ai controlli documento e descrive ciò che 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 |
|---|---|
| Documento -Varia |
Documento -Varia |
Proprietà di automazione interfaccia utente necessarie
Nella tabella seguente sono elencate le proprietà di automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per i controlli documento. 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. | Il documento dispone di un punto selezionabile che causerà lo stato attivo del documento di uno dei relativi elementi nel contenitore di documenti. |
| ControlTypeProperty | Documento | Questo valore è lo stesso per tutti i framework dell'interfaccia utente. |
| IsContentElementProperty | Vero | Il controllo documento è sempre incluso nella visualizzazione contenuto dell'albero di automazione interfaccia utente. |
| IsControlElementProperty | Vero | Il controllo documento è sempre incluso nella visualizzazione controllo dell'albero di automazione interfaccia utente. |
| IsKeyboardFocusableProperty | Vedere le note. | Se il controllo può ricevere lo stato attivo della tastiera, 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 | "documento" | Stringa localizzata corrispondente al tipo di controllo del documento. |
| NameProperty | Vedere le note. | Il controllo documento ottiene in genere i relativi nomi dal nome file da cui viene caricato. Questo viene spesso visualizzato in un titolo di finestra o cornice contenitore. |
Modelli di controllo di automazione interfaccia utente necessari
La tabella seguente elenca i pattern di controllo di automazione interfaccia utente necessari per essere supportati dai controlli documento. Per altre informazioni sui pattern di controllo, vedere UI Automation Control Patterns Overview.
| Pattern di controllo | Assistenza | Note |
|---|---|---|
| IScrollProvider | Dipende da | Il controllo documento può estendersi su un intervallo maggiore di quello del riquadro di visualizzazione. Il controllo deve supportare il pattern di controllo Scroll se il contenuto è scorrevole. |
| ITextProvider | Obbligatorio | Il controllo documento può estendersi su un intervallo maggiore di quello del riquadro di visualizzazione. Il controllo deve supportare il pattern di controllo Scroll se il contenuto è scorrevole. |
| IValueProvider | Mai | Il controllo documento non supporta questo pattern di controllo perché il contenuto del controllo si estende spesso su più di una pagina. I client di automazione interfaccia utente devono usare TextPattern per ottenere informazioni di testo su un documento. |
Eventi di automazione interfaccia utente necessari
La tabella seguente elenca gli eventi di automazione interfaccia utente necessari per essere supportati da tutti i controlli documento. Per ulteriori informazioni sugli eventi, vedere UI Automation Events Overview.
| Evento di automazione interfaccia utente | Assistenza | Note |
|---|---|---|
| AutomationFocusChangedEvent | Obbligatorio | Nessuno |
| Evento di cambiamento della proprietà BoundingRectangleProperty. | Obbligatorio | Nessuno |
| Evento di cambiamento della proprietà IsEnabledProperty. | Obbligatorio | Nessuno |
| Evento di cambiamento della proprietà IsOffscreenProperty. | Obbligatorio | Nessuno |
| StructureChangedEvent | Obbligatorio | Nessuno |
| Evento di cambiamento della proprietà HorizontallyScrollableProperty. | Obbligatorio | Nessuno |
| Evento di cambiamento della proprietà HorizontalScrollPercentProperty. | Obbligatorio | Nessuno |
| Evento di cambiamento della proprietà HorizontalViewSizeProperty. | Obbligatorio | Nessuno |
| Evento di cambiamento della proprietà VerticalScrollPercentProperty. | Obbligatorio | Nessuno |
| Evento di cambiamento della proprietà VerticallyScrollableProperty. | Obbligatorio | Nessuno |
| Evento di cambiamento della proprietà VerticalViewSizeProperty. | Obbligatorio | Nessuno |
| InvalidatedEvent | Dipende da | Se il controllo supporta il pattern di controllo Selection, deve supportare questo evento. |
| TextSelectionChangedEvent | Obbligatorio | Nessuno |
| TextChangedEvent | Obbligatorio | Nessuno |
| Evento di cambiamento della proprietà ValueProperty. | Mai | Nessuno |