Grafisch programmeren met GTK - Deel 3

ArticleCategory:

SoftwareDevelopment

AuthorImage:

TranslationInfo:

original in tr Özcan Güngör

en to tr Özcan Güngör

en to nl Samuel Derous

AboutTheAuthor

Op het ogenblik doe ik mijn legerdienst als Linux, Oracle beheerder en webprogrammeur.

Abstract

In deze serie artikelen zullen we leren hoe we graphical user interfaces (GUIs) kunnen schrijven door gebruik te maken van GTK. Ik heb er geen idee van hoe lang deze serie zal duren. Om deze artikelen te begrijpen zou je het volgende over de C-talen moeten kennen:

Variabelen
functies
Pointers

Het is aanbevolgen de vorige artikelen te lezen:
Grafisch programmeren met GTK,
Grafisch programmeren met GTK - Deel 2.
Dit artikel is wat korter dan de vorige daar ik mijn legerdienst doe.

ArticleIllustration:

ArticleBody:

Toggle Button

Deze knop lijkt op een normale knop maar heeft twee mogelijkheden: ingedrukt of niet. Om een indrukknop te maken wordt één van de volgende functies gebruikt:

GtkWidget *toggle=gtk_toggle_button_new(void);
GtkWidget *toggle=gtk_toggle_button_new_with_label(const gchar *label);

De eerste functie maakt een indrukknop zonder tekstlabel, terwijl de tweede één creëert met de string label erop.
Zijn status kun je met volgende functie aanpassen:

gtk_toggle_button_set_active (GtkToggleButton *toggle_button, 
                              gboolean is_active);

Hier is toggle_button de knop wiens status je wenst aan te passen en active is de status (0 of 1). Wanneer het 0 is, is de knop niet ingedrukt; wanneer het 1 is, is de knop wel ingedrukt.

Om de status van de knop te verkrijgen kan volgende functie gebruikt worden:

gboolean gtk_toggle_button_get_active(GtkToggleButton *button);

De "toggled" event kan verbonden worden met een indrukknop.

Hier is een voorbeeld:

#include <gtk/gtk.h>
void togg(GtkWidget *widget, gpointer *data){
   if (gtk_toggle_button_get_active(GTK_TOGGLE_BUTTON(data)))
    g_print("State is 1\n");
   else
    g_print("State is 0\n");
}

int main( int argc,char *argv[] )
   {
   
   GtkWidget *window;
   GtkWidget *button;

   gtk_init (&argc, &argv);

   /* Maak een nieuw venster */
   window = gtk_window_new (GTK_WINDOW_TOPLEVEL);
   gtk_window_set_title (GTK_WINDOW (window), "Toggle Button");

   /* Verbind een vernietigingsevent aan het venster. */
   gtk_signal_connect (GTK_OBJECT (window), "destroy",
                       GTK_SIGNAL_FUNC(gtk_main_quit), NULL);
   
   /* Maakt een toggle button */ 
   button=gtk_toggle_button_new_with_label("I'm a toggle button");
   
   /* Voeg de knop toe aan het venster */
   gtk_container_add(GTK_CONTAINER(window),button);

   /* Verbind de "toggled" event aan de knop */ 
   gtk_signal_connect (GTK_OBJECT (button), "toggled",
                       GTK_SIGNAL_FUNC(togg),(gpointer *)button);

   gtk_widget_show(button);
   gtk_widget_show (window);
   
   gtk_main ();
   return(0);
}

Het keuzevakje

Het keuzevakje is een subklasse van de toggle knop. Het kan gebruikt worden om enkele opties te selecteren.

Om een keuzevakje te maken wordt volgende functie gebruikt:

GtkWidget* gtk_check_button_new (void);
GtkWidget* gtk_check_button_new_with_label (const gchar *label);

De uitleg is dezelfde als voor de indrukknop.

Het voorbeeld:

#include <gtk/gtk.h>
void togg(GtkWidget *widget, gpointer *data){
   if (gtk_toggle_button_get_active(GTK_TOGGLE_BUTTON(data)))
       g_print("State is 1\n");
   else
    g_print("State is 0\n");
}

