Gtk::ComboBox Class Reference

#include <combobox.h>

Inheritance diagram for Gtk::ComboBox:

Public Types
typedef TreeView::SlotRowSeparator	SlotRowSeparator
Public Types inherited from Gtk::Container
typedef sigc::slot< void, Widget & >	ForeachSlot
Public Types inherited from Gtk::CellLayout
typedef sigc::slot< void, const TreeModel::const_iterator & >	SlotCellData

Public Member Functions
virtual	~ComboBox ()
GtkComboBox *	gobj ()
	Provides access to the underlying C GtkObject. More...
const GtkComboBox *	gobj () const
	Provides access to the underlying C GtkObject. More...
	ComboBox ()
	ComboBox (const Glib::RefPtr< TreeModel > &model)
	ComboBox (bool has_entry)
	ComboBox (const Glib::RefPtr< TreeModel > &model, bool has_entry)
void	set_wrap_width (int width)
int	get_wrap_width () const
void	set_row_span_column (int row_span)
int	get_row_span_column () const
void	set_column_span_column (int column_span)
int	get_column_span_column () const
bool	get_add_tearoffs () const
void	set_add_tearoffs (bool add_tearoffs=true)
Glib::ustring	get_title () const
void	set_title (const Glib::ustring &title)
bool	get_focus_on_click () const
void	set_focus_on_click (bool focus_on_click=true)
int	get_active_row_number () const
TreeModel::iterator	get_active ()
TreeModel::const_iterator	get_active () const
void	set_active (int index)
void	set_active (const TreeModel::iterator &iter)
Glib::ustring	get_entry_text () const
void	unset_active ()
Glib::RefPtr< TreeModel >	get_model ()
Glib::RefPtr< const TreeModel >	get_model () const
void	set_model (const Glib::RefPtr< TreeModel > &model)
void	unset_model ()
void	set_row_separator_func (const SlotRowSeparator &slot)
void	unset_row_separator_func ()
void	set_button_sensitivity (SensitivityType sensitivity)
SensitivityType	get_button_sensitivity () const
bool	get_has_entry () const
void	set_entry_text_column (const TreeModelColumnBase &text_column) const
void	set_entry_text_column (int text_column)
int	get_entry_text_column () const
void	popup ()
void	popdown ()
Entry *	get_entry ()
const Entry *	get_entry () const
Glib::PropertyProxy< Glib::RefPtr< TreeModel > >	property_model ()
Glib::PropertyProxy_ReadOnly< Glib::RefPtr< TreeModel > >	property_model () const
Glib::PropertyProxy< int >	property_wrap_width ()
Glib::PropertyProxy_ReadOnly< int >	property_wrap_width () const
Glib::PropertyProxy< int >	property_row_span_column ()
Glib::PropertyProxy_ReadOnly< int >	property_row_span_column () const
Glib::PropertyProxy< int >	property_column_span_column ()
Glib::PropertyProxy_ReadOnly< int >	property_column_span_column () const
Glib::PropertyProxy< int >	property_active ()
Glib::PropertyProxy_ReadOnly< int >	property_active () const
Glib::PropertyProxy< bool >	property_add_tearoffs ()
Glib::PropertyProxy_ReadOnly< bool >	property_add_tearoffs () const
Glib::PropertyProxy< bool >	property_has_frame ()
Glib::PropertyProxy_ReadOnly< bool >	property_has_frame () const
Glib::PropertyProxy< bool >	property_focus_on_click ()
Glib::PropertyProxy_ReadOnly< bool >	property_focus_on_click () const
Glib::PropertyProxy< Glib::ustring >	property_tearoff_title ()
Glib::PropertyProxy_ReadOnly< Glib::ustring >	property_tearoff_title () const
Glib::PropertyProxy_ReadOnly< bool >	property_popup_shown () const
Glib::PropertyProxy< SensitivityType >	property_button_sensitivity ()
Glib::PropertyProxy_ReadOnly< SensitivityType >	property_button_sensitivity () const
Glib::SignalProxy0< void >	signal_changed ()
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
Public Member Functions inherited from Gtk::CellLayout
virtual	~CellLayout ()
GtkCellLayout *	gobj ()
	Provides access to the underlying C GObject. More...
const GtkCellLayout *	gobj () const
	Provides access to the underlying C GObject. More...
