DGListSetTabData

이 structure는 더 이상 사용하지 않습니다. 대신 DGListSetTabFieldCount와 DGListSetTabFieldData를 사용하십시오.

리스트 박스의 탭 필드들의 개수와 프로퍼티들을 세트합니다.

    bool DGListSetTabData (
      short                dialId,
      short                item,
      short                nTabFields,
      const DGListTabData* tabData
    );

파라미터

dialId

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

 

item

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

 

nTabFields

탭 필드들의 개수입니다. 이 값은 최소한 1이어야 합니다.

 

tabData

탭 필드들의 데이터에 대한 포인터입니다.

리턴 값

만약 함수가 성공하면 true를 리턴합니다. 그 외에는 false를 리턴합니다. 만약 탭 필드들이 겹치거나 리스트 박스 항목 안에 들어가지 않는다면, 리스트 박스 항목 안에 억지로 들어가도록 동일한 크기로 세트되고 함수는 false를 리턴합니다. 만약 리스트 박스가 수평 스크롤 바를 갖고 있다면 탭 필드들은 리스트 항목 크기를 확장하도록 허용됩니다.

설명

The tabulator field data is assigned to the list box not to its items.

리스트 박스 항목들은 여러 개의 컬럼들로 나뉠 수 있습니다. 이 함수는 컬럼들의 개수를 세트하고 각 컬럼의 프로퍼티들을 동시에 설정하는 데 사용합니다. 이 문서에서는 "컬럼" 대신 "탭 필드"라는 표기법을 사용합니다. 그 이유는 리스트 항목 안에 있는 컬럼들의 텍스트들이 탭 ('\t') 문자들을 삽입하여 분리될 수 있기 때문입니다. 탭 필드들의 개수는 nTabFields로 주어지며, 탭 필드들의 크기, 정렬, 절단 프로퍼티들은 tabData의 DGListTabData structure 안에 정의되어 있습니다.

기본적으로 모든 리스트 박스는 1개의 탭 필드를 갖고 있습니다. 이것은 리스트의 클라이언트 영역의 왼쪽에서 수직 스크롤 바의 왼쪽 가장자리까지 확장되어 있습니다. 내용은 왼쪽 정렬되어 있고 텍스트는 끝에서 절단됩니다.

탭 필드의 내용은 각각 DGListGetTabItemText, DGListGetTabItemIcon, DGListGetTabItemIconId 그리고 DGListSetTabItemText, DGListSetTabItemIcon, DGListSetTabItemIconId 함수들을 통해 가져오거나 세트할 수 있습니다.

탭 필드의 텍스트를 변경하는 또 다른 방법이 있습니다: 먼저 DGListGetItemText로 리스트 항목의 텍스트를 가져오고 항목 텍스트에서 탭 ('\t') 문자들을 검색하여 지정한 탭 필드의 내용을 찾습니다. 그리고 나서 문자열 조작 함수들을 이용하여 적절한 2개의 탭 문자 사이의 예전 텍스트를 새로운 텍스트로 대체합니다. 그리고 DGListSetItemText로 새로운 항목 텍스트를 세트합니다. 이 방법은 더 이상 사용하지 않으며 역 호환성을 위해서만 유지되고 있습니다.

요구사항

버전: DG 2.0.0 또는 이후

헤더: DG.h

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

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

참고사항

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