===================
TabWidget (hwx.gui)
===================

NoteBook with tabs.

A NoteBook presents multiple mutually exclusive panes of content in the same
area. It includes a tabbed control area with 'text' and a content area.

Inherits:
  - :ref:`Widget (hwx.gui)`

----------
Properties
----------

  +----------+----------+
  | current_ | flat_    |
  +----------+----------+

--------------
Public Methods
--------------

  +--------------------------------------------------------+
  | addTab_ (self, child, text='', icon=None)              |
  +--------------------------------------------------------+
  | insertTab_ (self, child, text='', icon=None, index=-1) |
  +--------------------------------------------------------+

----------------
Property Details
----------------

.. _current:
.. method:: current

The current tab.

.. _flat:
.. method:: flat

Gives the TabWidget a borderless appearance.

--------------
Method Details
--------------

.. _addTab:
.. method:: addTab(self, child, text='', icon=None)

Inserts a new tab with the specified child.

:param child: The widget to be added to the tab.
:type child: Widget
:param text: The text to be displayed on the tab.
:type text: str
:param icon: The icon to be shown in the tab.
:type icon: str


.. _insertTab:
.. method:: insertTab(self, child, text='', icon=None, index=-1)

Inserts a new tab with the specified child.

:param child: The widget to be added to the tab.
:type child: Widget
:param text: The text to be displayed on the tab.
:type text: str
:param icon: The icon to be shown in the tab.
:type icon: str
:param index: The index where to insert the tab.
:type index: int