src/frontends/kde/dlg/README

   1 These files are generated with qtarch-1.4-5 which can be downloaded
   2 from
   3
   4 http://qtarch.sourceforge.net/
   5
   6 FIXME. Note this is *not* the latest version, as they only
   7 support Qt 2.0.
   8
   9 You should compile in the KDE module when you compile qtarch-1.4.
  10 For me this was just a case of a make in the module/kde/ directory,
  11 and then you can add the .so library file in the qtarch GUI.
  12
  13 Note that the formsomethingdialogdata.* files are automatically
  14 generated, but the derived class files are *not* (i.e. they have
  15 been edited by hand). So you should only ever generate the base
  16 class files, and then propogate any changes into the derived class
  17 by hand.
  18
  19 Some tips and guidelines for qtarch and the KDE frontend :
  20
  21 o the default button should be the one that causes least harm, unless
  22   the action can be undone. So Print should default to cancel, whereas
  23   insert index entry can be undone, so should default to OK
  24
  25 o the dialog should derive from QWidget (set in Properties)
  26
  27 o the dialog should always have the gettext option set
  28
  29 o give every widget a name - useful for the geometry layouts later
  30
  31 o don't bother setting min/max sizes for anything, but do set the size Hint
  32   stuff appropriately. e.g. QLineEdit's should have a max height specified by
  33   size Hint, but variable width
  34
  35 o if you map a variable make it the same as the widget name
  36
  37 o radio groups are done automagically based on positioning
  38
  39 o grid units are 5 pixels
  40
  41 o set alignment before placing a widget inside a layout, it doesn't seem to
  42   update properly. Alternatively you can just edit the .dlg file directly
  43
  44 o push buttons are arranged symmetrically across the dialog e.g.
  45   <1 stretch> <button> <2 stretch> <button> <2 stretch> <button> <1 stretch>
  46
  47 o for GroupBox and similar, you set the children in the layout manager
  48
  49 o do the geometry layouts last. you cannot alter the geometry of widgets
  50   whilst they're being managed which makes any settings a pain, which
  51   are useful mainly while editing the dialog in qtarch
  52
  53 o when doing layout, add all the layouts before any of the widgets otherwise
  54   qtarch has a tendency to get confused
  55
  56 o qtarch often produces code that initialises stuff in the wrong order.
  57   This is nasty, but usually dumps core so is noticable. Either way, the
  58   cheesy perl script checkinitorder.pl will verify the produced files for
  59   you - if it complains you need to hack the .dlg file to re-arrange the order.
  60
  61         - jbl