#include <dialog.h>

Inheritance diagram for Gtk::Dialog:

Public Member Functions
virtual	~Dialog ()

GtkDialog *	gobj ()
	Provides access to the underlying C GtkObject. More...

const GtkDialog *	gobj () const
	Provides access to the underlying C GtkObject. More...

	Dialog ()

	Dialog (const Glib::ustring &title, bool modal=false, bool use_separator=false)

	Dialog (const Glib::ustring &title, Gtk::Window &parent, bool modal=false, bool use_separator=false)

void	add_action_widget (Widget &child, int response_id)

Button *	add_button (const Glib::ustring &button_text, int response_id)

Button *	add_button (const Gtk::StockID &stock_id, int response_id)

void	set_response_sensitive (int response_id, bool setting=true)

void	set_default_response (int response_id)

Widget *	get_widget_for_response (int response_id)

const Widget *	get_widget_for_response (int response_id) const

int	get_response_for_widget (const Gtk::Widget &widget) const

void	set_has_separator (bool setting=true)

bool	get_has_separator () const

void	set_alternative_button_order_from_array (const Glib::ArrayHandle< int > &new_order)

void	response (int response_id)

int	run ()

ButtonBox *	get_action_area ()

const ButtonBox *	get_action_area () const

VBox *	get_vbox ()

const VBox *	get_vbox () const

Glib::PropertyProxy< bool >	property_has_separator ()

Glib::PropertyProxy_ReadOnly< bool >	property_has_separator () const

Glib::SignalProxy1< void, int >	signal_response ()

Public Member Functions inherited from Gtk::Window
virtual	~Window ()

GtkWindow *	gobj ()
	Provides access to the underlying C GtkObject. More...

const GtkWindow *	gobj () const
	Provides access to the underlying C GtkObject. More...

	Window (WindowType type=WINDOW_TOPLEVEL)

Glib::PropertyProxy_ReadOnly< WindowType >	property_type () const

Glib::PropertyProxy< Glib::ustring >	property_title ()

Glib::PropertyProxy_ReadOnly< Glib::ustring >	property_title () const

Glib::PropertyProxy_WriteOnly< Glib::ustring >	property_startup_id ()

Glib::PropertyProxy< bool >	property_allow_shrink ()

Glib::PropertyProxy_ReadOnly< bool >	property_allow_shrink () const

Glib::PropertyProxy< bool >	property_allow_grow ()

Glib::PropertyProxy_ReadOnly< bool >	property_allow_grow () const

Glib::PropertyProxy< bool >	property_resizable ()

Glib::PropertyProxy_ReadOnly< bool >	property_resizable () const

Glib::PropertyProxy< bool >	property_modal ()

Glib::PropertyProxy_ReadOnly< bool >	property_modal () const

Glib::PropertyProxy< WindowPosition >	property_window_position ()

Glib::PropertyProxy_ReadOnly< WindowPosition >	property_window_position () const

Glib::PropertyProxy< int >	property_default_width ()

Glib::PropertyProxy_ReadOnly< int >	property_default_width () const

Glib::PropertyProxy< int >	property_default_height ()

Glib::PropertyProxy_ReadOnly< int >	property_default_height () const

Glib::PropertyProxy< bool >	property_destroy_with_parent ()

Glib::PropertyProxy_ReadOnly< bool >	property_destroy_with_parent () const

Glib::PropertyProxy< Glib::RefPtr< Gdk::Pixbuf > >	property_icon ()

Glib::PropertyProxy_ReadOnly< Glib::RefPtr< Gdk::Pixbuf > >	property_icon () const

Glib::PropertyProxy< bool >	property_mnemonics_visible ()

Glib::PropertyProxy_ReadOnly< bool >	property_mnemonics_visible () const

Glib::PropertyProxy< Glib::ustring >	property_icon_name ()

Glib::PropertyProxy_ReadOnly< Glib::ustring >	property_icon_name () const

Glib::PropertyProxy< Glib::RefPtr< Gdk::Screen > >	property_screen ()

Glib::PropertyProxy_ReadOnly< Glib::RefPtr< Gdk::Screen > >	property_screen () const

Glib::PropertyProxy_ReadOnly< bool >	property_is_active () const

Glib::PropertyProxy_ReadOnly< bool >	property_has_toplevel_focus () const

Glib::PropertyProxy< GdkWindowTypeHint >	property_type_hint ()

Glib::PropertyProxy_ReadOnly< GdkWindowTypeHint >	property_type_hint () const

Glib::PropertyProxy< bool >	property_skip_taskbar_hint ()

Glib::PropertyProxy_ReadOnly< bool >	property_skip_taskbar_hint () const

Glib::PropertyProxy< bool >	property_skip_pager_hint ()

Glib::PropertyProxy_ReadOnly< bool >	property_skip_pager_hint () const

Glib::PropertyProxy< Glib::ustring >	property_role ()

Glib::PropertyProxy_ReadOnly< Glib::ustring >	property_role () const

Glib::PropertyProxy< bool >	property_decorated ()

Glib::PropertyProxy_ReadOnly< bool >	property_decorated () const

Glib::PropertyProxy< Gdk::Gravity >	property_gravity ()

Glib::PropertyProxy_ReadOnly< Gdk::Gravity >	property_gravity () const

Glib::PropertyProxy< Window * >	property_transient_for ()

Glib::PropertyProxy_ReadOnly< Window * >	property_transient_for () const

Glib::PropertyProxy< double >	property_opacity ()

Glib::PropertyProxy_ReadOnly< double >	property_opacity () const

Glib::PropertyProxy< bool >	property_urgency_hint ()

Glib::PropertyProxy_ReadOnly< bool >	property_urgency_hint () const

Glib::PropertyProxy< bool >	property_accept_focus ()

Glib::PropertyProxy_ReadOnly< bool >	property_accept_focus () const

Glib::PropertyProxy< bool >	property_focus_on_map ()

Glib::PropertyProxy_ReadOnly< bool >	property_focus_on_map () const

Glib::PropertyProxy< bool >	property_deletable ()

Glib::PropertyProxy_ReadOnly< bool >	property_deletable () const

bool	is_toplevel () const

bool	is_popup () const

Glib::RefPtr< Gdk::Window >	get_frame ()

Glib::RefPtr< const Gdk::Window >	get_frame () const

Glib::SignalProxy1< void, Widget * >	signal_set_focus ()

Glib::SignalProxy1< bool, GdkEvent * >	signal_frame_event ()

void	set_title (const Glib::ustring &title)

Glib::ustring	get_title () const

void	set_wmclass (const Glib::ustring &wmclass_name, const Glib::ustring &wmclass_class)

void	set_role (const Glib::ustring &role)

Glib::ustring	get_role () const

void	add_accel_group (const Glib::RefPtr< AccelGroup > &accel_group)

void	remove_accel_group (const Glib::RefPtr< AccelGroup > &accel_group)

void	set_position (WindowPosition position)

bool	activate_focus ()

void	set_focus (Gtk::Widget &focus)

void	unset_focus ()

Widget *	get_focus ()

const Widget *	get_focus () const

void	set_default (Gtk::Widget &default_widget)

void	unset_default ()

bool	activate_default ()

void	set_transient_for (Window &parent)

void	unset_transient_for ()

Window *	get_transient_for ()

const Window *	get_transient_for () const

void	set_opacity (double opacity)

double	get_opacity () const

void	set_type_hint (Gdk::WindowTypeHint hint)

Gdk::WindowTypeHint	get_type_hint () const

