lyx_mirror/src/frontends/qt4
Edwin Leuven c8a91657d2 some connections not made because of:
- signal typo
- slots typos 

git-svn-id: svn://svn.lyx.org/lyx/lyx-devel/trunk@14257 a592a061-630c-0410-9148-cb99ea01b6c8
2006-06-28 12:48:51 +00:00
..
ui put citation dialog in good state: 2006-06-28 08:28:16 +00:00
Action.C GUI API Cleanup step 2: merge of the "younes" branch. 2006-06-26 16:55:35 +00:00
Action.h Those classes (and their associated [Ch] files) are renamed : 2006-06-17 09:14:58 +00:00
Alert_pimpl.C change string "qt2" to "qt4" 2006-04-24 13:25:50 +00:00
Application.C GUI API Cleanup step 2: merge of the "younes" branch. What's missing 2006-06-26 17:18:28 +00:00
Application.h GUI API Cleanup step 2: merge of the "younes" branch. What's missing 2006-06-26 17:18:28 +00:00
BiblioModuleBase.h
BulletsModule.C Some MSVC2003/2005 compatibility fixes, from Bo Peng (ben.bob@gmail.com) 2006-05-29 14:56:08 +00:00
BulletsModule.h replaced last convenience class in iconpallete 2006-05-08 11:44:37 +00:00
ChangeLog set svn:eol-style to native in qt4 frontend 2006-03-21 19:56:57 +00:00
checkedwidgets.C change string "qt2" to "qt4" 2006-04-24 13:25:50 +00:00
checkedwidgets.h change string "qt2" to "qt4" 2006-04-24 13:25:50 +00:00
ColorCache.C Those classes (and their associated [Ch] files) are renamed : 2006-06-17 09:14:58 +00:00
ColorCache.h Those classes (and their associated [Ch] files) are renamed : 2006-06-17 09:14:58 +00:00
Dialogs.C QURL renamed to UrlView 2006-06-28 12:09:25 +00:00
emptytable.C Qt4 compilation speedup patch by Bo Peng and me. 2006-05-18 08:51:12 +00:00
emptytable.h
FileDialog_private.C Qt4 compilation speedup patch by Bo Peng and me. 2006-05-18 08:51:12 +00:00
FileDialog_private.h getting rid of qt4 convenience classes: 2006-05-07 10:20:43 +00:00
FileDialog.C getting rid of qt4 convenience classes: 2006-05-07 10:20:43 +00:00
floatplacement.C Qt4 compilation speedup patch by Bo Peng and me. 2006-05-18 08:51:12 +00:00
floatplacement.h getting rid of even more qt3 convenience classes and unused headers... 2006-05-04 07:31:46 +00:00
FontLoader.C Those classes (and their associated [Ch] files) are renamed : 2006-06-17 09:14:58 +00:00
FontLoader.h GUI API Cleanup step 2: merge of the "younes" branch. 2006-06-26 16:55:35 +00:00
GuiClipboard.C GUI API Cleanup step 2: merge of the "younes" branch. What's missing 2006-06-26 17:18:28 +00:00
GuiClipboard.h This is the merging of the GUI API cleanup branch that was developed in svn+ssh://svn.lyx.org/lyx/lyx-devel/branches/personal/younes. 2006-06-20 08:39:16 +00:00
GuiImplementation.C GUI API Cleanup step 2: merge of the "younes" branch. 2006-06-26 16:55:35 +00:00
GuiImplementation.h GUI API Cleanup step 2: merge of the "younes" branch. 2006-06-26 16:55:35 +00:00
GuiView.C add link to the task tracker of the Qt4 bug 2006-06-27 07:53:44 +00:00
GuiView.h GUI API Cleanup step 2: merge of the "younes" branch. 2006-06-26 16:55:35 +00:00
GuiWorkArea.C Potential Bux fix: call "update()" instead of "vieport()->update()" 2006-06-27 10:28:04 +00:00
GuiWorkArea.h GUI API Cleanup step 2: merge of the "younes" branch. 2006-06-26 16:55:35 +00:00
iconpalette.C Qt4 compilation speedup patch by Bo Peng and me. 2006-05-18 08:51:12 +00:00
iconpalette.h replaced last convenience class in iconpallete 2006-05-08 11:44:37 +00:00
InsertTableWidget.C more cleanup: some formatting and handle mouse events in their event handlers (and not in event()) 2006-06-11 14:28:10 +00:00
InsertTableWidget.h more cleanup: some formatting and handle mouse events in their event handlers (and not in event()) 2006-06-11 14:28:10 +00:00
lengthcombo.C Qt4 compilation speedup patch by Bo Peng and me. 2006-05-18 08:51:12 +00:00
lengthcombo.h
lyx_gui.C Pass width = 0 and height = 0 as unsigned int to indicate the usage of the geometry option 2006-06-26 18:07:10 +00:00
LyXKeySymFactory.C change string "qt2" to "qt4" 2006-04-24 13:25:50 +00:00
Makefile.am QURL renamed to UrlView 2006-06-28 12:09:25 +00:00
Makefile.dialogs put citation dialog in good state: 2006-06-28 08:28:16 +00:00
panelstack.C * QPrefsDialog.[Ch]: Split up of QPrefsDialog into different modules (one per .ui file) 2006-05-20 11:49:53 +00:00
panelstack.h
pch.h Remove <climits> for pch.h as this header is not used anywhere in the qt4 frontend. 2006-05-06 14:41:23 +00:00
QAbout.C getting rid of qt4 convenience classes: 2006-05-07 10:20:43 +00:00
QAbout.h
QAboutDialog.C Qt4 compilation speedup patch by Bo Peng and me. 2006-05-18 08:51:12 +00:00
QAboutDialog.h
QBibitem.C
QBibitem.h
QBibitemDialog.C Qt4 compilation speedup patch by Bo Peng and me. 2006-05-18 08:51:12 +00:00
QBibitemDialog.h
QBibtex.C Replace Q3ListBox with QListWidget: 2006-05-02 19:17:59 +00:00
QBibtex.h
QBibtexDialog.C Qt4 compilation speedup patch by Bo Peng and me. 2006-05-18 08:51:12 +00:00
QBibtexDialog.h
QBox.C getting rid of even more qt3 convenience classes and unused headers... 2006-05-04 07:31:46 +00:00
QBox.h
QBoxDialog.C Qt4 compilation speedup patch by Bo Peng and me. 2006-05-18 08:51:12 +00:00
QBoxDialog.h
QBranch.C getting rid of even more qt3 convenience classes and unused headers... 2006-05-04 07:31:46 +00:00
QBranch.h
QBranchDialog.C Qt4 compilation speedup patch by Bo Peng and me. 2006-05-18 08:51:12 +00:00
QBranchDialog.h
QBranches.C Those classes (and their associated [Ch] files) are renamed : 2006-06-17 09:14:58 +00:00
QBranches.h getting rid of even more qt3 convenience classes and unused headers... 2006-05-04 07:31:46 +00:00
QBrowseBox.C Whitespace cleanup. 2006-04-05 23:56:29 +00:00
QBrowseBox.h
QChanges.C getting rid of even more qt3 convenience classes and unused headers... 2006-05-04 07:31:46 +00:00
QChanges.h
QChangesDialog.C Qt4 compilation speedup patch by Bo Peng and me. 2006-05-18 08:51:12 +00:00
QChangesDialog.h
QCharacter.C
QCharacter.h
QCharacterDialog.C Qt4 compilation speedup patch by Bo Peng and me. 2006-05-18 08:51:12 +00:00
QCharacterDialog.h
QCitation.C put citation dialog in good state: 2006-06-28 08:28:16 +00:00
QCitation.h put citation dialog in good state: 2006-06-28 08:28:16 +00:00
QCitationDialog.C put citation dialog in good state: 2006-06-28 08:28:16 +00:00
QCitationDialog.h put citation dialog in good state: 2006-06-28 08:28:16 +00:00
QCommandBuffer.C QtView renamed to GuiView 2006-06-20 09:33:01 +00:00
QCommandBuffer.h QtView renamed to GuiView 2006-06-20 09:33:01 +00:00
QCommandEdit.C Qt4 compilation speedup patch by Bo Peng and me. 2006-05-18 08:51:12 +00:00
QCommandEdit.h
QDelimiterDialog.C Qt4 compilation speedup patch by Bo Peng and me. 2006-05-18 08:51:12 +00:00
QDelimiterDialog.h
QDialogView.C Qt4 compilation speedup patch by Bo Peng and me. 2006-05-18 08:51:12 +00:00
QDialogView.h Changelog: 2006-03-22 18:59:17 +00:00
QDocument.C Whitespace cleanup. 2006-04-05 23:56:29 +00:00
QDocument.h
QDocumentDialog.C The Grand Font Selection Redesign: 2006-06-19 08:10:17 +00:00
QDocumentDialog.h The Grand Font Selection Redesign: 2006-06-19 08:10:17 +00:00
QErrorList.C get rid of convenience classes in the following dialogs (and associated implementation files): 2006-05-03 19:51:15 +00:00
QErrorList.h get rid of convenience classes in the following dialogs (and associated implementation files): 2006-05-03 19:51:15 +00:00
QErrorListDialog.C Qt4 compilation speedup patch by Bo Peng and me. 2006-05-18 08:51:12 +00:00
QErrorListDialog.h get rid of convenience classes in the following dialogs (and associated implementation files): 2006-05-03 19:51:15 +00:00
QERT.C
QERT.h
QERTDialog.C Qt4 compilation speedup patch by Bo Peng and me. 2006-05-18 08:51:12 +00:00
QERTDialog.h
QExternal.C get rid of convenience classes in the following dialogs (and associated implementation files): 2006-05-03 19:51:15 +00:00
QExternal.h
QExternalDialog.C Qt4 compilation speedup patch by Bo Peng and me. 2006-05-18 08:51:12 +00:00
QExternalDialog.h
QFloat.C
QFloat.h
QFloatDialog.C Qt4 compilation speedup patch by Bo Peng and me. 2006-05-18 08:51:12 +00:00
QFloatDialog.h
qfont_metrics.C GUI API Cleanup step 2: merge of the "younes" branch. 2006-06-26 16:55:35 +00:00
qfontexample.C Those classes (and their associated [Ch] files) are renamed : 2006-06-17 09:14:58 +00:00
qfontexample.h
QGraphics.C clean up of the graphics dialog: 2006-04-06 21:04:27 +00:00
QGraphics.h
QGraphicsDialog.C Qt4 compilation speedup patch by Bo Peng and me. 2006-05-18 08:51:12 +00:00
QGraphicsDialog.h clean up of the graphics dialog: 2006-04-06 21:04:27 +00:00
QGraphicsUi.h
QInclude.C
QInclude.h
QIncludeDialog.C Qt4 compilation speedup patch by Bo Peng and me. 2006-05-18 08:51:12 +00:00
QIncludeDialog.h
QIndex.C
QIndex.h
QIndexDialog.C Qt4 compilation speedup patch by Bo Peng and me. 2006-05-18 08:51:12 +00:00
QIndexDialog.h
QLImage.C Whitespace cleanup. 2006-04-05 23:56:29 +00:00
QLImage.h
qlkey.h
QLMenubar.C QtView renamed to GuiView 2006-06-20 09:33:01 +00:00
QLMenubar.h QtView renamed to GuiView 2006-06-20 09:33:01 +00:00
QLog.C getting rid of even more qt3 convenience classes and unused headers... 2006-05-04 07:31:46 +00:00
QLog.h
QLogDialog.C Qt4 compilation speedup patch by Bo Peng and me. 2006-05-18 08:51:12 +00:00
QLogDialog.h
QLPainter.C GUI API Cleanup step 2: merge of the "younes" branch. 2006-06-26 16:55:35 +00:00
QLPainter.h * reset color/linestyle/linewidth cache to QPen defaults on QPainter creation 2006-06-25 11:18:56 +00:00
QLPopupMenu.C QtView renamed to GuiView 2006-06-20 09:33:01 +00:00
QLPopupMenu.h Whitespace cleanup. 2006-04-05 23:56:29 +00:00
QLPrintDialog.C Qt4 compilation speedup patch by Bo Peng and me. 2006-05-18 08:51:12 +00:00
QLPrintDialog.h
QLToolbar.C QtView renamed to GuiView 2006-06-20 09:33:01 +00:00
QLToolbar.h QtView renamed to GuiView 2006-06-20 09:33:01 +00:00
QLyXKeySym.C getting rid of qt4 convenience classes: 2006-05-07 10:20:43 +00:00
QLyXKeySym.h getting rid of qt4 convenience classes: 2006-05-07 10:20:43 +00:00
QMath.C
QMath.h
QMathDialog.C Qt4 compilation speedup patch by Bo Peng and me. 2006-05-18 08:51:12 +00:00
QMathDialog.h Porting work from Edwin Leuven: 2006-04-05 15:10:34 +00:00
QMathMatrixDialog.C Qt4 compilation speedup patch by Bo Peng and me. 2006-05-18 08:51:12 +00:00
QMathMatrixDialog.h
QNote.C
QNote.h
QNoteDialog.C Qt4 compilation speedup patch by Bo Peng and me. 2006-05-18 08:51:12 +00:00
QNoteDialog.h
QParagraph.C getting rid of even more qt3 convenience classes and unused headers... 2006-05-04 07:31:46 +00:00
QParagraph.h
QParagraphDialog.C Qt4 compilation speedup patch by Bo Peng and me. 2006-05-18 08:51:12 +00:00
QParagraphDialog.h
QPrefs.C Those classes (and their associated [Ch] files) are renamed : 2006-06-17 09:14:58 +00:00
QPrefs.h Changelog: 2006-03-22 18:59:17 +00:00
QPrefsDialog.C some connections not made because of: 2006-06-28 12:48:51 +00:00
QPrefsDialog.h some connections not made because of: 2006-06-28 12:48:51 +00:00
QPrint.C
QPrint.h
QRef.C compile fix for OS X 2006-06-06 10:10:11 +00:00
QRef.h compile fix for OS X 2006-06-06 10:10:11 +00:00
QRefDialog.C Qt4 compilation speedup patch by Bo Peng and me. 2006-05-18 08:51:12 +00:00
QRefDialog.h get rid of convenience classes in the following dialogs (and associated implementation files): 2006-05-03 19:51:15 +00:00
QSearch.C
QSearch.h
QSearchDialog.C Qt4 compilation speedup patch by Bo Peng and me. 2006-05-18 08:51:12 +00:00
QSearchDialog.h
QSendto.C get rid of convenience classes in the following dialogs (and associated implementation files): 2006-05-03 19:51:15 +00:00
QSendto.h
QSendtoDialog.C Qt4 compilation speedup patch by Bo Peng and me. 2006-05-18 08:51:12 +00:00
QSendtoDialog.h get rid of convenience classes in the following dialogs (and associated implementation files): 2006-05-03 19:51:15 +00:00
qsetborder.C Qt4 compilation speedup patch by Bo Peng and me. 2006-05-18 08:51:12 +00:00
qsetborder.h
QShowFile.C getting rid of even more qt3 convenience classes and unused headers... 2006-05-04 07:31:46 +00:00
QShowFile.h
QShowFileDialog.C Qt4 compilation speedup patch by Bo Peng and me. 2006-05-18 08:51:12 +00:00
QShowFileDialog.h
QSpellchecker.C Patch from Martin Vermeer for bug 2218. 2006-06-27 12:20:16 +00:00
QSpellchecker.h
QSpellcheckerDialog.C Qt4 compilation speedup patch by Bo Peng and me. 2006-05-18 08:51:12 +00:00
QSpellcheckerDialog.h get rid of convenience classes in the following dialogs (and associated implementation files): 2006-05-03 19:51:15 +00:00
Qt2BC.C
Qt2BC.h
qt_helpers.C Remove qt2 support in the following files: 2006-03-17 19:02:43 +00:00
qt_helpers.h change string "qt2" to "qt4" 2006-04-24 13:25:50 +00:00
QTabular.C
QTabular.h
QTabularCreate.C
QTabularCreate.h
QTabularCreateDialog.C Add new tableinsertwidget 2006-05-31 12:53:05 +00:00
QTabularCreateDialog.h
QTabularDialog.C don't crash: apply values before closing 2006-06-01 20:33:37 +00:00
QTabularDialog.h
QTexinfo.C get rid of convenience classes in the following dialogs (and associated implementation files): 2006-05-03 19:51:15 +00:00
QTexinfo.h
QTexinfoDialog.C Qt4 compilation speedup patch by Bo Peng and me. 2006-05-18 08:51:12 +00:00
QTexinfoDialog.h
QThesaurus.C get rid of convenience classes in the following dialogs (and associated implementation files): 2006-05-03 19:51:15 +00:00
QThesaurus.h
QThesaurusDialog.C Qt4 compilation speedup patch by Bo Peng and me. 2006-05-18 08:51:12 +00:00
QThesaurusDialog.h get rid of convenience classes in the following dialogs (and associated implementation files): 2006-05-03 19:51:15 +00:00
QToc.C * QToc.[Ch], QTocDialog.[Ch]: adaptation to ControlToc changes in r13772 2006-04-28 09:16:48 +00:00
QToc.h * QToc.[Ch], QTocDialog.[Ch]: adaptation to ControlToc changes in r13772 2006-04-28 09:16:48 +00:00
QTocDialog.C Qt4 compilation speedup patch by Bo Peng and me. 2006-05-18 08:51:12 +00:00
QTocDialog.h * QToc.[Ch], QTocDialog.[Ch]: adaptation to ControlToc changes in r13772 2006-04-28 09:16:48 +00:00
qtTimeout.C
qtTimeout.h
QURLDialog.C QURL renamed to UrlView 2006-06-28 12:09:25 +00:00
QURLDialog.h QURL renamed to UrlView 2006-06-28 12:09:25 +00:00
QViewSource.C Qt4 compilation speedup patch by Bo Peng and me. 2006-05-18 08:51:12 +00:00
QViewSource.h Initial Qt4 support for view-source feature (r13610), from Bo Peng (ben.bob@gmail.com) 2006-04-15 14:13:41 +00:00
QViewSourceDialog.C Qt4 compilation speedup patch by Bo Peng and me. 2006-05-18 08:51:12 +00:00
QViewSourceDialog.h Initial Qt4 support for view-source feature (r13610), from Bo Peng (ben.bob@gmail.com) 2006-04-15 14:13:41 +00:00
QVSpace.C
QVSpace.h
QVSpaceDialog.C Qt4 compilation speedup patch by Bo Peng and me. 2006-05-18 08:51:12 +00:00
QVSpaceDialog.h Fix enableCustom 2006-04-11 10:51:59 +00:00
QWrap.C
QWrap.h
QWrapDialog.C Qt4 compilation speedup patch by Bo Peng and me. 2006-05-18 08:51:12 +00:00
QWrapDialog.h
README remove references to deleted file QtLyXView.h 2006-06-14 19:26:23 +00:00
socket_callback.C Qt4 compilation speedup patch by Bo Peng and me. 2006-05-18 08:51:12 +00:00
socket_callback.h Whitespace cleanup. 2006-04-05 23:56:29 +00:00
TocModel.C Qt4 compilation speedup patch by Bo Peng and me. 2006-05-18 08:51:12 +00:00
TocModel.h * QToc.[Ch], QTocDialog.[Ch]: adaptation to ControlToc changes in r13772 2006-04-28 09:16:48 +00:00
UrlView.C QURL renamed to UrlView 2006-06-28 12:09:25 +00:00
UrlView.h QURL renamed to UrlView 2006-06-28 12:09:25 +00:00
validators.C Qt4 compilation speedup patch by Bo Peng and me. 2006-05-18 08:51:12 +00:00
validators.h

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.

moc is incredibly stupid and sometimes you need a fully qualified
"std::string" for .connect() statements to work. Be very, very careful.

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_

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.