GTK: Referenz-Buttons

Aus Wikibooks

Programmierung GTK

Ein Button ist ein Steuerelement, das ein Signal versendet, wenn es angeklickt wird.

[Bearbeiten] gtk_button_clicked

Die Funktion gtk_button_clicked löst ein "clicked" Signal für den betreffenden Button aus.

 void gtk_button_clicked (GtkButton *button);

• Parameter
  • button: Ein Zeiger auf einen GtkButton.

Rückgabewert: Diese Funktion besitzt keinen Rückgabewert.

[Bearbeiten] gtk_button_enter

Die Funktion gtk_button_enter löst ein "enter" Signal für den betreffenden Button aus.

 void gtk_button_enter (GtkButton *button);

• Parameter
  • button: Ein Zeiger auf einen GtkButton.

Rückgabewert: Diese Funktion besitzt keinen Rückgabewert.

[Bearbeiten] gtk_button_leave

Die Funktion gtk_button_leave löst ein "leave" Signal für den betreffenden Button aus.

 void gtk_button_leave (GtkButton *button);

• Parameter
  • button: Ein Zeiger auf einen GtkButton.

Rückgabewert: Diese Funktion besitzt keinen Rückgabewert.

[Bearbeiten] gtk_button_new

[Bearbeiten] gtk_button_new

Die Funktion gtk_button_new legt einen neuen Button an.

 GtkWidget* gtk_button_new (void);

• Parameter
  • Diese Funktion besitzt keine Parameter.

Rückgabewert: Ein Zeiger auf einen neuen GtkButton.

[Bearbeiten] gtk_button_new_from_stock

Die Funktion gtk_button_new_from_stock legt einen neuen Button aus einer Vorlage an.

 GtkWidget* gtk_button_new_from_stock (const gchar *stock);

• Parameter
  • stock: Die möglichen Paramter können hier nachgelesen werden.

Rückgabewert: Ein Zeiger auf einen neuen GtkButton.

[Bearbeiten] gtk_button_new_with_label

Die Funktion gtk_button_new_with_label legt einen neuen Button mit Beschriftung an.

 GtkWidget* gtk_button_new_with_label (const gchar *text);

• Parameter
  • text: Ein String, der als Beschriftung des Buttons verwendet werden soll.

Rückgabewert: Ein Zeiger auf einen neuen GtkButton.

[Bearbeiten] gtk_button_new_with_mnemonic

Die Funktion gtk_button_new_with_mnemonic legt einen neuen Button mit Beschriftung und Abkürzung an.
Im String der übergeben wird, wird das erste Zeichen das mit einem Untersrich vorangestellt ist, zur Abkürzung für den Button.
Beim Tastendruck ALT+Abkürzung wird der entsprechende Button aktiviert.

 GtkWidget* gtk_button_new_with_mnemonic (const gchar *text);

• Parameter
  • text: Ein String, der als Beschriftung für denButton verwendet werden soll.

Rückgabewert: Ein Zeiger auf einen neuen GtkButton.

[Bearbeiten] gtk_button_pressed

Die Funktion gtk_button_pressed löst ein "pressed" Signal für den betreffenden Button aus.

 void gtk_button_pressed (GtkButton *button);

• Parameter
  • button: Ein Zeiger auf einen GtkButton.

Rückgabewert: Diese Funktion besitzt keinen Rückgabewert.

[Bearbeiten] gtk_button_released

Die Funktion gtk_button_released löst ein "released" Signal für den betreffenden Button aus.

 void gtk_button_released (GtkButton *button);

• Parameter
  • button: Ein Zeiger auf einen GtkButton.

Rückgabewert: Diese Funktion besitzt keinen Rückgabewert.

[Bearbeiten] gtk_button_set

[Bearbeiten] gtk_button_set_focus_on_click

Über die Funktion gtk_button_set_focus_on_click kann bestimmt werden, ob der Button den Fokus bekommt, wenn er angeklickt wird.

 void gtk_button_set_focus_on_click (GtkButton *button, gboolean focus);

• Parameter
  • button: Ein Zeiger auf einen GtkButton.
  • focus: TRUE für Button erhält Fokus, FALSE für Button erhält nicht automatisch den Fokus.

Rückgabewert: Diese Funktion besitzt keinen Rückgabewert.

[Bearbeiten] gtk_button_set_label

Über die Funktion gtk_button_set_label kann bestimmt werden, welcher Text auf dem Button angezeigt werden soll.

 void gtk_button_set_label (GtkButton *button, const gchar *text);

• Parameter
  • button: Ein Zeiger auf einen GtkButton.
  • text: Ein String, der als Beschriftung für den Button verwendet werden soll.

Rückgabewert: Diese Funktion besitzt keinen Rückgabewert.

[Bearbeiten] gtk_button_set_relief

Über die Funktion gtk_button_set_relief kann bestimmt werden, welcher Text auf dem Button angezeigt werden soll.

 void gtk_button_set_relief (GtkButton *button, GtkReliefStyle style);

• Parameter
  • button: Ein Zeiger auf einen GtkButton.
  • style: Es gibt 3 Möglichkeiten, GTK_RELIEF_NORMAL, GTK_RELIEF_HALF, GTK_RELIEF_NONE. Die Bedeutung dieser Parameter kann hier nachgelesen werden.

Rückgabewert: Diese Funktion besitzt keinen Rückgabewert.