View source for GTK

== General ==

* Every widget in GTK is a <code>GtkWidget</code>.
* GTK widgets use the <code>GObject</code> hierarchy, which allows for single inheritance. All GtkWidgets are ultimately GObjects.
* <code>GtkWidget</code> is an abstract base class for all GTK widgets. Standard practice is to store all widgets as GtkWidgets.
* <code>gtk_widget_show()</code> will only show the widget passed as the parameter. Invisible children will not be shown, and if the widget's parent is invisible then the widget will not be shown until its parent is.
* <code>gtk_widget_hide()</code> only marks the parameter widget as hidden. Although all child widgets are hidden by implication, they are not set as such, and so showing the widget again will result in all of its children being shown.
* <code>gtk_widget_show_all()</code> recursively draws the widget and all its children.
* <code>gtk_widget_hide_all()</code> recursively hides and sets the hidden flag on the widget and all its children.
* <code>gtk_widget_set_sensitive</code> sets a widget as active or inactive. Children take their sensitivity from their parents and any change to the parent will automatically affect the children.
* <code>gtk_window_set_icon_from_file</code> sets the file icon, and will be automatically resized as required.
* Top-level windows are placed by the window manager and so you should not assume any particular position.
* After calling <code>gtk_main()</code>, control of the program cannot be regained until a callback function is initialised.

== Console debugging ==

Data can be sent to the console via <code>g_print</code>.

== Labels ==

* Label text can be set when the label is created: <code>GtkWidget* gtk_label_new(const gchar *str)</code>
* Label text cannot be selected by default. Enable it by calling: <code>void gtk_label_set_selectable(GtkLabel *label, gboolean selectable)</code>. Error messages should always be selectable so that they can be copied and pasted into bug reports, search engines etc.

== Containers ==

* A widget can be added as the child of a container by calling: <code>void gtk_container_add(GtkContainer *container, GtkWidget *child)</code>
* <code>GtkWindow</code> is derived from <code>GtkBin</code>, which can only contain one child. However, that child can be a container itself, which may in turn contain multiple children.

== Signals and callbacks ==

Signals can be connected at any point within the application, including within callback functions. However, it is sensible to initialise any critical callbacks before calling <code>gtk_main()</code>.

The underscore and dash characters are interchangeable in signal names, so "destroy_event" and "destroy-event" refer to the same signal.

<code>g_signal_connect()</code> returns a handler identifier which can be used with the <code>g_signal_handler</code> functions.

Signals are inherited from parent structures.

<code>g_signal_connect</code> requires the following parameters:

# <code>gpointer object</code>: The object to connect the signal to.
# <code>const gchar *signal_name</code>: The name of the signal to be connected.
# <code>GCallBack handler</code>: The name of the callback handler (a function). Must be cast with <code>G_CALLBACK</code>.
# <code>gpointer data</code>: Optional data, can be set to <code>NULL</code>.

== Simple Makefile ==

The following Makefile is sufficient to compile GTK 3 applications using clang on Linux. This assumes that the GTK library has been registered with <code>pkg-config</code>, which will be the case if you have installed your distribution's package.

 CC=clang
 CFLAGS=-Wall -Wextra -Werror $(shell pkg-config gtk+-3.0 --cflags)
 LDFLAGS=$(shell pkg-config gtk+-3.0 --libs)
 SOURCES=helloworld.c
 OBJECTS=$(SOURCES:.c=.o)
 EXECUTABLE=helloworld
 
 all: $(SOURCES) $(EXECUTABLE)
 
 $(EXECUTABLE): $(OBJECTS)
   $(CC) $(LDFLAGS) $(OBJECTS) -o $@
 
 %.o: %.c
    $(CC) $(CFLAGS) -c $< -o $@
 
 clean:
   rm -rf *.o $(EXECUTABLE)

== Articles ==

* [http://ricardo.ecn.wfu.edu/~cottrell/cross-gtk/ Building GTK apps for MS Windows on Linux]
* [http://zetcode.com/tutorials/gtktutorial/ GTK+ tutorial]
* [http://www.wikivs.com/wiki/GTK_vs_Qt GTK vs Qt]

[[Category:Programming]]