NMTVASYNCDRAW 구조체(commctrl.h)

아이콘 또는 오버레이 트리 항목 그리기 실패 이유에 대한 설명이 포함되어 있습니다. 이 구조체는 TVN_ASYNCDRAW 알림에 전송됩니다. dwRetFlags 멤버를 설정하여 컨트롤이 수행해야 하는 작업을 나타냅니다. 이미지가 없으면 그리기는 실패할 수 있습니다. 즉, 아이콘 이미지가 추출되지 않은 경우입니다.

구문

typedef struct tagNMTVASYNCDRAW {
  NMHDR               hdr;
  IMAGELISTDRAWPARAMS *pimldp;
  HRESULT             hr;
  HTREEITEM           hItem;
  LPARAM              lParam;
  DWORD               dwRetFlags;
  int                 iRetImageIndex;
} NMTVASYNCDRAW;

멤버

hdr

형식: NMHDR

NMHDR 구조체.

pimldp

형식: IMAGELISTDRAWPARAMS*

그리지 못한 이미지를 설명하는 IMAGELISTDRAWPARAMS 구조체입니다.

hr

형식: HRESULT

ILDRF_IMAGELOWQUALITY, ILDRF_OVERLAYLOWQUALITY, E_PENDING 또는 S_OK 그리기 실패 이유를 나타내는 결과 코드입니다. S_OK 코드는 이미지가 있지만 필요한 이미지 품질에는 없음을 나타냅니다.

hItem

형식: HTREEITEM

그리지 못한 트리 항목의 핸들입니다.

lParam

형식: LPARAM

hItem에 대한 데이터입니다. 이는 TVITEM 구조의 적절한 마스크를 사용하여 메시지 TVM_GETITEM 검색되는 항목과 동일한 데이터입니다. 이 데이터는 부모에 따라 다릅니다. 부모는 트리 항목 또는 기타 정보를 식별하는 데 도움이 되는 정보를 저장할 수 있습니다. 데이터는 편의를 위해 lParam 에 제공되므로 부모는 메시지 TVM_GETITEM 보낼 필요가 없습니다.

dwRetFlags

형식: DWORD

보낸 사람(트리 뷰 컨트롤)이 반환할 때 실행해야 하는 작업입니다. 값은 다음 플래그 중 하나여야 합니다.

값	의미
ADRF_DRAWIMAGE	iRetImageIndex에서 지정한 이미지를 그립니다.
ADRF_DRAWSYNC	이미지를 계속 그리세요. 즉, 이미지와 페인트를 동기적으로 추출합니다. 컨트롤이 UI 스레드에 있다고 가정하면 추출 시간이 다를 수 있고 추출하는 동안 UI가 장시간 응답하지 않을 수 있으므로 이 플래그를 사용하는 것은 우선 순위가 낮은 UI 성능을 의미합니다.
ADRF_DRAWNOTHING	이미지를 그리지 마세요.

iRetImageIndex

형식: int

이미지 목록에 그릴 이미지의 인덱스입니다. dwRetFlags에서 ADRF_DRAWIMAGE 반환되는 경우에 사용됩니다.

요구 사항

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