lyx_mirror/src/frontends/qt4
Richard Heck e158e07c29 InsetCommandParams() now takes an InsetCode rather than a string.
These changes are just adaptations to the new signature.


git-svn-id: svn://svn.lyx.org/lyx/lyx-devel/trunk@21072 a592a061-630c-0410-9148-cb99ea01b6c8
2007-10-19 17:22:55 +00:00
..
ui PrefShortcuts: add a simple shortcut dialog (does nothing now), adjust prefShortcuts panel 2007-10-18 16:47:31 +00:00
Action.cpp mainly reduce include dependencies 2007-10-15 22:43:55 +00:00
Action.h mainly reduce include dependencies 2007-10-15 22:43:55 +00:00
alert_pimpl.cpp
BulletsModule.cpp use "real" resources 2007-10-17 18:28:45 +00:00
BulletsModule.h
ButtonController.cpp
ButtonController.h
ColorCache.cpp
ColorCache.h
Dialogs.cpp The huge URL patch: 2007-10-13 19:06:09 +00:00
DialogView.h cosmetics 2007-10-09 22:13:51 +00:00
DockView.h finally merge Dialog and Controller 2007-10-09 21:21:01 +00:00
EmptyTable.cpp
EmptyTable.h
FileDialog.cpp
FloatPlacement.cpp
FloatPlacement.h
GuiAbout.cpp move Controller inheritance further up the tree 2007-10-09 19:34:27 +00:00
GuiAbout.h move Controller inheritance further up the tree 2007-10-09 19:34:27 +00:00
GuiApplication.cpp
GuiApplication.h
GuiBibitem.cpp some refactoring 2007-10-07 14:44:41 +00:00
GuiBibitem.h move stuff around. probably not the final destination... 2007-10-07 21:14:24 +00:00
GuiBibtex.cpp one more 2007-10-07 18:40:01 +00:00
GuiBibtex.h one more 2007-10-07 18:40:01 +00:00
GuiBox.cpp move Controller inheritance further up the tree 2007-10-09 19:34:27 +00:00
GuiBox.h move Controller inheritance further up the tree 2007-10-09 19:34:27 +00:00
GuiBranch.cpp move Controller inheritance further up the tree 2007-10-09 19:34:27 +00:00
GuiBranch.h move Controller inheritance further up the tree 2007-10-09 19:34:27 +00:00
GuiBranches.cpp next one 2007-10-06 22:43:21 +00:00
GuiBranches.h
GuiChanges.cpp move Controller inheritance further up the tree 2007-10-09 19:34:27 +00:00
GuiChanges.h move Controller inheritance further up the tree 2007-10-09 19:34:27 +00:00
GuiCharacter.cpp finally merge Dialog and Controller 2007-10-09 21:21:01 +00:00
GuiCharacter.h finally merge Dialog and Controller 2007-10-09 21:21:01 +00:00
GuiCitation.cpp some refactoring 2007-10-07 14:59:01 +00:00
GuiCitation.h one more 2007-10-07 18:40:01 +00:00
GuiClipboard.cpp
GuiClipboard.h
GuiCommandBuffer.cpp use "real" resources 2007-10-17 18:28:45 +00:00
GuiCommandBuffer.h one more 2007-10-07 18:40:01 +00:00
GuiCommandEdit.cpp
GuiCommandEdit.h
GuiDelimiter.cpp move Controller inheritance further up the tree 2007-10-09 19:34:27 +00:00
GuiDelimiter.h math stuff 2007-10-07 20:34:09 +00:00
GuiDialog.cpp InsetCommandParams() now takes an InsetCode rather than a string. 2007-10-19 17:22:55 +00:00
GuiDialog.h finally merge Dialog and Controller 2007-10-09 21:21:01 +00:00
GuiDocument.cpp * BufferView::update(): renamed to processUpdateFlags() to clarify the intent. Also get rid of the default argument which added to the confusion as to what was the purpose of update(). Now also emit Buffer::changed() signal internally instead of assuming that the caller will act upon the returned boolean. 2007-10-10 08:52:55 +00:00
GuiDocument.h move Controller inheritance further up the tree 2007-10-09 19:34:27 +00:00
GuiEmbeddedFiles.cpp use "real" resources 2007-10-17 18:28:45 +00:00
GuiEmbeddedFiles.h set eol-style. 2007-10-09 06:38:07 +00:00
GuiErrorList.cpp fix bug reported by Jean-Marc 2007-10-10 16:57:05 +00:00
GuiErrorList.h move Controller inheritance further up the tree 2007-10-09 19:34:27 +00:00
GuiERT.cpp move Controller inheritance further up the tree 2007-10-09 19:34:27 +00:00
GuiERT.h move Controller inheritance further up the tree 2007-10-09 19:34:27 +00:00
GuiExternal.cpp finally merge Dialog and Controller 2007-10-09 21:21:01 +00:00
GuiExternal.h move Controller inheritance further up the tree 2007-10-09 19:34:27 +00:00
GuiFloat.cpp move Controller inheritance further up the tree 2007-10-09 19:34:27 +00:00
GuiFloat.h move Controller inheritance further up the tree 2007-10-09 19:34:27 +00:00
GuiFontExample.cpp
GuiFontExample.h
GuiFontLoader.cpp
GuiFontLoader.h
GuiFontMetrics.cpp Add a FIXME and a hint for implementation of surrogate pair metric problem. 2007-10-08 08:55:21 +00:00
GuiFontMetrics.h
GuiGraphics.cpp isome more FileName shuffling 2007-10-18 23:03:51 +00:00
GuiGraphics.h move Controller inheritance further up the tree 2007-10-09 19:34:27 +00:00
GuiGraphicsUi.h
GuiHyperlink.cpp The huge URL patch: 2007-10-13 19:06:09 +00:00
GuiHyperlink.h The huge URL patch: 2007-10-13 19:06:09 +00:00
GuiImage.cpp cosmetics 2007-10-17 18:47:47 +00:00
GuiImage.h
GuiImplementation.cpp
GuiImplementation.h
GuiInclude.cpp InsetCommandParams() now takes an InsetCode rather than a string. 2007-10-19 17:22:55 +00:00
GuiInclude.h move Controller inheritance further up the tree 2007-10-09 19:34:27 +00:00
GuiIndex.cpp some refactoring 2007-10-07 14:59:01 +00:00
GuiIndex.h some refactoring 2007-10-07 14:59:01 +00:00
GuiKeySymbol.cpp
GuiKeySymbol.h
GuiListings.cpp Add Erlang support for listings (bug 4263) 2007-10-13 20:56:28 +00:00
GuiListings.h move Controller inheritance further up the tree 2007-10-09 19:34:27 +00:00
GuiLog.cpp add missing include 2007-10-11 19:35:49 +00:00
GuiLog.h add "copy to clipboard" button to log dialog 2007-10-11 18:15:30 +00:00
GuiMath.cpp move Controller inheritance further up the tree 2007-10-09 19:34:27 +00:00
GuiMath.h move Controller inheritance further up the tree 2007-10-09 19:34:27 +00:00
GuiMathMatrix.cpp move Controller inheritance further up the tree 2007-10-09 19:34:27 +00:00
GuiMathMatrix.h math stuff 2007-10-07 20:34:09 +00:00
GuiMenubar.cpp
GuiMenubar.h
GuiNomencl.cpp next ones 2007-10-07 14:41:49 +00:00
GuiNomencl.h next ones 2007-10-07 14:41:49 +00:00
GuiNote.cpp move Controller inheritance further up the tree 2007-10-09 19:34:27 +00:00
GuiNote.h move Controller inheritance further up the tree 2007-10-09 19:34:27 +00:00
GuiPainter.cpp
GuiPainter.h
GuiParagraph.cpp finally merge Dialog and Controller 2007-10-09 21:21:01 +00:00
GuiParagraph.h finally merge Dialog and Controller 2007-10-09 21:21:01 +00:00
GuiPopupMenu.cpp mainly reduce include dependencies 2007-10-15 22:43:55 +00:00
GuiPopupMenu.h
GuiPrefs.cpp PrefShortcuts: Hide unmatched items instead of highlighting matched ones (JMarc's suggestion ) 2007-10-19 16:49:04 +00:00
GuiPrefs.h PrefShortcuts: the buttons are almost usable now 2007-10-19 03:09:14 +00:00
GuiPrint.cpp finally merge Dialog and Controller 2007-10-09 21:21:01 +00:00
GuiPrint.h move Controller inheritance further up the tree 2007-10-09 19:34:27 +00:00
GuiRef.cpp InsetCommandParams() now takes an InsetCode rather than a string. 2007-10-19 17:22:55 +00:00
GuiRef.h move Controller inheritance further up the tree 2007-10-09 19:34:27 +00:00
GuiSearch.cpp finally merge Dialog and Controller 2007-10-09 21:21:01 +00:00
GuiSearch.h move Controller inheritance further up the tree 2007-10-09 19:34:27 +00:00
GuiSelection.cpp
GuiSelection.h
GuiSelectionManager.cpp
GuiSelectionManager.h
GuiSendto.cpp move Controller inheritance further up the tree 2007-10-09 19:34:27 +00:00
GuiSendto.h move Controller inheritance further up the tree 2007-10-09 19:34:27 +00:00
GuiSetBorder.cpp
GuiSetBorder.h
GuiShowFile.cpp move Controller inheritance further up the tree 2007-10-09 19:34:27 +00:00
GuiShowFile.h move Controller inheritance further up the tree 2007-10-09 19:34:27 +00:00
GuiSpellchecker.cpp * BufferView::update(): renamed to processUpdateFlags() to clarify the intent. Also get rid of the default argument which added to the confusion as to what was the purpose of update(). Now also emit Buffer::changed() signal internally instead of assuming that the caller will act upon the returned boolean. 2007-10-10 08:52:55 +00:00
GuiSpellchecker.h move Controller inheritance further up the tree 2007-10-09 19:34:27 +00:00
GuiTabular.cpp Move Inset::Code to InsetCode.h 2007-10-13 09:04:52 +00:00
GuiTabular.h move Controller inheritance further up the tree 2007-10-09 19:34:27 +00:00
GuiTabularCreate.cpp move Controller inheritance further up the tree 2007-10-09 19:34:27 +00:00
GuiTabularCreate.h move Controller inheritance further up the tree 2007-10-09 19:34:27 +00:00
GuiTexinfo.cpp move Controller inheritance further up the tree 2007-10-09 19:34:27 +00:00
GuiTexinfo.h move Controller inheritance further up the tree 2007-10-09 19:34:27 +00:00
GuiThesaurus.cpp move Controller inheritance further up the tree 2007-10-09 19:34:27 +00:00
GuiThesaurus.h move Controller inheritance further up the tree 2007-10-09 19:34:27 +00:00
GuiToc.cpp InsetCommandParams() now takes an InsetCode rather than a string. 2007-10-19 17:22:55 +00:00
GuiToc.h Fix memory leak. 2007-10-09 09:29:27 +00:00
GuiToolbar.cpp Compile fix 2007-10-19 15:16:40 +00:00
GuiToolbar.h mainly reduce include dependencies 2007-10-15 22:43:55 +00:00
GuiToolbars.cpp mainly reduce include dependencies 2007-10-15 22:43:55 +00:00
GuiToolbars.h mainly reduce include dependencies 2007-10-15 22:43:55 +00:00
GuiView.cpp compil fix. 2007-10-18 09:24:16 +00:00
GuiView.h Move TabWidget related code to TabWorkArea class in GuiWorkArea.{cpp,h} 2007-10-06 15:48:58 +00:00
GuiViewSource.cpp * GuiViewSource: port back to DockView. 2007-10-09 09:43:56 +00:00
GuiViewSource.h * GuiViewSource: port back to DockView. 2007-10-09 09:43:56 +00:00
GuiVSpace.cpp finally merge Dialog and Controller 2007-10-09 21:21:01 +00:00
GuiVSpace.h move Controller inheritance further up the tree 2007-10-09 19:34:27 +00:00
GuiWorkArea.cpp compil fix. 2007-10-18 09:24:16 +00:00
GuiWorkArea.h Reduce use of dynamic_cast. 2007-10-16 06:50:09 +00:00
GuiWrap.cpp move Controller inheritance further up the tree 2007-10-09 19:34:27 +00:00
GuiWrap.h move Controller inheritance further up the tree 2007-10-09 19:34:27 +00:00
IconPalette.cpp
IconPalette.h
InsertTableWidget.cpp
InsertTableWidget.h
LaTeXHighlighter.cpp set eol-style. 2007-10-09 06:39:53 +00:00
LaTeXHighlighter.h move LaTeXHighlighte 2007-10-06 19:03:41 +00:00
LengthCombo.cpp
LengthCombo.h
LyXFileDialog.cpp
LyXFileDialog.h
Makefile.am PrefShortcuts: add a simple shortcut dialog (does nothing now), adjust prefShortcuts panel 2007-10-18 16:47:31 +00:00
PanelStack.cpp
PanelStack.h
pch.h
qlkey.h
qt_helpers.cpp
qt_helpers.h
README
TocModel.cpp
TocModel.h
TocWidget.cpp use "real" resources 2007-10-17 18:28:45 +00:00
TocWidget.h next one 2007-10-06 20:54:31 +00:00
Validator.cpp one more 2007-10-07 08:55:20 +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.