This section contains information about the API elements used with tree-view controls.

Overviews

About Tree-View Controls

A tree-view control is a window that displays a hierarchical list of items, such as the headings in a document, the entries in an index, or the files and directories on a disk.

Using Tree-View Controls

This section contains implementation details and example code for working with tree-view controls.

Macros

TreeView_CreateDragImage

Creates a dragging bitmap for the specified item in a tree-view control. The macro also creates an image list for the bitmap and adds the bitmap to the image list. An application can display the image when dragging the item by using the image list functions. You can use this macro or send the TVM_CREATEDRAGIMAGE message explicitly.

TreeView_DeleteAllItems

Deletes all items from a tree-view control.

TreeView_DeleteItem

Removes an item and all its children from a tree-view control. You can also send the TVM_DELETEITEM message explicitly.

TreeView_EditLabel

Begins in-place editing of the specified item's text, replacing the text of the item with a single-line edit control containing the text. This macro implicitly selects and focuses the specified item. You can use this macro or send the TVM_EDITLABEL message explicitly.

TreeView_EndEditLabelNow

Ends the editing of a tree-view item's label. You can use this macro or send the TVM_ENDEDITLABELNOW message explicitly.

TreeView_EnsureVisible

Ensures that a tree-view item is visible, expanding the parent item or scrolling the tree-view control, if necessary. You can use this macro or send the TVM_ENSUREVISIBLE message explicitly.

TreeView_Expand

The TreeView_Expand macro expands or collapses the list of child items associated with the specified parent item, if any. You can use this macro or send the TVM_EXPAND message explicitly.

TreeView_GetBkColor

Retrieves the current background color of the control. You can use this macro or send the TVM_GETBKCOLOR message explicitly.

TreeView_GetCheckState

Gets the check state of the specified item. You can also use the TVM_GETITEMSTATE message directly.

TreeView_GetChild

Retrieves the first child item of the specified tree-view item. You can use this macro, or you can explicitly send the TVM_GETNEXTITEM message with the TVGN_CHILD flag.

TreeView_GetCount

Retrieves a count of the items in a tree-view control. You can use this macro or send the TVM_GETCOUNT message explicitly.

TreeView_GetDropHilight

Retrieves the tree-view item that is the target of a drag-and-drop operation. You can use this macro, or you can explicitly send the TVM_GETNEXTITEM message with the TVGN_DROPHILITE flag.

TreeView_GetEditControl

Retrieves the handle to the edit control being used to edit a tree-view item's text. You can use this macro or send the TVM_GETEDITCONTROL message explicitly.

TreeView_GetExtendedStyle

Retrieves the extended style for a specified tree-view control. Use this macro or send the TVM_GETEXTENDEDSTYLE message explicitly.

TreeView_GetFirstVisible

Retrieves the first visible item in a tree-view control window. You can use this macro, or you can explicitly send the TVM_GETNEXTITEM message with the TVGN_FIRSTVISIBLE flag.

TreeView_GetImageList

Retrieves the handle to the normal or state image list associated with a tree-view control. You can use this macro or send the TVM_GETIMAGELIST message explicitly.

TreeView_GetIndent

Retrieves the amount, in pixels, that child items are indented relative to their parent items. You can use this macro or send the TVM_GETINDENT message explicitly.

TreeView_GetInsertMarkColor

Retrieves the color used to draw the insertion mark for the tree view. You can use this macro or send the TVM_GETINSERTMARKCOLOR message explicitly.

TreeView_GetISearchString

Retrieves the incremental search string for a tree-view control. The tree-view control uses the incremental search string to select an item based on characters typed by the user. You can use this macro or send the TVM_GETISEARCHSTRING message explicitly.

TreeView_GetItem

Retrieves some or all of a tree-view item's attributes. You can use this macro or send the TVM_GETITEM message explicitly.

TreeView_GetItemHeight

Retrieves the current height of the tree-view items. You can use this macro or send the TVM_GETITEMHEIGHT message explicitly.

