gtkmm: Deprecated List

gtkmm 2.24.2

- Main Page
- Related Pages
- Modules
- Namespaces
- Classes

# Deprecated List

Member Gdk::Cairo::rectangle (::Cairo::RefPtr< ::Cairo::Context >& context, const Gdk::Rectangle& rectangle)
  Use add_rectangle_to_path() instead reference.

Member Gdk::Cairo::region (::Cairo::RefPtr< ::Cairo::Context >& context, const Gdk::Region& region)
  Use add_region_to_path() instead

Member Gdk::Cairo::set_source_color (::Cairo::RefPtr< ::Cairo::Context >& context, const Gdk::Color& color)
  Use the overloaded function that takes a const RefPtr reference.

Member Gdk::Cairo::set_source_pixbuf (::Cairo::RefPtr< ::Cairo::Context >& context, const Glib::RefPtr< Gdk::Pixbuf >& pixbuf, double pixbuf_x=0, double pixbuf_y=0)
  Use the overloaded function that takes a const RefPtr reference.

Member Gdk::Cairo::set_source_pixmap (::Cairo::RefPtr< ::Cairo::Context >& context, const Glib::RefPtr< Gdk::Pixmap >& pixmap, double pixmap_x, double pixmap_y)
  Use the overloaded function that takes a const RefPtr reference.

Member Gdk::Color::parse (const Glib::ustring& spec)
  See set().

Member Gdk::Color::rgb_find_color (const Glib::RefPtr< Gdk::Colormap >& map)
  Cairo handles colors automatically.

Member Gdk::Colormap::alloc_colors (ArrayHandle_Color& colors, int ncolors, bool writeable, bool best_match, Glib::ArrayHandle< bool >& success)
  Use alloc_color().

Member Gdk::Colormap::free_colors (Color& colors, int ncolors)
  Use free_color()

Member Gdk::Display::unset_pointer_hooks ()
  This method has been removed in gtkmm-3.0 for lack of use cases.

Member Gdk::DragContext::create ()
  This method is not useful, you always obtain drag contexts by Gdk::Window::drag_begin() or similar.

Member Gdk::DragContext::DragContext ()
  This method is not useful, you always obtain drag contexts by Gdk::Window::drag_begin() or similar.

Member Gdk::DragContext::get_action () const
  Use get_selected_action()

Member Gdk::Drawable::draw_lines (const Glib::RefPtr< const GC >& gc, const Glib::ArrayHandle< Point >& points)
  Use cairo_line_to() and cairo_stroke() instead.

Member Gdk::Drawable::draw_pixbuf (const Glib::RefPtr< Pixbuf >& pixbuf, int src_x, int src_y, int dest_x, int dest_y, int width, int height, RgbDither dither, int x_dither, int y_dither)
  Use gdk_cairo_set_source_pixbuf() and cairo_paint() or cairo_rectangle() and cairo_fill() instead.

Member Gdk::Drawable::draw_points (const Glib::RefPtr< const GC >& gc, const Glib::ArrayHandle< Point >& points)
  Use n_points calls to cairo_rectangle() and cairo_fill() instead.

Member Gdk::Drawable::get_size (int& width, int& height)
  Use the const version of this method.

Member Gdk::GC::set_clip_rectangle (Rectangle& rectangle)
  Use set_clip_rectangle(const Rectangle& rectangle) instead.

Member Gdk::Image::get_bpl () const
  Use get_bytes_per_line()

Member Gdk::Image::get_bpp () const
  Use get_bytes_per_pixel()

Member Gdk::Image::get_mem ()
  Use get_pixels().

Member Gdk::Pixbuf::create (const Glib::RefPtr< Drawable >& src, const Glib::RefPtr< Colormap >& cmap, int src_x, int src_y, int dest_x, int dest_y, int width, int height)
  Use the create() methods that don't have the unused dest_x and dest_y parameters.

