lyx_mirror/src/frontends/qt4
Peter Kümmel 66e5f1bf39 revert buggy patch.
git-svn-id: svn://svn.lyx.org/lyx/lyx-devel/trunk@18495 a592a061-630c-0410-9148-cb99ea01b6c8
2007-05-24 17:17:35 +00:00
..
ui Add dialect support and showstringspaces parameter to the listings dialog, fix bug 3664. Mostly from Jurgen 2007-05-23 02:05:01 +00:00
Action.cpp Last (?) batch of renames: 2007-04-28 20:44:46 +00:00
Action.h Rename .C ==> .cpp for files in src, part one 2007-04-26 04:41:58 +00:00
alert_pimpl.cpp Last (?) batch of renames: 2007-04-28 20:44:46 +00:00
BulletsModule.cpp Rename .C ==> .cpp for files in src/frontends/qt4, part two 2007-04-26 03:53:51 +00:00
BulletsModule.h code cosmetics whitespace, unneeded lyx:: qualification, indentation, unneeded destructors and the like 2007-04-25 16:39:21 +00:00
ChangeLog rename LColor into Color 2007-04-26 17:34:20 +00:00
CheckedLineEdit.cpp Rename .C ==> .cpp for files in src/frontends/qt4, part two 2007-04-26 03:53:51 +00:00
CheckedLineEdit.h Rename .C ==> .cpp for files in src/frontends/qt4, part two 2007-04-26 03:53:51 +00:00
ColorCache.cpp I guess Windows folks are not too happy with files named color.h and Color.h 2007-04-26 19:21:38 +00:00
ColorCache.h rename LColor into Color 2007-04-26 17:34:20 +00:00
Dialogs.cpp Add support for listings package. Two listings command \lstinline, \lstinputlisting and an environment \lstlisting are supported, along with preamble \lstset. \lstinputlisting is implemented through Include dialog, and the other two are implemented with a new inset listings, along with its dialog. 2007-05-09 19:11:42 +00:00
DockView.h
EmptyTable.cpp Rename .C ==> .cpp for files in src/frontends/qt4, part two 2007-04-26 03:53:51 +00:00
EmptyTable.h Rename .C ==> .cpp for files in src/frontends/qt4, part two 2007-04-26 03:53:51 +00:00
FileDialog.cpp Rename files in src/support, step one. 2007-04-26 05:12:52 +00:00
FloatPlacement.cpp Rename .C ==> .cpp for files in src/frontends/qt4, part two 2007-04-26 03:53:51 +00:00
FloatPlacement.h
GuiApplication.cpp * LyX::addFileToLoad(): new method for double-clicked file icons on MacOS. 2007-05-04 17:20:53 +00:00
GuiApplication.h rename LColor into Color 2007-04-26 17:34:20 +00:00
GuiClipboard.cpp Rename .C ==> .cpp for files in src/frontends/qt4, part two 2007-04-26 03:53:51 +00:00
GuiClipboard.h
GuiFontLoader.cpp rename LyXFont to Font except in tex2lyx 2007-04-29 18:17:15 +00:00
GuiFontLoader.h rename LyXFont to Font except in tex2lyx 2007-04-29 18:17:15 +00:00
GuiFontMetrics.cpp Rename .C ==> .cpp for files in src, part one 2007-04-26 04:41:58 +00:00
GuiFontMetrics.h
GuiImplementation.cpp Rename .C ==> .cpp for files in src, part one 2007-04-26 04:41:58 +00:00
GuiImplementation.h
GuiSelection.cpp Rename .C ==> .cpp for files in src/frontends/qt4, part two 2007-04-26 03:53:51 +00:00
GuiSelection.h code cosmetics whitespace, unneeded lyx:: qualification, indentation, unneeded destructors and the like 2007-04-25 16:39:21 +00:00
GuiView.cpp Last (?) batch of renames: 2007-04-28 20:44:46 +00:00
GuiView.h Rename .C ==> .cpp for files in src, part one 2007-04-26 04:41:58 +00:00
GuiWorkArea.cpp revert buggy patch. 2007-05-24 17:17:35 +00:00
GuiWorkArea.h Rename .C ==> .cpp for files in src, part one 2007-04-26 04:41:58 +00:00
IconPalette.cpp Rename .C ==> .cpp for files in src/frontends/qt4, part two 2007-04-26 03:53:51 +00:00
IconPalette.h Rename .C ==> .cpp for files in src/frontends/qt4, part two 2007-04-26 03:53:51 +00:00
InsertTableWidget.cpp Rename .C ==> .cpp for files in src, part one 2007-04-26 04:41:58 +00:00
InsertTableWidget.h
KeySymbol.cpp rename LyXKeySym into KeySymbol 2007-04-27 08:43:38 +00:00
LengthCombo.cpp rename/merge LyXLength related stuff 2007-04-28 12:58:49 +00:00
LengthCombo.h rename/merge LyXLength related stuff 2007-04-28 12:58:49 +00:00
LyXFileDialog.cpp Rename files in src/support, step one. 2007-04-26 05:12:52 +00:00
LyXFileDialog.h Rename .C ==> .cpp for files in src/frontends/qt4, part two 2007-04-26 03:53:51 +00:00
Makefile.am Add support for listings package. Two listings command \lstinline, \lstinputlisting and an environment \lstlisting are supported, along with preamble \lstset. \lstinputlisting is implemented through Include dialog, and the other two are implemented with a new inset listings, along with its dialog. 2007-05-09 19:11:42 +00:00
Makefile.dialogs Add support for listings package. Two listings command \lstinline, \lstinputlisting and an environment \lstlisting are supported, along with preamble \lstset. \lstinputlisting is implemented through Include dialog, and the other two are implemented with a new inset listings, along with its dialog. 2007-05-09 19:11:42 +00:00
PanelStack.cpp Rename .C ==> .cpp for files in src/frontends/qt4, part two 2007-04-26 03:53:51 +00:00
PanelStack.h Rename .C ==> .cpp for files in src/frontends/qt4, part two 2007-04-26 03:53:51 +00:00
pch.h
QAbout.cpp Rename .C ==> .cpp for files in src/frontends/qt4, part two 2007-04-26 03:53:51 +00:00
QAbout.h merge QAbout and QAboutDialog 2007-04-24 11:32:09 +00:00
QBibitem.cpp Rename .C ==> .cpp for files in src/frontends/qt4, part two 2007-04-26 03:53:51 +00:00
QBibitem.h more dialog merging 2007-04-25 08:42:22 +00:00
QBibtex.cpp Last (?) batch of renames: 2007-04-28 20:44:46 +00:00
QBibtex.h more dialog merging 2007-04-25 08:42:22 +00:00
QBox.cpp rename/merge LyXLength related stuff 2007-04-28 12:58:49 +00:00
QBox.h merge QBox and QBoxDialog 2007-04-24 10:56:22 +00:00
QBranch.cpp Rename .C ==> .cpp for files in src/frontends/qt4, part two 2007-04-26 03:53:51 +00:00
QBranch.h more dialog merging 2007-04-25 08:42:22 +00:00
QBranches.cpp Rename .C ==> .cpp for files in src, part one 2007-04-26 04:41:58 +00:00
QBranches.h
QChanges.cpp Rename .C ==> .cpp for files in src/frontends/qt4, part two 2007-04-26 03:53:51 +00:00
QChanges.h more dialog merging 2007-04-25 10:25:37 +00:00
QCharacter.cpp rename LColor into Color 2007-04-26 17:34:20 +00:00
QCharacter.h rename LyXFont to Font except in tex2lyx 2007-04-29 18:17:15 +00:00
QCitation.cpp Rename .C ==> .cpp for files in src/frontends/qt4, part two 2007-04-26 03:53:51 +00:00
QCitation.h
QCitationDialog.cpp Fix minor bug involving overlapping citation strings. 2007-05-22 15:20:19 +00:00
QCitationDialog.h renaming in frontends/qt4/ui: s/Q//g 2007-04-24 08:56:28 +00:00
QCommandBuffer.cpp Implement shortcut (M-x) to hide the minibuffer 2007-04-29 08:58:09 +00:00
QCommandBuffer.h Implement shortcut (M-x) to hide the minibuffer 2007-04-29 08:58:09 +00:00
QCommandEdit.cpp Implement shortcut (M-x) to hide the minibuffer 2007-04-29 08:58:09 +00:00
QCommandEdit.h Implement shortcut (M-x) to hide the minibuffer 2007-04-29 08:58:09 +00:00
QDelimiterDialog.cpp rename LyXFont to Font except in tex2lyx 2007-04-29 18:17:15 +00:00
QDelimiterDialog.h renaming in frontends/qt4/ui: s/Q//g 2007-04-24 08:56:28 +00:00
QDialogView.cpp Rename .C ==> .cpp for files in src/frontends/qt4, part two 2007-04-26 03:53:51 +00:00
QDialogView.h
QDocument.cpp two small missing bits for rev18468 2007-05-23 04:09:09 +00:00
QDocument.h Fix gcc warning and be 64 bit clean. 2007-05-14 16:41:50 +00:00
QErrorList.cpp Rename .C ==> .cpp for files in src/frontends/qt4, part two 2007-04-26 03:53:51 +00:00
QErrorList.h more dialog merging 2007-04-25 10:25:37 +00:00
QERT.cpp Rename .C ==> .cpp for files in src/frontends/qt4, part two 2007-04-26 03:53:51 +00:00
QERT.h merge QERT and QERTDialog 2007-04-24 13:47:33 +00:00
QExternal.cpp Fix bug similar to 3377 by Ozgur Ugras BARAN. 2007-05-14 12:43:17 +00:00
QExternal.h more dialog merging 2007-04-25 08:42:22 +00:00
QFloat.cpp Rename .C ==> .cpp for files in src/frontends/qt4, part two 2007-04-26 03:53:51 +00:00
QFloat.h
QFloatDialog.cpp Rename .C ==> .cpp for files in src/frontends/qt4, part two 2007-04-26 03:53:51 +00:00
QFloatDialog.h renaming in frontends/qt4/ui: s/Q//g 2007-04-24 08:56:28 +00:00
QFontExample.cpp Rename .C ==> .cpp for files in src/frontends/qt4, part two 2007-04-26 03:53:51 +00:00
QFontExample.h Rename .C ==> .cpp for files in src/frontends/qt4, part two 2007-04-26 03:53:51 +00:00
QGraphics.cpp rename/merge LyXLength related stuff 2007-04-28 12:58:49 +00:00
QGraphics.h
QGraphicsDialog.cpp Fix bug 3377 by Ozgur Ugras BARAN: 2007-05-11 14:25:25 +00:00
QGraphicsDialog.h renaming in frontends/qt4/ui: s/Q//g 2007-04-24 08:56:28 +00:00
QGraphicsUi.h
QInclude.cpp two small missing bits for rev18468 2007-05-23 04:09:09 +00:00
QInclude.h Add support for listings package. Two listings command \lstinline, \lstinputlisting and an environment \lstlisting are supported, along with preamble \lstset. \lstinputlisting is implemented through Include dialog, and the other two are implemented with a new inset listings, along with its dialog. 2007-05-09 19:11:42 +00:00
QIndex.cpp Rename .C ==> .cpp for files in src/frontends/qt4, part two 2007-04-26 03:53:51 +00:00
QIndex.h code cosmetics whitespace, unneeded lyx:: qualification, indentation, unneeded destructors and the like 2007-04-25 16:39:21 +00:00
QKeySymbol.cpp rename LyXKeySym into KeySymbol 2007-04-27 08:43:38 +00:00
QKeySymbol.h rename LyXKeySym into KeySymbol 2007-04-27 08:43:38 +00:00
QLImage.cpp Rename files in src/support, step one. 2007-04-26 05:12:52 +00:00
QLImage.h
QListings.cpp Make listings dialog translatable (mostly strings from InsetListingsParams), fix bug 3645 2007-05-23 02:09:58 +00:00
QListings.h Add dialect support and showstringspaces parameter to the listings dialog, fix bug 3664. Mostly from Jurgen 2007-05-23 02:05:01 +00:00
qlkey.h
QLMenubar.cpp Rename .C ==> .cpp for files in src/frontends/qt4, part two 2007-04-26 03:53:51 +00:00
QLMenubar.h code cosmetics whitespace, unneeded lyx:: qualification, indentation, unneeded destructors and the like 2007-04-25 16:39:21 +00:00
QLog.cpp Rename .C ==> .cpp for files in src/frontends/qt4, part two 2007-04-26 03:53:51 +00:00
QLog.h more Foo/FooDialog merge 2007-04-24 19:37:34 +00:00
QLPainter.cpp * avoid mallocs by only increasing the points array by at least a constant factor 2007-05-20 08:50:54 +00:00
QLPainter.h rename LyXFont to Font except in tex2lyx 2007-04-29 18:17:15 +00:00
QLPopupMenu.cpp Rename .C ==> .cpp for files in src/frontends/qt4, part two 2007-04-26 03:53:51 +00:00
QLPopupMenu.h Rename .C ==> .cpp for files in src, part one 2007-04-26 04:41:58 +00:00
QLPrintDialog.cpp Rename .C ==> .cpp for files in src/frontends/qt4, part two 2007-04-26 03:53:51 +00:00
QLPrintDialog.h renaming in frontends/qt4/ui: s/Q//g 2007-04-24 08:56:28 +00:00
QLToolbar.cpp - introduces toolbar_toggle lfun 2007-05-23 22:08:07 +00:00
QLToolbar.h - introduces toolbar_toggle lfun 2007-05-23 22:08:07 +00:00
QMathMatrixDialog.cpp QMathMatrixDialog.cpp: fix part of bug 3475 2007-05-07 18:30:41 +00:00
QMathMatrixDialog.h renaming in frontends/qt4/ui: s/Q//g 2007-04-24 08:56:28 +00:00
QNomencl.cpp Rename .C ==> .cpp for files in src/frontends/qt4, part two 2007-04-26 03:53:51 +00:00
QNomencl.h more dialog merging 2007-04-25 10:57:54 +00:00
QNote.cpp Rename .C ==> .cpp for files in src/frontends/qt4, part two 2007-04-26 03:53:51 +00:00
QNote.h more dialog merging 2007-04-25 10:57:54 +00:00
QParagraph.cpp Fix for bug 3524: Indent checkbox is enabled even when paragraphs are marked 2007-05-08 15:35:44 +00:00
QParagraph.h resolve the layout.h <=> Layout.h conflict 2007-04-29 22:04:32 +00:00
QPrefs.cpp Fix files with spaces in converter cache; 2007-05-17 08:31:00 +00:00
QPrefs.h Problem: When canceling the preferences dialog after changing a color then the icon in the colors list is not reverted after reopening the dialog. Moreover when pressing apply later then the color is really changed. 2007-05-09 20:16:31 +00:00
QPrint.cpp Rename .C ==> .cpp for files in src/frontends/qt4, part two 2007-04-26 03:53:51 +00:00
QPrint.h
QRef.cpp [Bug 3461] Make escape key trigger a reset of the dialog. 2007-05-17 12:11:56 +00:00
QRef.h code cosmetics whitespace, unneeded lyx:: qualification, indentation, unneeded destructors and the like 2007-04-25 16:39:21 +00:00
QSearch.cpp Rename .C ==> .cpp for files in src/frontends/qt4, part two 2007-04-26 03:53:51 +00:00
QSearch.h merge QSearch and QSearchDialog 2007-04-24 13:27:23 +00:00
QSendto.cpp Rename .C ==> .cpp for files in src, part one 2007-04-26 04:41:58 +00:00
QSendto.h more dialog merging 2007-04-25 10:57:54 +00:00
QSetBorder.cpp Rename .C ==> .cpp for files in src/frontends/qt4, part two 2007-04-26 03:53:51 +00:00
QSetBorder.h Rename .C ==> .cpp for files in src/frontends/qt4, part two 2007-04-26 03:53:51 +00:00
QShowFile.cpp Rename .C ==> .cpp for files in src/frontends/qt4, part two 2007-04-26 03:53:51 +00:00
QShowFile.h more Foo/FooDialog merge 2007-04-24 19:37:34 +00:00
QSpellchecker.cpp Rename .C ==> .cpp for files in src/frontends/qt4, part two 2007-04-26 03:53:51 +00:00
QSpellchecker.h merge QSpellChecker and QSpellcheckerDialog 2007-04-24 15:32:14 +00:00
Qt2BC.cpp Rename .C ==> .cpp for files in src/frontends/qt4, part two 2007-04-26 03:53:51 +00:00
Qt2BC.h code cosmetics whitespace, unneeded lyx:: qualification, indentation, unneeded destructors and the like 2007-04-25 16:39:21 +00:00
qt_helpers.cpp rename/merge LyXLength related stuff 2007-04-28 12:58:49 +00:00
qt_helpers.h rename/merge LyXLength related stuff 2007-04-28 12:58:49 +00:00
QTabular.cpp rename/merge LyXLength related stuff 2007-04-28 12:58:49 +00:00
QTabular.h merge the tabular/gui related files 2007-04-24 17:46:08 +00:00
QTabularCreate.cpp Rename .C ==> .cpp for files in src/frontends/qt4, part two 2007-04-26 03:53:51 +00:00
QTabularCreate.h merge the tabular/gui related files 2007-04-24 17:46:08 +00:00
QTexinfo.cpp Rename .C ==> .cpp for files in src/frontends/qt4, part two 2007-04-26 03:53:51 +00:00
QTexinfo.h merge QTexinfo and QTexinfoDialog 2007-04-24 15:10:14 +00:00
QThesaurus.cpp Rename .C ==> .cpp for files in src/frontends/qt4, part two 2007-04-26 03:53:51 +00:00
QThesaurus.h merge QThesaurus and QThesaurusDialog 2007-04-24 14:35:15 +00:00
QToc.cpp Fix assertion with LOF and LOT by transfering the test from TocWidget::select() to QToc::getCurrentIndex(). 2007-05-15 18:01:22 +00:00
QToc.h Fix bugs 3528 and 3534 by Ozgur Ugras BARAN and myself: 2007-05-10 16:25:11 +00:00
qtTimeout.cpp Rename .C ==> .cpp for files in src/frontends/qt4, part two 2007-04-26 03:53:51 +00:00
qtTimeout.h
QURLDialog.cpp Rename .C ==> .cpp for files in src/frontends/qt4, part two 2007-04-26 03:53:51 +00:00
QURLDialog.h renaming in frontends/qt4/ui: s/Q//g 2007-04-24 08:56:28 +00:00
QViewSource.cpp Rename .C ==> .cpp for files in src/frontends/qt4, part two 2007-04-26 03:53:51 +00:00
QViewSource.h merge QViewSource and QViewSourceDialog 2007-04-24 14:08:53 +00:00
QVSpace.cpp rename/merge LyXLength related stuff 2007-04-28 12:58:49 +00:00
QVSpace.h merge QVSpace and QVSpaceDialog 2007-04-24 12:02:27 +00:00
QWrap.cpp rename/merge LyXLength related stuff 2007-04-28 12:58:49 +00:00
QWrap.h merge QWrapDialog and QWrap 2007-04-24 14:59:51 +00:00
README renaming in frontends/qt4/ui: s/Q//g 2007-04-24 08:56:28 +00:00
socket_callback.cpp Rename .C ==> .cpp for files in src/frontends/qt4, part two 2007-04-26 03:53:51 +00:00
socket_callback.h
TocModel.cpp Rename .C ==> .cpp for files in src/frontends/qt4, part two 2007-04-26 03:53:51 +00:00
TocModel.h
TocWidget.cpp Fix assertion with LOF and LOT by transfering the test from TocWidget::select() to QToc::getCurrentIndex(). 2007-05-15 18:01:22 +00:00
TocWidget.h From Ozgur Ugras BARAN: Fix bug 3529 2007-05-15 11:26:24 +00:00
UrlView.cpp Rename .C ==> .cpp for files in src/frontends/qt4, part two 2007-04-26 03:53:51 +00:00
UrlView.h
Validator.cpp Last (?) batch of renames: 2007-04-28 20:44:46 +00:00
Validator.h rename/merge LyXLength related stuff 2007-04-28 12:58:49 +00:00

This file contains some do's and dont's for the Qt4 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.

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/FooDialog.ui       The designer file
ui/FooDialogBase.[Ch] Generated files from FooDialog.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
GB - group box
LA - label
LC - LengthCombo
LV - QListView
ML - QTextBrowser
PB - push button
RB - radio button
SB - spin box
SL - slider
TE - text edit
TW - tree widget (FIXME: also TV in some files)


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 uses a different encoding (UCS4) than Qt (UTF16), therefore there are a
number of conversion functions in qt_helpers.[Ch]. Read the doxygen
documentation for details when to use which function.

Additionally, you should follow these simple rules :

o Use qt_() not _() in code
o Use the conversion functions of qt_helpers.h, NOT .latin1() / .c_str() etc.