TreeView_GetItemPartRect

Retrieves the largest possible bounding rectangle that constitutes the "hit zone" for a specified part of an item. Use this macro or send the TVM_GETITEMPARTRECT message explicitly.

TreeView_GetItemRect

Retrieves the bounding rectangle for a tree-view item and indicates whether the item is visible. You can use this macro or send the TVM_GETITEMRECT message explicitly.

TreeView_GetItemState

Retrieves some or all of a tree-view item's state attributes. You can use this macro or send the TVM_GETITEMSTATE message explicitly.

TreeView_GetLastVisible

Retrieves the last expanded item in a tree-view control. This does not retrieve the last item visible in the tree-view window. You can use this macro, or you can explicitly send the TVM_GETNEXTITEM message with the TVGN_LASTVISIBLE flag.

TreeView_GetLineColor

Gets the current line color. You can also use the TVM_GETLINECOLOR message directly.

TreeView_GetNextItem

Retrieves the tree-view item that bears the specified relationship to a specified item. You can use this macro, use one of the TreeView_Get macros described below, or send the TVM_GETNEXTITEM message explicitly.

TreeView_GetNextSelected

Retrieves the tree-view item that bears the TVGN_NEXTSELECTED relationship to a specified tree item.

TreeView_GetNextSibling

Retrieves the next sibling item of a specified item in a tree-view control. You can use this macro, or you can explicitly send the TVM_GETNEXTITEM message with the TVGN_NEXT flag.

TreeView_GetNextVisible

Retrieves the next visible item that follows a specified item in a tree-view control. You can use this macro, or you can explicitly send the TVM_GETNEXTITEM message with the TVGN_NEXTVISIBLE flag.

TreeView_GetParent

Retrieves the parent item of the specified tree-view item. You can use this macro, or you can explicitly send the TVM_GETNEXTITEM message with the TVGN_PARENT flag.

TreeView_GetPrevSibling

Retrieves the previous sibling item of a specified item in a tree-view control. You can use this macro, or you can explicitly send the TVM_GETNEXTITEM message with the TVGN_PREVIOUS flag.

TreeView_GetPrevVisible

Retrieves the first visible item that precedes a specified item in a tree-view control. You can use this macro, or you can explicitly send the TVM_GETNEXTITEM message with the TVGN_PREVIOUSVISIBLE flag.

TreeView_GetRoot

Retrieves the topmost or very first item of the tree-view control. You can use this macro, or you can explicitly send the TVM_GETNEXTITEM message with the TVGN_ROOT flag.

TreeView_GetScrollTime

Retrieves the maximum scroll time for the tree-view control. You can use this macro or send the TVM_GETSCROLLTIME message explicitly.

TreeView_GetSelectedCount

Not implemented.

TreeView_GetSelection

Retrieves the currently selected item in a tree-view control. You can use this macro, or you can explicitly send the TVM_GETNEXTITEM message with the TVGN_CARET flag.

TreeView_GetTextColor

Retrieves the current text color of the control. You can use this macro or send the TVM_GETTEXTCOLOR message explicitly.

TreeView_GetToolTips

Retrieves the handle to the child ToolTip control used by a tree-view control. You can use this macro or send the TVM_GETTOOLTIPS message explicitly.

TreeView_GetUnicodeFormat

Retrieves the Unicode character format flag for the control. You can use this macro or send the TVM_GETUNICODEFORMAT message explicitly.

TreeView_GetVisibleCount

Obtains the number of items that can be fully visible in the client window of a tree-view control. You can use this macro or send the TVM_GETVISIBLECOUNT message explicitly.

TreeView_HitTest

Determines the location of the specified point relative to the client area of a tree-view control. You can use this macro or send the TVM_HITTEST message explicitly.

TreeView_InsertItem

Inserts a new item in a tree-view control. You can use this macro or send the TVM_INSERTITEM message explicitly.

TreeView_MapAccIDToHTREEITEM

