개체 역할

이 항목에서는 애플리케이션에서 다양한 UI 개체의 역할을 설명하는 데 사용되는 상수 값에 대해 설명합니다. 역할 상수는 Oleacc.h 파일에 정의됩니다.

여기에 나열된 역할 상수만 사용해야 합니다. 미리 정의되지 않은 사용자 지정 역할 또는 역할을 추가하지 마세요.

이러한 개체 역할을 사용하기 전에 클라이언트 애플리케이션 개발자는 검사 도구를 사용하여 개체 역할이 UI 요소에서 사용되고 있는지 확인해야 합니다.

개체의 역할을 검색하기 위해 클라이언트는 테이블에 설명된 값 중 하나를 반환해야 하는 IAccessible::get_accRole 메서드를 호출합니다. 개체의 역할을 설명하는 지역화된 문자열을 검색하기 위해 클라이언트는 역할 값을 사용하여 GetRoleText 함수를 호출합니다. 역할 값에 대한 지역화된 문자열은 oleaccrc.dll 파일에 있습니다.

상수	Description
ROLE_SYSTEM_ALERT	개체는 사용자에게 알림을 받아야 하는 경고 또는 조건을 나타냅니다. 이 역할은 경고를 구현하지만 메시지 상자, 그래픽, 텍스트 또는 소리와 같은 다른 사용자 인터페이스 요소와 연결되지 않은 개체에만 사용됩니다.
ROLE_SYSTEM_ANIMATION	개체는 일련의 비트맵 프레임을 표시하는 컨트롤과 같이 시간이 지남에 따라 콘텐츠가 변경되는 애니메이션 컨트롤을 나타냅니다. 애니메이션 컨트롤은 파일이 복사되거나 시간이 많이 걸리는 다른 작업이 수행될 때 표시됩니다.
ROLE_SYSTEM_APPLICATION	개체는 애플리케이션에 대한 기본 창을 나타냅니다.
ROLE_SYSTEM_BORDER	개체는 창 테두리를 나타냅니다. 전체 테두리는 각 면에 대해 별도의 개체가 아닌 단일 개체로 표시됩니다.
ROLE_SYSTEM_BUTTONDROPDOWN	개체는 항목 목록을 확장하는 단추를 나타냅니다.
ROLE_SYSTEM_BUTTONDROPDOWNGRID	개체는 그리드를 확장하는 단추를 나타냅니다.
ROLE_SYSTEM_BUTTONMENU	개체는 메뉴를 확장하는 단추를 나타냅니다.
ROLE_SYSTEM_CARET	개체는 시스템 캐럿을 나타냅니다.
ROLE_SYSTEM_CELL	개체는 테이블 내의 셀을 나타냅니다.
ROLE_SYSTEM_CHARACTER	개체는 응용 프로그램 사용자에게 도움을 제공하기 위해 표시되는 Microsoft Office Assistant와 같은 만화 같은 그래픽 개체를 나타냅니다.
ROLE_SYSTEM_CHART	개체는 데이터를 차트로 표시하는 데 사용되는 그래픽 이미지를 나타냅니다.
ROLE_SYSTEM_CHECKBUTTON	개체는 다른 옵션과 독립적으로 선택되거나 선택 취소되는 옵션인 검사 상자 컨트롤을 나타냅니다.
ROLE_SYSTEM_CLIENT	개체는 창의 클라이언트 영역을 나타냅니다. Microsoft Active Accessibility는 UI 요소의 역할에 대한 질문이 있는 경우 이 역할을 기본값으로 사용합니다.
ROLE_SYSTEM_CLOCK	개체는 시간을 표시하는 컨트롤을 나타냅니다.
ROLE_SYSTEM_COLUMN	개체는 테이블 내의 셀 열을 나타냅니다.
ROLE_SYSTEM_COLUMNHEADER	개체는 테이블의 열에 대한 시각적 레이블을 제공하는 열 머리글을 나타냅니다.
ROLE_SYSTEM_COMBOBOX	개체는 미리 정의된 선택 항목 집합을 제공하는 연결된 목록 상자가 있는 편집 컨트롤인 콤보 상자를 나타냅니다.
ROLE_SYSTEM_CURSOR	개체는 시스템의 마우스 포인터를 나타냅니다.
ROLE_SYSTEM_DIAGRAM	개체는 데이터를 다이어그램하는 데 사용되는 그래픽 이미지를 나타냅니다.
ROLE_SYSTEM_DIAL	개체는 다이얼 또는 노브를 나타냅니다.
ROLE_SYSTEM_DIALOG	개체는 대화 상자 또는 메시지 상자를 나타냅니다.
ROLE_SYSTEM_DOCUMENT	개체는 문서 창을 나타냅니다. 문서 창은 항상 애플리케이션 창 내에 포함됩니다. 이 역할은 MDI 창에만 적용되며 MDI 제목 표시줄이 포함된 개체를 참조합니다.
ROLE_SYSTEM_DROPLIST	개체는 일정 컨트롤 SysDateTimePick32를 나타냅니다. Microsoft Active Accessibility 런타임 구성 요소는 이 역할을 사용하여 날짜 또는 일정 컨트롤이 발견되었음을 나타냅니다.
ROLE_SYSTEM_EQUATION	개체는 수학 수식을 나타냅니다.
ROLE_SYSTEM_GRAPHIC	개체는 그림을 나타냅니다.
ROLE_SYSTEM_GRIP	개체는 사용자가 창과 같은 사용자 인터페이스 요소를 조작할 수 있는 특수 마우스 포인터를 나타냅니다. 이 예제 중 하나는 오른쪽 아래 모서리를 끌어 창 크기를 조정하는 것입니다.
ROLE_SYSTEM_GROUPING	개체는 논리적으로 다른 개체를 그룹화합니다. 그룹화 개체와 포함하는 개체 간에 항상 부모-자식 관계가 있는 것은 아닙니다.
ROLE_SYSTEM_HELPBALLOON	개체는 도구 설명 또는 도움말 풍선의 형태로 도움말 항목을 표시합니다.
ROLE_SYSTEM_HOTKEYFIELD	개체는 사용자가 키 입력의 조합 또는 시퀀스를 입력할 수 있는 바로 가기 키 필드를 나타냅니다.
ROLE_SYSTEM_INDICATOR	개체는 현재 항목을 가리키는 포인터 그래픽과 같은 표시기를 나타냅니다.
ROLE_SYSTEM_IPADDRESS	개체는 IP 주소를 위해 설계된 편집 컨트롤을 나타냅니다. 편집 컨트롤은 각각 IP 주소의 특정 부분에 대한 섹션으로 나뉩니다.
ROLE_SYSTEM_LINK	개체는 다른 항목에 대한 링크를 나타냅니다. 이 개체는 텍스트나 그래픽처럼 보이지만 단추처럼 작동합니다.
ROLE_SYSTEM_LIST	개체는 목록 상자를 나타내며 사용자가 하나 이상의 항목을 선택할 수 있도록 합니다.
ROLE_SYSTEM_LISTITEM	개체는 목록 상자 또는 콤보 상자의 목록 부분, 드롭다운 목록 상자 또는 드롭다운 콤보 상자의 항목을 나타냅니다.
ROLE_SYSTEM_MENUBAR	개체는 사용자가 메뉴를 선택하는 메뉴 모음(창의 제목 표시줄 아래에 위치)을 나타냅니다.
ROLE_SYSTEM_MENUITEM	개체는 메뉴 항목을 나타냅니다. 사용자가 명령을 수행하거나 옵션을 선택하거나 다른 메뉴를 표시하도록 선택할 수 있는 메뉴 항목입니다. 기능적으로 메뉴 항목은 누름 단추, 라디오 단추, 검사 상자 또는 메뉴와 동일합니다.
ROLE_SYSTEM_MENUPOPUP	개체는 메뉴( 각각 특정 작업이 있는 옵션 목록)를 나타냅니다. 메뉴 모음에서 선택할 때 표시되는 드롭다운 메뉴를 포함하여 모든 메뉴 형식에 역할이 있어야 합니다. 및 바로 가기 메뉴는 마우스 오른쪽 단추를 클릭하여 표시됩니다.
ROLE_SYSTEM_OUTLINE	개체는 계층 목록을 표시하고 사용자가 분기를 확장하고 축소할 수 있도록 하는 트리 뷰 컨트롤과 같은 윤곽선 또는 트리 구조를 나타냅니다.
ROLE_SYSTEM_OUTLINEBUTTON	개체는 개요 항목처럼 탐색하는 항목을 나타냅니다. 위쪽 및 아래쪽 화살표 키는 개요를 탐색하는 데 사용됩니다. 그러나 왼쪽 및 오른쪽 화살표 키를 누를 때 확장 및 축소하는 대신 스페이스바 또는 ENTER 키를 누르고 항목에 포커스가 있을 때 이러한 메뉴가 확장되거나 축소됩니다.
ROLE_SYSTEM_OUTLINEITEM	개체는 윤곽선 또는 트리 구조의 항목을 나타냅니다.
ROLE_SYSTEM_PAGETAB	개체는 페이지 탭을 나타냅니다. 페이지 탭 컨트롤의 유일한 자식은 연결된 페이지의 내용이 있는 ROLE_SYSTEM_GROUPING 개체입니다.
ROLE_SYSTEM_PAGETABLIST	개체는 페이지 탭 컨트롤의 컨테이너를 나타냅니다.
ROLE_SYSTEM_PANE	개체는 프레임 또는 문서 창 내의 창을 나타냅니다. 각 창 및 현재 창의 여러 콘텐츠를 탐색할 수 있지만 다른 창의 항목은 탐색할 수 없습니다. 따라서 창은 프레임 또는 문서 창보다 낮지만 개별 컨트롤보다 높은 그룹화 수준을 나타냅니다. 컨텍스트에 따라 사용자가 TAB, F6 또는 CTRL+TAB을 눌러 창을 탐색합니다.
ROLE_SYSTEM_PROGRESSBAR	개체는 진행 중인 작업의 완료 정도를 동적으로 보여 주는 진행률 표시줄을 나타냅니다. 이 컨트롤은 사용자 입력을 사용하지 않습니다.
ROLE_SYSTEM_PROPERTYPAGE	개체는 속성 시트를 나타냅니다.
ROLE_SYSTEM_PUSHBUTTON	개체는 누름 단추 컨트롤을 나타냅니다.
ROLE_SYSTEM_RADIOBUTTON	개체는 옵션 단추(이전의 라디오 단추)를 나타냅니다. 상호 배타적인 옵션 그룹 중 하나입니다. 동일한 부모를 공유하고 이 특성을 가진 모든 개체는 상호 배타적인 단일 그룹의 일부로 간주됩니다. 이러한 개체를 별도의 그룹으로 나누려면 ROLE_SYSTEM_GROUPING 개체를 사용합니다.
ROLE_SYSTEM_ROW	개체는 테이블 내의 셀 행을 나타냅니다.
ROLE_SYSTEM_ROWHEADER	개체는 테이블 행에 대한 시각적 레이블을 제공하는 행 머리글을 나타냅니다.
ROLE_SYSTEM_SCROLLBAR	개체는 클라이언트 영역의 일부이거나 컨트롤에 사용되는 세로 또는 가로 스크롤 막대를 나타냅니다.
ROLE_SYSTEM_SEPARATOR	개체는 공간을 두 영역으로 시각적으로 나누는 데 사용됩니다. 구분 기호 개체의 예로는 구분 기호 메뉴 항목과 창 내에서 분할 창을 나누는 막대가 있습니다.
ROLE_SYSTEM_SLIDER	개체는 사용자가 최소값과 최대값 사이의 특정 증분 설정을 조정할 수 있는 슬라이더를 나타냅니다.
ROLE_SYSTEM_SOUND	개체는 다양한 시스템 이벤트와 연결된 시스템 사운드를 나타냅니다.
ROLE_SYSTEM_SPINBUTTON	개체는 사용자가 스핀 상자와 연결된 별도의 "버디" 컨트롤에 표시되는 값을 늘리거나 감소할 수 있는 컨트롤인 스핀 상자를 나타냅니다.
ROLE_SYSTEM_SPLITBUTTON	개체는 단추와 바로 인접한 드롭다운 목록 아이콘이 있는 도구 모음의 단추를 나타냅니다.
ROLE_SYSTEM_STATICTEXT	개체는 대화 상자의 다른 컨트롤 또는 지침에 대한 레이블과 같은 읽기 전용 텍스트를 나타냅니다. 정적 텍스트는 수정하거나 선택할 수 없습니다.
ROLE_SYSTEM_STATUSBAR	개체는 창 아래쪽에 있는 영역이며 현재 작업, 애플리케이션의 상태 또는 선택한 개체에 대한 정보를 표시하는 상태 막대를 나타냅니다. 상태 막대에는 다양한 종류의 정보를 표시하는 여러 필드가 있습니다.
ROLE_SYSTEM_TABLE	개체는 셀의 행과 열, 선택적으로 행 머리글 및 열 머리글이 포함된 테이블을 나타냅니다.
ROLE_SYSTEM_TEXT	개체는 편집을 허용하거나 읽기 전용으로 지정된 선택 가능한 텍스트를 나타냅니다.
ROLE_SYSTEM_TITLEBAR	개체는 창의 제목 또는 캡션 막대를 나타냅니다.
ROLE_SYSTEM_TOOLBAR	개체는 자주 사용되는 기능에 쉽게 액세스할 수 있는 컨트롤 그룹화인 도구 모음을 나타냅니다.
ROLE_SYSTEM_TOOLTIP	개체는 유용한 힌트를 제공하는 도구 설명을 나타냅니다.
ROLE_SYSTEM_WHITESPACE	개체는 다른 개체 사이의 빈 공간을 나타냅니다.
ROLE_SYSTEM_WINDOW	개체는 제목 표시줄, 클라이언트 및 창의 다른 개체와 같은 자식 개체를 포함하는 창 프레임을 나타냅니다.

요구 사항

요구 사항	값
헤더	Oleacc.h