TreeView_SetCheckState巨集（commctrl.h）

將專案的狀態影像設定為「已核取」或「未核取」。您也可以直接使用 TVM_SETITEM 訊息。

語法

UINT TreeView_SetCheckState(
   HWND      hwndTV,
   HTREEITEM hti,
   BOOL      fCheck
);

hwndTV

類型：HWND

樹視圖控件的句柄。

hti

類型：HTREEITEM

專案的句柄。

fCheck

類型：BOOL

值，指出顯示哪個狀態影像。 將 fCheck 設定為 TRUE，以顯示已核取的狀態影像或 FALSE 以顯示未核取的影像。

類型：UINT

不會使用傳回值。

樹視圖控件可以有兩個影像清單。一般影像清單會儲存選取、非選取和重疊影像。選取框會儲存在狀態影像清單中，並顯示在對應的一般影像左邊。狀態映像是由一個以單一為基礎的索引所指定。零的索引表示沒有狀態映像。如需如何處理樹視圖影像的討論，請參閱 Tree-View 影像清單。

如果您想要定義自己的狀態映射，此巨集假設已核取和未核取的映射索引與標準映射清單具有相同的索引：1 表示未核取，2 表示已核取。