![]() |
![]() |
![]() |
libxfce4panel Reference Manual | ![]() |
---|---|---|---|---|
XfceItembar; GtkWidget* xfce_itembar_new (GtkOrientation orientation); void xfce_itembar_set_orientation (XfceItembar *itembar, GtkOrientation orientation); GtkOrientation xfce_itembar_get_orientation (XfceItembar *itembar); void xfce_itembar_insert (XfceItembar *itembar, GtkWidget *item, int position); void xfce_itembar_append (XfceItembar *itembar, GtkWidget *item); void xfce_itembar_prepend (XfceItembar *itembar, GtkWidget *item); void xfce_itembar_reorder_child (XfceItembar *itembar, GtkWidget *item, int position); void xfce_itembar_set_child_expand (XfceItembar *itembar, GtkWidget *item, gboolean expand); gboolean xfce_itembar_get_child_expand (XfceItembar *itembar, GtkWidget *item); int xfce_itembar_get_n_items (XfceItembar *itembar); int xfce_itembar_get_item_index (XfceItembar *itembar, GtkWidget *item); GtkWidget* xfce_itembar_get_nth_item (XfceItembar *itembar, int n); void xfce_itembar_raise_event_window (XfceItembar *itembar); void xfce_itembar_lower_event_window (XfceItembar *itembar); gboolean xfce_itembar_event_window_is_raised (XfceItembar *itembar); GtkWidget* xfce_itembar_get_item_at_point (XfceItembar *itembar, int x, int y); int xfce_itembar_get_drop_index (XfceItembar *itembar, int x, int y);
GObject +----GInitiallyUnowned +----GtkObject +----GtkWidget +----GtkContainer +----XfceItembar
XfceItembar is a container widget that can hold multiple widgets. The orientation of the bar is configurable and can be changed at any time.
typedef struct _XfceItembar XfceItembar;
The XfceItembar struct contains private data only, and should be accessed using the functions below.
GtkWidget* xfce_itembar_new (GtkOrientation orientation);
|
GtkOrientation for new itembar. |
Returns : |
new XfceItembar widget with orientation .
|
void xfce_itembar_set_orientation (XfceItembar *itembar, GtkOrientation orientation);
Set the orienation of itembar
.
|
an XfceItembar |
|
new GtkOrientation |
GtkOrientation xfce_itembar_get_orientation (XfceItembar *itembar);
|
an XfceItembar |
Returns : |
GtkOrienation of itembar .
|
void xfce_itembar_insert (XfceItembar *itembar, GtkWidget *item, int position);
Insert new item at position
on itembar
.
|
an XfceItembar |
|
GtkWidget to insert |
|
position for item
|
void xfce_itembar_append (XfceItembar *itembar, GtkWidget *item);
Add a new item at the end of itembar
.
|
an XfceItembar |
|
GtkWidget to add |
void xfce_itembar_prepend (XfceItembar *itembar, GtkWidget *item);
Add a new item at the start of itembar
.
|
an XfceItembar |
|
GtkWidget to add |
void xfce_itembar_reorder_child (XfceItembar *itembar, GtkWidget *item, int position);
Move item
to a new position on itembar
.
|
an XfceItembar |
|
a child GtkWidget of itembar
|
|
new index for item
|
void xfce_itembar_set_child_expand (XfceItembar *itembar, GtkWidget *item, gboolean expand);
Sets whether item
should expand when the size of itembar
increases.
|
an XfceItembar |
|
a child GtkWidget of itembar
|
|
whether to expand the item |
gboolean xfce_itembar_get_child_expand (XfceItembar *itembar, GtkWidget *item);
|
an XfceItembar |
|
a child GtkWidget of itembar
|
Returns : |
TRUE if item will expand when the size of itembar increases,
otherwise FALSE .
|
int xfce_itembar_get_n_items (XfceItembar *itembar);
|
an XfceItembar |
Returns : |
the number of items on itembar .
|
int xfce_itembar_get_item_index (XfceItembar *itembar, GtkWidget *item);
|
an XfceItembar |
|
a child GtkWidget of itembar
|
Returns : |
the index of item or -1 if itembar does not contain item .
|
GtkWidget* xfce_itembar_get_nth_item (XfceItembar *itembar, int n);
|
an XfceItembar |
|
a position on the itembar |
Returns : |
the n 's item on itembar , or NULL if the
itembar does not contain an n 'th item.
|
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()
|
an XfceItembar |
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()
|
an XfceItembar |
gboolean xfce_itembar_event_window_is_raised (XfceItembar *itembar);
|
an XfceItembar |
Returns : |
TRUE if event window is raised.
|
GtkWidget* xfce_itembar_get_item_at_point (XfceItembar *itembar, int x, int y);
|
an XfceItembar |
|
x coordinate relative to the itembar window |
|
y coordinate relative to the itembar window |
Returns : |
a GtkWidget or NULL .
|
int xfce_itembar_get_drop_index (XfceItembar *itembar, int x, int 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.
|
an XfceItembar |
|
x coordinate of a point on the itembar |
|
y coordinate of a point on the itembar |
Returns : |
The position corresponding to the point (x , y ) on the
itembar.
|
orientation
" property"orientation" GtkOrientation : Read / Write
The orientation of the XfceItembar.
Default value: GTK_ORIENTATION_HORIZONTAL
expand
" child property"expand" gboolean : Read / Write
Whether the child of the XfceItembar should fill available space.
Default value: FALSE
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 object which emitted the signal |
|
user data set when the signal handler was connected. |
void user_function (XfceItembar *itembar, GtkOrientation orientation, gpointer user_data) : Run First
Emitted when the orientation of the itembar changes.
|
the object which emitted the signal |
|
the new GtkOrientation of the itembar |
|
user data set when the signal handler was connected. |