LVCOLUMNW 구조체(commctrl.h)
보고서 뷰의 열에 대한 정보를 포함합니다. 이 구조체는 열을 만들고 조작하는 데 모두 사용됩니다. 이 구조체는 LV_COLUMN 구조체를 대체합니다.
구문
typedef struct tagLVCOLUMNW {
UINT mask;
int fmt;
int cx;
LPWSTR pszText;
int cchTextMax;
int iSubItem;
int iImage;
int iOrder;
int cxMin;
int cxDefault;
int cxIdeal;
} LVCOLUMNW, *LPLVCOLUMNW;
멤버
mask
형식: UINT
유효한 정보를 포함하는 멤버를 지정하는 변수입니다. 이 멤버는 0이거나 다음 값 중 하나 이상일 수 있습니다.
| 값 | 의미 |
|---|---|
|
fmt 멤버가 유효합니다. |
|
cx 멤버가 유효합니다. |
|
pszText 멤버가 유효합니다. |
|
iSubItem 멤버가 유효합니다. |
|
버전 4.70. iImage 멤버가 유효합니다. |
|
버전 4.70. iOrder 멤버가 유효합니다. |
|
버전 6.00 및 Windows Vista.cxMin 멤버가 유효합니다. |
|
버전 6.00 및 Windows Vista.cxDefault 멤버가 유효합니다. |
|
버전 6.00 및 Windows Vista.cxIdeal 멤버가 유효합니다. |
fmt
형식: int
열 머리글 및 열의 하위 항목 텍스트 맞춤입니다. 맨 왼쪽 열의 맞춤은 항상 LVCFMT_LEFT. 변경할 수 없습니다. 이 멤버는 다음 값의 조합일 수 있습니다. 모든 조합이 유효한 것은 아닙니다.
| 값 | 의미 |
|---|---|
|
텍스트가 왼쪽 맞춤입니다. |
|
텍스트가 오른쪽 맞춤입니다. |
|
텍스트를 가운데에 맞춥니다. |
|
필드 근거를 제어하는 fmt 비트를 선택하는 데 사용되는 비트 마스크입니다. 열 형식을 검사 논리 "and"를 사용하여 LCFMT_JUSTIFYMASK fmt와 결합합니다. 그런 다음 switch 문을 사용하여 LVCFMT_LEFT, LVCFMT_RIGHT 또는 LVCFMT_CENTER 비트가 설정되었는지 여부를 확인할 수 있습니다. |
|
버전 4.70. 항목은 이미지 목록의 이미지를 표시합니다. |
|
버전 4.70. 비트맵이 텍스트 오른쪽에 나타납니다. 헤더 항목에 할당된 이미지 목록의 이미지에는 영향을 주지 않습니다. |
|
버전 4.70. 헤더 항목은 이미지 목록에 이미지를 포함합니다. |
|
버전 6.00 및 Windows Vista. 열의 크기를 조정할 수 없습니다. HDF_FIXEDWIDTH 동일합니다. |
|
버전 6.00 및 Windows Vista. 설정하지 않으면 CCM_DPISCALE 고정 너비 확장이 제어됩니다. |
|
버전 6.00 및 Windows Vista. 너비는 행 높이로 보강됩니다. |
|
버전 6.00 및 Windows Vista. 열은 분할 단추(HDF_SPLITBUTTON)입니다. 열의 머리글에는 분할 단추(HDF_SPLITBUTTON와 동일)가 표시됩니다. |
cx
형식: int
열의 너비(픽셀)입니다.
pszText
형식: LPTSTR
열 정보를 설정하는 경우 이 멤버는 열 머리글 텍스트를 포함하는 null로 끝나는 문자열의 주소입니다. 구조체가 열에 대한 정보를 수신하는 경우 이 멤버는 열 머리글 텍스트를 받는 버퍼의 주소를 지정합니다.
cchTextMax
형식: int
pszText 멤버가 가리키는 버퍼의 TCHAR크기입니다. 구조체가 열에 대한 정보를 받지 못하면 이 멤버는 무시됩니다.
iSubItem
형식: int
열과 연결된 하위 항목의 인덱스입니다.
iImage
형식: int
버전 4.70. 이미지 목록 내 이미지의 인덱스(0부터 시작)입니다. 지정된 이미지가 열 내에 표시됩니다.
iOrder
형식: int
버전 4.70. 0부터 시작하는 열 오프셋입니다. 열 오프셋은 왼쪽에서 오른쪽 순서로 표시됩니다. 예를 들어 0은 맨 왼쪽 열을 나타냅니다.
cxMin
형식: int
Windows Vista. 열의 최소 너비(픽셀)입니다.
cxDefault
형식: int
Windows Vista. 애플리케이션 정의 값은 일반적으로 열의 기본 너비를 저장하는 데 사용됩니다. 이 멤버는 목록 보기 컨트롤에서 무시됩니다.
cxIdeal
형식: int
Windows Vista. 읽기 전용입니다. 열이 현재 더 작은 너비로 자동 크기가 조정될 수 있으므로 열의 이상적인 너비(픽셀)입니다.
설명
인덱스 0(맨 왼쪽 열)이 있는 목록 보기 컨트롤에 열이 추가되면 항상 LVCFMT_LEFT. 열 0에 다른 플래그를 설정해도 해당 맞춤이 재정의되지 않습니다. 따라서 인덱스 0이 있는 열을 계속 삽입하면 모든 열의 텍스트가 왼쪽에 정렬됩니다. 첫 번째 열을 오른쪽 맞춤 또는 가운데에 맞추려면 더미 열을 만들고 인덱스 1 이상이 있는 하나 이상의 열을 삽입하고 필요한 맞춤을 지정할 수 있습니다. 마지막으로 더미 열을 삭제합니다.
참고
commctrl.h 헤더는 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 LVCOLUMN을 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.
요구 사항
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 머리글 | commctrl.h |
추가 정보
참조