lyx_mirror/src/frontends/qt4
Jürgen Spitzmüller 59f41d955f * src/frontends/controllers/frontend_helpers.{cpp,h}:
- new function getSortedColors
* src/frontends/qt4/QPrefs.cpp:
	- use that to sort the colors (bug 2571)

git-svn-id: svn://svn.lyx.org/lyx/lyx-devel/trunk@19236 a592a061-630c-0410-9148-cb99ea01b6c8
2007-07-30 13:48:46 +00:00
..
ui * src/frontends/qt4/ui/ParagraphUi.ui: just tiny cosmetics (make dialog more compact) 2007-07-11 10:09:19 +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 Whitespace cleanup 2007-05-28 22:27:45 +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 * added WidgetFlags argument to DockView to set Qt::Drawer flag where needed 2007-05-29 11:38:28 +00:00
DockView.h * added WidgetFlags argument to DockView to set Qt::Drawer flag where needed 2007-05-29 11:38:28 +00:00
EmptyTable.cpp Whitespace cleanup 2007-05-28 22:27:45 +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 add comment and ling to bug 3907. 2007-07-03 08:23:04 +00:00
FloatPlacement.cpp Whitespace cleanup 2007-05-28 22:27:45 +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 fix unicode decomposition (bugs 3313 and 3498): 2007-07-05 14:45:00 +00:00
GuiClipboard.h
GuiFontLoader.cpp * workaround for Qt not selecting a Times font on Mac with Qt 4.3.0. As soon as the 2007-06-04 12:10:30 +00:00
GuiFontLoader.h Whitespace cleanup 2007-05-28 22:27:45 +00:00
GuiFontMetrics.cpp Put again the (slightly edited) caution warning from Georg Baum about abusing the ucs4_to_qchar() conversion with symbol fonts. This comment was accidentally deleted in rev 18593. 2007-05-31 16:40:11 +00:00
GuiFontMetrics.h This commit allows to support the full unicode range in GuiFontMetrics thus fixing the crash in this bug: 2007-05-31 12:48:42 +00:00
GuiImplementation.cpp Whitespace cleanup 2007-05-28 22:27:45 +00:00
GuiImplementation.h Whitespace cleanup 2007-05-28 22:27:45 +00:00
GuiSelection.cpp fix unicode decomposition (bugs 3313 and 3498): 2007-07-05 14:45:00 +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 With or without multiview, a crash can happen randomly if the statusbar timer times out after the view is closed. Two reason for that: 2007-07-17 09:21:52 +00:00
GuiView.h add tab close button 2007-06-11 14:53:36 +00:00
GuiWorkArea.cpp * update cursor position on resize _after_ drawing. Because before 2007-06-18 15:39:52 +00:00
GuiWorkArea.h Whitespace cleanup 2007-05-28 22:27:45 +00:00
IconPalette.cpp * Get rid the of the QWidgetAction subclass and use homebrew tearoff widget: 2007-06-21 09:51:50 +00:00
IconPalette.h * Get rid the of the QWidgetAction subclass and use homebrew tearoff widget: 2007-06-21 09:51:50 +00:00
InsertTableWidget.cpp Rename .C ==> .cpp for files in src, part one 2007-04-26 04:41:58 +00:00
InsertTableWidget.h Whitespace cleanup 2007-05-28 22:27:45 +00:00
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 Whitespace cleanup 2007-05-28 22:27:45 +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 Whitespace cleanup 2007-05-28 22:27:45 +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 Fix bug 2753: LyX doesn't support paths and filenames with parentheses 2007-06-26 16:55:42 +00:00
QBibtex.h more dialog merging 2007-04-25 08:42:22 +00:00
QBox.cpp Whitespace cleanup 2007-05-28 22:27:45 +00:00
QBox.h merge QBox and QBoxDialog 2007-04-24 10:56:22 +00:00
QBranch.cpp Whitespace cleanup 2007-05-28 22:27:45 +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 Whitespace cleanup 2007-05-28 22:27:45 +00:00
QCitation.h Whitespace cleanup 2007-05-28 22:27:45 +00:00
QCitationDialog.cpp Auto raising the dialog when the user click on a Citation inset... 2007-07-03 08:59:10 +00:00
QCitationDialog.h Fix for bugs 3741 and 3756. Here's what it does: 2007-06-02 15:48:21 +00:00
QCommandBuffer.cpp * On MacOSX enter is no activation key for a QListWidget. Hence it 2007-06-21 06:38:50 +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 Whitespace cleanup 2007-05-28 22:27:45 +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 Fix Bug 4053: Update other controls allows invalid listings parameters to be passed in listings-related dialogs. 2007-07-27 18:17:00 +00:00
QDocument.h Fix Bug 4053: Update other controls allows invalid listings parameters to be passed in listings-related dialogs. 2007-07-27 18:17:00 +00:00
QErrorList.cpp Whitespace cleanup 2007-05-28 22:27:45 +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 2753: LyX doesn't support paths and filenames with parentheses 2007-06-26 16:55:42 +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 Fix bug 2753: LyX doesn't support paths and filenames with parentheses 2007-06-26 16:55:42 +00:00
QGraphics.h
QGraphicsDialog.cpp Fix bug 1749. CAUTION: lyx2lyx not fully working yet (see FIXMEs). 2007-06-25 13:49:51 +00:00
QGraphicsDialog.h Fix bug 1749. CAUTION: lyx2lyx not fully working yet (see FIXMEs). 2007-06-25 13:49:51 +00:00
QGraphicsUi.h
QInclude.cpp Fix Bug 4053: Update other controls allows invalid listings parameters to be passed in listings-related dialogs. 2007-07-27 18:17:00 +00:00
QInclude.h Fix Bug 4053: Update other controls allows invalid listings parameters to be passed in listings-related dialogs. 2007-07-27 18:17:00 +00:00
QIndex.cpp Whitespace cleanup 2007-05-28 22:27:45 +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 Whitespace cleanup 2007-05-28 22:27:45 +00:00
QKeySymbol.h rename LyXKeySym into KeySymbol 2007-04-27 08:43:38 +00:00
QLImage.cpp Whitespace cleanup 2007-05-28 22:27:45 +00:00
QLImage.h
QListings.cpp Fix Bug 4053: Update other controls allows invalid listings parameters to be passed in listings-related dialogs. 2007-07-27 18:17:00 +00:00
QListings.h Fix Bug 4053: Update other controls allows invalid listings parameters to be passed in listings-related dialogs. 2007-07-27 18:17:00 +00:00
qlkey.h * src/frontends/qt4/qlkey.h: add AltGr as modifier key (fix bug 4026) 2007-07-18 16:52:52 +00:00
QLMenubar.cpp Whitespace cleanup 2007-05-28 22:27:45 +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 Whitespace cleanup 2007-05-28 22:27:45 +00:00
QLog.h more Foo/FooDialog merge 2007-04-24 19:37:34 +00:00
QLPainter.cpp Whitespace cleanup 2007-05-28 22:27:45 +00:00
QLPainter.h rename LyXFont to Font except in tex2lyx 2007-04-29 18:17:15 +00:00
QLPopupMenu.cpp Whitespace cleanup 2007-05-28 22:27:45 +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 Allow unicode in Layout names. 2007-07-11 13:39:08 +00:00
QLToolbar.h Allow unicode in Layout names. 2007-07-11 13:39:08 +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 Whitespace cleanup 2007-05-28 22:27:45 +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 * src/frontends/qt4/QParagraph.cpp: 2007-07-09 19:01:27 +00:00
QParagraph.h * src/frontends/qt4/QParagraph.cpp: 2007-07-09 19:01:27 +00:00
QPrefs.cpp * src/frontends/controllers/frontend_helpers.{cpp,h}: 2007-07-30 13:48:46 +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 * src/frontends/qt4/QPrint.cpp: 2007-06-26 16:46:40 +00:00
QPrint.h
QRef.cpp Whitespace cleanup 2007-05-28 22:27:45 +00:00
QRef.h Whitespace cleanup 2007-05-28 22:27:45 +00:00
QSearch.cpp Whitespace cleanup 2007-05-28 22:27:45 +00:00
QSearch.h merge QSearch and QSearchDialog 2007-04-24 13:27:23 +00:00
QSendto.cpp Whitespace cleanup 2007-05-28 22:27:45 +00:00
QSendto.h more dialog merging 2007-04-25 10:57:54 +00:00
QSetBorder.cpp Whitespace cleanup 2007-05-28 22:27:45 +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 Whitespace cleanup 2007-05-28 22:27:45 +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 Whitespace cleanup 2007-05-28 22:27:45 +00:00
qt_helpers.h Whitespace cleanup 2007-05-28 22:27:45 +00:00
QTabular.cpp Properly fix bug 3258. 2007-07-18 09:55:33 +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 Whitespace cleanup 2007-05-28 22:27:45 +00:00
QToc.h Whitespace cleanup 2007-05-28 22:27:45 +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 Whitespace cleanup 2007-05-28 22:27:45 +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 Cosmetics. 2007-06-12 12:29:19 +00:00
TocModel.h
TocWidget.cpp * src/frontends/qt4/TocWidget.cpp (updateGui): do not call getGUIName, since 2007-06-04 13:27:27 +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 Whitespace cleanup 2007-05-28 22:27:45 +00:00
Validator.h Whitespace cleanup 2007-05-28 22:27:45 +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.