gtkmm: New API in gtkmm 2.6

gtkmm 3.13.2

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

New API in gtkmm 2.6

Member Gdk::Display::request_selection_notification (const Glib::ustring& selection)
  Parameters

    selection | The Gdk::Atom naming the selection for which ownership change notification is requested.

  Returns
    Whether Gdk::EventOwnerChange events will be sent.
Member Gdk::Display::store_clipboard (const Glib::RefPtr< Gdk::Window >& clipboard_window, guint32 time_)
Member Gdk::Display::supports_clipboard_persistence () const
  Returns
    `true` if the display supports clipboard persistance.
Member Gdk::Display::supports_selection_notification () const
  Returns
    Whether Gdk::EventOwnerChange events will be sent.
Member Gdk::Pixbuf::flip (bool horizontal=true) const
  Parameters

    horizontal | `true` to flip horizontally, `false` to flip vertically.

  Returns
    The new Gdk::Pixbuf, or `0` if not enough memory could be allocated for it.
Member Gdk::Pixbuf::rotate_simple (PixbufRotation angle) const
  Parameters

    angle | The angle to rotate by.

  Returns
    The new Gdk::Pixbuf, or `0` if not enough memory could be allocated for it.
Member Gdk::PixbufFormat::get_license () const
  Returns
    A string describing the license of format.
Member Gdk::PixbufFormat::is_disabled () const
  Returns
    Whether this image format is disabled.
Member Gdk::PixbufFormat::is_scalable () const
  Returns
    Whether this image format is scalable.
Member Gdk::PixbufFormat::set_disabled (bool disabled=true)
  Parameters

    disabled | `true` to disable the format format.

Member Gdk::Window::configure_finished ()
  Deprecated: 3.8: this function is no longer needed
Member Gdk::Window::enable_synchronized_configure ()
  Deprecated: 3.8: this function is no longer needed
Member Gdk::Window::set_focus_on_map (bool focus_on_map)
  Parameters

    focus_on_map | `true` if the window should receive input focus when mapped.

Member Gtk::AboutDialog::get_artists () const
  Returns
    A `0`-terminated string array containing the artists. The array is owned by the about dialog and must not be modified.
Member Gtk::AboutDialog::get_authors () const
  Returns
    A `0`-terminated string array containing the authors. The array is owned by the about dialog and must not be modified.
Member Gtk::AboutDialog::get_comments () const
  Returns
    The comments. The string is owned by the about dialog and must not be modified.
Member Gtk::AboutDialog::get_copyright () const
  Returns
    The copyright string. The string is owned by the about dialog and must not be modified.
Member Gtk::AboutDialog::get_documenters () const
  Returns
    A `0`-terminated string array containing the documenters. The array is owned by the about dialog and must not be modified.
Member Gtk::AboutDialog::get_license () const
  Returns
    The license information. The string is owned by the about dialog and must not be modified.
Member Gtk::AboutDialog::get_logo ()
  Returns
    The pixbuf displayed as logo. The pixbuf is owned by the about dialog. If you want to keep a reference to it, you have to call Glib::object_ref() on it.
Member Gtk::AboutDialog::get_logo () const
  Returns
    The pixbuf displayed as logo. The pixbuf is owned by the about dialog. If you want to keep a reference to it, you have to call Glib::object_ref() on it.
Member Gtk::AboutDialog::get_logo_icon_name () const
  Returns
    The icon name displayed as logo. The string is owned by the dialog. If you want to keep a reference to it, you have to call Glib::strdup() on it.
Member Gtk::AboutDialog::get_translator_credits () const
  Returns
    The translator credits string. The string is owned by the about dialog and must not be modified.
Member Gtk::AboutDialog::get_version () const
  Returns
    The version string. The string is owned by the about dialog and must not be modified.
Member Gtk::AboutDialog::get_website () const
  Returns
    The website URL. The string is owned by the about dialog and must not be modified.
Member Gtk::AboutDialog::get_website_label () const
  Returns
    The label used for the website link.
Member Gtk::AboutDialog::set_artists (const std::vector< Glib::ustring >& artists)
  Parameters

    artists | A `0`-terminated array of strings.

Member Gtk::AboutDialog::set_authors (const std::vector< Glib::ustring >& authors) const
  Parameters

    authors | A `0`-terminated array of strings.

Member Gtk::AboutDialog::set_comments (const Glib::ustring& comments)
  Parameters

    comments | A comments string.

