Acessibilidade do sgcUI

Os componentes expõem seu conteúdo ao Microsoft UI Automation, a interface de acessibilidade do Windows que leitores de tela como o Narrator e o NVDA e as ferramentas de teste da Microsoft usam: uma grade é exposta como uma tabela com linhas, células e cabeçalhos, um gráfico como uma lista de séries e pontos, um planejador como uma lista de itens, e assim por diante. Os clientes mais antigos que só falam MSAA são atendidos pela ponte que o Windows oferece entre o UI Automation e o MSAA.

• VCL: UI Automation em todas as versões compatíveis do Delphi e do C++Builder, do Delphi 7 ao Delphi 13 e do C++Builder 2007 ao C++Builder 13, com um único caminho de código e o mesmo comportamento em todas as versões.
• FireMonkey: UI Automation no Windows. O formulário é a raiz e cada controle sgcUI do formulário é um elemento dentro dele.
• WinForms: cada controle oferece seu próprio provedor de UI Automation, de modo que uma grade é uma tabela com os padrões Grid e Table. .NET Framework 4.7.2 e .NET 8, 9 e 10.
• WPF: cada controle retorna um automation peer e um peer por item que desenha. .NET Framework 4.7.2 e .NET 8, 9 e 10.
• Avalonia 12 (12.0 ou posterior, testado com o 12.1.4): cada controle retorna um automation peer e um peer por item que desenha, repassados ao UI Automation no Windows. .NET 8, 9 e 10.
• O sgcMaps é acessível no VCL, no FireMonkey no Windows e no WinForms, as plataformas em que está disponível.
• Teclado: alternativas pelo teclado para mover e redimensionar blocos, itens do planejador e formas, mover cartões Kanban, criar dependências do Gantt e vínculos de diagrama, adicionar formas a partir da paleta e mover campos da tabela dinâmica e colunas da grade. Todo controle interativo mostra um anel de foco visível.
• O alto contraste do Windows é seguido automaticamente enquanto um controle usa o tema padrão, e o tema utHighContrast o força. Os layouts da direita para a esquerda e o DPI alto são suportados.

Não coberto

• O controle visualizador do sgcPDF e o controle de visualização de impressão do sgcReports não expõem informações de acessibilidade nesta versão. Os arquivos PDF que o sgcPDF e o sgcReports produzem podem ser documentos PDF/UA com tags, o que é um recurso do documento e não é avaliado nos relatórios.
• FireMonkey no macOS, iOS e Android: por enquanto, a camada de acessibilidade está disponível somente no Windows.
• O Avalonia foi avaliado somente no Windows. Os outros sistemas operacionais não foram avaliados.

• Ainda não há alternativa pelo teclado para o redimensionamento da largura das colunas do sgcGrid, o zoom e o deslocamento por mouse do sgcCharts e as ferramentas de desenho financeiras, e os pontos de dobra dos conectores do sgcDiagram. As aplicações podem oferecê-los por meio da API do componente.
• Temas padrão: as bordas dos componentes têm 1,5:1 (claro), as linhas da grade 1,2:1 (claro) e 1,3:1 (escuro), quatro das oito cores de série do tema claro ficam abaixo de 3:1 sobre branco, e a cor de destaque clara tem 4,4:1 sobre branco quando um produto a usa para texto. O tema de alto contraste atende aos critérios de contraste, e o desenvolvedor pode escolher as cores.
• Nos temas padrão claro e escuro, as séries do gráfico, as categorias do planejador e as regras de formato da grade se distinguem pela cor, a menos que o desenvolvedor adicione marcadores, padrões de traço, rótulos de dados ou texto. A mesma informação é sempre exposta como texto para a tecnologia assistiva.
• As dicas de ferramenta e os rótulos do cursor em cruz do gráfico acompanham o ponteiro ou o ponto com foco e não podem receber o mouse sobre eles. O valor deles também é exposto como o valor do ponto com foco.
• O padrão Text do UI Automation (atributos de texto, cursor e seleção dentro dos editores e dos rótulos do diagrama) não está implementado. O texto é exposto como nomes e valores, e os editores de texto do VCL embutem um controle de edição nativo que expõe o próprio texto.
• Nenhuma relação LabeledBy com um controle de rótulo separado é exposta. Defina o nome acessível do controle.
• A configuração de tamanho do texto do sistema só é aplicada quando a aplicação a associa às fontes dos componentes.
• sgcMaps: a imagem do mapa é descrita somente pelo seu centro e zoom, e o renderizador do mapa não segue o alto contraste, porque a imagem do mapa é uma imagem de tiles do provedor.
• O texto alternativo da impressão e da exportação para PDF vem do mesmo gerador da descrição acessível padrão. Uma descrição acessível definida pela aplicação não é usada pela exportação.
• O Avalonia 12 não tem os padrões Grid e Table, portanto o sgcGrid e o sgcPivotGrid informam o cabeçalho da coluna e a posição no nome e no texto de ajuda de cada célula, em vez de uma relação de tabela. Foram encontrados mais dois limites do Avalonia com o NVDA. Com o registro de eventos do UI Automation padrão (seletivo) do NVDA, as mudanças de estado dos itens dentro dos controles sgcUI não são anunciadas, porque a janela do Avalonia responde a GetFocusedElement com o controle e não com o item. O Avalonia também não tem evento de notificação do UI Automation, portanto as notificações ao vivo não são anunciadas pelo Avalonia. Solução alternativa: no NVDA abra Configurações, Avançado, e defina "Registration for UI Automation events and property changes" como Global. As mudanças de estado dos itens passam a ser anunciadas; as notificações ao vivo não.
• A ajuda é publicada como páginas HTML, CHM e PDF com títulos e textos alternativos, e não foi auditada em relação às WCAG 2.1 AA.

Se um controle for difícil de usar com o seu leitor de tela, o seu teclado ou as suas configurações de contraste, ou se você precisar de um relatório em outro formato, escreva para info@esegece.com. Informe o produto, a plataforma, a versão e a tecnologia assistiva que você usa, e vamos analisar o caso.

Esta declaração foi preparada em outubro de 2026 para o sgcUI 2026.10. Os resultados do Avalonia foram testados novamente com o Avalonia 12.1.4 em 12 de outubro de 2026.

Leia o tópico de ajuda de acessibilidade