text: #include <wx/treelist.h>
  A control combining wxTreeCtrl and wxListCtrl features.
  This is a multi-column tree control optionally supporting images and checkboxes for the items in the first column.
  It is currently implemented using wxDataViewCtrl internally but provides a much simpler interface for the common use case it addresses. Thus, one of the design principles for this control is simplicity and intentionally doesn't provide all the features of wxDataViewCtrl. Most importantly, this class stores all its data internally and doesn't require you to define a custom model for it.
  Instead, this controls works like wxTreeCtrl or non-virtual wxListCtrl and allows you to simply add items to it using wxTreeListCtrl::AppendItem() and related methods. Typically, you start by setting up the columns (you must have at least one) by calling wxTreeListCtrl::AppendColumn() and then add the items. While only the text of the first column can be specified when adding them, you can use wxTreeListCtrl::SetItemText() to set the text of the other columns.
  Unlike wxTreeCtrl or wxListCtrl this control can sort its items on its own. To allow user to sort the control contents by clicking on some column you should use wxCOL_SORTABLE flag when adding that column to the control. When a column with this flag is clicked, the control resorts itself using the values in this column. By default the sort is done using alphabetical order comparison of the items text, which is not always correct (e.g. this doesn't work for the numeric columns). To change this you may use SetItemComparator() method to provide a custom comparator, i.e. simply an object that implements comparison between the two items. The treelist sample shows an example of doing this. And if you need to sort the control programmatically, you can call SetSortColumn() method.
  Here are the styles supported by this control. Notice that using wxTL_USER_3STATE implies wxTL_3STATE and wxTL_3STATE in turn implies wxTL_CHECKBOX.
  This class supports the following styles:
  The following event handler macros redirect the events to member function handlers 'func' with prototypes like:
  Event macros:
  wxEVT_TREELIST_SELECTION_CHANGEDevent and notifies about the selection change in the control. In the single selection case the item indicated by the event has been selected and previously selected item, if any, was deselected. In multiple selection case, the selection of this item has just changed (it may have been either selected or deselected) but notice that the selection of other items could have changed as well, use wxTreeListCtrl::GetSelections() to retrieve the new selection if necessary.
  wxEVT_TREELIST_ITEM_EXPANDINGevent notifying about the given branch being expanded. This event is sent before the expansion occurs and can be vetoed to prevent it from happening.
  wxEVT_TREELIST_ITEM_EXPANDEDevent notifying about the expansion of the given branch. This event is sent after the expansion occurs and can't be vetoed.
  wxEVT_TREELIST_ITEM_CHECKEDevent notifying about the user checking or unchecking the item. You can use wxTreeListCtrl::GetCheckedState() to retrieve the new item state and wxTreeListEvent::GetOldCheckedState() to get the previous one.
  wxEVT_TREELIST_ITEM_ACTIVATEDevent notifying about the user double clicking the item or activating it from keyboard.
  wxEVT_TREELIST_ITEM_CONTEXT_MENUevent indicating that the popup menu for the given item should be displayed.
  wxEVT_TREELIST_COLUMN_SORTEDevent indicating that the control contents has just been resorted using the specified column. The event doesn't carry the sort direction, use GetSortColumn() method if you need to know it.
  Add a column with the given title and attributes.
  Same as InsertItem() with wxTLI_LAST.
  Return true if all children of the given item are in the specified state.
  This is especially useful for the controls with
  wxTL_3STATE style to allow to decide whether the parent effective state should be the same state, if all its children are in it, or wxCHK_UNDETERMINED.
  Sets the image list and gives its ownership to the control.
  The image list assigned with this method will be automatically deleted by wxTreeCtrl as appropriate (i.e. it takes ownership of the list).
  Change the item checked state.
  Change the checked state of the given item and all its children.
  This is the same as CheckItem() but checks or unchecks not only this item itself but all its children recursively as well.
  Delete all columns.
  Collapse the given tree branch.
  Create the control window.
  Can be only called for the objects created using the default constructor and exactly once.
  Delete all tree items.
  Delete the column with the given index.
  Delete the specified item.
  Call this to ensure that the given item is visible.
  Expand the given tree branch.
  Return the checked state of the item.
  The return value can be wxCHK_CHECKED, wxCHK_UNCHECKED or wxCHK_UNDETERMINED.
  Return the total number of columns.
  Get the current width of the given column in pixels.
  Return the view part of this control as wxDataViewCtrl.
  This method may return NULL in the future, non wxDataViewCtrl-based, versions of this class, use GetView() unless you really need to use wxDataViewCtrl methods on the returned object.
  Return the first child of the given item.
  Item may be the root item.
  Return value may be invalid if the item doesn't have any children.
  Return the first item in the tree.
  This is the first child of the root item.
  Get the data associated with the given item.
  The returned pointer may be NULL.
  It must not be deleted by the caller as this will be done by the control itself.
  Return the parent of the given item.
  All the tree items visible in the tree have valid parent items, only the never shown root item has no parent.
  Return the text of the given item.
  By default, returns the text of the first column but any other one can be specified using col argument.
  Get item after the given one in the depth-first tree-traversal order.
  Calling this function starting with the result of GetFirstItem() allows iterating over all items in the tree.
  The iteration stops when this function returns an invalid item, i.e.
  Return the next sibling of the given item.
  Return value may be invalid if there are no more siblings.
  Return the (never shown) root item.
  Return the currently selected item.
  This method can't be used with multi-selection controls, use GetSelections() instead.
  The return value may be invalid if no item has been selected yet. Once an item in a single selection control was selected, it will keep a valid selection.
  Fill in the provided array with all the selected items.
  This method can be used in both single and multi-selection case.
  The previous array contents is destroyed.
  Returns the number of selected items.
  Return the column currently used for sorting, if any.
  If the control is currently unsorted, the function simply returns false and doesn't modify any of its output parameters.
  Insert a new item into the tree.
  Return whether the given item is expanded.
  Return true if the item is selected.
  This method can be used in both single and multiple selection modes.
  Same as InsertItem() with wxTLI_FIRST.
  Select the given item.
  In single selection mode, deselects any other selected items, in multi-selection case it adds to the selection.
  Select all the control items.
  Can be only used in multi-selection mode.
  Change the width of the given column.
  Set column width to either the given value in pixels or to the value large enough to fit all of the items if width is wxCOL_WIDTH_AUTOSIZE.
  Notice that setting the width of the last column is ignored as this column is always resized to fill the space left by the other columns.
  Sets the image list.
  The image list assigned with this method will not be deleted by the control itself and you will need to delete it yourself, use AssignImageList() to give the image list ownership to the control.
  Set the object to use for comparing the items.
  This object will be used when the control is being sorted because the user clicked on a sortable column or SetSortColumn() was called.
  The provided pointer is stored by the control so the object it points to must have a life-time equal or greater to that of the control itself. In addition, the pointer can be NULL to stop using custom comparator and revert to the default alphabetical comparison.
  Set the data associated with the given item.
  Previous client data, if any, is deleted when this function is called so it may be used to delete the current item data object and reset it by passing NULL as data argument.
  Set the images for the given item.
  See InsertItem() for the images parameters descriptions.
  Set the text of the specified column of the given item.
  Set the text of the first column of the given item.
  Set the column to use for sorting and the order in which to sort.
  Calling this method resorts the control contents using the values of the items in the specified column. Sorting uses custom comparator set with SetItemComparator() or alphabetical comparison of items texts if none was specified.
  Notice that currently there is no way to reset sort order.
  Uncheck the given item.
  This is synonymous with CheckItem(wxCHK_UNCHECKED).
  Deselect the given item.
  This method can be used in multiple selection mode only.
  Deselect all the control items.
  Can be only used in multi-selection mode.
  Update the state of the parent item to reflect the checked state of its children.
  This method updates the parent of this item recursively: if this item and all its siblings are checked, the parent will become checked as well. If this item and all its siblings are unchecked, the parent will be unchecked. And if the siblings of this item are not all in the same state, the parent will be switched to indeterminate state. And then the same logic will be applied to the parents parent and so on recursively.
  This is typically called when the state of the given item has changed from EVT_TREELIST_ITEM_CHECKED() handler in the controls which have wxTL_3STATE flag. Notice that without this flag this function can't work as it would be unable to set the state of a parent with both checked and unchecked items so it's only allowed to call it when this flag is set.
  Get the width appropriate for showing the given text.
  This is typically used as second argument for AppendColumn() or with SetColumnWidth().
  A constant indicating that no image should be used for an item.