gtkmm: New API in gtkmm 2.12

gtkmm 3.13.2

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

New API in gtkmm 2.12

Member Gdk::Display::supports_composite () const
  Returns
    `true` if windows may be composited.
Member Gdk::Pixbuf::apply_embedded_orientation ()
  Returns
    A newly-created pixbuf, or a reference to the input pixbuf (with an increased reference count).
Member Gdk::Pixbuf::create (const Glib::RefPtr< Window >& src, int src_x, int src_y, int width, int height)
Member Gdk::Pixbuf::Pixbuf (const Glib::RefPtr< Window >& src, int src_x, int src_y, int width, int height)
Member Gdk::Window::beep ()
Member Gdk::Window::set_composited (bool composited=TRUE)
  Parameters

    composited | `true` to set the window as composited.

Member Gdk::Window::set_opacity (double opacity)
  Parameters

    opacity | Opacity.

Member Gdk::Window::set_startup_id (const Glib::ustring& startup_id)
  Parameters

    startup_id | A string with startup-notification identifier.

Member Gtk::AboutDialog::get_program_name () const
  Returns
    The program name.
Member Gtk::AboutDialog::set_program_name (const Glib::ustring& name)
  Parameters

    name | The program name.

Member Gtk::Action::create_menu ()
Member Gtk::Buildable::get_name () const
  Returns
    The name set with set_name().
Member Gtk::Buildable::set_name (const Glib::ustring& name)
  Parameters

    name | Name to set.

Class Gtk::Builder
Member Gtk::Builder::add_from_string (const Glib::ustring& buffer)
Member Gtk::Builder::add_from_string (const char* buffer, gsize length)
Member Gtk::Builder::create_from_file (const std::string& filename)
Member Gtk::Builder::create_from_string (const Glib::ustring& buffer)
Member Gtk::Builder::get_object (const Glib::ustring& name)
  Parameters

    name | Name of object to get.

  Returns
    The object named name or `0` if it could not be found in the object tree.
Member Gtk::Builder::get_translation_domain () const
  Returns
    The translation domain. This string is owned by the builder object and must not be modified or freed.
Member Gtk::Builder::set_translation_domain (const Glib::ustring& domain)
  Parameters

    domain | The translation domain or `0`.

Member Gtk::CellLayout::get_cells ()
  Returns
    A list of cell renderers.
Member Gtk::CellLayout::get_cells () const
  Returns
    A list of cell renderers.
Class Gtk::CellRendererSpin
Member Gtk::Entry::get_cursor_hadjustment ()
  Returns
    The horizontal cursor adjustment, or `0` if none has been set.
Member Gtk::Entry::get_cursor_hadjustment () const
  Returns
    The horizontal cursor adjustment, or `0` if none has been set.
Member Gtk::Entry::set_cursor_hadjustment (const Glib::RefPtr< Adjustment >& adjustment)
  Parameters

    adjustment | An adjustment which should be adjusted when the cursor is moved, or `0`.

Member Gtk::EntryCompletion::get_completion_prefix () const
  Returns
    The prefix for the current completion.
Member Gtk::EntryCompletion::get_inline_selection () const
  Returns
    `true` if inline-selection mode is on.
Member Gtk::EntryCompletion::set_inline_selection (bool inline_selection=true)
  Parameters

    inline_selection | `true` to do inline selection.

Member Gtk::EntryCompletion::signal_cursor_on_match ()
Member Gtk::FileChooserButton::signal_file_set ()
Member Gtk::IconTheme::choose_icon (const std::vector< Glib::ustring >& icon_names, int size, IconLookupFlags flags)
  Parameters

    icon_names | Array of icon names to lookup.
    size | Desired icon size.
    flags | Flags modifying the behavior of the icon lookup.

  Returns
    A Gtk::IconInfo structure containing information about the icon. IconInfo::operator bool() will be false if the icon wasn't found - for instance, if (icon_info) { ... }.
Member Gtk::IconTheme::list_contexts () const
  Returns
    A list holding the names of all the contexts in the theme.
Member Gtk::IconView::convert_widget_to_bin_window_coords (int wx, int wy, int& bx, int& by) const
  Parameters

    wx | X coordinate relative to the widget.
    wy | Y coordinate relative to the widget.
    bx | Return location for bin_window X coordinate.
    by | Return location for bin_window Y coordinate.

Member Gtk::IconView::get_tooltip_column () const
  Returns
    The index of the tooltip column that is currently being used, or -1 if this is disabled.
