.. wxPython Phoenix documentation

   This file was generated by Phoenix's sphinx generator and associated
   tools, do not edit by hand.

   Copyright: (c) 2011-2020 by Total Control Software
   License:   wxWindows License

.. include:: headings.inc

.. currentmodule:: wx.lib.combotreebox

.. highlight:: python



.. _wx.lib.combotreebox.IterableTreeCtrl:

==========================================================================================================================================
|phoenix_title|  **wx.lib.combotreebox.IterableTreeCtrl**
==========================================================================================================================================

TreeCtrl is the same as :class:`TreeCtrl`, with a few convenience methods
added for easier navigation of items. 



|

|class_hierarchy| Class Hierarchy
=================================

.. raw:: html

   <div id="toggleBlock" onclick="return toggleVisibility(this)" class="closed" style="cursor:pointer;">
   <img id="toggleBlock-trigger" src="_static/images/closed.png"/>
   Inheritance diagram for class <strong>IterableTreeCtrl</strong>:
   </div>
   <div id="toggleBlock-summary" style="display:block;"></div>
   <div id="toggleBlock-content" style="display:none;">
   <p class="graphviz">
   <center><img src="_static/images/inheritance/wx.lib.combotreebox.IterableTreeCtrl_inheritance.svg" alt="Inheritance diagram of IterableTreeCtrl" usemap="#dummy" class="inheritance"/></center>
   <script type="text/javascript">toggleVisibilityOnLoad(document.getElementById('toggleBlock'))</script>
   <map id="dummy" name="dummy"> <area shape="rect" id="node1" href="wx.lib.combotreebox.IterableTreeCtrl.html" title="TreeCtrl is the same as TreeCtrl, with a few convenience methods" alt="" coords="49,466,338,495"/> <area shape="rect" id="node2" href="wx.TreeCtrl.html" title="A tree control presents information as a hierarchy, with items that may be expanded to show further items." alt="" coords="138,389,248,418"/> <area shape="rect" id="node3" href="wx.Control.html" title="This is the base class for a control or 'widget'." alt="" coords="69,313,174,341"/> <area shape="rect" id="node4" href="wx.WithImages.html" title="A mixin class to be used with other classes that use a wx.ImageList." alt="" coords="198,313,335,341"/> <area shape="rect" id="node5" href="wx.Window.html" title="wx.Window  is the base class for all windows and represents any visible object on screen." alt="" coords="66,236,177,265"/> <area shape="rect" id="node6" href="wx.WindowBase.html" title="wx.WindowBase" alt="" coords="48,159,195,188"/> <area shape="rect" id="node7" href="wx.EvtHandler.html" title="A class that can handle events from the windowing system." alt="" coords="55,82,188,111"/> <area shape="rect" id="node8" href="wx.Object.html" title="This is the root class of many of the wxWidgets classes." alt="" coords="5,5,104,34"/> <area shape="rect" id="node9" href="wx.Trackable.html" title="Add-on base class for a trackable object." alt="" coords="128,5,251,34"/> </map> 
   </p>
   </div>

|


|super_classes| Known Superclasses
==================================

:class:`wx.TreeCtrl`

|


|method_summary| Methods Summary
================================

================================================================================ ================================================================================
:meth:`~wx.lib.combotreebox.IterableTreeCtrl.GetFirstItem`                       Returns the very first item in the tree. This is the root item
:meth:`~wx.lib.combotreebox.IterableTreeCtrl.GetLastChildRecursively`            Returns the last child of the last child ... of item. If item
:meth:`~wx.lib.combotreebox.IterableTreeCtrl.GetNextItem`                        Returns the item that is on the line immediately below item
:meth:`~wx.lib.combotreebox.IterableTreeCtrl.GetNextSiblingRecursively`          Returns the next sibling of item if it has one. If item has no
:meth:`~wx.lib.combotreebox.IterableTreeCtrl.GetPreviousItem`                    Returns the item that is on the line immediately above item
:meth:`~wx.lib.combotreebox.IterableTreeCtrl.GetSelection`                       Extend GetSelection to never return the root item if the
================================================================================ ================================================================================


|


|api| Class API
===============


.. class:: IterableTreeCtrl(wx.TreeCtrl)

   TreeCtrl is the same as :class:`TreeCtrl`, with a few convenience methods
   added for easier navigation of items. 

   .. method:: GetFirstItem(self)

      Returns the very first item in the tree. This is the root item
      unless the root item is hidden. In that case the first child of
      the root item is returned, if any. If the tree is empty, an
      invalid tree item is returned.
      
      :return: :class:`TreeItemId`
      :rtype: :class:`TreeItemId`


   .. method:: GetLastChildRecursively(self, item)

      Returns the last child of the last child ... of item. If item
      has no children, item itself is returned. So the returned item
      is always valid, assuming a valid item has been passed.
      
      :param TreeItemId `item`: a :class:`TreeItemId`
      :return: :class:`TreeItemId` of the last item or an invalid item
      :rtype: :class:`TreeItemId`


   .. method:: GetNextItem(self, item)

      Returns the item that is on the line immediately below item
      (as is displayed when the tree is fully expanded). The returned
      item is invalid if item is the last item in the tree.
      
      :param TreeItemId `item`: a :class:`TreeItemId`
      :return: :class:`TreeItemId` of the next item or an invalid item
      :rtype: :class:`TreeItemId`


   .. method:: GetNextSiblingRecursively(self, item)

      Returns the next sibling of item if it has one. If item has no
      next sibling the next sibling of the parent of item is returned.
      If the parent has no next sibling the next sibling of the parent
      of the parent is returned, etc. If none of the ancestors of item
      has a next sibling, an invalid item is returned.
      
      :param TreeItemId `item`: a :class:`TreeItemId`
      :return: :class:`TreeItemId` of the next item or an invalid item
      :rtype: :class:`TreeItemId`


   .. method:: GetPreviousItem(self, item)

      Returns the item that is on the line immediately above item
      (as is displayed when the tree is fully expanded). The returned
      item is invalid if item is the first item in the tree.
      
      :param TreeItemId `item`: a :class:`TreeItemId`
      :return: the :class:`TreeItemId` previous to the one passed in or an invalid item
      :rtype: :class:`TreeItemId`


   .. method:: GetSelection(self)

      Extend GetSelection to never return the root item if the
      root item is hidden.