Maps an accessibility ID to an HTREEITEM. You can use this macro or send the TVM_MAPACCIDTOHTREEITEM message explicitly.

TreeView_MapHTREEITEMtoAccID

Maps an HTREEITEM to an accessibility ID. You can use this macro or send the TVM_MAPHTREEITEMTOACCID message explicitly.

TreeView_Select

Selects the specified tree-view item, scrolls the item into view, or redraws the item in the style used to indicate the target of a drag-and-drop operation. You can use this macro or the TreeView_SelectItem, TreeView_SelectSetFirstVisible, or TreeView_SelectDropTarget macros, or you can send the TVM_SELECTITEM message explicitly.

TreeView_SelectDropTarget

Redraws a specified tree-view control item in the style used to indicate the target of a drag-and-drop operation. You can use this macro or the TreeView_Select macro, or you can send the TVM_SELECTITEM message explicitly.

TreeView_SelectItem

Selects the specified tree-view item. You can use this macro or the TreeView_Select macro, or you can send the TVM_SELECTITEM message explicitly.

TreeView_SelectSetFirstVisible

Scrolls the tree-view control vertically to ensure that the specified item is visible. If possible, the specified item becomes the first visible item at the top of the control's window. You can use this macro or the TreeView_Select macro, or you can send the TVM_SELECTITEM message explicitly.

TreeView_SetAutoScrollInfo

Sets information used to determine auto-scroll characteristics. Use this macro or send the TVM_SETAUTOSCROLLINFO message explicitly.

TreeView_SetBkColor

Sets the background color of the control. You can use this macro or send the TVM_SETBKCOLOR message explicitly.

TreeView_SetCheckState

Sets the item's state image to "checked" or "unchecked." You can also use the TVM_SETITEM message directly.

TreeView_SetExtendedStyle

Sets the extended style for a specified TreeView control. Use this macro or send the TVM_SETEXTENDEDSTYLE message explicitly.

TreeView_SetImageList

Sets the normal or state image list for a tree-view control and redraws the control using the new images. You can use this macro or send the TVM_SETIMAGELIST message explicitly.

TreeView_SetIndent

Sets the width of indentation for a tree-view control and redraws the control to reflect the new width. You can use this macro or send the TVM_SETINDENT message explicitly.

TreeView_SetInsertMark

Sets the insertion mark in a tree-view control. You can use this macro or send the TVM_SETINSERTMARK message explicitly.

TreeView_SetInsertMarkColor

Sets the color used to draw the insertion mark for the tree view. You can use this macro or send the TVM_SETINSERTMARKCOLOR message explicitly.

TreeView_SetItem

The TreeView_SetItem macro sets some or all of a tree-view item's attributes. You can use this macro or send the TVM_SETITEM message explicitly.

TreeView_SetItemHeight

Sets the height of the tree-view items. You can use this macro or send the TVM_SETITEMHEIGHT message explicitly.

TreeView_SetItemState

Sets a tree-view item's state attributes. You can use this macro or send the TVM_SETITEM message explicitly.

TreeView_SetLineColor

Sets the current line color. You can also use the TVM_SETLINECOLOR message directly.

TreeView_SetScrollTime

Sets the maximum scroll time for the tree-view control. You can use this macro or send the TVM_SETSCROLLTIME message explicitly.

TreeView_SetTextColor

Sets the text color of the control. You can use this macro or send the TVM_SETTEXTCOLOR message explicitly.

TreeView_SetToolTips

Sets a tree-view control's child ToolTip control. You can use this macro or send the TVM_SETTOOLTIPS message explicitly.

TreeView_SetUnicodeFormat

Sets the Unicode character format flag for the control. This message allows you to change the character set used by the control at run time rather than having to re-create the control. You can use this macro or send the TVM_SETUNICODEFORMAT message explicitly.

TreeView_ShowInfoTip

Shows the infotip for a specified item in a tree-view control. Use this macro or send the TVM_SHOWINFOTIP message explicitly.

TreeView_SortChildren

