File: ex_tool_bar.rst

package info (click to toggle)
python-enaml 0.19.0-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 13,284 kB
  • sloc: python: 31,443; cpp: 4,499; makefile: 140; javascript: 68; lisp: 53; sh: 20
file content (43 lines) | stat: -rw-r--r-- 1,643 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
..
  NOTE: This RST file was generated by `make examples`.
  Do not edit it directly.
  See docs/source/examples/example_doc_generator.py

Tool Bar Example
===============================================================================

An example of the ``ToolBar`` widget.

This example demonstrates the use of the ``ToolBar`` widget. A ``ToolBar``
can have an arbitrary number of children, which must be ``Action`` widgets.
In this fashion, a ``ToolBar`` is very similar to a ``Menu`` in a ``MenuBar``.
The ``ToolBar`` also supports ``ActionGroup`` widgets in the same manner as
a ``Menu``. A ``ToolBar`` is typically used as a child of a ``MainWindow``,
but it can also used as a child of a ``Container`` and layed out using
constraints.

Implementation Notes:

    The tool bar facilities in Wx are very weak. Due to technical
    limitations, the ``ToolBar`` widget in Wx does not have the slick
    docking features which are available in Qt. It also does not
    look nice when used as the child of a ``Container``. If a ``ToolBar``
    is required for a particular application, strongly prefer the
    Qt backend over Wx (this is generally a good life-rule).

.. TIP:: To see this example in action, download it from
 :download:`tool_bar <../../../examples/widgets/tool_bar.enaml>`
 and run::

   $ enaml-run tool_bar.enaml


Screenshot
-------------------------------------------------------------------------------

.. image:: images/ex_tool_bar.png

Example Enaml Code
-------------------------------------------------------------------------------
.. literalinclude:: ../../../examples/widgets/tool_bar.enaml
    :language: enaml