.. DO NOT EDIT.
.. THIS FILE WAS AUTOMATICALLY GENERATED BY SPHINX-GALLERY.
.. TO MAKE CHANGES, EDIT THE SOURCE PYTHON FILE:
.. "auto_examples/07_ui/viz_ui_listbox.py"
.. LINE NUMBERS ARE GIVEN BELOW.

.. only:: html

    .. note::
        :class: sphx-glr-download-link-note

        :ref:`Go to the end <sphx_glr_download_auto_examples_07_ui_viz_ui_listbox.py>`
        to download the full example code.

.. rst-class:: sphx-glr-example-title

.. _sphx_glr_auto_examples_07_ui_viz_ui_listbox.py:


=========
ListBox
=========

This example shows how to use the UI API. We will create a list
some geometric shapes from FURY UI elements.

First, a bunch of imports.

.. GENERATED FROM PYTHON SOURCE LINES 12-16

.. code-block:: Python


    from fury import ui, window
    from fury.data import fetch_viz_icons


.. GENERATED FROM PYTHON SOURCE LINES 17-18

First we need to fetch some icons that are included in FURY.

.. GENERATED FROM PYTHON SOURCE LINES 18-21

.. code-block:: Python


    fetch_viz_icons()


.. GENERATED FROM PYTHON SOURCE LINES 22-24

Create some text blocks that will be shown when
list elements will be selected

.. GENERATED FROM PYTHON SOURCE LINES 24-31

.. code-block:: Python


    welcome_text = ui.TextBlock2D(text="Welcome", font_size=30, position=(500, 400))
    bye_text = ui.TextBlock2D(text="Bye", font_size=30, position=(500, 400))
    fury_text = ui.TextBlock2D(text="Fury", font_size=30, position=(500, 400))

    example = [welcome_text, bye_text, fury_text]


.. GENERATED FROM PYTHON SOURCE LINES 32-33

Hide these text blocks for now

.. GENERATED FROM PYTHON SOURCE LINES 33-42

.. code-block:: Python



    def hide_all_examples():
        for element in example:
            element.set_visibility(False)


    hide_all_examples()


.. GENERATED FROM PYTHON SOURCE LINES 43-44

Create ListBox with the values as parameter.

.. GENERATED FROM PYTHON SOURCE LINES 44-50

.. code-block:: Python


    values = ["Welcome", "Bye", "Fury"]
    listbox = ui.ListBox2D(
        values=values, position=(10, 300), size=(200, 200), multiselection=False
    )


.. GENERATED FROM PYTHON SOURCE LINES 51-52

Function to show selected element.

.. GENERATED FROM PYTHON SOURCE LINES 52-62

.. code-block:: Python



    def display_element():
        hide_all_examples()
        element = example[values.index(listbox.selected[0])]
        element.set_visibility(True)


    listbox.on_change = display_element


.. GENERATED FROM PYTHON SOURCE LINES 63-65

Now that all the elements have been initialised, we add them to the show
manager.

.. GENERATED FROM PYTHON SOURCE LINES 65-79

.. code-block:: Python


    current_size = (800, 800)
    show_manager = window.ShowManager(size=current_size, title="FURY UI ListBox_Example")

    show_manager.scene.add(listbox)
    show_manager.scene.add(welcome_text)
    show_manager.scene.add(bye_text)
    show_manager.scene.add(fury_text)
    interactive = False

    if interactive:
        show_manager.start()

    window.record(show_manager.scene, size=current_size, out_path="viz_listbox.png")


.. _sphx_glr_download_auto_examples_07_ui_viz_ui_listbox.py:

.. only:: html

  .. container:: sphx-glr-footer sphx-glr-footer-example

    .. container:: sphx-glr-download sphx-glr-download-jupyter

      :download:`Download Jupyter notebook: viz_ui_listbox.ipynb <viz_ui_listbox.ipynb>`

    .. container:: sphx-glr-download sphx-glr-download-python

      :download:`Download Python source code: viz_ui_listbox.py <viz_ui_listbox.py>`


.. only:: html

 .. rst-class:: sphx-glr-signature

    `Gallery generated by Sphinx-Gallery <https://sphinx-gallery.github.io>`_