树型视的三个结构

梦里梦外; 2022-09-20 05:58 248阅读 0赞

# 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**

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

<table> 
 <tbody> 
  <tr> 
   <th>值</th> 
   <th>意味</th> 
  </tr> 
  <tr> 
   <td>TVI_FIRST</td> 
   <td>在列表的开始插入项</td> 
  </tr> 
  <tr> 
   <td>TVI_LAST</td> 
   <td>在列表的最后插入项</td> 
  </tr> 
  <tr> 
   <td>TVI_ROOT</td> 
   <td>作为一个根项添加</td> 
  </tr> 
  <tr> 
   <td>TVI_SORT</td> 
   <td>以字母顺序插入项</td> 
  </tr> 
 </tbody> 
</table>

**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**成员指出项的属性被取回。这个成员可以是下列值的一个或多个。

<table> 
 <tbody> 
  <tr> 
   <td>TVIF_CHILDREN</td> 
   <td><strong>cChildren</strong>成员是有效的。</td> 
  </tr> 
  <tr> 
   <td>TVIF_DI_SETITEM</td> 
   <td>树形视控件将保留支持信息并且不重新请求它。当处理TVN_GETDISPINF通知时，这个标记是有效的。</td> 
  </tr> 
  <tr> 
   <td>TVIF_HANDLE</td> 
   <td><strong>hItem</strong>成员有效。</td> 
  </tr> 
  <tr> 
   <td>TVIF_IMAGE</td> 
   <td><strong>iImage</strong>成员有效。</td> 
  </tr> 
  <tr> 
   <td>TVIF_PARAM</td> 
   <td><strong>lParam</strong>成员有效。</td> 
  </tr> 
  <tr> 
   <td>TVIF_SELECTEDIMAGE</td> 
   <td><strong>iSelectedImage</strong>成员有效。</td> 
  </tr> 
  <tr> 
   <td>TVIF_STATE</td> 
   <td><strong>state</strong>和<strong>stateMask</strong>成员有效。</td> 
  </tr> 
  <tr> 
   <td>TVIF_TEXT</td> 
   <td><strong>pszText</strong>和<strong>cchTextMax</strong>成员有效。</td> 
  </tr> 
 </tbody> 
</table>

**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**

当项被选择时，是树形控件图像列表的索引。

**cChildren**

标记指出哪一个项有关联的子项。这个成员可以是下列值之一。

<table> 
 <tbody> 
  <tr> 
   <td>zero</td> 
   <td>这个项没有子项。</td> 
  </tr> 
  <tr> 
   <td>one</td> 
   <td>这个项有一个或更多的子项。</td> 
  </tr> 
  <tr> 
   <td>I_CHILDRENCALLBACK</td> 
   <td>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. <p>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.</p> </td> 
  </tr> 
 </tbody> 
</table>

**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结构。

#### 参见 ####