Condividi tramite


Estensioni SemanticProperties

Le SemanticProperties estensioni forniscono una serie di metodi di estensione che supportano la configurazione delle impostazioni correlate all'accessibilità.

Le proprietà semantiche vengono usate per definire informazioni sui controlli che devono ricevere lo stato attivo sull'accessibilità e sul testo da leggere ad alta voce all'utente. Le proprietà semantiche sono proprietà associate che possono essere aggiunte a qualsiasi elemento per impostare le API di accessibilità della piattaforma sottostanti.

Per altre informazioni su SemanticProperties e accessibilità, vedere la documentazione di .NET MAUI.

Per informazioni su altre estensioni correlate all'accessibilità, vedere le estensioni automationProperties.

SemanticDescription

Il SemanticDescription metodo imposta una stringa breve e descrittiva usata dall'utilità per la lettura dello schermo delle piattaforme per annunciare .BindableObject

Nell'esempio seguente viene illustrato come impostare la descrizione in un nuovo Entryoggetto :

new Entry().SemanticDescription("Enter your username.");

SemanticHeadingLevel

Il SemanticDescription metodo imposta un livello di intestazione per abilitare l'intestazione BindableObject da contrassegnare come intestazione per organizzare l'interfaccia utente e semplificare la navigazione per l'utilità per la lettura dello schermo della piattaforma.

Nell'esempio seguente viene illustrato come impostare il livello di intestazione su un nuovo Entryoggetto :

new Entry().SemanticHeadingLevel(SemanticHeadingLevel.Level5);

Importante

Non tutte le piattaforme supportano tutti i SemanticHeadingLevel valori. Per altre informazioni, vedere la documentazione di .NET MAUI.

SemanticHint

Il SemanticHint metodo imposta un contesto aggiuntivo su tale set in SemanticDescription, ad esempio lo scopo dell'oggetto BindableObject.

Nell'esempio seguente viene illustrato come impostare l'hint in un nuovo Entryoggetto :

new Entry().SemanticHint("The username field used to create a new account. This is a required field.");