TVINSERTSTRUCT

包含添加新項到樹形視控件所使用的信息。這個結構被TVM_INSERTITEM消息使用。這個結構與TV_INSERTSTRUCT結構是一樣的，但它已經按當前的命名習慣重命名了。

typedef struct tagTVINSERTSTRUCT {
HTREEITEM hParent;
HTREEITEM hInsertAfter;
#if (_WIN32_IE >= 0x0400)
union
{
TVITEMEX itemex;
TVITEM item;
} DUMMYUNIONNAME;
#else
TVITEM item;
#endif
} TVINSERTSTRUCT, FAR *LPTVINSERTSTRUCT;

成員

hParent

父項的句柄。如果這個成員的值是TVI_ROOT或NULL，這項將被作為樹形控件的根插入。

hInsertAfter

插入的新項之后的項的句柄。或是下列值之一：

值	意味
TVI_FIRST	在列表的開始插入項
TVI_LAST	在列表的最后插入項
TVI_ROOT	作為一個根項添加
TVI_SORT	以字母順序插入項

itemex

版本4.71。TVITEMEX包含關于項添加的信息。

item

TVITEM包含關于項添加的信息。

需求

   Windows NT/2000：需要Windows NT 3.51或更高版本。
   Windows 95/98：需要Windows 95或更高版本。
   Header：定義在commctrl.h。

TVITEM

指定或接收樹形視項的屬性。這個結構與TV_ITEM結構一樣，但它已經被當前命名協議重新命名了。新的應用程序應該使用這個結構。

typedef struct tagTVITEM{
UINT      mask;
HTREEITEM hItem;
UINT      state;
UINT      stateMask;
LPTSTR    pszText;
int       cchTextMax;
int       iImage;
int       iSelectedImage;
int       cChildren;
LPARAM    lParam;
} TVITEM, FAR *LPTVITEM;

成員

mask

指出其它的結構成員哪些包含有效數據的標記數組。當這個結構被TVM_GETITEM消息使用時，mask成員指出項的屬性被取回。這個成員可以是下列值的一個或多個。

TVIF_CHILDREN	cChildren成員是有效的。
TVIF_DI_SETITEM	樹形視控件將保留支持信息并且不重新請求它。當處理TVN_GETDISPINF通知時，這個標記是有效的。
TVIF_HANDLE	hItem成員有效。
TVIF_IMAGE	iImage成員有效。
TVIF_PARAM	lParam成員有效。
TVIF_SELECTEDIMAGE	iSelectedImage成員有效。
TVIF_STATE	state和stateMask成員有效。
TVIF_TEXT	pszText和cchTextMax成員有效。

hItem

這個函數引用的項。

state

位標記和圖像列表索引的設置，指出項的狀態。當設置了一個項的狀態，stateMask成員指出這個成員的位是有效的。當取加一個項的狀態時，這個成員返回stateMask成員指出的位的當前狀態。

這個成員的0至7位包含了項的狀態標記。關于可能的項狀態標記，參見Tree View Control Item States.

覆蓋圖像覆蓋在項的圖標圖像之上。這個成員的8至11位指定了以1為基準的覆蓋圖像索引。如果這些位是0，這個項沒有覆蓋圖像。要隔離這些位，使用TVIS_OVERLAYMASK掩碼。要在這個成員中設置覆蓋圖像索引，使用INDEXTOOVERLAYMASK宏。圖像列表的覆蓋圖像是被ImageList_SetOverlayImage函數設置的。

一個狀態圖像是僅次于指出應用程序定義的狀態的項的圖標顯示的。通過發送TVM_SETIMAGELIST消息來指定一個狀態圖像列表。要設置一個項的狀態圖像，在TVITEM結構的stateMask成員中包含TVIS_STATEIMAGEMASK值。結構的state成員的12至15位指定狀態圖像列表中被繪制圖像的索引。

要設置狀態圖像索引，使用INDEXTOSTATEIMAGEMASK。這個宏把一個索引適當的設置到12至15位上。要指出項沒有狀態圖像，設置索引為0。這意味著在狀態圖像列表中的圖像0不能被作為一個狀態圖像使用。要隔離state成員的位12至15，使用TVIS_STATEIMAGEMASK掩碼。

stateMask

state成員的位是有效的。如果你取回了一個項的狀態，設置stateMask成員的位來指出state成員中的這個位被返回。如果你設置了一個項的狀態，設置stateMask成員的位來指出state成員的這個位是你想設置的。要設置或取回一個項的覆蓋圖像的索引，設置TVIS_OVERLAYMASK位。要設置和取回一個項的狀態圖像索引，設置TVIS_STATEIMAGEMASK位。

pszText

如果這個結構指定了項屬性，那么這個成員是指向一個以空字符結束的字符串，包含有項的文本。如果這個成員是值LPSTR_TEXTCALLBACK，那么父窗口為保存名字負責。既然這樣，當樹形視控件需要顯示、保存或編輯項文本時，向父窗口發送TVN_GETDISPINFO通過消息，當項文本改變時，發送TVN_SETDISPINFO通知消息。

如果結構是取回項的屬性，這個成員是取回項文本緩沖的地址。

cchTextMax

pszText成員指定緩沖的大小，以字符為單位。如果這個結構被使用來設置項屬性，這個成員被忽略。

iImage

當項是在非選擇狀態中時，是樹形控件的圖像列表的索引。

如果這個成員是值I_IMAGECALLBACK，父窗口為保存索引負責。既然這樣，當樹形視控件需要顯示這個圖像時，向父窗口發送TVN_GETDISPINFO通知消息來獲得索引。

iSelectedImage

當項被選擇時，是樹形控件圖像列表的索引。

如果這個成員是值I_IMAGECALLBACK，父窗口為保存索引負責。既然這樣，當樹形視控件需要顯示這個圖像時，向父窗口發送TVN_GETDISPINFO通知消息來獲得索引。

cChildren

標記指出哪一個項有關聯的子項。這個成員可以是下列值之一。

zero	這個項沒有子項。
one	這個項有一個或更多的子項。
I_CHILDRENCALLBACK	The parent window keeps track of whether the item has child items. In this case, when the tree view control needs to display the item, the control sends the parent a TVN_GETDISPINFO notification message to determine whether the item has child items. If the tree view control has the TVS_HASBUTTONS style, it uses this member to determine whether to display the button indicating the presence of child items. You can use this member to force the control to display the button even though the item does not have any child items inserted. This allows you to display the button while minimizing the control's memory usage by inserting child items only when the item is visible or expanded.

lParam

與這項相關的32位值。

需要

   Windows NT/2000：需要Windows NT 3.51或更高版本。
   Windows 95/98：需要Windows 95或更高版本。
   Header：定義在commctrl.h。

NMTREEVIEW

包含關于樹形視通知消息的信息。這個結構與NM_TREEVIEW結構一樣，但它已經用當前的命名規則進行了重命名。

typedef struct tagNMTREEVIEW {
NMHDR hdr;
UINT action;
TVITEM itemOld;
TVITEM itemNew;
POINT ptDrag;
} NMTREEVIEW, FAR *LPNMTREEVIEW;

成員

hdr

NMHDR結構，包含了關于這個通知消息的信息

action

通知指定的動作標記。

itemOld

包含關于舊項狀態信息的TVITEM結構。通知消息沒有使用它時，這個成員為0。

itemNew

包含關于新項狀態信息的TVITEM結構。通知消息沒有使用它時，這個成員為0。

ptDrag

包含引起通知消息發送的事件信息的POINT結構。

參見

WM_NOTIFY