Member Gtk::AboutDialog::set_copyright (const Glib::ustring& copyright)
  Parameters

    copyright | The copyright string.

Member Gtk::AboutDialog::set_documenters (const std::vector< Glib::ustring >& documenters)
  Parameters

    documenters | A `0`-terminated array of strings.

Member Gtk::AboutDialog::set_license (const Glib::ustring& license)
  Parameters

    license | The license information or `0`.

Member Gtk::AboutDialog::set_logo (const Glib::RefPtr< Gdk::Pixbuf >& logo)
  Parameters

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

Member Gtk::AboutDialog::set_logo_icon_name (const Glib::ustring& icon_name)
  Parameters

    icon_name | An icon name, or `0`.

Member Gtk::AboutDialog::set_translator_credits (const Glib::ustring& translator_credits)
  Parameters

    translator_credits | The translator credits.

Member Gtk::AboutDialog::set_version (const Glib::ustring& version)
  Parameters

    version | The version string.

Member Gtk::AboutDialog::set_website (const Glib::ustring& website)
  Parameters

    website | A URL string starting with "http://".

Member Gtk::AboutDialog::set_website_label (const Glib::ustring& website_label)
  Parameters

    website_label | The label used for the website link.

Member Gtk::AccelGroup::get_label (guint accelerator_key, Gdk::ModifierType accelerator_mods)
  Parameters

    accelerator_key | Accelerator keyval.
    accelerator_mods | Accelerator modifier mask.

  Returns
    A newly-allocated string representing the accelerator.
Member Gtk::Action::get_accel_path () const
Member Gtk::Action::set_sensitive (bool sensitive=true)
Member Gtk::Action::set_visible (bool visible=true)
Member Gtk::ActionGroup::translate_string (const Glib::ustring& string) const
Member Gtk::Button::get_image ()
Member Gtk::Button::get_image () const
Member Gtk::Button::set_image (Widget& image)
  Parameters

    image | A widget to set as the image for the button.

Member Gtk::CellRenderer::signal_editing_started ()
  Parameters

    editable | The Gtk::CellEditable.
    path | The path identifying the edited cell.

Member Gtk::CellRenderer::stop_editing (bool canceled=false)
  Parameters

    canceled | `true` if the editing has been canceled.

Class Gtk::CellRendererProgress
Member Gtk::CellView::get_displayed_row () const
  Returns
    The currently displayed row or `0`.
Member Gtk::CellView::set_background_color (const Gdk::Color& color)
Member Gtk::CellView::set_displayed_row (const TreeModel::Path& path)
  Parameters

    path | A Gtk::TreePath or `0` to unset.

Member Gtk::CellView::set_model (const Glib::RefPtr< TreeModel >& model)
  Parameters

    model | A Gtk::TreeModel.

Member Gtk::Clipboard::set_image (const Glib::RefPtr< Gdk::Pixbuf >& pixbuf)
  Parameters

    pixbuf | A Gdk::Pixbuf.

Member Gtk::Clipboard::signal_owner_change ()
  Parameters

    event | The GdkEventOwnerChange event.

Member Gtk::Clipboard::store ()
Member Gtk::Clipboard::wait_for_image () const
  Returns
    A newly-allocated Gdk::Pixbuf object which must be disposed with Glib::object_unref(), or `0` if retrieving the selection data failed. (This could happen for various reasons, in particular if the clipboard was empty or if the contents of the clipboard could not be converted into an image.).
Member Gtk::Clipboard::wait_is_image_available () const
  Returns
    `true` is there is an image available, `false` otherwise.
Member Gtk::Clipboard::wait_is_target_available (const Glib::ustring& target)
  Parameters

    target | A Gdk::Atom indicating which target to look for.

  Returns
    `true` if the target is available, `false` otherwise.
Member Gtk::ComboBox::get_column_span_column () const
  Returns
    The column span column.
Member Gtk::ComboBox::get_focus_on_click () const
  Returns
    `true` if the combo box grabs focus when it is clicked with the mouse.
Member Gtk::ComboBox::get_popup_accessible ()
  Returns
    The accessible object corresponding to the combo box’s popup.
Member Gtk::ComboBox::get_popup_accessible () const
  Returns
    The accessible object corresponding to the combo box’s popup.
Member Gtk::ComboBox::get_row_span_column () const
  Returns
    The row span column.
