Slider 컨트롤 형식Slider Control Type

이 항목에서는 Slider 컨트롤 형식에 대 한 Microsoft UI 자동화 지원 정보를 제공 합니다.This topic provides information about Microsoft UI Automation support for the Slider control type.

슬라이더 컨트롤은 사용자가 숫자 범위를 설정 하거나 항목 집합에서 선택할 수 있도록 하는 단추가 있는 복합 컨트롤입니다.A slider control is a composite control with buttons that enable a user to set a numerical range or select from a set of items.

다음 섹션에서는 Slider 컨트롤 형식에 필요한 UI 자동화 트리 구조, 속성, 컨트롤 패턴, 이벤트를 정의 합니다.The following sections define the required UI Automation tree structure, properties, control patterns, and events for the Slider control type. Ui 자동화 요구 사항은 UI 프레임 워크/플랫폼이 컨트롤 형식 및 컨트롤 패턴에 대 한 UI 자동화 지원을 통합 하는 모든 슬라이더 컨트롤에 적용 됩니다.The UI Automation requirements apply to all slider controls where the UI framework/platform integrates UI Automation support for control types and control patterns.

이 항목에는 다음과 같은 섹션이 포함되어 있습니다.This topic contains the following sections.

일반적인 트리 구조Typical Tree Structure

다음 표는 슬라이더 컨트롤과 관련 된 UI 자동화 트리의 일반적인 컨트롤 및 콘텐츠 뷰를 보여주고 각 뷰에 포함 될 수 있는 내용에 대해 설명 합니다.The following table depicts a typical control and content view of the UI Automation tree that pertains to slider controls and describes what can be contained in each view. UI 자동화 트리에 대 한 자세한 내용은 Ui 자동화 트리 개요를 참조 하세요.For more information about the UI Automation tree, see UI Automation Tree Overview.

컨트롤 뷰Control View 콘텐츠 뷰Content View
  • 슬라이더Slider
    • Button(2 또는 4개)Button (2 or 4)
    • Thumb (1)Thumb (1)
    • 목록 항목 (0 개 이상)List Item (0 or more)
  • 슬라이더Slider
    • 목록 항목 (0 개 이상)List Item (0 or more)

 

관련 속성Relevant Properties

다음 표에서는 값 또는 정의가 슬라이더 컨트롤과 특별히 관련 된 UI 자동화 속성을 나열 하 여 보여 줍니다.The following table lists the UI Automation properties whose value or definition is especially relevant to slider controls. UI 자동화 속성에 대 한 자세한 내용은 Ui 자동화 요소에서 속성 검색을 참조 하세요.For more information about UI Automation properties, see Retrieving Properties from UI Automation Elements.

UI 자동화 속성UI Automation Property Value 메모Notes
UIA _ AutomationIdPropertyIdUIA_AutomationIdPropertyId 메모를 참조하세요.See notes. 이 속성의 값은 UI 자동화 트리의 raw 뷰에서 모든 피어 요소 간에 고유 해야 합니다.The value of this property must be unique among all peer elements in the raw view of the UI Automation tree.
UIA _ BoundingRectanglePropertyIdUIA_BoundingRectanglePropertyId 메모를 참조하세요.See notes. 전체 컨트롤이 포함된 가장 바깥쪽 사각형입니다.The outermost rectangle that contains the whole control.
UIA _ ClickablePointPropertyIdUIA_ClickablePointPropertyId 메모를 참조하세요.See notes. 슬라이더 컨트롤의 전체 경계 사각형은 자식 컨트롤이 차지 하기 때문에 대부분의 슬라이더 컨트롤은 UIA _ E _ no클릭 ablepoint 오류를 반환 해야 합니다.The majority of slider controls must return the UIA_E_NOCLICKABLEPOINT error because the entire bounding rectangle of the slider control is occupied by child controls.
UIA _ ControlTypePropertyIdUIA_ControlTypePropertyId 슬라이더Slider 이 값은 모든 프레임워크에 대해 동일합니다.This value is the same for all frameworks.
UIA _ IsContentElementPropertyIdUIA_IsContentElementPropertyId TRUETRUE 슬라이더 컨트롤은 UI 자동화 트리의 콘텐츠 뷰에 항상 포함 됩니다.The slider control is always included in the content view of the UI Automation tree.
UIA _ IsControlElementPropertyIdUIA_IsControlElementPropertyId TRUETRUE 슬라이더 컨트롤은 UI 자동화 트리의 컨트롤 뷰에 항상 포함 됩니다.The slider control is always included in the control view of the UI Automation tree.
UIA _ IsKeyboardFocusablePropertyIdUIA_IsKeyboardFocusablePropertyId 메모를 참조하세요.See notes. 컨트롤이 키보드 포커스를 받을 수 있으면 해당 컨트롤은 이 속성을 지원해야 합니다.If the control can receive keyboard focus, it must support this property. 슬라이더 컨트롤의 자식 (단추 및 엄지 단추)은 포커스를 받지 않아야 합니다.The children (buttons and thumb) of a slider control should never take the focus. 포커스는 항상 slider 컨트롤 자체에 남아 있어야 합니다.The focus should always remain on the slider control itself.
UIA _ LabeledByPropertyIdUIA_LabeledByPropertyId 메모를 참조하세요.See notes. 컨트롤과 연결 된 정적 텍스트 레이블이 있는 경우이 속성은 해당 컨트롤에 대 한 참조를 노출 해야 합니다.If there is a static text label associated with the control, this property must expose a reference to that control. 텍스트 컨트롤이 다른 컨트롤의 하위 구성 요소인 경우 있으면 labeledby 속성이 설정 되지 않습니다.If the text control is a subcomponent of another control, it will not have a LabeledBy property set.
UIA _ LocalizedControlTypePropertyIdUIA_LocalizedControlTypePropertyId 메모를 참조하세요.See notes. Slider 컨트롤 형식에 해당 하는 지역화 된 문자열입니다.Localized string corresponding to the Slider control type. 기본값은 en-us 또는 영어 (미국)의 경우 "slider"입니다.The default value is "slider" for en-US or English (United States).
UIA _ NamePropertyIdUIA_NamePropertyId 메모를 참조하세요.See notes. 슬라이더 컨트롤의 이름은 일반적으로 정적 텍스트 레이블에서 생성 됩니다.The name of the slider control is typically generated from a static text label. 정적 텍스트 레이블이 없는 경우 응용 프로그램 개발자가 이름 에 대 한 속성 값을 할당 해야 합니다.If there is not a static text label, a property value for Name must be assigned by the application developer.

 

