共用方式為

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的資料。 這是與訊息一起擷取之專案的資料相同，TVM_GETITEM在結構TVITEM中使用適當的遮罩。 此資料是父系特定資料;父代可以儲存可協助識別樹狀結構專案或其他資訊的資訊。 為了方便起見， 資料會在 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