void	set_skip_taskbar_hint (bool setting=true)

bool	get_skip_taskbar_hint () const

void	set_skip_pager_hint (bool setting=true)

bool	get_skip_pager_hint () const

void	set_urgency_hint (bool setting=true)

bool	get_urgency_hint () const

void	set_accept_focus (bool setting=true)

bool	get_accept_focus () const

void	set_focus_on_map (bool setting=true)

bool	get_focus_on_map () const

bool	get_destroy_with_parent () const

void	set_mnemonics_visible (bool setting=true)

bool	get_mnemonics_visible () const

void	set_resizable (bool resizable=true)

bool	get_resizable () const

void	set_gravity (Gdk::Gravity gravity)

Gdk::Gravity	get_gravity () const

void	set_geometry_hints (Widget &geometry_widget, const Gdk::Geometry &geometry, Gdk::WindowHints geom_mask)

void	set_screen (const Glib::RefPtr< Gdk::Screen > &screen)

Glib::RefPtr< Gdk::Screen >	get_screen ()

Glib::RefPtr< const Gdk::Screen >	get_screen () const

void	set_has_frame (bool setting=true)

bool	get_has_frame () const

void	set_frame_dimensions (int left, int top, int right, int bottom)

void	get_frame_dimensions (int &left, int &top, int &right, int &bottom) const

void	set_decorated (bool setting=true)

bool	get_decorated () const

void	set_deletable (bool setting=true)

bool	get_deletable () const

Glib::ListHandle< Glib::RefPtr< Gdk::Pixbuf > >	get_icon_list ()

Glib::ListHandle< Glib::RefPtr< const Gdk::Pixbuf > >	get_icon_list () const

void	set_icon_list (const Glib::ListHandle< Glib::RefPtr< Gdk::Pixbuf > > &list)

void	set_icon (const Glib::RefPtr< Gdk::Pixbuf > &icon)

void	set_icon_name (const Glib::ustring &name)

bool	set_icon_from_file (const std::string &filename)

Glib::RefPtr< Gdk::Pixbuf >	get_icon ()

Glib::RefPtr< const Gdk::Pixbuf >	get_icon () const

Glib::ustring	get_icon_name () const

void	set_modal (bool modal=true)

bool	get_modal () const

void	add_mnemonic (guint keyval, Widget &target)

void	remove_mnemonic (guint keyval, Widget &target)

bool	mnemonic_activate (guint keyval, Gdk::ModifierType modifier)

void	set_mnemonic_modifier (Gdk::ModifierType modifier)

Gdk::ModifierType	get_mnemonic_modifier ()

void	present ()

void	present (guint32 timestamp)

void	iconify ()

void	deiconify ()

void	stick ()

void	unstick ()

void	maximize ()

void	unmaximize ()

void	fullscreen ()

void	unfullscreen ()

void	begin_resize_drag (Gdk::WindowEdge edge, int button, int root_x, int root_y, guint32 timestamp)

void	begin_move_drag (int button, int root_x, int root_y, guint32 timestamp)

void	set_default_size (int width, int height)

void	get_default_size (int &width, int &height) const

void	resize (int width, int height)

void	get_size (int &width, int &height) const

void	move (int x, int y)

void	get_position (int &root_x, int &root_y) const

bool	parse_geometry (const Glib::ustring &geometry)

Glib::RefPtr< WindowGroup >	get_group ()

Glib::RefPtr< const WindowGroup >	get_group () const

WindowType	get_window_type () const

void	reshow_with_initial_size ()

void	set_keep_above (bool setting=true)

void	set_keep_below (bool setting=true)

Glib::RefPtr< AccelGroup >	get_accel_group ()

virtual void	raise ()

virtual void	set_manage ()
	Overriden to warn that it doesn't make sense to use Gtk::manage() on this class because it has no parent container. More...

Public Member Functions inherited from Gtk::Bin
virtual	~Bin ()

GtkBin *	gobj ()
	Provides access to the underlying C GtkObject. More...

const GtkBin *	gobj () const
	Provides access to the underlying C GtkObject. More...

Gtk::Widget *	get_child ()

const Gtk::Widget *	get_child () const

void	remove ()

void	add_label (const Glib::ustring &label, bool mnemonic=false, double x_align=0.5, double y_align=0.5)

void	add_label (const Glib::ustring &label, bool mnemonic, AlignmentEnum x_align, AlignmentEnum y_align=ALIGN_CENTER)

void	add_pixmap (const Glib::RefPtr< Gdk::Pixmap > &pixmap, const Glib::RefPtr< Gdk::Bitmap > &mask)

void	add_pixlabel (const Glib::RefPtr< Gdk::Pixmap > &pixmap, const Glib::RefPtr< Gdk::Bitmap > &mask, const Glib::ustring &label, double x_align=0.5, double y_align=0.5)

void	add_pixlabel (const Glib::ustring &pixfile, const Glib::ustring &label, double x_align=0.5, double y_align=0.5)

Public Member Functions inherited from Gtk::Container
virtual	~Container ()

GtkContainer *	gobj ()
	Provides access to the underlying C GtkObject. More...

const GtkContainer *	gobj () const
	Provides access to the underlying C GtkObject. More...

void	set_border_width (guint border_width)

guint	get_border_width () const

virtual void	add (Widget &widget)

void	remove (Widget &widget)

void	set_resize_mode (ResizeMode resize_mode)

ResizeMode	get_resize_mode () const

void	check_resize ()

void	foreach (const ForeachSlot &slot)

Glib::ListHandle< Widget * >	get_children ()
	(internal) Operate on contained items (see foreach()) More...

Glib::ListHandle< const Widget * >	get_children () const

void	propagate_expose (Widget &child, GdkEventExpose *event)

void	set_focus_chain (const Glib::ListHandle< Widget * > &focusable_widgets)

bool	has_focus_chain () const

Glib::ListHandle< Widget * >	get_focus_chain ()

Glib::ListHandle< const Widget * >	get_focus_chain () const

void	unset_focus_chain ()

void	set_reallocate_redraws (bool needs_redraws=true)

void	set_focus_child (Widget &widget)

void	set_focus_vadjustment (Adjustment &adjustment)

Adjustment *	get_focus_vadjustment ()

const Adjustment *	get_focus_vadjustment () const

void	set_focus_hadjustment (Adjustment &adjustment)

Adjustment *	get_focus_hadjustment ()

const Adjustment *	get_focus_hadjustment () const

void	resize_children ()

GType	child_type () const

Glib::SignalProxy1< void, Widget * >	signal_add ()

Glib::SignalProxy1< void, Widget * >	signal_remove ()

Glib::SignalProxy0< void >	signal_check_resize ()

Glib::SignalProxy1< void, Widget * >	signal_set_focus_child ()

void	show_all_children (bool recursive=true)

Public Member Functions inherited from Gtk::Widget
virtual	~Widget ()

GtkWidget *	gobj ()
	Provides access to the underlying C GtkObject. More...

const GtkWidget *	gobj () const
	Provides access to the underlying C GtkObject. More...

bool	set_scroll_adjustments (Adjustment &hadjustment, Adjustment &vadjustment)

void	show ()

void	show_now ()

void	hide ()

void	show_all ()

void	hide_all ()

void	queue_draw ()

void	queue_draw_area (int x, int y, int width, int height)

void	queue_resize ()

Requisition	size_request () const

void	size_request (const Requisition &requisition)

void	size_allocate (const Allocation &allocation)