Member Gtk::IconView::get_tooltip_context_iter (int& x, int& y, bool keyboard_tip, Gtk::TreeModel::iterator& iter)
Member Gtk::IconView::get_tooltip_context_path (int& x, int& y, bool keyboard_tip, TreeModel::Path& path)
Member Gtk::IconView::set_tooltip_cell (const Glib::RefPtr< Tooltip >& tooltip, const TreeModel::Path& path, CellRenderer& cell)
  Parameters

    tooltip | A Gtk::Tooltip.
    path | A Gtk::TreePath.
    cell | A Gtk::CellRenderer.

Member Gtk::IconView::set_tooltip_cell (const Glib::RefPtr< Tooltip >& tooltip, const TreeModel::Path& path)
  Parameters

    tooltip | A Gtk::Tooltip.
    path | A Gtk::TreePath.

Member Gtk::IconView::set_tooltip_column (int column)
  Parameters

    column | An integer, which is a valid column number for icon_view’s model.

Member Gtk::IconView::set_tooltip_item (const Glib::RefPtr< Tooltip >& tooltip, const TreeModel::Path& path)
  Parameters

    tooltip | A Gtk::Tooltip.
    path | A Gtk::TreePath.

Member Gtk::MenuShell::signal_move_selected ()
  Parameters

    distance | +1 to move to the next item, -1 to move to the previous.

  Returns
    `true` to stop the signal emission, `false` to continue.
Member Gtk::MenuToolButton::set_arrow_tooltip_markup (const Glib::ustring& markup)
  Parameters

    markup | Markup text to be used as tooltip text for button’s arrow button.

Member Gtk::MenuToolButton::set_arrow_tooltip_text (const Glib::ustring& text)
  Parameters

    text | Text to be used as tooltip text for button’s arrow button.

Member Gtk::PageSetup::save_to_file (const std::string& file_name) const
  Parameters

    file_name | The file to save to.

  Returns
    `true` on success.
Member Gtk::PageSetup::save_to_key_file (Glib::KeyFile& key_file, const Glib::ustring& group_name) const
  Parameters

    key_file | The Glib::KeyFile to save the page setup to.
    group_name | The group to add the settings to in key_file.

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

    key_file | The G::KeyFile to save the page setup to.

Member Gtk::PaperSize::get_paper_sizes (bool include_custom=true)
  Parameters

    include_custom | Whether to include custom paper sizes as defined in the page setup dialog.

  Returns
    A newly allocated list of newly allocated Gtk::PaperSize objects.
Member Gtk::PaperSize::operator BoolExpr () const
Member Gtk::PaperSize::save_to_key_file (Glib::KeyFile& key_file, const Glib::ustring& group_name)
  Parameters

    key_file | The KeyFile to save the paper size to.
    group_name | The group to add the settings to in key_file.

Member Gtk::PaperSize::save_to_key_file (Glib::KeyFile& key_file)
  Parameters

    key_file | The Glib::KeyFile to save the paper size to.

Member Gtk::Printer::get_capabilities () const
  Returns
    The printer’s capabilities.
Member Gtk::Printer::has_details () const
  Returns
    `true` if printer details are available.
Member Gtk::Printer::list_papers ()
  Returns
    A newly allocated list of newly allocated Gtk::PageSetup s.
Member Gtk::Printer::list_papers () const
  Returns
    A newly allocated list of newly allocated Gtk::PageSetup s.
Member Gtk::Printer::request_details ()
Member Gtk::PrintSettings::save_to_file (const std::string& file_name) const
  Parameters

    file_name | The file to save to.

  Returns
    `true` on success.
Member Gtk::PrintSettings::save_to_key_file (Glib::KeyFile& key_file, const Glib::ustring& group_name) const
  Parameters

    key_file | The Glib::KeyFile to save the print settings to.
    group_name | The group to add the settings to in key_file.

Member Gtk::PrintSettings::save_to_key_file (Glib::KeyFile& key_file) const
  Parameters

    key_file | The Glib::KeyFile to save the print settings to.

Member Gtk::Range::get_fill_level () const
  Returns
    The current fill level.
Member Gtk::Range::get_restrict_to_fill_level () const
  Returns
    `true` if range is restricted to the fill level.
Member Gtk::Range::get_show_fill_level () const
  Returns
    `true` if range shows the fill level.
Member Gtk::Range::set_fill_level (double fill_level)
  Parameters

    fill_level | The new position of the fill level indicator.

Member Gtk::Range::set_restrict_to_fill_level (bool restrict_to_fill_level=true)
  Parameters

    restrict_to_fill_level | Whether the fill level restricts slider movement.

Member Gtk::Range::set_show_fill_level (bool show_fill_level=true)
  Parameters

    show_fill_level | Whether a fill level indicator graphics is shown.

Class Gtk::RecentAction
Member Gtk::RecentAction::get_show_numbers ()
Member Gtk::RecentAction::set_show_numbers (bool show_numbers=true)
Class Gtk::ScaleButton
Member Gtk::ScaleButton::get_adjustment ()
  Returns
    The adjustment associated with the scale.
