DGListGetTabItemIconId

리스트 박스 항목의 탭 필드의 아이콘 ID를 가져옵니다.

    short DGListGetTabItemIconId (
      short  dialId,
      short  item,
      short  listItem,
      short  tabIndex
    );

파라미터

dialId

다이얼로그 또는 탭 페이지의 ID입니다. DG_TOP_MODAL은 최상위 Modal 다이얼로그를 지정합니다.

 

item

다이얼로그 항목의 1-기반 인덱스입니다.

 

listItem

리스트 항목의 1-기반 인덱스입니다. DG_LIST_TOP은 리스트의 1번째 항목을 지정하고, DG_LIST_BOTTOM은 리스트의 마지막 항목을 지정합니다.

 

tabIndex

탭 필드의 1-기반 인덱스입니다.

리턴 값

주어진 탭 필드의 아이콘의 ID입니다. 만약 필드가 아이콘을 갖고 있지 않거나, 아이콘을 DGListSetTabItemIcon으로 세트했거나, 함수 파라미터들이 올바르지 않으면 DG_NO_ICON을 리턴합니다.

설명

리스트 항목들의 내용은 여러 컬럼들로 나뉠 수 있습니다. DG 리스트 박스는 row(행)와 column(열, 컬럼)들로 이루어진 2차원 리스트로 상상해볼 수 있습니다. 하나의 컬럼을 "탭 필드"라고 합니다. "탭 항목"은 탭 필드와 행 간의 교차입니다. "탭 필드"와 "탭 항목"이라는 이름들은 DG의 예전 버전에서 상속되었습니다. 예전 버전들에서 리스트 항목 안의 컬럼들의 텍스트들은 탭 ('\t') 문자들을 삽입하여 여러 텍스트들로 분리할 수 있었습니다. 탭 항목에 아이콘 그리고/또는 텍스트를 지정할 수 있습니다: 자세한 것은 DGListSetTabItemIconId와 DGListSetTabItemText를 보십시오.

탭 항목은 아이콘 그리고/또는 텍스트를 포함할 수 있습니다. 그러나 하나의 탭 항목에는 오직 하나의 아이콘만 표시할 수 있습니다. 탭 항목에 아이콘과 텍스트를 함께 사용하는 경우, 항목 텍스트는 DGListSetTabItemText 함수로 세트할 수 있습니다. 만약 탭 항목이 아이콘과 텍스트를 포함하는 경우, 아이콘은 justification에 따라 텍스트의 시작 또는 끝에 있게 될 것입니다. (DG_IS_LEFT justification은 아이콘과 텍스트를 포함하는 탭 항목에 적용됩니다. DG_IS_CENTER justification의 경우에도 DG_IS_LEFT justification과 동일합니다.)

DGListSetTabFieldCount와 DGListSetTabFieldData로 탭 필드들의 개수와 각각의 프로퍼티들을 세트한 후에만 이 루틴을 호출하십시오.

온탭 체크박스들을 구현하기 위해 탭 필드 상의 아이콘을 DGListSetTabItemIconId로 세트할 수 있습니다. 이 경우 DG_MSG_CLICK 메시지들은 다이얼로그 콜백 함수에서 처리되어야 합니다. 이 특수 체크박스들은 탭 필드에 붙어 있는 일반 체크박스 컨트롤들보다 훨씬 멋있어 보입니다. 왜냐하면 투명하고 사이즈 조절이 가능하기 때문입니다. 가능한 아이콘 ID들은 다음과 같습니다:

값	의미
DG_LIST_CHECKEDICON	체크된 체크박스 아이콘입니다.
DG_LIST_GRAYCHECKICON	회색처리된 체크박스 아이콘입니다.
DG_LIST_MIXEDCHECKICON	채워진 체크박스 아이콘입니다. 선택/미선택이 섞여 있거나 선택이 정의되어 있지 않다는 것을 표현할 때 사용합니다.
DG_LIST_FRAMELESSCHECKEDICON	프레임이 없는 체크박스 아이콘입니다.
DG_LIST_UNCHECKEDICON	체크되지 않은 체크박스 아이콘입니다.

요구사항

버전: DG 2.0.0 또는 이후

헤더: DG.h

라이브러리 가져오기: DG.lib [WIN]

모듈: DGLib [MAC], DG.dll [WIN]

참고사항

DG 함수, 리스트 박스, DGListSetTabItemIconId
DGListGetTabItemIcon, DGListGetTabItemIconResource, DGListGetTabItemText
DGListSetTabItemIcon, DGListSetTabItemIconResource, DGListSetTabItemText
콜백 함수, 체크박스, DG_MSG_CLICK, DGListSetTabFieldCount, DGListSetTabFieldData