Member Gtk::ComboBox::get_wrap_width () const
  Returns
    The wrap width.
Member Gtk::ComboBox::set_add_tearoffs (bool add_tearoffs=true)
Member Gtk::ComboBox::set_focus_on_click (bool focus_on_click=true)
  Parameters

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

Member Gtk::Dialog::alternative_button_order (const Glib::RefPtr< const Gdk::Screen >& screen)
  Deprecated: 3.10: Deprecated
Member Gtk::Dialog::set_alternative_button_order_from_array (const std::vector< int >& new_order)
Member Gtk::EntryCompletion::get_inline_completion () const
  Returns
    `true` if inline completion is turned on.
Member Gtk::EntryCompletion::get_popup_completion () const
  Returns
    `true` if popup completion is turned on.
Member Gtk::EntryCompletion::get_text_column () const
  Returns
    The column containing the strings.
Member Gtk::EntryCompletion::insert_prefix ()
Member Gtk::EntryCompletion::set_inline_completion (bool inline_completion=true)
  Parameters

    inline_completion | `true` to do inline completion.

Member Gtk::EntryCompletion::set_popup_completion (bool popup_completion=true)
  Parameters

    popup_completion | `true` to do popup completion.

Member Gtk::EntryCompletion::signal_insert_prefix ()
  Parameters

    prefix | The common prefix of all possible completions.

  Returns
    `true` if the signal has been handled.
Member Gtk::FileChooser::get_show_hidden () const
  Returns
    `true` if hidden files and folders are displayed.
Member Gtk::FileChooser::set_show_hidden (bool show_hidden=true)
  Parameters

    show_hidden | `true` if hidden files and folders should be displayed.

Member Gtk::FileChooserButton::get_title () const
  Returns
    A pointer to the browse dialog’s title.
Member Gtk::FileChooserButton::get_width_chars () const
  Returns
    An integer width (in characters) that the button will use to size itself.
Member Gtk::FileChooserButton::set_title (const Glib::ustring& title)
  Parameters

    title | The new browse dialog title.

Member Gtk::FileChooserButton::set_width_chars (int n_chars)
  Parameters

    n_chars | The new width, in characters.

Member Gtk::FileFilter::add_pixbuf_formats ()
Member Gtk::IconView::get_column_spacing () const
  Returns
    The space between columns.
Member Gtk::IconView::get_columns () const
  Returns
    The number of columns, or -1.
Member Gtk::IconView::get_icon_width () const
  Returns
    The width of a single item, or -1.
Member Gtk::IconView::get_item_at_pos (int x, int y, TreeModel::Path& path, CellRenderer*& cell) const
Member Gtk::IconView::get_item_at_pos (int x, int y, CellRenderer*& cell) const
Member Gtk::IconView::get_item_at_pos (int x, int y, TreeModel::Path& path) const
Member Gtk::IconView::get_item_orientation () const
  Returns
    The relative position of texts and icons.
Member Gtk::IconView::get_margin () const
  Returns
    The space at the borders.
Member Gtk::IconView::get_markup_column () const
  Returns
    The markup column, or -1 if it’s unset.
Member Gtk::IconView::get_model ()
  Returns
    A Gtk::TreeModel, or `0` if none is currently being used.
Member Gtk::IconView::get_model () const
  Returns
    A Gtk::TreeModel, or `0` if none is currently being used.
Member Gtk::IconView::get_path_at_pos (int x, int y) const
  Parameters

    x | The x position to be identified.
    y | The y position to be identified.

  Returns
    The Gtk::TreePath corresponding to the icon or `0` if no icon exists at that position.
Member Gtk::IconView::get_pixbuf_column () const
  Returns
    The pixbuf column, or -1 if it’s unset.
Member Gtk::IconView::get_row_spacing () const
  Returns
    The space between rows.
Member Gtk::IconView::get_selected_items () const
  Returns
    A List containing a Gtk::TreePath for each selected row.
Member Gtk::IconView::get_selection_mode () const
  Returns
    The current selection mode.
Member Gtk::IconView::get_spacing () const
  Returns
    The space between cells.
Member Gtk::IconView::get_text_column () const
  Returns
    The text column, or -1 if it’s unset.
Member Gtk::IconView::item_activated (const TreeModel::Path& path)
  Parameters

    path | The Gtk::TreePath to be activated.

Member Gtk::IconView::path_is_selected (const TreeModel::Path& path) const
  Parameters

    path | A Gtk::TreePath to check selection on.

  Returns
    `true` if path is selected.
