다음을 통해 공유

스크롤 컨트롤 패턴

  • 아티클

속성 및 메서드에 대한 정보를 포함하여 IScrollProvider를 구현하기 위한 지침 및 규칙을 설명합니다. 스크롤 컨트롤 패턴은 자식 개체 컬렉션에 대해 스크롤 가능한 컨테이너 역할을 하는 컨트롤을 지원하는 데 사용됩니다.

컨트롤은 스크롤 막대를 사용하여 스크롤 기능을 지원할 필요는 없지만 일반적으로는 지원합니다. 다음 이미지는 스크롤 막대를 사용하지 않는 스크롤 컨트롤을 보여줍니다. 이 컨트롤 패턴을 구현하는 컨트롤의 예는 컨트롤 형식 및 지원되는 컨트롤 패턴을 참조하세요.

스크롤 막대가 없는 스크롤 컨트롤을 보여 주는 스크린샷

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

구현 지침 및 규칙

스크롤 컨트롤 패턴을 구현할 때 다음 지침 및 규칙을 확인합니다.

  • 이 컨트롤의 자식은 IScrollItemProvider를 구현해야 합니다.
  • 컨테이너 컨트롤의 스크롤 막대는 스크롤 컨트롤 패턴을 지원하지 않습니다. 대신 RangeValue 컨트롤 패턴을 지원해야 합니다.
  • 스크롤이 백분율로 측정되면, 스크롤 눈금과 관련된 모든 값 또는 양은 0에서 100까지의 범위로 정규화되어야 합니다.
  • IScrollProvider::HorizontallyScrollable 속성 및 VerticallyScrollable 속성은 IsEnabled 속성과 독립적입니다.
  • IScrollProvider::HorizontallyScrollable 속성이 FALSE이면 HorizontalViewSize 속성을 100(100%)으로 설정하고 HorizontalScrollPercent 속성을 UIA_ScrollPatternNoScroll(-1)로 설정해야 합니다. 마찬가지로 VerticallyScrollable 속성이 FALSE이면 VerticalViewSize 속성을 100(100%)으로 설정하고 VerticalScrollPercent 속성을 UIA_ScrollPatternNoScroll (-1)로 설정해야 합니다. 이렇게 하면 Microsoft UI 자동화 클라이언트가 스크롤에 관심이 없는 방향이 활성화되는 경우 경합 상태를 피하면서 SetScrollPercent 메서드 내에서 이러한 속성 값을 사용할 수 있습니다.
  • IScrollProvider::HorizontalScrollPercent 속성은 로캘에 따라 다릅니다. HorizontalScrollPercent를 100으로 설정하려면 컨트롤의 스크롤 위치를 왼쪽에서 오른쪽으로 읽는 영어와 같은 언어의 가장 오른쪽 위치에 해당하는 위치로 설정해야 합니다. 또는 오른쪽에서 왼쪽으로 읽는 아랍어와 같은 언어의 경우 HorizontalScrollPercent 를 100으로 설정하려면 스크롤 위치를 가장 왼쪽 위치로 설정해야 합니다.

IScrollProvider에 필요한 멤버

IScrollProvider 인터페이스를 구현하려면 다음 속성과 메서드가 필요합니다.

필요한 멤버 멤버 형식 참고
HorizontalScrollPercent 속성 없음
VerticalScrollPercent 속성 없음
HorizontalViewSize 속성 없음
VerticalViewSize 속성 없음
HorizontallyScrollable 속성 없음
VerticallyScrollable 속성 없음
스크롤 방법 없음
SetScrollPercent 방법 없음

 

이 컨트롤 패턴에 연결된 이벤트가 없습니다.

컨트롤 형식 및 해당 지원되는 컨트롤 패턴

UI 자동화 컨트롤 패턴 개요

UI 자동화 트리 개요