Condividi tramite


Identificatori di proprietà dell'elemento di Automazione

In questo argomento vengono descritte le costanti denominate che identificano le proprietà degli elementi di Microsoft Automazione interfaccia utente.

Costante/valore Descrizione
UIA_AcceleratorKeyPropertyId
30006
Identifica la proprietà AcceleratorKey , ovvero una stringa contenente le combinazioni di tasti di scelta rapida (denominata anche tasto di scelta rapida) per l'elemento di automazione.
Le combinazioni di tasti di scelta rapida richiamano un'azione. Ad esempio, CTRL+O viene spesso usato per richiamare la finestra di dialogo Apri file comuni. Un elemento di automazione con la proprietà AcceleratorKey può implementare il modello di controllo Invoke per l'azione equivalente al comando di scelta rapida.
Tipo variante: VT_BSTR
Valore predefinito: stringa vuota
UIA_AccessKeyPropertyId
30007
Identifica la proprietà AccessKey , ovvero una stringa contenente il carattere chiave di accesso per l'elemento di automazione.
Una chiave di accesso (talvolta denominata mnemonic) è un carattere nel testo di un menu, una voce di menu o un'etichetta di un controllo, ad esempio un pulsante, che attiva la funzione di menu associata. Ad esempio, per aprire il menu File, per il quale il tasto di accesso è in genere F, l'utente preme ALT+F.
Tipo variante: VT_BSTR
Valore predefinito: stringa vuota
UIA_AnnotationObjectsPropertyId
30156
Identifica la proprietà AnnotationObjects , ovvero un elenco di oggetti annotazione in un documento, ad esempio commento, intestazione, piè di pagina e così via.
Tipo variante: VT_I4 VT_ARRAY |
Valore predefinito: matrice vuota
UIA_AnnotationTypesPropertyId
30155
Identifica la proprietà AnnotationTypes , ovvero un elenco dei tipi di annotazioni in un documento, ad esempio commento, intestazione, piè di pagina e così via.
Tipo variante: VT_I4 VT_ARRAY |
Valore predefinito: matrice vuota
UIA_AriaPropertiesPropertyId
30102
Identifica la proprietà AriaProperties , ovvero una stringa formattata contenente le informazioni sulla proprietà Application Rich Internet (ARIA) accessibili per l'elemento di automazione. Per altre informazioni sul mapping degli stati e delle proprietà ARIA alle proprietà e alle funzioni Automazione interfaccia utente, vedere Automazione interfaccia utente per la specifica delle applicazioni Rich Internet accessibili da W3C.
AriaProperties è una raccolta di coppie Name/Value con delimitatori di = (uguale) e ; (punto e virgola), ad esempio "checked=true;disabled=false". La \ (barra rovesciata) viene usata come carattere di escape quando questi caratteri delimitatori o \ vengono visualizzati nei valori. Per motivi di sicurezza e altre ragioni, l'implementazione del provider di questa proprietà può eseguire passaggi per convalidare le proprietà ARIA originali; tuttavia, non è obbligatorio.
Tipo variante: VT_BSTR
Valore predefinito: stringa vuota
UIA_AriaRolePropertyId
30101
Identifica la proprietà AriaRole , che è una stringa contenente le informazioni sul ruolo Application Rich Internet (ARIA) accessibili per l'elemento di automazione. Per altre informazioni sul mapping dei ruoli ARIA ai tipi di controllo Automazione interfaccia utente, vedere Automazione interfaccia utente per la specifica delle applicazioni Rich Internet accessibili da W3C.

Nota:
Come opzione, l'agente utente può anche offrire una descrizione localizzata del ruolo ARIA W3C nella proprietà LocalizedControlType . Quando la stringa localizzata non è specificata, il sistema fornirà la stringa LocalizedControlType predefinita per l'elemento.



Tipo variante: VT_BSTR
Valore predefinito: stringa vuota

