lyx_mirror/src/frontends/gnome
Lars Gullik Bjønnes 53274e31ec the string -> char patch
git-svn-id: svn://svn.lyx.org/lyx/lyx-devel/trunk@5725 a592a061-630c-0410-9148-cb99ea01b6c8
2002-11-27 10:30:28 +00:00
..
dialogs Change existing ERT dialog to follow GNOME guidelines, implement About and Float Properties. 2002-06-15 09:22:03 +00:00
.cvsignore
accessors.py Implement the Log dialog, also update accessors.py 2002-06-03 03:38:30 +00:00
ChangeLog doxygen fixes. 2002-09-26 08:57:43 +00:00
Dialogs.C doxygen fixes. 2002-09-26 08:57:43 +00:00
FileDialog.C doxygen fixes. 2002-09-26 08:57:43 +00:00
GAbout.C STRCONV 2002-11-04 02:12:42 +00:00
GAbout.h doxygen fixes. 2002-09-26 08:57:43 +00:00
GError.C doxygen fixes. 2002-09-26 08:57:43 +00:00
GError.h doxygen fixes. 2002-09-26 08:57:43 +00:00
GERT.C doxygen fixes. 2002-09-26 08:57:43 +00:00
GERT.h doxygen fixes. 2002-09-26 08:57:43 +00:00
GFloat.C the string -> char patch 2002-11-27 10:30:28 +00:00
GFloat.h doxygen fixes. 2002-09-26 08:57:43 +00:00
GLog.C doxygen fixes. 2002-09-26 08:57:43 +00:00
GLog.h doxygen fixes. 2002-09-26 08:57:43 +00:00
gnome_helpers.C Copyright notices 2002-09-25 14:26:13 +00:00
gnome_helpers.h Copyright notices 2002-09-25 14:26:13 +00:00
GnomeBase.C Copyright notices 2002-09-25 14:26:13 +00:00
GnomeBase.h doxygen fixes. 2002-09-26 08:57:43 +00:00
gnomeBC.C Copyright notices 2002-09-25 14:26:13 +00:00
gnomeBC.h Copyright notices 2002-09-25 14:26:13 +00:00
GPreamble.C doxygen fixes. 2002-09-26 08:57:43 +00:00
GPreamble.h doxygen fixes. 2002-09-26 08:57:43 +00:00
GTabularCreate.C doxygen fixes. 2002-09-26 08:57:43 +00:00
GTabularCreate.h doxygen fixes. 2002-09-26 08:57:43 +00:00
GUIRunTime.C Copyright notices 2002-09-25 14:26:13 +00:00
GUrl.C doxygen fixes. 2002-09-26 08:57:43 +00:00
GUrl.h doxygen fixes. 2002-09-26 08:57:43 +00:00
Makefile.am replace XFORMSGIMAGE by XFORMSIMAGE 2002-07-04 13:00:09 +00:00
pixbutton.h Copyright notices 2002-09-25 14:26:13 +00:00
README A lean, clean and working start to the new, improved gnome frontend. 2002-03-27 10:07:57 +00:00
support.c Marko's GNOME patch and Baruch's insetgraphic patch + some fixes to make all 2000-08-14 09:44:53 +00:00
support.h ws cleanup 2002-03-21 21:21:28 +00:00
Timeout_pimpl.C Copyright notices 2002-09-25 14:26:13 +00:00
Timeout_pimpl.h Copyright notices 2002-09-25 14:26:13 +00:00

GNOME FRONT END
===============

Firstly, this stuff is pre-alpha.  I don't use it so you shouldn't
either.  At all, no exceptions :). Secondly I'm no c++ guru, I'm
learning as I go along so if something looks stupid, there's a good
chance it is.

Adding Dialogs
--------------

The GNOME frontend of LyX uses libglade to draw the dialogs.  The base
(GnomeBase.C) class handles the drawing and activating of the Dialogs,
for an example of contructing a simple dialog see GUrl.[Ch]

FormUrl::FormUrl(ControlUrl & c)
	: FormCB<ControlUrl>(c, "FormUrl")
{}



To manipulate a widget you extract a pointer using getWidget(string).

If you look at FormUrl you'll see that there are a number of
helper functions at the bottom of the .C file.  These are
automatically generated by accessors.py

For accessors.py to work glade files now must adhere to the following
conventions: 

 * The root widget and the file should be named after the form (i.e
   FormTabularCreate & FormTabularCreate.glade)  
 * Functional widgets, those actually used rather than the filler
   widgets like Gtk::HBox etc,  should have an r_ as the first two
   characters of their name. (see below)

To make the build system include your new dialog edit Makefile.am as
follows:
 1) make clean in src/frontends/gnome/
 2) Add GX.C and GX.h to libgnome_la_SOURCES
 3) Remove FormX.lo and form_x.lo (if applicable) from xforms_objects
 4) make clean && make in src/frontends/
 5) make in src/


Using accessors.py
------------------

Usage:

python accessors.py glade_ui_file DialogClass

e.g

python accessors.py FormTabularCreate.glade GTabularCreate

Accessors.py will write the helper functions to DialogClass.C_gen and
the function declarations to DialogClass.g_gen.  To ensure the widgets
you're interested in are made available using this method, prefix the
widgets name with r_ when you build the dialog in Glade.