lyx_mirror/src/frontends/qt4
Pavel Sanda 8ea66efe16 Attempt to fix #8137 (arrived at r40862).
1) Revert to designer compilable by older Qt's
2) Remove spacer in right part of dialog
3) Decrease height.
2012-04-24 02:02:25 +02:00
..
ui Attempt to fix #8137 (arrived at r40862). 2012-04-24 02:02:25 +02:00
.gitignore Setup .gitignore for generated files 2012-03-22 02:16:12 +01:00
Action.cpp
Action.h
BulletsModule.cpp Update status when bullet size is changed. 2011-06-04 12:50:39 +00:00
BulletsModule.h
ButtonController.cpp
ButtonController.h
ButtonPolicy.cpp Revert r35760, as suggested by Vincent. 2010-10-21 19:33:29 +00:00
ButtonPolicy.h fix compiler warnings in pedantic mode: remove trailing comma after last enum member 2010-12-17 19:56:51 +00:00
CMakeLists.txt cmake: move CMakeLists.txt into source dir (multiple steps) 2011-05-10 17:44:41 +00:00
ColorCache.cpp
ColorCache.h
CustomizedWidgets.cpp
CustomizedWidgets.h
Dialog.cpp Added method for easy reach of main document buffer. 2011-05-27 21:53:23 +00:00
Dialog.h Added method for easy reach of main document buffer. 2011-05-27 21:53:23 +00:00
DialogView.h DialogView: make GuiView the parent widget to partly solve bug #6710. 2010-10-21 13:40:49 +00:00
DockView.h close floating dock widgets (not currently docked) with escape keypress event 2011-09-29 18:52:36 +00:00
EmptyTable.cpp
EmptyTable.h
FancyLineEdit.cpp Another unused variable. 2011-09-23 17:52:11 +00:00
FancyLineEdit.h Compile fix for Qt 4.5 and earlier. The other build systems should update 2011-06-08 19:45:52 +00:00
FileDialog.cpp Take Vincent's advice: using a pointer for selectedFilter 2011-10-15 13:32:14 +00:00
FileDialog.h Take Vincent's advice: using a pointer for selectedFilter 2011-10-15 13:32:14 +00:00
FindAndReplace.cpp More useful message (tells the user that ESC cancels the long operation in progress). 2012-03-06 23:26:19 +00:00
FindAndReplace.h This makes the FindAndReplace replace-related buttons de-activate 2012-01-07 11:41:04 +00:00
FloatPlacement.cpp More include frenzy. 2010-10-31 01:04:03 +00:00
FloatPlacement.h
GuiAbout.cpp
GuiAbout.h
GuiAlert.cpp Qt performs its own formatting to assure a maximum line length of the 2011-03-02 00:26:34 +00:00
GuiApplication.cpp Fix bugs #6871 and #8119. 2012-04-13 02:57:25 +02:00
GuiApplication.h Fix bugs #6871 and #8119. 2012-04-13 02:57:25 +02:00
GuiBibitem.cpp Remove the name parameter from string2params and params2string. We can always derive the name with insetName(params.code()). 2010-10-29 00:25:28 +00:00
GuiBibitem.h
GuiBibtex.cpp Move the citation engine machinery to layouts. 2012-03-01 00:41:30 +00:00
GuiBibtex.h
GuiBox.cpp
GuiBox.h
GuiBranch.cpp
GuiBranch.h
GuiBranches.cpp Fix monolithic build (bug #8079) 2012-03-24 15:25:30 +01:00
GuiBranches.h Fix handling of the add branch textfield in GuiBranches 2012-03-03 14:39:32 +00:00
GuiChanges.cpp Fix bug #4213: Change tracking support for tex2lyx. 2011-11-06 17:03:59 +00:00
GuiChanges.h
GuiCharacter.cpp
GuiCharacter.h
GuiCitation.cpp Move the citation engine machinery to layouts. 2012-03-01 00:41:30 +00:00
GuiCitation.h Move the citation engine machinery to layouts. 2012-03-01 00:41:30 +00:00
GuiClipboard.cpp Fix bug #6538 (Figure: relative path changed to absolute on copy/paste) 2010-12-11 23:04:24 +00:00
GuiClipboard.h Fix bug #6538 (Figure: relative path changed to absolute on copy/paste) 2010-12-11 23:04:24 +00:00
GuiCommandBuffer.cpp Revert "Don't allow newline characters in the command buffer." 2011-10-19 22:52:34 +00:00
GuiCommandBuffer.h
GuiCommandEdit.cpp
GuiCommandEdit.h
GuiCompare.cpp Fix bug #7540. Patch based upon one added to bug report by Max Funk. 2011-06-01 13:18:08 +00:00
GuiCompare.h Some cosmetics (from my local cosmetics branch). 2010-10-18 14:20:03 +00:00
GuiCompareHistory.cpp
GuiCompareHistory.h
GuiCompleter.cpp The Cursor argument here was not being used, so there is no need 2011-12-02 22:44:38 +00:00
GuiCompleter.h The Cursor argument here was not being used, so there is no need 2011-12-02 22:44:38 +00:00
GuiDelimiter.cpp * GuiDelimiter.cpp: disable cut and paste inside the listviews (bug 6942). 2010-10-15 07:12:49 +00:00
GuiDelimiter.h
GuiDialog.cpp
GuiDialog.h Typos in the comment. 2011-02-13 09:59:14 +00:00
GuiDocument.cpp Rename is_valid_ as validated_, which is a bit more informative. 2012-04-21 16:25:38 -04:00
GuiDocument.h Rename is_valid_ as validated_, which is a bit more informative. 2012-04-21 16:25:38 -04:00
GuiErrorList.cpp Generalize check to generic non-editable insets. 2011-04-05 15:40:00 +00:00
GuiErrorList.h
GuiERT.cpp
GuiERT.h
GuiExternal.cpp Move readBB_from_PSFile() out of support (no code change), 2012-02-15 20:50:52 +00:00
GuiExternal.h
GuiFontExample.cpp
GuiFontExample.h
GuiFontLoader.cpp Add some extra information about bug #3684. 2010-12-29 05:50:50 +00:00
GuiFontLoader.h
GuiFontMetrics.cpp Fix bug #7187: Font painting problems with emulated scaling. 2010-12-29 05:35:03 +00:00
GuiFontMetrics.h Avoid narrowing in array initializator 2012-01-07 18:29:07 +00:00
GuiGraphics.cpp Move readBB_from_PSFile() out of support (no code change), 2012-02-15 20:50:52 +00:00
GuiGraphics.h
GuiGraphicsUi.h
GuiHSpace.cpp Simplify code a bit. 2011-11-23 16:49:34 +00:00
GuiHSpace.h InsetSpace support for 2011-08-29 14:07:30 +00:00
GuiHyperlink.cpp Fix assert in all InsetParamsWidget's for unicode characters (bug #7017) 2010-11-07 17:38:39 +00:00
GuiHyperlink.h Migrate GuiHyperlink to InsetParamsDialog. 2010-10-27 17:02:42 +00:00
GuiIdListModel.cpp Fix a couple of compilation issues with gcc 4.6. See bug #7285. 2011-02-07 22:47:02 +00:00
GuiIdListModel.h
GuiImage.cpp
GuiImage.h
GuiInclude.cpp Fix the file filters for InsetInclude. 2011-09-13 20:43:06 +00:00
GuiInclude.h fix compiler warnings in pedantic mode: remove trailing comma after last enum member 2010-12-17 19:56:51 +00:00
GuiIndex.cpp
GuiIndex.h
GuiIndices.cpp Don't allow newline characters in document settings. 2011-09-24 16:39:23 +00:00
GuiIndices.h Rename QLineEdit widgets to have a LE suffix (consistent within GuiDocument). 2011-09-24 16:39:20 +00:00
GuiInfo.cpp More include frenzy. 2010-10-31 01:04:03 +00:00
GuiInfo.h
GuiKeySymbol.cpp fix wrong preprocessor 2011-02-23 21:06:15 +00:00
GuiKeySymbol.h
GuiLabel.cpp Fix assert in all InsetParamsWidget's for unicode characters (bug #7017) 2010-11-07 17:38:39 +00:00
GuiLabel.h Revert r35933. There are insets not based upon InsetCommand, such as 2010-10-31 18:56:32 +00:00
GuiLine.cpp fix typo: double semicolon at line end of code 2010-12-21 15:28:55 +00:00
GuiLine.h
GuiListings.cpp
GuiListings.h
GuiLog.cpp
GuiLog.h
GuiMathMatrix.cpp This should be fixed. 2010-11-13 23:01:30 +00:00
GuiMathMatrix.h
GuiNomenclature.cpp Implement GuiNomenclature::initialiseParams(), thus restoring the 2011-09-11 14:14:04 +00:00
GuiNomenclature.h Implement GuiNomenclature::initialiseParams(), thus restoring the 2011-09-11 14:14:04 +00:00
GuiNote.cpp
GuiNote.h
GuiPainter.cpp #7266 drawing of dotted lines with QPen and line width of 0.5 does not work well - restore line width 0 for thin line 2011-03-08 15:35:24 +00:00
GuiPainter.h
GuiParagraph.cpp
GuiParagraph.h
GuiPhantom.cpp
GuiPhantom.h
GuiPrefs.cpp Since version 1.9 SumatraPDF supports forward search without DDE commands. 2012-03-02 02:35:30 +00:00
GuiPrefs.h Use libmagic for file format detection if available. 2012-02-21 20:29:44 +00:00
GuiPrint.cpp Fix bug #7540. Patch based upon one added to bug report by Max Funk. 2011-06-01 13:18:08 +00:00
GuiPrint.h
GuiPrintindex.cpp Remove the name parameter from string2params and params2string. We can always derive the name with insetName(params.code()). 2010-10-29 00:25:28 +00:00
GuiPrintindex.h
GuiPrintNomencl.cpp GuiPrintNomencl.cpp: fix bug #7853 2011-10-24 23:35:01 +00:00
GuiPrintNomencl.h Revert r35933. There are insets not based upon InsetCommand, such as 2010-10-31 18:56:32 +00:00
GuiProgress.cpp Fix bug #8032 (timeout when using the Sweave module) 2012-02-18 14:16:25 +00:00
GuiProgress.h Fix bug #8032 (timeout when using the Sweave module) 2012-02-18 14:16:25 +00:00
GuiProgressView.cpp
GuiProgressView.h
GuiRef.cpp Remove the name parameter from string2params and params2string. We can always derive the name with insetName(params.code()). 2010-10-29 00:25:28 +00:00
GuiRef.h
GuiSearch.cpp
GuiSearch.h
GuiSelection.cpp
GuiSelection.h
GuiSelectionManager.cpp GuiCitation: Do not allow to add entries by pressing Enter when the Add button is disabled. 2012-03-03 12:39:19 +00:00
GuiSelectionManager.h
GuiSendto.cpp Fix the outstanding part of #7764, which involves sorting the file lists 2011-10-30 20:02:14 +00:00
GuiSendto.h
GuiSetBorder.cpp
GuiSetBorder.h
GuiShowFile.cpp
GuiShowFile.h
GuiSpellchecker.cpp #7978 validate stored doc iterators for start position and selection range to avoid crashes in case the user does the spell check and unrelated changes in parallel 2012-01-12 06:12:28 +00:00
GuiSpellchecker.h Fixes the following issues: 2011-04-08 13:26:45 +00:00
GuiSymbols.cpp
GuiSymbols.h
GuiTabular.cpp full support for table rotations; fileformat change 2012-03-21 23:04:45 +01:00
GuiTabular.h Fix #7021: the problem was that activating the border combo was triggering dialogToParams() and thus disallowed because of the empty value. 2010-12-04 10:55:03 +00:00
GuiTabularCreate.cpp
GuiTabularCreate.h
GuiTexinfo.cpp Also display the info about BibTeX databases in the TeX info panel. 2011-12-03 22:24:58 +00:00
GuiTexinfo.h Also display the info about BibTeX databases in the TeX info panel. 2011-12-03 22:24:58 +00:00
GuiThesaurus.cpp Implement access to hunspell's stemming function and let the Thesaurus use that (part of bug #8060). 2012-03-02 10:20:09 +00:00
GuiThesaurus.h Implement access to hunspell's stemming function and let the Thesaurus use that (part of bug #8060). 2012-03-02 10:20:09 +00:00
GuiToc.cpp
GuiToc.h
GuiToolbar.cpp Fix bug #8069: View/Update other formats button disabled with non-TeX fonts 2012-03-15 12:55:40 +01:00
GuiToolbar.h Fix bug #8069: View/Update other formats button disabled with non-TeX fonts 2012-03-15 12:55:40 +01:00
GuiView.cpp Whitespace. 2012-01-22 22:20:50 +00:00
GuiView.h Fix the messaging after an autosave 2011-10-30 21:34:12 +00:00
GuiViewSource.cpp Accidentally removed this code at last commit. 2012-03-10 16:49:20 +00:00
GuiViewSource.h The View->Source pane resets the format every time you click into 2011-12-09 19:48:50 +00:00
GuiVSpace.cpp
GuiVSpace.h
GuiWorkArea_Private.h Introduce new RC option for QImage backend instead of macro. This can later be changed at runtime though a command line option or by auto detecting the X11 remote status. 2011-12-17 21:53:46 +00:00
GuiWorkArea.cpp If we switch via the mouse, we need to update the Buffer 2012-01-13 03:31:48 +00:00
GuiWorkArea.h First step towards a little bit more independence of GuiWorkArea (WRT GuiView). Ideally, GuiWorkArea should not at all about GuiView. GuiWorkArea now uses a new signal busy() to inform its container (GuiView) about its status. 2011-10-23 20:21:01 +00:00
GuiWrap.cpp
GuiWrap.h
IconPalette.cpp
IconPalette.h
InGuiThread.cpp check also if there is a QApplication instance 2010-11-01 21:32:59 +00:00
InGuiThread.h Be compatible with Qt 4.2 and 4.3 (Q_EMIT). 2010-11-03 00:38:35 +00:00
InsertTableWidget.cpp
InsertTableWidget.h
InsetParamsDialog.cpp InsetParamsDialog: update the dialog settings on context change (on user request). 2011-01-31 14:48:16 +00:00
InsetParamsDialog.h InsetParamsDialog: update the dialog settings on context change (on user request). 2011-01-31 14:48:16 +00:00
InsetParamsWidget.cpp set eol-style 2010-11-18 19:50:29 +00:00
InsetParamsWidget.h set eol-style 2010-11-18 19:50:29 +00:00
LaTeXHighlighter.cpp
LaTeXHighlighter.h
LayoutBox.cpp Fixing ASSERT on re-opening of Advanced F&R with cursor on a text style non-existing in the currently opened document. 2011-10-18 22:04:42 +00:00
LayoutBox.h Cleanup private part of Layout Box on destructor (probably not really an 2011-10-15 13:34:14 +00:00
LengthCombo.cpp
LengthCombo.h
LyXFileDialog.cpp
LyXFileDialog.h
Makefile.am compilation fix; a couple of warnings 2011-10-17 08:57:28 +00:00
Menus.cpp Move the citation engine machinery to layouts. 2012-03-01 00:41:30 +00:00
Menus.h Remove extra whitespace. 2011-12-03 22:15:11 +00:00
PanelStack.cpp Fix the tab ordering of PanelStack and PrefsUi. 2011-09-24 16:39:26 +00:00
PanelStack.h Add a search box to the Document Settings and Preferences dialog. 2011-06-05 17:54:27 +00:00
pch.h
qt_helpers.cpp Better label for index list. 2011-09-15 21:48:45 +00:00
qt_helpers.h Fix bug #7540. Patch based upon one added to bug report by Max Funk. 2011-06-01 13:18:08 +00:00
qt_i18n.h
README
TocModel.cpp Fix bug #7709. Seems we need to reset the source model here. 2011-11-23 16:52:46 +00:00
TocModel.h
TocWidget.cpp Native support for \lstlistoflistings 2012-04-16 21:40:59 +02:00
TocWidget.h Attempt to workaround movement and editation slowness. 2010-12-19 22:27:21 +00:00
Toolbars.cpp Fix another instance of "visibility >= MATH". This was forgotten in r37068. 2011-01-03 12:14:44 +00:00
Toolbars.h Remove GuiToolbar::allowauto_ and define this property in the Toolbars.h::Visibility enum. 2011-01-03 11:42:01 +00:00
Validator.cpp Move the NoNewLineValidator to Validator.cpp where it fits better. 2011-09-24 16:39:17 +00:00
Validator.h Move the NoNewLineValidator to Validator.cpp where it fits better. 2011-09-24 16:39:17 +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.