필수 컨트롤 패턴Required Control Patterns

다음 표에서는 모든 슬라이더 컨트롤에서 지원 되는 데 필요한 UI 자동화 컨트롤 패턴을 나열 하 여 보여줍니다.The following table lists the UI Automation control patterns required to be supported by all slider controls. 컨트롤 패턴에 대한 자세한 내용은 UI Automation Control Patterns Overview를 참조하세요.For more information on control patterns, see UI Automation Control Patterns Overview.

컨트롤 패턴/패턴 속성Control Pattern/Pattern Property 지원/값Support/Value 메모Notes
IRangeValueProviderIRangeValueProvider 개체Depends 콘텐츠를 숫자 범위 내에 있는 값으로 설정할 수 있는 경우 슬라이더는 범위 컨트롤 패턴을 지원 해야 합니다.A slider should support the RangeValue control pattern if the content can be set to a value within a numerical range.
ISelectionProviderISelectionProvider 개체Depends 콘텐츠가 불연속 옵션 집합 중 하나의 값을 나타내는 경우 슬라이더는 Selection 컨트롤 패턴을 지원 해야 합니다.A slider should support the Selection control pattern if the content represents one value among a discrete set of options. Selection 컨트롤 패턴이 지원되면 해당 선택은 슬라이더의 자식 목록 항목 중 하나 이상으로 노출되어야 합니다.When the Selection control pattern is supported, the corresponding selection must be exposed as one or more child list items of the slider.
IValueProviderIValueProvider 개체Depends 내용이 불연속 옵션 집합의 값 중 하나를 나타내는 경우 슬라이더는 value 컨트롤 패턴을 지원 해야 합니다.A slider should support the Value control pattern if the content represents one value among a discrete set of options.

 

필요한 이벤트Required Events

다음 표에서는 슬라이더 컨트롤이를 지 원하는 데 필요한 UI 자동화 이벤트를 보여 줍니다.The following table lists the UI Automation events that slider controls are required to support. 이벤트에 대한 자세한 내용은 UI Automation Events Overview를 참조하세요.For more information on events, see UI Automation Events Overview.

UI 자동화 이벤트UI Automation Event 메모Notes
UIA _ AutomationFocusChangedEventIdUIA_AutomationFocusChangedEventId
UIA _ BoundingRectanglePropertyId 속성 변경 이벤트입니다.UIA_BoundingRectanglePropertyId property-changed event.
UIA _ IsEnabledPropertyId 속성 변경 이벤트입니다.UIA_IsEnabledPropertyId property-changed event. 컨트롤에서 IsEnabled 속성을 지 원하는 경우이 이벤트를 지원 해야 합니다.If the control supports the IsEnabled property, it must support this event.
UIA _ IsOffscreenPropertyId 속성 변경 이벤트입니다.UIA_IsOffscreenPropertyId property-changed event. 컨트롤에서 IsOffscreen 속성을 지 원하는 경우이 이벤트를 지원 해야 합니다.If the control supports the IsOffscreen property, it must support this event.
UIA _ RangeValueValuePropertyId 속성 변경 이벤트입니다.UIA_RangeValueValuePropertyId property-changed event. 컨트롤이 범위 컨트롤 패턴을 지 원하는 경우이 이벤트를 지원 해야 합니다.If the control supports the RangeValue control pattern, it must support this event.
UIA _ Selection _ InvalidatedEventIdUIA_Selection_InvalidatedEventId 컨트롤이 Selection 컨트롤 패턴을 지 원하는 경우이 이벤트를 지원 해야 합니다.If the control supports the Selection control pattern, it must support this event.
UIA _ StructureChangedEventIdUIA_StructureChangedEventId
UIA _ ValueValuePropertyId 속성 변경 이벤트입니다.UIA_ValueValuePropertyId property-changed event. 컨트롤에서 Value 컨트롤 패턴을 지 원하는 경우이 이벤트를 지원 해야 합니다.If the control supports the Value control pattern, it must support this event.

 

설계Conceptual

UI 자동화 컨트롤 형식 개요UI Automation Control Types Overview

UI 자동화 개요UI Automation Overview