Tipo di controllo documento
In questo argomento vengono fornite informazioni sul supporto di Microsoft Automazione interfaccia utente per il tipo di controllo Documento.
I controlli Document 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 Automazione interfaccia utente, le proprietà, i pattern di controllo e gli eventi necessari per il tipo di controllo Document. I requisiti Automazione interfaccia utente si applicano a tutti i controlli documento in cui il framework o la piattaforma dell'interfaccia utente si integra Automazione interfaccia utente supporto per i tipi di controllo e i pattern di controllo.
In questo argomento sono contenute le sezioni seguenti.
- Struttura ad albero tipica
- Proprietà pertinenti
- Pattern di controllo obbligatori
- Eventi obbligatori
- Argomenti correlati
Struttura ad albero tipica
La tabella seguente illustra un controllo e una visualizzazione contenuto tipici dell'albero Automazione interfaccia utente che riguarda i controlli documento e descrive cosa può essere contenuto in ogni visualizzazione. Per altre informazioni sull'albero di Automazione interfaccia utente, vedere Panoramica dell'albero di Automazione interfaccia utente.
| Visualizzazione controlli | Visualizzazione contenuto |
|---|---|
|
|
Proprietà pertinenti
Nella tabella seguente sono elencate le proprietà Automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per i controlli documento. Per altre informazioni sulle proprietà di Automazione interfaccia utente, vedere Recupero di proprietà da elementi Automazione interfaccia utente.
| Proprietà di automazione interfaccia utente | Valore | Note |
|---|---|---|
| UIA_AutomationIdPropertyId | Vedere le note. | Il valore di questa proprietà deve essere univoco tra tutti gli elementi peer nella visualizzazione non elaborata dell'albero Automazione interfaccia utente. |
| UIA_BoundingRectanglePropertyId | Vedere le note. | Il rettangolo più esterno che contiene l'intero controllo. |
| UIA_ClickablePointPropertyId | 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. |
| UIA_ControlTypePropertyId | Documento | |
| UIA_IsContentElementPropertyId | TRUE | Il controllo documento viene sempre incluso nella visualizzazione contenuto dell'albero Automazione interfaccia utente. |
| UIA_IsControlElementPropertyId | TRUE | Il controllo documento viene sempre incluso nella visualizzazione controllo dell'albero Automazione interfaccia utente. |
| UIA_IsKeyboardFocusablePropertyId | Vedere le note. | Se il controllo può ricevere lo stato attivo, deve supportare questa proprietà. |
| UIA_LabeledByPropertyId | Vedere le note. | Il valore di questa proprietà deve essere l'etichetta del controllo documento. In genere, viene usato il titolo del documento. |
| UIA_LocalizedControlTypePropertyId | Vedere le note. | Stringa localizzata corrispondente al tipo di controllo Documento . Il valore predefinito è "document" per en-US o english (Stati Uniti). |
| UIA_NamePropertyId | Vedere le note. | Il controllo documento ottiene in genere il nome dal nome del file da cui viene caricato. Viene spesso visualizzato nel titolo di una finestra o di un frame contenitore. |
Pattern di controllo obbligatori
Nella tabella seguente sono elencati i pattern di controllo 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/proprietà del pattern | Supporto/valore | 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 è scorrevole. |
| ITextProvider | Necessario | Tutti i controlli documento devono supportare il pattern di controllo Text . |
| IValueProvider | Dipende da | Anche se Automazione interfaccia utente client possono usare IUIAutomationTextPattern per ottenere informazioni di testo su un documento, è necessario il pattern di controllo Value per impostare il valore interno. La voce di testo semplice è possibile solo tramite il pattern di controllo Valore. |
Eventi obbligatori
Nella tabella seguente sono elencati gli eventi Automazione interfaccia utente necessari per il supporto dei controlli documento. Per altre informazioni sugli eventi, vedere UI Automation Events Overview.
| evento Automazione interfaccia utente | Note |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId evento modificato dalla proprietà. | |
| UIA_IsEnabledPropertyId evento modificato dalla proprietà. | Se il controllo supporta la proprietà IsEnabled , deve supportare questo evento. |
| UIA_IsOffscreenPropertyId evento modificato dalla proprietà. | Se il controllo supporta la proprietà IsOffscreen , deve supportare questo evento. |
| UIA_StructureChangedEventId | |
| UIA_ScrollHorizontallyScrollablePropertyId evento modificato dalla proprietà. | Se il controllo supporta il modello di controllo Scroll , deve supportare questo evento. |
| UIA_ScrollHorizontalScrollPercentPropertyId evento modificato dalla proprietà. | Se il controllo supporta il modello di controllo Scroll , deve supportare questo evento. |
| UIA_ScrollHorizontalViewSizePropertyId evento modificato dalla proprietà. | Se il controllo supporta il modello di controllo Scroll , deve supportare questo evento. |
| UIA_ScrollVerticallyScrollablePropertyId evento modificato dalla proprietà. | Se il controllo supporta il modello di controllo Scroll , deve supportare questo evento. |
| UIA_ScrollVerticalScrollPercentPropertyId evento modificato dalla proprietà. | Se il controllo supporta il modello di controllo Scroll , deve supportare questo evento. |
| UIA_ScrollVerticalViewSizePropertyId evento modificato dalla proprietà. | Se il controllo supporta il modello di controllo Scroll , deve supportare questo evento. |
| UIA_Selection_InvalidatedEventId | Se il controllo supporta il modello di controllo Selection , deve supportare questo evento. |
| UIA_Text_TextSelectionChangedEventId | |
| UIA_Text_TextChangedEventId | |
| UIA_ValueValuePropertyId evento modificato dalla proprietà. | Se il controllo supporta il modello di controllo Value , deve supportare questo evento. |
Argomenti correlati
-
Informazioni concettuali
-
Cenni preliminari sui tipi di controllo per l'automazione interfaccia utente