Member Gtk::ScaleButton::get_adjustment () const
  Returns
    The adjustment associated with the scale.
Member Gtk::ScaleButton::get_value () const
  Returns
    Current value of the scale button.
Member Gtk::ScaleButton::set_adjustment (const Glib::RefPtr< Adjustment >& adjustment)
  Parameters

    adjustment | A Gtk::Adjustment.

Member Gtk::ScaleButton::set_icons (const std::vector< Glib::ustring >& icons)
  Parameters

    icons | A `0`-terminated array of icon names.

Member Gtk::ScaleButton::set_value (double value)
  Parameters

    value | New value of the scale button.

Member Gtk::ScaleButton::signal_value_changed ()
  Parameters

    value | The new value.

Member Gtk::StatusIcon::get_screen ()
  Returns
    A Gdk::Screen.
Member Gtk::StatusIcon::get_screen () const
  Returns
    A Gdk::Screen.
Member Gtk::StatusIcon::popup_menu_at_position (Menu& menu, guint button, guint32 activate_time)
Member Gtk::StatusIcon::set_screen (const Glib::RefPtr< Gdk::Screen >& screen)
  Parameters

    screen | A Gdk::Screen.

Member Gtk::TextBuffer::add_mark (const Glib::RefPtr< TextBuffer::Mark >& mark, const iterator& where)
  Parameters

    mark | The mark to add.
    where | Location to place mark.

Member Gtk::TextMark::create (bool left_gravity=true)
Member Gtk::TextMark::create (const Glib::ustring& name, bool left_gravity=true)
Member Gtk::TextMark::TextMark (bool left_gravity=true)
Member Gtk::TextMark::TextMark (const Glib::ustring& name, bool left_gravity=true)
Member Gtk::ToolItem::set_tooltip_markup (const Glib::ustring& markup)
  Parameters

    markup | Markup text to be used as tooltip for tool_item.

Member Gtk::ToolItem::set_tooltip_text (const Glib::ustring& text)
  Parameters

    text | Text to be used as tooltip for tool_item.

Class Gtk::Tooltip
Member Gtk::Tooltip::set_custom (Widget& custom_widget)
  Parameters

    custom_widget | A Gtk::Widget, or `0` to unset the old custom widget.

Member Gtk::Tooltip::set_icon (const Glib::RefPtr< Gdk::Pixbuf >& pixbuf)
  Parameters

    pixbuf | A Gdk::Pixbuf, or `0`.

Member Gtk::Tooltip::set_icon_from_stock (const StockID& stock_id, IconSize size)
Member Gtk::Tooltip::set_markup (const Glib::ustring& markup)
  Parameters

    markup | A markup string (see [Pango markup format][PangoMarkupFormat]) or `0`.

Member Gtk::Tooltip::set_text (const Glib::ustring& text)
  Parameters

    text | A text string or `0`.

Member Gtk::Tooltip::set_tip_area (const Gdk::Rectangle& rect)
  Parameters

    rect | A Gdk::Rectangle.

Member Gtk::TreeView::convert_bin_window_to_tree_coords (int bx, int by, int& tx, int& ty) const
  Parameters

    bx | X coordinate relative to bin_window.
    by | Y coordinate relative to bin_window.
    tx | Return location for tree X coordinate.
    ty | Return location for tree Y coordinate.

Member Gtk::TreeView::convert_bin_window_to_widget_coords (int bx, int by, int& wx, int& wy) const
  Parameters

    bx | Bin_window X coordinate.
    by | Bin_window Y coordinate.
    wx | Return location for widget X coordinate.
    wy | Return location for widget Y coordinate.

Member Gtk::TreeView::convert_tree_to_bin_window_coords (int tx, int ty, int& bx, int& by) const
  Parameters

    tx | Tree X coordinate.
    ty | Tree Y coordinate.
    bx | Return location for X coordinate relative to bin_window.
    by | Return location for Y coordinate relative to bin_window.

Member Gtk::TreeView::convert_tree_to_widget_coords (int tx, int ty, int& wx, int& wy) const
  Parameters

    tx | X coordinate relative to the tree.
    ty | Y coordinate relative to the tree.
    wx | Return location for widget X coordinate.
    wy | Return location for widget Y coordinate.

Member Gtk::TreeView::convert_widget_to_bin_window_coords (int wx, int wy, int& bx, int& by) const
  Parameters

    wx | X coordinate relative to the widget.
    wy | Y coordinate relative to the widget.
    bx | Return location for bin_window X coordinate.
    by | Return location for bin_window Y coordinate.

Member Gtk::TreeView::convert_widget_to_tree_coords (int wx, int wy, int& tx, int& ty) const
  Parameters

    wx | X coordinate relative to the widget.
    wy | Y coordinate relative to the widget.
    tx | Return location for tree X coordinate.
    ty | Return location for tree Y coordinate.

