Xiqual 0.9.1

gadget* lui_newgadget

(ulong type,
  ulong tag1,
  ... )

Create gadget, and automatically set certain tags.

Documentation

Create gadget, and automatically set certain tags. The LBT_TOGGLE tag is set if type is GAD_TOGGLE. LUI_SCREEN is also automatically set to xig->screen, but any LUI_SCREEN�tags you supply will override this.

Known button types

• GAD_BUTTON
• Ordinary clickable button, with optional highlight images. The highlight image for the pressed-in state doesn't really make much sense, but it would make you able to change a button to toggle state on the fly.
• GAD_TOGGLE
• Like a clickable button, except the button stays pressed until you click again. The pressed-in highlight image is useful for these.
• GAD_LIST
• A very simple list with a field above and below that scrolls its contents up and down, respectively. It relies on hooks from the up/down buttons to tell what item to show as the first one (just a number), the its ondraw() hook gets his number and must update the list contents.
• GAD_MENU
• Creates a menu header (walks like a button, quacks like a button) which pops up a list of further buttons when clicked. No layout management is done yet, so the items will just appear below eachother. The menu itself handles highlighting of the menuitems. Its inputarea changes size temporarily while the menuitems are displayed.
• GAD_MESSAGE
• This is a modal message box with one (confirm) button. For those who don't speak GUI, modal means all other gadgets are unavailable while this box awaits input. It handles its own highlighting of items, and may possibly have a scrolling list of text, if the text is too large for its displayable area.
• GAD_CONFIRM
• This is another modal message box, but with both a confirm and cancel button.

Alphabetic index