15.6 Anzeige-Elemente 

Als Nächstes sollen hier einige Widgets vorgestellt werden, mit denen nur etwas angezeigt werden kann. Also einfache Widgets ohne irgendwelche Interaktionen wie Ein- oder Ausgabe.

Im folgenden Beispiel werden das Widget GtkLabel, mit dem Sie eine einfache Beschriftung auf einem Widget anbringen, und das Widget GtkImage verwendet, mit dem Sie, wie man dem Klassennamen schon entnehmen kann, Bilder auf ein Widget anzeigen können. Mit GtkImage lassen sich fast Bilder jeglicher Art darstellen. Des Weiteren finden Sie das Widget GtkStatusbar, womit gewöhnlich, der Status – die aktuelle Aktion – der Anwendung in einem kleinen Balken am unterem Fensterrand angezeigt wird. Daneben wird auch noch das häufig verwendete Widget GtkSeparator (hier mit der Unterklasse GtkHSeparator) zum Anzeigen einer Linie verwendet.

Hierzu das Programmbeispiel mit anschließender Erläuterung der einzelnen Widgets.

/* gkt2.c */
/* Anzeigeelemente:             */
/*       Label,                 */
/*       Grafik                 */
/*       Statusbar              */
#include <gtk/gtk.h>
static gint
delete_Event(GtkWidget *widget, GdkEvent event, gpointer daten) {
  g_print("Das Fenster wird zerstoert!\n");
  /* Nur mit FALSE wird die Anwendung wirklich beendet */
  return FALSE;
}
static void end ( GtkWidget *widget, gpointer daten ) {
  g_print("Und tschuess!\n");
  gtk_main_quit();
}
int main(int argc, char *argv[]) {
  GtkWindow  *win;
  GdkPixbuf  *pic;
  GtkVBox    *vbox;
  GtkLabel   *text;
  GtkImage   *image;
  GtkStatusbar *bar;
  GtkHSeparator *sep1, *sep2, *sep3;
  gtk_init( &argc, &argv );
  /* Eine Grafik in einen Pixbuf laden */
  pic = gdk_pixbuf_new_from_file("icon/at-work.gif", NULL );
  /* Fenster mit folgenden Eigenschaften anlegen */
  win = g_object_new( GTK_TYPE_WINDOW,
                      "title", "Verschiedene Anzeigeelemente",
                      "default-width", 300,
                      "default-height", 200,
                      "resizable", TRUE,
                      "window-position", GTK_WIN_POS_CENTER,
                      "border-width", 5,
                      "icon", pic,
                      NULL );
  /* Eine vertikale Box erzeugen */
  vbox = g_object_new( GTK_TYPE_VBOX,
                       "spacing", 5,
                       "homogeneous", FALSE,
                       NULL );
  /* Ein Text-Label erzeugen */
  text = g_object_new(GTK_TYPE_LABEL,
                      "label","Ein einfaches GtkLabel, das"
                      " die\nAbbildung etwas beschreiben"
                      " koennte.\n",
                      "justify", GTK_JUSTIFY_FILL,
                      NULL);
  /* 3 horizontale Separatoren (Linien) erzeugen */
  sep1 = g_object_new( GTK_TYPE_HSEPARATOR, NULL);
  sep2 = g_object_new( GTK_TYPE_HSEPARATOR, NULL);
  sep3 = g_object_new( GTK_TYPE_HSEPARATOR, NULL);
  /* Ein "Bild"-Widget erzeugen */
  image = g_object_new( GTK_TYPE_IMAGE,
                        "file", "icon/john.png",
                        NULL);
  /* Eine Statusbar erzeugen */
  bar = g_object_new( GTK_TYPE_STATUSBAR, NULL );
  /* Text in der Statusbar einfügen */
  gtk_statusbar_push (bar, 0 ,
         "Informationen der aktellen Aktionen in der Statusbar");
  /* Größe der Statusbar nicht (FALSE) veränderbar */
  gtk_statusbar_set_has_resize_grip (bar, FALSE);
  /* Signalhandler einrichten */
  g_signal_connect( win, "delete-event",
                    G_CALLBACK(delete_Event), NULL );
  g_signal_connect( win, "destroy",
                    G_CALLBACK(end), NULL );
  /* Packen */
  /* vertikale Box in das Hauptfenster */
  gtk_container_add( GTK_CONTAINER(win), GTK_WIDGET(vbox));
  /* Einzelne Widgets von oben nach unten in die vertikale */
  /* Box packen                                            */
  gtk_box_pack_start_defaults(GTK_BOX(vbox), GTK_WIDGET(sep1));
  gtk_box_pack_start_defaults(GTK_BOX(vbox), GTK_WIDGET(text));
  gtk_box_pack_start_defaults(GTK_BOX(vbox), GTK_WIDGET(sep2));
  gtk_box_pack_start_defaults(GTK_BOX(vbox), GTK_WIDGET(image));
  gtk_box_pack_start_defaults(GTK_BOX(vbox), GTK_WIDGET(sep3));
  gtk_box_pack_start_defaults(GTK_BOX(vbox), GTK_WIDGET(bar));
  /* Fenster anzeigen */
  gtk_widget_show_all( GTK_WIDGET(win) );
  /* Hauptschleife von gtk */
  gtk_main();
  g_print("Die GTK-Hauptschleife wurde beendet\n");
  return 0;
}

