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と共に取得される項目のデータと同じです。 このデータは親固有です。親は、ツリー項目またはその他の情報を識別するのに役立つ情報を格納できます。 便宜上、親がメッセージ TVM_GETITEMを送信する必要がないように、データは lParam で提供されます。

dwRetFlags

型: DWORD

送信者 (ツリー ビュー コントロール) が戻り時に実行する必要があるアクション。 値は、次のいずれかのフラグである必要があります。

値 意味
ADRF_DRAWIMAGE
 iRetImageIndex で指定されたイメージを描画します。
ADRF_DRAWSYNC
 イメージの描画に進みます。つまり、イメージを同期的に抽出してペイントします。 コントロールが UI スレッド上にある場合、このフラグを使用すると、抽出時間が異なる場合があり、抽出中に UI が長時間応答しなくなる可能性があるため、このフラグを使用すると、UI のパフォーマンスが低いことを意味します。
ADRF_DRAWNOTHING
 イメージを描画しないでください。

iRetImageIndex

型: int

画像リストに描画するイメージのインデックス。 dwRetFlags でADRF_DRAWIMAGEが返される場合に使用されます。

要件

   
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
Header commctrl.h