접근성 도구 - 검사

아티클
10/24/2023

Important

검사는 레거시 도구입니다. 대신 접근성 인사이트를 사용하는 것이 좋습니다.

검사(Inspect.exe)는 UI 요소를 선택하고 접근성 데이터를 볼 수 있는 Windows 기반 도구입니다. Microsoft UI 자동화 속성과 컨트롤 패턴 및 MSAA(Microsoft Active Accessibility) 속성을 모두 볼 수 있습니다. 또한 검사에서는 UI 자동화 트리의 자동화 요소 탐색 구조와 Microsoft Active Accessibility 계층 구조의 액세스 가능한 개체를 테스트할 수 있습니다.

요구 사항

UI 자동화 검사하려면 시스템에 UI 자동화 있어야 합니다. 자세한 내용은 런타임 요구 사항을 참조 하세요.

검사 기능은 이 섹션에 설명된 모든 접근성 관련 도구를 포함하는 Windows SDK(소프트웨어 개발 키트)의 도구 중 하나로 설치됩니다. 별도의 다운로드로 배포되지 않습니다.

Windows SDK를 다운로드합니다.

참고 항목

이전 버전의 Windows SDK는 Windows SDK 및 에뮬레이터 보관 파일을 참조 하세요.

Inspect.exe는 SDK 설치 경로의 \bin\<version>\<platform> 폴더에 있습니다. 일반적으로 관리자 권한으로 실행할 필요가 없습니다.

검사 창

검사 창에는 다음과 같은 여러 기본 부분이 있습니다.

제목 표시줄. HWND(검사 창 핸들)를 표시합니다.
메뉴 모음. 검사 기능에 대한 액세스를 제공합니다.
도구 모음. 검사 기능에 대한 액세스를 제공합니다.
트리 보기. UI 요소의 계층 구조를 요소 간에 탐색하는 데 사용할 수 있는 트리 뷰 컨트롤로 표시합니다.
데이터 보기. 선택한 UI 요소에 대해 노출된 모든 접근성 속성을 표시합니다.

메뉴 모음에서 사용할 수 있는 명령은 도구 모음에서도 사용할 수 있습니다. 다음 이미지는 메모장 편집 메뉴 요소의 UI 자동화 속성을 쿼리하는 검사를 보여줍니다.

Screenshot that shows the user interface of the Inspect tool.

검사 사용

검사를 시작하면 트리 뷰는 요소 계층 구조에서 현재 선택한 UI 요소의 위치를 표시하고 데이터 뷰는 선택한 UI 요소에 대한 속성 정보를 표시합니다. UI를 탐색하여 UI의 모든 요소에 대한 접근성 정보를 볼 수 있습니다. 기본적으로 검사에서는 키보드 또는 마우스 포커스를 추적합니다. 포커스가 변경되면 데이터 뷰가 포커스가 있는 요소의 속성 정보로 업데이트됩니다.

UI 요소 간을 탐색하려면 다음 요소 중 하나라도 사용할 수 있습니다.

마우스입니다.
키보드입니다.
트리 뷰의 트리 뷰 컨트롤입니다.
탐색 메뉴의 탐색 옵션입니다.
도구 모음의 탐색 옵션입니다.

마지막 세 가지 옵션을 사용하면 UI의 트리 계층 구조를 탐색할 수 있습니다. 이 트리의 구조는 UI 자동화 Microsoft Active Accessibility 모드 간에 약간 다를 수 있습니다.

접근성 속성 정보 확인

데이터 뷰에는 현재 선택된 UI 요소의 속성 정보가 표시됩니다. 모든 접근성 속성 또는 해당 속성의 하위 집합에 대한 정보를 표시하도록 검사를 구성할 수 있습니다. 검사 창이 다른 사용자 인터페이스 위에 다시 표시되는지기본 검사에서 선택한 요소 주위의 경계 사각형을 강조 표시하는지 여부와 같은 다른 보기 옵션을 지정할 수도 있습니다.

원하는 방식으로 작동하도록 검사를 구성한 후 UI 요소 간 탐색 및 속성 정보 보기를 시작합니다. 검사에서는 구성 설정이 닫히면 저장하고 이를 사용하여 다음 검사 세션을 초기화합니다.

속성 설정을 구성하려면 다음 단계를 수행합니다.