template<class ColumnType >
void	pack_start (const TreeModelColumn< ColumnType > &model_column, bool expand=true)
void	pack_start (CellRenderer &cell, bool expand=true)
void	pack_end (CellRenderer &cell, bool expand=true)
Glib::ListHandle< CellRenderer * >	get_cells ()
Glib::ListHandle< const CellRenderer * >	get_cells () const
void	clear ()
void	add_attribute (CellRenderer &cell, const Glib::ustring &attribute, int column)
void	add_attribute (const Glib::PropertyProxy_Base &property, const TreeModelColumnBase &column)
void	add_attribute (CellRenderer &cell, const Glib::ustring &attribute, const TreeModelColumnBase &column)
void	set_cell_data_func (CellRenderer &cell, const SlotCellData &slot)
void	clear_attributes (CellRenderer &cell)
void	reorder (CellRenderer &cell, int position)
template<class T_ModelColumnType >
void	pack_start (const TreeModelColumn< T_ModelColumnType > &column, bool expand)

Protected Member Functions
virtual void	on_changed ()
	This is a default handler for the signal signal_changed(). More...
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 bool	on_touch_begin_event (GdkEventTouch *event)
virtual bool	on_touch_update_event (GdkEventTouch *event)
virtual bool	on_touch_end_event (GdkEventTouch *event)
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 ()
Protected Member Functions inherited from Gtk::CellLayout
	CellLayout ()
virtual void	pack_start_vfunc (CellRenderer *cell, bool expand)
virtual void	pack_end_vfunc (CellRenderer *cell, bool expand)
virtual void	clear_vfunc ()
virtual void	add_attribute_vfunc (CellRenderer *cell, const Glib::ustring &attribute, int column)
virtual void	clear_attributes_vfunc (CellRenderer *cell)
virtual void	reorder_vfunc (CellRenderer *cell, int position)

Related Functions
(Note that these are not member functions.)
Gtk::ComboBox *	wrap (GtkComboBox *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)
Related Functions inherited from Gtk::CellLayout
Glib::RefPtr< Gtk::CellLayout >	wrap (GtkCellLayout *object, bool take_copy=false)

Additional Inherited Members
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)
Static Public Member Functions inherited from Gtk::CellLayout
static void	add_interface (GType gtype_implementer)
static GType	get_type () G_GNUC_CONST

Detailed Description

A widget used to choose from a list of items.

A ComboBox is a widget that allows the user to choose from a list of valid choices. The ComboBox displays the selected choice. When activated, the ComboBox displays a popup which allows the user to make a new choice. The style in which the selected value is displayed, and the style of the popup is determined by the current theme. It may be similar to a OptionMenu, or similar to a Windows-style combo box.

The ComboBox uses the model-view pattern; the list of valid choices is specified in the form of a tree model, and the display of the choices can be adapted to the data in the model by using cell renderers, as you would in a tree view. This is possible since ComboBox implements the CellLayout interface. The tree model holding the valid choices is not restricted to a flat list, it can be a real tree, and the popup will reflect the tree structure.

See also ComboBoxText, which is specialised for a single text column.

Definition at line 68 of file combobox.h.

Member Typedef Documentation

SlotRowSeparator

typedef TreeView::SlotRowSeparator Gtk::ComboBox::SlotRowSeparator

Definition at line 322 of file combobox.h.

Constructor & Destructor Documentation

~ComboBox()

virtual Gtk::ComboBox::~ComboBox ( )

virtual

ComboBox() [1/4]

Gtk::ComboBox::ComboBox

(

)

ComboBox() [2/4]

Gtk::ComboBox::ComboBox ( const Glib::RefPtr< TreeModel > &  model )

explicit

Creates a new ComboBox with the model initialized to model.

ComboBox() [3/4]

Gtk::ComboBox::ComboBox ( bool  has_entry )

explicit

Creates a new empty GtkComboBox, optionally with an entry.

Parameters

has_entry

If this is true then this will have an Entry widget.

ComboBox() [4/4]

Gtk::ComboBox::ComboBox ( const Glib::RefPtr< TreeModel > &  model, bool  has_entry  )

explicit

Creates a new ComboBox with the model initialized to model.

Parameters

model	The model containing data to display in the ComboBox.
has_entry	If this is true then this will have an Entry widget.

Member Function Documentation

get_active() [1/2]

TreeModel::iterator Gtk::ComboBox::get_active

(

)

Gets an iterator that points to the current active item, if it exists.

Returns

The iterator.

get_active() [2/2]

TreeModel::const_iterator Gtk::ComboBox::get_active