Sorts the child items of the specified parent item in a tree-view control. You can use this macro or send the TVM_SORTCHILDREN message explicitly.

TreeView_SortChildrenCB

Sorts tree-view items using an application-defined callback function that compares the items. You can use this macro or send the TVM_SORTCHILDRENCB message explicitly.

Messages

TVM_CREATEDRAGIMAGE

Creates a dragging bitmap for the specified item in a tree-view control. The message also creates an image list for the bitmap and adds the bitmap to the image list. An application can display the image when dragging the item by using the image list functions. You can send this message explicitly or by using the TreeView_CreateDragImage macro.

TVM_DELETEITEM

Removes an item and all its children from a tree-view control. You can send this message explicitly or by using the TreeView_DeleteItem macro.

TVM_EDITLABEL

Begins in-place editing of the specified item's text, replacing the text of the item with a single-line edit control containing the text. This message implicitly selects and focuses the specified item. You can send this message explicitly or by using the TreeView_EditLabel macro.

TVM_ENDEDITLABELNOW

Ends the editing of a tree-view item's label. You can send this message explicitly or by using the TreeView_EndEditLabelNow macro.

TVM_ENSUREVISIBLE

Ensures that a tree-view item is visible, expanding the parent item or scrolling the tree-view control, if necessary. You can send this message explicitly or by using the TreeView_EnsureVisible macro.

TVM_EXPAND

The TVM_EXPAND message expands or collapses the list of child items associated with the specified parent item, if any. You can send this message explicitly or by using the TreeView_Expand macro.

TVM_GETBKCOLOR

Retrieves the current background color of the control. You can send this message explicitly or by using the TreeView_GetBkColor macro.

TVM_GETCOUNT

Retrieves a count of the items in a tree-view control. You can send this message explicitly or by using the TreeView_GetCount macro.

TVM_GETEDITCONTROL

Retrieves the handle to the edit control being used to edit a tree-view item's text. You can send this message explicitly or by using the TreeView_GetEditControl macro.

TVM_GETEXTENDEDSTYLE

Retrieves the extended style for a tree-view control. Send this message explicitly or by using the TreeView_GetExtendedStyle macro.

TVM_GETIMAGELIST

Retrieves the handle to the normal or state image list associated with a tree-view control. You can send this message explicitly or by using the TreeView_GetImageList macro.

TVM_GETINDENT

Retrieves the amount, in pixels, that child items are indented relative to their parent items. You can send this message explicitly or by using the TreeView_GetIndent macro.

TVM_GETINSERTMARKCOLOR

Retrieves the color used to draw the insertion mark for the tree view. You can send this message explicitly or by using the TreeView_GetInsertMarkColor macro.

TVM_GETISEARCHSTRING

Retrieves the incremental search string for a tree-view control. The tree-view control uses the incremental search string to select an item based on characters typed by the user. You can send this message explicitly or by using the TreeView_GetISearchString macro.

TVM_GETITEM

Retrieves some or all of a tree-view item's attributes. You can send this message explicitly or by using the TreeView_GetItem macro.

TVM_GETITEMHEIGHT

Retrieves the current height of the each tree-view item. You can send this message explicitly or by using the TreeView_GetItemHeight macro.

TVM_GETITEMPARTRECT

Not implemented.

TVM_GETITEMRECT

Retrieves the bounding rectangle for a tree-view item and indicates whether the item is visible. You can send this message explicitly or by using the TreeView_GetItemRect macro.

TVM_GETITEMSTATE

Retrieves some or all of a tree-view item's state attributes. You can send this message explicitly or by using the TreeView_GetItemState macro.

TVM_GETLINECOLOR

The TVM_GETLINECOLOR message gets the current line color.

TVM_GETNEXTITEM

Retrieves the tree-view item that bears the specified relationship to a specified item. You can send this message explicitly, by using the TreeView_GetNextItem macro.

TVM_GETSCROLLTIME

Retrieves the maximum scroll time for the tree-view control. You can send this message explicitly or by using the TreeView_GetScrollTime macro.