void	add_accelerator (const Glib::ustring &accel_signal, const Glib::RefPtr< AccelGroup > &accel_group, guint accel_key, Gdk::ModifierType accel_mods, AccelFlags accel_flags)

bool	remove_accelerator (const Glib::RefPtr< AccelGroup > &accel_group, guint accel_key, Gdk::ModifierType accel_mods)

void	set_accel_path (const Glib::ustring &accel_path, const Glib::RefPtr< AccelGroup > &accel_group)

bool	mnemonic_activate (bool group_cycling)

bool	event (GdkEvent *event)

int	send_expose (GdkEvent *event)

bool	send_focus_change (GdkEvent *event)

bool	activate ()

void	reparent (Widget &new_parent)

bool	intersect (const Gdk::Rectangle &area) const

bool	intersect (const Gdk::Rectangle &area, Gdk::Rectangle &intersection) const

Gdk::Region	region_intersect (const Gdk::Region &region) const

void	freeze_child_notify ()

void	child_notify (const Glib::ustring &child_property)

void	thaw_child_notify ()

void	set_can_focus (bool can_focus=true)

bool	get_can_focus () const

bool	can_focus () const

bool	has_focus () const

bool	is_focus () const

void	grab_focus ()

void	set_can_default (bool can_default=true)

bool	get_can_default () const

bool	can_default () const

bool	has_default () const

void	grab_default ()

void	set_receives_default (bool receives_default=true)

bool	get_receives_default () const

bool	has_grab () const

void	add_modal_grab ()

void	remove_modal_grab ()

void	set_name (const Glib::ustring &name)

void	unset_name ()

Glib::ustring	get_name () const

void	set_state (StateType state)

StateType	get_state () const

void	set_sensitive (bool sensitive=true)

bool	get_sensitive () const

bool	is_sensitive () const

void	set_visible (bool visible=true)

bool	get_visible () const

void	set_has_window (bool has_window=true)

bool	get_has_window () const

bool	get_is_toplevel () const

bool	get_is_drawable () const

bool	get_realized () const

bool	get_mapped () const

void	set_app_paintable (bool app_paintable=true)

bool	get_app_paintable () const

void	set_double_buffered (bool double_buffered=true)

bool	get_double_buffered () const

void	set_redraw_on_allocate (bool redraw_on_allocate=true)

void	set_child_visible (bool is_visible=true)

bool	get_child_visible () const

void	set_window (const Glib::RefPtr< Gdk::Window > &window)

Glib::RefPtr< Gdk::Window >	get_window ()

Glib::RefPtr< const Gdk::Window >	get_window () const

Allocation	get_allocation () const

void	set_allocation (const Allocation &allocation)

Container *	get_parent ()

const Container *	get_parent () const

Glib::RefPtr< Gdk::Window >	get_parent_window ()

Glib::RefPtr< const Gdk::Window >	get_parent_window () const

void	set_parent_window (const Glib::RefPtr< const Gdk::Window > &parent_window)

bool	child_focus (DirectionType direction)

bool	keynav_failed (DirectionType direction)

void	error_bell ()

void	set_size_request (int width=-1, int height=-1)

void	get_size_request (int &width, int &height) const

void	set_events (Gdk::EventMask events)

void	add_events (Gdk::EventMask events)

void	set_extension_events (Gdk::ExtensionMode mode)

Gdk::ExtensionMode	get_extension_events () const

Container *	get_toplevel ()

const Container *	get_toplevel () const

Widget *	get_ancestor (GType widget_type)

const Widget *	get_ancestor (GType widget_type) const

Glib::RefPtr< Gdk::Colormap >	get_colormap ()

Glib::RefPtr< Gdk::Visual >	get_visual ()

Glib::RefPtr< Gdk::Screen >	get_screen ()

Glib::RefPtr< const Gdk::Screen >	get_screen () const

bool	has_screen () const

Glib::RefPtr< Gdk::Display >	get_display ()

Glib::RefPtr< const Gdk::Display >	get_display () const

Glib::RefPtr< Gdk::Window >	get_root_window ()

Glib::RefPtr< const Gdk::Window >	get_root_window () const

Glib::RefPtr< Settings >	get_settings ()

Glib::RefPtr< Clipboard >	get_clipboard (const Glib::ustring &selection)

Glib::RefPtr< const Clipboard >	get_clipboard (const Glib::ustring &selection) const

Glib::RefPtr< Gdk::Pixmap >	get_snapshot (Gdk::Rectangle &clip_rect) const

Glib::RefPtr< Gdk::Pixmap >	get_snapshot () const

void	set_colormap (const Glib::RefPtr< const Gdk::Colormap > &colormap)

Gdk::EventMask	get_events () const

void	get_pointer (int &x, int &y) const

bool	is_ancestor (Widget &ancestor) const

bool	translate_coordinates (Widget &dest_widget, int src_x, int src_y, int &dest_x, int &dest_y)

bool	has_rc_style () const

void	set_style (const Glib::RefPtr< Style > &style)

void	unset_style ()

void	ensure_style ()

Glib::RefPtr< Style >	get_style ()

Glib::RefPtr< const Style >	get_style () const

void	modify_style (const Glib::RefPtr< RcStyle > &style)

Glib::RefPtr< RcStyle >	get_modifier_style ()

Glib::RefPtr< const RcStyle >	get_modifier_style () const

void	modify_fg (StateType state, const Gdk::Color &color)

void	modify_bg (StateType state, const Gdk::Color &color)

void	modify_bg_pixmap (StateType state, const Glib::ustring &pixmap_name)

void	modify_text (StateType state, const Gdk::Color &color)

void	modify_base (StateType state, const Gdk::Color &color)

void	modify_cursor (const Gdk::Color &primary, const Gdk::Color &secondary)

void	unset_cursor ()
	See modify_cursor(). More...

void	modify_font (const Pango::FontDescription &font_desc)

void	unset_fg (StateType state)

void	unset_bg (StateType state)

void	unset_text (StateType state)

void	unset_base (StateType state)

void	unset_font ()

template<class PropertyType >
void	get_style_property (const Glib::ustring &the_property_name, PropertyType &value) const

Glib::RefPtr< Pango::Context >	create_pango_context ()

Glib::RefPtr< Pango::Context >	get_pango_context ()

Glib::RefPtr< Pango::Layout >	create_pango_layout (const Glib::ustring &text)

Glib::RefPtr< Gdk::Pixbuf >	render_icon (const StockID &stock_id, IconSize size, const Glib::ustring &detail=Glib::ustring())

void	set_composite_name (const Glib::ustring &name)

void	unset_composite_name ()

Glib::ustring	get_composite_name () const

void	reset_rc_styles ()

void	set_direction (TextDirection dir)

TextDirection	get_direction ()

TextDirection	get_direction () const

void	shape_combine_mask (const Glib::RefPtr< const Gdk::Bitmap > &shape_mask, int offset_x, int offset_y)

void	unset_shape_combine_mask ()

void	input_shape_combine_mask (const Glib::RefPtr< const Gdk::Bitmap > &shape_mask, int offset_x, int offset_y)

void	unset_input_shape_combine_mask ()

void	reset_shapes ()

void	path (Glib::ustring &path, Glib::ustring &path_reversed)
	Compute a widget's path of the form "GtkWindow.MyLabel". More...

void	class_path (Glib::ustring &path, Glib::ustring &path_reversed)

Glib::ListHandle< Widget * >	list_mnemonic_labels ()

Glib::ListHandle< const Widget * >	list_mnemonic_labels () const

