lyx_mirror/src/frontends/qt4
2014-08-23 16:01:03 +02:00
..
ui Fix compilation warnings on windows. 2014-07-28 09:46:13 +02:00
.gitignore Setup .gitignore for generated files 2012-03-22 02:16:12 +01:00
Action.cpp Even more llvm/clang warnings 2013-05-02 19:22:10 +02:00
Action.h Even more llvm/clang warnings 2013-05-02 19:22:10 +02:00
BulletsModule.cpp
BulletsModule.h
ButtonController.cpp
ButtonController.h
ButtonPolicy.cpp
ButtonPolicy.h
CategorizedCombo.cpp Consider filtering when selecting from categorized combo (#8452) 2012-12-10 12:52:23 +01:00
CategorizedCombo.h Rescue monolithic build after 32fde61c8f. 2012-11-24 17:48:47 +01:00
CMakeLists.txt Make it compilable under cmake again after the merge from str-metrics 2014-07-25 22:03:59 +02:00
ColorCache.cpp
ColorCache.h
CustomizedWidgets.cpp Correct \file statement 2013-12-21 12:58:23 +01:00
CustomizedWidgets.h
Dialog.cpp Another assertion that got changed wrongly. 2013-04-27 18:12:27 -04:00
Dialog.h Remove some header leftovers based on Scott's script hints. 2013-05-02 00:30:16 -07:00
DialogView.h
DockView.h
EmptyTable.cpp
EmptyTable.h More llvm/clang warnings 2013-05-02 18:27:32 +02:00
FancyLineEdit.cpp Prepare LyX code to compile and link with Qt5: 2013-02-03 19:26:21 +01:00
FancyLineEdit.h Prepare LyX code to compile and link with Qt5: 2013-02-03 19:26:21 +01:00
FileDialog.cpp Fix various warnings issued by clang++. 2014-04-22 00:04:04 +02:00
FileDialog.h Fix various warnings issued by clang++. 2014-04-22 00:04:04 +02:00
FindAndReplace.cpp Fix a bunch of minor issues discovered by the cppcheck script. 2014-04-21 11:52:00 -04:00
FindAndReplace.h Header cleanup cont. 2013-05-19 18:07:53 -07:00
FloatPlacement.cpp
FloatPlacement.h
GuiAbout.cpp GuiAbout: Add missing include 2013-05-15 07:47:02 +02:00
GuiAbout.h
GuiAlert.cpp On Linux show in crash message box the backtrace 2014-06-14 11:25:25 +02:00
GuiApplication.cpp Correct the method signature of MenuTranslator::translate for Qt5 2014-08-23 16:01:03 +02:00
GuiApplication.h Avoid that, if an error dialog pops up during a long operation, it freezes LyX. 2012-08-18 22:45:21 +01:00
GuiBibitem.cpp
GuiBibitem.h
GuiBibtex.cpp Revert a6e42e5079. 2012-06-28 20:52:20 +02:00
GuiBibtex.h
GuiBox.cpp GuiBox.cpp, InsetBox.cpp: fix some wrong logic 2013-05-25 15:07:17 +02:00
GuiBox.h support for \mbox and \fbox 2013-03-22 01:33:58 +01:00
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
GuiChanges.h
GuiCharacter.cpp Fix toggling of 'misc' font options (bug #8764) 2013-07-17 08:30:42 +02:00
GuiCharacter.h More llvm/clang warnings 2013-05-02 18:27:32 +02:00
GuiCitation.cpp Fix bug #9131 for development branch. There are two parts to the fix. 2014-05-23 11:26:45 -04:00
GuiCitation.h Fix bug #9131 for development branch. There are two parts to the fix. 2014-05-23 11:26:45 -04:00
GuiClipboard.cpp GuiLog: Use GuiClipboard to put the log on the clipboard 2014-04-29 15:38:35 +02:00
GuiClipboard.h GuiLog: Use GuiClipboard to put the log on the clipboard 2014-04-29 15:38:35 +02:00
GuiCommandBuffer.cpp Constify some catches and others 2012-09-17 04:05:34 -04:00
GuiCommandBuffer.h
GuiCommandEdit.cpp
GuiCommandEdit.h
GuiCompare.cpp
GuiCompare.h
GuiCompareHistory.cpp Add very simple revision comparison for git. 2013-02-09 19:35:22 -08:00
GuiCompareHistory.h Header cleanup cont. 2013-05-19 18:07:53 -07:00
GuiCompleter.cpp Header cleanup cont. 2013-05-19 18:07:53 -07:00
GuiCompleter.h Header cleanup cont. 2013-05-19 18:07:53 -07:00
GuiDelimiter.cpp This is the result of an audit of all static variables, looking 2014-04-21 11:51:57 -04:00
GuiDelimiter.h
GuiDialog.cpp Revert a6e42e5079. 2012-06-28 20:52:20 +02:00
GuiDialog.h
GuiDocument.cpp This is the result of an audit of all static variables, looking 2014-04-21 11:51:57 -04:00
GuiDocument.h A first batch of potential bugs spotted by llvm/clang 2013-05-02 16:38:25 +02:00
GuiErrorList.cpp Fix a bunch of small performance issues spotted by cppcheck 2014-07-05 19:13:10 +02:00
GuiErrorList.h
GuiERT.cpp
GuiERT.h
GuiExternal.cpp
GuiExternal.h
GuiFontExample.cpp
GuiFontExample.h
GuiFontLoader.cpp Remove support for LyXRC::force_paint_single_char 2014-07-08 21:30:05 +02:00
GuiFontLoader.h
GuiFontMetrics.cpp Better algorithm for forcing bidi drawing 2014-07-25 19:56:51 +02:00
GuiFontMetrics.h Fix positionning of cursor 2014-07-08 21:30:05 +02:00
GuiGraphics.cpp This is the result of an audit of all static variables, looking 2014-04-21 11:51:57 -04:00
GuiGraphics.h Header cleanup cont. 2013-05-20 18:47:16 -07:00
GuiGraphicsUi.h
GuiHSpace.cpp Focus on custom line edit when custom is selected 2013-11-15 01:03:14 -05:00
GuiHSpace.h
GuiHyperlink.cpp If the selection is some sort of URL, then make it the target, not 2014-02-23 11:36:54 -05:00
GuiHyperlink.h If the selection is some sort of URL, then make it the target, not 2014-02-23 11:36:54 -05:00
GuiIdListModel.cpp Audit all the LASSERT calls, and try to do something sensible at 2013-04-25 17:27:10 -04:00
GuiIdListModel.h
GuiImage.cpp
GuiImage.h
GuiInclude.cpp This is the result of an audit of all static variables, looking 2014-04-21 11:51:57 -04:00
GuiInclude.h
GuiIndex.cpp
GuiIndex.h
GuiIndices.cpp
GuiIndices.h
GuiInfo.cpp Revert a6e42e5079. 2012-06-28 20:52:20 +02:00
GuiInfo.h
GuiKeySymbol.cpp Audit all the LASSERT calls, and try to do something sensible at 2013-04-25 17:27:10 -04:00
GuiKeySymbol.h Header cleanup cont. 2013-05-20 18:47:16 -07:00
GuiLabel.cpp
GuiLabel.h
GuiLine.cpp Revert a6e42e5079. 2012-06-28 20:52:20 +02:00
GuiLine.h
GuiListings.cpp This is the result of an audit of all static variables, looking 2014-04-21 11:51:57 -04:00
GuiListings.h
GuiLog.cpp Get rid of ugly font metrics workarounds. 2014-06-25 17:55:16 +02:00
GuiLog.h
GuiMathMatrix.cpp Fix bug #9153 (Using mathpanel to insert matrix creates extra space on top) 2014-06-06 16:14:24 +02:00
GuiMathMatrix.h
GuiNomenclature.cpp
GuiNomenclature.h
GuiNote.cpp
GuiNote.h
GuiPainter.cpp Better algorithm for forcing bidi drawing 2014-07-25 19:56:51 +02:00
GuiPainter.h Better algorithm for forcing bidi drawing 2014-07-25 19:56:51 +02:00
GuiParagraph.cpp Add layout tag that determines if/when a paragraph can be indented. 2014-05-29 14:10:32 +02:00
GuiParagraph.h Header cleanup cont. 2013-05-20 18:47:16 -07:00
GuiPhantom.cpp
GuiPhantom.h
GuiPrefs.cpp Merge remote-tracking branch 'features/str-metrics' 2014-07-25 20:10:55 +02:00
GuiPrefs.h Header cleanup cont. 2013-05-20 18:47:16 -07:00
GuiPrint.cpp
GuiPrint.h Header cleanup cont. 2013-05-20 18:47:16 -07:00
GuiPrintindex.cpp
GuiPrintindex.h
GuiPrintNomencl.cpp Revert a6e42e5079. 2012-06-28 20:52:20 +02:00
GuiPrintNomencl.h
GuiProgress.cpp On Linux show in crash message box the backtrace 2014-06-14 11:25:25 +02:00
GuiProgress.h On Linux show in crash message box the backtrace 2014-06-14 11:25:25 +02:00
GuiProgressView.cpp Get rid of ugly font metrics workarounds. 2014-06-25 17:55:16 +02:00
GuiProgressView.h Header cleanup cont. 2013-05-20 18:47:16 -07:00
GuiRef.cpp Make BufferList::fileNames() threadsafe 2014-07-05 12:51:40 +02:00
GuiRef.h Fix issues with xref dialog in read-only documents (#8177) 2012-09-29 16:12:31 +02:00
GuiSearch.cpp Style 2014-02-04 10:37:29 +01:00
GuiSearch.h Adding wrap-around pop-up question to simple find and replace dialog (fixing enhancement request #1262). 2013-07-21 17:51:53 +01:00
GuiSelection.cpp Use the cached value GuiSelection::selection_supported_ 2014-04-29 15:17:15 +02:00
GuiSelection.h
GuiSelectionManager.cpp Revert a6e42e5079. 2012-06-28 20:52:20 +02:00
GuiSelectionManager.h Remove ; from end of function definitions 2013-05-12 13:04:18 +02:00
GuiSendto.cpp Do not sort formats in BufferParams::exportableFormats 2013-03-24 18:06:32 +01:00
GuiSendto.h
GuiSetBorder.cpp qt5: Use Qt::WindowFlags instead of Qt::WFlags 2012-12-15 11:07:35 +01:00
GuiSetBorder.h qt5: Use Qt::WindowFlags instead of Qt::WFlags 2012-12-15 11:07:35 +01:00
GuiShowFile.cpp
GuiShowFile.h
GuiSpellchecker.cpp Fix bug #8238: correct the forward argument of replace2string() in on_replacePB_clicked(). 2012-07-27 00:34:17 +02:00
GuiSpellchecker.h
GuiSymbols.cpp Fix various warnings issued by clang++. 2014-04-22 00:04:04 +02:00
GuiSymbols.h
GuiTabular.cpp GuiTabular: disabling is now done on textChanged() 2013-03-19 14:48:20 -04:00
GuiTabular.h
GuiTabularCreate.cpp
GuiTabularCreate.h
GuiTexinfo.cpp
GuiTexinfo.h Header cleanup cont. 2013-05-22 19:58:58 -07:00
GuiThesaurus.cpp Revert a6e42e5079. 2012-06-28 20:52:20 +02:00
GuiThesaurus.h Header cleanup cont. 2013-05-22 19:58:58 -07:00
GuiToc.cpp Revert a6e42e5079. 2012-06-28 20:52:20 +02:00
GuiToc.h Header cleanup cont. 2013-05-22 19:58:58 -07:00
GuiToolbar.cpp Header cleanup cont. 2013-05-22 19:58:58 -07:00
GuiToolbar.h Header cleanup cont. 2013-05-22 19:58:58 -07:00
GuiView.cpp Revert "Clear empty selections in GuiView after dispatch" 2014-08-03 19:20:56 -04:00
GuiView.h Some fixes to the SaveAs dialog 2013-11-15 09:20:07 +01:00
GuiViewSource.cpp Merge remote-tracking branch 'features/str-metrics' 2014-07-25 20:10:55 +02:00
GuiViewSource.h Header cleanup cont. 2013-05-22 19:58:58 -07:00
GuiVSpace.cpp Add missing widget update 2013-11-15 19:29:15 +01:00
GuiVSpace.h
GuiWorkArea_Private.h Header cleanup cont. 2013-05-22 19:58:58 -07:00
GuiWorkArea.cpp Use QProxyStyle instead of QMacStyle. QMacStyle is not available anymore with At5 and QProxyStyle is present since Qt4.6 as an alternative 2014-08-22 11:17:34 +02:00
GuiWorkArea.h Header cleanup cont. 2013-05-22 19:58:58 -07:00
GuiWrap.cpp
GuiWrap.h
IconPalette.cpp
IconPalette.h
InGuiThread.cpp
InGuiThread.h LyX 2.1 will support only Qt>=4.5. 2012-11-04 01:22:32 +01:00
InsertTableWidget.cpp More llvm/clang warnings 2013-05-02 18:27:32 +02:00
InsertTableWidget.h More llvm/clang warnings 2013-05-02 18:27:32 +02:00
InsetParamsDialog.cpp Revert a6e42e5079. 2012-06-28 20:52:20 +02:00
InsetParamsDialog.h Header cleanup cont. 2013-05-22 19:58:58 -07:00
InsetParamsWidget.cpp Fix bug 8880: do not try to validate custom value if it is disabled 2013-11-12 15:48:34 +01:00
InsetParamsWidget.h
LaTeXHighlighter.cpp
LaTeXHighlighter.h
LayoutBox.cpp Audit all the LASSERT calls, and try to do something sensible at 2013-04-25 17:27:10 -04:00
LayoutBox.h
LengthCombo.cpp Move LengthCombo into namespace lyx::frontend 2012-12-17 21:38:57 +01:00
LengthCombo.h Move LengthCombo into namespace lyx::frontend 2012-12-17 21:38:57 +01:00
LyXFileDialog.cpp Fix file dialogs with Qt 5.2.0 and later. 2013-12-24 17:21:56 +01:00
LyXFileDialog.h
Makefile.am Update autotools for building with Qt5. 2014-07-19 03:34:28 +02:00
Menus.cpp Disable branches insert menu if read only 2014-07-28 12:59:35 -04:00
Menus.h Remove some header leftovers based on Scott's script hints. 2013-05-02 00:30:16 -07:00
PanelStack.cpp Fix assert: Do not use translated names as keys 2013-05-13 10:00:57 +02:00
PanelStack.h
pch.h
qt_helpers.cpp Fix a bunch of minor issues discovered by the cppcheck script. 2014-04-21 11:52:00 -04:00
qt_helpers.h Fix empty width support for Box inset 2013-05-24 15:44:59 +02:00
qt_i18n.h
README
TocModel.cpp Header cleanup cont. 2013-05-22 19:58:58 -07:00
TocModel.h Header cleanup cont. 2013-05-22 19:58:58 -07:00
TocWidget.cpp Focus on buffer after section select in Outliner 2014-04-21 11:51:57 -04:00
TocWidget.h
Toolbars.cpp An IPA toolbar 2012-08-21 14:56:34 +02:00
Toolbars.h An IPA toolbar 2012-08-21 14:56:34 +02:00
Validator.cpp "Performance" fixes suggested by cppcheck 2012-05-28 22:42:44 +02:00
Validator.h "Performance" fixes suggested by cppcheck 2012-05-28 22:42:44 +02: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.