LVCOLUMNA 구조체(commctrl.h)

아티클
08/22/2023

보고서 뷰의 열에 대한 정보를 포함합니다. 이 구조체는 열을 만들고 조작하는 데 모두 사용됩니다. 이 구조체는 LV_COLUMN 구조체를 대체합니다.

구문

typedef struct tagLVCOLUMNA {
  UINT  mask;
  int   fmt;
  int   cx;
  LPSTR pszText;
  int   cchTextMax;
  int   iSubItem;
  int   iImage;
  int   iOrder;
  int   cxMin;
  int   cxDefault;
  int   cxIdeal;
} LVCOLUMNA, *LPLVCOLUMNA;

멤버

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. 너비는 행 높이로 보강됩니다.
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

추가 정보

참조

LVCOLUMNA 구조체(commctrl.h)

구문

멤버

설명

요구 사항

추가 정보

피드백

피드백

추가 리소스