void	add_mnemonic_label (Widget &label)

void	remove_mnemonic_label (Widget &label)

void	drag_get_data (const Glib::RefPtr< Gdk::DragContext > &context, Glib::ustring &target, guint32 time)

void	drag_get_data (const Glib::RefPtr< Gdk::DragContext > &context, const Glib::ustring &target, guint32 time)

void	drag_highlight ()

void	drag_unhighlight ()

void	drag_dest_set (DestDefaults flags=DestDefaults(0), Gdk::DragAction actions=Gdk::DragAction(0))

void	drag_dest_set (const ArrayHandle_TargetEntry &targets, DestDefaults flags=DEST_DEFAULT_ALL, Gdk::DragAction actions=Gdk::ACTION_COPY)

void	drag_dest_set_proxy (const Glib::RefPtr< Gdk::Window > &proxy_window, Gdk::DragProtocol protocol, bool use_coordinates)

void	drag_dest_unset ()

Glib::ustring	drag_dest_find_target (const Glib::RefPtr< Gdk::DragContext > &context, const Glib::RefPtr< TargetList > &target_list) const

Glib::ustring	drag_dest_find_target (const Glib::RefPtr< Gdk::DragContext > &context) const

Glib::RefPtr< TargetList >	drag_dest_get_target_list ()

Glib::RefPtr< const TargetList >	drag_dest_get_target_list () const

void	drag_dest_set_target_list (const Glib::RefPtr< TargetList > &target_list)

void	drag_dest_add_text_targets ()

void	drag_dest_add_image_targets ()

void	drag_dest_add_uri_targets ()

void	drag_source_set (const ArrayHandle_TargetEntry &targets, Gdk::ModifierType start_button_mask=Gdk::MODIFIER_MASK, Gdk::DragAction actions=Gdk::ACTION_COPY)

void	drag_source_unset ()

void	drag_source_set_icon (const Glib::RefPtr< Gdk::Colormap > &colormap, const Glib::RefPtr< Gdk::Pixmap > &pixmap, const Glib::RefPtr< Gdk::Bitmap > &mask)

void	drag_source_set_icon (const Glib::RefPtr< Gdk::Pixbuf > &pixbuf)

void	drag_source_set_icon (const StockID &stock_id)

void	drag_source_set_icon (const Glib::ustring &icon_name)

void	drag_source_add_text_targets ()

void	drag_source_add_uri_targets ()

void	drag_source_add_image_targets ()

Glib::RefPtr< Gdk::DragContext >	drag_begin (const Glib::RefPtr< TargetList > &targets, Gdk::DragAction actions, int button, GdkEvent *event)

bool	drag_check_threshold (int start_x, int start_y, int current_x, int current_y)

void	drag_set_as_icon (const Glib::RefPtr< Gdk::DragContext > &context, int hot_x, int hot_y)

void	queue_resize_no_redraw ()

bool	get_no_show_all () const

void	set_no_show_all (bool no_show_all=true)

void	set_parent (Widget &parent)

void	unparent ()

void	map ()

void	unmap ()

void	draw_insertion_cursor (Glib::RefPtr< Gdk::Drawable > drawable, const Gdk::Rectangle &area, const Gdk::Rectangle &location, bool is_primary, TextDirection direction, bool draw_arrow=true)

void	set_tooltip_window (Window &window)

Window *	get_tooltip_window ()

void	trigger_tooltip_query ()

void	set_tooltip_text (const Glib::ustring &text)

Glib::ustring	get_tooltip_text () const

void	set_tooltip_markup (const Glib::ustring &markup)

Glib::ustring	get_tooltip_markup () const

void	set_has_tooltip (bool has_tooltip=TRUE)

bool	get_has_tooltip () const

bool	has_no_window () const

bool	is_realized () const

bool	is_mapped () const

bool	is_toplevel () const

bool	is_drawable () const

bool	is_visible () const

bool	sensitive () const

bool	app_paintable () const

bool	receives_default () const

bool	double_buffered () const

bool	parent_sensitive () const

bool	rc_style () const

bool	is_composite_child () const

WidgetFlags	get_flags () const

void	set_flags (WidgetFlags flags)

void	unset_flags (WidgetFlags flags)

Gtk::StateType	get_saved_state () const

int	get_width () const

int	get_height () const

bool	is_composited () const

Glib::RefPtr< Action >	get_action ()

Glib::RefPtr< const Action >	get_action () const

Requisition	get_requisition () const

Glib::SignalProxy0< void >	signal_show ()

Glib::SignalProxy0< void >	signal_hide ()

Glib::SignalProxy0< void >	signal_map ()
	Emitted on mapping of a widget to the screen. More...

Glib::SignalProxy0< void >	signal_unmap ()

Glib::SignalProxy0< void >	signal_realize ()
	Emitted on realization of a widget. More...

Glib::SignalProxy0< void >	signal_unrealize ()

Glib::SignalProxy1< void, Requisition * >	signal_size_request ()

Glib::SignalProxy1< void, Allocation & >	signal_size_allocate ()

Glib::SignalProxy1< void, Gtk::StateType >	signal_state_changed ()

Glib::SignalProxy1< void, Widget * >	signal_parent_changed ()
	Informs objects that their parent changed. More...

Glib::SignalProxy1< void, Widget * >	signal_hierarchy_changed ()

Glib::SignalProxy1< void, const Glib::RefPtr< Gtk::Style > & >	signal_style_changed ()

Glib::SignalProxy1< void, TextDirection >	signal_direction_changed ()

Glib::SignalProxy1< void, bool >	signal_grab_notify ()

Glib::SignalProxy1< void, GParamSpec * >	signal_child_notify ()

Glib::SignalProxy1< bool, bool >	signal_mnemonic_activate ()

Glib::SignalProxy0< void >	signal_grab_focus ()

Glib::SignalProxy1< bool, DirectionType >	signal_focus ()

Glib::SignalProxy1< bool, GdkEvent * >	signal_event ()

Glib::SignalProxy1< void, GdkEvent * >	signal_event_after ()

Glib::SignalProxy1< bool, GdkEventButton * >	signal_button_press_event ()

Glib::SignalProxy1< bool, GdkEventButton * >	signal_button_release_event ()

Glib::SignalProxy1< bool, GdkEventScroll * >	signal_scroll_event ()

Glib::SignalProxy1< bool, GdkEventMotion * >	signal_motion_notify_event ()

Glib::SignalProxy1< bool, GdkEventAny * >	signal_delete_event ()

Glib::SignalProxy1< bool, GdkEventExpose * >	signal_expose_event ()
	Event triggered by window requiring a refresh. More...

Glib::SignalProxy1< bool, GdkEventKey * >	signal_key_press_event ()

Glib::SignalProxy1< bool, GdkEventKey * >	signal_key_release_event ()

Glib::SignalProxy1< bool, GdkEventCrossing * >	signal_enter_notify_event ()

Glib::SignalProxy1< bool, GdkEventCrossing * >	signal_leave_notify_event ()

Glib::SignalProxy1< bool, GdkEventConfigure * >	signal_configure_event ()

Glib::SignalProxy1< bool, GdkEventFocus * >	signal_focus_in_event ()

Glib::SignalProxy1< bool, GdkEventFocus * >	signal_focus_out_event ()

Glib::SignalProxy1< bool, GdkEventAny * >	signal_map_event ()

Glib::SignalProxy1< bool, GdkEventAny * >	signal_unmap_event ()

Glib::SignalProxy1< bool, GdkEventProperty * >	signal_property_notify_event ()

