lyx_mirror/src/frontends/qt4
Pavel Sanda 6b2d20c8a6 ToC tree redrawing after resets.
http://bugzilla.lyx.org/show_bug.cgi?id=3740


git-svn-id: svn://svn.lyx.org/lyx/lyx-devel/trunk@23436 a592a061-630c-0410-9148-cb99ea01b6c8
2008-03-04 12:39:03 +00:00
..
ui * WrapUI.ui: 2008-03-02 17:28:41 +00:00
Action.cpp header cleanup 2008-02-18 07:14:42 +00:00
Action.h
BulletsModule.cpp getting rid of superfluous std:: statements. 2007-12-12 19:28:07 +00:00
BulletsModule.h
ButtonController.cpp header cleanup 2008-02-18 07:14:42 +00:00
ButtonController.h Factorize out the way window titles are handled. 2008-02-05 12:43:19 +00:00
ButtonPolicy.cpp header cleanup 2008-02-18 07:14:42 +00:00
ButtonPolicy.h Move Dialog.{h,cpp} and ButtonPolicy.{h,cpp} to frontends/qt4/ 2007-11-22 08:01:09 +00:00
ColorCache.cpp
ColorCache.h
CustomizedWidgets.cpp more compile fixes 2008-02-18 09:55:14 +00:00
CustomizedWidgets.h
Dialog.cpp More cleanup from Andre. 2008-02-24 15:44:11 +00:00
Dialog.h compilation fix 2008-02-05 15:16:49 +00:00
DialogView.cpp header cleanup 2008-02-17 20:47:04 +00:00
DialogView.h Factorize out the way window titles are handled. 2008-02-05 12:43:19 +00:00
DockView.h Factorize out the way window titles are handled. 2008-02-05 12:43:19 +00:00
EmptyTable.cpp
EmptyTable.h
FileDialog.cpp Transfer FileDialog.h to qt4/ 2008-02-07 00:05:18 +00:00
FileDialog.h Transfer FileDialog.h to qt4/ 2008-02-07 00:05:18 +00:00
FloatPlacement.cpp *** Support for generic sideways floats *** 2008-01-11 18:56:53 +00:00
FloatPlacement.h *** Support for generic sideways floats *** 2008-01-11 18:56:53 +00:00
GuiAbout.cpp Factorize out the way window titles are handled. 2008-02-05 12:43:19 +00:00
GuiAbout.h Transfer some more dialog related code from core to frontend: 2007-11-23 09:44:02 +00:00
GuiAlert.cpp disable annoying debug messages 2008-02-22 10:30:46 +00:00
GuiApplication.cpp Introduce BufferException so that we don't crash if a problem affects only current Buffer. Instead we now just do an emergency save and we close it. 2008-02-29 08:10:51 +00:00
GuiApplication.h Transfer some GUI oriented code from core to frontend. 2008-02-06 23:02:57 +00:00
GuiBibitem.cpp Factorize closeEvent() for GuiDialog based dialogs. 2008-02-17 20:16:14 +00:00
GuiBibitem.h Factorize closeEvent() for GuiDialog based dialogs. 2008-02-17 20:16:14 +00:00
GuiBibtex.cpp header cleanup 2008-02-18 07:14:42 +00:00
GuiBibtex.h Factorize closeEvent() for GuiDialog based dialogs. 2008-02-17 20:16:14 +00:00
GuiBox.cpp header cleanup 2008-02-17 20:47:04 +00:00
GuiBox.h Factorize closeEvent() for GuiDialog based dialogs. 2008-02-17 20:16:14 +00:00
GuiBranch.cpp header cleanup 2008-02-17 20:47:04 +00:00
GuiBranch.h Factorize closeEvent() for GuiDialog based dialogs. 2008-02-17 20:16:14 +00:00
GuiBranches.cpp
GuiBranches.h
GuiChanges.cpp header cleanup 2008-02-17 20:47:04 +00:00
GuiChanges.h Factorize closeEvent() for GuiDialog based dialogs. 2008-02-17 20:16:14 +00:00
GuiCharacter.cpp header cleanup 2008-02-17 20:47:04 +00:00
GuiCharacter.h Factorize closeEvent() for GuiDialog based dialogs. 2008-02-17 20:16:14 +00:00
GuiCitation.cpp header cleanup 2008-02-18 07:14:42 +00:00
GuiCitation.h Support for nocite, provided by Bernhard Reiter. 2007-12-20 15:46:14 +00:00
GuiClipboard.cpp cosmetics 2008-02-27 22:23:12 +00:00
GuiClipboard.h * Support for graphics pasting (with most code in the frontend's GuiClipboard) 2008-02-03 10:43:03 +00:00
GuiCommandBuffer.cpp * completion infrastructure 2008-02-21 19:42:34 +00:00
GuiCommandBuffer.h
GuiCommandEdit.cpp
GuiCommandEdit.h
GuiCompleter.cpp * cosmetic 2008-03-04 09:43:42 +00:00
GuiCompleter.h * fix another crash due to the redraw opti-/minimization during 2008-03-04 09:43:32 +00:00
GuiDelimiter.cpp remove unused macro 2008-02-07 14:22:41 +00:00
GuiDelimiter.h Transfer some more dialog related code from core to frontend: 2007-11-23 09:44:02 +00:00
GuiDialog.cpp Bug fix bis: disconnect and clearParams for GuiDialog based dialog. 2008-03-02 15:19:03 +00:00
GuiDialog.h Factorize closeEvent() for GuiDialog based dialogs. 2008-02-17 20:16:14 +00:00
GuiDocument.cpp GuiDocument.cpp: add linebreaks to error messages 2008-03-02 12:36:30 +00:00
GuiDocument.h Fix bug 4594. 2008-03-01 22:08:16 +00:00
GuiErrorList.cpp more compile fixes 2008-02-18 09:55:14 +00:00
GuiErrorList.h Factorize closeEvent() for GuiDialog based dialogs. 2008-02-17 20:16:14 +00:00
GuiERT.cpp header cleanup 2008-02-17 20:47:04 +00:00
GuiERT.h Factorize closeEvent() for GuiDialog based dialogs. 2008-02-17 20:16:14 +00:00
GuiExternal.cpp header cleanup 2008-02-17 20:47:04 +00:00
GuiExternal.h Factorize closeEvent() for GuiDialog based dialogs. 2008-02-17 20:16:14 +00:00
GuiFloat.cpp header cleanup 2008-02-17 20:47:04 +00:00
GuiFloat.h Factorize closeEvent() for GuiDialog based dialogs. 2008-02-17 20:16:14 +00:00
GuiFontExample.cpp
GuiFontExample.h
GuiFontLoader.cpp header cleanup 2008-02-18 07:14:42 +00:00
GuiFontLoader.h fix memory leaks 2007-12-02 18:39:05 +00:00
GuiFontMetrics.cpp Hopefully fix monolithic build. 2008-03-02 10:20:13 +00:00
GuiFontMetrics.h
GuiGraphics.cpp ** subfig support ** 2008-03-02 11:30:50 +00:00
GuiGraphics.h Factorize closeEvent() for GuiDialog based dialogs. 2008-02-17 20:16:14 +00:00
GuiGraphicsUi.h
GuiHyperlink.cpp header cleanup 2008-02-17 20:47:04 +00:00
GuiHyperlink.h Factorize closeEvent() for GuiDialog based dialogs. 2008-02-17 20:16:14 +00:00
GuiIdListModel.cpp More work towards type safety regarding TextClass's. A couple bugs have been fixed here, too, discovered along the way. 2008-02-28 21:04:55 +00:00
GuiIdListModel.h More work towards type safety regarding TextClass's. A couple bugs have been fixed here, too, discovered along the way. 2008-02-28 21:04:55 +00:00
GuiImage.cpp getting rid of superfluous lyx::support:: statements. 2007-12-12 19:57:42 +00:00
GuiImage.h cosmetics 2007-11-23 22:15:17 +00:00
GuiInclude.cpp header cleanup 2008-02-17 20:47:04 +00:00
GuiInclude.h Factorize closeEvent() for GuiDialog based dialogs. 2008-02-17 20:16:14 +00:00
GuiKeySymbol.cpp 'using namespace std' instead of 'using std::xxx' 2007-12-12 10:16:00 +00:00
GuiKeySymbol.h
GuiLabel.cpp header cleanup 2008-02-18 07:14:42 +00:00
GuiLabel.h header cleanup 2008-02-17 20:47:04 +00:00
GuiListings.cpp header cleanup 2008-02-18 07:14:42 +00:00
GuiListings.h Factorize closeEvent() for GuiDialog based dialogs. 2008-02-17 20:16:14 +00:00
GuiLog.cpp header cleanup 2008-02-17 20:47:04 +00:00
GuiLog.h Factorize closeEvent() for GuiDialog based dialogs. 2008-02-17 20:16:14 +00:00
GuiMath.cpp header cleanup 2008-02-18 07:14:42 +00:00
GuiMath.h Factorize out the way window titles are handled. 2008-02-05 12:43:19 +00:00
GuiMathMatrix.cpp Factorize out the way window titles are handled. 2008-02-05 12:43:19 +00:00
GuiMathMatrix.h Transfer some more dialog related code from core to frontend: 2007-11-23 09:44:02 +00:00
GuiNomencl.cpp header cleanup 2008-02-18 07:14:42 +00:00
GuiNomencl.h Factorize closeEvent() for GuiDialog based dialogs. 2008-02-17 20:16:14 +00:00
GuiNote.cpp header cleanup 2008-02-17 20:47:04 +00:00
GuiNote.h Factorize closeEvent() for GuiDialog based dialogs. 2008-02-17 20:16:14 +00:00
GuiPainter.cpp Hopefully fix monolithic build. 2008-03-02 10:20:13 +00:00
GuiPainter.h merge frontend::Painter into GuiPainter 2007-11-23 21:39:51 +00:00
GuiParagraph.cpp header cleanup 2008-02-18 07:14:42 +00:00
GuiParagraph.h header cleanup 2008-02-18 07:14:42 +00:00
GuiPopupMenu.cpp header cleanup 2008-02-18 07:14:42 +00:00
GuiPopupMenu.h * MenuBackend.cpp (binding): remove forgui argument 2008-01-07 10:53:04 +00:00
GuiPrefs.cpp * "show popup without delay"-checkbox was missing a connect 2008-02-26 13:09:44 +00:00
GuiPrefs.h Factorize closeEvent() for GuiDialog based dialogs. 2008-02-17 20:16:14 +00:00
GuiPrint.cpp Factorize out the way window titles are handled. 2008-02-05 12:43:19 +00:00
GuiPrint.h Transfer some more dialog related code from core to frontend: 2007-11-23 09:44:02 +00:00
GuiRef.cpp Factorize closeEvent() for GuiDialog based dialogs. 2008-02-17 20:16:14 +00:00
GuiRef.h Transfer some more dialog related code from core to frontend: 2007-11-23 09:44:02 +00:00
GuiSearch.cpp header cleanup 2008-02-17 20:47:04 +00:00
GuiSearch.h Factorize closeEvent() for GuiDialog based dialogs. 2008-02-17 20:16:14 +00:00
GuiSelection.cpp header cleanup 2008-02-18 07:14:42 +00:00
GuiSelection.h
GuiSelectionManager.cpp remove duplicated code, (fix cmake merge) 2008-01-14 19:52:16 +00:00
GuiSelectionManager.h This commit changes the way individual LyXModule's are represented, both internally and in the .lyx files. The earlier version represented them by their `descriptive name', e.g., "Endnote" or "Theorems (AMS)", these being the same names used in the UI. This was a mistake, as becomes readily apparent when one starts to think about translating these strings. The modules ought to be represented by their filename, without the extension, just as TextClass's are. 2008-01-12 04:28:12 +00:00
GuiSendto.cpp header cleanup 2008-02-17 20:47:04 +00:00
GuiSendto.h Factorize closeEvent() for GuiDialog based dialogs. 2008-02-17 20:16:14 +00:00
GuiSetBorder.cpp
GuiSetBorder.h
GuiShowFile.cpp header cleanup 2008-02-17 20:47:04 +00:00
GuiShowFile.h Factorize closeEvent() for GuiDialog based dialogs. 2008-02-17 20:16:14 +00:00
GuiSpellchecker.cpp header cleanup 2008-02-18 07:14:42 +00:00
GuiSpellchecker.h Factorize closeEvent() for GuiDialog based dialogs. 2008-02-17 20:16:14 +00:00
GuiSymbols.cpp simplification. 2008-02-08 17:55:43 +00:00
GuiSymbols.h * GuiSymbols.{cpp,h}: 2008-02-08 16:43:02 +00:00
GuiTabular.cpp header cleanup 2008-02-17 20:47:04 +00:00
GuiTabular.h Factorize closeEvent() for GuiDialog based dialogs. 2008-02-17 20:16:14 +00:00
GuiTabularCreate.cpp header cleanup 2008-02-17 20:47:04 +00:00
GuiTabularCreate.h Transfer some more dialog related code from core to frontend: 2007-11-23 09:44:02 +00:00
GuiTexinfo.cpp header cleanup 2008-02-18 07:14:42 +00:00
GuiTexinfo.h Factorize closeEvent() for GuiDialog based dialogs. 2008-02-17 20:16:14 +00:00
GuiThesaurus.cpp header cleanup 2008-02-17 20:47:04 +00:00
GuiThesaurus.h Factorize closeEvent() for GuiDialog based dialogs. 2008-02-17 20:16:14 +00:00
GuiToc.cpp set parent 2008-02-28 16:14:26 +00:00
GuiToc.h simplify GuiToc / TocWidget interaction. Much can still be simplified... 2008-02-12 07:47:16 +00:00
GuiToolbar.cpp * sorting depends on translated string, i.e. column 0 of the layout model 2008-03-04 09:54:53 +00:00
GuiToolbar.h * cosmetic 2008-03-04 09:46:49 +00:00
GuiToolbars.cpp Fullscreen fixes (multiple windows & toolbar visibility). 2008-02-28 11:19:19 +00:00
GuiToolbars.h Remove TextClassPtr without losing the type safety it provided. 2008-02-28 01:42:02 +00:00
GuiView.cpp GuiView: Avoid unnecessary GUI updates if it was the current view already. 2008-03-04 10:43:35 +00:00
GuiView.h * bug fix to only do paragraph redraws, not fullscreen 2008-02-29 09:18:46 +00:00
GuiViewSource.cpp Factorize out the way window titles are handled. 2008-02-05 12:43:19 +00:00
GuiViewSource.h use structure with named members instead of pair<int, int>... 2007-11-29 22:12:19 +00:00
GuiVSpace.cpp header cleanup 2008-02-17 20:47:04 +00:00
GuiVSpace.h Factorize closeEvent() for GuiDialog based dialogs. 2008-02-17 20:16:14 +00:00
GuiWorkArea.cpp * GuiWorkArea::focusInEvent(): avoid unnecessary full redraw if the work area was already current. 2008-03-03 11:04:17 +00:00
GuiWorkArea.h * completion cursor 2008-02-28 12:41:43 +00:00
GuiWrap.cpp fileformat incremented to 317: 2008-03-02 17:12:22 +00:00
GuiWrap.h Factorize closeEvent() for GuiDialog based dialogs. 2008-02-17 20:16:14 +00:00
IconPalette.cpp don't update parent and make sure the icon sizes on the palette are correct 2008-01-16 20:51:00 +00:00
IconPalette.h don't update parent and make sure the icon sizes on the palette are correct 2008-01-16 20:51:00 +00:00
InsertTableWidget.cpp Please JMarc: Make sure we always pass through LyXFunc::dispatch() even if this is a waste of CPU. 2007-11-26 22:45:17 +00:00
InsertTableWidget.h Transfer some more dialog related code from core to frontend: 2007-11-23 09:44:02 +00:00
LaTeXHighlighter.cpp Use a less verbose form for warnings in the view source window 2007-12-30 21:28:38 +00:00
LaTeXHighlighter.h * src/Buffer.cpp: 2007-12-24 13:55:01 +00:00
LengthCombo.cpp
LengthCombo.h
LyXFileDialog.cpp * src/frontends/qt4/LyXFileDialog.cpp: 2008-02-10 11:50:10 +00:00
LyXFileDialog.h Transfer FileDialog.h to qt4/ 2008-02-07 00:05:18 +00:00
Makefile.am * completion infrastructure 2008-02-21 19:42:34 +00:00
Menus.cpp Fix mac menubar only modifying the Prefs. 2008-01-16 16:50:10 +00:00
Menus.h * compile fix 2007-12-26 13:29:45 +00:00
PanelStack.cpp 'using namespace std' instead of 'using std::xxx' 2007-12-12 10:16:00 +00:00
PanelStack.h
pch.h
qlkey.h
qt_helpers.cpp header cleanup 2008-02-18 07:14:42 +00:00
qt_helpers.h
README
TocModel.cpp Patch to please gcc 4.3. Less bloat in the include headers means that 2008-02-07 17:04:06 +00:00
TocModel.h
TocWidget.cpp ToC tree redrawing after resets. 2008-03-04 12:39:03 +00:00
TocWidget.h ToC tree redrawing after resets. 2008-03-04 12:39:03 +00:00
Validator.cpp 'using namespace std' instead of 'using std::xxx' 2007-12-12 10:16:00 +00:00
Validator.h

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.