LVBKIMAGEW 구조체(commctrl.h)

아티클
08/22/2023

목록 뷰 컨트롤의 배경 이미지에 대한 정보를 포함합니다. 이 구조체는 배경 이미지 정보를 설정하고 검색하는 데 사용됩니다.

구문

typedef struct tagLVBKIMAGEW {
  ULONG   ulFlags;
  HBITMAP hbm;
  LPWSTR  pszImage;
  UINT    cchImageMax;
  int     xOffsetPercent;
  int     yOffsetPercent;
} LVBKIMAGEW, *LPLVBKIMAGEW;

멤버

ulFlags

형식: ULONG

이 멤버는 다음 플래그 중 하나 이상일 수 있습니다. LVBKIF_SOURCE_MASK 값을 사용하여 원본 플래그를 제외한 모든 항목을 마스킹할 수 있습니다. LVBKIF_STYLE_MASK 값을 사용하여 스타일 플래그를 제외한 모든 항목을 마스킹할 수 있습니다.

값	의미
LVBKIF_SOURCE_NONE	목록 보기 컨트롤에는 배경 이미지가 없습니다.
LVBKIF_SOURCE_HBITMAP	백그라운드 비트맵은 LVBKIMAGE의 hbm 멤버를 통해 제공됩니다. 메시지가 LVM_SETBKIMAGE 성공하면 목록 보기가 비트맵의 소유권을 가져옵니다.
LVBKIF_SOURCE_URL	pszImage 멤버는 배경 이미지의 URL을 포함합니다.
LVBKIF_STYLE_NORMAL	배경 이미지가 정상적으로 표시됩니다.
LVBKIF_STYLE_TILE	배경 이미지는 컨트롤의 전체 배경을 채우기 위해 바일식으로 바꿉니다.
LVBKIF_FLAG_TILEOFFSET	첫 번째 타일의 좌표를 지정합니다. 이 플래그는 LVBKIF_STYLE_TILE 플래그도 지정된 경우에만 유효합니다. 이 플래그를 지정하지 않으면 첫 번째 타일이 클라이언트 영역의 왼쪽 위 모서리에서 시작됩니다. ComCtl32.dll 버전 6.0 을 사용하는 경우 xOffsetPercent 및 yOffsetPercent 필드에는 백분율 값이 아닌 픽셀이 포함되어 첫 번째 타일의 좌표를 지정합니다. Comctl32.dll 버전 6은 재배포할 수 없지만 Windows 이상에 포함되어 있습니다. 또한 매니페스트에서 Comctl32.dll 버전 6을 지정해야 합니다. 매니페스트에 대한 자세한 내용은 시각적 스타일 사용을 참조하세요.
LVBKIF_TYPE_WATERMARK	워터마크 배경 비트맵은 LVBKIMAGE의 hbm 멤버를 통해 제공됩니다. LVM_SETBKIMAGE 메시지가 성공하면 목록 보기 컨트롤이 비트맵의 소유권을 가져옵니다.
LVBKIF_FLAG_ALPHABLEND	LVBKIF_TYPE_WATERMARK 지정한 경우에만 유효합니다. 이 플래그는 LVBKIF_TYPE_WATERMARK 통해 제공되는 비트맵에 유효한 알파 채널이 포함되어 있음을 나타냅니다.

hbm

형식: HBITMAP

백그라운드 비트맵의 핸들입니다. 이 멤버는 LVBKIF_SOURCE_HBITMAP 플래그가 ulFlags로 설정된 경우에만 유효합니다.

pszImage

형식: LPTSTR

배경 이미지의 URL을 포함하는 NULL로 끝나는 문자열의 주소입니다. 이 멤버는 LVBKIF_SOURCE_URL 플래그가 ulFlags로 설정된 경우에만 유효합니다. 메시지를 보내기 전에 텍스트를 포함하거나 받는 버퍼를 가리키도록 이 멤버를 초기화해야 합니다.

cchImageMax

형식: UINT

pszImage의 주소에 있는 버퍼의 크기입니다. 정보가 컨트롤로 전송되는 경우 이 멤버는 무시됩니다.

xOffsetPercent

형식: int

이미지가 가로로 오프셋되어야 하는 컨트롤의 클라이언트 영역 백분율입니다. 예를 들어 0%에서 이미지는 컨트롤 클라이언트 영역의 왼쪽 가장자리에 표시됩니다. 50%에서 이미지는 컨트롤의 클라이언트 영역을 가운데에 가로로 표시합니다. 100%에서 이미지가 컨트롤 클라이언트 영역의 오른쪽 가장자리에 표시됩니다. 이 멤버는 LVBKIF_STYLE_NORMALulFlags에 지정된 경우에만 유효합니다. LVBKIF_FLAG_TILEOFFSET 및 LVBKIF_STYLE_TILE 둘 다 ulFlags에 지정된 경우 값은 첫 번째 타일의 백분율 오프셋이 아닌 픽셀을 지정합니다. 그렇지 않으면 값이 무시됩니다.

yOffsetPercent

형식: int

이미지가 세로로 오프셋되어야 하는 컨트롤의 클라이언트 영역 백분율입니다. 예를 들어 0%에서 이미지가 컨트롤 클라이언트 영역의 위쪽 가장자리에 표시됩니다. 50%에서 이미지는 컨트롤의 클라이언트 영역을 가운데에 세로로 표시합니다. 100%에서 이미지가 컨트롤 클라이언트 영역의 아래쪽 가장자리에 표시됩니다. 이 멤버는 LVBKIF_STYLE_NORMALulFlags에 지정된 경우에만 유효합니다. LVBKIF_FLAG_TILEOFFSET 및 LVBKIF_STYLE_TILE 둘 다 ulFlags에 지정된 경우 값은 첫 번째 타일의 백분율 오프셋이 아닌 픽셀을 지정합니다. 그렇지 않으면 값이 무시됩니다.

설명

이 구조체는 LVM_GETBKIMAGE 및 LVM_SETBKIMAGE 메시지와 함께 사용됩니다.

참고

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

요구 사항

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

다음을 통해 공유

LVBKIMAGEW 구조체(commctrl.h)

구문

멤버

설명

요구 사항

피드백

추가 리소스