메모
이 항목에서는 MSAA UI 요소 참조를 위해 컨트롤 개체 편집 대해 설명합니다. 다양한 UI 프레임워크에서 Control 개체 편집을 만드는 방법은 여기에 설명되어 있지 않습니다. 사용 중인 UI 프레임워크에 대한 API 참조 설명서를 참조하세요.
편집 컨트롤을 사용하면 사용자가 텍스트를 보고 편집할 수 있습니다. 편집 컨트롤은 ES_MULTILINE 같은 다양한 스타일로 만들어집니다. 이 스타일은 메모장의 클라이언트 영역과 같은 여러 줄 편집 컨트롤을 만들고 ES_READONLY 읽기 전용 편집 컨트롤을 만듭니다.
Microsoft Active Accessibility는 창 클래스 이름 "EDIT"로 만든 편집 컨트롤과 창 클래스 이름 "RichEdit" 또는 "RichEdit20A"로 만든 서식 있는 편집 컨트롤을 구분하지 않습니다.
IAccessible 메서드
편집 컨트롤은 다음 IAccessible 메서드를 지원합니다.
- accHitTest
- accLocation
- accNavigate
- accSelect
IAccessible 속성
편집 컨트롤은 다음 IAccessible 속성을 지원합니다.
재산 | 코멘트 |
---|---|
get_accChild | |
get_accChildCount | |
get_accDescription | |
get_accFocus | |
get_accKeyboardShortcut | KeyboardShortcut 속성은 편집 컨트롤의 액세스 키이며 편집 컨트롤의 레이블 텍스트에 밑줄이 그어져 있는 문자입니다. 예를 들어 WordPad와 같은 표준 파일 열기 대화 상자에서 "Filename:"이라는 레이블이 지정된 편집 컨트롤의 KeyboardShortcut "Alt+n"입니다. |
get_accName | Name 속성은 편집 컨트롤에 레이블을 지정하는 정적 텍스트 컨트롤의 텍스트입니다. 예를 들어 WordPad와 같은 표준 파일 열기 대화 상자에서 편집 컨트롤의 Name 속성은 "파일 이름:"입니다. |
get_accParent | Parent 속성은 컨트롤을 둘러싸고 Name 속성 및 창 클래스 이름을 컨트롤과 같은 창(ROLE_SYSTEM_WINDOW)입니다. |
get_accRole | Role 속성은 ROLE_SYSTEM_TEXT. |
get_accSelection | |
get_accState |
State 속성은 다음값 중 하나 이상의 조합입니다.STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_READONLY | STATE_SYSTEM_PROTECTED | STATE_SYSTEM_NORMAL |
get_accValue | Value 속성은 편집 컨트롤의 텍스트를 포함하는 단일 문자열입니다. 그러나 컨트롤이 암호로 보호된 경우 Value 속성은 E_ACCESSDENIED 반환합니다. 여러 줄 편집 컨트롤의 경우 문자열에는 각 줄 끝에 캐리지 리턴과 줄 바꿈 문자가 포함됩니다. |
노트
텍스트가 개체의 Value 속성에 문자열로 노출되므로 Microsoft Active Accessibility는 편집 및 서식 있는 편집 컨트롤에 포함된 텍스트 선택을 지원하지 않습니다.
Riched20.dll 제공하는 풍부한 편집 컨트롤(Windows 98의 WordPad와 같은 텍스트 편집기에서 사용됨)은 텍스트를 선택하는 동안 캐리트 위치가 변경될 때 WinEvents를 보내지 않습니다. 사용자가 Shift 키와 화살표 키를 눌러 텍스트를 선택하면 caret 개체가 EVENT_OBJECT_LOCATIONCHANGE WinEvent를 트리거하지 않습니다. 서식 있는 편집 메시지를 통해 프로그래밍 방식으로 선택 영역이 설정되면 caret 개체는 새 위치를 나타내는 이벤트를 보내지 않습니다.
Riched20.dll 사용하는 모든 애플리케이션은 이 문제를 발생합니다. 이전 버전의 리치 편집 컨트롤을 사용하는 애플리케이션은 선택에 따라 이벤트를 올바르게 보냅니다.
암호 편집 컨트롤의 상태 값에는 항상 비트 플래그 STATE_SYSTEM_PROTECTED포함됩니다.