# User interface programming

We use the QT Toolkit for GUI- and other programming. The QT-Assistant is an important tool for getting help. Almost everything can be looked up there.

GUIs can be either be hardcoded (see `fterfirsta`a=95 _ `a=58 : `a>64 `a<91 aaa <`<=95 _ `<=58 : `<>64 `<<91 <<< c@amelhyph<269>>rranger.cpp` for an example) or can be created using QT-Designer (see the dialogs under `fterfirstw`w=95 _ `w=58 : `w>64 `w<91 www <`<=95 _ `<=58 : `<>64 `<<91 <<< c@amelhyph<269>>idgets/function_dialogs/` for mostly cleanly-written examples). Don't forget to add your `fterfirstc`c=95 _ `c=58 : `c>64 `c<91 ccc <`<=95 _ `<=58 : `<>64 `<<91 <<< c@amelhyph<269>>pp`, `fterfirsth`h=95 _ `h=58 : `h>64 `h<91 hhh <`<=95 _ `<=58 : `<>64 `<<91 <<< c@amelhyph<269>>` and `fterfirstu`u=95 _ `u=58 : `u>64 `u<91 uuu <`<=95 _ `<=58 : `<>64 `<<91 <<< c@amelhyph<269>>i` files to the corresponding sections in the `fterfirstC`C=95 _ `C=58 : `C>64 `C<91 CCC <`<=95 _ `<=58 : `<>64 `<<91 <<< c@amelhyph<269>>MakeLists.txt`!

Additionally, MusE offers some custom widgets, like menu title items etc. Following, there will be a small, unordered list about custom widgets:

- `fterfirstM`M=95 _ `M=58 : `M>64 `M<91 MMM <`<=95 _ `<=58 : `<>64 `<<91 <<< c@amelhyph<269>>usEGui::MenuTitleItem`: Provides a title-bar in a `fterfirstQ`Q=95 _ `Q=58 : `Q>64 `Q<91 QQQ <`<=95 _ `<=58 : `<>64 `<<91 <<< c@amelhyph<269>>Menu`.
  Usage: `fterfirsts`s=95 _ `s=58 : `s>64 `s<91 sss <`<=95 _ `<=58 : `<>64 `<<91 <<< c@amelhyph<269>>omeMenu->addAction(new MusEGui::MenuTitleItem(tr("fnord"), someMenu));`
  Defined in `fterfirstw`w=95 _ `w=58 : `w>64 `w<91 www <`<=95 _ `<=58 : `<>64 `<<91 <<< c@amelhyph<269>>idgets/menutitleitem.h`.
- `fterfirstM`M=95 _ `M=58 : `M>64 `M<91 MMM <`<=95 _ `<=58 : `<>64 `<<91 <<< c@amelhyph<269>>usEGui::PopupMenu`: Provides a `fterfirstQ`Q=95 _ `Q=58 : `Q>64 `Q<91 QQQ <`<=95 _ `<=58 : `<>64 `<<91 <<< c@amelhyph<269>>Menu`-like menu which can stay open after the user checks a checkable action.
  Usage: just create a `fterfirstn`n=95 _ `n=58 : `n>64 `n<91 nnn <`<=95 _ `<=58 : `<>64 `<<91 <<< c@amelhyph<269>>ew PopupMenu( true|false )` instead of a `fterfirstn`n=95 _ `n=58 : `n>64 `n<91 nnn <`<=95 _ `<=58 : `<>64 `<<91 <<< c@amelhyph<269>>ew QMenu()`. (`fterfirstt`t=95 _ `t=58 : `t>64 `t<91 ttt <`<=95 _ `<=58 : `<>64 `<<91 <<< c@amelhyph<269>>rue` means 'stay open')
  Defined in `fterfirstw`w=95 _ `w=58 : `w>64 `w<91 www <`<=95 _ `<=58 : `<>64 `<<91 <<< c@amelhyph<269>>idgets/popupmenu.h`.