DGListSetTabFieldData

리스트 박스에서 탭 필드의 속성을 설정합니다.

    void DGListSetTabFieldData (
      short  dialId,
      short  item,
      short  tabIndex,
      short  begPos,
      short  endPos,
      short  justFlag,
      short  truncFlag,
      bool   hasSeparator,
      bool   status
    );

파라미터

dialId

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

 

item

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

 

tabIndex

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

 

begPos

픽셀 단위의 탭 필드 왼쪽 위치입니다. 리스트 박스의 클라이언트 직사각형에 상대적입니다.

 

endPos

픽셀 단위의 탭 필드 오른쪽 위치입니다. 리스트 박스의 클라이언트 직사각형에 상대적입니다.

 

justFlag

탭 필드 내 내용의 Justification입니다. 왼쪽/가운데/오른쪽 Justification에 대하여 DG_IS_LEFT, DG_IS_CENTER, DG_IS_RIGHT를 사용합니다.

 

truncFlag

만약 탭 필드에 전부 맞출 수 없다면 탭 필드의 텍스트를 절단하는 방법입니다. 가능한 값들은 다음과 같습니다:

Flag	Action
DG_IS_NOTRUNC	절단 없음.
DG_IS_TRUNCEND	끝에서 절단.
DG_IS_TRUNCMIDDLE	중간에서 절단. (텍스트 양끝에서 동일한 수의 문자 수만큼 남김)

 

hasSeparator

만약 이 flag가 세트되면, 각 리스트 박스 항목에서 이 탭 필드의 오른쪽 모서리에서 분리자 라인이 그려집니다. 분리자 라인 컬러는 DGListSetSeparatorLineColor 함수로 세트하거나 변경할 수 있습니다.

 

status

만약 이 flag가 false로 세트되면, 탭 필드가 비활성화됩니다. 그 외에는 활성화됩니다.

설명

리스트 박스 내 탭 필드들의 수는 DGListSetTabFieldCount로 세트됩니다. 기본적으로 모든 리스트 박스는 리스트의 클라이언트 영역 왼쪽에서 수직 스크롤 바의 왼쪽 모서리까지 확장되는 1개의 탭 필드를 갖고 있습니다. 이 항목의 내용은 왼쪽 정렬되며 만약 리스트 박스가 수평 스크롤 바를 갖고 있지 않으면 텍스트 끝에서 절단합니다. 그 외에는 절단하지 않습니다.

만약 탭 필드들이 중첩되거나 리스트 박스 항목에 맞지 않으면, 탭 필드들은 동일한 크기로 세트되어서 리스트 박스 항목에 강제로 맞출 것입니다. 만약 리스트 박스가 수평 스크롤 바를 갖고 있으면, 탭 필드들은 리스트 항목 크기로 확장되는 것이 허용됩니다.

수평 스크롤 바의 범위는 마지막 탭 필드의 속성에 따라 계산됩니다. 만약 이 필드에서 절단(truncation) flag 또는 사용자 업데이트 flag가 켜지면, 스크롤 바의 범위는 마지막 탭 필드의 마지막 위치와 동일합니다. 그 외에는 가장 긴 리스트 박스 항목의 내용으로부터 동적으로 계산됩니다.

탭 필드의 현재 속성들을 가져오기 위해 DGListGetTabFieldData를 사용하십시오.

요구사항

버전: DG 2.0.0 또는 이후

헤더: DG.h

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

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

참고사항

DG 함수, 리스트 박스, DGListGetTabFieldData
DGListSetTabFieldCount, DGListGetTabFieldCount, DGListSetTabItemText, DGListGetTabItemText, DGListSetTabItemIcon, DGListGetTabItemIcon, DGListGetTabItemIconId, DGListSetTabItemIconId