DGListGetTabItemIcon

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

    const void* DGListGetTabItemIcon (
      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-기반 인덱스입니다.

리턴 값

주어진 탭 필드의 아이콘 데이터입니다. (void*로 캐스팅할 것) 만약 필드가 아이콘을 갖고 있지 않거나, 아이콘을 DGListSetTabItemIconId 또는 DGListSetTabItemIconResource로 세트했거나, 함수 파라미터들이 올바르지 않으면 NULL입니다.

아이콘 데이터를 가리킵니다:

 Macintosh 전용: 

void*로 캐스팅되는 아이콘의 NSImage* 포인터

 Windows 전용: 

void*로 캐스팅되는 아이콘의 HICON 핸들

설명

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

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

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

요구사항

버전: DG 2.2.0 또는 이후

헤더: DG.h

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

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

참고사항

DG 함수, 리스트 박스, DGListSetTabItemIcon
DGListGetTabItemIconId, DGListGetTabItemIconResource, DGListGetTabItemText
DGListSetTabItemIconId, DGListSetTabItemIconResource, DGListSetTabItemText
DGListSetTabFieldCount, DGListSetTabFieldData