Member Gdk::Pixbuf::create (const Glib::RefPtr< Image >& src, const Glib::RefPtr< Colormap >& cmap, int src_x, int src_y, int dest_x, int dest_y, int width, int height)
  Use the create() methods that that don't have the unused dest_x and dest_y parameters.

Member Gdk::Pixbuf::Pixbuf (const Glib::RefPtr< Drawable >& src, const Glib::RefPtr< Colormap >& cmap, int src_x, int src_y, int dest_x, int dest_y, int width, int height)
  Use the constructor without dest_x and dest_y parameters.

Member Gdk::Pixbuf::Pixbuf (const Glib::RefPtr< Image >& src, const Glib::RefPtr< Colormap >& cmap, int src_x, int src_y, int dest_x, int dest_y, int width, int height)
  Use the constructors without dest_x and dest_y parameters.

Member Gdk::Pixbuf::render_to_drawable (const Glib::RefPtr< Drawable >& drawable, const Glib::RefPtr< Gdk::GC >& gc, int src_x, int src_y, int dest_x, int dest_y, int width, int height, RgbDither dither, int x_dither, int y_dither)
  Use Gdk::Drawable::draw_pixbuf() instead.

Member Gdk::Pixbuf::render_to_drawable_alpha (const Glib::RefPtr< Drawable >& drawable, int src_x, int src_y, int dest_x, int dest_y, int width, int height, PixbufAlphaMode alpha_mode, int alpha_threshold, RgbDither dither, int x_dither, int y_dither)
  Use Gdk::Drawable::draw_pixbuf() instead.

Member Gtk::AboutDialog::set_email_hook (const SlotActivateLink& slot)
  Use signal_activate_link() instead.

Member Gtk::AboutDialog::set_url_hook (const SlotActivateLink& slot)
  Use signal_activate_link() instead.

Member Gtk::AboutDialog::SlotActivateLink
  Use signal_activate_link() instead.

Member Gtk::ALIGN_BOTTOM
  Use ALIGN_END.

Member Gtk::ALIGN_LEFT
  Use ALIGN_START.

Member Gtk::ALIGN_RIGHT
  Use ALIGN_END.

Member Gtk::ALIGN_TOP
  Use ALIGN_START.

Member Gtk::CellRenderer::editing_canceled ()
  Use stop_editing().

Member Gtk::ColorSelectionDialog::get_cancel_button ()
  Use Gtk::Dialog::get_widget_for_response() instead.

Member Gtk::ColorSelectionDialog::get_colorsel ()
  Use get_color_selection() instead.

Member Gtk::ColorSelectionDialog::get_colorsel () const
  Use get_color_selection() instead.

Member Gtk::ColorSelectionDialog::get_help_button ()
  Use Gtk::Dialog::get_widget_for_response() instead.

Member Gtk::ColorSelectionDialog::get_ok_button ()
  Use Gtk::Dialog::get_widget_for_response() instead.

Class Gtk::Combo
  Use the ComboBox widget instead.

Class Gtk::ComboBoxEntry
  Instead use ComboBox with has_entry = true.

Class Gtk::ComboBoxEntryText
  Instead use ComboBoxText with has_entry = true.

Member Gtk::ComboBoxEntryText::append_text (const Glib::ustring& text)
  Use append().

Member Gtk::ComboBoxEntryText::clear ()
  See clear_items(). Since 2.8.

Member Gtk::ComboBoxEntryText::insert_text (int position, const Glib::ustring& text)
  Use insert().

Member Gtk::ComboBoxEntryText::prepend_text (const Glib::ustring& text)
  Use prepend().

Member Gtk::ComboBoxText::append_text (const Glib::ustring& text)
  Use append().

Member Gtk::ComboBoxText::clear ()
  Use remove_all(). Since 2.8.

Member Gtk::ComboBoxText::clear_items ()
  Use remove_all().

