LABEL E TOOLTIP

 

Labels

Le Labels (etichette) sono relativamente semplici e non emettono segnali.
Nel caso che invece si voglia raccogliere un segnale da una label questa andrà associata ad una EventBox widget.

Per creare una nuova label si usa la funzione:

GtkWidget *gtk_label_new( char *str );

Il cui unico argomento è la stringa da visualizzare.

Per cambiare il testo della label dopo la sua creazione:

void gtk_label_set_text( GtkLabel *label,
char *str );

Dove il primo argomento e la label creata e il secondo la nuova stringa.

Per ricavare il testo della label si può usare:

void gtk_label_get( GtkLabel *label,
char **str );

Dove il primo argomento è la label creata ed il secondo la stringa ritornata.

Il testo della label può essere giustificato con:

void gtk_label_set_justify( GtkLabel *label,
GtkJustification jtype );

I valori possibili per jtype sono:

GTK_JUSTIFY_LEFT
GTK_JUSTIFY_RIGHT
GTK_JUSTIFY_CENTER (default)
GTK_JUSTIFY_FILL

Si può anche attivare il wrap del testo sulla label con:

void gtk_label_set_line_wrap (GtkLabel *label,
gboolean wrap);

Dove l'argomento wrap può assumere le forme TRUE o FALSE.

Tooltips.

Sono delle piccole stringhe di testo che appaiono quando si lascia il puntatore del mouse su un widget per qualche secondo. Sono facili da usare come risulta dall'esempio.

Le widget che non ricevono eventi non funzionano con i tooltips a meno di non associarle ad una eventbox.

Per creare una nuova Tooltip si può usare la funzione:

GtkTooltips *gtk_tooltips_new( void );

Dopo averla creata si può settare con:

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

Il primo argomento è la Tolltip creata precedentemente, il secondo il widget cui si vuole collegare ed il terzo è il testo che deve contenere ed il quarto è un identificatore per l'help che per ora setteremo a NULL.

Ecco un piccolo esempio:

GtkTooltips *tooltips;
GtkWidget *button;
.
.
.
tooltips = gtk_tooltips_new ();
button = gtk_button_new_with_label ("button 1");
.
.
.
gtk_tooltips_set_tip (tooltips, button, "This is button 1", NULL);

Ci sono altre chiamate per le tolltips che elenchiamo brevemente:

void gtk_tooltips_enable( GtkTooltips *tooltips );

Abilita un set di tooltips

void gtk_tooltips_disable( GtkTooltips *tooltips );

Disabilita un set di tooltips.

void gtk_tooltips_set_delay( GtkTooltips *tooltips,
gint delay );

Setta in millisecondi il tempo che deve trascorrere per far apparire la tooltips.
Il default è 500 (mezzo secondo).

void gtk_tooltips_set_colors( GtkTooltips *tooltips,
GdkColor *background,
GdkColor *foreground );

Setta i colori dello sfondo e del carattere della tooltips.