옵션 메뉴에서 설정 선택하거나 도구 모음에서 설정 대화 상자 표시를 선택합니다.
주 창의 표시 목록에서 검사의 데이터 보기에 표시할 속성을 선택합니다.
정보 도구 설명의 표시 목록에서 도구 설명에 표시할 속성을 선택합니다.
UI 요소가 지원하지 않는 속성을 보려면 지원되지 않는 속성 표시를 선택합니다.
확인을 선택하여 변경 내용을 저장합니다.

보기 옵션을 구성하려면 옵션 메뉴 또는 도구 모음에서 다음 보기 옵션을 선택할 수 있습니다.

이 옵션을 선택한 경우	검사 에서 이 작업을 수행합니다.
항상 위	화면의 다른 창 위에 나타납니다.
MSAA 모드	Microsoft Active Accessibility 속성 정보를 표시합니다.
UI 자동화 모드	UI 자동화 속성 정보를 표시합니다.
표시되는 Windows 전용 보기	MSAA 모드에서만 사용할 수 있습니다.
Raw 뷰	트리 뷰에서 UI 자동화 트리 또는 MSAA 트리의 원시 뷰를 표시합니다.
컨트롤 뷰	트리 뷰에서 UI 자동화 트리의 컨트롤 뷰를 표시합니다. UI 자동화 모드에서만 사용할 수 있습니다.
콘텐츠 뷰	트리 뷰에서 UI 자동화 트리의 콘텐츠 뷰를 표시합니다. UI 자동화 모드에서만 사용 가능
활성 가리키기 도구 모음	마우스 클릭을 요구하지 않고 마우스 가리키기에서 도구 모음 단추를 활성화합니다.
경고음 오류 발생	UI 자동화 또는 MSAA 작업 중에 오류가 감지되면 경고음이 울립니다.
SPI_SCREENREADER 플래그	화면 읽기 프로그램이 있다고 가정합니다. 이 옵션은 애플리케이션이 그래픽이 아닌 텍스트로 정보를 제공해야 했음을 나타냅니다. 화면 읽기 프로그램이 있기 때문에 이 플래그가 설정된다고 가정하면 안 됩니다.
강조 표시 사각형 표시	포커스가 있는 요소 주위의 사각형을 강조 표시합니다.
케어 강조 표시	캐리트를 강조 표시합니다. MSAA 모드에서만 사용할 수 있습니다.
정보 도구 설명 표시	도구 설명에 속성 정보를 표시합니다.
포커스 보기	키보드 포커스를 따릅니다. 이 옵션을 선택하면 비동기 포커스 이벤트 후크가 설치되고 포커스가 있는 요소의 왼쪽 위로 캐리트를 이동합니다. 이 작업을 수행하면 Inspect에서 약 1초 안에 해당 속성을 새로 고칩니다.
캐리트 보기	캐리트를 따릅니다. MSAA 모드에서만 사용할 수 있습니다.
커서 보기	커서를 따릅니다.
조사식 도구 설명	도구 설명을 따릅니다.
트리 표시	트리 뷰를 표시합니다.

Inspect를 사용하여 UI 요소를 선택하면 보조 기술 제품에 대해 요소가 올바른 Windows Automation 탐색을 노출하는지 확인할 수 있습니다.

접근성 탐색을 확인하려면 다음 단계를 수행합니다.

검사 및 테스트할 애플리케이션을 엽니다.
탐색을 시작할 UI 요소를 선택합니다.
데이터 뷰에서 요소가 올바른 탐색 관련 속성을 노출하는지 확인합니다.
도구 모음의 트리 보기, 탐색 메뉴 또는 탐색 단추를 사용하여 UI를 탐색하고 각 요소가 올바른 탐색 관련 속성을 노출하는지 확인합니다.

참고 항목

탐색 메뉴 옵션 및 탐색 도구 모음 단추는 선택한 요소가 트리에 있는 위치에 따라 변경됩니다.

UI 요소와 상호 작용

Windows Automation은 보조 기술 제품이 단추를 누르는 등 마우스나 키보드를 사용하는 것처럼 UI 요소와 상호 작용할 수 있도록 하는 메서드를 노출합니다. [작업 검사] 메뉴를 사용하면 테스터가 IUIAutomationInvokePattern::Invoke 메서드를 호출하는 것과 Invoke.Invoke 같이 요소에서 Windows Automation 메서드를 호출할 수 있습니다.

UI 요소와 상호 작용하려면 다음 단계를 수행합니다.

