XfceItembar

typedef struct _XfceItembar XfceItembar;

The XfceItembar struct contains private data only, and should be accessed using the functions below.

xfce_itembar_new ()

GtkWidget *         xfce_itembar_new                    (GtkOrientation orientation);

Creates a new XfceItembar widget.

xfce_itembar_set_orientation ()

void                xfce_itembar_set_orientation        (XfceItembar *itembar,
                                                         GtkOrientation orientation);

Set the orienation of itembar.

xfce_itembar_get_orientation ()

GtkOrientation      xfce_itembar_get_orientation        (XfceItembar *itembar);

Return the orientation of the XfceItembar.

xfce_itembar_insert ()

void                xfce_itembar_insert                 (XfceItembar *itembar,
                                                         GtkWidget *item,
                                                         gint position);

Insert new item at position on itembar.

xfce_itembar_append ()

void                xfce_itembar_append                 (XfceItembar *itembar,
                                                         GtkWidget *item);

Add a new item at the end of itembar.

xfce_itembar_prepend ()

void                xfce_itembar_prepend                (XfceItembar *itembar,
                                                         GtkWidget *item);

Add a new item at the start of itembar.

xfce_itembar_reorder_child ()

void                xfce_itembar_reorder_child          (XfceItembar *itembar,
                                                         GtkWidget *item,
                                                         gint position);

Move item to a new position on itembar.

xfce_itembar_set_child_expand ()

void                xfce_itembar_set_child_expand       (XfceItembar *itembar,
                                                         GtkWidget *item,
                                                         gboolean expand);

Sets whether item should expand when the size of itembar increases.

xfce_itembar_get_child_expand ()

gboolean            xfce_itembar_get_child_expand       (XfceItembar *itembar,
                                                         GtkWidget *item);

Return if the GtkWidget in the XfceItembar expands when the panel is resized.

xfce_itembar_set_allow_expand ()

void                xfce_itembar_set_allow_expand       (XfceItembar *itembar,
                                                         gboolean allow);

Set whether the 'expand' child property is honored.

See also: xfce_itembar_set_child_expand().

xfce_itembar_get_n_items ()

gint                xfce_itembar_get_n_items            (XfceItembar *itembar);

Return the number of items on a XfceItembar.

xfce_itembar_get_item_index ()

gint                xfce_itembar_get_item_index         (XfceItembar *itembar,
                                                         GtkWidget *item);

The index if the child GtkWidget in a XfceItembar.

xfce_itembar_get_nth_item ()

GtkWidget *         xfce_itembar_get_nth_item           (XfceItembar *itembar,
                                                         gint n);

Return the GtkWidget inside the XfceItembar with the n's index.

xfce_itembar_raise_event_window ()

void                xfce_itembar_raise_event_window     (XfceItembar *itembar);

Raise the event window of itembar. This causes all events, like mouse clicks or key presses to be send to the itembar and not to any item.

See also: xfce_itembar_lower_event_window()

xfce_itembar_lower_event_window ()

void                xfce_itembar_lower_event_window     (XfceItembar *itembar);

Lower the event window of itembar. This causes all events, like mouse clicks or key presses to be send to the items, before reaching the itembar.

See also: xfce_itembar_raise_event_window()

xfce_itembar_event_window_is_raised ()

gboolean            xfce_itembar_event_window_is_raised (XfceItembar *itembar);

Whether the event window of the XfceItembar is raised.

xfce_itembar_get_item_at_point ()

GtkWidget *         xfce_itembar_get_item_at_point      (XfceItembar *itembar,
                                                         gint x,
                                                         gint y);

Return the GtkWidget in the XfceItembar that is below the (x,y) coordinate.

xfce_itembar_get_drop_index ()

gint                xfce_itembar_get_drop_index         (XfceItembar *itembar,
                                                         gint x,
                                                         gint y);

Returns the position corresponding to the indicated point on itembar. This is useful when dragging items to the itembar: this function returns the position a new item should be inserted.

x and y are in itembar coordinates.

The "orientation" property

  "orientation"              GtkOrientation        : Read / Write

The orientation of the XfceItembar.

Default value: GTK_ORIENTATION_HORIZONTAL

The "expand" child property

  "expand"                   gboolean              : Read / Write

Whether the child of the XfceItembar should fill available space.

Default value: FALSE

The "contents-changed" signal

void                user_function                      (XfceItembar *itembar,
                                                        gpointer     user_data)      : Run First

Emitted when the contents of the itembar change, either by adding a child, removing a child, or reordering a child.

The "orientation-changed" signal

void                user_function                      (XfceItembar   *itembar,
                                                        GtkOrientation orientation,
                                                        gpointer       user_data)        : Run First

Emitted when the orientation of the itembar changes.