attributi di testo Automazione interfaccia utente
Questo argomento descrive come Microsoft Automazione interfaccia utente espone le proprietà di formato e stile (attributi di testo) del contenuto testuale e fornisce un elenco di attributi di testo supportati.
Automazione interfaccia utente provider espongono attributi di testo tramite i metodi GetAttributeValue e FindAttribute del modello 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 un testo corrispondente, il metodo crea un nuovo intervallo di testo contenente il testo corrispondente.
Gli attributi di testo nell'elenco seguente sono supportati dal modello di controllo TextRange . I nomi degli attributi sono derivati dai Automazione interfaccia utente identificatori di attributo di testo. Ad esempio, l'attributo AnimationStyle viene identificato dai client come UIA_AnimationStyleAttributeId (definito in Uiautomationclient.h) e dai provider come Text_AnimationStyle_Attribute_GUID (definito 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. Per le note relative al supporto della versione, vedere Identificatori di attributo di testo .
In questo argomento sono incluse le sezioni seguenti:
- Attributi di annotazione
- Attributi dei tipi di carattere
- Attributi del linguaggio
- Attributo link
- Attributi margine pagina
- Attributi di allineamento del testo
- Attributi di colore del testo
- Attributi di decorazione del testo
- Attributi dello stile di testo
- Attributi di interazione e selezione
- Argomenti correlati
Attributi di annotazione
Gli oggetti di annotazione e i tipi di annotazione sono disponibili tramite gli attributi seguenti.
| Attributo | Identificatore |
|---|---|
| AnnotationObjects | UIA_AnnotationObjectsAttributeId |
| AnnotationTypes | UIA_AnnotationTypesAttributeId |
Attributi dei tipi di carattere
Il nome, le dimensioni e il peso di un tipo di carattere sono disponibili tramite gli attributi seguenti.
| Attributo | Identificatore |
|---|---|
| FontName | UIA_FontNameAttributeId |
| FontSize | UIA_FontSizeAttributeId |
| SpessoreCarattere | UIA_FontWeightAttributeId |
Attributi del linguaggio
Le informazioni sulla lingua del testo sono disponibili tramite gli attributi seguenti.
| Attributo | Identificatore |
|---|---|
| Cultura | UIA_CultureAttributeId |
| TextFlowDirections | UIA_TextFlowDirectionsAttributeId |
Attributo link
L'attributo seguente fornisce l'intervallo di testo di destinazione di un collegamento in un documento.
| Attributo | Identificatore |
|---|---|
| Collegamento | UIA_LinkAttributeId |
Attributi margine pagina
I rettangoli di associazione 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 della scheda e l'allineamento orizzontale sono disponibili tramite gli attributi seguenti.
| Attributo | Identificatore |
|---|---|
| HorizontalTextAlignment | UIA_HorizontalTextAlignmentAttributeId |
| RientroFirstLine | UIA_IndentationFirstLineAttributeId |
| rientroLeading | UIA_IndentationLeadingAttributeId |
| RientroTrailing | UIA_IndentationTrailingAttributeId |
| Schede | UIA_TabsAttributeId |
Attributi di colore del testo
I colori di testo in primo piano e di sfondo sono disponibili tramite gli attributi di testo seguenti. Entrambi i colori vengono specificati come tipo di dati COLORREF .
| 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 di stile testo
Le informazioni sugli stili di testo sono disponibili tramite 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 nello stato di intervallo e 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
-
Informazioni concettuali
-
Informazioni sui pattern di controllo Text e TextRange Automazione interfaccia utente