Glib::SignalProxy1< bool, GdkEventSelection * >	signal_selection_clear_event ()

Glib::SignalProxy1< bool, GdkEventSelection * >	signal_selection_request_event ()

Glib::SignalProxy1< bool, GdkEventSelection * >	signal_selection_notify_event ()

Glib::SignalProxy1< bool, GdkEventProximity * >	signal_proximity_in_event ()

Glib::SignalProxy1< bool, GdkEventProximity * >	signal_proximity_out_event ()

Glib::SignalProxy1< bool, GdkEventVisibility * >	signal_visibility_notify_event ()

Glib::SignalProxy1< bool, GdkEventClient * >	signal_client_event ()

Glib::SignalProxy1< bool, GdkEventAny * >	signal_no_expose_event ()

Glib::SignalProxy1< bool, GdkEventWindowState * >	signal_window_state_event ()

Glib::SignalProxy3< void, SelectionData &, guint, guint >	signal_selection_get ()

Glib::SignalProxy2< void, const SelectionData &, guint >	signal_selection_received ()

Glib::SignalProxy1< void, const Glib::RefPtr< Gdk::DragContext > & >	signal_drag_begin ()

Glib::SignalProxy1< void, const Glib::RefPtr< Gdk::DragContext > & >	signal_drag_end ()

Glib::SignalProxy4< void, const Glib::RefPtr< Gdk::DragContext > &, SelectionData &, guint, guint >	signal_drag_data_get ()

Glib::SignalProxy1< void, const Glib::RefPtr< Gdk::DragContext > & >	signal_drag_data_delete ()

Glib::SignalProxy2< bool, const Glib::RefPtr< Gdk::DragContext > &, DragResult >	signal_drag_failed ()

Glib::SignalProxy2< void, const Glib::RefPtr< Gdk::DragContext > &, guint >	signal_drag_leave ()

Glib::SignalProxy4< bool, const Glib::RefPtr< Gdk::DragContext > &, int, int, guint >	signal_drag_motion ()

Glib::SignalProxy4< bool, const Glib::RefPtr< Gdk::DragContext > &, int, int, guint >	signal_drag_drop ()

Glib::SignalProxy6< void, const Glib::RefPtr< Gdk::DragContext > &, int, int, const SelectionData &, guint, guint >	signal_drag_data_received ()

Glib::SignalProxy1< void, const Glib::RefPtr< Gdk::Screen > & >	signal_screen_changed ()

Glib::SignalProxy0< void >	signal_composited_changed ()

Glib::SignalProxy0< bool >	signal_popup_menu ()

Glib::SignalProxy4< bool, int, int, bool, const Glib::RefPtr< Tooltip > & >	signal_query_tooltip ()

Glib::SignalProxy1< bool, GdkEventGrabBroken * >	signal_grab_broken_event ()

Glib::SignalProxy1< bool, GdkEventExpose * >	signal_damage_event ()

Glib::PropertyProxy< Glib::ustring >	property_name ()

Glib::PropertyProxy_ReadOnly< Glib::ustring >	property_name () const

Glib::PropertyProxy< Container * >	property_parent ()

Glib::PropertyProxy_ReadOnly< Container * >	property_parent () const

Glib::PropertyProxy< int >	property_width_request ()

Glib::PropertyProxy_ReadOnly< int >	property_width_request () const

Glib::PropertyProxy< int >	property_height_request ()

Glib::PropertyProxy_ReadOnly< int >	property_height_request () const

Glib::PropertyProxy< bool >	property_visible ()

Glib::PropertyProxy_ReadOnly< bool >	property_visible () const

Glib::PropertyProxy< bool >	property_sensitive ()

Glib::PropertyProxy_ReadOnly< bool >	property_sensitive () const

Glib::PropertyProxy< bool >	property_app_paintable ()

Glib::PropertyProxy_ReadOnly< bool >	property_app_paintable () const

Glib::PropertyProxy< bool >	property_can_focus ()

Glib::PropertyProxy_ReadOnly< bool >	property_can_focus () const

Glib::PropertyProxy< bool >	property_has_focus ()

Glib::PropertyProxy_ReadOnly< bool >	property_has_focus () const

Glib::PropertyProxy< bool >	property_is_focus ()

Glib::PropertyProxy_ReadOnly< bool >	property_is_focus () const

Glib::PropertyProxy< bool >	property_can_default ()

Glib::PropertyProxy_ReadOnly< bool >	property_can_default () const

Glib::PropertyProxy< bool >	property_has_default ()

Glib::PropertyProxy_ReadOnly< bool >	property_has_default () const

Glib::PropertyProxy< bool >	property_receives_default ()

Glib::PropertyProxy_ReadOnly< bool >	property_receives_default () const

Glib::PropertyProxy_ReadOnly< bool >	property_composite_child () const

Glib::PropertyProxy< Glib::RefPtr< Style > >	property_style ()

Glib::PropertyProxy_ReadOnly< Glib::RefPtr< Style > >	property_style () const

Glib::PropertyProxy< Gdk::EventMask >	property_events ()

Glib::PropertyProxy_ReadOnly< Gdk::EventMask >	property_events () const

Glib::PropertyProxy< Gdk::ExtensionMode >	property_extension_events ()

Glib::PropertyProxy_ReadOnly< Gdk::ExtensionMode >	property_extension_events () const

Glib::PropertyProxy< bool >	property_has_tooltip ()

Glib::PropertyProxy_ReadOnly< bool >	property_has_tooltip () const

Glib::PropertyProxy< Glib::ustring >	property_tooltip_markup ()

Glib::PropertyProxy_ReadOnly< Glib::ustring >	property_tooltip_markup () const

Glib::PropertyProxy< Glib::ustring >	property_tooltip_text ()

Glib::PropertyProxy_ReadOnly< Glib::ustring >	property_tooltip_text () const

Glib::PropertyProxy_ReadOnly< Glib::RefPtr< Gdk::Window > >	property_window () const

Glib::PropertyProxy< bool >	property_no_show_all ()

Glib::PropertyProxy_ReadOnly< bool >	property_no_show_all () const

Glib::PropertyProxy< bool >	property_double_buffered ()

Glib::PropertyProxy_ReadOnly< bool >	property_double_buffered () const

Public Member Functions inherited from Gtk::Object
virtual	~Object ()

GtkObject *	gobj ()
	Provides access to the underlying C GtkObject. More...

const GtkObject *	gobj () const
	Provides access to the underlying C GtkObject. More...

Glib::PropertyProxy< void * >	property_user_data ()

Glib::PropertyProxy_ReadOnly< void * >	property_user_data () const

Static Public Member Functions
static bool	alternative_button_order (const Glib::RefPtr< const Gdk::Screen > &screen)

Static Public Member Functions inherited from Gtk::Window
static void	set_default_icon_list (const Glib::ListHandle< Glib::RefPtr< Gdk::Pixbuf > > &list)

static Glib::ListHandle< Glib::RefPtr< Gdk::Pixbuf > >	get_default_icon_list ()

static void	set_default_icon (const Glib::RefPtr< Gdk::Pixbuf > &icon)

static void	set_default_icon_name (const Glib::ustring &name)

static bool	set_default_icon_from_file (const std::string &filename)

static void	set_auto_startup_notification (bool setting=true)

static Glib::ListHandle< Window * >	list_toplevels ()

Static Public Member Functions inherited from Gtk::Widget
static Widget *	get_current_modal_grab ()

