1 This file contains some do's and dont's for the Qt2 frontend.
6 Both xforms and Qt use X error handlers which collide - if you get
7 crashes, try lyx -sync, which seems to help.
12 Every editable field that affects the state of the dialog contents
13 from LyX's point of view should connect its xxxChanged() signal to
14 a the dialog's changed_adaptor() slot, which in turn should call
15 form_->changed(). If you are using a more complicated thing anyway,
16 then remember to call form_->changed() at the end (if it has changed !)
18 Every non-trivial widget should have a tooltip. If you don't know
19 what to write, write "FIXME", and it can fixed later. Don't be afraid
20 to use QWhatsThis too, but this must be done in the derived class's
21 constructor, and use _("...").
23 If necessary, you should override Qt2Base::isValid() for determining the validity
24 of the current dialog's contents.
26 OK/Apply/Restore/Close should be connected in the derived class's constructor
27 to call form_->slotOK() etc. Refer to close/cancel as close in the source.
29 Override update_contents() to update the dialog, not update(), and build_dialog(),
30 not build(). Only these functions may change dialog widgets that may emit changed()
31 during initialisation, to prevent the button controller from changing its state.
33 Never call buttoncontroller functions directly from dialogs. In general, you
34 should use Qt2Base::changed() in all circumstances. However, if you must call
35 the buttoncontroller, make sure to respect Qt2Base::updating_
37 Don't #undef emit - #include "QtLyXView.h" instead
42 QFoo.[Ch] The file that interacts with the controller
43 QFooDialog.[Ch] The implementation of the dialog, derived from the generated files
44 ui/QFooDialog.ui The designer file
45 ui/QFooDialogBase.[Ch] Generated files from QFooDialog.ui
47 slots should be named e.g. slotFooClicked(), slotFooSelected(), where foo is the name
50 Widgets should be named like "fooXX", where XX is one of the following
59 (FIXME: complete this)
62 Dialog Maintainer MVC conversion
63 ----------------------------------------------
69 Document Kalle Waiting for MVC
78 Paragraph Edwin Waiting for MVC
83 Spellchecker John Done
85 Tabular Waiting for MVC
86 TabularCreate Edwin Done
88 Toc Kalle Waiting to be updated