Das Programm bei der Ausführung:

$ gcc -Wall -o gtk2 gtk2.c \
  `pkg-config gtk+-2.0 --cflags --libs`
$ ./gtk2

Im Beispiel wurden sämtliche Objekte mit der Funktion g_object_new() und der entsprechenden Typenkennung erzeugt. Neben dem bereits bekannten Typ GTK_TYPE_WINDOW und dem Typ GTK_TYPE_VBOX, den Sie im nächsten Abschnitt näher kennen lernen, finden Sie hier noch die Typen GTK_TYPE_LABEL, GTK_TYPE_HSEPARATOR, GTK_TYPE_IMAGE und GTK_TYPE_STATUSBAR vor.

15.6.1 Text – GtkLabel 

Mit GtkLabel können Sie einen einfachen Text an ein Widget anbringen. Obwohl Sie hier im Beispiel nur das Attribut justify zur Ausrichtung der Zeilen der Schriften gegeneinander verwendet haben, können Sie hierbei noch eine Menge weiterer Eigenschaften einsetzen.

Ein Label mit use-markup zu verwenden, lässt die häufig etwas blass aussehenden Text-Labels etwas freudiger erscheinen. Verantwortlich für diese Markup-Sprache ist Pango. Die Syntax von Pango lässt sich aus einer Mischung von HTML mit CSS beschreiben; wobei die Text-Engine von Pango wirklich sehr mächtig ist, weshalb hier für weitere Informationen die entsprechende Dokumentation empfohlen sei. Dennoch will ich Ihnen ein kurzes Listing, das den Einsatz von Pango-Markup demonstriert, nicht vorenthalten.

/* gkt2b.c */
/* Anzeigeelemente:             */
/*       Label mit Pango-Markup */
#include <gtk/gtk.h>
static gint
delete_Event(GtkWidget *widget, GdkEvent event, gpointer daten) {
  g_print("Das Fenster wird zerstoert!\n");
  /* Nur mit FALSE wird die Anwendung wirklich beendet */
  return FALSE;
}
static void end ( GtkWidget *widget, gpointer daten ) {
  g_print("Und tschuess!\n");
  gtk_main_quit();
}
int main(int argc, char **argv) {
  GtkWindow  *win;
  GdkPixbuf  *pic;
  GtkVBox    *vbox;
  GtkLabel   *text;
  gtk_init( &argc, &argv );
  /* Eine Grafik in einen Pixbuf laden */
  pic = gdk_pixbuf_new_from_file("icon/at-work.gif", NULL );
  /* Fenster mit folgenden Eigenschaften anlegen */
  win = g_object_new( GTK_TYPE_WINDOW,
                      "title", "Demonstriert Pango-Markup",
                      "default-width",  300,
                      "default-height", 200,
                      "resizable", TRUE,
                      "window-position", GTK_WIN_POS_CENTER,
                      "border-width", 5,
                      "icon", pic,
                      NULL );
  /* Eine vertikale Box erzeugen */
  vbox = g_object_new( GTK_TYPE_VBOX,
                       "spacing", 5,
                       "homogeneous", FALSE,
                       NULL );
  /* Ein Text-Label erzeugen */
  text = g_object_new( GTK_TYPE_LABEL,
 "justify", GTK_JUSTIFY_CENTER,
 "use-markup", TRUE,
 "label",
 "<span font_desc=\"Times Normal 12\"> Times Normal 12</span> - "
 "<span font_desc=\"Verdana\"> Verdana </span> - "
 "<span font_desc=\"Courier Bold 10\"> Courier Bold 10 "
 " </span>\n\n"
 "<span style=\"italic\"> Kursiv </span> - "
 "<span style=\"oblique\"> Geschraegt </span> - "
 "<span style=\"normal\"> Normal </span>\n\n"
 "<span font_desc=\"Times Normal 12\"  background=\"white\""
 " foreground=\"blue\"> Invers1 </span> - "
 "<span font_desc=\"Courier Bold 14\"  background=\"black\""
 " foreground=\"green\"> Invers2 </span> - "
 "<span style=\"italic\"  background=\"red\""
 " foreground=\"yellow\"> Invers3 </span>\n",
                       NULL);
  /* Signalhandler einrichten */
  g_signal_connect( win, "delete-event",
                    G_CALLBACK(delete_Event), NULL );
  g_signal_connect( win, "destroy",
                    G_CALLBACK(end), NULL );
  /* Packen */
  gtk_container_add( GTK_CONTAINER(win), GTK_WIDGET(vbox));
  gtk_box_pack_start_defaults(GTK_BOX(vbox), GTK_WIDGET(text));
  /* Fenster anzeigen */
  gtk_widget_show_all( GTK_WIDGET(win) );
  /* Hauptschleife von gtk */
  gtk_main();
  g_print("Die GTK-Hauptschleife wurde beendet\n");
  return 0;
}