static void	push_colormap (const Glib::RefPtr< const Gdk::Colormap > &cmap)

static void	pop_colormap ()

static void	push_composite_child ()

static void	pop_composite_child ()

static void	set_default_colormap (const Glib::RefPtr< const Gdk::Colormap > &colormap)

static Glib::RefPtr< Style >	get_default_style ()

static Glib::RefPtr< Gdk::Colormap >	get_default_colormap ()

static Glib::RefPtr< Gdk::Visual >	get_default_visual ()

static void	set_default_direction (TextDirection dir)

static TextDirection	get_default_direction ()

static Widget *	drag_get_source_widget (const Glib::RefPtr< Gdk::DragContext > &context)

Protected Member Functions
virtual void	on_response (int response_id)
	This is a default handler for the signal signal_response(). More...

void	construct_ (bool modal, bool use_separator)

Protected Member Functions inherited from Gtk::Window
virtual void	on_set_focus (Widget *focus)
	This is a default handler for the signal signal_set_focus(). More...

virtual bool	on_frame_event (GdkEvent *event)
	This is a default handler for the signal signal_frame_event(). More...

void	destroy_ ()

void	_destroy_c_instance ()

Protected Member Functions inherited from Gtk::Bin
	Bin ()

Protected Member Functions inherited from Gtk::Container
virtual void	on_add (Widget *widget)
	This is a default handler for the signal signal_add(). More...

virtual void	on_remove (Widget *widget)
	This is a default handler for the signal signal_remove(). More...

virtual void	on_check_resize ()
	This is a default handler for the signal signal_check_resize(). More...

virtual void	on_set_focus_child (Widget *widget)
	This is a default handler for the signal signal_set_focus_child(). More...

	Container ()

virtual GType	child_type_vfunc () const

virtual void	forall_vfunc (gboolean include_internals, GtkCallback callback, gpointer callback_data)

virtual char *	composite_name_vfunc (GtkWidget *child)

virtual void	set_child_property_vfunc (GtkWidget child, guint property_id, const GValue value, GParamSpec *pspec)

virtual void	get_child_property_vfunc (GtkWidget child, guint property_id, GValue value, GParamSpec *pspec) const

Glib::PropertyProxy< guint >	property_border_width ()

Glib::PropertyProxy_ReadOnly< guint >	property_border_width () const

Glib::PropertyProxy< ResizeMode >	property_resize_mode ()

Glib::PropertyProxy_ReadOnly< ResizeMode >	property_resize_mode () const

Glib::PropertyProxy_WriteOnly< Widget * >	property_child ()

Protected Member Functions inherited from Gtk::Widget
virtual void	on_show ()
	This is a default handler for the signal signal_show(). More...

virtual void	on_hide ()
	This is a default handler for the signal signal_hide(). More...

virtual void	on_map ()
	This is a default handler for the signal signal_map(). More...

virtual void	on_unmap ()
	This is a default handler for the signal signal_unmap(). More...

virtual void	on_realize ()
	This is a default handler for the signal signal_realize(). More...

virtual void	on_unrealize ()
	This is a default handler for the signal signal_unrealize(). More...

virtual void	on_size_request (Requisition *requisition)
	This is a default handler for the signal signal_size_request(). More...

virtual void	on_size_allocate (Allocation &allocation)
	This is a default handler for the signal signal_size_allocate(). More...

virtual void	on_state_changed (Gtk::StateType previous_state)
	This is a default handler for the signal signal_state_changed(). More...

virtual void	on_parent_changed (Widget *previous_parent)
	This is a default handler for the signal signal_parent_changed(). More...

virtual void	on_hierarchy_changed (Widget *previous_toplevel)
	This is a default handler for the signal signal_hierarchy_changed(). More...

virtual void	on_style_changed (const Glib::RefPtr< Gtk::Style > &previous_style)
	This is a default handler for the signal signal_style_changed(). More...

virtual void	on_direction_changed (TextDirection direction)
	This is a default handler for the signal signal_direction_changed(). More...

virtual void	on_grab_notify (bool was_grabbed)
	This is a default handler for the signal signal_grab_notify(). More...

virtual void	on_child_notify (GParamSpec *pspec)
	This is a default handler for the signal signal_child_notify(). More...

virtual bool	on_mnemonic_activate (bool group_cycling)
	This is a default handler for the signal signal_mnemonic_activate(). More...

virtual void	on_grab_focus ()
	This is a default handler for the signal signal_grab_focus(). More...

virtual bool	on_focus (DirectionType direction)
	This is a default handler for the signal signal_focus(). More...

virtual bool	on_event (GdkEvent *event)
	This is a default handler for the signal signal_event(). More...

virtual bool	on_button_press_event (GdkEventButton *event)
	This is a default handler for the signal signal_button_press_event(). More...

virtual bool	on_button_release_event (GdkEventButton *event)
	This is a default handler for the signal signal_button_release_event(). More...

virtual bool	on_scroll_event (GdkEventScroll *event)
	This is a default handler for the signal signal_scroll_event(). More...

virtual bool	on_motion_notify_event (GdkEventMotion *event)
	This is a default handler for the signal signal_motion_notify_event(). More...

virtual bool	on_delete_event (GdkEventAny *event)
	This is a default handler for the signal signal_delete_event(). More...

virtual bool	on_expose_event (GdkEventExpose *event)
	This is a default handler for the signal signal_expose_event(). More...

virtual bool	on_key_press_event (GdkEventKey *event)
	This is a default handler for the signal signal_key_press_event(). More...

virtual bool	on_key_release_event (GdkEventKey *event)
	This is a default handler for the signal signal_key_release_event(). More...

virtual bool	on_enter_notify_event (GdkEventCrossing *event)
	This is a default handler for the signal signal_enter_notify_event(). More...

virtual bool	on_leave_notify_event (GdkEventCrossing *event)
	This is a default handler for the signal signal_leave_notify_event(). More...

virtual bool	on_configure_event (GdkEventConfigure *event)
	This is a default handler for the signal signal_configure_event(). More...

virtual bool	on_focus_in_event (GdkEventFocus *event)
	This is a default handler for the signal signal_focus_in_event(). More...

virtual bool	on_focus_out_event (GdkEventFocus *event)
	This is a default handler for the signal signal_focus_out_event(). More...

virtual bool	on_map_event (GdkEventAny *event)
	This is a default handler for the signal signal_map_event(). More...

virtual bool	on_unmap_event (GdkEventAny *event)
	This is a default handler for the signal signal_unmap_event(). More...

virtual bool	on_property_notify_event (GdkEventProperty *event)
	This is a default handler for the signal signal_property_notify_event(). More...

virtual bool	on_selection_clear_event (GdkEventSelection *event)
	This is a default handler for the signal signal_selection_clear_event(). More...

virtual bool	on_selection_request_event (GdkEventSelection *event)
	This is a default handler for the signal signal_selection_request_event(). More...

virtual bool	on_selection_notify_event (GdkEventSelection *event)
	This is a default handler for the signal signal_selection_notify_event(). More...

virtual bool	on_proximity_in_event (GdkEventProximity *event)
	This is a default handler for the signal signal_proximity_in_event(). More...

virtual bool	on_proximity_out_event (GdkEventProximity *event)
	This is a default handler for the signal signal_proximity_out_event(). More...

virtual bool	on_visibility_notify_event (GdkEventVisibility *event)
	This is a default handler for the signal signal_visibility_notify_event(). More...

virtual bool	on_client_event (GdkEventClient *event)
	This is a default handler for the signal signal_client_event(). More...

