Tipo di controllo documento
Questo argomento fornisce informazioni sul supporto di Automazione interfaccia utente Microsoft per il tipo di controllo documento.
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 documento. I requisiti di automazione interfaccia utente si applicano a tutti i controlli del documento in cui il framework o la piattaforma dell'interfaccia utente integra il supporto di Automazione interfaccia utente per i tipi di controllo e i pattern di controllo.
Questo argomento contiene le sezioni seguenti.
- struttura ad albero tipica
- proprietà rilevanti
- modelli di controllo necessari
- eventi obbligatori
- argomenti correlati
Struttura ad albero tipica
La tabella seguente illustra un controllo e una visualizzazione contenuto tipici dell'albero di 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 ui Automation Tree Overview.
| Visualizzazione controlli | Visualizzazione contenuto |
|---|---|
|
|
Proprietà pertinenti
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 Recupero delle proprietà dagli elementi di automazione interfaccia utente.
| Ui Automation, proprietà | 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 di automazione interfaccia utente. |
| UIA_BoundingRectanglePropertyId | Vedere le note. | Rettangolo più esterno che contiene l'intero controllo. |
| UIA_ClickablePointPropertyId | 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. |
| UIA_ControlTypePropertyId | documento | |
| UIA_IsContentElementPropertyId | VERO | Il controllo documento è sempre incluso nella visualizzazione contenuto dell'albero di automazione interfaccia utente. |
| UIA_IsControlElementPropertyId | VERO | Il controllo documento è sempre incluso nella visualizzazione controllo dell'albero di automazione interfaccia utente. |
| UIA_IsKeyboardFocusablePropertyId | Vedere le note. | Se il controllo può ricevere lo stato attivo della tastiera, 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 document. Il valore predefinito è "document" per en-US o inglese (Stati Uniti). |
| UIA_NamePropertyId | Vedere le note. | Il controllo documento ottiene in genere il nome dal nome file da cui viene caricato. Questo viene spesso visualizzato in un titolo di finestra o cornice contenitore. |
Modelli di controllo obbligatori
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.For more information on control patterns, see UI Automation Control Patterns Overview.
| Pattern di controllo/pattern, proprietà | Supporto/valore | Note |
|---|---|---|
| IScrollProvider | Dipende | 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 | Tutti i controlli documento devono supportare il pattern di controllo testo. |
| IValueProvider | Dipende | Anche se i client di automazione interfaccia utente possono usare IUIAutomationTextPattern per ottenere informazioni di testo su un documento, hanno bisogno del pattern di controllo Valore per impostare il valore interno. La voce di testo semplice è possibile solo tramite il pattern di controllo Value. |
Eventi obbligatori
Nella tabella seguente sono elencati gli eventi di automazione interfaccia utente necessari per supportare i controlli documento. Per altre informazioni sugli eventi, vedere Panoramica degli eventi di automazione interfaccia utente .
| Evento di automazione interfaccia utente | Note |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId evento di modifica delle proprietà. | |
| UIA_IsEnabledPropertyId evento di modifica delle proprietà. | Se il controllo supporta la proprietàIsEnabled, deve supportare questo evento. |
| UIA_IsOffscreenPropertyId evento di modifica delle proprietà. | Se il controllo supporta la proprietàIsOffscreen, deve supportare questo evento. |
| UIA_StructureChangedEventId | |
| UIA_ScrollHorizontallyScrollablePropertyId evento di modifica delle proprietà. | Se il controllo supporta il pattern di controllo Scroll, deve supportare questo evento. |
| UIA_ScrollHorizontalScrollPercentPropertyId evento di modifica delle proprietà. | Se il controllo supporta il pattern di controllo Scroll, deve supportare questo evento. |
| UIA_ScrollHorizontalViewSizePropertyId evento di modifica delle proprietà. | Se il controllo supporta il pattern di controllo Scroll, deve supportare questo evento. |
| UIA_ScrollVerticallyScrollablePropertyId evento di modifica delle proprietà. | Se il controllo supporta il pattern di controllo Scroll, deve supportare questo evento. |
| UIA_ScrollVerticalScrollPercentPropertyId evento di modifica delle proprietà. | Se il controllo supporta il pattern di controllo Scroll, deve supportare questo evento. |
| UIA_ScrollVerticalViewSizePropertyId evento di modifica delle proprietà. | Se il controllo supporta il pattern di controllo Scroll, deve supportare questo evento. |
| UIA_Selection_InvalidatedEventId | Se il controllo supporta il pattern di controllo Selection, deve supportare questo evento. |
| UIA_Text_TextSelectionChangedEventId | |
| UIA_Text_TextChangedEventId | |
| UIA_ValueValuePropertyId evento di modifica delle proprietà. | Se il controllo supporta il pattern di controllo Value, deve supportare questo evento. |
Argomenti correlati