lyx_mirror/src/frontends/qt4
Abdelrazak Younes f7f385f73b More code removal.
git-svn-id: svn://svn.lyx.org/lyx/lyx-devel/trunk@25063 a592a061-630c-0410-9148-cb99ea01b6c8
2008-06-02 09:26:27 +00:00
..
ui one string more. 2008-05-29 11:54:29 +00:00
Action.cpp * remove the need of an active GuiView 2008-03-14 16:33:16 +00:00
Action.h * remove the need of an active GuiView 2008-03-14 16:33:16 +00:00
BulletsModule.cpp
BulletsModule.h
ButtonController.cpp pimpl ButtonController 2008-04-19 09:12:34 +00:00
ButtonController.h pimpl ButtonController 2008-04-19 09:12:34 +00:00
ButtonPolicy.cpp pimply buttonpolicy data 2008-04-19 08:42:56 +00:00
ButtonPolicy.h pimply buttonpolicy data 2008-04-19 08:42:56 +00:00
ColorCache.cpp fix my color cache "improvements" 2008-05-31 22:39:52 +00:00
ColorCache.h fix my color cache "improvements" 2008-05-31 22:39:52 +00:00
CustomizedWidgets.cpp more compile fixes 2008-02-18 09:55:14 +00:00
CustomizedWidgets.h
Dialog.cpp header. 2008-05-07 14:45:49 +00:00
Dialog.h * Delegates.h: clarify some comments. 2008-05-02 21:38:23 +00:00
DialogView.h do what the FIXME suggested 2008-03-05 20:11:47 +00:00
DockView.h do what the FIXME suggested 2008-03-05 20:11:47 +00:00
EmptyTable.cpp
EmptyTable.h
FileDialog.cpp compile fix 2008-04-21 06:30:46 +00:00
FileDialog.h move the filefilter stuff closer to the only place where it is used 2008-04-20 19:56:01 +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 * Some work was done in 2007 and 2008 which should deserve a copyright, no? 2008-03-14 23:32:34 +00:00
GuiAbout.h
GuiAlert.cpp disable annoying debug messages 2008-02-22 10:30:46 +00:00
GuiApplication.cpp next try 2008-05-29 17:57:57 +00:00
GuiApplication.h a bunch of toolbar related renaming. 2008-05-25 08:30:06 +00:00
GuiBibitem.cpp move GuiCommand into hedar of its own. InsetCommandParams.h is expensive 2008-04-20 08:19:26 +00:00
GuiBibitem.h move GuiCommand into hedar of its own. InsetCommandParams.h is expensive 2008-04-20 08:19:26 +00:00
GuiBibtex.cpp * GuiBibtex.cpp: 2008-04-28 12:57:41 +00:00
GuiBibtex.h merge GuiCommand into its users. 2008-04-20 09:24:14 +00:00
GuiBox.cpp remove stupid windows defines 2008-05-24 21:58:56 +00:00
GuiBox.h remove InsetBoxMailer. 2008-03-27 07:26:37 +00:00
GuiBranch.cpp remove remaining MailInsets. 2008-03-27 22:26:24 +00:00
GuiBranch.h Factorize closeEvent() for GuiDialog based dialogs. 2008-02-17 20:16:14 +00:00
GuiBranches.cpp Cosmetics. 2008-05-27 19:00:42 +00:00
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 fix http://bugzilla.lyx.org/show_bug.cgi?id=4870 2008-05-22 15:20:43 +00:00
GuiCharacter.h remove stupid windows defines 2008-05-24 21:58:56 +00:00
GuiCitation.cpp Add session to citation dialog. 2008-05-14 14:37:33 +00:00
GuiCitation.h Add session to citation dialog. 2008-05-14 14:37:33 +00:00
GuiClipboard.cpp cleanup export of mime type strings 2008-05-25 07:49:16 +00:00
GuiClipboard.h cleanup export of mime type strings 2008-05-25 07:49:16 +00:00
GuiCommandBuffer.cpp * completion infrastructure 2008-02-21 19:42:34 +00:00
GuiCommandBuffer.h
GuiCommandEdit.cpp
GuiCommandEdit.h
GuiCompleter.cpp from_utf8(fromqstr -> qstring_to_ucs4 . 2008-05-05 17:04:02 +00:00
GuiCompleter.h * even setModel can trigger focus events. So move also those into 2008-03-04 12:44:48 +00:00
GuiDelimiter.cpp More code removal. 2008-06-02 09:26:27 +00:00
GuiDelimiter.h
GuiDialog.cpp bug 4652: better fix. 2008-05-15 08:06:32 +00:00
GuiDialog.h move GuiCommand into hedar of its own. InsetCommandParams.h is expensive 2008-04-20 08:19:26 +00:00
GuiDocument.cpp rework a bit the document dialog so that it works more or less fine without any open document. 2008-05-15 08:41:17 +00:00
GuiDocument.h rework a bit the document dialog so that it works more or less fine without any open document. 2008-05-15 08:41:17 +00:00
GuiErrorList.cpp * GuiErrorList.{cpp,h}: 2008-05-29 12:37:22 +00:00
GuiErrorList.h * GuiErrorList.{cpp,h}: 2008-05-29 12:37:22 +00:00
GuiERT.cpp this feels more natural... 2008-03-27 23:37:59 +00:00
GuiERT.h Factorize closeEvent() for GuiDialog based dialogs. 2008-02-17 20:16:14 +00:00
GuiExternal.cpp Improvements to the External dialog. 2008-04-28 06:19:25 +00:00
GuiExternal.h basic context menu for InsetExternal. 2008-04-28 05:12:28 +00:00
GuiFloat.cpp remove remaining MailInsets. 2008-03-27 22:26:24 +00:00
GuiFloat.h Factorize closeEvent() for GuiDialog based dialogs. 2008-02-17 20:16:14 +00:00
GuiFontExample.cpp
GuiFontExample.h
GuiFontLoader.cpp cosmetics 2008-05-02 22:07:51 +00:00
GuiFontLoader.h Pimpl stuff in GuiApplication. 2008-05-23 08:43:07 +00:00
GuiFontMetrics.cpp rename assert.h to lassert.h 2008-04-30 08:26:40 +00:00
GuiFontMetrics.h
GuiGraphics.cpp Fix button enabling for graphics input. 2008-05-26 17:56:48 +00:00
GuiGraphics.h Fix 4603 for GuiGraphics. I guess most GuiDialog based dialog need fixing... 2008-05-06 15:18:50 +00:00
GuiGraphicsUi.h
GuiHSpace.cpp support for rightarrowfill, leftarrowfill, upbracefill, downbracefill, by Helge Hafting. 2008-04-30 20:11:57 +00:00
GuiHSpace.h ** add support for protected horizontal fill. FILE FORMAT CHANGE. ** 2008-03-18 12:11:28 +00:00
GuiHyperlink.cpp cosmetics 2008-04-20 21:05:35 +00:00
GuiHyperlink.h merge GuiCommand into its users. 2008-04-20 09:24:14 +00:00
GuiIdListModel.cpp rename assert.h to lassert.h 2008-04-30 08:26:40 +00:00
GuiIdListModel.h Fix a bug noticed by Stefan: that the module UI was broken. The problem was introduced at r23981. The data() and setData() methods must be kept in sync. 2008-04-17 02:43:57 +00:00
GuiImage.cpp cosmetics 2008-04-20 21:05:35 +00:00
GuiImage.h
GuiInclude.cpp * implement "inset-edit" in InsetInclude. 2008-04-27 18:03:21 +00:00
GuiInclude.h * implement "inset-edit" in InsetInclude. 2008-04-27 18:03:21 +00:00
GuiKeySymbol.cpp rename assert.h to lassert.h 2008-04-30 08:26:40 +00:00
GuiKeySymbol.h
GuiLabel.cpp merge GuiCommand into its users. 2008-04-20 09:24:14 +00:00
GuiLabel.h merge GuiCommand into its users. 2008-04-20 09:24:14 +00:00
GuiListings.cpp remove remaining MailInsets. 2008-03-27 22:26:24 +00:00
GuiListings.h Factorize closeEvent() for GuiDialog based dialogs. 2008-02-17 20:16:14 +00:00
GuiLog.cpp Introduce docstring_list 2008-05-24 10:15:52 +00:00
GuiLog.h Factorize closeEvent() for GuiDialog based dialogs. 2008-02-17 20:16:14 +00:00
GuiMath.cpp More code removal. 2008-06-02 09:26:27 +00:00
GuiMath.h More code removal. 2008-06-02 09:26:27 +00:00
GuiMathMatrix.cpp More code removal. 2008-06-02 09:26:27 +00:00
GuiMathMatrix.h
GuiNomencl.cpp merge GuiCommand into its users. 2008-04-20 09:24:14 +00:00
GuiNomencl.h merge GuiCommand into its users. 2008-04-20 09:24:14 +00:00
GuiNote.cpp remove remaining MailInsets. 2008-03-27 22:26:24 +00:00
GuiNote.h Factorize closeEvent() for GuiDialog based dialogs. 2008-02-17 20:16:14 +00:00
GuiPainter.cpp Pimpl stuff in GuiApplication. 2008-05-23 08:43:07 +00:00
GuiPainter.h
GuiParagraph.cpp Add session to paragraph dialog. 2008-05-14 14:08:58 +00:00
GuiParagraph.h Add session to paragraph dialog. 2008-05-14 14:08:58 +00:00
GuiPrefs.cpp * GuiPrefs.cpp: 2008-05-25 09:42:41 +00:00
GuiPrefs.h cosmetics 2008-05-19 20:52:24 +00:00
GuiPrint.cpp compile fix 2008-04-21 06:53:00 +00:00
GuiPrint.h s/kb_action/FuncCode/g 2008-03-15 01:20:36 +00:00
GuiRef.cpp compile fix 2008-04-21 06:53:00 +00:00
GuiRef.h merge GuiCommand into its users. 2008-04-20 09:24:14 +00:00
GuiSearch.cpp Fix bug http://bugzilla.lyx.org/show_bug.cgi?id=4194 . 2008-03-12 16:17:25 +00:00
GuiSearch.h Factorize closeEvent() for GuiDialog based dialogs. 2008-02-17 20:16:14 +00:00
GuiSelection.cpp cosmetics 2008-04-20 21:05:35 +00:00
GuiSelection.h
GuiSelectionManager.cpp Some comments. 2008-04-24 18:19:40 +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 * src/frontends/qt4/GuiSendto.cpp: 2008-05-19 10:12:27 +00:00
GuiSendto.h use cheaper includes in ui files 2008-04-20 16:32:40 +00:00
GuiSetBorder.cpp
GuiSetBorder.h
GuiShowFile.cpp a few more docstring<->QString conversions 2008-03-05 23:10:53 +00:00
GuiShowFile.h Factorize closeEvent() for GuiDialog based dialogs. 2008-02-17 20:16:14 +00:00
GuiSpellchecker.cpp * getSpeller create a new speller, so call it create* 2008-03-16 17:06:26 +00:00
GuiSpellchecker.h Factorize closeEvent() for GuiDialog based dialogs. 2008-02-17 20:16:14 +00:00
GuiSymbols.cpp Pimpl stuff in GuiApplication. 2008-05-23 08:43:07 +00:00
GuiSymbols.h use cheaper includes in ui files 2008-04-20 16:32:40 +00:00
GuiTabular.cpp fix: http://bugzilla.lyx.org/show_bug.cgi?id=4688 2008-05-04 07:51:50 +00:00
GuiTabular.h fix: http://bugzilla.lyx.org/show_bug.cgi?id=4688 2008-05-04 07:51:50 +00:00
GuiTabularCreate.cpp header cleanup 2008-02-17 20:47:04 +00:00
GuiTabularCreate.h s/kb_action/FuncCode/g 2008-03-15 01:20:36 +00:00
GuiTexinfo.cpp ...and clean up headers 2008-03-08 21:55:03 +00:00
GuiTexinfo.h less string conversions as long as we stay in the frontend 2008-03-08 07:59:47 +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 the focus on the work area after clicking on a navigator item. 2008-05-30 11:33:24 +00:00
GuiToc.h Cleanup Toc dialog and GuiView interaction. The toc models are now part of GuiView. The TocWidget is just a view of this model. 2008-05-02 12:09:51 +00:00
GuiToolbar.cpp GuiToolbar::fill(): only once. 2008-05-28 10:30:25 +00:00
GuiToolbar.h GuiToolbar::fill(): only once. 2008-05-28 10:30:25 +00:00
GuiView.cpp FuncStatus::enabled(bool) --> FuncStatus::setEnabled(bool) 2008-05-29 15:14:00 +00:00
GuiView.h Temptatively fix fullscreen problems on X11. 2008-05-27 13:16:50 +00:00
GuiViewSource.cpp Fix manual update of the viewsource dialog, set default states of the view source checkboxes 2008-06-01 20:03:36 +00:00
GuiViewSource.h next try 2008-05-29 17:57:57 +00:00
GuiVSpace.cpp remove InsetVSpaceMailer class 2008-03-27 00:21:35 +00:00
GuiVSpace.h Factorize closeEvent() for GuiDialog based dialogs. 2008-02-17 20:16:14 +00:00
GuiWorkArea.cpp Pimpl stuff in GuiApplication. 2008-05-23 08:43:07 +00:00
GuiWorkArea.h * Some more clever elide mode for the LyX buffer tabs. In trunk 2008-04-29 15:44:07 +00:00
GuiWrap.cpp Fix http://bugzilla.lyx.org/show_bug.cgi?id=4603 2008-05-06 14:53:54 +00:00
GuiWrap.h Fix http://bugzilla.lyx.org/show_bug.cgi?id=4603 2008-05-06 14:53:54 +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
InsertTableWidget.h
LaTeXHighlighter.cpp Use a less verbose form for warnings in the view source window 2007-12-30 21:28:38 +00:00
LaTeXHighlighter.h
LengthCombo.cpp
LengthCombo.h
LyXFileDialog.cpp move the filefilter stuff closer to the only place where it is used 2008-04-20 19:56:01 +00:00
LyXFileDialog.h move the filefilter stuff closer to the only place where it is used 2008-04-20 19:56:01 +00:00
Makefile.am Re-engineer the toolbar support code: 2008-05-27 11:15:17 +00:00
Menus.cpp FuncStatus::enabled(bool) --> FuncStatus::setEnabled(bool) 2008-05-29 15:14:00 +00:00
Menus.h Introduce docstring_list 2008-05-24 10:15:52 +00:00
PanelStack.cpp cosmetics 2008-05-02 22:07:51 +00:00
PanelStack.h * src/frontends/qt4/PanelStack.{cpp, h}: 2008-03-19 18:15:16 +00:00
pch.h
qt_helpers.cpp Add list of branches. 2008-05-30 13:59:29 +00:00
qt_helpers.h Factorize out some code between TocModel.cpp and Menus.cpp. 2008-05-16 13:49:49 +00:00
qt_i18n.h move the filefilter stuff closer to the only place where it is used 2008-04-20 19:56:01 +00:00
README
TocModel.cpp Factorize out some code between TocModel.cpp and Menus.cpp. 2008-05-16 13:49:49 +00:00
TocModel.h Factorize out some code between TocModel.cpp and Menus.cpp. 2008-05-16 13:49:49 +00:00
TocWidget.cpp forgot that one. 2008-05-30 12:23:15 +00:00
TocWidget.h Code simplification. 2008-05-30 11:59:57 +00:00
Toolbars.cpp Re-engineer the toolbar support code: 2008-05-27 11:15:17 +00:00
Toolbars.h Compil fix. 2008-05-27 11:47:50 +00:00
Validator.cpp
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.