Accessibilità di sgcUI

I componenti espongono il proprio contenuto a Microsoft UI Automation, l'interfaccia di accessibilità di Windows che gli screen reader come Narrator e NVDA e gli strumenti di test di Microsoft usano: una griglia è esposta come una tabella con righe, celle e intestazioni, un grafico come un elenco di serie e punti, un planner come un elenco di elementi, e così via. I client più vecchi che parlano solo MSAA sono serviti tramite il ponte che Windows offre tra UI Automation e MSAA.

• VCL: UI Automation in ogni versione supportata di Delphi e C++Builder, da Delphi 7 a Delphi 13 e da C++Builder 2007 a C++Builder 13, con un solo percorso di codice e lo stesso comportamento in ogni versione.
• FireMonkey: UI Automation su Windows. Il form è la radice e ogni controllo sgcUI del form è un elemento al suo interno.
• WinForms: ogni controllo serve il proprio provider UI Automation, quindi una griglia è una tabella con i pattern Grid e Table. .NET Framework 4.7.2 e .NET 8, 9 e 10.
• WPF: ogni controllo restituisce un automation peer e un peer per ogni elemento che disegna. .NET Framework 4.7.2 e .NET 8, 9 e 10.
• Avalonia 12 (12.0 o successivo, testato con 12.1.4): ogni controllo restituisce un automation peer e un peer per ogni elemento che disegna, passato a UI Automation su Windows. .NET 8, 9 e 10.
• sgcMaps è accessibile su VCL, su FireMonkey su Windows e su WinForms, le piattaforme in cui è disponibile.
• Tastiera: alternative da tastiera per spostare e ridimensionare tile, elementi del planner e forme, spostare le schede Kanban, creare dipendenze Gantt e collegamenti nei diagrammi, aggiungere forme dalla palette, e spostare i campi pivot e le colonne della griglia. Ogni controllo interattivo mostra un anello di focus visibile.
• L'alto contrasto di Windows viene seguito automaticamente mentre un controllo usa il tema predefinito, e il tema utHighContrast lo forza. I layout da destra a sinistra e l'alta risoluzione (high DPI) sono supportati.

Non coperto

• Il controllo visualizzatore di sgcPDF e il controllo di anteprima di sgcReports non espongono informazioni di accessibilità in questa versione. I file PDF prodotti da sgcPDF e sgcReports possono essere documenti PDF/UA con tag, che è una funzione del documento e non è valutata nei report.
• FireMonkey su macOS, iOS e Android: per ora il livello di accessibilità è disponibile solo su Windows.
• Avalonia è stato valutato solo su Windows. Gli altri sistemi operativi non sono stati valutati.

• Non esiste ancora un'alternativa da tastiera per il ridimensionamento della larghezza delle colonne di sgcGrid, per lo zoom e lo spostamento con il mouse di sgcCharts e gli strumenti di disegno finanziari, e per i punti di piegatura dei connettori di sgcDiagram. Le applicazioni possono offrirli tramite l'API del componente.
• Temi predefiniti: i bordi dei componenti sono 1,5:1 (chiaro), le linee della griglia 1,2:1 (chiaro) e 1,3:1 (scuro), quattro degli otto colori delle serie del tema chiaro sono sotto 3:1 su bianco, e il colore di accento chiaro è 4,4:1 su bianco dove un prodotto lo usa per il testo. Il tema ad alto contrasto soddisfa i criteri di contrasto, e lo sviluppatore può scegliere i colori.
• Nei temi predefiniti chiaro e scuro, le serie dei grafici, le categorie del planner e le regole di formato della griglia si distinguono per colore, a meno che lo sviluppatore aggiunga marcatori, motivi di tratteggio, etichette dati o testo. Le stesse informazioni sono sempre esposte come testo alle tecnologie assistive.
• I tooltip dei grafici e le etichette del mirino seguono il puntatore o il punto con il focus e non possono essere raggiunti con il mouse. Il loro valore è esposto anche come valore del punto con il focus.
• Il pattern Text di UI Automation (attributi del testo, cursore e selezione negli editor e nelle etichette dei diagrammi) non è implementato. Il testo è esposto come nomi e valori, e gli editor di testo VCL incorporano un controllo di modifica nativo che espone il proprio testo.
• Non viene esposta alcuna relazione LabeledBy con un controllo etichetta separato. Imposta invece il nome accessibile del controllo.
• L'impostazione della dimensione del testo di sistema viene applicata solo quando l'applicazione la associa ai font dei componenti.
• sgcMaps: l'immagine della mappa è descritta solo dal suo centro e dallo zoom, e il renderer della mappa non segue l'alto contrasto, perché l'immagine della mappa è composta da tile del provider.
• Il testo alternativo della stampa e dell'esportazione PDF proviene dallo stesso generatore della descrizione accessibile predefinita. Una descrizione accessibile impostata dall'applicazione non viene usata dall'esportazione.
• Avalonia 12 non ha i pattern Grid e Table, quindi sgcGrid e sgcPivotGrid riportano l'intestazione di colonna e la posizione nel nome e nel testo della guida di ogni cella invece di una relazione di tabella. Con NVDA sono stati trovati altri due limiti di Avalonia. Con la registrazione degli eventi UI Automation predefinita (selettiva) di NVDA, le modifiche di stato degli elementi all'interno dei controlli sgcUI non vengono annunciate, perché la finestra di Avalonia risponde a GetFocusedElement con il controllo e non con l'elemento. Avalonia non ha inoltre un evento di notifica UI Automation, quindi le notifiche live non vengono annunciate da Avalonia. Soluzione alternativa: in NVDA aprire Impostazioni, Avanzate, e impostare "Registration for UI Automation events and property changes" su Global. Le modifiche di stato degli elementi vengono allora annunciate, le notifiche live no.
• La guida è pubblicata come pagine HTML, CHM e PDF con intestazioni e testi alternativi, e non è stata verificata rispetto a WCAG 2.1 AA.

Se un controllo è difficile da usare con il tuo screen reader, la tua tastiera o le tue impostazioni di contrasto, o se hai bisogno di un report in un altro formato, scrivi a info@esegece.com. Indicaci il prodotto, la piattaforma, la versione e la tecnologia assistiva che usi, e analizzeremo il problema.

Questa dichiarazione è stata preparata in ottobre 2026 per sgcUI 2026.10. I risultati di Avalonia sono stati verificati di nuovo con Avalonia 12.1.4 il 12 ottobre 2026.

Leggi l'argomento della guida sull'accessibilità