TVM_GETSELECTEDCOUNT

Not implemented.

TVM_GETTEXTCOLOR

Retrieves the current text color of the control. You can send this message explicitly or by using the TreeView_GetTextColor macro.

TVM_GETTOOLTIPS

Retrieves the handle to the child ToolTip control used by a tree-view control. You can send this message explicitly or by using the TreeView_GetToolTips macro.

TVM_GETUNICODEFORMAT

Retrieves the Unicode character format flag for the control. You can send this message explicitly or use the TreeView_GetUnicodeFormat macro.

TVM_GETVISIBLECOUNT

Obtains the number of items that can be fully visible in the client window of a tree-view control. You can send this message explicitly or by using the TreeView_GetVisibleCount macro.

TVM_HITTEST

Determines the location of the specified point relative to the client area of a tree-view control. You can send this message explicitly or by using the TreeView_HitTest macro.

TVM_INSERTITEM

Inserts a new item in a tree-view control. You can send this message explicitly or by using the TreeView_InsertItem macro.

TVM_MAPACCIDTOHTREEITEM

Maps an accessibility ID to an HTREEITEM.

TVM_MAPHTREEITEMTOACCID

Maps an HTREEITEM to an accessibility ID.

TVM_SELECTITEM

Selects the specified tree-view item, scrolls the item into view, or redraws the item in the style used to indicate the target of a drag-and-drop operation. You can send this message explicitly or by using the TreeView_Select, TreeView_SelectItem, or TreeView_SelectDropTarget macro.

TVM_SETAUTOSCROLLINFO

Sets information used to determine auto-scroll characteristics. You can send this message explicitly or by using the TreeView_SetAutoScrollInfo macro.

TVM_SETBKCOLOR

Sets the background color of the control. You can send this message explicitly or by using the TreeView_SetBkColor macro.

TVM_SETEXTENDEDSTYLE

Informs the tree-view control to set extended styles. Send this message or use the macro TreeView_SetExtendedStyle.

TVM_SETIMAGELIST

Sets the normal or state image list for a tree-view control and redraws the control using the new images. You can send this message explicitly or by using the TreeView_SetImageList macro.

TVM_SETINDENT

Sets the width of indentation for a tree-view control and redraws the control to reflect the new width. You can send this message explicitly or by using the TreeView_SetIndent macro.

TVM_SETINSERTMARK

Sets the insertion mark in a tree-view control. You can send this message explicitly or by using the TreeView_SetInsertMark macro.

TVM_SETINSERTMARKCOLOR

Sets the color used to draw the insertion mark for the tree view. You can send this message explicitly or by using the TreeView_SetInsertMarkColor macro.

TVM_SETITEM

The TVM_SETITEM message sets some or all of a tree-view item's attributes. You can send this message explicitly or by using the TreeView_SetItem macro.

TVM_SETITEMHEIGHT

Sets the height of the tree-view items. You can send this message explicitly or by using the TreeView_SetItemHeight macro.

TVM_SETLINECOLOR

The TVM_SETLINECOLOR message sets the current line color.

TVM_SETSCROLLTIME

Sets the maximum scroll time for the tree-view control. You can send this message explicitly or by using the TreeView_SetScrollTime macro.

TVM_SETTEXTCOLOR

Sets the text color of the control. You can send this message explicitly or by using the TreeView_SetTextColor macro.

TVM_SETTOOLTIPS

Sets a tree-view control's child ToolTip control. You can send this message explicitly or by using the TreeView_SetToolTips macro.

TVM_SETUNICODEFORMAT

Sets the Unicode character format flag for the control. This message allows you to change the character set used by the control at run time rather than having to re-create the control. You can send this message explicitly or use the TreeView_SetUnicodeFormat macro.

TVM_SHOWINFOTIP

Shows the infotip for a specified item in a tree-view control. You can send this message explicitly or by using the TreeView_ShowInfoTip macro..

TVM_SORTCHILDREN

