Supporto di automazione interfaccia utente per il tipo di controllo Document

Aggiornamento: novembre 2007

In questo argomento vengono fornite informazioni sul supporto di automazione interfaccia utente per il tipo di controllo Document. In automazione interfaccia utente un tipo di controllo è un insieme di condizioni che un controllo deve soddisfare al fine di utilizzare la proprietà ControlTypeProperty. Le condizioni includono linee guida specifiche per la struttura ad albero di automazione interfaccia utente, i valori delle proprietà automazione interfaccia utente e i pattern di controllo.

I controlli documento consentono di visualizzare e modificare più pagine di testo.

Nelle sezioni seguenti vengono definiti la struttura ad albero, le proprietà, i pattern di controllo e gli eventi di automazione interfaccia utente necessari per il tipo di controllo Document. I requisiti di automazione interfaccia utente si applicano a tutti i controlli documento, sia Windows Presentation Foundation (WPF), Win32 che Windows Form.

Nel presente argomento sono contenute le seguenti sezioni.

  • Struttura ad albero di automazione interfaccia utente obbligatoria
  • Proprietà di automazione interfaccia utente obbligatorie
  • Pattern di controllo di automazione interfaccia utente obbligatori
  • Eventi di automazione interfaccia utente obbligatori
  • Argomenti correlati

Struttura ad albero di automazione interfaccia utente obbligatoria

Nella tabella riportata di seguito vengono illustrate la visualizzazione controlli e la visualizzazione contenuto della struttura ad albero di automazione interfaccia utente relativamente ai controlli documento e viene descritto il contenuto di ogni visualizzazione. Per ulteriori informazioni sulla struttura ad albero di automazione interfaccia utente, vedere Cenni preliminari sulla struttura di automazione dell'interfaccia utente.

Visualizzazione controlli

Visualizzazione contenuto

  • Document

  • Varia

  • Document

  • Varia

Proprietà di automazione interfaccia utente obbligatorie

Nella tabella seguente sono elencate le proprietà di automazione interfaccia utente il cui valore o la cui definizione è particolarmente rilevante per i controlli documento. Per ulteriori informazioni sulle proprietà di automazione interfaccia utente, vedere Proprietà di automazione interfaccia utente per i client.

Proprietà di automazione interfaccia utente

Valore

Notes

AutomationIdProperty()

Vedere le note.

Il valore di questa proprietà deve essere univoco per tutti i controlli di un'applicazione.

BoundingRectangleProperty

Vedere le note.

Il rettangolo più esterno che contiene l'intero controllo.

ClickablePointProperty

Vedere le note.

Il documento include un punto selezionabile tramite il quale il documento o uno dei relativi elementi nel contenitore di documenti riceve lo stato attivo.

ControlTypeProperty

Document

Questo valore è identico per tutti i framework dell'interfaccia utente.

IsContentElementProperty

True

Il controllo documento è sempre incluso nella visualizzazione contenuto della struttura ad albero di automazione interfaccia utente.

IsControlElementProperty

True

Il controllo documento è sempre incluso nella visualizzazione controlli della struttura ad albero di automazione interfaccia utente.

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 utilizzato il titolo del documento.

LocalizedControlTypeProperty

"documento"

Stringa localizzata che corrisponde al tipo di controllo Document.

NameProperty

Vedere le note.

Il controllo documento ottiene in genere i nomi dal nome del file dal quale è caricato, che viene spesso visualizzato in una finestra che lo contiene o nel titolo del frame.

Pattern di controllo di automazione interfaccia utente obbligatori

Nella tabella seguente sono elencati i pattern di controllo di automazione interfaccia utente che devono essere supportati dai controlli documento. Per ulteriori informazioni sui pattern di controllo, vedere Cenni preliminari sui pattern di controllo per l'automazione interfaccia utente.

Pattern di controllo/Proprietà pattern

Supporto/Valore

Notes

IScrollProvider

A seconda dei casi

Se un documento si estende in più pagine, il controllo deve implementare questo pattern di controllo. Viceversa, se un documento non si esetende su più pagine, al controllo non è richiesto il supporto di questo pattern di controllo.

ITextProvider

Required

Tutti i controlli documento devono supportare questo pattern di controllo.

IValueProvider

Mai

Il controllo documento non supporta questo pattern di controllo perché il contenuto del controllo spesso si estende su più di una pagina. I client di automazione interfaccia utente devono utilizzare TextPattern per ottenere informazioni di testo su un documento.

Eventi di automazione interfaccia utente obbligatori

Nella tabella seguente sono elencati gli eventi di automazione interfaccia utente che devono essere supportati da tutti i controlli documento. Per ulteriori informazioni sugli eventi, vedere Cenni preliminari sugli eventi di automazione interfaccia utente.

Evento di automazione interfaccia utente

Supporto

Notes

AutomationFocusChangedEvent

Required

None

Evento di proprietà modificata BoundingRectangleProperty.

Required

None

Evento di proprietà modificata IsEnabledProperty.

Required

None

Evento di proprietà modificata IsOffscreenProperty.

Required

None

StructureChangedEvent

Required

None

Evento di proprietà modificata HorizontallyScrollableProperty.

Required

None

Evento di proprietà modificata HorizontalScrollPercentProperty.

Required

None

Evento di proprietà modificata HorizontalViewSizeProperty.

Required

None

Evento di proprietà modificata VerticalScrollPercentProperty.

Required

None

Evento di proprietà modificata VerticallyScrollableProperty.

Required

None

Evento di proprietà modificata VerticalViewSizeProperty.

Required

None

InvalidatedEvent

A seconda dei casi

Se il controllo supporta il pattern di controllo Selection, deve supportare questo evento.

TextSelectionChangedEvent

Required

None

TextChangedEvent

Required

None

Evento di proprietà modificata ValueProperty.

Mai

None

Vedere anche

Concetti

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

Cenni preliminari su automazione interfaccia utente

Riferimenti

Document