검사 및 테스트할 애플리케이션을 엽니다.
상호 작용할 UI 요소를 선택합니다.
작업 메뉴 또는 도구 모음에서 호출하려는 Windows Automation 메서드에 해당하는 작업을 선택합니다.

작업 메뉴에는 새로 고침 및 포커스 항목과 함께 UI 자동화 모드 또는 MSAA 모드 선택 여부에 따라 다른 항목이 포함됩니다. UI 자동화 모드에서 다른 항목은 현재 선택한 UI 요소에서 지원하는 컨트롤 패턴을 반영합니다. MSAA 모드에서 다른 항목은 항상 다음 작업으로 구성됩니다.

작업	설명
새로 고침	사용자 인터페이스를 새로 고칩니다. MSAA 및 UI 자동화 모드에서 사용할 수 있습니다.
기본 작업	요소에 대한 기본 작업을 수행합니다.
포커스	요소에 포커스를 설정합니다. MSAA 및 UI 자동화 모드에서 사용할 수 있습니다.
선택	요소를 선택합니다.
선택 영역 확장	선택한 첫 번째 요소와 현재 요소 사이의 모든 요소를 포함하도록 요소 선택을 확장합니다.
선택 영역에 추가	목록 항목과 같은 현재 요소를 선택합니다.
선택 영역에서 제거	선택 영역에서 현재 요소를 제거합니다.
SetAccValue	요소의 Microsoft Active Accessibility 값을 지정된 문자열로 설정합니다.
포커스가 있는 자식	현재 포커스가 있는 요소의 자식으로 이동합니다.
커서의 HitTest	마우스 커서로 지정된 요소의 자식으로 이동합니다.
Hittest...	HitTest 대화 상자를 엽니다.

바로 가기 키

검사에서 활성 애플리케이션이 아닌 경우에도 대부분의 메뉴 항목을 바로 가기 키로 호출할 수 있습니다. 바로 가기 키는 일부 애플리케이션과 충돌할 수 있습니다.

다음 바로 가기 키는 메뉴의 다양한 옵션을 활성화합니다.

이 옵션을 수행하려면	바로 가기 키
커서 아래에 있는 개체의 기본 동작을 호출합니다(기본 작업 수행). MSAA 모드에서만 사용할 수 있습니다.	Ctrl+Shift+F2
커서 아래의 개체를 선택합니다(선택). MSAA 모드에서만 사용할 수 있습니다.	Ctrl+Shift+F3
키보드 포커스를 커서(포커스) 아래의 개체로 설정합니다.	Ctrl+Shift+F4
커서 아래의 형제 개체에서 이전 형제 개체로 이동합니다. 이 명령은 컨테이너(이전 형제) 내의 개체로만 이동합니다.	Ctrl+Shift+F5
개체의 부모(부모)로 이동합니다.	Ctrl+Shift+F6
현재 개체의 첫 번째 자식(첫 번째 자식)으로 이동합니다.	Ctrl+Shift+F7
커서 아래의 형제 개체에서 다음 형제 개체로 이동합니다. 이 명령은 컨테이너(다음 형제) 내의 개체로만 이동합니다.	Ctrl+Shift+F8
현재 개체의 마지막 자식(마지막 자식)으로 이동합니다.	Ctrl+Shift+F9
마우스 커서 아래의 개체로 이동합니다(커서의 HitTest). MSAA 모드에서만 사용할 수 있습니다.	Ctrl+Shift+1
데이터 보기의 내용을 클립보드에 복사합니다(모두 복사).	Ctrl+Shift+4
데이터 뷰의 내용을 새로 고칩니다(새로 고침).	Ctrl+Shift+5
포커스가 있는 개체를 봅니다(포커스 보기).	Ctrl+Shift+6
커서가 위에 있는 형제 개체의 왼쪽(왼쪽)으로 이동합니다. MSAA 모드에서만 사용할 수 있습니다.	Ctrl+Shift+7
커서가 끝난 개체 위의 형제 개체로 이동합니다(위쪽). MSAA 모드에서만 사용할 수 있습니다.	Ctrl+Shift+8
커서가 위에 있는 개체 아래의 형제 개체로 이동합니다(아래쪽). MSAA 모드에서만 사용할 수 있습니다.	Ctrl+Shift+9
커서가 위에 있는 형제 개체의 오른쪽(오른쪽)으로 이동합니다. MSAA 모드에서만 사용할 수 있습니다.	Ctrl+Shift+0