Sorts the child items of the specified parent item in a tree-view control. You can send this message explicitly or by using the TreeView_SortChildren macro.

TVM_SORTCHILDRENCB

Sorts tree-view items using an application-defined callback function that compares the items. You can send this message explicitly or by using the TreeView_SortChildrenCB macro.

Notifications

NM_CLICK (tree view)

Notifies the parent window of a tree-view control that the user has clicked the left mouse button within the control. This notification is sent in the form of a WM_NOTIFY message.

NM_CUSTOMDRAW (tree view)

Sent by a tree-view control to notify its parent window about drawing operations. This notification is sent in the form of a WM_NOTIFY message.

NM_DBLCLK (tree view)

Notifies the parent window of a tree-view control that the user has double-clicked the left mouse button within the control. This notification is sent in the form of a WM_NOTIFY message.

NM_KILLFOCUS (tree view)

Notifies a tree-view control's parent window that the control has lost the input focus. This notification is sent in the form of a WM_NOTIFY message.

NM_RCLICK (tree view)

Notifies the parent window of a tree-view control that the user has clicked the right mouse button within the control. This notification is sent in the form of a WM_NOTIFY message.

NM_RDBLCLK (tree view)

Notifies the parent of a tree-view control that the user has double-clicked the right mouse button within the control. This notification is sent in the form of a WM_NOTIFY message.

NM_RETURN (tree view)

Notifies a tree-view control's parent window that the control has the input focus and that the user has pressed the key. This notification is sent in the form of a WM_NOTIFY message.

NM_SETCURSOR (tree view)

Notifies a tree-view control's parent window that the control is setting the cursor in response to a WM_SETCURSOR message. This notification is sent in the form of a WM_NOTIFY message.

NM_SETFOCUS (tree view)

Notifies a tree-view control's parent window that the control has received the input focus. This notification is sent in the form of a WM_NOTIFY message.

TVN_ASYNCDRAW

Sent by a tree-view control to its parent when the drawing of a icon or overlay has failed. This notification message is sent in the form of a WM_NOTIFY message.

TVN_BEGINDRAG

Notifies a tree-view control's parent window that a drag-and-drop operation involving the left mouse button is being initiated. This notification message is sent in the form of a WM_NOTIFY message.

TVN_BEGINLABELEDIT

Notifies a tree-view control's parent window about the start of label editing for an item. This notification message is sent in the form of a WM_NOTIFY message.

TVN_BEGINRDRAG

Notifies a tree-view control's parent window about the initiation of a drag-and-drop operation involving the right mouse button. This notification message is sent in the form of a WM_NOTIFY message.

TVN_DELETEITEM

Notifies a tree-view control's parent window that an item is being deleted. This notification message is sent in the form of a WM_NOTIFY message.

TVN_ENDLABELEDIT

Notifies a tree-view control's parent window about the end of label editing for an item. This notification message is sent in the form of a WM_NOTIFY message.

TVN_GETDISPINFO

Requests that a tree-view control's parent window provide information needed to display or sort an item. This notification message is sent in the form of a WM_NOTIFY message.

TVN_GETINFOTIP

Sent by a tree-view control that has the TVS_INFOTIP style. This notification is sent when the control is requesting additional text information to be displayed in a ToolTip. The notification is sent in the form of a WM_NOTIFY message.

TVN_ITEMCHANGED

Notifies a tree-view control's parent window that item attributes have changed. This notification message is sent in the form of a WM_NOTIFY message.

TVN_ITEMCHANGING

Notifies a tree-view control's parent window that item attributes are about to change. This notification message is sent in the form of a WM_NOTIFY message.

TVN_ITEMEXPANDED

Notifies a tree-view control's parent window that a parent item's list of child items has expanded or collapsed. This notification message is sent in the form of a WM_NOTIFY message.

TVN_ITEMEXPANDING

Notifies a tree-view control's parent window that a parent item's list of child items is about to expand or collapse. This notification message is sent in the form of a WM_NOTIFY message.

