attributi di testo Automazione interfaccia utente

  • Articolo

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

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

 

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

 

Informazioni concettuali

Informazioni sui pattern di controllo Text e TextRange Automazione interfaccia utente

Modelli di controllo Text e TextRange

Utilizzo dei controlli basati su testo