lyx_mirror/src/frontends/qt2/README

64 lines
1.9 KiB
Plaintext
Raw Normal View History

This file contains some do's and dont's for the Qt2 frontend.
General rules
-------------
Every editable field that affects the state of the dialog contents
from LyX's point of view should connect its xxxChanged() signal to
a the dialog's changed_adaptor() slot, which in turn should call
form_->changed(). If you are using a more complicated thing anyway,
then remember to call form_->changed() at the end (if it has changed !)
Every non-trivial widget should have a tooltip. If you don't know
what to write, write "FIXME", and it can fixed later.
If necessary, you should override Qt2Base::isValid() for determining the validity
of the current dialog's contents.
OK/Apply/Restore/Close should be connected in the derived class's constructor
to call form_->slotOK() etc. Refer to close/cancel as close in the source.
Every overridden update() must call reset() to ensure the beginning state of the dialog
is correct !
Don't #undef emit - #include "QtLyXView.h" instead
Naming conventions
------------------
QFoo.[Ch] The file that interacts with the controller
QFooDialog.[Ch] The implementation of the dialog, derived from the generated files
ui/QFooDialog.ui The designer file
ui/QFooDialogBase.[Ch] Generated files from QFooDialog.ui
slots should be named e.g. slotFooClicked(), slotFooSelected(), where foo is the name
of the widget.
Widgets should be named like "fooXX", where XX is one of the following
widget types :
CB - check box
CO - combo box
ED - line edit
LA - label
ML -
PB - push button
(FIXME: complete this)
Dialog Maintainer MVC conversion
----------------------------------------------
Character Edwin
Citation Kalle Done
Document Kalle Waiting for MVC
Index Kalle Done
Paragraph Edwin Waiting for MVC
Print Edwin
Ref Kalle
Search Edwin
Splash Edwin
Tabular Waiting for MVC
TabularCreate Edwin
Toc Kalle
Url Kalle