다음을 통해 공유

스크롤 막대(MSAA UI 요소 참조)

  • 아티클

참고

이 항목에서는 MSAA UI 요소 참조를 위해 스크롤 막대 개체에 대해 설명합니다. 다양한 UI 프레임워크에서 스크롤 막대 개체를 만드는 방법은 여기에 설명되어 있지 않습니다. 사용 중인 UI 프레임워크에 대한 API 참조 설명서를 참조하세요.

 

스크롤 막대를 사용하면 사용자가 관련 창 또는 목록 상자에서 정보를 스크롤할 방향과 거리를 선택할 수 있습니다. 스크롤 막대의 창 클래스 이름은 "SCROLLBAR"입니다.

IAccessible 속성의 내용은 스크롤 막대가 세로 또는 가로인지 여부와 클라이언트에서 쿼리 중인 스크롤 막대의 다음 부분에 따라 달라집니다.

  • 스크롤 막대 자체
  • 위쪽 또는 오른쪽 화살표 단추
  • 아래쪽 또는 왼쪽 화살표 단추
  • 스크롤 상자(thumb)
  • 페이지 위쪽 또는 페이지 오른쪽 영역
  • 페이지 아래쪽 또는 페이지 왼쪽 영역

IAccessible 메서드

스크롤 막대는 다음 IAccessible 메서드를 지원합니다 .

  • accDoDefaultAction - 스크롤 막대 개체 자체와 스크롤 엄지손가락은 accDoDefaultAction 메서드를 지원하지 않습니다.

    세로 스크롤 막대의 다른 스크롤 막대 부분에 대해 accDoDefaultAction은 wParam이 다음 값으로 설정된 WM_VSCROLL 메시지와 함께 PostMessage를 호출합니다.

    단추/지역 Vaule
    위쪽 화살표 단추 SB_LINEUP
    아래쪽 화살표 단추 SB_LINEDOWN
    페이지 위로 영역 SB_PAGEUP
    페이지 아래쪽 영역 SB_PAGEDOWN

     

    가로 스크롤 막대의 다른 스크롤 막대 부분에 대해 accDoDefaultAction은 wParam이 다음 값으로 설정된 WM_HSCROLL 메시지와 함께 PostMessage를 호출합니다.

    단추/지역 값
    왼쪽 화살표 단추 SB_LINELEFT
    오른쪽 화살표 단추 SB_LINERIGHT
    페이지 왼쪽 영역 SB_PAGELEFT
    페이지 오른쪽 영역 SB_PAGERIGHT

     

  • accHitTest

  • accLocation

  • accNavigate

IAccessible 속성

