lyx_mirror/src/frontends/qt2
Angus Leeming e22ee4208d port the minipage dialog to the new scheme. Various other small changes
in the inset mailers and in the controllers.
Enable the include dialog to be lauched for a new inset (should please John ;-)


git-svn-id: svn://svn.lyx.org/lyx/lyx-devel/trunk@6374 a592a061-630c-0410-9148-cb99ea01b6c8
2003-03-07 14:08:10 +00:00
..
moc simplify and distcheck ready 2003-01-13 10:39:18 +00:00
ui Make max files by 9 like it is in reality 2003-03-06 15:34:28 +00:00
.cvsignore
Alert_pimpl.C dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
BulletsModule.C Strip trailing whitespace. 2003-02-25 13:35:26 +00:00
BulletsModule.h Strip trailing whitespace. 2003-02-25 13:35:26 +00:00
bulletstrings.C ws changes 2002-12-01 22:59:25 +00:00
bulletstrings.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
ChangeLog port the minipage dialog to the new scheme. Various other small changes 2003-03-07 14:08:10 +00:00
Dialogs2.C port the minipage dialog to the new scheme. Various other small changes 2003-03-07 14:08:10 +00:00
Dialogs3.C port the minipage dialog to the new scheme. Various other small changes 2003-03-07 14:08:10 +00:00
Dialogs_impl.h port the minipage dialog to the new scheme. Various other small changes 2003-03-07 14:08:10 +00:00
Dialogs.C port the minipage dialog to the new scheme. Various other small changes 2003-03-07 14:08:10 +00:00
emptytable.C dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
emptytable.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
FileDialog_private.C dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
FileDialog_private.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
FileDialog.C The file dialog browser doesn't need a LyXView... 2003-02-21 12:22:25 +00:00
iconpalette.C dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
iconpalette.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
io_callback.C dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
io_callback.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
lengthcombo.C dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
lengthcombo.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
lyx_gui.C Alfredo's patch 2003-02-28 09:49:49 +00:00
LyXKeySymFactory.C dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
LyXScreenFactory.C dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
Makefile.am Hold on to your hats. 2003-02-25 14:51:38 +00:00
Makefile.dialogs Hold on to your hats. 2003-02-25 14:51:38 +00:00
Menubar_pimpl.C dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
Menubar_pimpl.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QAbout.C dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QAbout.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QAboutDialog.C dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QAboutDialog.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QBibitem.C port the minipage dialog to the new scheme. Various other small changes 2003-03-07 14:08:10 +00:00
QBibitem.h port the minipage dialog to the new scheme. Various other small changes 2003-03-07 14:08:10 +00:00
QBibitemDialog.C port the minipage dialog to the new scheme. Various other small changes 2003-03-07 14:08:10 +00:00
QBibitemDialog.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QBibtex.C Hold on to your hats. 2003-02-25 14:51:38 +00:00
QBibtex.h Hold on to your hats. 2003-02-25 14:51:38 +00:00
QBibtexDialog.C Strip trailing whitespace. 2003-02-25 13:35:26 +00:00
QBibtexDialog.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QBrowseBox.C ws changes 2002-12-01 22:59:25 +00:00
QBrowseBox.h ws changes 2002-12-01 22:59:25 +00:00
QChanges.C consistent dialog titles 2003-02-16 05:08:14 +00:00
QChanges.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QChangesDialog.C dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QChangesDialog.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QCharacter.C consistent dialog titles 2003-02-16 05:08:14 +00:00
QCharacter.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QCharacterDialog.C dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QCharacterDialog.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QCitation.C Hold on to your hats. 2003-02-25 14:51:38 +00:00
QCitation.h Hold on to your hats. 2003-02-25 14:51:38 +00:00
QCitationDialog.C dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QCitationDialog.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
qcoloritem.C ws changes 2002-12-01 22:59:25 +00:00
qcoloritem.h ws changes 2002-12-01 22:59:25 +00:00
QCommandBuffer.C dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QCommandBuffer.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QCommandEdit.C the qtclean-2 patch with some very small changes 2002-10-20 01:48:28 +00:00
QCommandEdit.h the qtclean-2 patch with some very small changes 2002-10-20 01:48:28 +00:00
QContentPane.C dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QContentPane.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QDelimiterDialog.C dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QDelimiterDialog.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QDialogView.C Hold on to your hats. 2003-02-25 14:51:38 +00:00
QDialogView.h Hold on to your hats. 2003-02-25 14:51:38 +00:00
QDocument.C compile fix 2003-03-06 15:31:23 +00:00
QDocument.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QDocumentDialog.C Strip trailing whitespace. 2003-02-25 13:35:26 +00:00
QDocumentDialog.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QError.C Hold on to your hats. 2003-02-25 14:51:38 +00:00
QError.h Hold on to your hats. 2003-02-25 14:51:38 +00:00
QErrorDialog.C dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QErrorDialog.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QERT.C Hold on to your hats. 2003-02-25 14:51:38 +00:00
QERT.h Hold on to your hats. 2003-02-25 14:51:38 +00:00
QERTDialog.C dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QERTDialog.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QExternal.C Move the external dialog to the new scheme. 2003-03-05 11:30:35 +00:00
QExternal.h Move the external dialog to the new scheme. 2003-03-05 11:30:35 +00:00
QExternalDialog.C connect up apply for external 2003-03-06 05:52:13 +00:00
QExternalDialog.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QFloat.C Move insetfloat.h out of ControlFloat.h and into the .C files 2003-03-05 23:12:19 +00:00
QFloat.h Move the float dialog to the new scheme. 2003-03-05 19:46:08 +00:00
QFloatDialog.C dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QFloatDialog.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
qfont_loader.C Fix math fonts problem 2003-03-03 21:31:38 +00:00
qfont_loader.h Strip trailing whitespace. 2003-02-25 13:35:26 +00:00
qfont_metrics.C Strip trailing whitespace. 2003-02-25 13:35:26 +00:00
qfontexample.C ws changes 2002-12-01 22:59:25 +00:00
qfontexample.h ws changes 2002-12-01 22:59:25 +00:00
QGraphics.C consistent dialog titles 2003-02-16 05:08:14 +00:00
QGraphics.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QGraphicsDialog.C dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QGraphicsDialog.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
qgridview.C Strip trailing whitespace. 2003-02-25 13:35:26 +00:00
qgridview.h ws changes 2002-12-01 22:59:25 +00:00
QInclude.C Move the include dialog to the new scheme 2003-03-05 14:59:37 +00:00
QInclude.h Move the include dialog to the new scheme 2003-03-05 14:59:37 +00:00
QIncludeDialog.C Strip trailing whitespace. 2003-02-25 13:35:26 +00:00
QIncludeDialog.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QIndex.C port the minipage dialog to the new scheme. Various other small changes 2003-03-07 14:08:10 +00:00
QIndex.h Minimal fix needed to give Qt a label dialog again. 2003-03-05 10:47:11 +00:00
QIndexDialog.C dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QIndexDialog.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QLImage.C Alfredo's patch 2003-02-28 09:49:49 +00:00
QLImage.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
qlkey.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QLog.C consistent dialog titles 2003-02-16 05:08:14 +00:00
QLog.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QLogDialog.C dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QLogDialog.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QLPainter.C dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QLPainter.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QLPopupMenu.C Strip trailing whitespace. 2003-02-25 13:35:26 +00:00
QLPopupMenu.h more code in the menu backend == less code in the menu frontends; add support for OptSubmenu (not used yet) 2003-02-15 21:03:40 +00:00
QLPrintDialog.C dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QLPrintDialog.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QLyXKeySym.C Strip trailing whitespace. 2003-02-25 13:35:26 +00:00
QLyXKeySym.h Strip trailing whitespace. 2003-02-25 13:35:26 +00:00
QMath.C dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QMath.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QMathDialog.C dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QMathDialog.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QMathMatrixDialog.C dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QMathMatrixDialog.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QMinipage.C port the minipage dialog to the new scheme. Various other small changes 2003-03-07 14:08:10 +00:00
QMinipage.h port the minipage dialog to the new scheme. Various other small changes 2003-03-07 14:08:10 +00:00
QMinipageDialog.C dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QMinipageDialog.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QParagraph.C consistent dialog titles 2003-02-16 05:08:14 +00:00
QParagraph.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QParagraphDialog.C dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QParagraphDialog.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QPrefs.C Strip trailing whitespace. 2003-02-25 13:35:26 +00:00
QPrefs.h Alfredo's patch 2003-02-28 09:49:49 +00:00
QPrefsDialog.C dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QPrefsDialog.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QPrint.C consistent dialog titles 2003-02-16 05:08:14 +00:00
QPrint.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QRef.C Hold on to your hats. 2003-02-25 14:51:38 +00:00
QRef.h Hold on to your hats. 2003-02-25 14:51:38 +00:00
QRefDialog.C dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QRefDialog.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
qscreen.C Alfredo's patch. 2003-03-06 20:21:21 +00:00
qscreen.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QSearch.C consistent dialog titles 2003-02-16 05:08:14 +00:00
QSearch.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QSearchDialog.C Strip trailing whitespace. 2003-02-25 13:35:26 +00:00
QSearchDialog.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QSendto.C Alfredo's patch 2003-02-28 09:49:49 +00:00
QSendto.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QSendtoDialog.C Alfredo's patch 2003-02-28 09:49:49 +00:00
QSendtoDialog.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
qsetborder.C ws changes 2002-12-01 22:59:25 +00:00
qsetborder.h ws changes 2002-12-01 22:59:25 +00:00
QShowFile.C consistent dialog titles 2003-02-16 05:08:14 +00:00
QShowFile.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QShowFileDialog.C dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QShowFileDialog.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QSpellchecker.C Strip trailing whitespace. 2003-02-25 13:35:26 +00:00
QSpellchecker.h spell rework. revert fix 2003-02-17 18:40:04 +00:00
QSpellcheckerDialog.C spell rework. revert fix 2003-02-17 18:40:04 +00:00
QSpellcheckerDialog.h Strip trailing whitespace. 2003-02-25 13:35:26 +00:00
Qt2Base.C dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
Qt2Base.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
Qt2BC.C dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
Qt2BC.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
qt_helpers.C Strip trailing whitespace. 2003-02-25 13:35:26 +00:00
qt_helpers.h Strip trailing whitespace. 2003-02-25 13:35:26 +00:00
QTabular.C consistent dialog titles 2003-02-16 05:08:14 +00:00
QTabular.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QTabularCreate.C consistent dialog titles 2003-02-16 05:08:14 +00:00
QTabularCreate.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QTabularCreateDialog.C dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QTabularCreateDialog.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QTabularDialog.C dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QTabularDialog.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QTexinfo.C consistent dialog titles 2003-02-16 05:08:14 +00:00
QTexinfo.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QTexinfoDialog.C dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QTexinfoDialog.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QThesaurus.C consistent dialog titles 2003-02-16 05:08:14 +00:00
QThesaurus.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QThesaurusDialog.C dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QThesaurusDialog.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QtLyXView.h Lots and lots of little trivial bits. 2002-09-24 13:57:09 +00:00
QToc.C Hold on to your hats. 2003-02-25 14:51:38 +00:00
QToc.h Hold on to your hats. 2003-02-25 14:51:38 +00:00
QTocDialog.C dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QTocDialog.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
qttableview.C small changes 2002-11-04 00:15:56 +00:00
qttableview.h
qtTimeout.C Make the GUI instantiation invisible to Timeout. 2003-02-22 18:01:16 +00:00
qtTimeout.h Strip trailing whitespace. 2003-02-25 13:35:26 +00:00
QtView.C My old allow/prohibitInput() -> busy(bool) patch cleanup 2003-02-14 14:49:51 +00:00
QtView.h My old allow/prohibitInput() -> busy(bool) patch cleanup 2003-02-14 14:49:51 +00:00
QURL.C port the minipage dialog to the new scheme. Various other small changes 2003-03-07 14:08:10 +00:00
QURL.h port the minipage dialog to the new scheme. Various other small changes 2003-03-07 14:08:10 +00:00
QURLDialog.C dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QURLDialog.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QVCLog.C consistent dialog titles 2003-02-16 05:08:14 +00:00
QVCLog.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QVCLogDialog.C dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QVCLogDialog.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QWorkArea.C dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QWorkArea.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QWrap.C Port wrap dialog to the new scheme. 2003-03-05 23:19:45 +00:00
QWrap.h Port wrap dialog to the new scheme. 2003-03-05 23:19:45 +00:00
QWrapDialog.C dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
QWrapDialog.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
README spell rework. revert fix 2003-02-17 18:40:04 +00:00
Toolbar_pimpl.C dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
Toolbar_pimpl.h dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00
WorkAreaFactory.C dont use pragma impementation and interface anymore 2003-02-13 16:53:15 +00:00

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. Don't be afraid
to use QWhatsThis too, but this must be done in the derived class's
constructor, and use _("..."). Non-trivial means that things like "OK"
/must not/ have a tooltip.

