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