Member Gtk::IconView::select_all ()
Member Gtk::IconView::select_path (const TreeModel::Path& path)
  Parameters

    path | The Gtk::TreePath to be selected.

Member Gtk::IconView::set_column_spacing (int column_spacing)
  Parameters

    column_spacing | The column spacing.

Member Gtk::IconView::set_columns (int columns)
  Parameters

    columns | The number of columns.

Member Gtk::IconView::set_item_orientation (Orientation orientation)
  Parameters

    orientation | The relative position of texts and icons.

Member Gtk::IconView::set_item_width (int item_width)
  Parameters

    item_width | The width for each item.

Member Gtk::IconView::set_margin (int margin)
  Parameters

    margin | The margin.

Member Gtk::IconView::set_markup_column (const TreeModelColumnBase& column)
  Parameters

    column | A column in the currently used model, or -1 to display no text.

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

    column | A column in the currently used model, or -1 to display no text.

Member Gtk::IconView::set_model (const Glib::RefPtr< TreeModel >& model)
  Parameters

    model | The model.

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

    column | A column in the currently used model, or -1 to disable.

Member Gtk::IconView::set_pixbuf_column (const TreeModelColumnBase& column)
  Parameters

    column | A column in the currently used model, or -1 to disable.

Member Gtk::IconView::set_row_spacing (int row_spacing)
  Parameters

    row_spacing | The row spacing.

Member Gtk::IconView::set_selection_mode (SelectionMode mode)
  Parameters

    mode | The selection mode.

Member Gtk::IconView::set_spacing (int spacing)
  Parameters

    spacing | The spacing.

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

    column | A column in the currently used model, or -1 to display no text.

Member Gtk::IconView::set_text_column (const TreeModelColumnBase& model_column)
  Parameters

    column | A column in the currently used model, or -1 to display no text.

Member Gtk::IconView::unselect_all ()
Member Gtk::IconView::unselect_path (const TreeModel::Path& path)
  Parameters

    path | The Gtk::TreePath to be unselected.

Member Gtk::Image::get_pixel_size () const
  Returns
    The pixel size used for named icons.
Member Gtk::Image::set_from_icon_name (const Glib::ustring& icon_name, IconSize size)
  Parameters

    icon_name | An icon name.
    size | An icon size.

Member Gtk::Image::set_pixel_size (int pixel_size)
  Parameters

    pixel_size | The new pixel size.

Member Gtk::Label::get_angle () const
  Returns
    The angle of rotation for the label.
Member Gtk::Label::get_ellipsize () const
  Returns
    Pango::EllipsizeMode.
Member Gtk::Label::get_max_width_chars () const
  Returns
    The maximum width of the label in characters.
Member Gtk::Label::get_single_line_mode () const
  Returns
    `true` when the label is in single line mode.
Member Gtk::Label::get_width_chars () const
  Returns
    The width of the label in characters.
Member Gtk::Label::set_angle (double angle)
  Parameters

    angle | The angle that the baseline of the label makes with the horizontal, in degrees, measured counterclockwise.

Member Gtk::Label::set_ellipsize (Pango::EllipsizeMode mode)
  Parameters

    mode | A Pango::EllipsizeMode.

Member Gtk::Label::set_max_width_chars (int n_chars)
  Parameters

    n_chars | The new desired maximum width, in characters.

Member Gtk::Label::set_single_line_mode (bool single_line_mode=true)
  Parameters

    single_line_mode | `true` if the label should be in single line mode.

Member Gtk::Label::set_width_chars (int n_chars)
  Parameters

    n_chars | The new desired width, in characters.

Member Gtk::MenuToolButton::get_menu ()
  Returns
    The Gtk::Menu associated with Gtk::MenuToolButton.
Member Gtk::MenuToolButton::get_menu () const
  Returns
    The Gtk::Menu associated with Gtk::MenuToolButton.
Member Gtk::MenuToolButton::set_menu (Menu& menu)
  Parameters

    menu | The Gtk::Menu associated with Gtk::MenuToolButton.

Member Gtk::MessageDialog::set_secondary_text (const Glib::ustring& text, bool use_markup=false)
Member Gtk::ProgressBar::get_ellipsize () const
  Returns
    Pango::EllipsizeMode.
