Widgets - qPCR4vir/nana-docs GitHub Wiki

An introduction to the widgets, with code examples showing basic usage of the widgets. ( A note about the code examples. )

  • form The application window.
  • base widget Stuff every widget can do.
  • panel Displays other widgets.
  • button Responds to user clicks.
  • label Displays some text.
  • textbox User enters some text.
  • checkbox User toggles a boolean.
  • group Display frame and title around other widgets.
  • radiobutton User selects from displayed options.
  • combox User selects from drop-down list.
  • menu User selects from pop-up list.
  • slider User selects value from graphical number range.
  • spinbox User selects value from text range.
  • filebox User selects file.
  • messagebox Display pop-up window with message.
  • inputbox User selects multiple values
  • scroll Displays large panel in small window.

todo

  • categorize
  • datechooser
  • listbox
  • progress
  • toolbar
  • tabbar
  • treebox

Widgets list

The pictures are good for selecting the widget you need, if you are unfamiliar with their names. The icons links to documentation sources. Some of the links are broken and need actualization.

Name ..........................Picture............................
button , :books: Responds to user clicks.
categorize :books: Represent an architecture of categories and what category is chosen. The categorize widget can be used for representing a path of a directory or the order of a hierarchy.
checkbox , :books: With the radio mode, users make a choice among a set of mutually exclusive, related options. Users can choose one and only one option. inside a group
combox at: , :books: This widget is a combo box which consists of a list box combined with a textbox. The list box should drop down when the user selects the drop-down arrow next to the control. The text can be editable.
date_chooser , :books: A graphical user interface for choosing a date.
form , :books: Represents a popup window. Overall it is a root widget(see Overview of widgets) which attaches the OS/Windowing system native window.
group , :books: A group box provides a frame, a title, and displays various other widgets inside itself. It automatically lays out the child widgets if these child widgets are inserted into the group internal place field. see also spinbox and checkbox images
label , :books: It can be a very simple static text, or a sofisticated formated, aligned and responsible to commands (enter, leave and click) dynamic text label including imagenes. You can get the precalculated exact size. Examples: 1 Label with image
listbox , :books: list of categories with in turn contain items. A category is a text that can be expanded to show the items. Cotegories and items can be selected and checked. An item is formed by columns (fields) corresponding to the headers. Drag the header to reisize or reorganize it. Click on a header reorder the list up and down alternatively
menu , :books: A list of items that specify options or group of options for an application.
menubar , :books: Is a toolbar at the top of window for popuping menus.
nested_form , :books: Represents a native window to be a child of other form. Overall it is a root widget(see Overview of widgets) which attaches the OS/Windowing system native window. It represents a form as a child of other form, using this feature, you can dock other native windows to the nested form, such as a web browser ActiveX control.
panel , :books: For placing other widgets
picture , :books: Rectangle area for displaying an image.
progress , :books: A progress bar with two possible styles: known amount, and unknown amount value (goal). In unknown style the amount is ignored and the bar is scrolled when value change.
scroll , :books: Provides a way to display an object which is larger than the window's client area.
slider , :books: A slider widget wich the user can drag for tracking.
spinbox. Choose a value in the specified range. Supports groups of integers, doubles or texts.
toolbar , :books: a control bar that contains buttons
tabbar , :books: Analogous to dividers in a notebook or the labels in a file cabinet.
textbox Provides a widget that is used to input and display text. It supports three modes: single line, multiple lines and line wrap.
treebox:books: Displays a hierarchical list of items, such as the files and directories on a disk. The nodes contain a text and can be (events) expanded, checked, selected and hovered. Data of any type can be optionally atached to each node using item_proxy:books:
:octocat: , :books:

demo win demo linux