int main( int argc,char *argv[] )
{

    GtkWidget *window;
    GtkWidget *button;

    gtk_init (&argc, &argv);
    
    /* Maak een nieuw venster */
    window = gtk_window_new (GTK_WINDOW_TOPLEVEL);
    gtk_window_set_title (GTK_WINDOW (window), "Check Button");

    /* Verbind een vernietigingsevent aan het venster. */
    gtk_signal_connect (GTK_OBJECT (window), "destroy",
                        GTK_SIGNAL_FUNC(gtk_main_quit), NULL);
   
    /* Maakt een keuzevakje */ 
    button=gtk_check_button_new_with_label("I'm a check button");
   
    /* voeg het vakje toe aan het venster */
    gtk_container_add(GTK_CONTAINER(window),button);

    /* Verbind de "toggled" event aan de knop */ 
    gtk_signal_connect (GTK_OBJECT (button), "toggled",
                        GTK_SIGNAL_FUNC(togg), (gpointer *)button);
    gtk_widget_show(button);
    gtk_widget_show (window);
   
    gtk_main ();
    return(0);
}

Label

Labels laten je toe om waar dan ook in een venster tekst te plaatsen.
Om een label te maken gebruik je gewoon volgende functie:

GtkWidget* gtk_label_new(const gchar *text);

Met de functie

gtk_label_set_text(GtkLabel *label, gchar *text);

kun je ten allen tijde de string op een label aanpassen.

gtk_label_set_justify(GtkLabel *label, GtkJustification jtype);

De gtk_label_set_justify functie wordt gebruik om de tekst op een label uit te vullen. jtype kan volgende waarden hebben:

GTK_JUSTIFY_LEFT om de tekst links uit te vullen
GTK_JUSTIFY_RIGHT om de tekst rechts te plaatsen
GTK_JUSTIFY_CENTER om de tekst te centreren
GTK_JUSTIFY_FILL om de tekst het gehele label te laten vullen.

gtk_label_set_line_wrap (GtkLabel *label,gboolean wrap);

wordt gebruikt om de tekst verdeelbaar te maken, zodat het verdeeld kan worden in verschillende stukken wanneer de tekst langer is dan de plaats die het moet innemen. Wanneer wrap 1 is, zal de tekst overgebracht worden naar de volgende lijn, anders niet.

gtk_label_get(GtkLabel *label, gchar **str)

wordt gebruikt om de tekst op het label in str te krijgen.

ToolTips

Een Tooltip is een tekst die verschijnt wanneer de muis over een widget beweegt. Je kunt bijvoorbeeld een tip op een knop plaatsen en wanneer je muis over die knop beweegt verschijnt de tekst "zend de informatie".

Om dit te doen dient eerst een GtkToolTips widget gemaakt te worden:

GtkToolTips* gtk_tooltips_new();

Dan wordt de tooltip aan een widget gehecht:

gtk_tooltips_set_tip(GtkTooltips *tooltips, GtkWidget *widget, 
                     const gchar *tip_text,const gchar *tip_private);

Een klein voorbeeldje:

#include <gtk/gtk.h>
int main( int argc,char *argv[] )
{
    GtkWidget *window;
    GtkWidget *button;
    GtkTooltips *tip;
    
    gtk_init (&argc, &argv);

    /* Maak een nieuw venster */
    window = gtk_window_new (GTK_WINDOW_TOPLEVEL);
    gtk_window_set_title (GTK_WINDOW (window), "Tooltips");

    /* verbindt een vernietigingsevent aan het venster */
    gtk_signal_connect (GTK_OBJECT (window), "destroy",
                        GTK_SIGNAL_FUNC (gtk_main_quit), NULL);

    /* Maak een knop */
    button=gtk_button_new_with_label("I'm a Button");

    /* Voeg de knop toe aan het venster */
    gtk_container_add(GTK_CONTAINER(window),button);

    /* maak een tooltips aan*/
    tip=gtk_tooltips_new();

    /* verbind deze tooltips aan de knop met tekst */
    gtk_tooltips_set_tip(tip, button, "Click me!",NULL);

    gtk_widget_show(button);
    gtk_widget_show (window);

    gtk_main ();
    return(0);
}

Nog enkele andere functies:

gtk_tooltips_enable (GtkTooltips *tooltips);

stelt de tooltips in werking.

gtk_tooltips_disable (GtkTooltips *tooltips);

Stelt de tooltips buiten werking.

Om welke tooltipdata van een widget dan ook te verkrijgen, hebben we het volgende nodig

GtkTooltipsData* gtk_tooltips_get_data(GtkWidget *widget);