UIA_AutomationIdPropertyId
30011
Identifica la proprietà AutomationId, ovvero una stringa contenente l'identificatore Automazione interfaccia utente (ID) per l'elemento di automazione.
Quando è disponibile, automationId di un elemento deve essere uguale in qualsiasi istanza dell'applicazione, indipendentemente dalla lingua locale. Il valore deve essere univoco tra gli elementi di pari livello, ma non necessariamente univoco nell'intero desktop. Ad esempio, più istanze di un'applicazione o più visualizzazioni di cartelle in Microsoft Windows Explorer possono contenere elementi con la stessa proprietà AutomationId , ad esempio "SystemMenuBar".
Anche se il supporto per AutomationId è sempre consigliato per un supporto di test automatizzato migliore, questa proprietà non è obbligatoria. Dove è supportato, AutomationId è utile per creare uno script di automazione di test che viene eseguito indipendentemente dal linguaggio dell'interfaccia utente. I client non devono prendere presupposti relativi ai valori AutomationId esposti da altre applicazioni. AutomationId non è garantito che sia stabile tra versioni diverse o compilazioni di un'applicazione.
Tipo variante: VT_BSTR
Valore predefinito: stringa vuota
UIA_BoundingRectanglePropertyId
30001
Identifica la proprietà BoundingRectangle , che specifica le coordinate del rettangolo che racchiude completamente l'elemento di automazione. Il rettangolo è espresso nelle coordinate dello schermo fisiche. Può contenere punti che non sono selezionabili se la forma o l'area selezionabile dell'elemento dell'interfaccia utente è irregolare o se l'elemento è oscurato da altri elementi dell'interfaccia utente.
Tipo variant: VT_R8 VT_ARRAY |
Valore predefinito: [0,0,0,0]

Nota:
Questa proprietà è NULL se l'elemento non visualizza attualmente un'interfaccia utente.



UIA_CenterPointPropertyId
30165
Identifica la proprietà CenterPoint , che specifica le coordinate del punto X e Y del centro dell'elemento di automazione. Lo spazio delle coordinate è quello che il provider considera logicamente una pagina.
Tipo variant: VT_R8 VT_ARRAY |
Valore predefinito: VT_EMPTY
UIA_ClassNamePropertyId
30012
Identifica la proprietà ClassName , ovvero una stringa contenente il nome della classe per l'elemento di automazione come assegnato dallo sviluppatore di controllo.
Il nome della classe dipende dall'implementazione del provider di Automazione interfaccia utente e pertanto non è sempre in un formato standard. Tuttavia, se il nome della classe è noto, può essere usato per verificare che un'applicazione funzioni con l'elemento di automazione previsto.
Tipo variante: VT_BSTR
Valore predefinito: stringa vuota
UIA_ClickablePointPropertyId
30014
Identifica la proprietà ClickablePoint , ovvero un punto sull'elemento di automazione che può essere fatto clic. Non è possibile fare clic su un elemento se è completamente o parzialmente oscurato da un'altra finestra.
Tipo variant: VT_R8 VT_ARRAY |
Valore predefinito: VT_EMPTY
UIA_ControllerForPropertyId
30104
Identifica la proprietà ControllerFor , ovvero una matrice di elementi di automazione modificati dall'elemento di automazione che supporta questa proprietà.
ControllerFor viene usato quando un elemento di automazione influisce su uno o più segmenti dell'interfaccia utente dell'applicazione o del desktop; in caso contrario, è difficile associare l'impatto dell'operazione di controllo agli elementi dell'interfaccia utente.
Questo identificatore viene comunemente usato per l'accessibilità suggerita automaticamente.
Tipo variant per i provider: VT_UNKNOWN VT_ARRAY |
Tipo variant per i client: VT_UNKNOWN (IUIAutomationElementArray )
Valore predefinito: matrice vuota
UIA_ControlTypePropertyId
30003
Identifica la proprietà ControlType , ovvero una classe che identifica il tipo dell'elemento di automazione. ControlType definisce le caratteristiche degli elementi dell'interfaccia utente da primitive di controllo dell'interfaccia utente note, ad esempio pulsanti o caselle di controllo.
Tipo variant: VT_I4
Valore predefinito: UIA_CustomControlTypeId

Nota:
Usare il valore predefinito solo se l'elemento di automazione rappresenta un tipo completamente nuovo di controllo.



