다음을 통해 공유


SemanticZoom 컨트롤 형식

이 항목에서는 SemanticZoom 컨트롤 형식에 대한 UI 자동화 지원에 대한 정보를 제공합니다.

의미 체계 확대/축소는 사진 앨범, 앱 목록 또는 주소록과 같은 단일 보기 내에서 대규모 관련 데이터 또는 콘텐츠 집합을 표시하고 탐색하기 위해 Windows 8에서 도입된 기술입니다. 의미 체계 확대/축소는 콘텐츠를 구성하고 표시하기 위해 분류 또는 확대/축소 수준의 두 가지 고유 모드를 사용합니다. 하위 수준(또는 확대) 모드는 항목을 평평한 "올업" 구조로 표시합니다. 상위 수준(또는 축소) 모드는 그룹에 항목을 표시하므로 사용자가 콘텐츠를 빠르게 탐색하고 탐색할 수 있습니다. 예를 들어 도시 목록을 확대/축소하면 해당 도시가 포함된 주 목록으로 변경될 수 있습니다. 프로그램 목록을 확대/축소하면 논리 프로그램 그룹 목록으로 변경될 수 있습니다.

특히 Windows 스토어 앱에 사용되는 의미 체계 확대/축소에 대한 자세한 내용은 의미 체계 확대/축소에 대한 지침을 참조하세요.

SemanticZoom 컨트롤 형식의 사용 모델은 프로그래밍 방식 액세스를 위해 주로 존재한다는 측면에서 비정상적입니다. Microsoft UI 자동화 클라이언트는 의미 체계 확대/축소 컨트롤을 모니터링하고 조작하여 목록의 확대 상태를 제어할 수 있습니다. 보조 기술을 사용하지 않는 사용자는 일반적으로 터치 제스처 또는 바로 가기 키를 통해 의미 체계 확대/축소 컨트롤을 직접 조작합니다.

다음 섹션에서는 SemanticZoom 컨트롤 형식에 필요한 UI 자동화 트리 구조, 속성, 컨트롤 패턴 및 이벤트를 정의합니다. UI 자동화 요구 사항은 UI 프레임워크/플랫폼이 컨트롤 형식 및 컨트롤 패턴에 대한 UI 자동화 지원을 통합하는 모든 의미 체계 Zoom 컨트롤에 적용됩니다.

이 항목에는 다음과 같은 섹션이 포함되어 있습니다.

일반적인 트리 구조

다음 표에서는 SemanticZoom 컨트롤 형식과 관련된 UI 자동화 트리의 일반적인 컨트롤 및 콘텐츠 뷰를 설명하고 각 보기에 포함될 수 있는 내용을 설명합니다. UI 자동화 트리에 대한 자세한 내용은 UI 자동화 트리 개요를 참조하세요.

컨트롤 뷰 콘텐츠 뷰
  • 목록
    • [SemanticZoom]
      • ListItem(0개 이상)
  • 목록
    • ListItem(0개 이상)

또는

컨트롤 뷰 콘텐츠 뷰
  • [SemanticZoom]
    • 목록
      • ListItem(0개 이상)
  • 목록
    • ListItem(0개 이상)

관련 속성

다음 표에서는 값 또는 정의가 SemanticZoom 컨트롤 형식을 구현하는 컨트롤과 특히 관련된 UI 자동화 속성을 나열합니다. UI 자동화 속성에 대한 자세한 내용은 UI 자동화 요소에서 속성 검색을 참조하세요.

UI 자동화 속성 참고
UIA_AutomationIdPropertyId 메모를 참조하세요. 이 속성의 값은 UI 자동화 트리의 원시 뷰에 있는 모든 피어 요소에서 고유해야 합니다.
UIA_BoundingRectanglePropertyId 메모를 참조하세요. 전체 컨트롤이 포함된 가장 바깥쪽 사각형입니다.
UIA_ClickablePointPropertyId 메모를 참조하세요. 목록 컨트롤에 클릭 가능한 점(목록에 포커스를 두도록 클릭할 수 있는 점)이 있는 경우 해당 지점은 이 속성을 통해 노출되어야 합니다. UIA_IsOffscreenPropertyId 속성의 값이 TRUE이면 이 속성을 검색하려고 하면 UIA_E_NOCLICKABLEPOINT 오류가 발생합니다.
UIA_ControlTypePropertyId SemanticZoom
UIA_IsContentElementPropertyId TRUE
UIA_IsControlElementPropertyId TRUE
UIA_IsKeyboardFocusablePropertyId FALSE
UIA_LabeledByPropertyId 메모를 참조하세요. 정적 텍스트 레이블이 있는 경우 이 속성은 해당 컨트롤에 대한 참조를 노출해야 합니다.
UIA_LocalizedControlTypePropertyId 메모를 참조하세요. SemanticZoom 컨트롤 형식에 해당하는 지역화된 문자열입니다. 기본값은 en-US 또는 영어(미국)의 "의미 체계 확대/축소"입니다. 참고: 일부 프레임워크는 이를 "의미 체계"로 연결했습니다.
UIA_NamePropertyId 메모를 참조하세요. 빈 문자열이 허용되거나 의미 체계 확대/축소라는 용어가 포함되어 있지 않으면 컨트롤 형식과 이름의 조합이 혼동되는 더 유용한 이름을 제공할 수 있습니다.

필수 컨트롤 패턴 및 속성

다음 표에서는 모든 의미 체계 확대/축소 컨트롤에서 지원하는 데 필요한 UI 자동화 컨트롤 패턴을 나열합니다. 컨트롤 패턴에 대한 자세한 내용은 UI Automation Control Patterns Overview를 참조하세요.

컨트롤 패턴/패턴 속성 지원/값 참고
IToggleProvider 개체 의미 체계 확대/축소 컨트롤은 확대/축소를 사용하거나 사용하지 않도록 설정할 수 있도록 토글 컨트롤 패턴을 지원합니다. ToggleState_Off 플랫, 올업 상태에 해당하며 , ToggleState_On 상위 수준 축소 보기에 해당합니다.

필요한 이벤트

다음 표에서는 의미 체계 Zoom 컨트롤이 지원하는 데 필요한 UI 자동화 이벤트를 나열합니다. 이벤트에 대한 자세한 내용은 UI Automation Events Overview를 참조하세요.

UI 자동화 이벤트 참고
속성 변경 이벤트를 UIA_BoundingRectanglePropertyId.
속성 변경 이벤트를 UIA_IsEnabledPropertyId. 컨트롤이 IsEnabled 속성을 지원하는 경우 이 이벤트를 지원해야 합니다.
속성 변경 이벤트를 UIA_IsOffscreenPropertyId. 컨트롤이 IsOffscreen 속성을 지원하는 경우 이 이벤트를 지원해야 합니다.
속성 변경 이벤트를 UIA_ToggleToggleStatePropertyId.

설명

UI에 시맨틱 확대/축소 컨트롤 동작을 토글하는 단추가 표시되는 경우 이 단추에는 SemanticZoom 컨트롤 형식이 없어야 합니다. 이는 직관적이지 않지만 SemanticZoom 컨트롤 형식은 확대/축소를 제어하는 단추가 아니라 확대/축소 콘텐츠의 컨테이너를 특징으로 합니다. (이러한 단추는 토글 컨트롤 패턴이 있는 단추 컨트롤 형식으로 간단하게 나타낼 수 있습니다.)

UI 자동화 컨트롤 형식 개요

UI 자동화 개요