(

)

const

Gets an iterator that points to the current active item, if it exists.

Returns

The iterator.

get_active_row_number()

int Gtk::ComboBox::get_active_row_number

(

)

const

Returns the index of the currently active item, or -1 if there's no active item. If the model is a non-flat treemodel, and the active item is not an immediate child of the root of the tree, this function returns gtk_tree_path_get_indices (path)[0], where path is the Gtk::TreePath of the active item.

Returns

An integer which is the index of the currently active item, or -1 if there's no active item.

get_add_tearoffs()

bool Gtk::ComboBox::get_add_tearoffs

(

)

const

Gets the current value of the :add-tearoffs property.

Returns

The current value of the :add-tearoffs property.

get_button_sensitivity()

SensitivityType Gtk::ComboBox::get_button_sensitivity

(

)

const

Returns whether the combo box sets the dropdown button sensitive or not when there are no items in the model.

Returns

Gtk::SENSITIVITY_ON if the dropdown button is sensitive when the model is empty, Gtk::SENSITIVITY_OFF if the button is always insensitive or Gtk::SENSITIVITY_AUTO if it is only sensitive as long as the model has one item to be selected.

get_column_span_column()

int Gtk::ComboBox::get_column_span_column

(

)

const

Returns the column with column span information for combo_box.

Returns

The column span column.

get_entry() [1/2]

Entry* Gtk::ComboBox::get_entry

(

)

See also

Bin::get_child().

get_entry() [2/2]

const Entry* Gtk::ComboBox::get_entry

(

)

const

See also

Bin::get_child().

get_entry_text()

Glib::ustring Gtk::ComboBox::get_entry_text

(

)

const

Get the text in the entry, if there is an entry.

get_entry_text_column()

int Gtk::ComboBox::get_entry_text_column

(

)

const

Returns the column which combo_box is using to get the strings from to display in the internal entry.

Returns

A column in the data source model of combo_box.

get_focus_on_click()

bool Gtk::ComboBox::get_focus_on_click

(

)

const

Returns whether the combo box grabs focus when it is clicked with the mouse. See set_focus_on_click().

Returns

true if the combo box grabs focus when it is clicked with the mouse.

get_has_entry()

bool Gtk::ComboBox::get_has_entry

(

)

const

Returns whether the combo box has an entry.

Returns

Whether there is an entry in combo_box.

get_model() [1/2]

Glib::RefPtr<TreeModel> Gtk::ComboBox::get_model

(

)

Returns the Gtk::TreeModel which is acting as data source for combo_box.

Returns

A Gtk::TreeModel which was passed during construction.

get_model() [2/2]

Glib::RefPtr<const TreeModel> Gtk::ComboBox::get_model

(

)

const

Returns the Gtk::TreeModel which is acting as data source for combo_box.

Returns

A Gtk::TreeModel which was passed during construction.

get_row_span_column()

int Gtk::ComboBox::get_row_span_column

(

)

const

Returns the column with row span information for combo_box.

Returns

The row span column.

get_title()

Glib::ustring Gtk::ComboBox::get_title

(

)

const

Gets the current title of the menu in tearoff mode. See set_add_tearoffs().

Returns

The menu's title in tearoff mode. This is an internal copy of the string which must not be freed.

get_wrap_width()

int Gtk::ComboBox::get_wrap_width

(

)

const

Returns the wrap width which is used to determine the number of columns for the popup menu. If the wrap width is larger than 1, the combo box is in table mode.

Returns

The wrap width.

gobj() [1/2]

GtkComboBox* Gtk::ComboBox::gobj ( )

inline

Provides access to the underlying C GtkObject.

Definition at line 108 of file combobox.h.

gobj() [2/2]

const GtkComboBox* Gtk::ComboBox::gobj ( ) const

inline

Provides access to the underlying C GtkObject.

Definition at line 111 of file combobox.h.

on_changed()

virtual void Gtk::ComboBox::on_changed ( )

protectedvirtual

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

popdown()

void Gtk::ComboBox::popdown

(

)

Hides the menu or dropdown list of combo_box.

This function is mostly intended for use by accessibility technologies; applications should have little use for it.

popup()

void Gtk::ComboBox::popup

(

)

Pops up the menu or dropdown list of combo_box.

This function is mostly intended for use by accessibility technologies; applications should have little use for it.

property_active() [1/2]

Glib::PropertyProxy< int > Gtk::ComboBox::property_active

(

)

