다음을 통해 공유

탭 컨트롤 유형

  • 아티클

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

탭 컨트롤은 노트북의 구분선 또는 파일 캐비닛의 레이블과 유사합니다. 애플리케이션은 탭 컨트롤을 사용하여 창 또는 대화 상자의 동일한 영역에 대해 여러 페이지를 정의할 수 있습니다.

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

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

일반적인 트리 구조

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

컨트롤 뷰 콘텐츠 뷰
  • 탭
    • TabItem(1개 이상)
    • ScrollBar(0 또는 1개)
      • Button(0 또는 2개)
  • 탭
    • TabItem(1개 이상)

 

Tab 컨트롤에는 TabItem 컨트롤 형식에 따라 자식 UI 자동화 요소가 있습니다. 탭 항목이 그룹화되면(예: Microsoft Office 응용 프로그램에서와 같이) Tab 컨트롤 형식은 다음 트리 구조와 같이 그룹화된 탭 항목에 대한 그룹 컨트롤 형식을 호스트할 수도 있습니다.

컨트롤 뷰 콘텐츠 뷰
  • 탭
    • TabItem(1개 이상)
    • Group(0개 이상)
      • TabItem(0개 이상)
    • ScrollBar(0 또는 1개)
      • Button(0 또는 2개)
  • 탭
    • TabItem(1개 이상)
    • Group(0개 이상)
      • TabItem(0개 이상)

 

관련 속성

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

UI 자동화 속성 값 참고
UIA_AutomationIdPropertyId 메모를 참조하세요. 이 속성의 값은 UI 자동화 트리의 원시 뷰에 있는 모든 피어 요소에서 고유해야 합니다.
UIA_BoundingRectanglePropertyId 메모를 참조하세요. 전체 컨트롤이 포함된 가장 바깥쪽 사각형입니다.
UIA_ClickablePointPropertyId No 탭 컨트롤에 클릭 가능한 점이 없습니다.
UIA_ControlTypePropertyId Tab
UIA_IsContentElementPropertyId TRUE Tab 컨트롤이 UI 자동화 트리의 콘텐츠 뷰에 항상 포함됩니다.
UIA_IsControlElementPropertyId TRUE Tab 컨트롤이 UI 자동화 트리의 컨트롤 뷰에 항상 포함됩니다.
UIA_IsKeyboardFocusablePropertyId TRUE Tab 컨트롤 형식은 키보드 포커스를 받을 수 있어야 합니다. 일반적으로 UI 자동화 클라이언트는 탭 컨트롤에서 IUIAutomationElement::SetFocus를 호출하고 해당 항목 중 하나는 키보드 포커스를 탭 컨트롤로 전달합니다. 포커스가 항목 중 하나로 설정되지 않아도 일부 탭 컨테이너에서 포커스를 받을 수 있습니다.
UIA_LabeledByPropertyId 메모를 참조하세요. 탭 컨트롤에는 일반적으로 이 속성을 통해 노출되는 정적 텍스트 레이블이 있습니다.
UIA_LocalizedControlTypePropertyId 메모를 참조하세요. Tab 컨트롤 형식에 해당하는 지역화된 문자열입니다. 기본값은 en-US 또는 영어(미국)의 경우 "tab"입니다.
UIA_NamePropertyId 메모를 참조하세요. 탭 컨트롤에는 Name 속성이 거의 필요하지 않습니다.
UIA_OrientationPropertyId 메모를 참조하세요. 탭 컨트롤은 항상 가로 또는 세로로 배치되어 있는지 나타내야 합니다.

 

필수 컨트롤 패턴

다음 표에서는 모든 Tab 컨트롤에서 지원되는 데 필요한 UI 자동화 컨트롤 패턴을 나열하여 보여 줍니다. 컨트롤 패턴에 대한 자세한 내용은 UI Automation Control Patterns Overview를 참조하세요.

컨트롤 패턴/패턴 속성 지원/값 참고
ISelectionProvider 필수 모든 탭 컨트롤은 선택 컨트롤 패턴을 지원해야 합니다.
IsSelectionRequired TRUE 탭 컨트롤에 항상 선택 항목이 있어야 합니다.
CanSelectMultiple FALSE 탭 컨트롤은 항상 단일 선택 컨테이너입니다.
IScrollProvider 개체 탭 컨트롤에 탭 항목 집합을 스크롤할 수 있는 위젯이 있는 경우 스크롤 컨트롤 패턴을 지원해야 합니다.

 

필요한 이벤트

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

UI 자동화 이벤트 참고
UIA_AutomationFocusChangedEventId
속성 변경 이벤트를 UIA_BoundingRectanglePropertyId.
속성 변경 이벤트를 UIA_IsEnabledPropertyId. 컨트롤이 IsEnabled 속성을 지원하는 경우 이 이벤트를 지원해야 합니다.
속성 변경 이벤트를 UIA_IsOffscreenPropertyId. 컨트롤이 IsOffscreen 속성을 지원하는 경우 이 이벤트를 지원해야 합니다.
속성 변경 이벤트를 UIA_ScrollHorizontallyScrollablePropertyId. 컨트롤이 스크롤 컨트롤 패턴을 지원하는 경우 이 이벤트를 지원해야 합니다.
속성 변경 이벤트를 UIA_ScrollHorizontalScrollPercentPropertyId. 컨트롤이 스크롤 컨트롤 패턴을 지원하는 경우 이 이벤트를 지원해야 합니다.
속성 변경 이벤트를 UIA_ScrollHorizontalViewSizePropertyId. 컨트롤이 스크롤 컨트롤 패턴을 지원하는 경우 이 이벤트를 지원해야 합니다.
속성 변경 이벤트를 UIA_ScrollVerticallyScrollablePropertyId. 컨트롤이 스크롤 컨트롤 패턴을 지원하는 경우 이 이벤트를 지원해야 합니다.
속성 변경 이벤트를 UIA_ScrollVerticalScrollPercentPropertyId. 컨트롤이 스크롤 컨트롤 패턴을 지원하는 경우 이 이벤트를 지원해야 합니다.
속성 변경 이벤트를 UIA_ScrollVerticalViewSizePropertyId. 컨트롤이 스크롤 컨트롤 패턴을 지원하는 경우 이 이벤트를 지원해야 합니다.
UIA_StructureChangedEventId

 

개념

UI 자동화 컨트롤 형식 개요

UI 자동화 개요