lyx_mirror/src/frontends/qt4
Peter Kümmel ddc38c93ca don't block GUI when showing all debug messages
git-svn-id: svn://svn.lyx.org/lyx/lyx-devel/trunk@34612 a592a061-630c-0410-9148-cb99ea01b6c8
2010-06-07 20:25:41 +00:00
..
ui add support for decimal alignment in tables 2010-06-05 07:44:44 +00:00
Action.cpp * FuncStatus: unify naming of functions. 2010-04-16 10:51:20 +00:00
Action.h
BulletsModule.cpp Bullet's pref box glitch - looks like qt 4.5 changed some small finger paint and we need 2009-08-17 14:22:40 +00:00
BulletsModule.h
ButtonController.cpp
ButtonController.h Fix doxygen output for grouped items. Without the /name tag doxygen shows the group name as the name of the first item. Moreover, the comment styles are somewhat standardized. 2010-01-27 18:10:33 +00:00
ButtonPolicy.cpp Prevent warning when pressing OKAY while the dialog is in AUTOAPPLY_INITIAL state (GuiCharacter). 2009-05-03 15:27:47 +00:00
ButtonPolicy.h
ColorCache.cpp
ColorCache.h
CustomizedWidgets.cpp Patch from Ben M.: do not accept key events if we do not know what these keys 2009-07-06 16:14:20 +00:00
CustomizedWidgets.h
Dialog.cpp Dialog::bufferFilepath -> Dialog::bufferFilePath 2010-04-21 01:19:30 +00:00
Dialog.h Fix bug #6451 (last part): Crash when interacting with buffer-dependent dialog with no buffer open. 2010-04-26 02:12:10 +00:00
DialogView.h Fix bug #6451 (last part): Crash when interacting with buffer-dependent dialog with no buffer open. 2010-04-26 02:12:10 +00:00
DockView.h Fix bug #3871: Shortcut to switch from TOC to text pane. 2010-04-26 10:03:09 +00:00
EmptyTable.cpp
EmptyTable.h
FileDialog.cpp Proper camel case for FileName.absFilename 2010-04-21 01:19:09 +00:00
FileDialog.h
FindAndReplace.cpp Proper camel case for FileName.absFilename 2010-04-21 01:19:09 +00:00
FindAndReplace.h hopefully fix the (re)sizing of the adv search/replace 2010-03-27 17:37:41 +00:00
FloatPlacement.cpp Next headers 2010-03-31 19:38:05 +00:00
FloatPlacement.h InsetParamsWidget(): fix method constness. 2010-02-18 07:56:38 +00:00
GuiAbout.cpp Proper camel case for FileName.absFilename 2010-04-21 01:19:09 +00:00
GuiAbout.h About box: Migrate to DialogView. 2010-01-23 20:29:00 +00:00
GuiAlert.cpp Extend Alert::prompt such that 4 buttons are possible. Thus, when 2010-04-19 20:44:57 +00:00
GuiApplication.cpp Fix bug #6686: Navigate back does not trigger a repaint 2010-05-10 11:02:45 +00:00
GuiApplication.h Refactor GuiApplication::getStatus(). 2010-04-16 16:04:35 +00:00
GuiBibitem.cpp Migrate GuiBibitem to InsetParamsWidget. 2010-02-23 21:24:24 +00:00
GuiBibitem.h Migrate GuiBibitem to InsetParamsWidget. 2010-02-23 21:24:24 +00:00
GuiBibtex.cpp Dialog::bufferFilepath -> Dialog::bufferFilePath 2010-04-21 01:19:30 +00:00
GuiBibtex.h
GuiBox.cpp GuiBox.cpp: 2010-05-28 03:01:18 +00:00
GuiBox.h InsetParamsWidget(): fix method constness. 2010-02-18 07:56:38 +00:00
GuiBranch.cpp Migrate Branch dialog to InsetParamsWidget 2010-02-19 20:57:25 +00:00
GuiBranch.h Migrate Branch dialog to InsetParamsWidget 2010-02-19 20:57:25 +00:00
GuiBranches.cpp BranchList: 2010-04-21 01:19:35 +00:00
GuiBranches.h * Add possibility to append active branch names to the output file name (#3105). 2009-07-13 14:30:08 +00:00
GuiChanges.cpp Fix bug #2213 (part 3): GuiChanges lacks "Previous Change" button. 2009-04-05 19:15:52 +00:00
GuiChanges.h Fix bug #2213 (part 3): GuiChanges lacks "Previous Change" button. 2009-04-05 19:15:52 +00:00
GuiCharacter.cpp Introduce double underline and wavy underline styles from ulem 2009-05-05 09:26:28 +00:00
GuiCharacter.h Fix doxygen output for grouped items. Without the /name tag doxygen shows the group name as the name of the first item. Moreover, the comment styles are somewhat standardized. 2010-01-27 18:10:33 +00:00
GuiCitation.cpp Read the citation formats from a file, rather than hardcoding them. This 2010-03-29 18:37:25 +00:00
GuiCitation.h
GuiClipboard.cpp Proper camel case for FileName.absFilename 2010-04-21 01:19:09 +00:00
GuiClipboard.h
GuiCommandBuffer.cpp Seems boost also includes all std headers. Not including boost therefore produces errors. 2010-04-22 11:45:34 +00:00
GuiCommandBuffer.h Next camel 2009-05-23 09:40:44 +00:00
GuiCommandEdit.cpp
GuiCommandEdit.h
GuiCompare.cpp Dialog::bufferFilepath -> Dialog::bufferFilePath 2010-04-21 01:19:30 +00:00
GuiCompare.h Set the hourglass cursor for the dialog while running. However, the Cancel button can always be pressed, so this one gets a normal cursor. 2010-01-14 01:20:14 +00:00
GuiCompleter.cpp Make Cursor::disp_ private as it should be. 2010-04-15 17:34:34 +00:00
GuiCompleter.h
GuiDelimiter.cpp please Lars. 2009-03-15 15:53:17 +00:00
GuiDelimiter.h
GuiDialog.cpp fix ticket #6081 2009-07-14 16:01:55 +00:00
GuiDialog.h Fix bug #6451 (last part): Crash when interacting with buffer-dependent dialog with no buffer open. 2010-04-26 02:12:10 +00:00
GuiDocument.cpp Move hints from designer to code 2010-05-25 11:53:58 +00:00
GuiDocument.h * GuiDocument: 2010-05-18 02:56:36 +00:00
GuiErrorList.cpp Minor cleanup, and some const-ness. 2010-03-13 16:55:59 +00:00
GuiErrorList.h Fix bug #6462: Out-of-bounds index in GuiErrorList::goTo when new buffer is active. 2010-03-12 15:06:13 +00:00
GuiERT.cpp Attempt to simplify as much as possible Inset parameter dialog creation. We now just need an ui file and a class that inherits InsetParamsWidget and implement 4 methods. Then InsetParamsDialog will take care of the rest. InsetParamsDialog has 2 running mode: "immediate apply" and "Restore/OK/Close" which is the default; I hope this is enough to satisfy all users. The checkbox status might be saved later in session settings. 2010-02-15 23:17:45 +00:00
GuiERT.h InsetParamsWidget(): fix method constness. 2010-02-18 07:56:38 +00:00
GuiExternal.cpp Dialog::bufferFilepath -> Dialog::bufferFilePath 2010-04-21 01:19:30 +00:00
GuiExternal.h
GuiFontExample.cpp
GuiFontExample.h
GuiFontLoader.cpp Proper camel case for FileName.absFilename 2010-04-21 01:19:09 +00:00
GuiFontLoader.h
GuiFontMetrics.cpp
GuiFontMetrics.h
GuiGraphics.cpp Dialog::bufferFilepath -> Dialog::bufferFilePath 2010-04-21 01:19:30 +00:00
GuiGraphics.h stickToCodingConventions. 2009-05-23 08:01:38 +00:00
GuiGraphicsUi.h
GuiHSpace.cpp Unify "* space" into "* Space", its just double work for translators. 2010-04-28 21:48:10 +00:00
GuiHSpace.h Migrate GuiHSPace to InsetParamsDialog. 2010-02-21 09:28:33 +00:00
GuiHyperlink.cpp cmake: remove recursive call, even if it breaks merged builds with GCC, fix linker error on win32 2010-04-23 13:20:28 +00:00
GuiHyperlink.h
GuiIdListModel.cpp
GuiIdListModel.h
GuiImage.cpp Proper camel case for FileName.absFilename 2010-04-21 01:19:09 +00:00
GuiImage.h
GuiInclude.cpp Camelize another slot 2009-05-23 09:06:50 +00:00
GuiInclude.h Camelize another slot 2009-05-23 09:06:50 +00:00
GuiIndex.cpp New inset dialog for InsetIndex (only used with multiple indices).. 2009-04-17 09:22:44 +00:00
GuiIndex.h New inset dialog for InsetIndex (only used with multiple indices).. 2009-04-17 09:22:44 +00:00
GuiIndices.cpp * GuiIndices.cpp: 2009-08-27 16:47:45 +00:00
GuiIndices.h * GuiBranches.cpp: 2009-07-11 06:29:57 +00:00
GuiInfo.cpp LyX version info for InsetInfo. 2010-04-17 13:04:41 +00:00
GuiInfo.h InsetParamsWidget(): fix method constness. 2010-02-18 07:56:38 +00:00
GuiKeySymbol.cpp Patch from Ben M.: do not accept key events if we do not know what these keys 2009-07-06 16:14:20 +00:00
GuiKeySymbol.h
GuiLabel.cpp Update the GuiLabel view when the document is read-only. Also disable the text field. 2009-12-31 16:47:36 +00:00
GuiLabel.h Update the GuiLabel view when the document is read-only. Also disable the text field. 2009-12-31 16:47:36 +00:00
GuiListings.cpp CMake: fix merged build, seems GCC could not handle the namespaces correctly 2010-01-30 11:34:28 +00:00
GuiListings.h Camelize another slot 2009-05-23 09:06:50 +00:00
GuiLog.cpp * Include bibtex and makeindex logs to log file dialog. 2009-11-29 17:15:22 +00:00
GuiLog.h * Include bibtex and makeindex logs to log file dialog. 2009-11-29 17:15:22 +00:00
GuiMathMatrix.cpp Fix unsafe use of fixed width arrays. 2010-03-06 14:57:16 +00:00
GuiMathMatrix.h support for matrix decoration in the MathMatrix dialog; 2009-07-12 21:39:21 +00:00
GuiNomencl.cpp Fix also nomenclature dialog which was refered in #3852 2009-11-06 15:22:21 +00:00
GuiNomencl.h
GuiNote.cpp
GuiNote.h
GuiPainter.cpp little wiggles for on-the-fly spellcheck 2010-03-21 20:26:30 +00:00
GuiPainter.h Introduce double underline and wavy underline styles from ulem 2009-05-05 09:26:28 +00:00
GuiParagraph.cpp Add support for number localization in the GUI (using Qt's locale facilities). 2009-07-12 15:44:26 +00:00
GuiParagraph.h Better fix 2009-06-16 14:33:29 +00:00
GuiPhantom.cpp
GuiPhantom.h
GuiPrefs.cpp add support for decimal alignment in tables 2010-06-05 07:44:44 +00:00
GuiPrefs.h Join PrefDateUi and PrefPlaintextUi into PrefOutputUi 2010-04-15 14:25:25 +00:00
GuiPrint.cpp Dialog::bufferFilepath -> Dialog::bufferFilePath 2010-04-21 01:19:30 +00:00
GuiPrint.h
GuiPrintindex.cpp A GUI for nomencl settings. Adds the possibility to enter a custom length. 2009-05-22 16:26:15 +00:00
GuiPrintindex.h New inset dialog for InsetPrintIndex (only used with multiple indices).. 2009-04-17 14:29:32 +00:00
GuiPrintNomencl.cpp constify GuiPrintNomencl::isValid() 2009-05-26 16:19:03 +00:00
GuiPrintNomencl.h constify GuiPrintNomencl::isValid() 2009-05-26 16:19:03 +00:00
GuiProgress.cpp don't block GUI when showing all debug messages 2010-06-07 20:25:41 +00:00
GuiProgress.h don't block GUI when showing all debug messages 2010-06-07 20:25:41 +00:00
GuiProgressView.cpp fix bug #6748: queue LyXErrMessages so any other stuff is done 2010-06-03 21:24:20 +00:00
GuiProgressView.h Coding style, thanks Abdel. 2010-05-17 08:15:04 +00:00
GuiRef.cpp Proper camel case for FileName.absFilename 2010-04-21 01:19:09 +00:00
GuiRef.h * GuiRef: improve filter UI 2010-01-30 11:19:48 +00:00
GuiSearch.cpp LFUN_WORD_REPLACE: Invert replacement and searched strings in the FuncRequest argument. This is to allow replacement of current word even if it is not selected. 2009-07-04 23:02:27 +00:00
GuiSearch.h
GuiSelection.cpp
GuiSelection.h
GuiSelectionManager.cpp fix (again) monolithic build 2010-04-08 10:23:54 +00:00
GuiSelectionManager.h Take Andre's advice and implement the focus tracking using the event 2010-03-24 14:34:44 +00:00
GuiSendto.cpp headers cleanup 2009-05-14 09:20:58 +00:00
GuiSendto.h remove duplicated (and probably not really correct) code 2009-05-12 07:12:25 +00:00
GuiSetBorder.cpp * GuiSetBorder.cpp: lighter colour for disabled borders (not used currently). 2010-01-31 13:15:26 +00:00
GuiSetBorder.h
GuiShowFile.cpp support: 2010-04-21 01:19:28 +00:00
GuiShowFile.h
GuiSpellchecker.cpp * GuiSpellchecker.cpp: fix bug 6676. 2010-04-30 09:52:00 +00:00
GuiSpellchecker.h Fix bug #6451 (last part): Crash when interacting with buffer-dependent dialog with no buffer open. 2010-04-26 02:12:10 +00:00
GuiSymbols.cpp
GuiSymbols.h
GuiTabular.cpp add support for decimal alignment in tables 2010-06-05 07:44:44 +00:00
GuiTabular.h InsetParamsDialog: don't update the inset widget if we are not un 2010-02-19 11:04:15 +00:00
GuiTabularCreate.cpp
GuiTabularCreate.h
GuiTexinfo.cpp support: 2010-04-21 01:19:28 +00:00
GuiTexinfo.h
GuiThesaurus.cpp * GuiThesaurus: do not show irritating messages if nothing is to be looked up. 2010-04-20 09:59:16 +00:00
GuiThesaurus.h
GuiToc.cpp Fix bug #3871: Shortcut to switch from TOC to text pane. 2010-04-26 10:03:09 +00:00
GuiToc.h Fix bug #3918: Toggle outline button update when clicking x. 2009-05-14 23:46:42 +00:00
GuiToolbar.cpp Transfer LyXfunc code to GuiApplication::dispatch() and getStatus(). Now 2010-02-09 16:11:13 +00:00
GuiToolbar.h Move layout from GuiToolbar to GuiView. Now, it is possible to use the popup also when the Toolbar has not been visible before. 2009-08-14 22:58:57 +00:00
GuiView.cpp Fix bug #6606: Crash when reverting a document with a not available document class. 2010-06-04 13:24:03 +00:00
GuiView.h Fix bug #6606: Crash when reverting a document with a not available document class. 2010-06-04 13:24:03 +00:00
GuiViewSource.cpp GuiViewsource: 2009-04-01 20:32:26 +00:00
GuiViewSource.h
GuiVSpace.cpp Attempt to simplify as much as possible Inset parameter dialog creation. We now just need an ui file and a class that inherits InsetParamsWidget and implement 4 methods. Then InsetParamsDialog will take care of the rest. InsetParamsDialog has 2 running mode: "immediate apply" and "Restore/OK/Close" which is the default; I hope this is enough to satisfy all users. The checkbox status might be saved later in session settings. 2010-02-15 23:17:45 +00:00
GuiVSpace.h InsetParamsWidget(): fix method constness. 2010-02-18 07:56:38 +00:00
GuiWorkArea.cpp Fix bug #6606: Crash when reverting a document with a not available document class. 2010-06-04 13:24:03 +00:00
GuiWorkArea.h new buffer on double click in empty area of the tab bar 2010-04-18 11:30:20 +00:00
GuiWrap.cpp
GuiWrap.h
IconPalette.cpp
IconPalette.h
InsertTableWidget.cpp Transfer LyXfunc code to GuiApplication::dispatch() and getStatus(). Now 2010-02-09 16:11:13 +00:00
InsertTableWidget.h
InsetParamsDialog.cpp Migrate GuiBibitem to InsetParamsWidget. 2010-02-23 21:24:24 +00:00
InsetParamsDialog.h Implement Vincent's suggestions: 2010-02-19 20:44:59 +00:00
InsetParamsWidget.cpp Attempt to simplify as much as possible Inset parameter dialog creation. We now just need an ui file and a class that inherits InsetParamsWidget and implement 4 methods. Then InsetParamsDialog will take care of the rest. InsetParamsDialog has 2 running mode: "immediate apply" and "Restore/OK/Close" which is the default; I hope this is enough to satisfy all users. The checkbox status might be saved later in session settings. 2010-02-15 23:17:45 +00:00
InsetParamsWidget.h Migrate GuiHSPace to InsetParamsDialog. 2010-02-21 09:28:33 +00:00
LaTeXHighlighter.cpp Proper fix to avoid an infinite loop with Qt4.5. 2009-03-09 19:54:47 +00:00
LaTeXHighlighter.h
LayoutBox.cpp Transfer LyXfunc code to GuiApplication::dispatch() and getStatus(). Now 2010-02-09 16:11:13 +00:00
LayoutBox.h Remove GuiToolbar * member from the LayoutBox ctor: Why should we limit a LayoutBox to the Toolbar and it doesn't even have to know where it is. 2009-08-14 22:47:57 +00:00
LengthCombo.cpp According to André, QLatin1String is cheaper. 2010-02-01 01:07:32 +00:00
LengthCombo.h Another camel 2009-05-23 09:28:33 +00:00
LyXFileDialog.cpp
LyXFileDialog.h
Makefile.am Join PrefDateUi and PrefPlaintextUi into PrefOutputUi 2010-04-15 14:25:25 +00:00
Menus.cpp msvcUsing "using namespace std" with msvc10 makes also std::tr1::shared_ptr visible and generates conflicts with boost::shared_ptr. 2010-04-22 11:37:32 +00:00
Menus.h
PanelStack.cpp * PanelStack.{cpp,h}: 2010-01-10 14:46:39 +00:00
PanelStack.h * PanelStack.{cpp,h}: 2010-01-10 14:46:39 +00:00
pch.h
qt_helpers.cpp support: 2010-04-21 01:19:28 +00:00
qt_helpers.h support: 2010-04-21 01:19:28 +00:00
qt_i18n.h
README
TocModel.cpp Make sure the Table of Contents is always on top in the model combobox of the TocWidget. 2010-04-26 01:36:24 +00:00
TocModel.h Make sure the Table of Contents is always on top in the model combobox of the TocWidget. 2010-04-26 01:36:24 +00:00
TocWidget.cpp Fix the warning message "TocModel.cpp: type not found" when (re-)loading a file. 2010-06-01 09:56:07 +00:00
TocWidget.h This can just take a FuncCode. 2010-02-26 19:51:06 +00:00
Toolbars.cpp Using "using namespace std" with msvc10 makes also std::tr1::bind visible and generates conflicts with boost::bind. 2010-04-22 11:16:58 +00:00
Toolbars.h Introduce "samerow" toolbar tag and let View/Update toolbar to be in the 2010-01-27 17:19:14 +00:00
Validator.cpp * Validator.{cpp, h}: 2009-07-19 16:53:50 +00:00
Validator.h * Validator.{cpp, h}: 2009-07-19 16:53:50 +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
changed(). If you are using a more complicated thing anyway,
then remember to call 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 needs 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. This is
usually done by adding a top-level layout to the dialog in Designer.

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 slotOK() etc. Refer to close/cancel as close in the
source.

Override update_contents() to update the dialog, not update().  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.{cpp,h}     The file that interacts with the controller _and_
the implementation of the dialog, derived from the generated files
ui/FooDialog.ui  The designer file
ui_FooDialog.h   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)


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

LyX uses a different encoding (UCS4) than Qt (UTF16), therefore there are a
number of conversion functions in qt_helpers.{cpp,h}. 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.