lyx_mirror/src/frontends/qt4
Vincent van Ravesteijn 2afc45c538 Make the GuiCharacter dialog use the new ButtonPolicy.
git-svn-id: svn://svn.lyx.org/lyx/lyx-devel/trunk@28239 a592a061-630c-0410-9148-cb99ea01b6c8
2009-01-18 14:41:12 +00:00
..
ui * InsetGraphics.{cpp.h}: 2009-01-17 08:02:52 +00:00
Action.cpp thrid attempt at changing the naming pattern of the intermediated 'mocced' files 2008-11-14 14:28:50 +00:00
Action.h
BulletsModule.cpp thrid attempt at changing the naming pattern of the intermediated 'mocced' files 2008-11-14 14:28:50 +00:00
BulletsModule.h cosmetics; 2008-09-20 11:47:38 +00:00
ButtonController.cpp New ButtonPolicy for dialogs with an auto-apply option. 2009-01-18 14:33:51 +00:00
ButtonController.h New ButtonPolicy for dialogs with an auto-apply option. 2009-01-18 14:33:51 +00:00
ButtonPolicy.cpp New ButtonPolicy for dialogs with an auto-apply option. 2009-01-18 14:33:51 +00:00
ButtonPolicy.h Whitespace. 2009-01-18 14:37:14 +00:00
ColorCache.cpp
ColorCache.h
CustomizedWidgets.cpp more latin1..utf8 schanges. all of src/* should be utf8 now 2008-11-14 15:58:50 +00:00
CustomizedWidgets.h more latin1..utf8 schanges. all of src/* should be utf8 now 2008-11-14 15:58:50 +00:00
Dialog.cpp Dialogs: discourage non const access to buffer() and bufferview(). 2008-09-29 10:52:17 +00:00
Dialog.h Dialogs: discourage non const access to lyxview(). 2008-09-29 11:01:53 +00:00
DialogView.h Fix citation bug: In certain circumstances, attempts to insert a new citation 2008-08-13 14:32:30 +00:00
DockView.h Don't show the dock widget at construction time. This should fix bug http://bugzilla.lyx.org/show_bug.cgi?id=5273 2008-10-03 13:45:56 +00:00
EmptyTable.cpp thrid attempt at changing the naming pattern of the intermediated 'mocced' files 2008-11-14 14:28:50 +00:00
EmptyTable.h
FileDialog.cpp Remove traces of Q_CYGWIN_WIN 2008-10-15 23:00:42 +00:00
FileDialog.h
FindAndReplace.cpp FindAdvSearch. Next patch from Tommaso. 2009-01-14 15:34:56 +00:00
FindAndReplace.h FindAdvSearch. Next patch from Tommaso. 2009-01-14 15:34:56 +00:00
FloatPlacement.cpp thrid attempt at changing the naming pattern of the intermediated 'mocced' files 2008-11-14 14:28:50 +00:00
FloatPlacement.h cosmetics. remoe strange dependency of GuiDocument.h 2008-09-20 13:44:51 +00:00
GuiAbout.cpp Uncrustify string for translators 2009-01-17 13:30:41 +00:00
GuiAbout.h
GuiAlert.cpp thrid attempt at changing the naming pattern of the intermediated 'mocced' files 2008-11-14 14:28:50 +00:00
GuiApplication.cpp Improved debug message for locating toolbar icons. Patch from Dieter Jurzitza. 2009-01-05 19:05:46 +00:00
GuiApplication.h remove spellchecker command and flag telling us whether to use a process or a 2008-11-16 12:22:54 +00:00
GuiBibitem.cpp thrid attempt at changing the naming pattern of the intermediated 'mocced' files 2008-11-14 14:28:50 +00:00
GuiBibitem.h
GuiBibtex.cpp Add button to rescan the list of bib/bst files from within the dialogs. 2008-12-02 08:46:59 +00:00
GuiBibtex.h Add button to rescan the list of bib/bst files from within the dialogs. 2008-12-02 08:46:59 +00:00
GuiBox.cpp * GuiBox.cpp: 2009-01-14 14:10:52 +00:00
GuiBox.h more latin1..utf8 schanges. all of src/* should be utf8 now 2008-11-14 15:58:50 +00:00
GuiBranch.cpp more latin1..utf8 schanges. all of src/* should be utf8 now 2008-11-14 15:58:50 +00:00
GuiBranch.h more latin1..utf8 schanges. all of src/* should be utf8 now 2008-11-14 15:58:50 +00:00
GuiBranches.cpp thrid attempt at changing the naming pattern of the intermediated 'mocced' files 2008-11-14 14:28:50 +00:00
GuiBranches.h cosmetics 2008-09-21 19:27:20 +00:00
GuiChanges.cpp remove unneeded header. 2008-11-15 12:55:40 +00:00
GuiChanges.h
GuiCharacter.cpp Make the GuiCharacter dialog use the new ButtonPolicy. 2009-01-18 14:41:12 +00:00
GuiCharacter.h
GuiCitation.cpp The comment preceding getValueForField() reflected an earlier implmentation. 2008-11-19 04:16:12 +00:00
GuiCitation.h Fix citation bug: In certain circumstances, attempts to insert a new citation 2008-08-13 14:32:30 +00:00
GuiClipboard.cpp Safety measure for r27988. 2009-01-04 23:39:12 +00:00
GuiClipboard.h Fix bug http://bugzilla.lyx.org/show_bug.cgi?id=5560. 2009-01-04 23:31:32 +00:00
GuiCommandBuffer.cpp Fix bug http://bugzilla.lyx.org/show_bug.cgi?id=5567: Enable up button in command buffer widget. 2008-11-25 13:20:54 +00:00
GuiCommandBuffer.h
GuiCommandEdit.cpp thrid attempt at changing the naming pattern of the intermediated 'mocced' files 2008-11-14 14:28:50 +00:00
GuiCommandEdit.h
GuiCompleter.cpp add Buffer * member to DocIterator 2008-11-17 11:46:07 +00:00
GuiCompleter.h * complete-accept directly completes if the completion is unique 2008-11-16 17:02:40 +00:00
GuiDelimiter.cpp thrid attempt at changing the naming pattern of the intermediated 'mocced' files 2008-11-14 14:28:50 +00:00
GuiDelimiter.h
GuiDialog.cpp New ButtonPolicy for dialogs with an auto-apply option. 2009-01-18 14:33:51 +00:00
GuiDialog.h New ButtonPolicy for dialogs with an auto-apply option. 2009-01-18 14:33:51 +00:00
GuiDocument.cpp forgot to save ... 2009-01-08 08:00:37 +00:00
GuiDocument.h This patch introduces ProvidesModule and ExcludesModule layout tags. 2008-10-23 00:27:03 +00:00
GuiErrorList.cpp * GuiErrorList.cpp (showEvent): 2008-11-23 10:55:41 +00:00
GuiErrorList.h Fix for 5429 from Vincent. 2008-10-30 11:49:18 +00:00
GuiERT.cpp thrid attempt at changing the naming pattern of the intermediated 'mocced' files 2008-11-14 14:28:50 +00:00
GuiERT.h
GuiExternal.cpp * GuiExternal.{cpp,h}: 2009-01-14 15:47:25 +00:00
GuiExternal.h * GuiExternal.{cpp,h}: 2009-01-14 15:47:25 +00:00
GuiFloat.cpp thrid attempt at changing the naming pattern of the intermediated 'mocced' files 2008-11-14 14:28:50 +00:00
GuiFloat.h
GuiFontExample.cpp
GuiFontExample.h
GuiFontLoader.cpp
GuiFontLoader.h
GuiFontMetrics.cpp Coding style 2008-09-08 01:18:33 +00:00
GuiFontMetrics.h
GuiGraphics.cpp * InsetGraphics.{cpp.h}: 2009-01-17 08:02:52 +00:00
GuiGraphics.h * InsetGraphics.{cpp.h}: 2009-01-17 08:02:52 +00:00
GuiGraphicsUi.h
GuiHSpace.cpp fix bug 2558: hspace support in math 2008-12-22 18:12:32 +00:00
GuiHSpace.h fix bug 2558: hspace support in math 2008-12-22 18:12:32 +00:00
GuiHyperlink.cpp thrid attempt at changing the naming pattern of the intermediated 'mocced' files 2008-11-14 14:28:50 +00:00
GuiHyperlink.h cosmetics 2008-09-03 18:30:05 +00:00
GuiIdListModel.cpp
GuiIdListModel.h
GuiImage.cpp * GuiImage::scale(): simplify. 2008-09-19 14:36:45 +00:00
GuiImage.h Simplify image creation with a new factory function: newImage(). 2008-09-19 12:01:01 +00:00
GuiInclude.cpp thrid attempt at changing the naming pattern of the intermediated 'mocced' files 2008-11-14 14:28:50 +00:00
GuiInclude.h cosmetics 2008-09-03 18:30:05 +00:00
GuiInfo.cpp fix potential problems detected by gcc 2008-12-22 18:18:47 +00:00
GuiInfo.h
GuiKeySymbol.cpp Fix bug http://bugzilla.lyx.org/show_bug.cgi?id=5648 2009-01-09 07:32:52 +00:00
GuiKeySymbol.h more latin1..utf8 schanges. all of src/* should be utf8 now 2008-11-14 15:58:50 +00:00
GuiLabel.cpp thrid attempt at changing the naming pattern of the intermediated 'mocced' files 2008-11-14 14:28:50 +00:00
GuiLabel.h
GuiListings.cpp more latin1..utf8 schanges. all of src/* should be utf8 now 2008-11-14 15:58:50 +00:00
GuiListings.h
GuiLog.cpp thrid attempt at changing the naming pattern of the intermediated 'mocced' files 2008-11-14 14:28:50 +00:00
GuiLog.h
GuiMathMatrix.cpp more latin1..utf8 schanges. all of src/* should be utf8 now 2008-11-14 15:58:50 +00:00
GuiMathMatrix.h more latin1..utf8 schanges. all of src/* should be utf8 now 2008-11-14 15:58:50 +00:00
GuiNomencl.cpp thrid attempt at changing the naming pattern of the intermediated 'mocced' files 2008-11-14 14:28:50 +00:00
GuiNomencl.h cosmetics 2008-09-03 18:30:05 +00:00
GuiNote.cpp more latin1..utf8 schanges. all of src/* should be utf8 now 2008-11-14 15:58:50 +00:00
GuiNote.h more latin1..utf8 schanges. all of src/* should be utf8 now 2008-11-14 15:58:50 +00:00
GuiPainter.cpp * fix for r27091: draw the newly created pixmap. The reordering of the code has removed this case. So much about trivial program transformation. 2008-11-03 07:40:18 +00:00
GuiPainter.h
GuiParagraph.cpp thrid attempt at changing the naming pattern of the intermediated 'mocced' files 2008-11-14 14:28:50 +00:00
GuiParagraph.h remove mutable property 2008-09-29 10:56:45 +00:00
GuiPrefs.cpp Case-insensitive sorting of colors in GuiPrefs. 2009-01-05 13:37:46 +00:00
GuiPrefs.h Add support for MyThes (i.e., OpenOffice thesauri). 2008-11-16 18:48:25 +00:00
GuiPrint.cpp thrid attempt at changing the naming pattern of the intermediated 'mocced' files 2008-11-14 14:28:50 +00:00
GuiPrint.h
GuiRef.cpp more latin1..utf8 schanges. all of src/* should be utf8 now 2008-11-14 15:58:50 +00:00
GuiRef.h From Vincent: 2008-10-28 15:38:28 +00:00
GuiSearch.cpp thrid attempt at changing the naming pattern of the intermediated 'mocced' files 2008-11-14 14:28:50 +00:00
GuiSearch.h
GuiSelection.cpp thrid attempt at changing the naming pattern of the intermediated 'mocced' files 2008-11-14 14:28:50 +00:00
GuiSelection.h
GuiSelectionManager.cpp thrid attempt at changing the naming pattern of the intermediated 'mocced' files 2008-11-14 14:28:50 +00:00
GuiSelectionManager.h cosmetics. remoe strange dependency of GuiDocument.h 2008-09-20 13:44:51 +00:00
GuiSendto.cpp more latin1..utf8 schanges. all of src/* should be utf8 now 2008-11-14 15:58:50 +00:00
GuiSendto.h more latin1..utf8 schanges. all of src/* should be utf8 now 2008-11-14 15:58:50 +00:00
GuiSetBorder.cpp thrid attempt at changing the naming pattern of the intermediated 'mocced' files 2008-11-14 14:28:50 +00:00
GuiSetBorder.h
GuiShowFile.cpp thrid attempt at changing the naming pattern of the intermediated 'mocced' files 2008-11-14 14:28:50 +00:00
GuiShowFile.h
GuiSpellchecker.cpp * GuiSpellchecker: 2008-12-05 10:20:26 +00:00
GuiSpellchecker.h
GuiSymbols.cpp Support gcc 4.4. Patch from Martin Michlmayr. 2008-11-17 12:49:47 +00:00
GuiSymbols.h more latin1..utf8 schanges. all of src/* should be utf8 now 2008-11-14 15:58:50 +00:00
GuiTabular.cpp Fix some small Tabular UI glitches 2008-11-17 11:58:14 +00:00
GuiTabular.h more latin1..utf8 schanges. all of src/* should be utf8 now 2008-11-14 15:58:50 +00:00
GuiTabularCreate.cpp thrid attempt at changing the naming pattern of the intermediated 'mocced' files 2008-11-14 14:28:50 +00:00
GuiTabularCreate.h
GuiTexinfo.cpp thrid attempt at changing the naming pattern of the intermediated 'mocced' files 2008-11-14 14:28:50 +00:00
GuiTexinfo.h
GuiThesaurus.cpp * GuiThesaurus.cpp: 2008-11-17 07:15:44 +00:00
GuiThesaurus.h Add support for MyThes (i.e., OpenOffice thesauri). 2008-11-16 18:48:25 +00:00
GuiToc.cpp thrid attempt at changing the naming pattern of the intermediated 'mocced' files 2008-11-14 14:28:50 +00:00
GuiToc.h
GuiToolbar.cpp * GuiToolbar.cpp (set): 2008-12-05 14:02:03 +00:00
GuiToolbar.h more latin1..utf8 schanges. all of src/* should be utf8 now 2008-11-14 15:58:50 +00:00
GuiView.cpp * GuiView.cpp (insertPlaintextFile): 2009-01-09 07:35:20 +00:00
GuiView.h The rest of Tommaso patch with some cleanups. Not very clean still but at least it compiles! 2008-11-16 01:20:34 +00:00
GuiViewSource.cpp #4430 still not fixed. try better one. 2008-11-17 12:30:28 +00:00
GuiViewSource.h Code shuffling in order to fix http://bugzilla.lyx.org/show_bug.cgi?id=5347 2008-10-18 13:20:17 +00:00
GuiVSpace.cpp more latin1..utf8 schanges. all of src/* should be utf8 now 2008-11-14 15:58:50 +00:00
GuiVSpace.h more latin1..utf8 schanges. all of src/* should be utf8 now 2008-11-14 15:58:50 +00:00
GuiWorkArea.cpp FindAndReplace: more simplification and add a WorkArea for replace (not used yet). 2008-11-22 18:18:51 +00:00
GuiWorkArea.h FindAndReplace: more simplification and correct focus handling. 2008-11-22 17:35:17 +00:00
GuiWrap.cpp more latin1..utf8 schanges. all of src/* should be utf8 now 2008-11-14 15:58:50 +00:00
GuiWrap.h more latin1..utf8 schanges. all of src/* should be utf8 now 2008-11-14 15:58:50 +00:00
IconPalette.cpp thrid attempt at changing the naming pattern of the intermediated 'mocced' files 2008-11-14 14:28:50 +00:00
IconPalette.h
InsertTableWidget.cpp thrid attempt at changing the naming pattern of the intermediated 'mocced' files 2008-11-14 14:28:50 +00:00
InsertTableWidget.h
LaTeXHighlighter.cpp
LaTeXHighlighter.h
LengthCombo.cpp * LengthCombo.{cpp,h}: 2009-01-14 12:57:23 +00:00
LengthCombo.h * LengthCombo.{cpp,h}: 2009-01-14 12:57:23 +00:00
LyXFileDialog.cpp thrid attempt at changing the naming pattern of the intermediated 'mocced' files 2008-11-14 14:28:50 +00:00
LyXFileDialog.h
Makefile.am The rest of Tommaso patch with some cleanups. Not very clean still but at least it compiles! 2008-11-16 01:20:34 +00:00
Menus.cpp Clean up the menus: 2009-01-16 20:58:04 +00:00
Menus.h more latin1..utf8 schanges. all of src/* should be utf8 now 2008-11-14 15:58:50 +00:00
PanelStack.cpp thrid attempt at changing the naming pattern of the intermediated 'mocced' files 2008-11-14 14:28:50 +00:00
PanelStack.h cosmetics 2008-09-21 09:11:21 +00:00
pch.h
qt_helpers.cpp * qt_helpers.{cpp,h}: 2009-01-14 17:53:31 +00:00
qt_helpers.h * qt_helpers.{cpp,h}: 2009-01-14 17:53:31 +00:00
qt_i18n.h
README
TocModel.cpp thrid attempt at changing the naming pattern of the intermediated 'mocced' files 2008-11-14 14:28:50 +00:00
TocModel.h Avoid a complete Toc reset in case when only a toc item update is needed. 2008-09-30 09:50:54 +00:00
TocWidget.cpp * TocWidget: whitespace only. 2009-01-07 14:49:40 +00:00
TocWidget.h Add persistent view switch to the outliner. 2008-10-02 15:00:43 +00:00
Toolbars.cpp Fix crash when the Gui Name of a toolbar is not plain ascii. This 2008-08-15 18:43:46 +00:00
Toolbars.h Fix crash when the Gui Name of a toolbar is not plain ascii. This 2008-08-15 18:43:46 +00:00
Validator.cpp * qt_helpers.{cpp,h}: 2009-01-14 17:53:31 +00:00
Validator.h * qt_helpers.{cpp,h}: 2009-01-14 17:53:31 +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.