값 맵 주석

값 맵 주석을 사용하면 매핑 문자열을 사용하여 목록 보기 또는 트리 뷰에 있는 항목의 이미지 인덱스가 해당 역할 또는 상태에 해당하는 방식을 나타낼 수 있습니다. 예를 들어 매핑 문자열은 목록 보기의 이미지 인덱스 0이 검사 상자의 역할에 매핑되는 반면 이미지 인덱스 1은 라디오 단추의 역할에 매핑됨을 나타낼 수 있습니다.

값 맵 주석을 사용하여 슬라이더의 숫자 값에 매핑되는 문자열을 지정할 수도 있습니다.

이 기술을 사용해야 하는 경우

다음과 같은 상황에서 값 맵 주석을 사용하는 것이 좋습니다.

• 소유자가 그린 목록 보기 또는 트리 뷰가 이미지 사용을 통합하고 해당 이미지를 기반으로 사용자 지정 액세스 가능한 설명(설명 속성)을 제공하려는 경우 다음 그림에서는 예제를 보여 줍니다.

  

• 소유자가 그린 목록 보기 또는 트리 뷰 컨트롤이 이미지를 사용하여 트리 또는 목록 항목이 간단한 컨트롤, 일반적으로 확인란 또는 라디오 단추처럼 작동하도록 하는 경우 이미지를 역할에 매핑하려고 합니다. 다음 스크린샷에는 예제가 나와 있습니다.

  

• 슬라이더를 사용하여 다음 스크린샷과 같이 단순 정수 이외의 값으로 설명할 수 있는 값을 선택하는 경우, 여기서 화면 해상도 설정은 문자열로 설명됩니다.

  

값 맵 주석을 사용하면 매핑 문자열은 목록 또는 트리의 이미지 인덱스가 해당 역할 또는 상태에 해당하는 방식을 나타냅니다. 또는 슬라이더의 숫자 값이 문자열에 해당하는 방식을 나타낼 수 있습니다. 예를 들어 매핑 문자열은 목록 보기의 이미지 인덱스 0이 검사 상자의 역할에 매핑되고 이미지 인덱스 1이 라디오 단추의 역할에 매핑됨을 나타낼 수 있습니다. IAccPropServices::SetHwndPropStr()을 사용하여 매핑 문자열을 컨트롤에 연결합니다.

값 매핑을 지원하려면 컨트롤 관련 지식이 필요하므로 슬라이더 값 맵, 목록 보기 및 트리 뷰를 포함하여 값 맵 주석을 지원하는 컨트롤과 속성의 수는 제한되어 있습니다.

슬라이더 값 맵

PROPID_ACC_VALUEMAP 내부 슬라이더 위치에서 사람이 읽을 수 있는 문자열로의 매핑을 포함합니다. 이 속성은 Oleacc.dll 슬라이더 프록시에서 지원됩니다. 현재 슬라이더 값이 값 맵에 있으면 해당 문자열이 기본 백분율 문자열(예: "50")이 아닌 값으로 노출됩니다.

목록 보기 및 트리 뷰

PROPID_ACC_ROLEMAP, PROPID_ACC_STATEMAP 및 PROPID_ACC_DESCRIPTONMAP 상태 이미지 인덱스에서 역할 및 상태 값으로 매핑을 제공합니다. 이러한 맵을 사용하면 해당 이미지 인덱스를 적절한 역할(일반적으로 ROLE_SYSTEM_RADIOBUTTON 또는 ROLE_SYSTEM_CHECKBUTTON) 및 추가 상태 비트(일반적으로 STATE_SYSTEM_CHECKED)에 매핑할 수 있습니다.

값 맵 주석에 대한 자세한 내용은 다음 topics 참조하세요.

• 값 맵 주석 사용
• 값 맵 주석 샘플

주석 맵 형식

다음 표에서는 주석 맵에 포함된 필드를 설명합니다.

필드	설명
'A'	특정 코딩 체계가 사용됨을 나타냅니다. 추가 접두사는 향후 인코딩 체계에 대해 지원될 수 있습니다.
구분 기호 문자	일반적으로 콜론(:) 은 사용되지만 NULL 또는 빈 공간을 제외한 다른 문자일 수 있습니다. 이 문자는 나머지 필드의 구분 기호로 사용되므로 맵에서 값의 일부로 사용할 수 없습니다.
0, 1 또는 2	사용 중인 키를 나타내는 값입니다. 트리 뷰 및 목록 보기 역할 및 상태 맵의 경우 이 키는 0(이미지 인덱스), 1(상태 이미지 인덱스) 또는 2(오버레이 이미지 인덱스)일 수 있습니다. 키를 선택하지 않는 슬라이더 및 기타 컨트롤의 경우 이 값은 0이어야 합니다.
구분 기호 문자	:
키 값 쌍	각 쌍은 키 문자열과 구분 기호 문자로 구성됩니다. 키 문자열은 숫자이며 10진수 또는 16진수(선행 "0x" 접두사) 형식일 수 있습니다.
값 문자열	값 맵의 경우 문자열입니다. 역할 및 상태 맵의 경우 숫자(10진수 또는 16진수)입니다.
구분 기호 문자	:

 

예를 들어 맵은 다음과 같을 수 있습니다.

A:0:0:Cold:1:Warm:3:Hot:

이 값 맵이 슬라이더 컨트롤에 적용되면 슬라이더가 위치 1에 있을 때 "웜" 값이 노출됩니다. 이 예제에서는 값 2가 포함되지 않으므로 해당 위치의 기본값이 노출됩니다. 슬라이더의 경우 기본값은 백분율 값(예: 33)입니다.