please dont rip this site Prev Next

TV_ITEM info  Overview  Group

The TV_ITEM structure specifies or receives attributes of a tree-view item.

typedef struct _TV_ITEM {  tvi 

    UINT       mask; 

    HTREEITEM  hItem; 

    UINT       state; 

    UINT       stateMask; 

    LPSTR      pszText; 

    int        cchTextMax; 

    int        iImage; 

    int        iSelectedImage; 

    int        cChildren; 

    LPARAM     lParam; 

} TV_ITEM, FAR *LPTV_ITEM; 

 

Members

mask
Array of flags that indicate which of the other structure members contain valid data. When this structure is used with the TVM_GETITEM message, the mask member indicates the item attributes to retrieve. This member can be a combination of the following values:

Value

Meaning

TVIF_CHILDREN

The cChildren member is valid.

TVIF_HANDLE

The hItem member is valid.

TVIF_IMAGE

The iImage member is valid.

TVIF_PARAM

The lParam member is valid.

TVIF_SELECTEDIMAGE

The iSelectedImage member is valid.

TVIF_STATE

The state and stateMask members are valid.

TVIF_TEXT

The pszText and cchTextMax members are valid.

hItem
Identifies the item to which this structure refers.
state
A set of bit flags and image list indexes that indicate the itemís state. The stateMask member indicates the valid bits of the state member.

For a list of item state bit flags, see Tree-View Item States. For information about the state image and overlay image indexes, see Tree-View Image Lists.

When setting the state of an item, the stateMask member indicates the bits of the state member that are valid. When retrieving the state of an item, the state member returns the current state for the bits indicated in the stateMask member.

stateMask
Specifies the bits of the state member that are valid. If you are retrieving an itemís state, set the bits of the stateMask member to indicate the bits to be returned in the state member. If you are setting an itemís state, set the bits of the stateMask member to indicate the bits of the state member that you want to set. To set or retrieve an itemís overlay image index, set the TVIS_OVERLAYMASK bits. To set or retrieve an itemís state image index, set the TVIS_STATEIMAGEMASK bits.
pszText
Pointer to a null-terminated string that contains the item text if the structure specifies item attributes. If this member is the LPSTR_TEXTCALLBACK value, the parent window is responsible for storing the name. In this case, the tree-view control sends the parent window a TVN_GETDISPINFO notification message when it needs the item text for displaying, sorting, or editing, and a TVN_SETDISPINFO notification message when the item text changes.

If the structure is receiving item attributes, this member is the pointer to the buffer that receives the item text.

cchTextMax
Size of the buffer pointed to by the pszText member if the structure is receiving item attributes. If the structure specifies item attributes, this member is ignored.
iImage
Index in the tree-view controlís image list of the icon image to use when the item is in the non-selected state.

If this member is the I_IMAGECALLBACK value, the parent window is responsible for storing the index. In this case, the tree-view control sends the parent a TVN_GETDISPINFO notification message to get the index when it needs to display the image.

iSelectedImage
Index in the tree-view controlís image list of the icon image to use when the item is in the selected state.

If this member is the I_IMAGECALLBACK value, the parent window is responsible for storing the index. In this case, the tree-view control sends the parent a TVN_GETDISPINFO notification message to get the index when it needs to display the image.

cChildren
Flag that indicates whether the item has associated child items. This member is one of the following values:

Value

Meaning

zero

The item has no child items.

1

The item has one or more child items.

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
A 32-bit value to associate with the item.

Remarks

This structure is used with the TVM_GETITEM, TVM_SETITEM, and TVM_INSERTITEM messages. It is also included with many of the notification messages. When the structure is used to retrieve item information, only the structure members indicated by mask contain valid data. All other members are invalid.

See Also

TVN_GETDISPINFO, TVM_GETITEM, TVM_INSERTITEM, TVN_SETDISPINFO, TVM_SETITEM 

See also:


file: /Techref/os/win/api/win32/struc/src/str22_10.htm, 8KB, , updated: 2000/4/7 12:20, local time: 2022/5/22 13:55,
TOP NEW HELP FIND: 
35.170.82.159:LOG IN

 ©2022 These pages are served without commercial sponsorship. (No popup ads, etc...).Bandwidth abuse increases hosting cost forcing sponsorship or shutdown. This server aggressively defends against automated copying for any reason including offline viewing, duplication, etc... Please respect this requirement and DO NOT RIP THIS SITE. Questions?
Please DO link to this page! Digg it! / MAKE!

<A HREF="http://www.piclist.com/techref/os/win/api/win32/struc/src/str22_10.htm"> TV_ITEM</A>

After you find an appropriate page, you are invited to your to this massmind site! (posts will be visible only to you before review) Just type a nice message (short messages are blocked as spam) in the box and press the Post button. (HTML welcomed, but not the <A tag: Instead, use the link box to link to another page. A tutorial is available Members can login to post directly, become page editors, and be credited for their posts.


Link? Put it here: 
if you want a response, please enter your email address: 
Attn spammers: All posts are reviewed before being made visible to anyone other than the poster.
Did you find what you needed?

  PICList 2022 contributors:
o List host: MIT, Site host massmind.org, Top posters @20220522
* Page Editors: James Newton, David Cary, and YOU!
* Roman Black of Black Robotics donates from sales of Linistep stepper controller kits.
* Ashley Roll of Digital Nemesis donates from sales of RCL-1 RS232 to TTL converters.
* Monthly Subscribers: Gregg Rew. on-going support is MOST appreciated!
* Contributors: Richard Seriani, Sr.
 

Welcome to www.piclist.com!

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

  .