xfce_gtk_button_new_mixed ()

GtkWidget *
xfce_gtk_button_new_mixed (const gchar *stock_id,
                           const gchar *label);

Creates a new GtkButton containing a mnemonic label and a stock icon. The stock_id could be something like GTK_STOCK_OK or GTK_STOCK_APPLY.

When the stock_id is NULL a normal mnemonic button will be created, when label is NULL a stock button will be created. This behaviour is added for xfce_message_dialog_new().

xfce_gtk_frame_box_new ()

GtkWidget *
xfce_gtk_frame_box_new (const gchar *label,
                        GtkWidget **container_return);

Creates an Xfce-styled frame. The frame is a GtkFrame, without outline and an optional bolded text label. The contents of the frame are indented on the left. The return value is the GtkFrame itself. The container_return is a GtkAlignment widget to which children of the frame should be added.

See also: xfce_gtk_frame_box_new_with_content().

xfce_gtk_frame_box_new_with_content ()

GtkWidget *
xfce_gtk_frame_box_new_with_content (const gchar *label,
                                     GtkWidget *content);

Creates a widget with xfce_gtk_frame_box_new() and adds the content GtkWidget to the frame.

xfce_gtk_window_center_on_active_screen ()

void
xfce_gtk_window_center_on_active_screen
                               (GtkWindow *window);

Determines the screen that contains the pointer and centers the window on it. If it failes to determine the current pointer position, window is centered on the default screen.

This function only works properly if you call it before realizing the window and you haven't set a fixed window position using gtk_window_move().

See also: xfce_gdk_screen_get_active().

xfce_widget_reparent ()

gboolean
xfce_widget_reparent (GtkWidget *widget,
                      GtkWidget *new_parent);

Moves a widget from one GtkContainer to another, handling reference count issues to avoid destroying the widget.

Since: 4.14

xfce_gtk_menu_popup_until_mapped ()

gboolean
xfce_gtk_menu_popup_until_mapped (GtkMenu *menu,
                                  GtkWidget *parent_menu_shell,
                                  GtkWidget *parent_menu_item,
                                  GtkMenuPositionFunc func,
                                  gpointer data,
                                  guint button,
                                  guint32 activate_time);

Attempts to pop up a GtkMenu for a short duration. Unlike the original gtk_menu_popup(), this function will verify that the menu has been mapped or will keep trying for up to 250ms. It will also return a value indicating whether the menu was eventually mapped or not. Following is an excerpt from the GTK+ Documentation on GtkMenu.

Displays a menu and makes it available for selection.

Applications can use this function to display context-sensitive menus, and will typically supply NULL for the parent_menu_shell , parent_menu_item , func and data parameters. The default menu positioning function will position the menu at the current mouse cursor position.

The button parameter should be the mouse button pressed to initiate the menu popup. If the menu popup was initiated by something other than a mouse button press, such as a mouse button release or a keypress, button should be 0.

The activate_time parameter is used to conflict-resolve initiation of concurrent requests for mouse/keyboard grab requests. To function properly, this needs to be the timestamp of the user event (such as a mouse click or key press) that caused the initiation of the popup. Only if no such event is available, gtk_get_current_event_time() can be used instead.

Since: 4.14