GtkToolItemGroup

GtkToolItemGroup — A sub container used in a tool palette

Synopsis

#include <gtk/gtk.h>

                    GtkToolItemGroup;
gboolean            gtk_tool_item_group_get_collapsed   (GtkToolItemGroup *group);
GtkToolItem*        gtk_tool_item_group_get_drop_item   (GtkToolItemGroup *group,
                                                         gint x,
                                                         gint y);
PangoEllipsizeMode  gtk_tool_item_group_get_ellipsize   (GtkToolItemGroup *group);
gint                gtk_tool_item_group_get_item_position
                                                        (GtkToolItemGroup *group,
                                                         GtkToolItem *item);
guint               gtk_tool_item_group_get_n_items     (GtkToolItemGroup *group);
const gchar*        gtk_tool_item_group_get_label       (GtkToolItemGroup *group);
GtkWidget *         gtk_tool_item_group_get_label_widget
                                                        (GtkToolItemGroup *group);
GtkToolItem*        gtk_tool_item_group_get_nth_item    (GtkToolItemGroup *group,
                                                         guint index);
GtkReliefStyle      gtk_tool_item_group_get_header_relief
                                                        (GtkToolItemGroup *group);
void                gtk_tool_item_group_insert          (GtkToolItemGroup *group,
                                                         GtkToolItem *item,
                                                         gint position);
GtkWidget*          gtk_tool_item_group_new             (const gchar *label);
void                gtk_tool_item_group_set_collapsed   (GtkToolItemGroup *group,
                                                         gboolean collapsed);
void                gtk_tool_item_group_set_ellipsize   (GtkToolItemGroup *group,
                                                         PangoEllipsizeMode ellipsize);
void                gtk_tool_item_group_set_item_position
                                                        (GtkToolItemGroup *group,
                                                         GtkToolItem *item,
                                                         gint position);
void                gtk_tool_item_group_set_label       (GtkToolItemGroup *group,
                                                         const gchar *label);
void                gtk_tool_item_group_set_label_widget
                                                        (GtkToolItemGroup *group,
                                                         GtkWidget *label_widget);
void                gtk_tool_item_group_set_header_relief
                                                        (GtkToolItemGroup *group,
                                                         GtkReliefStyle style);

Object Hierarchy

  GObject
   +----GInitiallyUnowned
         +----GtkObject
               +----GtkWidget
                     +----GtkContainer
                           +----GtkToolItemGroup

Implemented Interfaces

GtkToolItemGroup implements AtkImplementorIface, GtkBuildable and GtkToolShell.

Properties

  "collapsed"                gboolean              : Read / Write
  "ellipsize"                PangoEllipsizeMode    : Read / Write
  "header-relief"            GtkReliefStyle        : Read / Write
  "label"                    gchar*                : Read / Write
  "label-widget"             GtkWidget*            : Read / Write

Child Properties

  "expand"                   gboolean              : Read / Write
  "fill"                     gboolean              : Read / Write
  "homogeneous"              gboolean              : Read / Write
  "new-row"                  gboolean              : Read / Write
  "position"                 gint                  : Read / Write

Style Properties

  "expander-size"            gint                  : Read
  "header-spacing"           gint                  : Read

Description

A GtkToolItemGroup is used together with GtkToolPalette to add GtkToolItems to a palette like container with different categories and drag and drop support.

Details

GtkToolItemGroup

typedef struct _GtkToolItemGroup GtkToolItemGroup;

This should not be accessed directly. Use the accessor functions below.


gtk_tool_item_group_get_collapsed ()

gboolean            gtk_tool_item_group_get_collapsed   (GtkToolItemGroup *group);

Gets whether group is collapsed or expanded.

group :

a GtkToolItemGroup

Returns :

TRUE if group is collapsed, FALSE if it is expanded

Since 2.20


gtk_tool_item_group_get_drop_item ()

GtkToolItem*        gtk_tool_item_group_get_drop_item   (GtkToolItemGroup *group,
                                                         gint x,
                                                         gint y);

Gets the tool item at position (x, y).

group :

a GtkToolItemGroup

x :

the x position

y :

the y position

Returns :

the GtkToolItem at position (x, y)

Since 2.20


gtk_tool_item_group_get_ellipsize ()

PangoEllipsizeMode  gtk_tool_item_group_get_ellipsize   (GtkToolItemGroup *group);

Gets the ellipsization mode of group.

group :

a GtkToolItemGroup

Returns :

the PangoEllipsizeMode of group

Since 2.20


gtk_tool_item_group_get_item_position ()

gint                gtk_tool_item_group_get_item_position
                                                        (GtkToolItemGroup *group,
                                                         GtkToolItem *item);

Gets the position of item in group as index.

group :

a GtkToolItemGroup

item :

a GtkToolItem

Returns :

the index of item in group or -1 if item is no child of group

Since 2.20


gtk_tool_item_group_get_n_items ()

guint               gtk_tool_item_group_get_n_items     (GtkToolItemGroup *group);

Gets the number of tool items in group.

group :

a GtkToolItemGroup

Returns :

the number of tool items in group

Since 2.20


gtk_tool_item_group_get_label ()

const gchar*        gtk_tool_item_group_get_label       (GtkToolItemGroup *group);

Gets the label of group.

group :

a GtkToolItemGroup

Returns :

the label of group. The label is an internal string of group and must not be modified. Note that NULL is returned if a custom label has been set with gtk_tool_item_group_set_label_widget()

Since 2.20


