GTK+ Reference Manual
<<< Previous Page | Home | Up | Next Page >>>

# GtkContainer

## Name

GtkContainer --

## Synopsis

    #include <gtk/gtk.h>

    struct      GtkContainer;
    #define     GTK_IS_RESIZE_CONTAINER         (widget)
    #define     gtk_container_border_width
    void        gtk_container_add               (GtkContainer *container,
                                                 GtkWidget *widget);
    void        gtk_container_remove            (GtkContainer *container,
                                                 GtkWidget *widget);
    void        gtk_container_set_resize_mode   (GtkContainer *container,
                                                 GtkResizeMode resize_mode);
    void        gtk_container_check_resize      (GtkContainer *container);
    void        gtk_container_foreach           (GtkContainer *container,
                                                 GtkCallback callback,
                                                 gpointer callback_data);
    void        gtk_container_foreach_full      (GtkContainer *container,
                                                 GtkCallback callback,
                                                 GtkCallbackMarshal marshal,
                                                 gpointer callback_data,
                                                 GtkDestroyNotify notify);
    GList*      gtk_container_children          (GtkContainer *container);
    gint        gtk_container_focus             (GtkContainer *container,
                                                 GtkDirectionType direction);
    void        gtk_container_set_focus_child   (GtkContainer *container,
                                                 GtkWidget *child);
    void        gtk_container_set_focus_vadjustment
                                                (GtkContainer *container,
                                                 GtkAdjustment *adjustment);
    void        gtk_container_set_focus_hadjustment
                                                (GtkContainer *container,
                                                 GtkAdjustment *adjustment);
    void        gtk_container_register_toplevel (GtkContainer *container);
    void        gtk_container_unregister_toplevel
                                                (GtkContainer *container);
    void        gtk_container_resize_children   (GtkContainer *container);
    GtkType     gtk_container_child_type        (GtkContainer *container);
    void        gtk_container_add_child_arg_type
                                                (const gchar *arg_name,
                                                 GtkType arg_type,
                                                 guint arg_flags,
                                                 guint arg_id);
    GtkArg*     gtk_container_query_child_args  (GtkType class_type,
                                                 guint32 **arg_flags,
                                                 guint *nargs);
    void        gtk_container_child_getv        (GtkContainer *container,
                                                 GtkWidget *child,
                                                 guint n_args,
                                                 GtkArg *args);
    void        gtk_container_child_setv        (GtkContainer *container,
                                                 GtkWidget *child,
                                                 guint n_args,
                                                 GtkArg *args);
    void        gtk_container_add_with_args     (GtkContainer *container,
                                                 GtkWidget *widget,
                                                 const gchar *first_arg_name,
                                                 ...);
    void        gtk_container_addv              (GtkContainer *container,
                                                 GtkWidget *widget,
                                                 guint n_args,
                                                 GtkArg *args);
    void        gtk_container_child_set         (GtkContainer *container,
                                                 GtkWidget *child,
                                                 const gchar *first_arg_name,
                                                 ...);
    void        gtk_container_queue_resize      (GtkContainer *container);
    void        gtk_container_clear_resize_widgets
                                                (GtkContainer *container);
    void        gtk_container_arg_set           (GtkContainer *container,
                                                 GtkWidget *child,
                                                 GtkArg *arg,
                                                 GtkArgInfo *info);
    void        gtk_container_arg_get           (GtkContainer *container,
                                                 GtkWidget *child,
                                                 GtkArg *arg,
                                                 GtkArgInfo *info);
    gchar*      gtk_container_child_args_collect
                                                (GtkType object_type,
                                                 GSList **arg_list_p,
                                                 GSList **info_list_p,
                                                 const gchar *first_arg_name,
                                                 va_list args);
    gchar*      gtk_container_child_arg_get_info
                                                (GtkType object_type,
                                                 const gchar *arg_name,
                                                 GtkArgInfo **info_p);
    void        gtk_container_forall            (GtkContainer *container,
                                                 GtkCallback callback,
                                                 gpointer callback_data);
    gchar*      gtk_container_child_composite_name
                                                (GtkContainer *container,
                                                 GtkWidget *child);
    GList*      gtk_container_get_toplevels     (void);
    void        gtk_container_set_border_width  (GtkContainer *container,
                                                 guint border_width);

## Object Hierarchy

      GtkObject
       +----GtkWidget
             +----GtkContainer

## Args

      "border_width"         gulong               : Read / Write
      "resize_mode"          GtkResizeMode        : Read / Write
      "child"                GtkWidget            : Write

