개체 상태 상수
이 항목에서는 애플리케이션 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 |