아이콘

아이콘 컨트롤들은 마스킹된 이미지를 표시하며 보통 다이얼로그에서 다른 컨트롤들의 라벨 역할로 사용됩니다. 아이콘 컨트롤들은 또한 다른 컨트롤들을 위한 배경으로 쓰일 수 있습니다. 예를 들어, 작은 별도의 아이콘들을 사용하는 대신 포커스 가능한 컨트롤(예. Edit 컨트롤)을 위한 하나의 큰 설명 아이콘을 사용할 수 있습니다.

기본적으로 아이콘 컨트롤은 프레임 없이 그려집니다. 그러나 이것은 3가지 타입의 프레임을 가질 수 있습니다: static edge, client edge, modal frame.

그림 컨트롤들은 아이콘 컨트롤들과 매우 비슷합니다. 차이점은 그림 컨트롤의 경우 마스킹되지 않는다는 것입니다.

항목 타입

DG_ITM_ICONITEM

프레임 타입

프레임 타입	의미
DG_FT_NONE	프레임이 없습니다.
DG_FT_STATIC	함몰 모서리를 가진 얇은 3차원 경계입니다.
DG_FT_CLIENT	함몰 모서리를 가진 두꺼운 3차원 경계입니다.
DG_FT_MODAL	돌출 모서리를 가진 두꺼운 3차원 경계입니다.

GRC 사양

    Icon    x  y  dx  dy  iconID  [frameType]

x와 y는 아이콘 컨트롤의 좌상단 코너의 픽셀 좌표입니다. dx와 dy는 컨트롤의 너비와 높이의 픽셀 크기입니다. iconID는 컨트롤의 아이콘 리소스 ID를 정의합니다. 만약 선택적인 frameType flag가 생략되면, 아이콘은 프레임 없이 그려집니다.

iconID는 양수 리소스 ID 혹은 다음에 미리 정의된 상수 중 하나가 될 수 있습니다:

값	의미	Macintosh	Windows
NoIcon	아이콘이 없습니다. 빈 공간입니다.
ErrorIcon	오류 아이콘.
InfoIcon	정보 아이콘.
WarningIcon	경고 아이콘.

frameType의 가능한 값은 다음과 같습니다:

값	의미
Default	DG_FT_NONE 프레임 타입이 세트되었습니다.
StaticEdge	DG_FT_STATIC 프레임 타입이 세트되었습니다.
ClientEdge	DG_FT_CLIENT 프레임 타입이 세트되었습니다.
ModalFrame	DG_FT_MODAL 프레임 타입이 세트되었습니다.

메시지

메시지	의미
DG_MSG_CLICK	아이콘 컨트롤을 클릭했습니다. 메시지 데이터 파라미터는 항상 0입니다.
DG_MSG_DOUBLECLICK	아이콘 컨트롤을 더블 클릭했습니다. 메시지 데이터 파라미터는 항상 0입니다.

설명

만약 아이콘 컨트롤이 다른 컨트롤들을 위해 설명하는 배경으로 사용되면, 이것은 반드시 다이얼로그 항목 리스트에서 가장 앞에 있어야 합니다. 이 컨트롤들은 아이콘 컨트롤의 영역 내에 전체 혹은 일부가 포함될 수 있습니다.

아이콘 컨트롤의 아이콘은 아이콘의 리소스 ID 또는 핸들에 의해 할당될 수 있습니다. 아이콘을 세트하고 가져오려면 DGSetItemImageId 또는 DGSetItemImage 그리고 DGGetItemImageId 또는 DGGetItemImage를 각각 사용하십시오. 아이콘 리소스 ID는 GRC 스크립트에서도 정의될 수 있음을 참고하십시오.

아이콘 컨트롤이 생성되거나 프로그램 코드로 새로운 아이콘이 할당될 때, 컨트롤은 자동으로 아이콘 크기로 리사이즈됩니다. 이 동작을 수행하는 동안 컨트롤의 중심은 이동하지 않으며 가능한 프레임을 고려합니다.

자원 공간을 절약하기 위해 아이콘의 색상 테이블에 가능하면 항상 적은 수의 색상을 사용하십시오. 예를 들어 만약 당신의 이미지가 6개의 다른 색상을 포함하고 있다면, 256 컬러 아이콘을 사용하지 말고 대신 16 컬러 아이콘을 사용하십시오.

요구사항

버전: DG 2.0.0 또는 이후

헤더: DG.h

참고사항

다이얼로그 항목 타입, 그림
DGGetItemImage, DGGetItemImageId, DGSetItemImage, DGSetItemImageId
DG_MSG_CLICK, DG_MSG_DOUBLECLICK