sgcUI 접근성

컴포넌트는 화면 읽기 프로그램(Narrator, NVDA 등)과 Microsoft 테스트 도구가 사용하는 Windows의 접근성 인터페이스인 Microsoft UI Automation에 내용을 노출합니다. 그리드는 행, 셀, 머리글이 있는 표로, 차트는 시리즈와 포인트 목록으로, 플래너는 항목 목록으로 노출되는 식입니다. MSAA만 지원하는 이전 클라이언트는 Windows가 UI Automation과 MSAA 사이에 제공하는 브리지를 통해 지원됩니다.

• VCL: 지원되는 모든 Delphi 및 C++Builder 버전, 즉 Delphi 7부터 Delphi 13, C++Builder 2007부터 C++Builder 13까지 UI Automation을 지원하며, 코드 경로는 하나이고 모든 버전에서 동작이 같습니다.
• FireMonkey: Windows에서 UI Automation을 지원합니다. 폼이 루트이고 폼의 모든 sgcUI 컨트롤이 그 안의 요소입니다.
• WinForms: 모든 컨트롤이 자체 UI Automation 공급자를 제공하므로 그리드는 Grid 및 Table 패턴을 가진 표입니다. .NET Framework 4.7.2와 .NET 8, 9, 10.
• WPF: 모든 컨트롤이 자동화 피어를 반환하며, 그리는 항목마다 피어가 하나씩 있습니다. .NET Framework 4.7.2와 .NET 8, 9, 10.
• Avalonia 12(12.0 이상, 12.1.4로 테스트): 모든 컨트롤이 자동화 피어를 반환하며, 그리는 항목마다 피어가 하나씩 있고 Windows에서 UI Automation으로 전달됩니다. .NET 8, 9, 10.
• sgcMaps는 사용할 수 있는 플랫폼인 VCL, Windows의 FireMonkey, WinForms에서 접근할 수 있습니다.
• 키보드: 타일, 플래너 항목, 도형의 이동과 크기 조절, 칸반 카드 이동, 간트 종속성과 다이어그램 링크 만들기, 팔레트에서 도형 추가, 피벗 필드와 그리드 열 이동에 키보드 대안이 있습니다. 상호작용하는 모든 컨트롤은 눈에 보이는 포커스 링을 표시합니다.
• 컨트롤이 기본 테마를 사용하는 동안에는 Windows 고대비를 자동으로 따르며, utHighContrast 테마는 이를 강제합니다. 오른쪽에서 왼쪽으로 쓰는 레이아웃과 고해상도 DPI를 지원합니다.

해당되지 않는 범위

• sgcPDF 뷰어 컨트롤과 sgcReports 미리 보기 컨트롤은 이 릴리스에서 접근성 정보를 노출하지 않습니다. sgcPDF와 sgcReports가 만드는 PDF 파일은 태그가 지정된 PDF/UA 문서일 수 있으며, 이는 문서 기능이므로 보고서에서 평가하지 않습니다.
• macOS, iOS, Android의 FireMonkey: 접근성 계층은 현재 Windows에서만 제공됩니다.
• Avalonia는 Windows에서만 평가했습니다. 다른 운영 체제는 평가하지 않았습니다.

• sgcGrid 열 너비 조절, 마우스를 이용한 sgcCharts 확대/축소와 이동 및 금융 그리기 도구, sgcDiagram 커넥터 꺾임점에는 아직 키보드 대안이 없습니다. 애플리케이션은 컴포넌트 API를 통해 이러한 기능을 제공할 수 있습니다.
• 기본 테마: 컴포넌트 테두리는 1.5:1(밝은 테마), 그리드 선은 1.2:1(밝은 테마)과 1.3:1(어두운 테마)이며, 밝은 테마의 시리즈 색 여덟 개 중 네 개는 흰색 위에서 3:1 미만이고, 제품이 텍스트에 사용하는 밝은 강조 색은 흰색 위에서 4.4:1입니다. 고대비 테마는 대비 기준을 충족하며, 개발자가 색을 선택할 수 있습니다.
• 기본 밝은 테마와 어두운 테마에서 차트 시리즈, 플래너 범주, 그리드 서식 규칙은 개발자가 마커, 파선 패턴, 데이터 레이블, 텍스트를 추가하지 않으면 색으로 구분됩니다. 같은 정보는 항상 텍스트로 보조 기술에 노출됩니다.
• 차트 툴팁과 십자선 레이블은 포인터 또는 포커스된 포인트를 따라다니며 그 위에 마우스를 올릴 수 없습니다. 그 값은 포커스된 포인트의 값으로도 노출됩니다.
• UI Automation Text 패턴(편집기와 다이어그램 레이블 안의 텍스트 특성, 캐럿, 선택 영역)은 구현되지 않았습니다. 텍스트는 이름과 값으로 노출되며, VCL 텍스트 편집기는 자체 텍스트를 노출하는 네이티브 편집 컨트롤을 포함합니다.
• 별도의 레이블 컨트롤에 대한 LabeledBy 관계는 노출되지 않습니다. 대신 컨트롤의 접근성 이름을 설정하세요.
• 시스템 텍스트 크기 설정은 애플리케이션이 이를 컴포넌트의 글꼴에 매핑하는 경우에만 적용됩니다.
• sgcMaps: 지도 이미지는 중심과 확대/축소 수준으로만 설명되며, 지도 이미지가 제공자의 타일 이미지이기 때문에 지도 렌더러는 고대비를 따르지 않습니다.
• 인쇄와 PDF 내보내기의 대체 텍스트는 기본 접근성 설명과 같은 생성기에서 만들어집니다. 애플리케이션이 설정한 접근성 설명은 내보내기에서 사용되지 않습니다.
• Avalonia 12에는 Grid 및 Table 패턴이 없으므로 sgcGrid와 sgcPivotGrid는 표 관계 대신 각 셀의 이름과 도움말 텍스트에 열 머리글과 위치를 제공합니다. NVDA로 Avalonia의 제한이 두 가지 더 확인되었습니다. NVDA의 기본(선택적) UI Automation 이벤트 등록에서는 Avalonia 창이 GetFocusedElement에 항목이 아니라 컨트롤을 반환하므로 sgcUI 컨트롤 안의 항목 상태 변경이 알려지지 않습니다. 또한 Avalonia에는 UI Automation 알림 이벤트가 없으므로 라이브 알림은 Avalonia에서 알려지지 않습니다. 해결 방법: NVDA 설정의 고급에서 "Registration for UI Automation events and property changes"를 Global로 설정하십시오. 그러면 항목 상태 변경은 알려지지만 라이브 알림은 알려지지 않습니다.
• 도움말은 제목과 대체 텍스트를 갖춘 HTML 페이지, CHM, PDF로 게시되며 WCAG 2.1 AA 기준의 감사를 받지 않았습니다.

컨트롤을 화면 읽기 프로그램, 키보드, 대비 설정으로 사용하기 어렵거나 다른 형식의 보고서가 필요하면 info@esegece.com으로 문의하세요. 제품, 플랫폼, 버전, 사용 중인 보조 기술을 알려 주시면 확인하겠습니다.

이 성명서는 2026년 10월에 sgcUI 2026.10을 기준으로 작성되었습니다. Avalonia 결과는 2026년 10월 12일에 Avalonia 12.1.4로 다시 테스트되었습니다.

접근성 도움말 항목 읽기