virtual bool	on_no_expose_event (GdkEventAny *event)
	This is a default handler for the signal signal_no_expose_event(). More...

virtual bool	on_window_state_event (GdkEventWindowState *event)
	This is a default handler for the signal signal_window_state_event(). More...

virtual void	on_selection_get (SelectionData &selection_data, guint info, guint time)
	This is a default handler for the signal signal_selection_get(). More...

virtual void	on_selection_received (const SelectionData &selection_data, guint time)
	This is a default handler for the signal signal_selection_received(). More...

virtual void	on_drag_begin (const Glib::RefPtr< Gdk::DragContext > &context)
	This is a default handler for the signal signal_drag_begin(). More...

virtual void	on_drag_end (const Glib::RefPtr< Gdk::DragContext > &context)
	This is a default handler for the signal signal_drag_end(). More...

virtual void	on_drag_data_get (const Glib::RefPtr< Gdk::DragContext > &context, SelectionData &selection_data, guint info, guint time)
	This is a default handler for the signal signal_drag_data_get(). More...

virtual void	on_drag_data_delete (const Glib::RefPtr< Gdk::DragContext > &context)
	This is a default handler for the signal signal_drag_data_delete(). More...

virtual void	on_drag_leave (const Glib::RefPtr< Gdk::DragContext > &context, guint time)
	This is a default handler for the signal signal_drag_leave(). More...

virtual bool	on_drag_motion (const Glib::RefPtr< Gdk::DragContext > &context, int x, int y, guint time)
	This is a default handler for the signal signal_drag_motion(). More...

virtual bool	on_drag_drop (const Glib::RefPtr< Gdk::DragContext > &context, int x, int y, guint time)
	This is a default handler for the signal signal_drag_drop(). More...

virtual void	on_drag_data_received (const Glib::RefPtr< Gdk::DragContext > &context, int x, int y, const SelectionData &selection_data, guint info, guint time)
	This is a default handler for the signal signal_drag_data_received(). More...

virtual void	on_screen_changed (const Glib::RefPtr< Gdk::Screen > &previous_screen)
	This is a default handler for the signal signal_screen_changed(). More...

virtual void	dispatch_child_properties_changed_vfunc (guint p1, GParamSpec **p2)

virtual void	show_all_vfunc ()

virtual void	hide_all_vfunc ()

	Widget ()

void	realize ()

void	unrealize ()

void	set_mapped (bool mapped=true)

void	set_realized (bool realized=true)

void	style_attach ()

void	get_child_requisition (Requisition &requisition) const

void	get_style_property_value (const Glib::ustring &the_property_name, Glib::ValueBase &value) const

void	realize_if_needed ()

Related Functions
(Note that these are not member functions.)
Gtk::Dialog *	wrap (GtkDialog *object, bool take_copy=false)

Related Functions inherited from Gtk::Window
Gtk::Window *	wrap (GtkWindow *object, bool take_copy=false)

Related Functions inherited from Gtk::Bin
Gtk::Bin *	wrap (GtkBin *object, bool take_copy=false)

Related Functions inherited from Gtk::Container
Gtk::Container *	wrap (GtkContainer *object, bool take_copy=false)

Related Functions inherited from Gtk::Widget
Gtk::Widget *	wrap (GtkWidget *object, bool take_copy=false)

Related Functions inherited from Gtk::Object
Gtk::Object *	wrap (GtkObject *object, bool take_copy=false)

Additional Inherited Members
Public Types inherited from Gtk::Container
typedef sigc::slot< void, Widget & >	ForeachSlot

Detailed Description

Create popup windows.

Dialog boxes are a convenient way to prompt the user for a small amount of input, eg. to display a message, ask a question, or anything else that does not require extensive effort on the user's part.

gtkmm treats a dialog as a window split vertically. The top section is a Gtk::VBox, and is where widgets such as a Gtk::Label or a Gtk::Entry should be packed. The bottom area is known as the action_area. This is generally used for packing buttons into the dialog which may perform functions such as cancel, ok, or apply. The two areas are separated by a Gtk::HSeparator.

The dialog can be 'modal' (that is, one which freezes the rest of the application from user input) - this can be specified in the Gtk::Dialog constructor.

When adding buttons using add_button(), clicking the button will emit signal_response() with a "response id" you specified. You are encouraged to use the Gtk::ResponseType enum. If a dialog receives a delete event, the "response" signal will be emitted with a response id of Gtk::RESPONSE_NONE.

If you want to block waiting for a dialog to return before returning control flow to your code, you can call run(). This function enters a recursive main loop and waits for the user to respond to the dialog, returning the response ID corresponding to the button the user clicked.

Definition at line 125 of file dialog.h.

Constructor & Destructor Documentation

◆ ~Dialog()

virtual Gtk::Dialog::~Dialog ( )

virtual

◆ Dialog() [1/3]

Gtk::Dialog::Dialog ( )

◆ Dialog() [2/3]

Gtk::Dialog::Dialog	(	const Glib::ustring &	title,
		bool	modal = `false`,
		bool	use_separator = `false`
	)

explicit

◆ Dialog() [3/3]

Gtk::Dialog::Dialog	(	const Glib::ustring &	title,
		Gtk::Window &	parent,
		bool	modal = `false`,
		bool	use_separator = `false`
	)

Member Function Documentation

◆ add_action_widget()

void Gtk::Dialog::add_action_widget	(	Widget &	child,
		int	response_id
	)

Adds an activatable widget to the action area of a Gtk::Dialog, connecting a signal handler that will emit the Gtk::Dialog::signal_response() signal on the dialog when the widget is activated. The widget is appended to the end of the dialog's action area. If you want to add a non-activatable widget, simply pack it into the action_area field of the Gtk::Dialog struct.

Parameters

child	An activatable widget.
response_id	Response ID for child.

◆ add_button() [1/2]

Button* Gtk::Dialog::add_button	(	const Glib::ustring &	button_text,
		int	response_id
	)

Adds a button with the given text (or a stock button, if button_text is a stock ID) and sets things up so that clicking the button will emit the Gtk::Dialog::signal_response() signal with the given response_id. The button is appended to the end of the dialog's action area. The button widget is returned, but usually you don't need it.

Parameters

button_text	Text of button, or stock ID.
response_id	Response ID for the button.

Returns: The button widget that was added.

◆ add_button() [2/2]

Button* Gtk::Dialog::add_button	(	const Gtk::StockID &	stock_id,
		int	response_id
	)

Adds a button with the given text (or a stock button, if button_text is a stock ID) and sets things up so that clicking the button will emit the Gtk::Dialog::signal_response() signal with the given response_id. The button is appended to the end of the dialog's action area. The button widget is returned, but usually you don't need it.

Parameters

stock_id	Text of button, or stock ID.
response_id	Response ID for the button.

Returns: The button widget that was added.

◆ alternative_button_order()

static bool Gtk::Dialog::alternative_button_order ( const Glib::RefPtr< const Gdk::Screen > & screen )

static

Returns true if dialogs are expected to use an alternative button order on the screen screen. See Gtk::Dialog::set_alternative_button_order() for more details about alternative button order.

If you need to use this function, you should probably connect to the notify:gtk-alternative-button-order signal on the Gtk::Settings object associated to screen, in order to be notified if the button order setting changes.

Parameters

screen A Gdk::Screen, or 0 to use the default screen.

Returns: Whether the alternative button order should be used.

◆ construct_()

void Gtk::Dialog::construct_	(	bool	modal,
		bool	use_separator
	)

