Qt: new volume slider, optionnal. Totem like, for people who use Totem
[vlc.git] / modules / gui / qt4 / HACKING
1 Small Hacking file for the Qt Interface
2
3 If you ever code for Qt4 interface, please read this before.
4
5 ** Code Convetions **
6
7 Please respect VLC code conventions here:
8  - NO trailing spaces
9  - NO tab
10  - Indentation is 4 spaces
11  - Braces ARE indented
12  - Space before and after operators
13  - Case labels are on the same column as the switch
14
15 Refer to http://wiki.videolan.org/Code_Conventions it should be up to date
16
17 ** Include order **
18
19 - VLC include/*.h includes
20 - Other VLC .h includes (gruiking :D)
21 - Qt4 module includes
22 - Qt includes
23
24 ** Naming **
25 This naming is stupid and inconsistent :D
26
27 Try to prefix with psz_, i_, b_, ui_ for the normal basic C/C++ styles.
28
29 If you have spare time, prefix QString with qs_.
30
31 Use aPointerName over a_pointer_name for long names.
32
33 ** QVLCFrame vs QVLCDialog **
34
35 A QVLCFrame is just a QWidget, without any parent and used as a Qt::Windows
36 A QVLCDialog is a QDialog.
37
38 This mean that the QVLCDialog is centered on the parent and ABOVE it, will be destroyed by the parent automatically.
39 This also mean that you have to destroy the QVLCFrame and to save its position/size.
40
41 So if your dialog is a dialog you are used to keep during a playing of a video, then use a QVLCFrame, else use a QVLCDialog, if this is something you do over anything else.
42
43 QVLCFrame: extended panel, messages...
44 QVLCDialog: preferences, open...
45
46 ** HIG for Qt4 **
47 We tend to use GNOME/KDE specs over Vista ones for capitalizations:
48 We use Header for:
49  - Menu
50  - Menu items
51  - GroupBox Titles
52  - Windows and dialog Titles
53 We use Sentence for:
54  - CheckBoxes
55  - ComboBox list
56  - ComboBox labels
57  - Tooltips
58
59 We use "..." after a menu item if it opens another dialog.