.. wxPython Phoenix documentation
This file was generated by Phoenix's sphinx generator and associated
tools, do not edit by hand.
Copyright: (c) 2011-2018 by Total Control Software
License: wxWindows License
.. include:: headings.inc
.. _wx.dataview.DataViewTreeStore:
==========================================================================================================================================
|phoenix_title| **wx.dataview.DataViewTreeStore**
==========================================================================================================================================
:ref:`wx.dataview.DataViewTreeStore` is a specialised :ref:`wx.dataview.DataViewModel` for storing simple trees very much like :ref:`wx.TreeCtrl` does and it offers a similar API.
This class actually stores the entire tree and the values (therefore its name) and implements all virtual methods from the base class so it can be used directly without having to derive any class from it, but it is mostly used from within :ref:`wx.dataview.DataViewTreeCtrl`.
|
|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>DataViewTreeStore</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.dataview.DataViewTreeStore_inheritance.png" alt="Inheritance diagram of DataViewTreeStore" 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.dataview.DataViewTreeStore.html" title="wx.dataview.DataViewTreeStore is a specialised wx.dataview.DataViewModel for storing simple trees very much like wx.TreeCtrl does and it offers a similar API." alt="" coords="5,160,245,189"/> <area shape="rect" id="node2" href="wx.dataview.DataViewModel.html" title="wx.dataview.DataViewModel is the base class for all data model to be displayed by a wx.dataview.DataViewCtrl." alt="" coords="19,83,232,112"/> <area shape="rect" id="node3" href="wx.RefCounter.html" title="This class is used to manage reference-counting providing a simple interface and a counter." alt="" coords="65,5,185,35"/> </map>
</p>
</div>
|
|method_summary| Methods Summary
================================
================================================================================ ================================================================================
:meth:`~wx.dataview.DataViewTreeStore.__init__` Constructor.
:meth:`~wx.dataview.DataViewTreeStore.AppendContainer` Append a container.
:meth:`~wx.dataview.DataViewTreeStore.AppendItem` Append an item.
:meth:`~wx.dataview.DataViewTreeStore.DeleteAllItems` Delete all item in the model.
:meth:`~wx.dataview.DataViewTreeStore.DeleteChildren` Delete all children of the item, but not the item itself.
:meth:`~wx.dataview.DataViewTreeStore.DeleteItem` Delete this item.
:meth:`~wx.dataview.DataViewTreeStore.GetChildCount` Return the number of children of item.
:meth:`~wx.dataview.DataViewTreeStore.GetItemData` Returns the client data associated with the item.
:meth:`~wx.dataview.DataViewTreeStore.GetItemExpandedIcon` Returns the icon to display in expanded containers.
:meth:`~wx.dataview.DataViewTreeStore.GetItemIcon` Returns the icon of the item.
:meth:`~wx.dataview.DataViewTreeStore.GetItemText` Returns the text of the item.
:meth:`~wx.dataview.DataViewTreeStore.GetNthChild` Returns the nth child item of item.
:meth:`~wx.dataview.DataViewTreeStore.InsertContainer` Inserts a container after `previous`.
:meth:`~wx.dataview.DataViewTreeStore.InsertItem` Inserts an item after `previous`.
:meth:`~wx.dataview.DataViewTreeStore.PrependContainer` Inserts a container before the first child item or `parent`.
:meth:`~wx.dataview.DataViewTreeStore.PrependItem` Inserts an item before the first child item or `parent`.
:meth:`~wx.dataview.DataViewTreeStore.SetItemData` Sets the client data associated with the item.
:meth:`~wx.dataview.DataViewTreeStore.SetItemExpandedIcon` Sets the expanded icon for the item.
:meth:`~wx.dataview.DataViewTreeStore.SetItemIcon` Sets the icon for the item.
================================================================================ ================================================================================
|
|api| Class API
===============
.. class:: wx.dataview.DataViewTreeStore(DataViewModel)
**Possible constructors**::
DataViewTreeStore()
DataViewTreeStore is a specialised DataViewModel for storing
simple trees very much like TreeCtrl does and it offers a similar
API.
.. method:: __init__(self)
Constructor.
Creates the invisible root node internally.
.. method:: AppendContainer(self, parent, text, icon=NullIcon, expanded=NullIcon, data=None)
Append a container.
:param `parent`:
:type `parent`: wx.dataview.DataViewItem
:param `text`:
:type `text`: string
:param `icon`:
:type `icon`: wx.Icon
:param `expanded`:
:type `expanded`: wx.Icon
:param `data`:
:type `data`: ClientData
:rtype: :ref:`wx.dataview.DataViewItem`
.. method:: AppendItem(self, parent, text, icon=NullIcon, data=None)
Append an item.
:param `parent`:
:type `parent`: wx.dataview.DataViewItem
:param `text`:
:type `text`: string
:param `icon`:
:type `icon`: wx.Icon
:param `data`:
:type `data`: ClientData
:rtype: :ref:`wx.dataview.DataViewItem`
.. method:: DeleteAllItems(self)
Delete all item in the model.
.. method:: DeleteChildren(self, item)
Delete all children of the item, but not the item itself.
:param `item`:
:type `item`: wx.dataview.DataViewItem
.. method:: DeleteItem(self, item)
Delete this item.
:param `item`:
:type `item`: wx.dataview.DataViewItem
.. method:: GetChildCount(self, parent)
Return the number of children of item.
:param `parent`:
:type `parent`: wx.dataview.DataViewItem
:rtype: `int`
.. method:: GetItemData(self, item)
Returns the client data associated with the item.
:param `item`:
:type `item`: wx.dataview.DataViewItem
:rtype: `ClientData`
.. method:: GetItemExpandedIcon(self, item)
Returns the icon to display in expanded containers.
:param `item`:
:type `item`: wx.dataview.DataViewItem
:rtype: `Icon`
.. method:: GetItemIcon(self, item)
Returns the icon of the item.
:param `item`:
:type `item`: wx.dataview.DataViewItem
:rtype: `Icon`
.. method:: GetItemText(self, item)
Returns the text of the item.
:param `item`:
:type `item`: wx.dataview.DataViewItem
:rtype: `string`
.. method:: GetNthChild(self, parent, pos)
Returns the nth child item of item.
:param `parent`:
:type `parent`: wx.dataview.DataViewItem
:param `pos`:
:type `pos`: int
:rtype: :ref:`wx.dataview.DataViewItem`
.. method:: InsertContainer(self, parent, previous, text, icon=NullIcon, expanded=NullIcon, data=None)
Inserts a container after `previous`.
:param `parent`:
:type `parent`: wx.dataview.DataViewItem
:param `previous`:
:type `previous`: wx.dataview.DataViewItem
:param `text`:
:type `text`: string
:param `icon`:
:type `icon`: wx.Icon
:param `expanded`:
:type `expanded`: wx.Icon
:param `data`:
:type `data`: ClientData
:rtype: :ref:`wx.dataview.DataViewItem`
.. method:: InsertItem(self, parent, previous, text, icon=NullIcon, data=None)
Inserts an item after `previous`.
:param `parent`:
:type `parent`: wx.dataview.DataViewItem
:param `previous`:
:type `previous`: wx.dataview.DataViewItem
:param `text`:
:type `text`: string
:param `icon`:
:type `icon`: wx.Icon
:param `data`:
:type `data`: ClientData
:rtype: :ref:`wx.dataview.DataViewItem`
.. method:: PrependContainer(self, parent, text, icon=NullIcon, expanded=NullIcon, data=None)
Inserts a container before the first child item or `parent`.
:param `parent`:
:type `parent`: wx.dataview.DataViewItem
:param `text`:
:type `text`: string
:param `icon`:
:type `icon`: wx.Icon
:param `expanded`:
:type `expanded`: wx.Icon
:param `data`:
:type `data`: ClientData
:rtype: :ref:`wx.dataview.DataViewItem`
.. method:: PrependItem(self, parent, text, icon=NullIcon, data=None)
Inserts an item before the first child item or `parent`.
:param `parent`:
:type `parent`: wx.dataview.DataViewItem
:param `text`:
:type `text`: string
:param `icon`:
:type `icon`: wx.Icon
:param `data`:
:type `data`: ClientData
:rtype: :ref:`wx.dataview.DataViewItem`
.. method:: SetItemData(self, item, data)
Sets the client data associated with the item.
:param `item`:
:type `item`: wx.dataview.DataViewItem
:param `data`:
:type `data`: ClientData
.. method:: SetItemExpandedIcon(self, item, icon)
Sets the expanded icon for the item.
:param `item`:
:type `item`: wx.dataview.DataViewItem
:param `icon`:
:type `icon`: wx.Icon
.. method:: SetItemIcon(self, item, icon)
Sets the icon for the item.
:param `item`:
:type `item`: wx.dataview.DataViewItem
:param `icon`:
:type `icon`: wx.Icon