DGListGetHeaderItemText

리스트 박스 항목의 헤더 항목의 텍스트를 가져옵니다.

    Int32 DGListGetHeaderItemText (
      short        dialId,
      short        item,
      short        headerItem,
      char*        text,
      Int32        size
   );

파라미터

dialId

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

 

item

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

 

headerItem

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

 

text

텍스트를 수신할 버퍼에 대한 포인터입니다. 이 파라미터는 NULL이 될 수 있습니다.

 

size

text 버퍼의 크기입니다. 만약 text가 NULL이면, 이 파라미터는 무시합니다.

리턴 값

헤더 항목 텍스트의 길이입니다. (0 terminator 포함) 만약 size가 헤더 항목 텍스트의 크기보다 작으면 0입니다.

필요한 버퍼 크기를 가져오려면 text 파라미터에 대하여 NULL을 사용하십시오.

설명

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

헤더 항목들의 개수와 크기는 DG에 의해 해당 탭 필드들과 동기화되거나, 애플리케이션에 의해 독립적으로 처리됨으로써 헤더를 구성할 수 있습니다. 헤더 flag들을 각각 DGListSetHeaderFlags와 DGListGetHeaderFlags 함수들을 이용하여 세트하거나 가져올 수 있습니다.

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

요구사항

버전: DG 2.2.0 또는 이후

헤더: DG.h

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

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

참고사항

DG 함수, 리스트 박스, DGListSetHeaderItemText
DGListSetHeaderFlags, DGListGetHeaderFlags, DGListSetHeaderItemFont, DGListSetHeaderItemIcon, DGListGetHeaderItemIcon, DGListGetHeaderItemCount