Tipo di controllo documento

  • Articolo

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

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
  • Documento
    • Varia
  • Documento
    • Varia

 

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.

 

Informazioni concettuali

Cenni preliminari sui tipi di controllo per l'automazione interfaccia utente

Cenni preliminari su automazione interfaccia utente