UIA_CulturePropertyId
30015
Identifica la proprietà Culture, che contiene un identificatore delle impostazioni locali per l'elemento di automazione ( ad esempio, 0x0409 per "en-US" o inglese (Stati Uniti)).
Ogni impostazione locale ha un identificatore univoco, un valore a 32 bit costituito da un identificatore di lingua e da un identificatore di ordinamento. L'identificatore delle impostazioni locali è un'abbreviazione numerica internazionale standard e include i componenti necessari per identificare in modo univoco una delle impostazioni locali definite dal sistema operativo installate. Per altre informazioni, vedere Costanti e stringhe dell'identificatore di linguaggio.
Questa proprietà può esistere per ogni controllo, ma in genere è disponibile solo a livello di applicazione.
Tipo variant: VT_I4
Valore predefinito: 0
UIA_DescribedByPropertyId
30105
Identifica la proprietà DescribedBy , ovvero una matrice di elementi che forniscono altre informazioni sull'elemento di automazione.
DescribedBy viene usato quando un elemento di automazione viene spiegato da un altro segmento dell'interfaccia utente dell'applicazione. Ad esempio, la proprietà può puntare a un elemento di testo di "2.529 elementi in 85 gruppi, 10 elementi selezionati" da un oggetto elenco personalizzato complesso. Invece di usare il modello a oggetti per consentire ai client di digerire informazioni simili, la proprietà DescribedBy può offrire accesso rapido all'elemento dell'interfaccia utente che potrebbe già offrire informazioni utili per l'utente finale che descrivono l'elemento dell'interfaccia utente.
Tipo variant per i provider: VT_UNKNOWN VT_ARRAY |
Tipo variant per i client: VT_UNKNOWN (IUIAutomationElementArray)
Valore predefinito: matrice vuota
UIA_FillColorPropertyId
30160
Identifica la proprietà FillColor , che specifica il colore utilizzato per riempire l'elemento di automazione. Questo attributo viene specificato come COLORREF, un valore a 32 bit usato per specificare un colore RGB o RGBA.
Tipo variant: VT_I4
Valore predefinito: 0
UIA_FillTypePropertyId
30162
Identifica la proprietà FillType , che specifica il motivo utilizzato per riempire l'elemento di automazione, ad esempio nessuno, colore, sfumatura, immagine, motivo e così via.
Tipo variant: VT_I4
Valore predefinito: 0
UIA_FlowsFromPropertyId
30148
Identifica la proprietà FlowsFrom , ovvero una matrice di elementi di automazione che suggerisce l'ordine di lettura prima dell'elemento di automazione corrente. Supportato a partire da Windows 8.
La proprietà FlowsFrom specifica l'ordine di lettura quando gli elementi di automazione non sono esposti o strutturati nello stesso ordine di lettura percepito dall'utente. Anche se la proprietà FlowsFrom può specificare più elementi precedenti, in genere contiene solo l'elemento precedente nell'ordine di lettura.
Tipo variant per i provider: VT_UNKNOWN VT_ARRAY |
Tipo variant per i client: VT_UNKNOWN (IUIAutomationElementArray)
Valore predefinito: matrice vuota
UIA_FlowsToPropertyId
30106
Identifica la proprietà FlowsTo , ovvero una matrice di elementi di automazione che suggerisce l'ordine di lettura dopo l'elemento di automazione corrente.
La proprietà FlowsTo specifica l'ordine di lettura quando gli elementi di automazione non sono esposti o strutturati nello stesso ordine di lettura percepito dall'utente. Anche se la proprietà FlowsTo può specificare più elementi successivi, in genere contiene solo l'elemento successivo nell'ordine di lettura.
Tipo variant per i provider: VT_UNKNOWN VT_ARRAY |
Tipo variant per i client: VT_UNKNOWN (IUIAutomationElementArray)
Valore predefinito: matrice vuota
UIA_FrameworkIdPropertyId
30024
Identifica la proprietà FrameworkId , ovvero una stringa contenente il nome del framework dell'interfaccia utente sottostante a cui appartiene l'elemento di automazione.
FrameworkId consente alle applicazioni client di elaborare elementi di automazione in modo diverso a seconda del framework dell'interfaccia utente specifico. Esempi di valori di proprietà includono "Win32", "WinForm" e "DirectUI".
Tipo variant: VT_BSTR
Valore predefinito: stringa vuota
UIA_FullDescriptionPropertyId
30159
La proprietà FullDescription espone una stringa localizzata che può contenere testo di descrizione esteso per un elemento. FullDescription può contenere una descrizione più completa di un elemento rispetto a quanto potrebbe essere appropriato per l'elemento Name.
Tipo variant: VT_BSTR
Valore predefinito: stringa vuota
UIA_HasKeyboardFocusPropertyId
30008
Identifica la proprietà HasKeyboardFocus , ovvero un valore booleano che indica se l'elemento di automazione ha lo stato attivo della tastiera.
Tipo variant: VT_BOOL
Valore predefinito: FALSE
UIA_HeadingLevelPropertyId
30173
Identifica la proprietà HeadingLevel, che indica il livello di titolo di un elemento Automazione interfaccia utente.
Tipo variant: VT_I4
Valore predefinito: HeadingLevel_None
UIA_HelpTextPropertyId
30013
Identifica la proprietà HelpText , ovvero una stringa di testo della Guida associata all'elemento di automazione.
La proprietà HelpText può essere supportata con il testo segnaposto visualizzato nei controlli di modifica o elenco. Ad esempio, "Digitare il testo qui per la ricerca" è un buon candidato alla proprietà HelpText per un controllo di modifica che inserisce il testo prima dell'input effettivo dell'utente. Tuttavia, non è adeguato per la proprietà name del controllo di modifica.
Quando HelpText è supportato, la stringa deve corrispondere alla lingua dell'interfaccia utente dell'applicazione o alla lingua predefinita dell'interfaccia utente del sistema operativo.
Tipo variant: VT_BSTR
Valore predefinito: stringa vuota
UIA_IsContentElementPropertyId
30017
Identifica la proprietà IsContentElement , ovvero un valore booleano che specifica se l'elemento viene visualizzato nella visualizzazione contenuto dell'albero degli elementi di automazione. Per altre informazioni, vedere Panoramica dell'albero di Automazione interfaccia utente.

