다음을 통해 공유


개체 상태 상수

이 항목에서는 애플리케이션 UI의 개체 상태를 설명하는 데 사용되는 상수 값에 대해 설명합니다. 상태 상수는 oleacc.h에 정의됩니다.

개체는 언제든지 이러한 상태 값 중 하나 이상과 연결됩니다. STATE_SYSTEM_ALERT_HIGH, STATE_SYSTEM_ALERT_MEDIUM, STATE_SYSTEM_ALERT_LOW 및 STATE_SYSTEM_FLOATING 개체 상태 상수는 사용되지 않습니다.

클라이언트는 다음 비트 플래그의 조합인 정수를 반환하는 IAccessible::get_accState호출하여 개체의 상태를 검색합니다. 클라이언트는 상태 값을 사용하여 GetStateText 호출하여 개체의 상태를 설명하는 지역화된 문자열을 검색합니다.

개체 상태가 변경되면 서버는 EVENT_OBJECT_STATECHANGE 이벤트 상수를 사용하여 NotifyWinEvent 호출해야 합니다. 그러나 STATE_SYSTEM_INVISIBLE, STATE_SYSTEM_FOCUSED 및 STATE_SYSTEM_ SELECTED 개체 상태 상수가 있는 개체에는 고유한 이벤트 상수가 있습니다. 이러한 개체의 경우 EVENT_OBJECT_STATECHANGE사용하지 마세요. 대신 개별 이벤트 상수 사용

다음은 개체 상태 상수입니다.