The item which is currently active.

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_active() [2/2]

Glib::PropertyProxy_ReadOnly< int > Gtk::ComboBox::property_active

(

)

const

The item which is currently active.

Returns

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

property_add_tearoffs() [1/2]

Glib::PropertyProxy< bool > Gtk::ComboBox::property_add_tearoffs

(

)

Whether dropdowns should have a tearoff menu item.

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_add_tearoffs() [2/2]

Glib::PropertyProxy_ReadOnly< bool > Gtk::ComboBox::property_add_tearoffs

(

)

const

Whether dropdowns should have a tearoff menu item.

Returns

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

property_button_sensitivity() [1/2]

Glib::PropertyProxy< SensitivityType > Gtk::ComboBox::property_button_sensitivity

(

)

Whether the dropdown button is sensitive when the model is empty.

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_button_sensitivity() [2/2]

Glib::PropertyProxy_ReadOnly< SensitivityType > Gtk::ComboBox::property_button_sensitivity

(

)

const

Whether the dropdown button is sensitive when the model is empty.

Returns

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

property_column_span_column() [1/2]

Glib::PropertyProxy< int > Gtk::ComboBox::property_column_span_column

(

)

TreeModel column containing the column span values.

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_column_span_column() [2/2]

Glib::PropertyProxy_ReadOnly< int > Gtk::ComboBox::property_column_span_column

(

)

const

TreeModel column containing the column span values.

Returns

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

property_focus_on_click() [1/2]

Glib::PropertyProxy< bool > Gtk::ComboBox::property_focus_on_click

(

)

Whether the combo box grabs focus when it is clicked with the mouse.

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_focus_on_click() [2/2]

Glib::PropertyProxy_ReadOnly< bool > Gtk::ComboBox::property_focus_on_click

(

)

const

Whether the combo box grabs focus when it is clicked with the mouse.

Returns

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

property_has_frame() [1/2]

Glib::PropertyProxy< bool > Gtk::ComboBox::property_has_frame

(

)

Whether the combo box draws a frame around the child.

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_frame() [2/2]

Glib::PropertyProxy_ReadOnly< bool > Gtk::ComboBox::property_has_frame

(

)

const

Whether the combo box draws a frame around the child.

Returns

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

property_model() [1/2]

Glib::PropertyProxy< Glib::RefPtr<TreeModel> > Gtk::ComboBox::property_model

(

)

The model for the combo box.

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_model() [2/2]

Glib::PropertyProxy_ReadOnly< Glib::RefPtr<TreeModel> > Gtk::ComboBox::property_model

(

)

const

The model for the combo box.

Returns

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

property_popup_shown()

Glib::PropertyProxy_ReadOnly< bool > Gtk::ComboBox::property_popup_shown

(

)

const

Whether the combo's dropdown is shown.

Returns

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

property_row_span_column() [1/2]

Glib::PropertyProxy< int > Gtk::ComboBox::property_row_span_column

(

)

TreeModel column containing the row span values.

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_row_span_column() [2/2]

Glib::PropertyProxy_ReadOnly< int > Gtk::ComboBox::property_row_span_column

(

)

const

TreeModel column containing the row span values.

Returns

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

property_tearoff_title() [1/2]

Glib::PropertyProxy< Glib::ustring > Gtk::ComboBox::property_tearoff_title

(

)

A title that may be displayed by the window manager when the popup is torn-off.

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_tearoff_title() [2/2]

Glib::PropertyProxy_ReadOnly< Glib::ustring > Gtk::ComboBox::property_tearoff_title

(

)

const

A title that may be displayed by the window manager when the popup is torn-off.

Returns

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

property_wrap_width() [1/2]

Glib::PropertyProxy< int > Gtk::ComboBox::property_wrap_width

(

)

Wrap width for laying out the items in a grid.

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_wrap_width() [2/2]

Glib::PropertyProxy_ReadOnly< int > Gtk::ComboBox::property_wrap_width

(

)

const

Wrap width for laying out the items in a grid.

Returns

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

set_active() [1/2]

void Gtk::ComboBox::set_active

(

const TreeModel::iterator &

iter

)

Sets the current active item to be the one referenced by iter, or unsets the active item if iter is 0.

Parameters

iter	The Gtk::TreeIter, or 0.

set_active() [2/2]

void Gtk::ComboBox::set_active

(

int

index

)

Sets the active item of combo_box to be the item at index.

Parameters

index