Nota:
Affinché un elemento venga visualizzato nella visualizzazione contenuto, sia la proprietà IsContentElement che la proprietà IsControlElement devono essere TRUE.



Tipo variant: VT_BOOL
Valore predefinito: TRUE

UIA_IsControlElementPropertyId
30016
Identifica la proprietà IsControlElement , ovvero un valore booleano che specifica se l'elemento viene visualizzato nella visualizzazione controllo dell'albero degli elementi di automazione. Per altre informazioni, vedere Panoramica dell'albero di Automazione interfaccia utente.
Tipo variant: VT_BOOL
Valore predefinito: TRUE
UIA_IsDataValidForFormPropertyId
30103
Identifica la proprietà IsDataValidForForm , ovvero un valore booleano che indica se il valore immesso o selezionato è valido per la regola del modulo associata all'elemento di automazione. Ad esempio, se l'utente ha immesso "425-555-5555" per un campo di codice postale che richiede 5 o 9 cifre, la proprietà IsDataValidForForm può essere impostata su FALSE per indicare che i dati non sono validi.
Tipo variant: VT_BOOL
Valore predefinito: FALSE
UIA_IsDialogPropertyId
30174
Identifica la proprietà IsDialog , ovvero un valore booleano che indica se l'elemento di automazione è una finestra di dialogo. Ad esempio, la tecnologia di assistive technology, ad esempio, le utilità per la lettura dello schermo parlano in genere il titolo del dialogo, il controllo attivo nel dialogo e quindi il contenuto del dialogo fino al controllo attivo ("Salvare le modifiche prima della chiusura"). Per le finestre standard, un'utilità per la lettura dello schermo parla in genere il titolo della finestra seguito dal controllo attivo. La proprietà IsDialog può essere impostata su TRUE per indicare che l'applicazione client deve considerare l'elemento come finestra di dialogo.
Tipo variant: VT_BOOL
Valore predefinito: FALSE
UIA_IsEnabledPropertyId
30010
Identifica la proprietà IsEnabled , ovvero un valore booleano che indica se l'elemento dell'interfaccia utente a cui fa riferimento l'elemento di automazione è abilitato e può essere interagito con.
Quando lo stato abilitato di un controllo è FALSE, si presuppone che anche i controlli figlio non siano abilitati. I client non devono aspettarsi eventi di modifica delle proprietà dagli elementi figlio quando lo stato del controllo padre cambia.
Tipo variant: VT_BOOL
Valore predefinito: FALSE
UIA_IsKeyboardFocusablePropertyId
30009
Identifica la proprietà IsKeyboardFocusable , ovvero un valore booleano che indica se l'elemento di automazione può accettare lo stato attivo della tastiera.
Tipo variant: VT_BOOL
Valore predefinito: FALSE
UIA_IsOffscreenPropertyId
30022
Identifica la proprietà IsOffscreen , ovvero un valore booleano che indica se l'elemento di automazione è completamente fuori visualizzazione (ad esempio, un elemento in una casella di riepilogo che si trova all'esterno del riquadro di visualizzazione dell'oggetto contenitore) o se è compresso fuori visualizzazione (ad esempio, un elemento in una visualizzazione albero o un menu o in una finestra ridotta a icona). Se l'elemento ha un punto selezionabile che può causare la ricezione dello stato attivo, l'elemento viene considerato sullo schermo mentre una parte dell'elemento è fuori schermo.
Il valore della proprietà non è influenzato dall'occlusione da altre finestre o dal fatto che l'elemento sia visibile in un monitoraggio specifico.
Se la proprietà IsOffscreen è TRUE, l'elemento dell'interfaccia utente viene scorrevole fuori schermo o compresso. L'elemento è temporaneamente nascosto, ma rimane nella percezione dell'utente finale e continua a essere incluso nel modello di interfaccia utente. L'oggetto può essere riportato in visualizzazione scorrendo, facendo clic su un elenco a discesa e così via.
Gli oggetti che l'utente finale non percepisce affatto o che sono "nascosti a livello di codice", ad esempio una finestra di dialogo che è stata chiusa, ma l'oggetto sottostante è ancora memorizzato nella cache dall'applicazione, non deve trovarsi nell'albero degli elementi di automazione al primo posto (anziché impostare lo stato di IsOffscreen su TRUE).
Tipo variant: VT_BOOL
Valore predefinito: FALSE
UIA_IsPasswordPropertyId
30019
Identifica la proprietà IsPassword , ovvero un valore booleano che indica se l'elemento di automazione contiene contenuto protetto o una password.
Quando la proprietà IsPassword è TRUE e l'elemento ha lo stato attivo della tastiera, un'applicazione client deve disabilitare l'eco della tastiera o il feedback di input della tastiera che può esporre le informazioni protette dell'utente. Il tentativo di accedere alla proprietà Value dell'elemento protetto (controllo di modifica) può causare un errore.
Tipo variant: VT_BOOL
Valore predefinito: FALSE
UIA_IsPeripheralPropertyId
30150
Identifica la proprietà IsPeripheral , ovvero un valore booleano che indica se l'elemento di automazione rappresenta l'interfaccia utente periferica. L'interfaccia utente della periferica viene visualizzata e supporta l'interazione dell'utente, ma non prende lo stato attivo della tastiera quando viene visualizzata. Esempi di interfaccia utente periferica includono popup, riquadri a comparsa, menu di scelta rapida o notifiche mobili. Supportato a partire da Windows 8.1.
Quando la proprietà IsPeripheral è TRUE, un'applicazione client non può presupporre che lo stato attivo sia stato preso dall'elemento anche se è attualmente interattivo da tastiera.
Questa proprietà è rilevante per questi tipi di controllo:
  • UIA_GroupControlTypeId
  • UIA_MenuControlTypeId
  • UIA_PaneControlTypeId
  • UIA_ToolBarControlTypeId
  • UIA_ToolTipControlTypeId
  • UIA_WindowControlTypeId
  • UIA_CustomControlTypeId