상수 묘사
STATE_SYSTEM_ALERT_HIGH
0x10000000
(이 개체 상태 상수는 지원되지 않습니다.)
사용자에게 즉시 전달할 중요한 정보를 나타냅니다. 예를 들어 배터리가 매우 낮은 수준에 도달하면 수준 표시기가 높은 수준의 경고를 생성합니다. 따라서 블라인드 액세스 도구는 사용자에게 이 정보를 즉시 알리고 화면 확대 프로그램은 배터리 표시기가 표시되도록 화면을 스크롤합니다. 이 상태는 사용자가 계속하기 전에 완료해야 하는 프롬프트 또는 작업에도 적합합니다.
STATE_SYSTEM_ALERT_MEDIUM
0x8000000
(이 개체 상태 상수는 지원되지 않습니다.)
사용자에게 즉시 전달되지 않는 중요한 정보를 나타냅니다. 예를 들어 배터리가 낮은 수준에 도달하기 시작하면 수준 표시기가 중간 수준의 경고를 생성합니다. 그러면 블라인드 액세스 도구는 사용자의 작업을 실제로 방해하지 않고 중요한 정보를 사용할 수 있음을 사용자에게 알리는 소리를 생성합니다. 그러면 사용자는 편리할 때 경고 정보를 쿼리할 수 있습니다.
STATE_SYSTEM_ALERT_LOW
0x4000000
(이 개체 상태 상수는 지원되지 않습니다.)
사용자에게 중요하지 않은 우선 순위가 낮은 정보를 나타냅니다. 예를 들어 Word에서 도구 모음의 TipWizard 단추 모양을 변경하여 사용자에 대한 힌트가 있음을 나타내는 경우 이 상태가 사용됩니다.
STATE_SYSTEM_ANIMATED
0x4000
개체의 모양이 빠르게 또는 지속적으로 변경됩니다. 경우에 따라 애니메이션 효과를 주는 그래픽은 State 속성이 STATE_SYSTEM_ANIMATED 설정된 ROLE_SYSTEM_GRAPHIC 설명됩니다. 이 상태는 개체의 위치가 변경되고 있음을 나타내는 데 사용됩니다.
STATE_SYSTEM_BUSY
0x800
현재 컨트롤에서 입력을 수락할 수 없습니다.
STATE_SYSTEM_CHECKED
0x10
개체의 확인란이 선택되어 있습니다.
STATE_SYSTEM_COLLAPSED
0x400
ROLE_SYSTEM_OUTLINEITEM 역할이 있는 개체의 자식은 숨겨집니다.
STATE_SYSTEM_DEFAULT
0x100
이 상태는 창의 기본 단추를 나타냅니다.
STATE_SYSTEM_EXPANDED
0x200
ROLE_SYSTEM_OUTLINEITEM 역할이 있는 개체의 자식이 표시됩니다.
STATE_SYSTEM_EXTSELECTABLE
0x2000000
개체가 IAccessible::accSelect 메서드의 SELFLAG_EXTENDSELECTION 사용하여 선택 영역을 확장했음을 나타냅니다.
STATE_SYSTEM_FLOATING
0x1000
(이 개체 상태 상수는 지원되지 않습니다.)
개체가 부모 개체의 경계로 잘리지 않고 부모가 이동할 때 자동으로 이동되지 않습니다.
STATE_SYSTEM_FOCUSABLE
0x100000
개체가 활성 창에 있으며 키보드 포커스를 받을 준비가 된 것입니다.
STATE_SYSTEM_FOCUSED
0x4
개체에 키보드 포커스가 있습니다. 개체 포커스와 개체 선택을 혼동하지 마세요. 자세한 내용은 선택 및 포커스 속성 및 메서드참조하세요. 이 개체 상태를 가진 개체의 경우 EVENT_OBJECT_SHOW 보내거나 EVENT_OBJECT_HIDE WinEvents를 보내 클라이언트 애플리케이션에 상태 변경에 대해 알립니다. EVENT_OBJECT_STATECHANGE사용하지 마세요.
STATE_SYSTEM_HASPOPUP
0x40000000
호출되면 개체에 팝업 메뉴 또는 창이 표시됩니다.
STATE_SYSTEM_HOTTRACKED
0x80
개체는 마우스로 핫 추적되므로 개체의 모양이 변경되어 마우스 포인터가 그 위에 있음을 나타냅니다.
STATE_SYSTEM_INVISIBLE
0x8000
개체가 프로그래밍 방식으로 숨겨집니다. 예를 들어 메뉴 반복은 사용자가 메뉴를 활성화할 때까지 프로그래밍 방식으로 숨겨집니다. 이 상태의 개체는 사용자가 사용할 수 없으므로 클라이언트 애플리케이션은 개체에 대한 정보를 사용자에게 전달해서는 안 됩니다. 그러나 클라이언트 애플리케이션이 이 상태의 개체를 찾는 경우 STATE_SYSTEM_OFFSCREEN 설정되었는지 확인해야 합니다. 이 두 번째 상태가 정의되면 클라이언트는 개체에 대한 정보를 사용자에게 전달할 수 있습니다. 예를 들어 목록 상자에는 STATE_SYSTEM_INVISIBLE 및 STATE_SYSTEM_OFFSCREEN 둘 다 설정할 수 있습니다. 이 경우 클라이언트 애플리케이션은 목록의 모든 항목을 사용자에게 전달할 수 있습니다.
클라이언트 애플리케이션이 IAccessible 트리를 탐색하고 표시되지 않는 부모 개체를 발견하면 Microsoft Active Accessibility는 부모가 보이지 않는 한 부모의 가능한 자식에 대한 정보를 노출하지 않습니다.
STATE_SYSTEM_LINKED
0x400000
개체의 서식이 하이퍼링크로 지정되었음을 나타냅니다. 개체의 역할은 일반적으로 ROLE_SYSTEM_TEXT.
STATE_SYSTEM_MARQUEED
0x2000
텍스트 또는 그래픽 스크롤 또는 이동을 나타냅니다.
STATE_SYSTEM_MIXED
0x20
3개 상태 확인란 또는 도구 모음 단추의 상태가 결정되지 않음을 나타냅니다. 확인란은 선택되거나 선택 취소되지 않으므로 세 번째 또는 혼합 상태입니다.
STATE_SYSTEM_MOVEABLE
0x40000
개체를 이동할 수 있음을 나타냅니다. 예를 들어 사용자는 개체의 제목 표시줄을 클릭하고 개체를 새 위치로 끌 수 있습니다.
STATE_SYSTEM_MULTISELECTABLE
0x1000000
개체가 선택한 여러 항목을 허용한다는 것을 나타냅니다. 즉, IAccessible::accSelect 메서드에 대한 SELFLAG_ADDSELECTION 유효합니다.
STATE_SYSTEM_NORMAL
0
개체에 할당된 다른 상태가 없음을 나타냅니다.
STATE_SYSTEM_OFFSCREEN
0x10000
개체가 잘리거나 보기 밖으로 스크롤되었지만 프로그래밍 방식으로 숨겨지지는 않습니다. 사용자가 뷰포트를 크게 만들면 컴퓨터 화면에 더 많은 개체가 표시됩니다.
STATE_SYSTEM_PRESSED
0x8
개체를 눌렀습니다.
STATE_SYSTEM_PROTECTED
0x20000000
개체는 암호로 보호된 편집 컨트롤입니다.
STATE_SYSTEM_READONLY
0x40
개체는 읽기 전용으로 지정됩니다.
STATE_SYSTEM_SELECTABLE
0x200000
개체는 선택을 허용합니다.
STATE_SYSTEM_SELECTED
0x2
개체가 선택되어 있습니다.
STATE_SYSTEM_SELFVOICING
0x80000
개체 또는 자식은 설명을 위해 TTS(텍스트 음성 변환) 기술을 사용합니다. 이 상태의 개체에 포커스가 있는 경우 개체가 자동으로 알리기 때문에 음성 기반 접근성 보조 기능이 정보를 알리지 않습니다.
STATE_SYSTEM_SIZEABLE
0x20000
개체의 크기를 조정할 수 있습니다. 예를 들어 사용자는 테두리로 끌어 창의 크기를 변경할 수 있습니다.
STATE_SYSTEM_TRAVERSED
0x800000
개체는 사용자가(이전에 클릭) 방문한 하이퍼링크입니다.
STATE_SYSTEM_UNAVAILABLE
0x1
개체를 사용할 수 없습니다.

요구 사항

요구
머리글
Oleacc.h