*DO NOT USE DESIGNER FROM Qt 3*. You must use a designer from Qt 2 to
maintain compatibility.

Remember to check tab order on a dialog (third icon, with blue bars in designer).
 
Remember to check sensible resizing behaviour on a dialog.

Remember to use Edit->Check Accelerators

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.
 
Override update_contents() to update the dialog, not update(), and build_dialog(),
not build(). Only these functions may change dialog widgets that may emit changed()
during initialisation, to prevent the button controller from changing its state.

Never call buttoncontroller functions directly from dialogs. In general, you
should use Qt2Base::changed() in all circumstances. However, if you must call
the buttoncontroller, make sure to respect Qt2Base::updating_

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)

 
Stuff to be aware of
--------------------

The connect statement in Qt is a macro and its arguments does not follow
the C++ standard as it should. Using the construct "Type const &" as
argument will lead to runtime-errors, use "const Type &" instead.

ex.

--right--

	connect(list, SIGNAL(selected(const QString &)),
		this, SLOT(complete_selected(const QString &)));

--wrong--

	connect(list, SIGNAL(selected(QString const &)),
		this, SLOT(complete_selected(QString const &)));

Qt, Unicode, and LyX
--------------------

LyX isn't unicoded yet. But you should follow these simple rules :

o Use qt_() not _() in code
o Use fromqstr and toqstr NOT .latin1() / .c_str()

Using these functions (in qt_helpers.h) will make sure we use
the right locale for converting to Qt's QString, which is unicode.