DGListGetHeaderItemIcon
const void* DGListGetHeaderItemIcon (
short dialId,
short item,
short headerItem
);
파라미터
- dialId
- 다이얼로그 또는 탭 페이지의 ID입니다. DG_TOP_MODAL은 최상위 Modal 다이얼로그를 지정합니다.
- item
- 다이얼로그 항목의 1-기반 인덱스입니다.
- headerItem
- 헤더 항목의 1-기반 인덱스입니다.
리턴 값
주어진 헤더 항목의 icon입니다. (void*로 캐스팅할 것) 만약 헤더 항목이 아이콘을 갖고 있지 않거나, 만약 함수 파라미터들이 올바르지 않으면 NULL을 리턴합니다.
설명
리스트 박스 헤더는 리스트 박스의 위에 표시됩니다. 헤더는 여러 개의 헤더 항목들로 나뉠 수 있습니다. 헤더는 리스트 박스 컬럼들에 대한 정보를 표시하는 데 사용하며, 사용자가 리스트 박스 컬럼들의 크기와 순서를 동적으로 조정할 수 있게 하여 헤더를 구성할 수 있도록 해줍니다. 헤더 항목들의 개수는 DGListGetHeaderItemCount로 가져올 수 있습니다. 헤더 항목의 아이콘은 DGListSetHeaderItemIcon으로 세트할 수 있습니다.
헤더 항목들의 개수와 크기는 DG에 의해 해당 탭 필드들과 동기화되거나, 애플리케이션에 의해 독립적으로 처리됨으로써 헤더를 구성할 수 있습니다. 헤더 flag들을 각각 DGListSetHeaderFlags와 DGListGetHeaderFlags 함수들을 이용하여 세트하거나 가져올 수 있습니다.
헤더 항목은 아이콘 그리고/또는 텍스트 역시 포함할 수 있습니다. 그러나 헤더 항목에는 1개의 아이콘만 표시할 수 있습니다. 헤더 항목에 아이콘과 텍스트를 함께 사용하는 경우, 각각 DGListSetHeaderItemText와 DGListGetHeaderItemText 함수들을 이용하여 텍스트를 세트하거나 가져올 수 있습니다. 만약 헤더 항목이 아이콘과 텍스트도 포함한다면, 아이콘은 justification에 의해 텍스트의 시작 부분 또는 끝 부분에 있게 될 것입니다. (DG_IS_LEFT justification은 아이콘과 텍스트를 포함하는 헤더 항목에 적용됩니다. DG_IS_CENTER justification이 주어져도 DG_IS_LEFT justification이 적용됩니다.)
요구사항
- 버전: DG 2.2.0 또는 이후
- 헤더: DG.h
- 라이브러리 가져오기: DG.lib [WIN]
- 모듈: DGLib [MAC], DG.dll [WIN]
참고사항
DG 함수, 리스트 박스, DGListSetHeaderItemIcon
DGListSetHeaderFlags, DGListGetHeaderFlags, DGListSetHeaderItemText, DGListGetHeaderItemText, DGListGetHeaderItemCount