Member Gtk::ComboBoxText::insert_text (int position, const Glib::ustring& text)
  Use insert().

Member Gtk::ComboBoxText::prepend_text (const Glib::ustring& text)
  Use prepend().

Class Gtk::ComboDropDown
  Use the ComboBox widget instead.

Class Gtk::ComboDropDownItem
  Use the ComboBox widget instead.

Class Gtk::Curve
  As of gtkmm 2.20, this widget has been deprecated since it is too specialized.

Member Gtk::EntryCompletion::get_text_column ()
  Use the const version of this method.

Member Gtk::EntryCompletion::set_popup_single_width (bool popup_single_match=true)
  Use set_popup_single_match() instead. This function was wrongly named.

Class Gtk::FileSelection
  Use the FileChooserDialog instead.

Member Gtk::FontSelection::get_filter_button ()
  You should not need to call this method.

Member Gtk::FontSelection::get_font_entry ()
  You should not need to call this method.

Member Gtk::FontSelection::get_font_style_entry ()
  You should not need to call this method.

Member Gtk::FontSelection::get_pixels_button ()
  You should not need to call this method.

Member Gtk::FontSelection::get_points_button ()
  You should not need to call this method.

Member Gtk::HandleBox::get_bin_window ()
  You should not need to call this method.

Member Gtk::HandleBox::get_float_window ()
  You should not need to call this method.

Member Gtk::HandleBox::is_float_window_mapped () const
  This method does not seem to be useful and will be removed from a future version of gtkmm, due to changes in GTK+.

Member Gtk::HandleBox::is_in_drag () const
  This method does not seem to be useful and will be removed from a future version of gtkmm, due to changes in GTK+.

Member Gtk::HandleBox::shrinks_on_detach () const
  This method does not seem to be useful and will be removed from a future version of gtkmm, due to changes in GTK+.

Class Gtk::HRuler
  This has been removed from gtkmm-3.0 because it was unmaintained and too specialized. There is no replacement other than using the original GtkRuler and Gtk::Ruler source files in your application.

Member Gtk::IconInfo::operator bool ()
  Use the const version.

Member Gtk::Image::Image (IconSet& icon_set, IconSize icon_size)
  Use the constructor that takes a const IconSet& icon_set instead.

Member Gtk::Image::set (IconSet& icon_set, IconSize size)
  Use the method that takes a const IconSet& instead.

Class Gtk::InputDialog
  As of gtkmm 2.20, this widget has been deprecated since it is too specialized.

Member Gtk::LinkButton::set_uri_hook (const SlotUri& slot)
  Use Button::signal_clicked() instead.

Member Gtk::LinkButton::SlotUri
  Use Button::signal_clicked() instead.

Member Gtk::LinkButton::unset_uri_hook ()
  Use Button::signal_clicked() instead.

Member Gtk::ListViewText::append_text (const Glib::ustring& column_one_value=Glib::ustring())
  Use append().

Member Gtk::ListViewText::insert_text (guint row, const Glib::ustring& column_one_value=Glib::ustring())
  Use insert().

Member Gtk::ListViewText::prepend_text (const Glib::ustring& column_one_value=Glib::ustring())
  Use prepend().

Member Gtk::Main::signal_quit ()
  This was removed in gtkmm-3.0 because it is not useful.

Member Gtk::MenuToolButton::set_arrow_tooltip (Tooltips& tooltips, const Glib::ustring& tip_text, const Glib::ustring& tip_private)
  Use set_arrow_tooltip_text() or set_arrow_tooltip_markup() instead

Member Gtk::MessageDialog::set_markup (const Glib::ustring& str)
  Use set_message(string, true).

Member Gtk::Notebook::get_current ()
  Use Notebook::get_current_page(), Notebook::get_nth_page(), etc.

Member Gtk::Notebook::get_n_pages ()
  Use the const method.

Member Gtk::Notebook::page_num (const Widget& child)
  Use the const method.