Tipo variant: VT_BOOL
Valore predefinito: FALSE
UIA_IsRequiredForFormPropertyId
30025
Identifica la proprietà IsRequiredForForm , ovvero un valore booleano che indica se è necessario compilare l'elemento di automazione in un modulo.
Tipo variant: VT_BOOL
Valore predefinito: FALSE
UIA_ItemStatusPropertyId
30026
Identifica la proprietà ItemStatus , ovvero una stringa di testo che descrive lo stato di un elemento dell'elemento di automazione.
ItemStatus consente a un client di verificare se un elemento trasmette lo stato di un elemento e lo stato. Ad esempio, un elemento associato a un contatto in un'applicazione di messaggistica potrebbe essere "Occupato" o "Connesso".
Quando ItemStatus è supportato, la stringa deve corrispondere alla lingua dell'interfaccia utente dell'applicazione o alla lingua predefinita dell'interfaccia utente del sistema operativo.
Tipo variant: VT_BSTR
Valore predefinito: stringa vuota
UIA_ItemTypePropertyId
300021
Identifica la proprietà ItemType , ovvero una stringa di testo che descrive il tipo dell'elemento di automazione.
ItemType viene usato per ottenere informazioni sugli elementi in una griglia di dati, visualizzazione elenco o albero. Ad esempio, un elemento in una visualizzazione directory file potrebbe essere "File di documento" o "Cartella".
Quando ItemType è supportato, la stringa deve corrispondere alla lingua dell'interfaccia utente dell'applicazione o alla lingua predefinita dell'interfaccia utente del sistema operativo.
Tipo variant: VT_BSTR
Valore predefinito: stringa vuota
UIA_LabeledByPropertyId
30018
Identifica la proprietà LabeledBy , che è un elemento di automazione che contiene l'etichetta di testo per questo elemento.
Questa proprietà può essere utilizzata per recuperare, ad esempio, l'etichetta di testo statico per una casella combinata.
Tipo variant: VT_UNKNOWN
Valore predefinito: NULL
UIA_LandmarkTypePropertyId
30157
Identifica la proprietà LandmarkType , ovvero un identificatore di tipo punto di riferimento associato a un elemento.
La proprietà LandmarkType descrive un elemento che rappresenta un gruppo di elementi. Ad esempio, un punto di riferimento di ricerca può rappresentare un set di controlli correlati per la ricerca.
Se si usa UIA_CustomLandmarkTypeId , è necessario UIA_LocalizedLandmarkTypePropertyId per descrivere il punto di riferimento personalizzato.
Tipo variant: VT_I4
Valore predefinito: 0
UIA_LevelPropertyId
30154
Identifica la proprietà Level , ovvero un numero intero basato su 1 associato a un elemento di automazione.
La proprietà Level descrive la posizione di un elemento all'interno di strutture gerarchiche gerarchiche o interrotte. Ad esempio, un elenco puntato/numerato, intestazioni o altri elementi di dati strutturati può avere varie relazioni padre/figlio. Level descrive dove si trova l'elemento nella struttura.
È consigliabile usare il pattern di controllo CustomNavigation in combinazione con Level.
Tipo variante: VT_I4
Valore predefinito: 0
UIA_LiveSettingPropertyId
30135
Identifica la proprietà LiveSetting , supportata da un elemento di automazione che rappresenta un'area dinamica. La proprietà LiveSetting indica il livello di "cortesia" usato da un client per informare l'utente delle modifiche all'area dinamica. Questa proprietà può essere uno dei valori dell'enumerazione LiveSetting . Supportato a partire da Windows 8.
Tipo variante: VT_I4
Valore predefinito: 0
UIA_LocalizedControlTypePropertyId
30004
Identifica la proprietà LocalizedControlType , ovvero una stringa di testo che descrive il tipo di controllo rappresentato dall'elemento di automazione. La stringa deve contenere solo caratteri minuscoli:
  • Correzione: "button"
  • Errato: "Pulsante"

