<p><codeclass="literal">xfce_titled_dialog_new_with_buttons</code> has been deprecated since version 4.16 and should not be used in newly-written code.</p>
<p>See the documentation of <ahref="/usr/share/gtk-doc/html/gtk3/GtkDialog.html#gtk-dialog-new-with-buttons"><codeclass="function">gtk_dialog_new_with_buttons()</code></a> for details about the
parameters and the returned dialog.</p>
<divclass="refsect3">
...
...
@@ -279,13 +315,160 @@ the buttons to use an optional named or stock icon.</p>
<p>This function creates a custom action area (of type <ahref="/usr/share/gtk-doc/html/gtk3/GtkButtonBox.html#GtkButtonBox-struct"><spanclass="type">GtkButtonBox</span></a>) and has to
be used in combination with <aclass="link"href="XfceTitledDialog.html#xfce-titled-dialog-add-action-widget"title="xfce_titled_dialog_add_action_widget ()"><spanclass="type">xfce_titled_dialog_add_action_widget</span></a>.</p>
<p>When using the XfceTitledDialogClass directly to create dialogs this function is
useful to keep action widgets out of the <ahref="/usr/share/gtk-doc/html/gtk3/GtkHeaderBar.html#GtkHeaderBar-struct"><spanclass="type">GtkHeaderBar</span></a> in which they would
normally end up by calling <ahref="/usr/share/gtk-doc/html/gtk3/GtkDialog.html#gtk-dialog-add-action-widget"><spanclass="type">gtk_dialog_add_action_widget</span></a>.</p>
<p>This function is a replacement for <ahref="/usr/share/gtk-doc/html/gtk3/GtkDialog.html#gtk-dialog-add-button"><spanclass="type">gtk_dialog_add_button</span></a> and assumes that
you have called <aclass="link"href="XfceTitledDialog.html#xfce-titled-dialog-create-action-area"title="xfce_titled_dialog_create_action_area ()"><spanclass="type">xfce_titled_dialog_create_action_area</span></a> before.</p>
<p>Buttons with <ahref="/usr/share/gtk-doc/html/gtk3/GtkDialog.html#GTK-RESPONSE-HELP:CAPS"><spanclass="type">GTK_RESPONSE_HELP</span></a> will be added to the secondary group of children
(see <ahref="/usr/share/gtk-doc/html/gtk3/GtkButtonBox.html#gtk-button-box-set-child-secondary"><spanclass="type">gtk_button_box_set_child_secondary</span></a> for reference).</p>
<p>This function is a replacement for <ahref="/usr/share/gtk-doc/html/gtk3/GtkDialog.html#gtk-dialog-add-action-widget"><spanclass="type">gtk_dialog_add_action_widget</span></a> and assumes that
you have called <aclass="link"href="XfceTitledDialog.html#xfce-titled-dialog-create-action-area"title="xfce_titled_dialog_create_action_area ()"><spanclass="type">xfce_titled_dialog_create_action_area</span></a> before.</p>
<p>Children with <ahref="/usr/share/gtk-doc/html/gtk3/GtkDialog.html#GTK-RESPONSE-HELP:CAPS"><spanclass="type">GTK_RESPONSE_HELP</span></a> will be added to the secondary group of children
(see <ahref="/usr/share/gtk-doc/html/gtk3/GtkButtonBox.html#gtk-button-box-set-child-secondary"><spanclass="type">gtk_button_box_set_child_secondary</span></a> for reference).</p>
<p>Sets the last widget in the dialog’s action area with the given <emclass="parameter"><code>response_id</code></em>
as the default widget for the dialog. Pressing “Enter” normally activates
the default widget.</p>
<p>This function is a replacement for <ahref="/usr/share/gtk-doc/html/gtk3/GtkDialog.html#gtk-dialog-set-default-response"><spanclass="type">gtk_dialog_set_default_response</span></a>, which does
not work with <aclass="link"href="XfceTitledDialog.html"title="XfceTitledDialog"><spanclass="type">XfceTitledDialog</span></a>.</p>
<p>Returns the subtitle of the <emclass="parameter"><code>titled_dialog</code></em>
, or <ahref="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><codeclass="literal">NULL</code></a>
if no subtitle is displayed in the <emclass="parameter"><code>titled_dialog</code></em>
.</p>
.
This is just a convenience function around <ahref="/usr/share/gtk-doc/html/gtk3/GtkHeaderBar.html#gtk-header-bar-get-subtitle"><spanclass="type">gtk_header_bar_get_subtitle</span></a>.</p>
@@ -318,7 +501,8 @@ xfce_titled_dialog_set_subtitle (<em class="parameter"><code><a class="link" hre
; if
<emclass="parameter"><code>subtitle</code></em>
is <ahref="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><codeclass="literal">NULL</code></a> no subtitle will be displayed by the <emclass="parameter"><code>titled_dialog</code></em>
.</p>
.
This is just a convenience function around <ahref="/usr/share/gtk-doc/html/gtk3/GtkHeaderBar.html#gtk-header-bar-set-subtitle"><spanclass="type">gtk_header_bar_set_subtitle</span></a>.</p>
<aclass="link"href="libxfce4ui-XfceDialogs.html#xfce-dialog-confirm-close-tabs"title="xfce_dialog_confirm_close_tabs ()">xfce_dialog_confirm_close_tabs</a>, function in <aclass="link"href="libxfce4ui-XfceDialogs.html"title="XfceDialogs">XfceDialogs</a>
</dt>
<dd></dd>
<dt>
<aclass="link"href="libxfce4ui-XfceDialogs.html#xfce-dialog-show-error"title="xfce_dialog_show_error ()">xfce_dialog_show_error</a>, function in <aclass="link"href="libxfce4ui-XfceDialogs.html"title="XfceDialogs">XfceDialogs</a>
</dt>
<dd></dd>
...
...
@@ -80,6 +86,10 @@
</dt>
<dd></dd>
<dt>
<aclass="link"href="libxfce4ui-Gtk-Extensions.html#xfce-gicon-from-name"title="xfce_gicon_from_name ()">xfce_gicon_from_name</a>, function in <aclass="link"href="libxfce4ui-Gtk-Extensions.html"title="Gtk Extensions">Gtk Extensions</a>
</dt>
<dd></dd>
<dt>
<aclass="link"href="libxfce4ui-Gtk-Extensions.html#xfce-gtk-button-new-mixed"title="xfce_gtk_button_new_mixed ()">xfce_gtk_button_new_mixed</a>, function in <aclass="link"href="libxfce4ui-Gtk-Extensions.html"title="Gtk Extensions">Gtk Extensions</a>
</dt>
<dd></dd>
...
...
@@ -99,6 +109,11 @@
<aclass="link"href="libxfce4ui-Gtk-Extensions.html#xfce-gtk-window-center-on-active-screen"title="xfce_gtk_window_center_on_active_screen ()">xfce_gtk_window_center_on_active_screen</a>, function in <aclass="link"href="libxfce4ui-Gtk-Extensions.html"title="Gtk Extensions">Gtk Extensions</a>
</dt>
<dd></dd>
<aname="idxI"></a><h3class="title">I</h3>
<dt>
<aclass="link"href="libxfce4ui-Gtk-Extensions.html#xfce-icon-name-from-desktop-id"title="xfce_icon_name_from_desktop_id ()">xfce_icon_name_from_desktop_id</a>, function in <aclass="link"href="libxfce4ui-Gtk-Extensions.html"title="Gtk Extensions">Gtk Extensions</a>
</dt>
<dd></dd>
<aname="idxL"></a><h3class="title">L</h3>
<dt>
<aclass="link"href="libxfce4ui-libxfce4ui-config.html#LIBXFCE4UI-CHECK-VERSION:CAPS"title="LIBXFCE4UI_CHECK_VERSION()">LIBXFCE4UI_CHECK_VERSION</a>, macro in <aclass="link"href="libxfce4ui-libxfce4ui-config.html"title="libxfce4ui config">libxfce4ui config</a>
...
...
@@ -328,6 +343,18 @@
</dt>
<dd></dd>
<dt>
<aclass="link"href="XfceTitledDialog.html#xfce-titled-dialog-add-action-widget"title="xfce_titled_dialog_add_action_widget ()">xfce_titled_dialog_add_action_widget</a>, function in <aclass="link"href="XfceTitledDialog.html"title="XfceTitledDialog">XfceTitledDialog</a>
</dt>
<dd></dd>
<dt>
<aclass="link"href="XfceTitledDialog.html#xfce-titled-dialog-add-button"title="xfce_titled_dialog_add_button ()">xfce_titled_dialog_add_button</a>, function in <aclass="link"href="XfceTitledDialog.html"title="XfceTitledDialog">XfceTitledDialog</a>
</dt>
<dd></dd>
<dt>
<aclass="link"href="XfceTitledDialog.html#xfce-titled-dialog-create-action-area"title="xfce_titled_dialog_create_action_area ()">xfce_titled_dialog_create_action_area</a>, function in <aclass="link"href="XfceTitledDialog.html"title="XfceTitledDialog">XfceTitledDialog</a>
</dt>
<dd></dd>
<dt>
<aclass="link"href="XfceTitledDialog.html#xfce-titled-dialog-get-subtitle"title="xfce_titled_dialog_get_subtitle ()">xfce_titled_dialog_get_subtitle</a>, function in <aclass="link"href="XfceTitledDialog.html"title="XfceTitledDialog">XfceTitledDialog</a>
</dt>
<dd></dd>
...
...
@@ -344,6 +371,10 @@
</dt>
<dd></dd>
<dt>
<aclass="link"href="XfceTitledDialog.html#xfce-titled-dialog-set-default-response"title="xfce_titled_dialog_set_default_response ()">xfce_titled_dialog_set_default_response</a>, function in <aclass="link"href="XfceTitledDialog.html"title="XfceTitledDialog">XfceTitledDialog</a>
</dt>
<dd></dd>
<dt>
<aclass="link"href="XfceTitledDialog.html#xfce-titled-dialog-set-subtitle"title="xfce_titled_dialog_set_subtitle ()">xfce_titled_dialog_set_subtitle</a>, function in <aclass="link"href="XfceTitledDialog.html"title="XfceTitledDialog">XfceTitledDialog</a>
<tdclass="parameter_description"><p>a <ahref="/usr/share/gtk-doc/html/gtk3/GtkContainer.html#GtkContainer-struct"><spanclass="type">GtkContainer</span></a> to move the widget into</p></td>
<p><ahref="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><codeclass="literal">TRUE</code></a> if the widget could be moved, <ahref="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><codeclass="literal">FALSE</code></a> otherwise.</p>
<tdclass="parameter_description"><p>a <ahref="/usr/share/gtk-doc/html/gtk3/GtkContainer.html#GtkContainer-struct"><spanclass="type">GtkContainer</span></a> to move the widget into</p></td>
<p><ahref="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><codeclass="literal">TRUE</code></a> if the widget could be moved, <ahref="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><codeclass="literal">FALSE</code></a> otherwise.</p>
<p><ahref="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><codeclass="literal">NULL</code></a> on error, else the string value of the "Icon" property.</p>
<p>This function will first look for a desktop file of <emclass="parameter"><code>name</code></em>
and if successful
use the value of the "Icon" property to return a <ahref="/usr/share/gtk-doc/html/gio/GIcon.html#GIcon-struct"><spanclass="type">GIcon</span></a>.
If no desktop file of <emclass="parameter"><code>name</code></em>
is found it will fallback to returning a <ahref="/usr/share/gtk-doc/html/gio/GIcon.html#GIcon-struct"><spanclass="type">GIcon</span></a>
based on <ahref="/usr/share/gtk-doc/html/gio/GThemedIcon.html#g-themed-icon-new-with-default-fallbacks"><spanclass="type">g_themed_icon_new_with_default_fallbacks</span></a> and
This allows you to easily create mixed buttons in a dialog.
<emclass="parameter"><code>param1</code></em> is used for the stock_id, <emclass="parameter"><code>param2</code></em> for the label and
<emclass="parameter"><code>param1</code></em> is used for the icon name, <emclass="parameter"><code>param2</code></em> for the label and
<emclass="parameter"><code>param3</code></em> for the response_id. See also <aclass="link"href="libxfce4ui-Gtk-Extensions.html#xfce-gtk-button-new-mixed"title="xfce_gtk_button_new_mixed ()"><codeclass="function">xfce_gtk_button_new_mixed()</code></a>.
<p>Asks the user to visit the online documentation. If confirmed, it will open
the webbrowser and redirect the user to the correct location.</p>
<p>Appart from the <emclass="parameter"><code>component</code></em>
<p>Apart from the <emclass="parameter"><code>component</code></em>
, <emclass="parameter"><code>page</code></em>
and <emclass="parameter"><code>offset</code></em>
the following information
is also send to the server: user language and the <ahref="/usr/share/gtk-doc/html/libxfce4util/libxfce4util-Version-Information.html#xfce-version-string"><codeclass="function">xfce_version_string()</code></a>
is also sent to the server: user language and the <ahref="/usr/share/gtk-doc/html/libxfce4util/libxfce4util-Version-Information.html#xfce-version-string"><codeclass="function">xfce_version_string()</code></a>
is <ahref="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><codeclass="literal">TRUE</code></a> 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 <emclass="parameter"><code>confirm_box_checked</code></em>
and the value at <emclass="parameter"><code>confirm_box_checked</code></em>
after returning records the state of the
checkbox. If <emclass="parameter"><code>show_confirm_box</code></em>
is <ahref="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><codeclass="literal">FALSE</code></a>, <emclass="parameter"><code>confirm_box_checked</code></em>
is ignored and
may be <ahref="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><codeclass="literal">NULL</code></a>.</p>
<tdclass="parameter_description"><p>transient parent of the dialog, or <ahref="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><codeclass="literal">NULL</code></a>. </p></td>
<tdclass="parameter_annotations"><spanclass="annotation">[<acronymtitle="NULL is OK, both for passing and for returning."><spanclass="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<tdclass="parameter_name"><p>num_tabs</p></td>
<tdclass="parameter_description"><p>the number of open tabs for display to user</p></td>
<tdclass="parameter_description"><p>state of confirmation checkbox. </p></td>
<tdclass="parameter_annotations"><spanclass="annotation">[<acronymtitle="NULL is OK, both for passing and for returning."><spanclass="acronym">allow-none</span></acronym>]</span></td>
<p><ahref="/usr/share/gtk-doc/html/gtk3/GtkDialog.html#GTK-RESPONSE-CANCEL:CAPS"><spanclass="type">GTK_RESPONSE_CANCEL</span></a> if cancelled, <ahref="/usr/share/gtk-doc/html/gtk3/GtkDialog.html#GTK-RESPONSE-YES:CAPS"><spanclass="type">GTK_RESPONSE_YES</span></a> if the user
wants to close the window, <ahref="/usr/share/gtk-doc/html/gtk3/GtkDialog.html#GTK-RESPONSE-CLOSE:CAPS"><spanclass="type">GTK_RESPONSE_CLOSE</span></a> if the user wants to close the tab,
and <ahref="/usr/share/gtk-doc/html/gtk3/GtkDialog.html#GTK-RESPONSE-NONE:CAPS"><spanclass="type">GTK_RESPONSE_NONE</span></a> for an error.</p>
</div>
</div>
</div>
<divclass="refsect1">
<aname="libxfce4ui-XfceDialogs.other_details"></a><h2>Types and Values</h2>
<keywordtype="function"name="xfce_titled_dialog_new_with_buttons ()"link="XfceTitledDialog.html#xfce-titled-dialog-new-with-buttons"deprecated="4.16: Use #xfce_titled_dialog_new_with_mixed_buttons instead."/>