This allows you to easily create mixed buttons in a dialog. param1 is used for the stock_id, param2 for the label and param3 for the response_id. See also xfce_gtk_button_new_mixed(). Creates a button with the #GdkPixbuf as button icon. param1 is the #GdkPixbuf, param2 for the label and param3 for the response_id. A new #XfceClipboardManager instance or %NULL if @replace is %FALSE and a clipboard manager is already running. whether or not to replace an existing clipboard manager An opaque structure with only private fields. A convenience function to be connected as a callback for the "text-invalid" signal (for example, using g_connect_swapped) for the simple case where the desired effect of this signal is to set the sensitivity of a single GtkWidget (for example, a GtkButton). a #GtkWidget A convenience function to be connected as a callback for the "text-valid" signal (for example, using g_connect_swapped) for the simple case where the desired effect of this signal is to set the sensitivity of a single GtkWidget (for example, a GtkButton). a #GtkWidget Forces a check of the current input text even when it has not changed. This is useful to force the appropriate signal to be sent to indicate whether the text is a valid filename or not, so that for example any GtkWidgets whose sensitivity is controlled by this can be correctly updated when they are first created. a #XfceFilenameInput instance. Gets the #GtkEntry associated to filename_input A #GtkEntry a #XfceFilenameInput instance. Gets the current text of the widget. the string representing the current text a #XfceFilenameInput instance. The maximum permitted length of a filename. A value of -1 indicates no maximum length. The original name of the file, to be used as the initial text displayed in the GtkEntry. A NULL value indicates no original filename. Signals that the current text is not a valid filename. This signal is emitted whenever the user changes the text and the result is not a valid filename. Signals that the current text is a valid filename. This signal is emitted whenever the user changes the text and the result is a valid filename. Replacement for the deprecated #GtkActionEntry. The idea is to provide a fixed list of #XfceGtkActionEntrys: - use xfce_gtk_translate_action_entries() once to translate the list - use xfce_gtk_accel_map_add_entries() once to register the provided accelerators - use xfce_gtk_get_action_entry_by_id() to find a single entry, e.g. by using a enumeration - use xfce_gtk_*_new_from_action_entry() to create the specific menu- or tool-items from the entry unique identifier for instances of this structure (you might want to use a enum) the unique path, used to identify the accelerator the default key and modifier to trigger the callback linked to the entry the type of the item which should be used for creation text which should be shown in the menu optional tooltip of the item optional icon name which will be used to find a image for the item the callback which will be triggered on activation. The callback has to return %TRUE to signal that the accelerator was activated and handled List of item types which are supported by the #XfceGtkActionEntry. To be extended if required. see #GtkMenuItem see #GtkImageMenuItem see #GtkCheckMenuItem see #GtkRadioMenuItem An opaque struct with only private fields. Gets the application's SM client instance. This is best used with xfce_sm_client_get_option_group() above (and using the returned #GOptionGroup with g_option_context_parse()), as the command line parsing will figure out many of the SM client's required property values for you. If you have already created an #XfceSMClient instance using this function, this will return the same instance, i.e. you should *only* unref the first instance. A new #XfceSMClient instance -transfer full- on the first call only, other calls to this function are transfer none Creates a new SM client instance, allowing the application fine-grained control over the initial properties set. Note that this function does not actually connect to the session manager, so other actions can be taken (such as setting custom properties or connecting signals) before calling xfce_sm_client_connect(). It is recommended to use xfce_sm_client_get_with_argv(), or, if you are using Gtk or Glib's command-line option parser, xfce_sm_client_get_option_group() and xfce_sm_client_get() instead. A new #XfceSMClient instance An XfceSMClientRestartStyle A restart priority The client id used in the previous session The application's working directory A command that can resume the application's saved state The application's .desktop file Creates a new #XfceSMClient instance. It attempts to set all required properties using the app's command line. Note that this function does not actually connect to the session manager, so other actions can be taken (such as setting custom properties or connecting signals) before calling xfce_sm_client_connect(). If you are using Gtk or Glib's command-line option parser, it is recommended that you use xfce_sm_client_get_option_group() and xfce_sm_client_get() instead. A new #XfceSMClient instance The number of arguments passed to main() The argument vector passed to main() An #XfceSMClientRestartStyle A restart priority Gets the XfceSmClient Error Quark. a #GQuark. Constructs a #GOptionGroup suitable for use with Glib's command-line option parser. This function is a bit sneaky in that it will make a copy of the program's argc and argv <emphasis>before</emphasis> GTK+ etc. has a chance to mess around with it, so #XfceSMClient can later construct an accurate restart command. Instead of calling gtk_init() or gtk_init_with_args(), instead you'd do something like: <informalexample><programlisting> GOptionContext *context = g_option_context_new(""); g_option_context_add_group(context, gtk_get_option_group(TRUE)); g_option_context_add_group(context, xfce_sm_client_get_option_group(argc, argv); g_option_context_parse(context, &argc, &argv, NULL); </programlisting></informalexample> Error checking is omitted here for brevity, and of course you could add your app's own options with g_option_context_add_main_entries() or similar. A new #GOptionGroup The application's argument count The application's argument vector Attempts to connect to the session manager. %TRUE on success, %FALSE otherwise. If an error occurs, @error will be set. An #XfceSMClient Disconnects the application from the session manager. <note><para> This may not remove the application from the saved session (if any) if the user later does not choose to save the session when logging out. </para></note> An #XfceSMClient Retrieves the session client's unique ID. This ID can be used to construct a filename used to restore the application's state. Note that this value is only guaranteed to be valid if connected to the session manager. <note><para> Instead of constructing a state filename, it is recommended to use xfce_sm_client_get_state_file(). </para></note> an opaque object-owned string An #XfceSMClient Retrieves the session client's working directory. See xfce_sm_client_set_current_directory() for more information. an object-owned string An #XfceSMClient Retrieves the session client's restart priority. See xfce_sm_client_set_priority() for more information. a value from #G_MININT8 to #G_MAXINT8 An #XfceSMClient Retrieves the session client's restart command. See xfce_sm_client_set_restart_command() for more information. an object-owned string vector An #XfceSMClient Retrieves the session client's restart style. See xfce_sm_client_set_restart_style() for more information. a value from the #XfceSMClientRestartStyle enum An #XfceSMClient Constructs a filename that can be used to restore or save state information. When saving state, ote that this file may already exist (and may have been used for saving previous state for the application), so the application should first remove or empty the file if it requires a fresh state file. On the next application start, this function can be used to check to see if there is any previous saved state, and, if so, the state can be restored from the file. This function will use a standard location and naming scheme and handle state cleanup (setting of the discard command) for you. Before calling this function, the application must have a valid client ID (see xfce_sm_client_get_client_id()). a file name string, owned by the object or %NULL if the session client is disabled. An #XfceSMClient Determines whether or not the application has connected to the session manager. %TRUE if connected to the session manager, %FALSE otherwise An #XfceSMClient Determines whether the application was resumed from a previous session, or if the application has been started fresh with no state information associated with it. %TRUE if resumed from a previous session, %FALSE otherwise An #XfceSMClient Sends a request to the session manager to end the session. Depending on @hint, the session manager may prompt for a certain action (log out, halt, reboot, etc.) or may take the requested action without user intervention. <note><para> The session manager may or may not support all requested actions, and is also free to ignore the requested action. </para></note> An #XfceSMClient The type of shutdown requested Sets the startup working directory of @sm_client to @current_directory. If unset, defaults to the user's home directory. An #XfceSMClient A valid path name Sets the application's .desktop file. In addition to informing the session manager of the .desktop file so it can present localized names and an icon in session listings and the splash screen, this also calls g_set_application_name() and gtk_window_set_default_icon_name() (or gtk_window_set_default_icon_from_file()) if the Name and Icon keys are present, respectively. If a relative path to the file is provided, this function will search the standard application directories as specified by the <ulink type="http" url="http://standards.freedesktop.org/menu-spec/latest/">XDG Desktop Menu Specification</ulink>. An #XfceSMClient The path to the application's .desktop file Sets the startup priority for @sm_client to @priority. Note that the default priority for applications is 50; lower values should be reserved for components of the desktop environment. An #XfceSMClient A 8-bit signed priority value Sets the application's "restart" command, which is used to restart the application and restore any saved state from the previous run. If unset, defaults to the command used to start this instance of the application, with session management related arguments added (if not already present). An #XfceSMClient An argument vector Sets the restart style hint to @restart_style. An #XfceSMClient An #XfceSMClientRestartStyle value Emitted when the application is required to quit. This is not optional: if the client does not quit a short time after receiving this signal, it will likely be terminated in some other way. While not required, the application will usually receive quit-requested before receiving quit. If the application does not connect to this signal, #XfceSMClient will call <function>exit(3)</function> with an exit code of zero on behalf of the application. Informs the application that it will not need to quit. In most cases, quit-cancelled will be emitted a short time after quit-requested. Signals the client that the session manager will soon want the application to quit, perhaps as a part of ending the session (but this should not be assumed). The application can take this opportunity to prompt the user to save any unsaved work to disk. This signal also expects a return value from the handler. If the application wishes to cancel the quit request (perhaps because the user selected "Cancel" in prompts to save unsaved work), it should return %TRUE from the handler. If the application is satisfied with possibly needing to quit soon, the handler should return %FALSE. Signals the client that it should save a copy of its current state such that it could be restarted later in exactly the same state as it is at the time of signal emission. If the state is simple enough to be encoded in the application's command line, xfce_sm_client_set_restart_command() can be used to set that command line. For more complex state data, xfce_sm_client_get_state_file() should be used. The application should attempt to save its state as quickly as possible, and MUST NOT interact with the user as a part of saving state. Allows the application to save extra state information after all other applications in the session have had a chance to save their state. This is mainly used by the window manager to save window positions. Most applications should not need to connect to this signal. Some sample priority values for use with xfce_sm_client_set_priority(). A high priority value. You probably don't want to use this. A priority value for use by the window manager. A priority value for use by applications that place windows on the screen and possibly set window manager struts. A priority value for use by applications that draw on the desktop. A priority value for regular applications. The lowest possible priority value. An enumeration describing how the session manager should restart the application. Only restart the application if it is still running when the session is next saved. Immediately restart the application if it ever quits. Hints to the session manager what kind of shutdown the session manager should perform. Prompt the user for a choice, End the current session, Shut down the computer. Restart the computer. Creates a new #XfceScreensaver object or increases the reference count of the current object. An #XfceScreensaver object, to be released with g_object_unref() when no longer used. Calling this function with @inhibit as %TRUE will prevent the user's screensaver from activating. This is useful when the user is watching a movie or giving a presentation. Calling this function with @inhibit as %FALSE will remove any current screensaver inhibit the #XfceScreensaver object has. the #XfceScreensaver object whether to inhibit the screensaver from activating Attempts to lock the screen, either with one of the screensaver D-Bus proxies, the Xfconf lock command, or one of the fallback scripts such as xdg-screensaver. %TRUE if the lock attempt returns success, %FALSE otherwise. the #XfceScreensaver object Error codes returned by XfceSmCLient functions. Failed to connect to the session manager. Session does not have a valid client id. An opaque struct with only private fields. Allocates a new #XfceTitledDialog instance. the newly allocated #XfceTitledDialog. See the documentation of gtk_dialog_new_with_buttons() for details about the parameters and the returned dialog. Use #xfce_titled_dialog_new_with_mixed_buttons instead. the newly allocated #XfceTitledDialog. title of the dialog, or %NULL. transient parent window of the dialog, or %NULL. from #GtkDialogFlags. stock ID or text to go in first, or %NULL. response ID for the first button, then additional buttons, ending with %NULL. Creates an #XfceTitledDialog using xfce_gtk_button_new_mixed. This allows the buttons to use an optional named or stock icon. the newly allocated #XfceTitledDialog. title of the dialog, or %NULL. transient parent window of the dialog, or %NULL. from #GtkDialogFlags. icon name to go in first, or "" for no icon. text to go in first, or %NULL. response ID for the first button, then additional buttons, ending with %NULL. This function is a replacement for #gtk_dialog_add_action_widget. Children with #GTK_RESPONSE_HELP will be added to the secondary group of children (see #gtk_button_box_set_child_secondary for reference). a #XfceTitledDialog. an activatable widget. response ID for @child. This function is a replacement for #gtk_dialog_add_button. Buttons with #GTK_RESPONSE_HELP will be added to the secondary group of children (see #gtk_button_box_set_child_secondary for reference). the GtkButton widget that was added. a #XfceTitledDialog. text of button. response ID for @child. This function is a no-op since 4.19.3. a #XfceTitledDialog. Returns the subtitle of the @titled_dialog, or %NULL if no subtitle is displayed in the @titled_dialog. This is just a convenience function around #gtk_header_bar_get_subtitle. the subtitle of @titled_dialog, or %NULL. a #XfceTitledDialog. Sets the last widget in the dialog’s action area with the given @response_id as the default widget for the dialog. Pressing “Enter” normally activates the default widget. This function is a replacement for #gtk_dialog_set_default_response, which does not work with #XfceTitledDialog. a #XfceTitledDialog. a response ID Sets the subtitle displayed by @titled_dialog to @subtitle; if @subtitle is %NULL no subtitle will be displayed by the @titled_dialog. This is just a convenience function around #gtk_header_bar_set_subtitle when dialogs use header bars. Otherwise a simple label and separator are shown at the top of dialog. a #XfceTitledDialog. the new subtitle for the @titled_dialog, or %NULL. The subtitle displayed below the main dialog title. Runs a questions dialog that has a 'Cancel' and a 'Confirm' button. The 'Confirm' button text can be set by @action if given. If @stock_id is equal to #GTK_STOCK_YES, the 'Cancel' button becomes a 'No' button. TRUE if the user confirms, else FALSE. transient parent of the dialog, or %NULL. the stock name of the confirm button, for example #GTK_STOCK_YES or #GTK_STOCK_CLEAR. if non-%NULL, this text is used on the confirm button together with the @stock_id icon. secondary text in the dialog. the printf()-style format for the dialog question. argument list for the @primary_format. Runs a dialog to ask the user whether they want to close the whole window, close the current tab, or cancel. If @num_tabs is non-negative, the message to the user will state that there are @num_tabs open tabs. If @num_tabs is negative, then the message to the user will state simply that there are "multiple open tabs". If @show_confirm_box is %TRUE a checkbox is added to the dialog to allow the user to set whether they wish to see this dialog in future. The initial state of the checkbox is determined by the value stored at @confirm_box_checked and the value at @confirm_box_checked after returning records the state of the checkbox. If @show_confirm_box is %FALSE, @confirm_box_checked is ignored and may be %NULL. #GTK_RESPONSE_CANCEL if cancelled, #GTK_RESPONSE_YES if the user wants to close the window, #GTK_RESPONSE_CLOSE if the user wants to close the tab, and #GTK_RESPONSE_NONE for an error. transient parent of the dialog, or %NULL. the number of open tabs for display to user whether to ask the user if this confirmation shall be shown in the future state of confirmation checkbox Displays an error dialog on @parent using the @primary_format as primary message and optionally displaying @error as secondary error text. transient parent of the dialog, or %NULL. a #GError, which gives a more precise description of the problem or %NULL. the printf()-style format for the primary problem description. argument list for the @primary_format. Asks the user to visit the online documentation. If confirmed, it will open the webbrowser and redirect the user to the correct location. Appart from the @component, @page and @offset the following information is also send to the server: user language and the xfce_version_string(). See also: xfce_dialog_show_help_with_version(). transient parent of the dialog, or %NULL. name of the component opening the help page or %NULL. If the value is %NULL the target will be the main page of the documentation website. subpage of the @component on the website or %NULL. anchor offset in @page or %NULL. Asks the user to visit the online documentation. If confirmed, it will open the webbrowser and redirect the user to the correct location. Apart from the @component, @page and @offset the following information is also sent to the server: user language and the xfce_version_string() or @version if set. See also: xfce_dialog_show_help(). transient parent of the dialog, or %NULL. name of the component opening the help page or %NULL. If the value is %NULL the target will be the main page of the documentation website. subpage of the @component on the website or %NULL. anchor offset in @page or %NULL. alternative version, or %NULL to use xfce_version_string(). Displays an information dialog on @parent using the @primary_format as message. transient parent of the dialog, or %NULL. secondary text of the dialog or %NULL. the printf()-style format for the primary problem description. argument list for the @format. Displays a warning dialog on @parent using the @primary_format as message. transient parent of the dialog, or %NULL. secondary text of the dialog or %NULL. the printf()-style format for the primary problem description. argument list for the @format. Similar to gdk_seat_grab but tries to grab the seat five times with 100ms between each attempt. %TRUE on success, %FALSE otherwise. A #GdkSeat. The #GdkWindow which will own the grab. Capabilities that will be grabbed. The cursor to display while the grab is active. If this is %NULL then the normal cursors are used for window and its descendants, and the cursor for window is used elsewhere. Returns the currently active #GdkScreen, that is, the screen which currently contains the pointer. If no active screen was found, the default #GdkScreen is returned. the currently active #GdkScreen. Address to store the monitor number to or %NULL. Returns the width and height of the default #GdkScreen. This is a replacement for gdk_screen_width/gdk_screen_height. a newly created #GdkRectangle containing the width and height of the screen. This function will first look for a desktop file of @name and if successful use the value of the "Icon" property to return a #GIcon. If no desktop file of @name is found it will fallback to returning a #GIcon based on #g_themed_icon_new_with_default_fallbacks and #gtk_icon_theme_lookup_by_gicon. a new #GThemedIcon. Name of the application. This method will connect each accel_path from the #XfceGtkActionEntry in action_entries to its related callback. If the accelerator is pressed, the related callback will be called. the #GtkAccelGroup to connect to array of action_entries to be added size of the action_entries array data which should be passed to the callback of each #XfceGtkActionEntry This method will disconnect each accel_path from the #XfceGtkActionEntry in action_entries. the #GtkAccelGroup to connect to array of action_entries to be added size of the action_entries array Adds the default key of each ActionEntry to the accel_map, if no key was defined for the related accel_path so far. array of action_entries to be added size of the action_entries array 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(). the newly created #GtkButton widget. the name of the stock item. the text of the button, with an underscore in front of the mnemonic character. Convenience method to create a #GtkCheckMenuItem and preconfigure it with the passed parameters. A new #GtkCheckMenuItem. Label to use for the #GtkCheckMenuItem Tooltip to add on the passed item, or NULL Unique path, used to identify the accelerator, or NULL #GCallback which will be triggered on activation, or NULL optional callback parameter, or NULL. boolean value indicating whether the check box is active. #GtkMenuShell on which the item should be appended, or NULL Activates the callback function of the #XfceGtkActionEntry that corresponds to @accel_path. If no such action exists in @entries, then nothing happens. a boolean that is TRUE if the action was found, otherwise it is FALSE the accelerator path of the action that we want to activate a pointer of data that will be passed to the callback if a tab-shortcut is found a #XfceGtkActionEntry[] the number of entries in @entries 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(). the newly created #GtkFrame widget. the text to use as the label of the frame. return location for the frame's container. Creates a widget with xfce_gtk_frame_box_new() and adds the @content #GtkWidget to the frame. the newly created #GtkFrame widget. the text to use as the label of the frame. the #GtkWidget to put inside the frame. Convenience method to find a specific action_entry from an array of action_entries The matching #XfceGtkActionEntry or NULL if not found array of action_entries to be searched size of the action_entries array id of the action entry (usually enum values are used) The Tab key is used to navigate the interface by GTK+ so we need to handle shortcuts with the Tab accelerator manually. Tab sometimes becomes ISO_Left_Tab (e.g. in Ctrl+Shift+Tab) so check both here. a boolean that is GDK_EVENT_STOP (TRUE) if the event was handled, otherwise it is GDK_EVENT_PROPAGATE (FALSE) the #GdkEventKey that might trigger a shortcut the #GtkAccelGroup that will be get queried a pointer of data that will be passed to the callback if a tab-shortcut is found a #XfceGtkActionEntry[] the number of entries in @entries Convenience method to create a deprecated #GtkImageMenuItem and preconfigure it with the passed parameters. In order to prevent G_GNUC_BEGIN_IGNORE_DEPRECATIONS in all xfce projects, this method can be used A new #GtkImageMenuItem. Label to use for the #GtkImageMenuItem Tooltip to add on the passed item, or NULL Unique path, used to identify the accelerator, or NULL #GCallback which will be triggered on activation, or NULL optional callback parameter, or NULL. a widget to set as the image for the menu item, or NULL #GtkMenuShell on which the item should be appended, or NULL Convenience method to create a #GtkImageMenuItem and preconfigure it with the passed parameters. A new #GtkImageMenuItem. Label to use for the #GtkImageMenuItem Tooltip to add on the passed item, or NULL Unique path, used to identify the accelerator, or NULL #GCallback which will be triggered on activation, or NULL optional callback parameter, or NULL. name of the icon to use for the #GtkImageMenuItem, or NULL #GtkMenuShell on which the item should be appended, or NULL Sets the `ATK_RELATION_LABEL_FOR` relation on @label for @widget, which means accessiblity tools will identify @label as descriptive item for the specified @widget. a #GtkLabel. a #GtkWidget. Convenience method do add separators, used to prevent code duplication #GtkMenuShell on which the separator should be appended Convenience method do add separators, used to prevent code duplication Use xfce_gtk_menu_append_separator() instead. #GtkMenuShell on which the separator should be appended Convenience method to create a #GtkMenuItem and preconfigure it with the passed parameters. A new #GtkMenuItem. Label to use for the #GtkMenuItem Tooltip to add on the passed item, or NULL Unique path, used to identify the accelerator, or NULL #GCallback which will be triggered on activation, or NULL optional callback parameter, or NULL. #GtkMenuShell on which the item should be appended, or NULL Method to create a menu item from the passed action entry A new #GtkMenuItem or NULL Label to use for the #GtkCheckMenuItem optional callback parameter, or NULL. #GtkMenuShell on which the item should be appended, or NULL Use the passed accel_path show the related #GtkAccelLabel with the correct accelerator on the item. #GtkMenuItem on which the accel label is to set Unique path, used to identify the accelerator, or NULL to show no accelerator 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. %TRUE if the menu could be mapped, %FALSE otherwise. a #GtkMenu. the menu shell containing the triggering menu item, or %NULL. the menu item whose activation triggered the popup, or %NULL. a user supplied function used to position the menu, or %NULL. user supplied data to be passed to func. the mouse button which was pressed to initiate the event. the time at which the activation event occurred. Convenience method to create a #GtkCheckMenuItem and preconfigure it with the passed parameters. In order to simplify usage, a #GtkCheckMenuItem is created and drawn as radio-item A new #GtkCheckMenuItem. Label to use for the #GtkCheckMenuItem Tooltip to add on the passed item, or NULL Unique path, used to identify the accelerator, or NULL #GCallback which will be triggered on activation, or NULL optional callback parameter, or NULL. boolean value indicating whether the check box is active. #GtkMenuShell on which the item should be appended, or NULL Method to create a toggle menu item from the passed action entry A new #GtkMenuItem or NULL Label to use for the #GtkCheckMenuItem optional callback parameter, or NULL. boolean value indicating whether the check box is active. #GtkMenuShell on which the item should be appended, or NULL Method to create a toolbar toggle-button from the passed action entry. A new #GtkToggleToolButton Label to use for the #GtkToggleToolButton optional callback parameter, or %NULL. boolean value indicating whether the toggle is initially active. #GtkToolbar on which the item should be appended Method to create a toolbar button from the passed action entry. A new #GtkToolButton Label to use for the #GtkToolButton optional callback parameter, or %NULL. #GtkToolbar on which the item should be appended Convenience method to translate the label text and tooltip text of an array of action_entries array of action_entries to be translated size of the action_entries array 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(). the #GtkWindow to center. This function can be called to determine if a #GdkWindow is using client-side decorations which is indicated by the _GTK_FRAME_EXTENTS X11 atom. It furthermore sets a pointer of type #GtkBorder to the actual extents. TRUE if a #GdkWindow has the _GTK_FRAME_EXTENTS atom set. A #GdkWindow A pointer to a #GtkBorder to copy to. %NULL on error, else the string value of the "Icon" property. Name of the desktop file. Variables and functions to check the Libxfce4ui version. Create a new dialog as in xfce_message_dialog_new(), then runs the dialog using #gtk_dialog_run and return the response id selected by the user. See xfce_message_dialog_new() for more information. the selected response id. transient parent of the dialog, or %NULL. title of the dialog, or %NULL. gtk stock icon name to show in the dialog. primary text shown in large bold font. secondary text shown in normal font. text for the first button. %NULL ended list of parameters. xfce_message_dialog_new() allows you to easily create Gtk+ message dialogs. It accepts GTK+ stock buttons (deprecated), mixed buttons (using XFCE_BUTTON_TYPE_MIXED) or buttons with a #GdkPixbuf (using XFCE_BUTTON_TYPE_PIXBUF). The buttons are defined by @first_button_text and the next arguments in the following format @type, @param1[, @param2, @param3]. <variablelist> <varlistentry> <term><varname>XFCE_BUTTON_TYPE_MIXED</varname></term> <listitem> <para> This allows you to easily create mixed buttons in a dialog. @param1 is used for the icon name, @param2 for the label and @param3 for the response_id. See also xfce_gtk_button_new_mixed(). </para> </listitem> </varlistentry> <varlistentry> <term><varname>XFCE_BUTTON_TYPE_PIXBUF</varname></term> <listitem> <para> Creates a button with the #GdkPixbuf as button icon. @param1 is the #GdkPixbuf, @param2 for the label and @param3 for the response_id. </para> </listitem> </varlistentry> <varlistentry> <term>Stock Buttons</term> <listitem> <para> When the variables above were not matched, the button type will be a stock button. @type will be the stock id, @param1 is used for the response_id. </para> </listitem> </varlistentry> </variablelist> To clarify this behaviour see the example below. We create a dialog with two stock buttons, a #GdkPixbuf button and a mixed button. <example> <title>Creating a Xfce Message Dialog</title> <programlisting> GdkPixbuf *pixbuf = gdk_pixbuf_new_from_file_at_size (filename, 24, 24); GtkWidget *dialog = xfce_message_dialog (parent, "Question", GTK_STOCK_DIALOG_QUESTION, "There are unsaved modifications", "The menu has been modified, do you want to save it before quitting?", GTK_STOCK_SAVE, GTK_RESPONSE_YES, XFCE_BUTTON_TYPE_MIXED, "edit-delete", _("Forget modifications"), GTK_RESPONSE_APPLY, XFCE_BUTTON_TYPE_PIXBUF, pixbuf, "Quit", GTK_RESPONSE_NO, GTK_STOCK_CANCEL, GTK_RESPONSE_CANCEL, NULL); g_object_unref (G_OBJECT (pixbuf)); </programlisting> </example> The caller is responsible for destroying the dialog with gtk_widget_destroy() when it is no longer required. A new #GtkMessageDialog. transient parent of the dialog, or %NULL. title of the dialog, or %NULL. gtk stock icon name to show in the dialog. primary text shown in large bold font. secondary text shown in normal font. text for the first button. %NULL terminated list of parameters. See xfce_message_dialog_new(), this version takes a va_list for language bindings to use. A new #GtkMessageDialog. transient parent of the dialog, or %NULL. title of the dialog, or %NULL. gtk stock icon name to show in the dialog. primary text shown in large bold font. secondary text shown in normal font. text for the first button. argument list. Like gdk_spawn_on_screen() (GDK 2), but also supports startup notification (if Libxfce4ui was built with startup notification support). %TRUE on success, %FALSE if @error is set. a #GdkScreen or %NULL to use the active screen, see xfce_gdk_screen_get_active(). child's current working directory or %NULL to inherit parent's. child's argument vector. child's environment vector or %NULL to inherit parent's. flags from #GSpawnFlags. #G_SPAWN_DO_NOT_REAP_CHILD is not allowed, use xfce_spawn_on_screen_with_child_watch() if you want a child watch. whether to use startup notification. the timestamp to pass to startup notification, use the event time here if possible to make focus stealing prevention work property. If you don't have direct access to the event time you could use gtk_get_current_event_time() or if nothing is available 0 is valid too. application icon or %NULL. %TRUE if the process should be a child process, %FALSE if it should be reparented to init. Executes the given @command_line and returns %TRUE if the command terminated successfully. Else, the @error is set to the standard error output. %TRUE if the @command_line was executed successfully, %FALSE if @error is set. a #GdkScreen or %NULL to use the active screen, see xfce_gdk_screen_get_active(). command line to run. whether to run @command_line in a terminal. whether to use startup notification. %TRUE if the process should be a child process, %FALSE if it should be reparented to init. Executes the given @command_line and returns %TRUE if the command terminated successfully. Else, the @error is set to the standard error output. Use #xfce_spawn_command_line instead. %TRUE if the @command_line was executed successfully, %FALSE if @error is set. a #GdkScreen or %NULL to use the active screen, see xfce_gdk_screen_get_active(). command line to run. whether to run @command_line in a terminal. whether to use startup notification. Like gdk_spawn_on_screen() (GDK 2), but also supports startup notification (if Libxfce4ui was built with startup notification support). Use #xfce_spawn instead. %TRUE on success, %FALSE if @error is set. a #GdkScreen or %NULL to use the active screen, see xfce_gdk_screen_get_active(). child's current working directory or %NULL to inherit parent's. child's argument vector. child's environment vector or %NULL to inherit parent's. flags from #GSpawnFlags. #G_SPAWN_DO_NOT_REAP_CHILD is not allowed, use xfce_spawn_on_screen_with_child_watch() if you want a child watch. whether to use startup notification. the timestamp to pass to startup notification, use the event time here if possible to make focus stealing prevention work property. If you don't have direct access to the event time you could use gtk_get_current_event_time() or if nothing is available 0 is valid too. application icon or %NULL. Like xfce_spawn_on_screen(), but allows to attach a closure to watch the child's exit status. This because only one g_child_watch_add() is allowed on Unix (per PID) and this is already internally needed for a proper startup notification implementation. <example> <title>Spawning with a child watch</title> <programlisting> static void child_watch_callback (GObject *object, gint status) { g_message ("Child exit status is %d", status); } static void spawn_something (void) { GClosure *child_watch; child_watch = g_cclosure_new_swap (G_CALLBACK (child_watch_callback), object, NULL); xfce_spawn_on_screen_with_child_watch (..., child_watch, ...); } </programlisting> </example> %TRUE on success, %FALSE if @error is set. a #GdkScreen or %NULL to use the active screen, see xfce_gdk_screen_get_active(). child's current working directory or %NULL to inherit parent's. child's argument vector. child's environment vector or %NULL to inherit parent's. flags from #GSpawnFlags. #G_SPAWN_DO_NOT_REAP_CHILD is not allowed, you should use the @child_watch_closure for this. whether to use startup notification. the timestamp to pass to startup notification, use the event time here if possible to make focus stealing prevention work property. If you don't have direct access to the event time you could use gtk_get_current_event_time() or if nothing is available 0 is valid too. application icon or %NULL. closure that is triggered when the child exists or %NULL. Moves a widget from one GtkContainer to another, handling reference count issues to avoid destroying the widget. %TRUE if the widget could be moved, %FALSE otherwise. a #GtkWidget. a #GtkContainer to move the widget into X11 clipboard manager which ensures persistence in the sense of gdk_display_supports_clipboard_persistence(). Xfce-dialogs are a collection of helper dialogs to display the help dialog with link to the docs website, warning, info, and error dialogs and more. A widget to allow filename input for creating or renaming files, with as-you-type checking for invalid filenames. Common used functions that are not provided by the Gdk or Gdk-pixbuf library. Common used functions for GtkWidget's that are not provided by the Gtk+ library #XfceSMClient is a session management client that speaks the X Session Management Protocol (XSMP). It's designed to be easy to use and hide some of the more esoteric feaures of XSMP from the API user. Functions to spawn a command with startup notification support. #XfceTitledDialog is a titled dialog window supporting an optional subtitle and mixed or pixbuf buttons.