TVN_KEYDOWN

Notifies a tree-view control's parent window that the user pressed a key and the tree-view control has the input focus. This notification message is sent in the form of a WM_NOTIFY message.

TVN_SELCHANGED

Notifies a tree-view control's parent window that the selection has changed from one item to another. This notification message is sent in the form of a WM_NOTIFY message.

TVN_SELCHANGING

Notifies a tree-view control's parent window that the selection is about to change from one item to another. This notification message is sent in the form of a WM_NOTIFY message.

TVN_SETDISPINFO

Notifies a tree-view control's parent window that it must update the information it maintains about an item. This notification message is sent in the form of a WM_NOTIFY message.

TVN_SINGLEEXPAND

Sent by a tree-view control with the TVS_SINGLEEXPAND style when the user opens or closes a tree item using a single click of the mouse. This notification is sent in the form of a WM_NOTIFY message.

Structures

NMTREEVIEW

Contains information about a tree-view notification message. This structure is identical to the NM_TREEVIEW structure, but it has been renamed to follow current naming conventions.

NMTVASYNCDRAW

Contains an explanation of why the draw of an icon or overlay tree item failed. This structure is sent on a TVN_ASYNCDRAW notification. Set the dwRetFlags member to indicate what action the control should take. Note that a draw can fail if there is no image; in other words, when the icon image has not been extracted.

NMTVCUSTOMDRAW

Contains information specific to an NM_CUSTOMDRAW (tree view) notification message sent by a tree-view control.

NMTVDISPINFO

Contains and receives display information for a tree-view item. This structure is identical to the TV_DISPINFO structure, but it has been renamed to follow current naming conventions.

NMTVDISPINFOEX

Contains information pertaining to extended TreeView notification information.

NMTVGETINFOTIP

Contains and receives tree-view item information needed to display a ToolTip for an item. This structure is used with the TVN_GETINFOTIP notification message.

NMTVITEMCHANGE

Contains information on a tree-view item change. This structure is sent with the TVN_ITEMCHANGED and TVN_ITEMCHANGING notifications.

NMTVITEMRECT

Not currently supported.

NMTVKEYDOWN

Contains information about a keyboard event in a tree-view control. This structure is used with the TVN_KEYDOWN notification message. The structure is identical to the TV_KEYDOWN structure, but it has been renamed to follow current naming conventions.

NMTVSTATEIMAGECHANGING

Contains information about a tree-view state image changing notification message.

TVGETITEMPARTRECTINFO

Contains information for identifying the "hit zone" for a specified part of a tree item. The structure is used with the TVM_GETITEMPARTRECT message and the TreeView_GetItemPartRect macro.

TVHITTESTINFO

Contains information used to determine the location of a point relative to a tree-view control. This structure is used with the TVM_HITTEST message. The structure is identical to the TV_HITTESTINFO structure, but it has been renamed to follow current naming conventions.

TVINSERTSTRUCT

Contains information used to add a new item to a tree-view control. This structure is used with the TVM_INSERTITEM message. The structure is identical to the TV_INSERTSTRUCT structure, but it has been renamed to follow current naming conventions.

TVITEM

Specifies or receives attributes of a tree-view item. This structure is identical to the TV_ITEM structure, but it has been renamed to follow current naming conventions. New applications should use this structure.

TVITEMEX

Specifies or receives attributes of a tree-view item. This structure is an enhancement to the TVITEM structure. New applications should use this structure where appropriate.

TVSORTCB

Contains information used to sort child items in a tree-view control. This structure is used with the TVM_SORTCHILDRENCB message. This structure is identical to the TV_SORTCB structure, but it has been renamed to follow current naming conventions.

Constants

Tree-View Control Extended Styles

This section lists extended styles used when creating tree-view controls. The value of extended styles is a bitwise combination of these styles.

Tree-View Control Item States

This section lists the item state flags used to indicate the state of an item in a tree-view control.

Tree-View Control Window Styles

This section lists window styles used when creating tree-view controls.