NMLVCUSTOMDRAW 구조체(commctrl.h)

  • 아티클

목록 뷰 컨트롤에서 보낸 NM_CUSTOMDRAW(목록 뷰) 알림 코드와 관련된 정보를 포함합니다.

구문

typedef struct tagNMLVCUSTOMDRAW {
  NMCUSTOMDRAW nmcd;
  COLORREF     clrText;
  COLORREF     clrTextBk;
  int          iSubItem;
  DWORD        dwItemType;
  COLORREF     clrFace;
  int          iIconEffect;
  int          iIconPhase;
  int          iPartId;
  int          iStateId;
  RECT         rcText;
  UINT         uAlign;
} NMLVCUSTOMDRAW, *LPNMLVCUSTOMDRAW;

멤버

nmcd

형식: NMCUSTOMDRAW

일반적인 사용자 지정 그리기 정보를 포함하는 NMCUSTOMDRAW 구조체입니다.

clrText

형식: COLORREF

목록 보기 컨트롤에서 텍스트 전경을 표시하는 데 사용할 색을 나타내는 COLORREF 값입니다.

clrTextBk

형식: COLORREF

목록 보기 컨트롤에서 텍스트 배경을 표시하는 데 사용할 색을 나타내는 COLORREF 값입니다. 버전 6.0. 에서 배경 이미지가 LVM_SETBKIMAGE 메시지로 설정된 경우 이 멤버는 무시됩니다.

iSubItem

형식: int

버전 4.71. 그려지는 하위 항목의 인덱스입니다. 기본 항목을 그리는 경우 이 멤버는 0이 됩니다.

dwItemType

형식: DWORD

버전 6.0.   그릴 항목의 형식을 포함하는 DWORD입니다. 이 멤버는 다음 값 중 하나일 수 있습니다.

값 의미
LVCDI_ITEM
 항목을 그릴 것입니다.
LVCDI_GROUP
 그룹을 그려야 합니다.
LVCDI_ITEMSLIST
 모든 항목을 그려야 합니다.

clrFace

형식: COLORREF

버전 6.0.항목의 얼굴을 표시하는 데 사용할 색을 나타내는 COLORREF 값입니다.

iIconEffect

형식: int

버전 6.0.  네온, 그림자 또는 펄스와 같은 아이콘에 적용되는 효과를 지정하는 int 형식의 값입니다.

iIconPhase

형식: int

버전 6.0.  아이콘의 위상을 지정하는 int 형식의 값입니다.

iPartId

형식: int

버전 6.0.  그릴 항목 부분의 ID를 지정하는 int 형식의 값입니다.

iStateId

형식: int

버전 6.0.  그릴 항목 상태의 ID를 지정하는 int 형식의 값입니다.

rcText

형식: RECT

버전 6.0.텍스트를 그릴 사각형을 지정하는 RECT입니다.

uAlign

형식: UINT

버전 6.0.그룹을 정렬하는 방법을 지정하는 UINT입니다. 이 멤버는 다음 값 중 하나일 수 있습니다.

값 의미
LVGA_HEADER_CENTER
 그룹을 가운데에 배치합니다.
LVGA_HEADER_LEFT
 왼쪽에 그룹을 맞춥니다.
LVGA_HEADER_RIGHT
 오른쪽에 그룹을 맞춥니다.

설명

Comctl32.dll 버전 6은 재배포할 수 없지만 Windows 이상에 포함되어 있습니다. Comctl32.dll 버전 6을 사용하려면 매니페스트에 지정합니다. 매니페스트에 대한 자세한 내용은 시각적 스타일 사용을 참조하세요.
 

요구 사항

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