protected

◆ get_action_area() [1/2]

ButtonBox* Gtk::Dialog::get_action_area ( )

Returns the action area of dialog.

Returns: The action area.

◆ get_action_area() [2/2]

const ButtonBox* Gtk::Dialog::get_action_area ( ) const

Returns the action area of dialog.

Returns: The action area.

◆ get_has_separator()

bool Gtk::Dialog::get_has_separator ( ) const

Accessor for whether the dialog has a separator.

Deprecated: 2.22: This function will be removed in GTK+ 3

Returns: true if the dialog has a separator.

◆ get_response_for_widget()

int Gtk::Dialog::get_response_for_widget ( const Gtk::Widget & widget ) const

Gets the response id of a widget in the action area of a dialog.

Parameters

widget A widget in the action area of dialog.

Returns: The response id of widget, or Gtk::RESPONSE_NONE if widget doesn't have a response id set.

◆ get_vbox() [1/2]

VBox* Gtk::Dialog::get_vbox ( )

Returns the content area of dialog.

Returns: The content area Gtk::VBox.

◆ get_vbox() [2/2]

const VBox* Gtk::Dialog::get_vbox ( ) const

Returns the content area of dialog.

Returns: The content area Gtk::VBox.

◆ get_widget_for_response() [1/2]

Widget* Gtk::Dialog::get_widget_for_response ( int response_id )

Gets the widget button that uses the given response ID in the action area of a dialog.

Parameters

response_id The response ID used by the dialog widget.

Returns: The widget button that uses the given response_id, or 0.

◆ get_widget_for_response() [2/2]

const Widget* Gtk::Dialog::get_widget_for_response ( int response_id ) const

Gets the widget button that uses the given response ID in the action area of a dialog.

Parameters

response_id The response ID used by the dialog widget.

Returns: The widget button that uses the given response_id, or 0.

◆ gobj() [1/2]

GtkDialog* Gtk::Dialog::gobj ( )

inline

Provides access to the underlying C GtkObject.

Definition at line 162 of file dialog.h.

◆ gobj() [2/2]

const GtkDialog* Gtk::Dialog::gobj ( ) const

inline

Provides access to the underlying C GtkObject.

Definition at line 165 of file dialog.h.

◆ on_response()

virtual void Gtk::Dialog::on_response ( int response_id )

protectedvirtual

This is a default handler for the signal signal_response().

Reimplemented in AddRouteDialog, SessionArchiveDialog, RhythmFerret, PatchChangeDialog, EngineControl, DuplicateRouteDialog, ArdourDialog, TranscodeVideoDialog, TimeFXDialog, StripSilenceDialog, SimpleExportDialog, NormalizeDialog, ExportReport, and ExportDialog.

◆ property_has_separator() [1/2]

Glib::PropertyProxy< bool > Gtk::Dialog::property_has_separator ( )

The dialog has a separator bar above its buttons.

Returns: A PropertyProxy that allows you to get or set the value of the property, or receive notification when the value of the property changes.

◆ property_has_separator() [2/2]

Glib::PropertyProxy_ReadOnly< bool > Gtk::Dialog::property_has_separator ( ) const

The dialog has a separator bar above its buttons.

Returns: A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.

◆ response()

void Gtk::Dialog::response ( int response_id )

Emits the Gtk::Dialog::signal_response() signal with the given response ID. Used to indicate that the user has responded to the dialog in some way; typically either you or run() will be monitoring the signal_response() signal and take appropriate action.

Parameters

response_id Response ID.

◆ run()

int Gtk::Dialog::run ( )

Blocks in a recursive main loop until the dialog emits the response signal. It returns the response ID from the "response" signal emission. Before entering the recursive main loop, run() calls Gtk::Widget::show() on the dialog for you. Note that you still need to show any children of the dialog yourself.

If the dialog receives "delete_event", Gtk::Dialog::run() will return Gtk::RESPONSE_DELETE_EVENT. Also, during Gtk::Dialog::run() the dialog will be modal. You can force Gtk::Dialog::run() to return at any time by calling Gtk::Dialog::response() to emit the "response" signal.

After Gtk::Dialog::run() returns, you are responsible for hiding or destroying the dialog if you wish to do so.

Typical usage of this function might be: <informalexample><programlisting> int result = dialog.run(); switch (result) { case Gtk::RESPONSE_ACCEPT: do_application_specific_something(); break; default: do_nothing_since_dialog_was_cancelled(); break; } </programlisting></informalexample>

Returns: Response ID.

◆ set_alternative_button_order_from_array()

void Gtk::Dialog::set_alternative_button_order_from_array ( const Glib::ArrayHandle< int > & new_order )

Sets an alternative button order. If the gtk-alternative-button-order setting is set to true, the dialog buttons are reordered according to the order of the response ids in new_order.

By default, GTK+ dialogs use the button order advocated by the Gnome Human Interface Guidelines with the affirmative button at the far right, and the cancel button left of it. But the builtin GTK+ dialogs and GtkMessageDialog do provide an alternative button order, which is more suitable on some platforms, e.g. Windows.

Use this function after adding all the buttons to your dialog

Parameters

new_order an array of response ids of the dialog's buttons.

◆ set_default_response()

void Gtk::Dialog::set_default_response ( int response_id )

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.

Parameters

response_id A response ID.

◆ set_has_separator()

void Gtk::Dialog::set_has_separator ( bool setting = true )

Sets whether the dialog has a separator above the buttons.

Deprecated: 2.22: This function will be removed in GTK+ 3

Parameters

setting true to have a separator.

◆ set_response_sensitive()

void Gtk::Dialog::set_response_sensitive	(	int	response_id,
		bool	setting = `true`
	)

Calls gtk_widget_set_sensitive (widget, setting) for each widget in the dialog's action area with the given response_id. A convenient way to sensitize/desensitize dialog buttons.

Parameters

response_id	A response ID.
setting	`true` for sensitive.

◆ signal_response()

Glib::SignalProxy1< void,int > Gtk::Dialog::signal_response ( )

Slot Prototype:: void on_my_response(int response_id)

Friends And Related Function Documentation

◆ wrap()

Gtk::Dialog * wrap	(	GtkDialog *	object,
		bool	take_copy = `false`
	)

Parameters

object	The C instance.
take_copy	False if the result should take ownership of the C instance. True if it should take a new copy or ref.

Returns: A C++ instance that wraps this C instance.

The documentation for this class was generated from the following file:

dialog.h

Public Member Functions

Static Public Member Functions

Protected Member Functions

Related Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ ~Dialog()

◆ Dialog() [1/3]

◆ Dialog() [2/3]

◆ Dialog() [3/3]

Member Function Documentation

◆ add_action_widget()

◆ add_button() [1/2]

◆ add_button() [2/2]

◆ alternative_button_order()

◆ construct_()

◆ get_action_area() [1/2]

◆ get_action_area() [2/2]

◆ get_has_separator()

◆ get_response_for_widget()

◆ get_vbox() [1/2]

◆ get_vbox() [2/2]

◆ get_widget_for_response() [1/2]

◆ get_widget_for_response() [2/2]

◆ gobj() [1/2]

◆ gobj() [2/2]

◆ on_response()

◆ property_has_separator() [1/2]

◆ property_has_separator() [2/2]

◆ response()

◆ run()

◆ set_alternative_button_order_from_array()

◆ set_default_response()

◆ set_has_separator()

◆ set_response_sensitive()

◆ signal_response()

Friends And Related Function Documentation

◆ wrap()