Member Gtk::TreeView::get_level_indentation () const
  Returns
    The amount of extra indentation for child levels in tree_view. A return value of 0 means that this feature is disabled.
Member Gtk::TreeView::get_show_expanders () const
  Returns
    `true` if expanders are drawn in tree_view, `false` otherwise.
Member Gtk::TreeView::get_tooltip_column () const
  Returns
    The index of the tooltip column that is currently being used, or -1 if this is disabled.
Member Gtk::TreeView::get_tooltip_context_iter (int& x, int& y, bool keyboard_tip, Gtk::TreeModel::iterator& iter)
Member Gtk::TreeView::get_tooltip_context_path (int& x, int& y, bool keyboard_tip, TreeModel::Path& path)
Member Gtk::TreeView::is_rubber_banding_active () const
  Returns
    `true` if a rubber banding operation is currently being done in tree_view.
Member Gtk::TreeView::set_level_indentation (int indentation)
  Parameters

    indentation | The amount, in pixels, of extra indentation in tree_view.

Member Gtk::TreeView::set_show_expanders (bool enabled=true)
  Parameters

    enabled | `true` to enable expander drawing, `false` otherwise.

Member Gtk::TreeView::set_tooltip_cell (const Glib::RefPtr< Tooltip >& tooltip, const TreeModel::Path* path, TreeViewColumn* column, CellRenderer* cell)
  Parameters

    tooltip | A Gtk::Tooltip.
    path | A Gtk::TreePath or `0`.
    column | A Gtk::TreeViewColumn or `0`.
    cell | A Gtk::CellRenderer or `0`.

Member Gtk::TreeView::set_tooltip_column (int column)
  Parameters

    column | An integer, which is a valid column number for tree_view’s model.

Member Gtk::TreeView::set_tooltip_row (const Glib::RefPtr< Tooltip >& tooltip, const TreePath& path)
  Parameters

    tooltip | A Gtk::Tooltip.
    path | A Gtk::TreePath.

Member Gtk::TreeViewColumn::get_tree_view () const
  Returns
    The tree view wherein column has been inserted if any, `0` otherwise.
Member Gtk::TreeViewColumn::get_tree_view ()
  Returns
    The tree view wherein column has been inserted if any, `0` otherwise.
Class Gtk::VolumeButton
Member Gtk::Widget::error_bell ()
Member Gtk::Widget::get_has_tooltip () const
  Returns
    Current value of has-tooltip on widget.
Member Gtk::Widget::get_tooltip_markup () const
  Returns
    The tooltip text.
Member Gtk::Widget::get_tooltip_text () const
  Returns
    The tooltip text.
Member Gtk::Widget::get_tooltip_window ()
  Returns
    The Gtk::Window of the current tooltip.
Member Gtk::Widget::keynav_failed (DirectionType direction)
  Parameters

    direction | Direction of focus movement.

  Returns
    `true` if stopping keyboard navigation is fine, `false` if the emitting widget should try to handle the keyboard navigation attempt in its parent container(s).
Member Gtk::Widget::set_has_tooltip (bool has_tooltip=TRUE)
  Parameters

    has_tooltip | Whether or not widget has a tooltip.

Member Gtk::Widget::set_tooltip_markup (const Glib::ustring& markup)
  Parameters

    markup | The contents of the tooltip for widget.

Member Gtk::Widget::set_tooltip_text (const Glib::ustring& text)
  Parameters

    text | The contents of the tooltip for widget.

Member Gtk::Widget::set_tooltip_window (Window& custom_window)
  Parameters

    custom_window | A Gtk::Window, or `0`.

Member Gtk::Widget::signal_drag_failed ()
  Parameters

    context | The drag context.
    result | The result of the drag operation.

  Returns
    `true` if the failed drag operation has been already handled.
Member Gtk::Widget::signal_query_tooltip ()
  Parameters

    x | The x coordinate of the cursor position where the request has been emitted, relative to widget's left side.
    y | The y coordinate of the cursor position where the request has been emitted, relative to widget's top.
    keyboard_mode | `true` if the tooltip was trigged using the keyboard.
    tooltip | A Gtk::Tooltip.

  Returns
    `true` if tooltip should be shown right now, `false` otherwise.
Member Gtk::Widget::trigger_tooltip_query ()
Member Gtk::Window::get_opacity () const
  Deprecated: 3.8: Use gtk_widget_get_opacity instead.
Member Gtk::Window::set_opacity (double opacity)
  Deprecated: 3.8: Use gtk_widget_set_opacity instead.
Member Gtk::Window::set_startup_id (const Glib::ustring& startup_id)
  Parameters

    startup_id | A string with startup-notification identifier.