다음을 통해 공유

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이거나 다음 값 중 하나 이상일 수 있습니다.

값 의미
LVCF_FMT
 fmt 멤버가 유효합니다.
LVCF_WIDTH
 cx 멤버가 유효합니다.
LVCF_TEXT
 pszText 멤버가 유효합니다.
LVCF_SUBITEM
 iSubItem 멤버가 유효합니다.
LVCF_IMAGE

버전 4.70. iImage 멤버가 유효합니다.
LVCF_ORDER

버전 4.70. iOrder 멤버가 유효합니다.
LVCF_MINWIDTH

버전 6.00 및 Windows Vista를 .cxMin 멤버가 유효합니다.
LVCF_DEFAULTWIDTH

버전 6.00 및 Windows Vista를 .cxDefault 멤버가 유효합니다.
LVCF_IDEALWIDTH

버전 6.00 및 Windows Vista를 .cxIdeal 멤버가 유효합니다.

fmt

형식: int

열 머리글 및 열의 하위 항목 텍스트 맞춤입니다. 맨 왼쪽 열의 맞춤은 항상 LVCFMT_LEFT; 변경할 수 없습니다. 이 멤버는 다음 값의 조합일 수 있습니다. 모든 조합이 유효한 것은 아닙니다.

값 의미
LVCFMT_LEFT
 텍스트가 왼쪽 맞춤입니다.
LVCFMT_RIGHT
 텍스트가 오른쪽 맞춤입니다.
LVCFMT_CENTER
 텍스트가 가운데에 배치됩니다.
LVCFMT_JUSTIFYMASK
 필드 근거를 제어하는 fmt 해당 비트를 선택하는 데 사용되는 비트 마스크입니다. 열 형식을 확인하려면 논리적 "and"를 사용하여 LCFMT_JUSTIFYMASK fmt결합합니다. 그런 다음 switch 문을 사용하여 LVCFMT_LEFT, LVCFMT_RIGHT 또는 LVCFMT_CENTER 비트가 설정되었는지 여부를 확인할 수 있습니다.
LVCFMT_IMAGE

버전 4.70. 항목은 이미지 목록의 이미지를 표시합니다.
LVCFMT_BITMAP_ON_RIGHT

버전 4.70. 비트맵이 텍스트 오른쪽에 나타납니다. 헤더 항목에 할당된 이미지 목록의 이미지에는 영향을 주지 않습니다.
LVCFMT_COL_HAS_IMAGES

버전 4.70. 헤더 항목은 이미지 목록에 이미지를 포함합니다.
LVCFMT_FIXED_WIDTH

버전 6.00 및 Windows Vista를 . 열의 크기를 조정할 수 없습니다. HDF_FIXEDWIDTH 동일합니다.
LVCFMT_NO_DPI_SCALE

버전 6.00 및 Windows Vista를 . 설정하지 않으면 CCM_DPISCALE 고정 너비를 확장하는 것을 제어합니다.
LVCFMT_FIXED_RATIO

버전 6.00 및 Windows Vista를 . Width는 행 높이로 보강됩니다.
LVCFMT_SPLITBUTTON

버전 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 헤더는 LVCOLUMN을 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입대한 규칙을 참조하세요.

요구 사항

요구 값
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
헤더 commctrl.h

참고 항목

LVM_DELETECOLUMN

LVM_GETCOLUMN

LVM_INSERTCOLUMN

LVM_SETCOLUMN

참조