Attributi di testo di automazione interfaccia utente
Questo argomento descrive in che modo Automazione interfaccia utente Microsoft espone le proprietà di formato e stile (attributi di testo) di contenuto testuale e fornisce un elenco di attributi di testo supportati.
I provider di automazione interfaccia utente espongono attributi di testo tramite i metodiGetAttributeValuee FindAttribute del pattern di controllo TextRange. Le applicazioni client usano il metodo IUIAutomationTextRange::GetAttributeValue per recuperare il valore di un attributo di testo specifico per un intervallo di testo. I client possono usare il metodo IUIAutomationTextRange::FindAttribute per cercare un intervallo di testo per il testo con un attributo specifico. Se viene trovato testo corrispondente, il metodo crea un nuovo intervallo di testo contenente il testo corrispondente.
Gli attributi di testo nell'elenco seguente sono supportati dal pattern di controllo TextRange. I nomi degli attributi sono derivati dagli identificatori dell'attributo di testo di Automazione interfaccia utente. Ad esempio, l'attributo AnimationStyle viene identificato dai client come UIA_AnimationStyleAttributeId (definiti in Uiautomationclient.h) e dai provider come Text_AnimationStyle_Attribute_GUID (definiti in Uiautomationcoreapi.h). Per altre informazioni su ogni attributo di testo supportato, vedere identificatori di attributo di testo.
Nota
Alcuni degli attributi elencati sono supportati a partire da Windows 8. Vedere identificatori di attributo di testo per le note relative al supporto della versione.
Questo argomento contiene le sezioni seguenti:
- attributi di annotazione
- attributi dei tipi di carattere
- attributi del linguaggio
- collegamento attributo
- attributi del margine di pagina
- attributi di allineamento del testo
- attributi colore testo
- attributi di decorazione del testo
- attributi di stile testo
- attributi di interazione e selezione
- argomenti correlati
Attributi di annotazione
Gli oggetti annotazione e i tipi di annotazione sono disponibili tramite gli attributi seguenti.
| Attributo | Identificatore |
|---|---|
| AnnotationObjects | UIA_AnnotationObjectsAttributeId |
| AnnotationTypes | UIA_AnnotationTypesAttributeId |
Attributi carattere
Il nome, le dimensioni e lo spessore di un tipo di carattere sono disponibili tramite gli attributi seguenti.
| Attributo | Identificatore |
|---|---|
| FontName | UIA_FontNameAttributeId |
| FontSize | UIA_FontSizeAttributeId |
| FontWeight | UIA_FontWeightAttributeId |
Attributi del linguaggio
Le informazioni sulla lingua del testo sono disponibili tramite gli attributi seguenti.
| Attributo | Identificatore |
|---|---|
| impostazioni cultura di | UIA_CultureAttributeId |
| TextFlowDirections | UIA_TextFlowDirectionsAttributeId |
Attributo collegamento
L'attributo seguente fornisce l'intervallo di testo che rappresenta la destinazione di un collegamento in un documento.
| Attributo | Identificatore |
|---|---|
| collegamento | UIA_LinkAttributeId |
Attributi margine pagina
I rettangoli di delimitazione di un intervallo di testo non espongono le coordinate del testo nella pagina. Tuttavia, un provider può esporre le informazioni sul margine di pagina usando gli attributi di testo seguenti.
| Attributo | Identificatore |
|---|---|
| MarginBottom | UIA_MarginBottomAttributeId |
| MarginLeading | UIA_MarginLeadingAttributeId |
| MarginTop | UIA_MarginTopAttributeId |
| MarginTrailing | UIA_MarginTrailingAttributeId |
Attributi di allineamento del testo
Le informazioni sull'allineamento del testo, ad esempio il rientro, le impostazioni di tabulazione e l'allineamento orizzontale, sono disponibili tramite gli attributi seguenti.
| Attributo | Identificatore |
|---|---|
| horizontalTextAlignment | UIA_HorizontalTextAlignmentAttributeId |
| rientroFirstLine | UIA_IndentationFirstLineAttributeId |
| IndentationLeading | UIA_IndentationLeadingAttributeId |
| IndentationTrailing | UIA_IndentationTrailingAttributeId |
| schede | UIA_TabsAttributeId |
Attributi colore testo
I colori del testo in primo piano e di sfondo sono disponibili tramite gli attributi di testo seguenti. Entrambi i colori vengono specificati come tipo di datiCOLORREF.
| Attributo | Identificatore |
|---|---|
| BackgroundColor | UIA_BackgroundColorAttributeId |
| ForegroundColor | UIA_ForegroundColorAttributeId |
Attributi di decorazione del testo
Le decorazioni di testo includono aree come punti elenco, sottolineatura e animazioni. Se il testo include punti elenco o numeri iniziali, il simbolo o il testo utilizzato per il punto elenco o il numero devono essere inclusi nel flusso di testo, se applicabile.
Le informazioni sulle decorazioni di testo sono disponibili tramite gli attributi seguenti.
| Attributo | Identificatore |
|---|---|
| AnimationStyle | UIA_AnimationStyleAttributeId |
| BulletStyle | UIA_BulletStyleAttributeId |
| OutlineStyles | UIA_OutlineStylesAttributeId |
| OverlineColor | UIA_OverlineColorAttributeId |
| OverlineStyle | UIA_OverlineStyleAttributeId |
| StrikethroughColor | UIA_StrikethroughColorAttributeId |
| StrikethroughStyle | UIA_StrikethroughStyleAttributeId |
| UnderlineColor | UIA_UnderlineColorAttributeId |
| UnderlineStyle | UIA_UnderlineStyleAttributeId |
Attributi stile testo
Le informazioni sugli stili di testo sono disponibili anche se gli attributi seguenti.
| Attributo | Identificatore |
|---|---|
| CapStyle | UIA_CapStyleAttributeId |
| IsHidden | UIA_IsHiddenAttributeId |
| IsItalic | UIA_IsItalicAttributeId |
| IsReadOnly | UIA_IsReadOnlyAttributeId |
| IsSuperscript | UIA_IsSuperscriptAttributeId |
| IsSubscript | UIA_IsSubscriptAttributeId |
Attributi di interazione e selezione
Le informazioni sulla selezione del testo corrente nell'intervallo e sullo stato attivo sono disponibili anche se gli attributi seguenti.
| Attributo | Identificatore |
|---|---|
| IsActive | UIA_IsActiveAttributeId |
| SelectionActiveEnd | UIA_SelectionActiveEndAttributeId |
| caretPosition | UIA_CaretPositionAttributeId |
| CaretBidiMode | UIA_CaretBidiModeAttributeId |
Argomenti correlati
-
concettuale
-
Informazioni sui modelli di controllo Text e TextRange dell'automazione interfaccia utente