다음을 통해 공유

값 맵 주석

  • 아티클

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

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

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

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

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

    아이콘이 내용에 대한 시각적 단서를 제공하는 시작 메뉴의 그림

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

    검사 상자 및 라디오 단추 값을 설정하기 위한 Internet Explorer 옵션의 스크린샷

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

    화면 해상도를 설정하는 데 사용되는 슬라이더의 스크린샷

값 맵 주석을 사용하면 매핑 문자열은 목록 또는 트리의 이미지 인덱스가 해당 역할 또는 상태에 해당하는 방식을 나타냅니다. 또는 슬라이더의 숫자 값이 문자열에 해당하는 방식을 나타낼 수 있습니다. 예를 들어 매핑 문자열은 목록 보기의 이미지 인덱스 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)입니다.