Member Gtk::Notebook::PageList
  Use Notebook::get_current_page(), Notebook::get_nth_page(), etc.

Member Gtk::Notebook::pages ()
  Use Notebook::get_current_page(), Notebook::get_nth_page(), etc.

Member Gtk::Notebook::pages () const
  Use Notebook::get_current_page(), Notebook::get_nth_page(), etc.

Member Gtk::Notebook::query_tab_label_packing (Widget& child, bool& expand, bool& fill, PackType& pack_type)
  Modify the "tab-expand" and "tab-fill" child properties instead.

Member Gtk::Notebook::set_window_creation_hook (const SlotWindowCreation& slot)
  Use the GtkNotebook::create-window signal instead.

Namespace Gtk::Notebook_Helpers
  Use Notebook::get_current_page(), Notebook::get_nth_page(), etc.

Class Gtk::Notebook_Helpers::MenuElem
  Use Notebook::get_current_page(), Notebook::get_nth_page(), etc.

Class Gtk::Notebook_Helpers::Page
  Use Notebook::get_current_page(), Notebook::get_nth_page(), etc.

Member Gtk::Notebook_Helpers::Page::query_tab_label_packing (bool& expand, bool& fill, PackType& pack_type)
  Query the "tab-expand" and "tab-fill" child properties instead.

Member Gtk::Notebook_Helpers::Page::set_tab_label_packing (bool expand, bool fill, PackType pack_type)
  Modify the "tab-expand" and "tab-fill" child properties instead.

Class Gtk::Notebook_Helpers::PageIterator
  Use Notebook::get_current_page(), Notebook::get_nth_page(), etc.

Class Gtk::Notebook_Helpers::PageList
  Use Notebook::get_current_page(), Notebook::get_nth_page(), etc. instead.

Class Gtk::Notebook_Helpers::TabElem
  Use Notebook::get_current_page(), Notebook::get_nth_page(), etc.

Class Gtk::OptionMenu
  Use the ComboBox widget instead.

Member Gtk::PageSetup::save_to_key_file (Glib::KeyFile& key_file)
  Use the const version.

Member Gtk::PageSetup::save_to_key_file (Glib::KeyFile& key_file, const Glib::ustring& group_name)
  Use the const version.

Member Gtk::PrintSettings::save_to_key_file (Glib::KeyFile& key_file)
  Use the const version.

Class Gtk::Ruler
  This has been removed from gtkmm-3.0 because it was unmaintained and too specialized. There is no replacement other than using the original GtkRuler and Gtk::Ruler source files in your application.

Member Gtk::Ruler::get_metric ()
  Use the const version

Member Gtk::Ruler::get_range_lower () const
  Use get_range() instead.

Member Gtk::Ruler::get_range_upper () const
  Use get_range() instead.

Member Gtk::ScrolledWindow::get_hscrollbar_visible () const
  You should not need to call this method.

Member Gtk::ScrolledWindow::get_vscrollbar_visible () const
  You should not need to call this method.

Member Gtk::Style::copy ()
  Use the const version

Member Gtk::Style::set_bg_pixmap (Gtk::StateType state_type, const Glib::RefPtr< Gdk::Pixmap >& pixmap)
  Use set_bg_pixmap(Gtk::StateType state_type, const Glib::RefPtr<const Gdk::Pixmap>& pixmap)

Member Gtk::Table::children () const
  Use Container::get_children() instead.

Member Gtk::Table::children ()
  Use Container::get_children() instead.

Member Gtk::Table::TableList
  Use Container::get_children() instead.

Namespace Gtk::Table_Helpers
  Use Container::get_children() instead.

Class Gtk::Table_Helpers::Child
  Use Container::get_children() instead.

Member Gtk::TearoffMenuItem::is_torn_off () const
  This method was apparently not useful and will be removed in a later gtkmm version, due to changes in GTK+.