## Signal Prototypes

    "add"       void        user_function      (GtkContainer *container,
                                                GtkWidget *widget,
                                                gpointer user_data);
    "remove"    void        user_function      (GtkContainer *container,
                                                GtkWidget *widget,
                                                gpointer user_data);
    "check-resize"
                void        user_function      (GtkContainer *container,
                                                gpointer user_data);
    "focus"     GtkDirectionTypeuser_function      (GtkContainer *container,
                                                GtkDirectionType direction,
                                                gpointer user_data);
    "set-focus-child"
                void        user_function      (GtkContainer *container,
                                                GtkWidget *widget,
                                                gpointer user_data);

## Description

## Details

### struct GtkContainer

    struct GtkContainer;

### GTK_IS_RESIZE_CONTAINER()

    #define GTK_IS_RESIZE_CONTAINER(widget) (GTK_IS_CONTAINER (widget) && ((GtkContainer*) (widget))->resize_mode != GTK_RESIZE_PARENT)

`widget` : |

### gtk_container_border_width

    #define	gtk_container_border_width		gtk_container_set_border_width

### gtk_container_add ()

    void        gtk_container_add               (GtkContainer *container,
                                                 GtkWidget *widget);

`container` : |
`widget` : |

### gtk_container_remove ()

    void        gtk_container_remove            (GtkContainer *container,
                                                 GtkWidget *widget);

`container` : |
`widget` : |

### gtk_container_set_resize_mode ()

    void        gtk_container_set_resize_mode   (GtkContainer *container,
                                                 GtkResizeMode resize_mode);

`container` : |
`resize_mode` : |

### gtk_container_check_resize ()

    void        gtk_container_check_resize      (GtkContainer *container);

`container` : |

### gtk_container_foreach ()

    void        gtk_container_foreach           (GtkContainer *container,
                                                 GtkCallback callback,
                                                 gpointer callback_data);

`container` : |
`callback` : |
`callback_data` : |

### gtk_container_foreach_full ()

    void        gtk_container_foreach_full      (GtkContainer *container,
                                                 GtkCallback callback,
                                                 GtkCallbackMarshal marshal,
                                                 gpointer callback_data,
                                                 GtkDestroyNotify notify);

`container` : |
`callback` : |
`marshal` : |
`callback_data` : |
`notify` : |

### gtk_container_children ()

    GList*      gtk_container_children          (GtkContainer *container);

`container` : |
Returns : |

### gtk_container_focus ()

    gint        gtk_container_focus             (GtkContainer *container,
                                                 GtkDirectionType direction);

`container` : |
`direction` : |
Returns : |

### gtk_container_set_focus_child ()

    void        gtk_container_set_focus_child   (GtkContainer *container,
                                                 GtkWidget *child);

`container` : |
`child` : |

### gtk_container_set_focus_vadjustment ()

    void        gtk_container_set_focus_vadjustment
                                                (GtkContainer *container,
                                                 GtkAdjustment *adjustment);

`container` : |
`adjustment` : |

### gtk_container_set_focus_hadjustment ()

    void        gtk_container_set_focus_hadjustment
                                                (GtkContainer *container,
                                                 GtkAdjustment *adjustment);

`container` : |
`adjustment` : |

### gtk_container_register_toplevel ()

    void        gtk_container_register_toplevel (GtkContainer *container);

`container` : |

### gtk_container_unregister_toplevel ()

    void        gtk_container_unregister_toplevel
                                                (GtkContainer *container);

`container` : |

### gtk_container_resize_children ()

    void        gtk_container_resize_children   (GtkContainer *container);

`container` : |

### gtk_container_child_type ()

    GtkType     gtk_container_child_type        (GtkContainer *container);

`container` : |
Returns : |

### gtk_container_add_child_arg_type ()

    void        gtk_container_add_child_arg_type
                                                (const gchar *arg_name,
                                                 GtkType arg_type,
                                                 guint arg_flags,
                                                 guint arg_id);

`arg_name` : |
`arg_type` : |
`arg_flags` : |
`arg_id` : |

### gtk_container_query_child_args ()

    GtkArg*     gtk_container_query_child_args  (GtkType class_type,
                                                 guint32 **arg_flags,
                                                 guint *nargs);

`class_type` : |
`arg_flags` : |
`nargs` : |
Returns : |

### gtk_container_child_getv ()

    void        gtk_container_child_getv        (GtkContainer *container,
                                                 GtkWidget *child,
                                                 guint n_args,
                                                 GtkArg *args);

`container` : |
`child` : |
`n_args` : |
`args` : |

### gtk_container_child_setv ()

    void        gtk_container_child_setv        (GtkContainer *container,
                                                 GtkWidget *child,
                                                 guint n_args,
                                                 GtkArg *args);