An index in the model passed during construction, or -1 to have no active item.

set_add_tearoffs()

void Gtk::ComboBox::set_add_tearoffs

(

bool

add_tearoffs = true

)

Sets whether the popup menu should have a tearoff menu item.

Parameters

add_tearoffs

true to add tearoff menu items.

set_button_sensitivity()

void Gtk::ComboBox::set_button_sensitivity

(

SensitivityType

sensitivity

)

Sets whether the dropdown button of the combo box should be always sensitive (Gtk::SENSITIVITY_ON), never sensitive (Gtk::SENSITIVITY_OFF) or only if there is at least one item to display (Gtk::SENSITIVITY_AUTO).

Parameters

sensitivity

Specify the sensitivity of the dropdown button.

set_column_span_column()

void Gtk::ComboBox::set_column_span_column

(

int

column_span

)

Sets the column with column span information for combo_box to be column_span. The column span column contains integers which indicate how many columns an item should span.

Parameters

column_span

A column in the model passed during construction.

set_entry_text_column() [1/2]

void Gtk::ComboBox::set_entry_text_column

(

const TreeModelColumnBase &

text_column

)

const

Sets the model column which combo_box should use to get strings from to be text_column. The column text_column in the model of combo_box must be of type TYPE_STRING.

This is only relevant if combo_box has been created with Gtk::ComboBox::property_has_entry() as true.

Parameters

text_column

A column in model to get the strings from for the internal entry.

set_entry_text_column() [2/2]

void Gtk::ComboBox::set_entry_text_column

(

int

text_column

)

Sets the model column which combo_box should use to get strings from to be text_column. The column text_column in the model of combo_box must be of type TYPE_STRING.

This is only relevant if combo_box has been created with Gtk::ComboBox::property_has_entry() as true.

Parameters

text_column

A column in model to get the strings from for the internal entry.

set_focus_on_click()

void Gtk::ComboBox::set_focus_on_click

(

bool

focus_on_click = true

)

Sets whether the combo box will grab focus when it is clicked with the mouse. Making mouse clicks not grab focus is useful in places like toolbars where you don't want the keyboard focus removed from the main area of the application.

Parameters

focus_on_click

Whether the combo box grabs focus when clicked with the mouse.

set_model()

void Gtk::ComboBox::set_model

(

const Glib::RefPtr< TreeModel > &

model

)

Sets the model used by combo_box to be model. Will unset a previously set model (if applicable). Use unset_model() to unset the old model.

Note that this function does not clear the cell renderers, you have to call Gtk::CellLayout::clear() yourself if you need to set up different cell renderers for the new model.

Parameters

model

A Gtk::TreeModel.

set_row_separator_func()

void Gtk::ComboBox::set_row_separator_func

(

const SlotRowSeparator &

slot

)

Sets the row separator function, which is used to determine whether a row should be drawn as a separator. See also unset_row_separator_func().

Parameters

slot	The callback.

set_row_span_column()

void Gtk::ComboBox::set_row_span_column

(

int

row_span

)

Sets the column with row span information for combo_box to be row_span. The row span column contains integers which indicate how many rows an item should span.

Parameters

row_span

A column in the model passed during construction.

set_title()

void Gtk::ComboBox::set_title

(

const Glib::ustring &

title

)

Sets the menu's title in tearoff mode.

Parameters

title

A title for the menu in tearoff mode.

set_wrap_width()

void Gtk::ComboBox::set_wrap_width

(

int

width

)

Sets the wrap width of combo_box to be width. The wrap width is basically the preferred number of columns when you want the popup to be layed out in a table.

Parameters

width

Preferred number of columns.

signal_changed()

Glib::SignalProxy0< void > Gtk::ComboBox::signal_changed

(

)

The changed signal gets emitted when the active item is changed. This can be due to the user selecting a different item from the list, or due to a call to set_active_iter().

Slot Prototype:

void on_my_changed()

unset_active()

void Gtk::ComboBox::unset_active

(

)

Causes no item to be active. See also set_active().

unset_model()

void Gtk::ComboBox::unset_model

(

)

Remove the model from the ComboBox.

See also

set_model().

unset_row_separator_func()

void Gtk::ComboBox::unset_row_separator_func

(

)

Causes no separators to be drawn.

Friends And Related Function Documentation

wrap()

Gtk::ComboBox * wrap ( GtkComboBox *  object, bool  take_copy = false  )

related

A Glib::wrap() method for this object.

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:

• combobox.h