다음을 통해 공유


개체 상태 상수

이 항목에서는 애플리케이션 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 사용하지 마세요. 대신 개별 이벤트 상수를 사용합니다.

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

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

요구 사항

요구 사항
헤더
Oleacc.h