gtkmm: Deprecated List

# 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, double pixbuf_y)

  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::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::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::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.

  Use the create() methods 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.

  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::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 () const

  : Use get_color_selection() instead.

  : 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.

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

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

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+.

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

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

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_n_pages ()
  Use the const method.

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

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_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::OptionMenu
  Use the ComboBox widget instead.

Member Gtk::PageSetup::save_to_key_file (Glib::KeyFile& key_file)

  Use the const version.

  Use the const version.

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

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::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::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()

  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 (bool include_hidden_chars=true)

  Use get_text(bool include_hidden_chars) const.

  Use get_text(const iterator& start, const iterator& end, 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=Glibustring())
  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 (int sort_column_id, SortType order)

  Use set_sort_column() instead.

  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::set_sort_column_id (int sort_column_id)

  Use set_sort_column() instead.

  Use set_sort_column() instead.

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::signal_get_accessible ()

  This should never have been in the API. It was never meaningful.

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

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().