gtk_tool_item_group_get_label_widget ()

GtkWidget *         gtk_tool_item_group_get_label_widget
                                                        (GtkToolItemGroup *group);

Gets the label widget of group. See gtk_tool_item_group_set_label_widget().

group :

a GtkToolItemGroup

Returns :

the label widget of group

Since 2.20


gtk_tool_item_group_get_nth_item ()

GtkToolItem*        gtk_tool_item_group_get_nth_item    (GtkToolItemGroup *group,
                                                         guint index);

Gets the tool item at index in group.

group :

a GtkToolItemGroup

index :

the index

Returns :

the GtkToolItem at index

Since 2.20


gtk_tool_item_group_get_header_relief ()

GtkReliefStyle      gtk_tool_item_group_get_header_relief
                                                        (GtkToolItemGroup *group);

Gets the relief mode of the header button of group.

group :

a GtkToolItemGroup

Returns :

the GtkReliefStyle

Since 2.20


gtk_tool_item_group_insert ()

void                gtk_tool_item_group_insert          (GtkToolItemGroup *group,
                                                         GtkToolItem *item,
                                                         gint position);

Inserts item at position in the list of children of group.

group :

a GtkToolItemGroup

item :

the GtkToolItem to insert into group

position :

the position of item in group, starting with 0. The position -1 means end of list.

Since 2.20


gtk_tool_item_group_new ()

GtkWidget*          gtk_tool_item_group_new             (const gchar *label);

Creates a new tool item group with label label.

label :

the label of the new group

Returns :

a new GtkToolItemGroup.

Since 2.20


gtk_tool_item_group_set_collapsed ()

void                gtk_tool_item_group_set_collapsed   (GtkToolItemGroup *group,
                                                         gboolean collapsed);

Sets whether the group should be collapsed or expanded.

group :

a GtkToolItemGroup

collapsed :

whether the group should be collapsed or expanded

Since 2.20


gtk_tool_item_group_set_ellipsize ()

void                gtk_tool_item_group_set_ellipsize   (GtkToolItemGroup *group,
                                                         PangoEllipsizeMode ellipsize);

Sets the ellipsization mode which should be used by labels in group.

group :

a GtkToolItemGroup

ellipsize :

the PangoEllipsizeMode labels in group should use

Since 2.20


gtk_tool_item_group_set_item_position ()

void                gtk_tool_item_group_set_item_position
                                                        (GtkToolItemGroup *group,
                                                         GtkToolItem *item,
                                                         gint position);

Sets the position of item in the list of children of group.

group :

a GtkToolItemGroup

item :

the GtkToolItem to move to a new position, should be a child of group.

position :

the new position of item in group, starting with 0. The position -1 means end of list.

Since 2.20


gtk_tool_item_group_set_label ()

void                gtk_tool_item_group_set_label       (GtkToolItemGroup *group,
                                                         const gchar *label);

Sets the label of the tool item group. The label is displayed in the header of the group.

group :

a GtkToolItemGroup

label :

the new human-readable label of of the group

Since 2.20


gtk_tool_item_group_set_label_widget ()

void                gtk_tool_item_group_set_label_widget
                                                        (GtkToolItemGroup *group,
                                                         GtkWidget *label_widget);

Sets the label of the tool item group. The label widget is displayed in the header of the group, in place of the usual label.

group :

a GtkToolItemGroup

label_widget :

the widget to be displayed in place of the usual label

Since 2.20


gtk_tool_item_group_set_header_relief ()

void                gtk_tool_item_group_set_header_relief
                                                        (GtkToolItemGroup *group,
                                                         GtkReliefStyle style);

Set the button relief of the group header. See gtk_button_set_relief() for details.

group :

a GtkToolItemGroup

style :

the GtkReliefStyle

Since 2.20

Property Details

The "collapsed" property

  "collapsed"                gboolean              : Read / Write

Wether the group has been collapsed and items are hidden.

Default value: FALSE


The "ellipsize" property

  "ellipsize"                PangoEllipsizeMode    : Read / Write

Ellipsize for item group headers.

Default value: PANGO_ELLIPSIZE_NONE


The "header-relief" property

  "header-relief"            GtkReliefStyle        : Read / Write

Relief of the group header button.

Default value: GTK_RELIEF_NORMAL


The "label" property

  "label"                    gchar*                : Read / Write

The human-readable title of this item group.

Default value: ""


The "label-widget" property

  "label-widget"             GtkWidget*            : Read / Write

A widget to display in place of the usual label.

Child Property Details

The "expand" child property

  "expand"                   gboolean              : Read / Write

Whether the item should receive extra space when the group grows.

Default value: FALSE


The "fill" child property

  "fill"                     gboolean              : Read / Write

Whether the item should fill the available space.

Default value: TRUE


The "homogeneous" child property

  "homogeneous"              gboolean              : Read / Write

Whether the item should be the same size as other homogeneous items.

Default value: TRUE


The "new-row" child property

  "new-row"                  gboolean              : Read / Write

Whether the item should start a new row.

Default value: FALSE


The "position" child property

  "position"                 gint                  : Read / Write

Position of the item within this group.

Allowed values: >= 0

Default value: 0

Style Property Details

The "expander-size" style property

  "expander-size"            gint                  : Read

Size of the expander arrow.

Allowed values: >= 0

Default value: 16


The "header-spacing" style property

  "header-spacing"           gint                  : Read

Spacing between expander arrow and caption.

Allowed values: >= 0

Default value: 2