GtkTooltipsData is op de volgende manier een struct:

struct _GtkTooltipsData
{
   GtkTooltips *tooltips;
   GtkWidget *widget;
   gchar *tip_text;
   gchar *tip_private;
   GdkFont *font;
   gint width;
   GList *row;
};

Om de vertraging van de verschijnende tekst aan te passen,

gtk_tooltips_set_delay (GtkTooltips *tip, guint delay)

Combo Box

Een combo box is een aanpasbaar tekstveld gecombineerd met een pull-down menu. Je kunt een waarde ingeven of er één selecteren uit een uitrollende lijst.

Een combo box kan gemaakt worden met

GtkWidget *gtk_combo_new();

En we hebben een lijst met opties nodig die een GList struct is.

GList *glist=NULL;

En de opties kunnen op volgende manier aan de lijst worden toegevoegd

GList *g_list_append(GList *list, gchar *option);

Dan dient de lijst aan de combo box toegevoegd te worden

gtk_combo_set_popdown_strings(GtkCombo *combo, GList *List);

De combo box is klaar. Om de geselecteerde opties te lezen gebruik je:

gchar *gtk_entry_get_text(GtkEntry *entry);

entry is in dit geval GTK_ENTRY(GTK_COMBO(combo)->entry)).

gtk_combo_set_use_arrows(GtkCombo *combo,gint val);

Deze functie wordt gebruikt om ervoor te zorgen dat de opwaartse/neerwaartse pijltjestoetsen op het toetsenbord de waarde op een combo box kunnen aanpassen. wanneer val 0 is, zullen deze toetsen niet werken, anders zullen deze toetsen de waarde aanpassen. Maar waneer de waarde op een combo box verschillend is van de waardes in de lijst, zullen deze toetsen niet werken.

gtk_combo_set_use_arrows_always(GtkCombo *combo,gint val);

Deze functie is dezelfde als gtk_combo_set_use_arrows maar wanneer de waarde op een combo box verschillend is van de waardes in de lijst, zullen deze toetsen toch werken.

gtk_combo_set_value_in_list(GtkCombo *combo, gboolean val, 
                             gboolean ok_if_empty);

Wanneer val 1 is, kun je een waarde in de lijst ingegeven. Wanneer ok_if_empty 1 is mag de waarde leeg gelaten worden.

#include <gtk/gtk.h>
void act(GtkWidget *widget, gpointer *data){ 
   g_print((gchar *)data);
}

int main( int argc,char *argv[] ) {
   GtkWidget *window;
   GtkWidget *combo;
   GtkWidget *button;
   GtkWidget *box;
   GList *list=NULL; 

   list=g_list_append(list,"Slackware");
   list=g_list_append(list,"RedHat");
   list=g_list_append(list,"SuSE");

   gtk_init (&argc, &argv); 
   
   /* Maak een nieuw venster */
   window = gtk_window_new (GTK_WINDOW_TOPLEVEL); 
   gtk_window_set_title (GTK_WINDOW (window), "Combo Box");
   
   /* Verbind een vernietigingsevent aan het venster */
   gtk_signal_connect (GTK_OBJECT (window), "destroy",
                       GTK_SIGNAL_FUNC(gtk_main_quit), NULL); 
   
   /* maak een horizontaal vak */
   box=gtk_hbox_new(1,0);
   gtk_container_add(GTK_CONTAINER(window),box);
   
   /* maak een combo box */ 
   combo=gtk_combo_new();

   /* stel de lijst in */
   gtk_combo_set_popdown_strings(GTK_COMBO(combo),list);

   /* Zorg ervoor dat de pijltjestoetsen werken */
   gtk_combo_set_use_arrows_always(GTK_COMBO(combo),1);

   gtk_box_pack_start(GTK_BOX(box), combo,1,1,1); 

   button=gtk_button_new_with_label("Write it");
   gtk_signal_connect(GTK_OBJECT(button),"clicked",GTK_SIGNAL_FUNC(act), 
             gtk_entry_get_text(GTK_ENTRY(GTK_COMBO(combo)->entry)));
   gtk_box_pack_start(GTK_BOX(box), button,1,1,1);

   gtk_widget_show(box);
   gtk_widget_show(combo);
   gtk_widget_show(button); 
   gtk_widget_show (window);
   
   gtk_main ();
   return(0);
   }

Commentaren zijn altijd welkom.