284 lines
9.1 KiB
HTML
284 lines
9.1 KiB
HTML
<html>
|
|
<head>
|
|
<title>The Gnome.NET Tutorial</title>
|
|
|
|
<link rel="stylesheet" type="text/css" href="../../style.css" />
|
|
|
|
</head>
|
|
<body>
|
|
|
|
<table bgcolor=#BEBAA8 width=100% >
|
|
<tr><td><a href="../../../index.html"><img src="../../../mg.png" border=0></a><a href="../../index.html"><img src="../../gn.png" border=0></a></td></tr>
|
|
</table>
|
|
<table bgcolor=#efefef width=100% >
|
|
<tr><td class="navbar"><a href="../../../index.html">Monkeyguide</a> > <a href="../../index.html">GNOME.NET</a> > C# bindings > <b>Glade#</b></tr>
|
|
</table>
|
|
<p>
|
|
|
|
<table>
|
|
<tr>
|
|
<td><img src="icon.png" /></td>
|
|
<td>
|
|
<h1>Glade - Rapid Application Development with Gnome 2</h1>
|
|
|
|
by Johannes Roith (<a
|
|
href="mailto:johannes@jroith.de">johannes@jroith.de</a>)</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<h2>Introduction</h2>
|
|
|
|
In the previous chapter, you learned how create a Gnome GUI. If
|
|
you've worked with Visual Studio, Delphi/Kylix or Visual Basic
|
|
you might be missing the easy way of dragging widgets on
|
|
forms.<br />
|
|
<br />
|
|
You're right, after all, what we want to do is creating good
|
|
applications <u>faster</u> with mono. Development , where the
|
|
programmer gets assistance in non-coding tasks from (visual)
|
|
tools and focuses on the real work is called RAD - Rapid
|
|
Application Development. Gnome offers a set of such technologies,
|
|
known as Glade. <br />
|
|
<br />
|
|
Glade consists of 2 part:<br />
|
|
<ul>
|
|
<li>Glade - a grafical editor to create forms and save them in
|
|
XML files.</li>
|
|
|
|
<li>libglade (called Glade# in Gtk#) - a library to load the XML
|
|
at runtime<br />
|
|
and dynamically create the form.</li>
|
|
</ul>
|
|
|
|
That means, the user will need have libglade installed, and the
|
|
xml file must be distributed with the application. Glade# is the
|
|
C# binding for libglade and even offers some advanced features -
|
|
like self-contained glade files - that are only available in
|
|
Gtk#.<br />
|
|
<br />
|
|
Language independence has always been a goal in Gnome
|
|
Development. For that reason the Glade Interface Builder exports
|
|
xml, that can be used with any language with glade bindings. This
|
|
benefit is bought with little more effort compared to Visual
|
|
Studio, as the code can't be generated automatically. <br />
|
|
<br />
|
|
<h2>Creating the UI</h2>
|
|
|
|
<table cellpadding="5" border="0">
|
|
<tr>
|
|
<td valign="top"><img src="glade-palette.png" border="0" /></td>
|
|
<td valign="top">Before we try to use glade with our Project,
|
|
first get some experience with it. Fire up the Glade Interface
|
|
Designer. You will be greeted by three windows: the main window,
|
|
a properites and a palette window, containing icons. Click
|
|
Project - New and select "Gnome Project".<br />
|
|
<br />
|
|
To create a new window click on the first icon in the
|
|
palette-window. The new window is shown in the list. You can
|
|
modify Type, Position, Caption, and other things in the
|
|
Properties window.<br />
|
|
<br />
|
|
If you want your application to quit, if the window is closed
|
|
you'll have to connect a signal with an event handler. Select
|
|
"Signals" and add a handler for "delete_event" and call it
|
|
"OnWindowDeleteEvent".<br />
|
|
<br />
|
|
Take a button and drop it on the window. As you know, gtk+ has
|
|
the concept of invisible boxes, to position widgets, and for that
|
|
reason the button will fill the whole window. Modify some
|
|
properties and add a signal handler for "clicked" and call it
|
|
"OnButton1Clicked".<br />
|
|
<br />
|
|
Save to a new directory. Glade will put 2 files there:
|
|
[projectname].glade and [projectname].gladep, wich does only save
|
|
some information for the Interface Builder. The "interesting"
|
|
file is the .glade file, that you can open in any text editor.
|
|
It's plain XML and looks like that:<br />
|
|
<br />
|
|
</td>
|
|
<td valign="top"><img src="glade-m.png" border="0" /><br />
|
|
<img src="glade-properties.png" border="0" /></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<pre class="code">
|
|
<?xml version="1.0" standalone="no"?> <!--*- mode: xml -*-->
|
|
<!DOCTYPE glade-interface SYSTEM "http://glade.gnome.org/glade-2.0.dtd">
|
|
|
|
<glade-interface>
|
|
|
|
<widget class="GtkWindow" id="window2">
|
|
<property name="visible">True</property>
|
|
<property name="title" translatable="yes">window2</property>
|
|
<property name="type">GTK_WINDOW_TOPLEVEL</property>
|
|
<property name="window_position">GTK_WIN_POS_NONE</property>
|
|
<property name="modal">False</property>
|
|
<property name="resizable">True</property>
|
|
<property name="destroy_with_parent">False</property>
|
|
|
|
<child>
|
|
<widget class="GtkButton" id="button1">
|
|
<property name="border_width">10</property>
|
|
<property name="visible">True</property>
|
|
<property name="can_focus">True</property>
|
|
<property name="label" translatable="yes">button1</property>
|
|
<property name="use_underline">True</property>
|
|
<property name="relief">GTK_RELIEF_NORMAL</property>
|
|
</widget>
|
|
</child>
|
|
</widget>
|
|
|
|
</glade-interface>
|
|
</pre>
|
|
|
|
<br />
|
|
<h2>It's time to start coding</h2>
|
|
|
|
The code is similiar to previous chapters. What has changed is,
|
|
that most of the code is move to the GladeTest constructor.
|
|
That's because the main-method is <b>static</b> and therefor
|
|
doesn't belong to any class. Altough possible, moving code to
|
|
Main() would only lead to more complicated code.<br />
|
|
<pre class="code">
|
|
namespace GladeSamples {
|
|
using System;
|
|
|
|
using Gtk;
|
|
using Gnome;
|
|
using Glade;
|
|
using GtkSharp;
|
|
|
|
public class GladeTest
|
|
{
|
|
|
|
public static void Main (string[] args)
|
|
{
|
|
new GladeTest(args);
|
|
}
|
|
public GladeTest (string[] args)
|
|
{
|
|
|
|
Application.Init();
|
|
|
|
/* This loads the glade file glade.glade, selects window2 and connects it to the current object,
|
|
* which is the class GladeTest here. */
|
|
|
|
<b>Glade.XML gxml = new Glade.XML ("file.glade", "window2", null);
|
|
gxml.Autoconnect (this);</b>
|
|
|
|
Application.Run();
|
|
|
|
/* If you want to access the glade objects you have to "import" them.
|
|
* This is not required, but else you can only work with the pre-defined signal handlers */
|
|
|
|
Button button1 = (Gtk.Button) gxml["button1"];
|
|
|
|
button1.BorderWidth=10;
|
|
|
|
}
|
|
|
|
|
|
/* Connect the Signals defined in Glade */
|
|
|
|
|
|
public void OnWindowDeleteEvent (object o, DeleteEventArgs args)
|
|
{
|
|
Application.Quit ();
|
|
args.RetVal = true;
|
|
}
|
|
|
|
public void OnButton1Clicked (System.Object obj, EventArgs e)
|
|
{
|
|
Console.WriteLine ("Button 1 clicked");
|
|
}
|
|
|
|
}
|
|
}
|
|
</pre>
|
|
|
|
<br />
|
|
compile with:
|
|
<table border="0">
|
|
<tr>
|
|
<td><img src="sample1.png" border="border" /></td>
|
|
<td>
|
|
<pre>
|
|
mcs /unsafe -r gtk-sharp.dll -r glade-sharp.dll glade.cs
|
|
</pre>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br />
|
|
Of course, include the Gnome and Glade namespaces.
|
|
<pre class="code">
|
|
using Gnome;
|
|
using Glade;
|
|
</pre>
|
|
|
|
The first part inits the Application.<br />
|
|
Then the glade xml file is connected. The first param is the
|
|
file, the second the main widget (here: the window). The second
|
|
line connects gxml to the current object.
|
|
<pre class="code">
|
|
Glade.XML gxml = new Glade.XML ("file.glade", "window2", null);
|
|
gxml.Autoconnect (this);
|
|
</pre>
|
|
|
|
Altough glade will show all widgets and cares about the events
|
|
defined, most likely you will want to change properties, or add
|
|
events during the runtime. For that to work you have to connect a
|
|
new object to the glade widget. This example also sets the
|
|
BorderWidth.
|
|
<pre class="code">
|
|
Button button1 = (Gtk.Button) gxml["button1"];
|
|
button1.BorderWidth=10;
|
|
</pre>
|
|
|
|
That's it.<br />
|
|
<br />
|
|
|
|
<h2>Available Widgets</h2>
|
|
|
|
All available widgets are devided in 4 categories. If you want
|
|
your application to be independent of gnome and portable to
|
|
windows, or Mac OS X, use only Gtk+ and Gtk+ Additional. If you
|
|
don't need that flexibility I strongly encourage you to make also
|
|
use of the Gnome category. That includes Font-Selector, Druids,
|
|
Iconlists and other useful things.<br />
|
|
<br />
|
|
Glade can be extened, for example gnome-db extensions are
|
|
available.
|
|
<h2>Using Glade in our Project</h2>
|
|
|
|
After explaining how it works, like in the other chapters we want
|
|
to go on with our little Project, introducing the new learned
|
|
technology and extending the knowledge. This chapter removes the
|
|
few UI bits, done by hand and adds an Interface using Glade.
|
|
<br />
|
|
<br />
|
|
[TODO] <br />
|
|
<br />
|
|
|
|
<h2>Didn't you say something about this self-contained
|
|
thing?</h2>
|
|
|
|
Yes, I did. And it's quite a good feature. Now, that we're using
|
|
Glade our application consists not only of 1, but 2 files.
|
|
Luckily, the CLR has a way, to embedd any file in the executable,
|
|
like images or text files. Glade offer an additional constructor
|
|
to load the glade file from a resource, so you don't have to
|
|
distribute it. The only difference is the "null" before the
|
|
filename.
|
|
<pre class="code">
|
|
Glade.XML gxml = new Glade.XML (<b>null</b>, "file.glade", "window2", null);
|
|
gxml.Autoconnect (this);
|
|
</pre>
|
|
|
|
You have then to compile the file in, with the resource switch.
|
|
<pre>
|
|
mcs /unsafe /resource:glade.glade -r gtk-sharp.dll -r glade-sharp.dll glade.cs
|
|
</pre>
|
|
</body>
|
|
</html>
|
|
|