Member Gtk::TextBuffer::assign (const char* text_begin, const char* text_end)
  Use set_text()

Member Gtk::TextBuffer::assign (const Glib::ustring& text)
  Use set_text()

Member Gtk::TextBuffer::get_slice (const iterator& start, const iterator& end, bool include_hidden_chars=true)
  Use get_slice(const iterator& start, const iterator& end, bool include_hidden_chars) const.

Member Gtk::TextBuffer::get_text (const iterator& start, const iterator& end, bool include_hidden_chars=true)
  Use get_text(const iterator& start, const iterator& end, bool include_hidden_chars) const

Member Gtk::TextBuffer::get_text (bool include_hidden_chars=true)
  Use get_text(bool include_hidden_chars) const.

Member Gtk::TextView::scroll_mark_onscreen (const Glib::RefPtr< TextBuffer::Mark >& mark)
  Use scroll_to()

Member Gtk::TextView::scroll_to_iter (TextBuffer::iterator& iter, double within_margin)
  Use scroll_to().

Member Gtk::TextView::scroll_to_mark (const Glib::RefPtr< TextBuffer::Mark >& mark, double within_margin)
  Use scroll_to().

Member Gtk::Toolbar::get_tooltips () const
  Use The toolkit-wide Gtk::Settings::property_gtk_enable_tooltips instead

Member Gtk::Toolbar::get_tooltips_object () const
  Use the Gtk::Tooltip API instead.

Member Gtk::Toolbar::set_tooltips (bool enable=true)
  Use The toolkit-wide Gtk::Settings::property_gtk_enable_tooltips instead

Member Gtk::ToolButton::signal_clicked ()
  This is an "action" key-binding signal that you should rarely need to use.

Member Gtk::ToolItem::set_tooltip (Tooltips& tooltips, const Glib::ustring& tip_text, const Glib::ustring& tip_private=Glib::ustring())
  Use set_tooltip_text() or set_tooltip_markup() instead

Member Gtk::ToolItem::signal_set_tooltip ()
  Use the new Gtk::Tooltip API. This signal will now never be emitted.

Class Gtk::Tooltips
  Use the Gtk::Tooltip API instead.

Member Gtk::TreeModel::iter_is_valid (const iterator& iter) const
  Use iter_is_valid() in the derived class.

Member Gtk::TreeModelFilter::convert_child_path_to_path (const Path& child_path)
  Use convert_child_path_to_path(const Path& child_path) const

Member Gtk::TreeModelFilter::convert_path_to_child_path (const Path& filter_path)
  convert_path_to_child_path(const Path& filter_path) const

Member Gtk::TreePath::append_index (int index)
  replaced by push_back()

Member Gtk::TreePath::get_depth () const
  replaced by size().

Member Gtk::TreePath::get_indices () const
  replaced by begin(), end(), and operator[]

Member Gtk::TreePath::prepend_index (int index)
  replaced by push_front().

Member Gtk::TreeSortable::set_sort_column_id (const TreeModelColumnBase& sort_column_id, SortType order)
  Use set_sort_column() instead.

Member Gtk::TreeSortable::set_sort_column_id (int sort_column_id, SortType order)
  Use set_sort_column() instead.

Member Gtk::TreeView::get_background_area (const TreeModel::Path& path, TreeViewColumn& column, Gdk::Rectangle& rect)
  Use the const version.

Member Gtk::TreeView::get_cell_area (const TreeModel::Path& path, TreeViewColumn& column, Gdk::Rectangle& rect)
  Use the const version

Member Gtk::TreeView::get_path_at_pos (int x, int y, TreeModel::Path& path, TreeViewColumn*& column, int& cell_x, int& cell_y)
  Use the const version.

Member Gtk::TreeView::get_visible_rect (Gdk::Rectangle& visible_rect)
  Use the const version.

Member Gtk::TreeView::tree_to_widget_coords (int tx, int ty, int& wx, int& wy)
  Use the const version.