`container` : |
`child` : |
`n_args` : |
`args` : |

### gtk_container_add_with_args ()

    void        gtk_container_add_with_args     (GtkContainer *container,
                                                 GtkWidget *widget,
                                                 const gchar *first_arg_name,
                                                 ...);

`container` : |
`widget` : |
`first_arg_name` : |
`...` : |

### gtk_container_addv ()

    void        gtk_container_addv              (GtkContainer *container,
                                                 GtkWidget *widget,
                                                 guint n_args,
                                                 GtkArg *args);

`container` : |
`widget` : |
`n_args` : |
`args` : |

### gtk_container_child_set ()

    void        gtk_container_child_set         (GtkContainer *container,
                                                 GtkWidget *child,
                                                 const gchar *first_arg_name,
                                                 ...);

`container` : |
`child` : |
`first_arg_name` : |
`...` : |

### gtk_container_queue_resize ()

    void        gtk_container_queue_resize      (GtkContainer *container);

`container` : |

### gtk_container_clear_resize_widgets ()

    void        gtk_container_clear_resize_widgets
                                                (GtkContainer *container);

`container` : |

### gtk_container_arg_set ()

    void        gtk_container_arg_set           (GtkContainer *container,
                                                 GtkWidget *child,
                                                 GtkArg *arg,
                                                 GtkArgInfo *info);

`container` : |
`child` : |
`arg` : |
`info` : |

### gtk_container_arg_get ()

    void        gtk_container_arg_get           (GtkContainer *container,
                                                 GtkWidget *child,
                                                 GtkArg *arg,
                                                 GtkArgInfo *info);

`container` : |
`child` : |
`arg` : |
`info` : |

### gtk_container_child_args_collect ()

    gchar*      gtk_container_child_args_collect
                                                (GtkType object_type,
                                                 GSList **arg_list_p,
                                                 GSList **info_list_p,
                                                 const gchar *first_arg_name,
                                                 va_list args);

`object_type` : |
`arg_list_p` : |
`info_list_p` : |
`first_arg_name` : |
`args` : |
Returns : |

### gtk_container_child_arg_get_info ()

    gchar*      gtk_container_child_arg_get_info
                                                (GtkType object_type,
                                                 const gchar *arg_name,
                                                 GtkArgInfo **info_p);

`object_type` : |
`arg_name` : |
`info_p` : |
Returns : |

### gtk_container_forall ()

    void        gtk_container_forall            (GtkContainer *container,
                                                 GtkCallback callback,
                                                 gpointer callback_data);

`container` : |
`callback` : |
`callback_data` : |

### gtk_container_child_composite_name ()

    gchar*      gtk_container_child_composite_name
                                                (GtkContainer *container,
                                                 GtkWidget *child);

`container` : |
`child` : |
Returns : |

### gtk_container_get_toplevels ()

    GList*      gtk_container_get_toplevels     (void);

Returns : |

### gtk_container_set_border_width ()

    void        gtk_container_set_border_width  (GtkContainer *container,
                                                 guint border_width);

`container` : |
`border_width` : |

## Args

"`border_width`" (gulong : Read / Write)

"`resize_mode`" (GtkResizeMode : Read / Write)

"`child`" (GtkWidget : Write)

## Signals

### The "add" signal

    void        user_function                  (GtkContainer *container,
                                                GtkWidget *widget,
                                                gpointer user_data);

`container` : | the object which received the signal.
`widget` : |
`user_data` : | user data set when the signal handler was connected.

### The "remove" signal

    void        user_function                  (GtkContainer *container,
                                                GtkWidget *widget,
                                                gpointer user_data);

`container` : | the object which received the signal.
`widget` : |
`user_data` : | user data set when the signal handler was connected.

### The "check-resize" signal

    void        user_function                  (GtkContainer *container,
                                                gpointer user_data);

`container` : | the object which received the signal.
`user_data` : | user data set when the signal handler was connected.

### The "focus" signal

    GtkDirectionTypeuser_function                  (GtkContainer *container,
                                                GtkDirectionType direction,
                                                gpointer user_data);

`container` : | the object which received the signal.
`direction` : |
`user_data` : | user data set when the signal handler was connected.
Returns : |

### The "set-focus-child" signal

    void        user_function                  (GtkContainer *container,
                                                GtkWidget *widget,
                                                gpointer user_data);

`container` : | the object which received the signal.
`widget` : |
`user_data` : | user data set when the signal handler was connected.

<<< Previous Page | Home | Up | Next Page >>>
GtkCombo | GtkCTree