Member Gtk::ProgressBar::set_ellipsize (Pango::EllipsizeMode mode)
  Parameters

    mode | A Pango::EllipsizeMode.

Member Gtk::Range::signal_change_value ()
  Parameters

    scroll | The type of scroll action that was performed.
    value | The new value resulting from the scroll action.

  Returns
    `true` to prevent other handlers from being invoked for the signal, `false` to propagate the signal further.
Member Gtk::SelectionData::get_pixbuf ()
  Returns
    If the selection data contained a recognized image type and it could be converted to a Gdk::Pixbuf, a newly allocated pixbuf is returned, otherwise `0`. If the result is non-`0` it must be freed with Glib::object_unref().
Member Gtk::SelectionData::get_pixbuf () const
  Returns
    If the selection data contained a recognized image type and it could be converted to a Gdk::Pixbuf, a newly allocated pixbuf is returned, otherwise `0`. If the result is non-`0` it must be freed with Glib::object_unref().
Member Gtk::SelectionData::get_uris () const
  Returns
    If the selection data contains a list of URIs, a container containing the URIs, otherwise an empty container.
Member Gtk::SelectionData::set_pixbuf (const Glib::RefPtr< Gdk::Pixbuf >& pixbuf)
  Parameters

    pixbuf | A Gdk::Pixbuf.

  Returns
    `true` if the selection was successfully set, otherwise `false`.
Member Gtk::SelectionData::set_uris (const std::vector< Glib::ustring >& uris)
  Parameters

    uris | A `0`-terminated array of strings holding URIs.

  Returns
    `true` if the selection was successfully set, otherwise `false`.
Member Gtk::SelectionData::targets_include_image (bool writable=true) const
  Parameters

    writable | Whether to accept only targets for which GTK+ knows how to convert a pixbuf into the format.

  Returns
    `true` if selection_data holds a list of targets, and a suitable target for images is included, otherwise `false`.
Member Gtk::TargetList::add_image_targets (guint info, bool writable)
  Parameters

    info | An ID that will be passed back to the application.
    writable | Whether to add only targets for which GTK+ knows how to convert a pixbuf into the format.

Member Gtk::TargetList::add_text_targets (guint info)
  Parameters

    info | An ID that will be passed back to the application.

Member Gtk::TargetList::add_uri_targets (guint info)
  Parameters

    info | An ID that will be passed back to the application.

Member Gtk::TextBuffer::backspace (const iterator& iter, bool interactive=true, bool default_editable=true)
Member Gtk::TextView::get_iter_at_position (TextBuffer::iterator& iter, int& trailing, int x, int y) const
  Parameters

    iter | A Gtk::TextIter.
    trailing | If non-`0`, location to store an integer indicating where in the grapheme the user clicked. It will either be zero, or the number of characters in the grapheme. 0 represents the trailing edge of the grapheme.
    x | X position, in buffer coordinates.
    y | Y position, in buffer coordinates.

Member Gtk::ToolItem::rebuild_menu ()
Member Gtk::TreeView::get_fixed_height_mode () const
  Returns
    `true` if tree_view is in fixed height mode.
Member Gtk::TreeView::get_hover_expand () const
  Returns
    `true` if tree_view is in hover expansion mode.
Member Gtk::TreeView::get_hover_selection () const
  Returns
    `true` if tree_view is in hover selection mode.
Member Gtk::TreeView::set_fixed_height_mode (bool enable=true)
  Parameters

    enable | `true` to enable fixed height mode.

Member Gtk::TreeView::set_hover_expand (bool expand=true)
  Parameters

    expand | `true` to enable hover selection mode.

Member Gtk::TreeView::set_hover_selection (bool hover=true)
  Parameters

    hover | `true` to enable hover selection mode.

Member Gtk::Widget::drag_source_add_text_targets ()
  Parameters

    widget | A Gtk::Widget that’s is a drag source.

Member Gtk::Window::get_focus_on_map () const
  Returns
    `true` if window should receive the input focus when mapped.
Member Gtk::Window::get_icon_name () const
  Returns
    The icon name or `0` if the window has no themed icon.
Member Gtk::Window::set_default_icon_name (const Glib::ustring& name)
  Parameters

    name | The name of the themed icon.

Member Gtk::Window::set_focus_on_map (bool setting=true)
  Parameters

    setting | `true` to let this window receive input focus on map.

Member Gtk::Window::set_icon_name (const Glib::ustring& name)
  Parameters

    name | The name of the themed icon.