EXAMPLES

These files are examples of specific parts of the java-gnome API worked up as complete Java programs.

Source code, especially Java source code, doesn’t always lend itself to being read, certainly not from top to bottom. We have attempted, however, to create some examples which are non-trivial but nonetheless are still readable.

Button in a Window
- ExamplePressMe.java
  It doesn’t get any simpler than this. A Label and a Button in a Window, showing how to connect a listener to handle a CLICKED signal from the Button and how to ensure your application terminates when the Window is deleted.
Handling keystrokes
- ExampleSnooping.java
  Handling keyboard input is more complicated than it reasonably ought to be. In most cases the existing GTK Widgets already do everything that needs doing (when you type text into an Entry, the text does indeed go into that Entry), focus handling, etc. However, if you need to intercept a keystroke so you can do something special, then you need to work with the Keyval and ModifierType classes in response to the KEY_PRESS_EVENT signal. This is how.
TreeView and TreeModel
- ExampleTrailHeads.java
  While not a complete tutorial, we have an example of a small application which uses a TreeView backed by a ListStore called ExampleTrailHeads. It is heavily commented and meant to serve as an introduction of the incredibly powerful yet very complex TreeView / TreeModel system. It should be read in conjunction with the API documentation for these types. You’ll also want to read about how to setup a ListStore and the explanation of available column types in DataColumn.
Drawing with Cairo
- ExampleDrawingInExposeEvent.java
  FIXME this needs a better name.
  Using the Cairo Graphics library to draw within a GTK program means following the idiom shown in this example. This program demonstrates drawing lines, rectangles, and gradients using a drawing Context as obtained within a Widget’s EXPOSE_EVENT signal handler.