Quando LocalizedControlType non viene specificato dal provider di elementi, la stringa localizzata predefinita viene fornita dal framework, in base al tipo di controllo dell'elemento , ad esempio "button" per il tipo di controllo Button . Un elemento di automazione con il tipo di controllo personalizzato deve supportare una stringa di tipo di controllo localizzata che rappresenta il ruolo dell'elemento ,ad esempio "selezione colori" per un controllo personalizzato che consente agli utenti di scegliere e specificare i colori.
Quando viene specificato un valore personalizzato, la stringa deve corrispondere alla lingua dell'interfaccia utente dell'applicazione o al linguaggio predefinito dell'interfaccia utente del sistema operativo.
Tipo variante: VT_BSTR
Valore predefinito: stringa vuota
UIA_LocalizedLandmarkTypePropertyId
30158
Identifica LocalizedLandmarkType, ovvero una stringa di testo che descrive il tipo di punto di riferimento rappresentato dall'elemento di automazione.
Questa operazione deve essere usata in combinazione con UIA_CustomLandmarkTypeId , tuttavia, LocalizedLandmarkType deve sempre avere la precedenza su LandmarkType e essere usata per descrivere il punto di riferimento prima di LandmarkType.
La stringa deve corrispondere alla lingua dell'interfaccia utente dell'applicazione o al linguaggio predefinito dell'interfaccia utente del sistema operativo.
Tipo variante: VT_BSTR
Valore predefinito: stringa vuota
UIA_NamePropertyId
30005
Identifica la proprietà Name , ovvero una stringa che contiene il nome dell'elemento di automazione.
La proprietà Name deve essere uguale al testo dell'etichetta sullo schermo. Ad esempio, nome deve essere "Sfoglia" per un elemento pulsante con l'etichetta "Sfoglia". La proprietà Name non deve includere il carattere mnemonic per le chiavi di accesso, ovvero "&"), sottolineato nella presentazione del testo dell'interfaccia utente. Inoltre, la proprietà Name non deve essere una versione estesa o modificata dell'etichetta sullo schermo perché la incoerenza tra il nome e l'etichetta può causare confusione tra applicazioni client e utenti.
Quando il testo dell'etichetta corrispondente non è visibile sullo schermo o quando viene sostituito dalla grafica, è necessario scegliere testo alternativo. Il testo alternativo deve essere conciso, intuitivo e localizzato nella lingua dell'interfaccia utente dell'applicazione o nella lingua predefinita dell'interfaccia utente del sistema operativo. Il testo alternativo non deve essere una descrizione dettagliata dei dettagli visivi, ma una descrizione concisa della funzione o della funzionalità dell'interfaccia utente come se fosse etichettata da testo semplice. Ad esempio, il pulsante del menu Start di Windows è denominato "Start" (pulsante) anziché "Windows Logo on blue round sphere graphics" (pulsante). Per altre informazioni, vedere Creazione di equivalenti di testo per le immagini.
Quando un'etichetta dell'interfaccia utente usa grafica di testo (ad esempio, usando ">>" per un pulsante che aggiunge un elemento da sinistra a destra), la proprietà Name deve essere sostituita da un'alternativa di testo appropriata (ad esempio, "Aggiungi"). Tuttavia, la pratica di usare grafica di testo come etichetta dell'interfaccia utente è sconsigliata a causa di problemi di localizzazione e accessibilità.
La proprietà Name non deve includere il ruolo di controllo o le informazioni sul tipo, ad esempio "button" o "list"; in caso contrario, verrà in conflitto con il testo dalla proprietà LocalizedControlType quando queste due proprietà vengono aggiunte (molte tecnologie assistive esistenti eseguono questa operazione).
La proprietà Name non può essere usata come identificatore univoco tra i fratelli. Tuttavia, purché sia coerente con la presentazione dell'interfaccia utente, lo stesso valore nome può essere supportato tra i peer. Per l'automazione dei test, i client devono considerare l'uso della proprietà AutomationId o RuntimeId .
I controlli di testo non devono sempre avere la proprietà Name identica al testo visualizzato all'interno del controllo, purché sia supportato anche il modello di testo.
Tipo variante: VT_BSTR
Valore predefinito: stringa vuota
UIA_NativeWindowHandlePropertyId
30020
Identifica la proprietà NativeWindowHandle , ovvero un intero che rappresenta l'handle (HWND) della finestra degli elementi di automazione, se presente; in caso contrario, questa proprietà è 0.
Tipo variante: VT_I4
Valore predefinito: 0
UIA_OptimizeForVisualContentPropertyId
30111
Identifica la proprietà OptimizeForVisualContent , ovvero un valore booleano che indica se il provider espone solo elementi visibili. Un provider può usare questa proprietà per ottimizzare le prestazioni quando si utilizzano parti di contenuto molto grandi. Ad esempio, come le pagine utente tramite un'ampia parte di contenuto, il provider può distruggere gli elementi del contenuto che non sono più visibili. Quando un elemento del contenuto viene eliminato, il provider deve restituire il codice di errore UIA_E_ELEMENTNOTAVAILABLE . Supportato a partire da Windows 8.
Tipo varianti: VT_BOOL
Valore predefinito: FALSE
UIA_OrientationPropertyId
300023
Identifica la proprietà Orientation , che indica l'orientamento del controllo rappresentato dall'elemento di automazione. La proprietà viene espressa come valore dal tipo enumerato OrientationType .
La proprietà Orientation è supportata dai controlli, ad esempio barre di scorrimento e dispositivi di scorrimento, che possono avere un orientamento verticale o orizzontale. In caso contrario, può essere sempre OrientationType_None, il che significa che il controllo non ha alcun orientamento.
Tipo variante: VT_I4
Valore predefinito: 0 (OrientationType_None)
UIA_OutlineColorPropertyId
30161
Identifica la proprietà OutlineColor , che specifica il colore utilizzato per la struttura dell'elemento di automazione. Questo attributo viene specificato come COLORREF, un valore a 32 bit usato per specificare un colore RGB o RGBA.
Tipo variante: VT_I4 VT_ARRAY |
Valore predefinito: 0
UIA_OutlineThicknessPropertyId
30164
Identifica la proprietà OutlineThickness , che specifica la larghezza per la struttura dell'elemento di automazione.
Tipo variant: VT_R8 VT_ARRAY |
Valore predefinito: VT_EMPTY
UIA_PositionInSetPropertyId
30152
Identifica la proprietà PositionInSet , ovvero un intero basato su 1 associato a un elemento di automazione. PositionInSet descrive la posizione ordinale dell'elemento all'interno di un set di elementi considerati pari a pari.
PositionInSet funziona in coordinamento con la proprietà SizeOfSet per descrivere la posizione ordinale nel set.
Tipo variante: VT_I4
Valore predefinito: 0
UIA_ProcessIdPropertyId
30002
Identifica la proprietà ProcessId , che rappresenta l'identificatore del processo (ID) dell'elemento di automazione.
L'identificatore di processo (ID) viene assegnato dal sistema operativo. Può essere visualizzato nella colonna PID della scheda Processi in Gestione attività.
Tipo variante: VT_I4
Valore predefinito: 0
UIA_ProviderDescriptionPropertyId
30107
Identifica la proprietà ProviderDescription, ovvero una stringa formattata contenente le informazioni di origine del provider di Automazione interfaccia utente per l'elemento di automazione, incluse le informazioni sul proxy.
Tipo variante: VT_BSTR
Valore predefinito: stringa vuota
UIA_RotationPropertyId
30166
Identifica la proprietà Rotation , che specifica l'angolo di rotazione in unità non specificate.
Tipo varianti: VT_R8
Valore predefinito: 0
UIA_RuntimeIdPropertyId
30000
Identifica la proprietà RuntimeId , ovvero una matrice di numeri interi che rappresenta l'identificatore di un elemento di automazione.
L'identificatore è univoco sul desktop, ma è garantito che sia univoco solo all'interno dell'interfaccia utente del desktop in cui è stato generato. Gli identificatori possono essere riutilizzati nel tempo.
Il formato di RuntimeId può cambiare. L'identificatore restituito deve essere considerato come un valore opaco e usato solo per il confronto; Ad esempio, per determinare se un elemento di automazione si trova nella cache.
Tipo variant: VT_I4 VT_ARRAY |
Valore predefinito: VT_EMPTY
UIA_SizePropertyId
30167
Identifica la proprietà Size , che specifica la larghezza e l'altezza dell'elemento di automazione.
Tipo variant: VT_R8 VT_ARRAY |
Valore predefinito: VT_EMPTY
UIA_SizeOfSetPropertyId
30153
Identifica la proprietà SizeOfSet , ovvero un intero basato su 1 associato a un elemento di automazione. SizeOfSet descrive il numero di elementi di automazione in un gruppo o set considerati elementi di pari livello.
SizeOfSet funziona in coordinamento con la proprietà PositionInSet per descrivere il numero di elementi nel set.
Tipo variant: VT_I4
Valore predefinito: 0
UIA_VisualEffectsPropertyId
30163
Identifica la proprietà VisualEffects , ovvero un campo di bit che specifica gli effetti sull'elemento di automazione, ad esempio ombreggiatura, reflection, alone, bordi sfumati o smussati.
VisualEffects:
  • VisualEffects_Shadow: 0x1
  • VisualEffects_Reflection: 0x2
  • VisualEffects_Glow: 0x4
  • VisualEffects_SoftEdges: 0x8
  • VisualEffects_Bevel: 0x10
Tipo variant: VT_I4
Valore predefinito: 0

Requisiti

Requisito valore
Client minimo supportato
Windows XP [app desktop | App UWP]
Server minimo supportato
Windows Server 2003 [app desktop | App UWP]
Intestazione
UIAutomationClient.h

Vedi anche

Informazioni concettuali

Cenni preliminari sulle proprietà di automazione interfaccia utente

Recupero di proprietà da elementi Automazione interfaccia utente