Member Gtk::TreeView::widget_to_tree_coords (int wx, int wy, int& tx, int& ty)
  Use the const version

Member Gtk::TreeViewColumn::cell_get_size (Gdk::Rectangle& cell_area, int& x_offset, int& y_offset, int& width, int& height) const
  Use the cell_get_size() method override that takes a const cell_area.

Member Gtk::TreeViewColumn::get_first_cell_renderer ()
  Use get_first_cell().

Member Gtk::TreeViewColumn::get_first_cell_renderer () const
  Use get_first_cell().

Member Gtk::TreeViewColumn::set_sort_column_id (int sort_column_id)
  Use set_sort_column() instead.

Member Gtk::TreeViewColumn::set_sort_column_id (const TreeModelColumnBase& sort_column_id)
  Use set_sort_column() instead.

Class Gtk::VRuler
  This has been removed from gtkmm-3.0 because it was unmaintained and too specialized. There is no replacement other than using the original GtkRuler and Gtk::Ruler source files in your application.

Member Gtk::Widget::app_paintable () const
  Use get_app_paintable() instead.

Member Gtk::Widget::can_default () const
  Replaced by get_can_default().

Member Gtk::Widget::can_focus () const
  Replaced by get_can_focus().

Member Gtk::Widget::double_buffered () const
  Use get_double_buffered() instead.

Member Gtk::Widget::get_direction ()
  Use the const version of this method.

Member Gtk::Widget::get_flags () const
  Use the proper method to test individual states, suchas get_app_paintable(), get_can_default(), get_can_focus(), get_double_buffered(), has_default(), is_drawable(), has_focus(), has_grab(), get_mapped(), get_has_window(), has_rc_style(), get_realized(), get_receives_default(), get_sensitive(), is_sensitive(), is_toplevel() or get_visible().

Member Gtk::Widget::get_saved_state () const
  You should not need to call this method.

Member Gtk::Widget::has_no_window () const
  Use !get_has_window() instead.

Member Gtk::Widget::is_composite_child () const
  Use the "composite-child" property instead.

Member Gtk::Widget::is_drawable () const
  Use get_is_drawable() instead.

Member Gtk::Widget::is_mapped () const
  Use get_mapped() instead.

Member Gtk::Widget::is_realized () const
  Use get_realized() instead.

Member Gtk::Widget::is_toplevel () const
  Use get_is_toplevel() instead.

Member Gtk::Widget::is_visible () const
  Use get_visible() instead.

Member Gtk::Widget::parent_sensitive () const
  Call get_sensitive() on the result of get_parent() instead.

Member Gtk::Widget::rc_style () const
  Use has_rc_style() instead.

Member Gtk::Widget::receives_default () const
  Use get_receives_default() instead.

Member Gtk::Widget::sensitive () const
  Use get_sensitive() instead.

Member Gtk::Widget::set_flags (WidgetFlags flags)
  Use the proper function instead, such as set_app_paintable(), set_can_default(), set_can_focus(), set_double_buffered(), set_has_window(), set_mapped(), set_no_show_all(), set_realized(), set_receives_default(), set_sensitive() or set_visible().

Member Gtk::Widget::signal_get_accessible ()
  This should never have been in the API.

Member Gtk::Widget::size_request (const Requisition& requisition)
  Use size_request() const.

Member Gtk::Widget::unset_flags (WidgetFlags flags)
  Use the proper function instead, such as set_app_paintable(), set_can_default(), set_can_focus(), set_double_buffered(), set_has_window(), set_mapped(), set_no_show_all(), set_realized(), set_receives_default(), set_sensitive() or set_visible().

Member Gtk::Window::get_frame ()
  You should not need to call this method.

Member Gtk::Window::is_popup () const
  Use get_window_type().

Member Gtk::Window::is_toplevel () const
  Use Gtk::Widget::is_toplevel().