스크롤 막대는 다음 IAccessible 속성을 지원합니다.

  • get_accChildCount - 스크롤 막대 개체의 ChildCount 속성은 5입니다. 다른 스크롤 막대 부분의 경우 ChildCount 속성은 0입니다.

  • get_accDefaultAction - 스크롤 막대 개체 자체와 스크롤 엄지손가락은 DefaultAction 속성을 지원하지 않습니다. 화살표 단추의 DefaultAction 속성과 스크롤 엄지 손가락의 양쪽에 있는 음영 처리된 영역은 "누르기"입니다.

  • get_accDescription - Description 속성은 쿼리되는 스크롤 막대의 부분에 따라 달라집니다.

    세로 스크롤 막대의 부분에는 다음과 같은 설명이 있습니다.

    부분 Description
    스크롤 막대 자체 "세로 보기 영역을 변경하는 데 사용됨"
    위쪽 화살표 단추 "세로 위치를 한 줄 위로 이동합니다."
    아래쪽 화살표 단추 "세로 위치를 한 줄 아래로 이동"
    스크롤 엄지손가락 "현재 세로 위치를 나타내며 끌어서 직접 변경할 수 있습니다."
    페이지 위로 영역 "세로 위치를 몇 줄 위로 이동"
    페이지 아래쪽 영역 "현재 세로 위치를 나타내며 끌어서 직접 변경할 수 있습니다."

     

    가로 스크롤 막대의 부분에는 다음과 같은 설명이 있습니다.

    부분 Description
    스크롤 막대 자체 "가로 보기 영역을 변경하는 데 사용됨"
    왼쪽 화살표 단추 "가로 위치를 한 열 왼쪽으로 이동"
    오른쪽 화살표 단추 '가로 위치를 한 열 오른쪽으로 이동합니다.'
    스크롤 엄지손가락 "현재 가로 위치를 나타내며 끌어서 직접 변경할 수 있습니다."
    페이지 왼쪽 영역 "가로 위치를 두 개의 열 왼쪽으로 이동"
    페이지 오른쪽 영역 "현재 세로 위치를 나타내며 끌어서 직접 변경할 수 있습니다."

     

  • get_accHelp

  • get_accHelpTopic

  • get_accName - Name 속성은 쿼리되는 스크롤 막대의 부분에 따라 달라집니다.

    세로 스크롤 막대의 부분에는 다음 이름이 있습니다.

    부분 속성
    스크롤 막대 창 "세로"
    위쪽 화살표 단추 "줄 바꿈"
    아래쪽 화살표 단추 "줄 아래로"
    스크롤 엄지손가락 "위치"
    페이지 위로 영역 "Page up"
    페이지 아래쪽 영역 "Page down"

     

    가로 스크롤 막대의 부분에는 다음 이름이 있습니다.

    부분 속성
    스크롤 막대 창 "가로"
    왼쪽 화살표 단추 "왼쪽 열"
    오른쪽 화살표 단추 "열 오른쪽"
    스크롤 엄지 손가락 "위치"
    페이지 오른쪽 지역 "페이지 오른쪽"
    페이지 왼쪽 영역 "페이지 왼쪽"

     

  • get_accParent - 화살표 단추, 스크롤 엄지 손가락 및 엄지 손가락 양쪽의 음영 영역의 Parent 속성은 스크롤 막대 창입니다. 스크롤 막대 창의 Parent 속성은 컨트롤을 둘러싸고 Name 속성 과 창 클래스 이름이 같은 창(ROLE_SYSTEM_WINDOW)입니다.

  • get_accRole - Role 속성은 쿼리되는 스크롤 막대의 부분에 따라 달라집니다. 스크롤 막대의 부분에는 다음과 같은 역할이 있습니다.

    부분 역할
    스크롤 막대 자체 ROLE_SYSTEM_SCROLLBAR
    위쪽, 아래쪽, 왼쪽 및 오른쪽 화살표 단추 ROLE_SYSTEM_PUSHBUTTON
    스크롤 엄지 손가락 ROLE_SYSTEM_INDICATOR
    페이지 위로, 페이지 아래로, 페이지 왼쪽 및 페이지 오른쪽 영역 ROLE_SYSTEM_PUSHBUTTON

     

  • get_accState - 각 스크롤 막대 구성 요소의 State 속성에는 다음 값의 조합이 포함됩니다.

    주 값
    STATE_SYSTEM_INVISIBLE 스크롤 막대 자체의 경우 지정된 세로 또는 가로 스크롤 막대가 없음을 나타냅니다. 페이지 위쪽 또는 페이지 아래쪽 영역의 경우 영역이 존재하지 않도록 엄지 손가락 위치가 지정되었음을 나타냅니다.
    STATE_SYSTEM_OFFSCREEN 스크롤 막대 자체의 경우 지정된 세로 또는 가로 스크롤 막대가 현재 표시되지 않도록 창 크기가 지정되었음을 나타냅니다.
    STATE_SYSTEM_PRESSED 화살표 단추 또는 페이지 영역을 누릅니다.
    STATE_SYSTEM_UNAVAILABLE 구성 요소를 사용할 수 없습니다.

     

  • get_accValue - 스크롤 막대 창의 Value 속성은 스크롤 막대 위치를 나타내며 "0"에서 "100"으로의 정수가 포함된 문자열입니다.

IAccessible 인터페이스