DGListSetHeaderItemFlags

리스트 박스 항목의 헤더 항목의 justification, 절단, 리사이즈 기능 설정들을 세트합니다.

    void DGListSetHeaderItemFlags (
      short        dialId,
      short        item,
      short        headerItem,
      short        style,
      bool         isSizeable
    );

파라미터

dialId

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

 

item

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

 

headerItem

헤더 항목의 1-기반 인덱스입니다.

 

style

DG_IS_DEFAULT 또는 justification과 절단 flag들의 bitwise OR (|) 조합으로 된 항목 스타일입니다:

 

헤더 항목의 내용의 절단입니다:

값	의미
DG_IS_LEFT	항목 내용이 왼쪽으로 정렬됩니다.
DG_IS_CENTER	항목 내용이 중앙 정렬됩니다.
DG_IS_RIGHT	항목 내용이 오른쪽으로 정렬됩니다.

 

만약 헤더 항목의 텍스트가 항목 안에 다 들어가지 않을 경우 절단하는 방법입니다. 가능한 값들은 다음과 같습니다:

값	의미
DG_IS_NOTRUNC	절단하지 않습니다.
DG_IS_TRUNCEND	항목 내용을 끝에서 절단합니다.
DG_IS_TRUNCMIDDLE	항목 내용을 중앙에서 절단합니다. (텍스트의 양 끝에 동일한 개수의 문자들을 남김)

 

isSizeable

만약 이 flag를 세트하면, 헤더 항목의 크기가 마우스 상호작용에 의해 변경될 수 있습니다.

설명

리스트 박스 헤더는 리스트 박스의 위에 표시됩니다. 헤더는 여러 개의 헤더 항목들로 나뉠 수 있습니다. 헤더는 리스트 박스 컬럼들에 대한 정보를 표시하는 데 사용하며, 사용자가 리스트 박스 컬럼들의 크기와 순서를 동적으로 조정할 수 있게 하여 헤더를 구성할 수 있도록 해줍니다. 헤더 항목들의 개수는 DGListGetHeaderItemCount로 가져올 수 있습니다. 헤더 항목의 특수 프로퍼티들은 DGListGetHeaderItemFlags로 가져올 수 있습니다.

만약 리스트 박스 헤더 상의 isSynchron flag가 true로 세트되면, 헤더 항목들의 프로퍼티들은 DG에 의해 해당 탭 필드들과 동기화됩니다. 그 외에는 애플리케이션에 의해 독립적으로 처리되어야 합니다. 이 프로퍼티들은 다음과 같습니다: 헤더 항목의 개수와 크기, 글꼴 타입과 크기, 정렬, 헤더 항목의 텍스트의 절단. 만약 이 flag가 세트되면, 탭 필드의 프로퍼티가 변경되었을 때 이 프로퍼티들은 자동으로 업데이트됩니다.
만약 isSynchron flag가 false로 세트되어 있고, style flag가 DG_IS_DEFAULT로 세트되어 있으면, 헤더 항목에 대하여 기본 설정들이 적용됩니다. 즉, 왼쪽 정렬과 절단 없음. 다음 함수들은 isSynchron flag가 false로 세트되어 있을 때에만 리스트 박스 헤더 항목들에게 효과가 있습니다: DGListSetHeaderItemFlags, DGListSetHeaderItemCount, DGListSetHeaderItemFont, DGListSetHeaderItemSize.
헤더 flag들은 각각 DGListSetHeaderFlags와 DGListGetHeaderFlags 함수들을 이용하여 세트하거나 가져올 수 있습니다.

헤더 항목은 아이콘 그리고/또는 텍스트 역시 포함할 수 있습니다. 그러나 헤더 항목에는 1개의 아이콘만 표시할 수 있습니다. 헤더 항목의 텍스트와 아이콘은 각각 DGListSetHeaderItemText, DGListSetHeaderItemIcon 그리고 DGListGetHeaderItemText, DGListGetHeaderItemIcon 함수들을 이용하여 세트하거나 가져올 수 있습니다. 만약 헤더 항목이 아이콘과 텍스트도 포함한다면, 아이콘은 justification에 의해 텍스트의 시작 부분 또는 끝 부분에 있게 될 것입니다. (DG_IS_LEFT justification은 아이콘과 텍스트를 포함하는 헤더 항목에 적용됩니다. DG_IS_CENTER justification이 주어져도 DG_IS_LEFT justification이 적용됩니다.) 멀티-라인 텍스트의 경우, 잘림을 적용할 수 없습니다. 각 헤더 항목의 글꼴 스타일과 크기는 DGListSetHeaderItemFont 함수로 세트할 수 있습니다.

isSizeable flag에 대한 기본 설정은 false입니다. 만약 리스트 박스 헤더 상의 isSizeable flag가 true로 세트되면, 헤더 항목은 마우스 상호작용으로 리사이즈할 수 있습니다. 헤더 항목의 최소 크기는 각각 DGListSetHeaderItemMinSize와 DGListGetHeaderItemMinSize 함수들을 이용하여 세트하거나 가져올 수 있습니다.

요구사항

버전: DG 2.2.0 또는 이후

헤더: DG.h

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

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

참고사항

DG 함수, 리스트 박스, DGListGetHeaderItemFlags
DGListSetHeaderFlags, DGListGetHeaderFlags, DGListSetHeaderItemCount, DGListGetHeaderItemCount, DGListSetHeaderItemText, DGListGetHeaderItemText, DGListSetHeaderItemIcon, DGListGetHeaderItemIcon, DGListSetHeaderItemMinSize, DGListGetHeaderItemMinSize, DGListSetHeaderItemFont, DGListSetHeaderItemSize