Das Programm bei der Ausführung:

$ gcc -Wall -o gtk2b gtk2b.c \
  `pkg-config gtk+-2.0 --cflags --libs`
$ ./gtk2b

15.6.2 Trennlinie – GtkSeparator 

Viel lässt sich zu diesem Widget eigentlich nicht sagen, nur dass GtkSeparator die Basisklasse für die Widgets GtkVSeparator (vertikale Linie) und GtkHSeparator (horizontale Linie) ist. Im Beispiel wurden mit dem Typ GTK_TYPE_HSEPARATOR drei horizontale Linien erzeugt. Mit dem Typ GTK_TYPE_VSEPARATOR lassen sich auch vertikale Linien erzeugen.

15.6.3 Grafiken – GtkImage 

Ebenso einfach wie einen Text (GtkLabel) können Sie auch eine Grafik auf einem Widget anbringen. Hierzu müssen Sie nur ein Widget mit der Klasse GtkImage (vom Typ GTK_TYPE_IMAGE) erzeugen und mithilfe der Eigenschaft file den Pfadnamen zur Grafik angeben. Hierbei werden so ziemlich alle wichtigen Grafikformate unterstützt (gif, jpeg, png, ico, tiff, bmp, tga etc.).

Wenn Sie allerdings neben dem Anzeigen einer Grafik auch daran interessiert sind, diese zu verändern, dann kommen Sie nicht um Pixbufs (GdkPixbuf) herum. Denn letztendlich geschieht die Verarbeitung und Anzeige der Grafik mit GtkImage über ein GdkPixbuf-Objekt. GdkPixbuf ist eine GDK-interne Struktur für Grafikdaten.

Da GdkPixbuf ein recht umfangreiches Thema ist, wurde der GTK+-Lib hierfür gleich eine extra umfangreiche Dokumentation spendiert, auf die ich Sie bei Bedarf verweisen muss.

15.6.4 Statusleiste – GtkStatusbar 

Gewöhnlich platziert man eine Statusbar, wie im Beispiel gesehen, unten am Hauptfenster von GtkWindow. Meistens befinden sich darin Informationen, wie z. B. bei einem Texteditor, welche Datei (mit Pfad) geöffnet wurde, in welcher Zeile/Spalte sich der Cursor befindet oder welche Seite von den insgesamt vorhandenen Seiten gerade bearbeitet wird.

guint gtk_statusbar_push ( 
  GtkStatusbar *statusbar, guint context_id, const gchar *text );
void gtk_statusbar_pop (
 GtkStatusbar *statusbar, guint context_id );
guint gtk_statusbar_get_context_id (
 GtkStatusbar *statusbar, const gchar *context_description );
void gtk_statusbar_set_has_resize_grip (
 GtkStatusbar *statusbar, gboolean setting );
void gtk_statusbar_remove ( 
 GtkStatusbar *statusbar, guint context_id, guint message_id );

Nach dem Erzeugen einer solchen Statusleiste können Sie mit der Funktion gtk_statusbar_push() eine neue Statusinformation in diese Leiste einfügen. Genauer, hiermit wird eine Nachricht auf einen Stack der Statusleiste gepuscht. Beim Anzeigen der Statusleiste wird dann immer die Nachricht angezeigt, die oben aufliegt. Mit der Funktion gtk_statusbar_pop() hingegen können Sie eine Nachricht oberhalb des Stacks wieder entfernen.

Jede Nachricht, die auf dem Stack der Statusbar hinzugefügt wird, benötigt eine bestimmte ID, um die Quelle der Nachricht eindeutig identifizieren zu können. Eine solche ID können Sie auch mit der Funktion gtk_statusbar_get_context_id() erzeugen. Diese Funktion gibt eine neue ID (gint) zurück. Natürlich können Sie hierbei auch die ID selbst, wie im Beispiel gesehen, in der Funktion gtk_statusbar_push() als zweiten Parameter eintragen.

Der Vorteil bei der Verwendung von gtk_statusbar_get_context_id() liegt darin, dass mit der Funktion gtk_statusbar_remove() eine Statusnachricht von einer beliebigen Stelle des Stacks entfernt werden kann.

Wollen Sie, dass die Größe der Statusbar veränderbar ist, können Sie mit der Funktion gtk_statusbar_set_has_resize_grip() den zweiten Parameter auf TRUE setzen.

15.6.5 Fortschrittsbalken – GtkProgressBar 

Ein weiteres reines Anzeige-Widget, das in diesem Beispiel nicht verwendet wurde, ist das Widget der Klasse GtkProgressBar vom Typ GTK_TYPE_PROGRESS_BAR. Hierbei handelt es sich um einen Fortschrittsbalken, der z. B. anzeigen kann, wie weit ein bestimmter Vorgang abgeschlossen ist.