| Guidelines | |||||||
|
Basics Menus Toolbar Statusbar Content Area Dialogs
Mouse Drag and Drop printable version (ps)/(pdf) |
| Links |
|
Icon Style Guide |
 |
Dialogs
Standard Dialogs
KDE provides a number of standard dialogs for tasks that are not limited to a single application. It is strongly recommended that you use standard dialogs whenever possible.
When a standard dialog does not address the needs of your application, consider using it as the base class of your new dialog.
If your application uses a dialog that might prove useful for other applications, please consider adding it to the KDE library as a standard dialog.
Below are the standard dialogs in KDE that existed at the time of writing:
|
About Dialog
|
The About Dialog provides information about the application: the name of the author(s), licensing information, and instructions for reporting bugs.
|
The KHelpMenu class generates a help menu complete with an About Dialog for you. |
|
Color Selection Dialog
|
The Color Selection Dialog should be used whenever the user needs to select a color.
|
The Color Selection Dialog is provided by the KColorDialog class. There is also an easy-to-use KColorButton class. This class provides a colored button which, when pressed, activates a Color Selection Dialog. The color of the button shows the currently-selected color. |
The File Selection Dialog should be used whenever the user needs to select a file.
|
This is the KFileDialog class. |
|
Font Selection Dialog
|
The Font Selection Dialog should be used whenever the user needs to select a font.
|
This is the KFontDialog class. |
|
Icon Selection Dialog
|
The Icon Selection Dialog should be used whenever the user needs to select an icon for something. Most applications use predefined icons and do not require the user to select any icons. The dialog lets the user select a single icon from the icons installed on the KDE system.
|
This is the KIconLoaderDialog class. |
|
Key Configuration Dialog
|
The Key Configuration Dialog can be used to let the user change key-bindings or shortcut-keys within your application.
The default shortcut-key combinations of your application should comply with the guidelines found in this style guide. Your application may, of course, allow users to configure different shortcut-keys as they wish.
|
The Key Configuration Dialog is provided by the KKeyDialog class. It should be used in conjunction with the KAccel class which provides your application with shortcut-key combinations. |
To support simple text editing functions, standard Goto Line, Search and Search & Replace dialogs are available.
|
These dialogs are provided by the classes KEdGotoLine, KEdSrch, and KEdReplace, respectively. |
Previous