|
| Graphics.UI.GIO.Controls | | Portability | portable | | Stability | provisional | | Maintainer | ka2_mail@yahoo.com |
|
|
|
|
|
| Description |
| This module contains interface to all controls supported from GIO.
A control is a child window an application uses in conjunction with
another window to perform simple input and output tasks.
The controls provides the user with the means to type text, choose options,
and execute an actions.
|
|
| Synopsis |
|
|
|
|
| Controls |
|
| Button |
|
| A button control is a small, rectangular child window that can be
clicked on and off. Buttons can be labeled or appear without text.
A button typically changes appearance when the user clicks it. |
|
| data Button |
| A standard push button. | | Instances | |
|
|
| button :: (Container w) => [Prop Button] -> w -> IO Button |
| Create a button. |
|
| Label |
|
| A label control simply displays a text string and it can be used
to label other controls. A label control can't take input and can't provide output. |
|
| data Label |
| A simple text label. | | Instances | |
|
|
| label :: (Container w) => [Prop Label] -> w -> IO Label |
| Create a text label. |
|
| Entry |
|
| An entry control is a rectangular widget in which the user can enter text. |
|
| data Entry |
| A standard text entry control. | | Instances | |
|
|
| entry :: (Container w) => [Prop Entry] -> w -> IO Entry |
| Create an entry. |
|
| readOnly :: Attr Entry Bool |
| Determines if the user can edit the text in the editable widget or not. |
|
| password :: Attr Entry Bool |
| Determines whether the entry is used to edit a password or a normal text. |
|
| Popup |
|
| A popup control consists of a list box combined with a label control.
The list box portion of the control drop down only when the user selects
the drop-down arrow next to the control. The currently selected item in the
list box is displayed in the label control. |
|
| data Popup |
| A popup selection box. Allthough it is Commanding, the default
command handler automatically calls a handler associated with a
selected item. | | Instances | |
|
|
| popup :: (Container w) => [Prop Popup] -> w -> IO Popup |
| Create a popup selection box. |
|
| ListBox |
|
| A list box displays a list of items, that the user can view and select.
In a single-selection list box, the user can select only one item.
In a multiple-selection list box, a range of items can be selected.
When the user selects an item, it is highlighted and the list box
the command event is generated. |
|
| data ListBox |
| A list box. Allthough it is Commanding, the default
command handler automatically calls a handler associated with a
selected item. | | Instances | |
|
|
| listBox :: (Container w) => Bool -> [Prop ListBox] -> w -> IO ListBox |
| Create a list box. |
|
| Slider |
|
| A slider control is a widget containing a slider and tick marks.
When the user moves the slider, using either the mouse or the direction keys,
the control generates the command event to indicate the change.
Slider controls are useful when you want the user to select a discrete value
in a given range. The slider can be vertical or horizontal. |
|
| data Slider |
| A slider control. | | Instances | |
|
|
| hslider :: (Container w) => [Prop Slider] -> w -> IO Slider |
| Create a horizontal slider control. |
|
| vslider :: (Container w) => [Prop Slider] -> w -> IO Slider |
| Create a vertical slider control. |
|
| ProgressBar |
|
| A progress bar control is a window that an application can use to
indicate the progress of a lengthy operation. It consists of a rectangle
that is gradually filled, from left to right, with the system specified color
as an operation progresses. A progress bar control has a range and a current
position. The range represents the entire duration of the operation, and the
current position represents the progress the application has made toward
completing the operation. |
|
| data ProgressBar |
|
|
| hProgressBar :: (Container w) => Bool -> [Prop ProgressBar] -> w -> IO ProgressBar |
| Create a horizontal progress bar.
The boolean parameter specify whether the bar shows continuous or discrete values. |
|
| vProgressBar :: (Container w) => Bool -> [Prop ProgressBar] -> w -> IO ProgressBar |
| Create a vertical progress bar.
The boolean parameter specify whether the bar shows continuous or discrete values. |
|
| CheckBox |
|
| A check box consists of a square box and a label, that indicates a choice
the user can make by selecting the check. Each CheckBox has two states:
checked (a check mark inside the box) or cleared (no check mark). The
state is controled from the checked attribute. Repeatedly clicking a
check box toggles it from checked to cleared and back again. |
|
| data CheckBox |
| A single check control. | | Instances | |
|
|
| checkBox :: (Container w) => [Prop CheckBox] -> w -> IO CheckBox |
| Create a check control with a certain label. |
|
| RadioBox |
|
| A radio button consists of a round button and a label that indicates a
choice the user can make by selecting the button. An application typically
uses radio buttons in a group box to permit the user to choose from a set
of mutually exclusive options. The group is defined with setRadioBoxGroup
function. When the user selects an radio button from group then the system
automatically sets its check state to checked and clears all other
buttons within the same group. |
|
| data RadioBox |
| A single radio control. | | Instances | |
|
|
| radioBox :: (Container w) => [Prop RadioBox] -> w -> IO RadioBox |
| Create a radio control. |
|
| setRadioBoxGroup :: [RadioBox] -> IO () |
| Connect a list of radio controls such that only one of them is selected
at any time. |
|
| GroupBox |
|
| A group box is a rectangle that surrounds a set of controls, such as
check boxes or radio buttons, with application-defined label in its upper
left corner. The sole purpose of a group box is to organize controls related
by a common purpose (usually indicated by the label). |
|
| data GroupBox |
|
|
| groupBox :: (Container w) => [Prop GroupBox] -> w -> IO GroupBox |
| Create a group box |
|
| CompoundControl |
|
| data CompoundControl |
| A compound control. | | Instances | |
|
|
| compoundControl :: (Container w) => [Prop CompoundControl] -> w -> IO CompoundControl |
| Create a compound control |
|
| Notebook |
|
| A notebook control is analogous to the dividers in a real notebook.
By using a notebook control, an application can define multiple pages for
the same area of a window or dialog box. Each page is represented from
NotebookPage type and is created from notebookPageAt or notebookPage
function. |
|
| data Notebook |
| A notebook control. | | Instances | |
|
|
| notebook :: (Container w) => [Prop Notebook] -> w -> IO Notebook |
| Create a notebook control. |
|
| labelsPosition :: Attr Notebook PositionType |
|
| selectedPage :: Attr Notebook NotebookPage |
| The selected page in the notebook |
|
| data NotebookPage |
| A notebook page. | | Instances | |
|
|
| notebookPageAt :: Maybe Int -> [Prop NotebookPage] -> Notebook -> IO NotebookPage |
| Create a new page at specified position in the notebook. |
|
| notebookPage :: [Prop NotebookPage] -> Notebook -> IO NotebookPage |
| Appends a new page in the notebook. |
|
| Produced by Haddock version 0.4 |
