Supporto per l'automazione interfaccia utente del tipo di controllo TitleBar
Nota
Questa documentazione è destinata agli sviluppatori .NET Framework che desiderano utilizzare le classi gestite di Automazione interfaccia utente definite nello spazio dei nomi System.Windows.Automation. Per informazioni aggiornate su Automazione interfaccia utente, vedere API di automazione di Windows: Automazione interfaccia utente.
Questo argomento fornisce informazioni sul supporto per Automazione interfaccia utente per il tipo di controllo TitleBar. In Automazione interfaccia utente, un tipo di controllo è un insieme di condizioni che un controllo deve soddisfare per poter utilizzare la proprietà ControlTypeProperty. 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 criteri di controllo.
I controlli barra del titolo rappresentano titoli o barre del titolo in una finestra.
Le seguenti sezioni definiscono la struttura ad albero, le proprietà, i criteri di controllo e gli eventi di Automazione interfaccia utente previsti per il tipo di controllo TitleBar. I requisiti di Automazione interfaccia utente si applicano a tutti i controlli barra del titolo, siano essi Windows Presentation Foundation (WPF), Win32 o Windows Form.
Struttura ad albero di automazione interfaccia utente obbligatoria
La tabella seguente mostra la vista controllo e la vista contenuto dell'albero di Automazione interfaccia utente che riguarda i controlli barra del titolo e descrive cosa può essere contenuto in ogni vista. Per maggiori informazioni sull'albero di Automazione interfaccia utente, vedere Panoramica dell'albero di Automazione interfaccia utente.
| Visualizzazione controlli | Visualizzazione contenuto |
|---|---|
| TitleBar - Menu (0 o 1) - Pulsante (0 o più) |
Non applicabile. (il controllo barra del titolo non include contenuto) |
Proprietà di automazione interfaccia utente obbligatorie
La seguente tabella elenca le proprietà di Automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per i controlli TitleBar. Per maggiori informazioni sulle proprietà di Automazione interfaccia utente, vedere Proprietà di Automazione interfaccia utente per i client.
| Proprietà di automazione interfaccia utente | Valore | Note |
|---|---|---|
| AutomationIdProperty | Vedere le note. | Il valore di questa proprietà deve essere univoco in tutti i controlli in un'applicazione. |
| BoundingRectangleProperty | Vedere le note. | Il rettangolo di delimitazione di una barra del titolo deve includere tutti i controlli in esso contenuti. |
| ClickablePointProperty | Vedere le note. | Supportata se è presente un rettangolo di delimitazione. Se non tutti i punti all'interno del rettangolo di delimitazione sono selezionabili ed è stato eseguito un processo di hit testing specializzato, eseguire l'override e implementare un punto selezionabile. |
| IsKeyboardFocusableProperty | Falso | Le barre del titolo hanno mai lo stato attivo. |
| NameProperty | "" | La barra del titolo non è un contenuto. Le relative informazioni testuali vengono esposte nella finestra padre. |
| LabeledByProperty | Vedere le note. | Il controllo barra del titolo in genere non dispone di un'etichetta. |
| ControlTypeProperty | TitleBar | Questo valore è uguale per tutti i framework dell'interfaccia utente. |
| LocalizedControlTypeProperty | "title bar" | Stringa localizzata corrispondente al tipo di controllo TitleBar. |
| IsContentElementProperty | Falso | Il controllo barra del titolo non è mai un contenuto. |
| IsControlElementProperty | Vero | Il controllo barra del titolo deve essere sempre un controllo. |
| IsOffscreenProperty | Dipende da | Questo controllo restituirà un valore a seconda che la barra del titolo sia visibile sullo schermo. |
| HelpTextProperty | "" | Non è necessario esporre il testo della Guida. |
| AcceleratorKeyProperty | "" | Le barre del titolo hanno mai tasti di scelta rapida. |
| AccessKeyProperty | "" | Il controllo barra del titolo non dispone di un tasto di scelta. |
Pattern di controllo obbligatori per l'automazione interfaccia utente
Il tipo di controllo TitleBar non deve supportare qualsiasi pattern di controllo. La relativa funzionalità viene esposta tramite il pattern di controllo Window nel controllo Window.
Eventi di automazione interfaccia utente obbligatori
La seguente tabella elenca gli eventi di Automazione interfaccia utente che devono essere supportati da tutti i controlli barra del titolo. Per altre informazioni sugli eventi, vedere UI Automation Events Overview.
| Evento di Automazione interfaccia utente | Supporto tecnico | Note |
|---|---|---|
| Evento di modifica della proprietàBoundingRectangleProperty . | Richiesto | None |
| Evento di modifica della proprietàIsOffscreenProperty . | Richiesto | None |
| Evento di modifica della proprietàIsEnabledProperty . | Mai | None |
| AutomationFocusChangedEvent | Mai | None |
| StructureChangedEvent | Richiesto | None |