gtkmm: Gtk::Image Class Reference
A widget displaying an image. More...
#include <gtkmm/image.h>
Public Member Functions | |
Image (Image&& src) noexcept | |
Image& | operator= (Image&& src) noexcept |
Image (const Image&)=delete | |
Image& | operator= (const Image&)=delete |
~Image () noexceptoverride | |
GtkImage* | gobj () |
Provides access to the underlying C GtkObject. More... | |
const GtkImage* | gobj () const |
Provides access to the underlying C GtkObject. More... | |
Image () | |
Image (const std::string& file) | |
Creates an Image widget displaying the file filename. More... | |
Image (const Glib::RefPtr< Gdk::Pixbuf >& pixbuf) | |
Creates a new Image widget displaying pixbuf. More... | |
Image (const Gtk::StockID& stock_id, IconSize size) | |
Creates am Image displaying a stock icon. More... | |
Image (const Glib::RefPtr< IconSet >& icon_set, IconSize size) | |
Image (const Glib::RefPtr< Gdk::PixbufAnimation >& animation) | |
void | set (const std::string& filename) |
See the Image::Image(const std::string& file) constructor for details. More... | |
void | set_from_resource (const std::string& resource_path) |
See new_from_resource() for details. More... | |
void | set (const Glib::RefPtr< Gdk::Pixbuf >& pixbuf) |
See the Image::Image(const Glib::RefPtr<Gdk::Pixbuf>& pixbuf) constructor for details. More... | |
void | set (const Gtk::StockID& stock_id, IconSize size) |
See the Image::Image(const Gtk::StockID& stock_id, IconSize size) constructor for details. More... | |
void | set (const Glib::RefPtr< IconSet >& icon_set, IconSize size) |
See new_from_icon_set() for details. More... | |
void | set (const Glib::RefPtr< Gdk::PixbufAnimation >& animation) |
Causes the Gtk::Image to display the given animation (or display nothing, if you set the animation to nullptr ). More... | |
void | set (const Glib::RefPtr< const Gio::Icon >& icon, IconSize size) |
See new_from_gicon() for details. More... | |
void | set (const ::Cairo::RefPtr< ::Cairo::Surface >& surface) |
See new_from_surface() for details. More... | |
void | set_from_icon_name (const Glib::ustring& icon_name, IconSize size) |
Causes the Image to display an icon from the current icon theme. More... | |
void | clear () |
Resets the image to be empty. More... | |
ImageType | get_storage_type () const |
Gets the type of representation being used by the Gtk::Image to store image data. More... | |
Glib::RefPtr< Gdk::Pixbuf > | get_pixbuf () |
Gets the Gdk::Pixbuf being displayed by the Gtk::Image. More... | |
Glib::RefPtr< const Gdk::Pixbuf > | get_pixbuf () const |
Gets the Gdk::Pixbuf being displayed by the Gtk::Image. More... | |
void | get_stock (Gtk::StockID& stock_id, IconSize&size) const |
void | get_icon_set (Glib::RefPtr< IconSet >& icon_set, IconSize&size) const |
Glib::RefPtr< Gdk::PixbufAnimation > | get_animation () |
Gets the Gdk::PixbufAnimation being displayed by the Gtk::Image. More... | |
Glib::RefPtr< const Gdk::PixbufAnimation > | get_animation () const |
Gets the Gdk::PixbufAnimation being displayed by the Gtk::Image. More... | |
Glib::RefPtr< Gio::Icon > | get_gicon (Gtk::IconSize& icon_size) |
Gets the Gio::Icon and size being displayed by the Gtk::Image. More... | |
Glib::RefPtr< const Gio::Icon > | get_gicon (Gtk::IconSize& icon_size) const |
Gets the Gio::Icon and size being displayed by the Gtk::Image. More... | |
Glib::ustring | get_icon_name () const |
Glib::ustring | get_icon_name (IconSize&size) |
int | get_pixel_size () const |
Gets the pixel size used for named icons. More... | |
void | set_pixel_size (int pixel_size) |
Sets the pixel size to use for named icons. More... | |
Glib::PropertyProxy< Glib::RefPtr< Gdk::Pixbuf > > | property_pixbuf () |
A GdkPixbuf to display. More... | |
Glib::PropertyProxy_ReadOnly< Glib::RefPtr< Gdk::Pixbuf > > | property_pixbuf () const |
A GdkPixbuf to display. More... | |
Glib::PropertyProxy< Glib::ustring > | property_file () |
Filename to load and display. More... | |
Glib::PropertyProxy_ReadOnly< Glib::ustring > | property_file () const |
Filename to load and display. More... | |
Glib::PropertyProxy< Glib::ustring > | property_stock () |
Stock ID for a stock image to display. More... | |
Glib::PropertyProxy_ReadOnly< Glib::ustring > | property_stock () const |
Stock ID for a stock image to display. More... | |
Glib::PropertyProxy< Glib::RefPtr< IconSet > > | property_icon_set () |
Icon set to display. More... | |
Glib::PropertyProxy_ReadOnly< Glib::RefPtr< IconSet > > | property_icon_set () const |
Icon set to display. More... | |
Glib::PropertyProxy< int > | property_icon_size () |
Symbolic size to use for stock icon, icon set or named icon. More... | |
Glib::PropertyProxy_ReadOnly< int > | property_icon_size () const |
Symbolic size to use for stock icon, icon set or named icon. More... | |
Glib::PropertyProxy< int > | property_pixel_size () |
The "pixel-size" property can be used to specify a fixed size overriding the Gtk::Image::property_icon_size() property for images of type Gtk::IMAGE_ICON_NAME. More... | |
Glib::PropertyProxy_ReadOnly< int > | property_pixel_size () const |
The "pixel-size" property can be used to specify a fixed size overriding the Gtk::Image::property_icon_size() property for images of type Gtk::IMAGE_ICON_NAME. More... | |
Glib::PropertyProxy< Glib::RefPtr< Gdk::PixbufAnimation > > | property_pixbuf_animation () |
GdkPixbufAnimation to display. More... | |
Glib::PropertyProxy_ReadOnly< Glib::RefPtr< Gdk::PixbufAnimation > > | property_pixbuf_animation () const |
GdkPixbufAnimation to display. More... | |
Glib::PropertyProxy< Glib::ustring > | property_icon_name () |
The name of the icon in the icon theme. More... | |
Glib::PropertyProxy_ReadOnly< Glib::ustring > | property_icon_name () const |
The name of the icon in the icon theme. More... | |
Glib::PropertyProxy_ReadOnly< ImageType > | property_storage_type () const |
The representation being used for image data. More... | |
Glib::PropertyProxy< Glib::RefPtr< Gio::Icon > > | property_gicon () |
The GIcon displayed in the GtkImage. More... | |
Glib::PropertyProxy_ReadOnly< Glib::RefPtr< Gio::Icon > > | property_gicon () const |
The GIcon displayed in the GtkImage. More... | |
Glib::PropertyProxy< bool > | property_use_fallback () |
Whether the icon displayed in the GtkImage will use standard icon names fallback. More... | |
Glib::PropertyProxy_ReadOnly< bool > | property_use_fallback () const |
Whether the icon displayed in the GtkImage will use standard icon names fallback. More... | |
Glib::PropertyProxy< std::string > | property_resource () |
A path to a resource file to display. More... | |
Glib::PropertyProxy_ReadOnly< std::string > | property_resource () const |
A path to a resource file to display. More... | |
Glib::PropertyProxy< ::Cairo::RefPtr< ::Cairo::Surface > > | property_surface () |
A cairo_surface_t to display. More... | |
Glib::PropertyProxy_ReadOnly< ::Cairo::RefPtr< ::Cairo::Surface > > | property_surface () const |
A cairo_surface_t to display. More... | |
Public Member Functions inherited from Gtk::Misc | |
Misc (Misc&& src) noexcept | |
Misc& | operator= (Misc&& src) noexcept |
Misc (const Misc&)=delete | |
Misc& | operator= (const Misc&)=delete |
~Misc () noexceptoverride | |
GtkMisc* | gobj () |
Provides access to the underlying C GtkObject. More... | |
const GtkMisc* | gobj () const |
Provides access to the underlying C GtkObject. More... | |
void | set_alignment (float xalign=0.0, float yalign=0.5) |
Sets the alignment of the widget. More... | |
void | set_alignment (Align xalign=Gtk::ALIGN_START, Align yalign=Gtk::ALIGN_CENTER) |
Sets the alignment of the widget. More... | |
void | get_alignment (float& xalign, float& yalign) const |
Gets the X and Y alignment of the widget within its allocation. More... | |
void | set_padding (int xpad, int ypad) |
Sets the amount of space to add around the widget. More... | |
void | get_padding (int& xpad, int& ypad) const |
Gets the padding in the X and Y directions of the widget. More... | |
Glib::PropertyProxy< float > | property_xalign () |
The horizontal alignment. More... | |
Glib::PropertyProxy_ReadOnly< float > | property_xalign () const |
The horizontal alignment. More... | |
Glib::PropertyProxy< float > | property_yalign () |
The vertical alignment. More... | |
Glib::PropertyProxy_ReadOnly< float > | property_yalign () const |
The vertical alignment. More... | |
Glib::PropertyProxy< int > | property_xpad () |
The amount of space to add on the left and right of the widget, in pixels. More... | |
Glib::PropertyProxy_ReadOnly< int > | property_xpad () const |
The amount of space to add on the left and right of the widget, in pixels. More... | |
Glib::PropertyProxy< int > | property_ypad () |
The amount of space to add on the top and bottom of the widget, in pixels. More... | |
Glib::PropertyProxy_ReadOnly< int > | property_ypad () const |
The amount of space to add on the top and bottom of the widget, in pixels. More... | |
Public Member Functions inherited from Gtk::Widget | |
Widget (Widget&& src) noexcept | |
Widget& | operator= (Widget&& src) noexcept |
Widget (const Widget&)=delete | |
Widget& | operator= (const Widget&)=delete |
~Widget () noexceptoverride | |
Destroys the widget. More... | |
GtkWidget* | gobj () |
Provides access to the underlying C GtkObject. More... | |
const GtkWidget* | gobj () const |
Provides access to the underlying C GtkObject. More... | |
void | show () |
Flags a widget to be displayed. More... | |
void | show_now () |
Shows a widget. More... | |
void | hide () |
Reverses the effects of show(), causing the widget to be hidden (invisible to the user). More... | |
void | show_all () |
Recursively shows a widget, and any child widgets (if the widget is a container). More... | |
void | queue_draw () |
Equivalent to calling queue_draw_area() for the entire area of a widget. More... | |
void | queue_draw_area (int x, int y, int width, int height) |
Convenience function that calls queue_draw_region() on the region created from the given coordinates. More... | |
void | queue_draw_region (const ::Cairo::RefPtr< const ::Cairo::Region >& region) |
Invalidates the area of widget defined by region by calling gdk_window_invalidate_region() on the widget’s window and all its child windows. More... | |
void | queue_resize () |
This function is only for use in widget implementations. More... | |
void | queue_allocate () |
This function is only for use in widget implementations. More... | |
void | size_allocate (const Allocation& allocation) |
This function is only used by Gtk::Container subclasses, to assign a size and position to their child widgets. More... | |
void | size_allocate (const Allocation& allocation, int baseline) |
This function is only used by Gtk::Container subclasses, to assign a size, position and (optionally) baseline to their child widgets. More... | |
SizeRequestMode | get_request_mode () const |
Gets whether the widget prefers a height-for-width layout or a width-for-height layout. More... | |
void | get_preferred_width (int& minimum_width, int& natural_width) const |
Retrieves a widget’s initial minimum and natural width. More... | |
void | get_preferred_height_for_width (int width, int& minimum_height, int& natural_height) const |
Retrieves a widget’s minimum and natural height if it would be given the specified width. More... | |
void | get_preferred_height_for_width (int width, int& minimum_height, int& natural_height, int& minimum_baseline, int& natural_baseline) const |
Retrieves a widget’s minimum and natural height and the corresponding baselines if it would be given the specified width, or the default height if width is -1. More... | |
void | get_preferred_height (int& minimum_height, int& natural_height) const |
Retrieves a widget’s initial minimum and natural height. More... | |
void | get_preferred_width_for_height (int height, int& minimum_width, int& natural_width) const |
Retrieves a widget’s minimum and natural width if it would be given the specified height. More... | |
void | get_preferred_size (Requisition& minimum_size, Requisition& natural_size) const |
Retrieves the minimum and natural size of a widget, taking into account the widget’s preference for height-for-width management. More... | |
void | add_accelerator (const Glib::ustring& accel_signal, const Glib::RefPtr< AccelGroup >& accel_group, guint accel_key, Gdk::ModifierType accel_mods, AccelFlags accel_flags) |
Installs an accelerator for this widget in accel_group that causes accel_signal to be emitted if the accelerator is activated. More... | |
bool | remove_accelerator (const Glib::RefPtr< AccelGroup >& accel_group, guint accel_key, Gdk::ModifierType accel_mods) |
Removes an accelerator from widget, previously installed with add_accelerator(). More... | |
void | set_accel_path (const Glib::ustring& accel_path, const Glib::RefPtr< AccelGroup >& accel_group) |
Given an accelerator group, accel_group, and an accelerator path, accel_path, sets up an accelerator in accel_group so whenever the key binding that is defined for accel_path is pressed, widget will be activated. More... | |
bool | mnemonic_activate (bool group_cycling) |
Emits the Gtk::Widget::signal_mnemonic_activate() signal. More... | |
bool | event (GdkEvent* gdk_event) |
Rarely-used function. More... | |
int | send_expose (GdkEvent* gdk_event) |
Very rarely-used function. More... | |
bool | send_focus_change (GdkEvent* gdk_event) |
Sends the focus change gdk_event to widget. More... | |
bool | activate () |
For widgets that can be “activated” (buttons, menu items, etc.) this function activates them. More... | |
void | reparent (Widget& new_parent) |
Moves a widget from one Gtk::Container to another, handling reference count issues to avoid destroying the widget. More... | |
bool | intersect (const Gdk::Rectangle& area) const |
bool | intersect (const Gdk::Rectangle& area, Gdk::Rectangle& intersection) const |
Computes the intersection of a widget’s area and area, storing the intersection in intersection, and returns true if there was an intersection. More... | |
::Cairo::RefPtr< ::Cairo::Region > | region_intersect (const ::Cairo::RefPtr< ::Cairo::Region >& region) const |
Computes the intersection of a widget’s area and region, returning the intersection. More... | |
void | freeze_child_notify () |
Stops emission of Gtk::Widget::signal_child_notify() signals on widget. More... | |
void | child_notify (const Glib::ustring& child_property) |
Emits a Gtk::Widget::signal_child_notify() signal for the [child property][child-properties] child_property on widget. More... | |
void | thaw_child_notify () |
Reverts the effect of a previous call to freeze_child_notify(). More... | |
void | set_can_focus (bool can_focus=true) |
Specifies whether widget can own the input focus. More... | |
bool | get_can_focus () const |
Determines whether widget can own the input focus. More... | |
bool | has_focus () const |
Determines if the widget has the global input focus. More... | |
bool | is_focus () const |
Determines if the widget is the focus widget within its toplevel. More... | |
bool | has_visible_focus () const |
Determines if the widget should show a visible indication that it has the global input focus. More... | |
void | grab_focus () |
Causes widget to have the keyboard focus for the Gtk::Window it's inside. More... | |
void | set_focus_on_click (bool focus_on_click=true) |
Sets whether the widget should grab focus when it is clicked with the mouse. More... | |
bool | get_focus_on_click () const |
Returns whether the widget should grab focus when it is clicked with the mouse. More... | |
void | set_can_default (bool can_default=true) |
Specifies whether widget can be a default widget. More... | |
bool | get_can_default () const |
Determines whether widget can be a default widget. More... | |
bool | has_default () const |
Determines whether widget is the current default widget within its toplevel. More... | |
void | grab_default () |
Causes widget to become the default widget. More... | |
void | set_receives_default (bool receives_default=true) |
Specifies whether widget will be treated as the default widget within its toplevel when it has the focus, even if another widget is the default. More... | |
bool | get_receives_default () const |
Determines whether widget is always treated as the default widget within its toplevel when it has the focus, even if another widget is the default. More... | |
bool | has_grab () const |
Determines whether the widget is currently grabbing events, so it is the only widget receiving input events (keyboard and mouse). More... | |
bool | device_is_shadowed (const Glib::RefPtr< const Gdk::Device >& device) |
Returns true if device has been shadowed by a GTK+ device grab on another widget, so it would stop sending events to widget. More... | |
void | add_modal_grab () |
Block events to everything else than this widget and its children. More... | |
void | remove_modal_grab () |
Remove the modal grab of the widget in case it was previously grabbed. More... | |
void | set_name (const Glib::ustring& name) |
Widgets can be named, which allows you to refer to them from a CSS file. More... | |
void | unset_name () |
Glib::ustring | get_name () const |
Retrieves the name of a widget. More... | |
void | set_state (StateType state) |
This function is for use in widget implementations. More... | |
StateType | get_state () const |
Returns the widget’s state. More... | |
void | set_state_flags (StateFlags flags, bool clear=true) |
This function is for use in widget implementations. More... | |
void | unset_state_flags (StateFlags flags) |
This function is for use in widget implementations. More... | |
StateFlags | get_state_flags () const |
Returns the widget state as a flag set. More... | |
void | set_sensitive (bool sensitive=true) |
Sets the sensitivity of a widget. More... | |
bool | get_sensitive () const |
Returns the widget’s sensitivity (in the sense of returning the value that has been set using set_sensitive()). More... | |
bool | is_sensitive () const |
Returns the widget’s effective sensitivity, which means it is sensitive itself and also its parent widget is sensitive. More... | |
void | set_visible (bool visible=true) |
Sets the visibility state of widget. More... | |
bool | get_visible () const |
Determines whether the widget is visible. More... | |
bool | is_visible () const |
Determines whether the widget and all its parents are marked as visible. More... | |
bool | get_has_window () const |
Determines whether widget has a Gdk::Window of its own. More... | |
bool | get_is_toplevel () const |
Determines whether widget is a toplevel widget. More... | |
bool | get_is_drawable () const |
Determines whether widget can be drawn to. More... | |
bool | get_realized () const |
Determines whether widget is realized. More... | |
bool | get_mapped () const |
Whether the widget is mapped. More... | |
void | set_app_paintable (bool app_paintable=true) |
Sets whether the application intends to draw on the widget in an Gtk::Widget::signal_draw() handler. More... | |
bool | get_app_paintable () const |
Determines whether the application intends to draw on the widget in an Gtk::Widget::signal_draw() handler. More... | |
void | set_double_buffered (bool double_buffered=true) |
Widgets are double buffered by default; you can use this function to turn off the buffering. More... | |
bool | get_double_buffered () const |
Determines whether the widget is double buffered. More... | |
void | set_redraw_on_allocate (bool redraw_on_allocate=true) |
Sets whether the entire widget is queued for drawing when its size allocation changes. More... | |
void | set_child_visible (bool visible=true) |
Sets whether widget should be mapped along with its when its parent is mapped and widget has been shown with show(). More... | |
bool | get_child_visible () const |
Gets the value set with set_child_visible(). More... | |
Glib::RefPtr< Gdk::Window > | get_window () |
Returns the widget’s window if it is realized, nullptr otherwise. More... | |
Glib::RefPtr< const Gdk::Window > | get_window () const |
Returns the widget’s window if it is realized, nullptr otherwise. More... | |
void | register_window (const Glib::RefPtr< Gdk::Window >& window) |
Registers a Gdk::Window with the widget and sets it up so that the widget receives events for it. More... | |
void | unregister_window (const Glib::RefPtr< Gdk::Window >& window) |
Unregisters a Gdk::Window from the widget that was previously set up with register_window(). More... | |
int | get_allocated_width () const |
Returns the width that has currently been allocated to widget. More... | |
int | get_allocated_height () const |
Returns the height that has currently been allocated to widget. More... | |
int | get_allocated_baseline () const |
Returns the baseline that has currently been allocated to widget. More... | |
void | get_allocated_size (Allocation& allocation, int& baseline) const |
Retrieves the widget’s allocated size. More... | |
Allocation | get_allocation () const |
Retrieves the widget's location. More... | |
void | set_allocation (const Allocation& allocation) |
Sets the widget’s allocation. More... | |
void | set_clip (const Allocation& clip) |
Sets the widget’s clip. More... | |
Allocation | get_clip () const |
Retrieves the widget’s clip area. More... | |
Container* | get_parent () |
Returns the parent container of widget. More... | |
const Container* | get_parent () const |
Returns the parent container of widget. More... | |
Glib::RefPtr< Gdk::Window > | get_parent_window () |
Gets widget’s parent window. More... | |
Glib::RefPtr< const Gdk::Window > | get_parent_window () const |
Gets widget’s parent window. More... | |
void | set_parent_window (const Glib::RefPtr< const Gdk::Window >& parent_window) |
Sets a non default parent window for widget. More... | |
bool | child_focus (DirectionType direction) |
This function is used by custom widget implementations; if you're writing an app, you’d use grab_focus() to move the focus to a particular widget, and Gtk::Container::set_focus_chain() to change the focus tab order. More... | |
bool | keynav_failed (DirectionType direction) |
This function should be called whenever keyboard navigation within a single widget hits a boundary. More... | |
void | error_bell () |
Notifies the user about an input-related error on this widget. More... | |
void | set_size_request (int width=-1, int height=-1) |
Sets the minimum size of a widget; that is, the widget’s size request will be at least width by height. More... | |
void | get_size_request (int& width, int& height) const |
Gets the size request that was explicitly set for the widget using set_size_request(). More... | |
void | set_events (Gdk::EventMask events) |
Sets the event mask (see Gdk::EventMask) for a widget. More... | |
void | add_events (Gdk::EventMask events) |
Adds the events in the bitfield events to the event mask for widget. More... | |
void | set_device_events (const Glib::RefPtr< const Gdk::Device >& device, Gdk::EventMask events) |
Sets the device event mask (see Gdk::EventMask) for a widget. More... | |
void | add_device_events (const Glib::RefPtr< const Gdk::Device >& device, Gdk::EventMask events) |
Adds the device events in the bitfield events to the event mask for widget. More... | |
void | set_opacity (double opacity) |
Request the widget to be rendered partially transparent, with opacity 0 being fully transparent and 1 fully opaque. More... | |
double | get_opacity () const |
Fetches the requested opacity for this widget. More... | |
void | set_device_enabled (const Glib::RefPtr< Gdk::Device >& device, bool enabled=true) |
Enables or disables a Gdk::Device to interact with widget and all its children. More... | |
bool | get_device_enabled (const Glib::RefPtr< const Gdk::Device >& device) const |
Returns whether device can interact with widget and its children. More... | |
Container* | get_toplevel () |
This function returns the topmost widget in the container hierarchy widget is a part of. More... | |
const Container* | get_toplevel () const |
This function returns the topmost widget in the container hierarchy widget is a part of. More... | |
Widget* | get_ancestor (GType widget_type) |
Gets the first ancestor of widget with type widget_type. More... | |
const Widget* | get_ancestor (GType widget_type) const |
Gets the first ancestor of widget with type widget_type. More... | |
Glib::RefPtr< Gdk::Visual > | get_visual () |
Gets the visual that will be used to render widget. More... | |
Glib::RefPtr< Gdk::Screen > | get_screen () |
Get the Gdk::Screen from the toplevel window associated with this widget. More... | |
Glib::RefPtr< const Gdk::Screen > | get_screen () const |
Get the Gdk::Screen from the toplevel window associated with this widget. More... | |
bool | has_screen () const |
Checks whether there is a Gdk::Screen is associated with this widget. More... | |
int | get_scale_factor () const |
Retrieves the internal scale factor that maps from window coordinates to the actual device pixels. More... | |
Glib::RefPtr< Gdk::Display > | get_display () |
Get the Gdk::Display for the toplevel window associated with this widget. More... | |
Glib::RefPtr< const Gdk::Display > | get_display () const |
Get the Gdk::Display for the toplevel window associated with this widget. More... | |
Glib::RefPtr< Gdk::Window > | get_root_window () |
Get the root window where this widget is located. More... | |
Glib::RefPtr< const Gdk::Window > | get_root_window () const |
Get the root window where this widget is located. More... | |
Glib::RefPtr< Settings > | get_settings () |
Gets the settings object holding the settings used for this widget. More... | |
Glib::RefPtr< Clipboard > | get_clipboard (const Glib::ustring& selection) |
Returns the clipboard object for the given selection to be used with widget. More... | |
Glib::RefPtr< const Clipboard > | get_clipboard (const Glib::ustring& selection) const |
Returns the clipboard object for the given selection to be used with widget. More... | |
bool | get_hexpand () const |
Gets whether the widget would like any available extra horizontal space. More... | |
void | set_hexpand (bool expand=true) |
Sets whether the widget would like any available extra horizontal space. More... | |
bool | get_hexpand_set () const |
Gets whether set_hexpand() has been used to explicitly set the expand flag on this widget. More... | |
void | set_hexpand_set (bool set=true) |
Sets whether the hexpand flag (see get_hexpand()) will be used. More... | |
bool | get_vexpand () const |
Gets whether the widget would like any available extra vertical space. More... | |
void | set_vexpand (bool expand=true) |
Sets whether the widget would like any available extra vertical space. More... | |
bool | get_vexpand_set () const |
Gets whether set_vexpand() has been used to explicitly set the expand flag on this widget. More... | |
void | set_vexpand_set (bool set=true) |
Sets whether the vexpand flag (see get_vexpand()) will be used. More... | |
void | queue_compute_expand () |
Mark widget as needing to recompute its expand flags. More... | |
bool | compute_expand (Orientation orientation) |
Computes whether a container should give this widget extra space when possible. More... | |
bool | get_support_multidevice () const |
Returns true if widget is multiple pointer aware. More... | |
void | set_support_multidevice (bool support_multidevice=true) |
Enables or disables multiple pointer awareness. More... | |
Glib::RefPtr< Atk::Object > | get_accessible () |
Returns the accessible object that describes the widget to an assistive technology. More... | |
Glib::RefPtr< const Atk::Object > | get_accessible () const |
Returns the accessible object that describes the widget to an assistive technology. More... | |
Align | get_halign () const |
Gets the value of the Gtk::Widget::property_halign() property. More... | |
void | set_halign (Align align) |
Sets the horizontal alignment of widget. More... | |
Align | get_valign () const |
Gets the value of the Gtk::Widget::property_valign() property. More... | |
Align | get_valign_with_baseline () const |
Gets the value of the Gtk::Widget::property_valign() property, including Gtk::ALIGN_BASELINE. More... | |
void | set_valign (Align align) |
Sets the vertical alignment of widget. More... | |
int | get_margin_left () const |
Gets the value of the Gtk::Widget::property_margin_left() property. More... | |
void | set_margin_left (int margin) |
Sets the left margin of widget. More... | |
int | get_margin_right () const |
Gets the value of the Gtk::Widget::property_margin_right() property. More... | |
void | set_margin_right (int margin) |
Sets the right margin of widget. More... | |
int | get_margin_start () const |
Gets the value of the Gtk::Widget::property_margin_start() property. More... | |
void | set_margin_start (int margin) |
Sets the start margin of widget. More... | |
int | get_margin_end () const |
Gets the value of the Gtk::Widget::property_margin_end() property. More... | |
void | set_margin_end (int margin) |
Sets the end margin of widget. More... | |
int | get_margin_top () const |
Gets the value of the Gtk::Widget::property_margin_top() property. More... | |
void | set_margin_top (int margin) |
Sets the top margin of widget. More... | |
int | get_margin_bottom () const |
Gets the value of the Gtk::Widget::property_margin_bottom() property. More... | |
void | set_margin_bottom (int margin) |
Sets the bottom margin of widget. More... | |
Gdk::EventMask | get_events () const |
Returns the event mask (see Gdk::EventMask) for the widget. More... | |
Gdk::EventMask | get_device_events (const Glib::RefPtr< const Gdk::Device >& device) const |
Returns the events mask for the widget corresponding to an specific device. More... | |
void | get_pointer (int& x, int& y) const |
Obtains the location of the mouse pointer in widget coordinates. More... | |
bool | is_ancestor (Widget& ancestor) const |
Determines whether widget is somewhere inside ancestor, possibly with intermediate containers. More... | |
bool | translate_coordinates (Widget& dest_widget, int src_x, int src_y, int& dest_x, int& dest_y) |
Translate coordinates relative to src_widget’s allocation to coordinates relative to dest_widget’s allocations. More... | |
void | override_color (const Gdk::RGBA& color, StateFlags state=STATE_FLAG_NORMAL) |
Sets the color to use for a widget. More... | |
void | unset_color (StateFlags state=STATE_FLAG_NORMAL) |
Undoes the effect of previous calls to override_color(). More... | |
void | override_background_color (const Gdk::RGBA& color, StateFlags state=STATE_FLAG_NORMAL) |
Sets the background color to use for a widget. More... | |
void | unset_background_color (StateFlags state=STATE_FLAG_NORMAL) |
Undoes the effect of previous calls to override_background_color(). More... | |
void | override_font (const Pango::FontDescription& font_desc) |
Sets the font to use for a widget. More... | |
void | unset_font () |
Undoes the effect of previous calls to override_font(). More... | |
void | override_symbolic_color (const Glib::ustring& name, const Gdk::RGBA& color) |
Sets a symbolic color for a widget. More... | |
void | unset_symbolic_color (const Glib::ustring& name) |
Undoes the effect of previous calls to override_symbolic_color(). More... | |
void | override_cursor (const Gdk::RGBA& cursor, const Gdk::RGBA& secondary_cursor) |
Sets the cursor color to use in a widget, overriding the cursor-color and secondary-cursor-color style properties. More... | |
void | unset_cursor () |
Undoes the effect of previous calls to override_cursor(). More... | |
void | reset_style () |
Updates the style context of widget and all descendants by updating its widget path. More... | |
template<class PropertyType > | |
void | get_style_property (const Glib::ustring& the_property_name, PropertyType& value) const |
Gets the value of a style property of widget. More... | |
Glib::RefPtr< Pango::Context > | create_pango_context () |
Creates a new Pango::Context with the appropriate font map, font options, font description, and base direction for drawing text for this widget. More... | |
Glib::RefPtr< Pango::Context > | get_pango_context () |
Gets a Pango::Context with the appropriate font map, font description, and base direction for this widget. More... | |
void | set_font_options (const ::Cairo::FontOptions& options) |
Sets the #cairo_font_options_t used for Pango rendering in this widget. More... | |
void | unset_font_options () |
Undoes the effect of previous calls to set_font_options(). More... | |
::Cairo::FontOptions | get_font_options () const |
Returns the #cairo_font_options_t used for Pango rendering. More... | |
Glib::RefPtr< Pango::Layout > | create_pango_layout (const Glib::ustring& text) |
Creates a new Pango::Layout with the appropriate font map, font description, and base direction for drawing text for this widget. More... | |
Glib::RefPtr< Gdk::Pixbuf > | render_icon_pixbuf (const StockID& stock_id, IconSize size) |
A convenience function that uses the theme engine and style settings for widget to look up stock_id and render it to a pixbuf. More... | |
void | set_composite_name (const Glib::ustring& name) |
Sets a widgets composite name. More... | |
void | unset_composite_name () |
Glib::ustring | get_composite_name () const |
Obtains the composite name of a widget. More... | |
void | set_direction (TextDirection dir) |
Sets the reading direction on a particular widget. More... | |
TextDirection | get_direction () const |
Gets the reading direction for a particular widget. More... | |
void | shape_combine_region (const ::Cairo::RefPtr< const ::Cairo::Region >& region) |
Sets a shape for this widget’s GDK window. More... | |
void | input_shape_combine_region (const ::Cairo::RefPtr< const ::Cairo::Region >& region) |
Sets an input shape for this widget’s GDK window. More... | |
WidgetPath | get_path () const |
Returns the Gtk::WidgetPath representing widget, if the widget is not connected to a toplevel widget, a partial path will be created. More... | |
std::vector< Widget* > | list_mnemonic_labels () |
Returns a newly allocated list of the widgets, normally labels, for which this widget is the target of a mnemonic (see for example, Gtk::Label::set_mnemonic_widget()). More... | |
std::vector< const Widget* > | list_mnemonic_labels () const |
Returns a newly allocated list of the widgets, normally labels, for which this widget is the target of a mnemonic (see for example, Gtk::Label::set_mnemonic_widget()). More... | |
void | add_mnemonic_label (Widget& label) |
Adds a widget to the list of mnemonic labels for this widget. More... | |
void | remove_mnemonic_label (Widget& label) |
Removes a widget from the list of mnemonic labels for this widget. More... | |
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 std::vector< 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 |
Looks for a match between context->targets and the dest_target_list, returning the first matching target, otherwise returning Gdk::NONE. More... | |
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 std::vector< TargetEntry >& targets, Gdk::ModifierType start_button_mask=Gdk::MODIFIER_MASK, Gdk::DragAction actions=Gdk::ACTION_COPY) |
void | drag_source_unset () |
Undoes the effects of gtk_drag_source_set(). More... | |
void | drag_source_set_icon (const Glib::RefPtr< Gdk::Pixbuf >& pixbuf) |
Sets the icon that will be used for drags from a particular widget from a Gdk::Pixbuf. More... | |
void | drag_source_set_icon (const StockID& stock_id) |
Sets the icon that will be used for drags from a particular source to a stock icon. More... | |
void | drag_source_set_icon (const Glib::ustring& icon_name) |
Sets the icon that will be used for drags from a particular source to a themed icon. More... | |
void | drag_source_add_text_targets () |
Add the text targets supported by Gtk::SelectionData to the target list of the drag source. More... | |
void | drag_source_add_uri_targets () |
Add the URI targets supported by Gtk::SelectionData to the target list of the drag source. More... | |
void | drag_source_add_image_targets () |
Add the writable image targets supported by Gtk::SelectionData to the target list of the drag source. More... | |
Glib::RefPtr< Gdk::DragContext > | drag_begin (const Glib::RefPtr< TargetList >& targets, Gdk::DragAction actions, int button, GdkEvent* gdk_event) |
Glib::RefPtr< Gdk::DragContext > | drag_begin (const Glib::RefPtr< TargetList >& targets, Gdk::DragAction actions, int button, GdkEvent* gdk_event, int x, int y) |
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 () |
This function works like queue_resize(), except that the widget is not invalidated. More... | |
bool | get_no_show_all () const |
Returns the current value of the Gtk::Widget::property_no_show_all() property, which determines whether calls to show_all() will affect this widget. More... | |
void | set_no_show_all (bool no_show_all=true) |
Sets the Gtk::Widget::property_no_show_all() property, which determines whether calls to show_all() will affect this widget. More... | |
void | set_parent (Widget& parent) |
This function is useful only when implementing subclasses of Gtk::Container. More... | |
void | unparent () |
This function is only for use in widget implementations. More... | |
void | map () |
This function is only for use in widget implementations. More... | |
void | unmap () |
This function is only for use in widget implementations. More... | |
void | draw_insertion_cursor (const ::Cairo::RefPtr< ::Cairo::Context >& cr, const Gdk::Rectangle& location, bool is_primary, TextDirection direction, bool draw_arrow=true) |
Draws a text caret on cr at location. More... | |
void | set_tooltip_window (Window& custom_window) |
Replaces the default, usually yellow, window used for displaying tooltips with custom_window. More... | |
Window* | get_tooltip_window () |
Returns the Gtk::Window of the current tooltip. More... | |
void | trigger_tooltip_query () |
Triggers a tooltip query on the display where the toplevel of widget is located. More... | |
void | set_tooltip_text (const Glib::ustring& text) |
Sets text as the contents of the tooltip. More... | |
Glib::ustring | get_tooltip_text () const |
Gets the contents of the tooltip for widget. More... | |
void | set_tooltip_markup (const Glib::ustring& markup) |
Sets markup as the contents of the tooltip, which is marked up with the Pango text markup language. More... | |
Glib::ustring | get_tooltip_markup () const |
Gets the contents of the tooltip for widget. More... | |
void | set_has_tooltip (bool has_tooltip=TRUE) |
Sets the has-tooltip property on widget to has_tooltip. More... | |
bool | get_has_tooltip () const |
Returns the current value of the has-tooltip property. More... | |
int | get_width () const |
int | get_height () const |
bool | is_composited () const |
Whether widget can rely on having its alpha channel drawn correctly. More... | |
bool | in_destruction () const |
Returns whether the widget is currently being destroyed. More... | |
Glib::RefPtr< StyleContext > | get_style_context () |
Returns the style context associated to widget. More... | |
Glib::RefPtr< Gtk::StyleContext > | get_style_context () const |
Returns the style context associated to widget. More... | |
Gdk::ModifierType | get_modifier_mask (Gdk::ModifierIntent intent) |
Returns the modifier mask the widget’s windowing system backend uses for a particular purpose. More... | |
void | insert_action_group (const Glib::ustring& name, const Glib::RefPtr< Gio::ActionGroup >& group) |
Inserts group into widget. More... | |
void | remove_action_group (const Glib::ustring& name) |
Removes a group from the widget. More... | |
Glib::RefPtr< Gio::ActionGroup > | get_action_group (const Glib::ustring& prefix) |
Retrieves the ActionGroup that was registered using prefix. More... | |
Glib::RefPtr< const Gio::ActionGroup > | get_action_group (const Glib::ustring& prefix) const |
Retrieves the ActionGroup that was registered using prefix. More... | |
std::vector< Glib::ustring > | list_action_prefixes () const |
Retrieves a nullptr -terminated array of strings containing the prefixes of ActionGroup's available to widget. More... | |
void | set_font_map (const Glib::RefPtr< Pango::FontMap >& font_map) |
Sets the font map to use for Pango rendering. More... | |
Glib::RefPtr< Pango::FontMap > | get_font_map () |
Gets the font map that has been set with set_font_map(). More... | |
Glib::RefPtr< const Pango::FontMap > | get_font_map () const |
Gets the font map that has been set with set_font_map(). More... | |
Glib::SignalProxy< void > | signal_show () |
Glib::SignalProxy< void > | signal_hide () |
Glib::SignalProxy< void > | signal_map () |
Emitted on mapping of a widget to the screen. More... | |
Glib::SignalProxy< void > | signal_unmap () |
Glib::SignalProxy< void > | signal_realize () |
Emitted on realization of a widget. More... | |
Glib::SignalProxy< void > | signal_unrealize () |
Glib::SignalProxy< void, Allocation& > | signal_size_allocate () |
Glib::SignalProxy< void, Gtk::StateType > | signal_state_changed () |
Glib::SignalProxy< void, Gtk::StateFlags > | signal_state_flags_changed () |
Glib::SignalProxy< void, Widget* > | signal_parent_changed () |
Informs objects that their parent changed. More... | |
Glib::SignalProxy< void, Widget* > | signal_hierarchy_changed () |
Glib::SignalProxy< void > | signal_style_updated () |
Glib::SignalProxy< void, TextDirection > | signal_direction_changed () |
Glib::SignalProxy< void, bool > | signal_grab_notify () |
Glib::SignalProxy< void, GParamSpec* > | signal_child_notify () |
Glib::SignalProxy< bool, bool > | signal_mnemonic_activate () |
Glib::SignalProxy< void > | signal_grab_focus () |
Glib::SignalProxy< bool, DirectionType > | signal_focus () |
Glib::SignalProxy< bool, GdkEvent* > | signal_event () |
Glib::SignalProxy< void, GdkEvent* > | signal_event_after () |
Glib::SignalProxy< bool, GdkEventButton* > | signal_button_press_event () |
Event triggered by user pressing button. More... | |
Glib::SignalProxy< bool, GdkEventButton* > | signal_button_release_event () |
Event triggered by user releasing button. More... | |
Glib::SignalProxy< bool, GdkEventScroll* > | signal_scroll_event () |
Glib::SignalProxy< bool, GdkEventMotion* > | signal_motion_notify_event () |
Event triggered by user moving pointer. More... | |
Glib::SignalProxy< bool, GdkEventAny* > | signal_delete_event () |
Glib::SignalProxy< bool, const ::Cairo::RefPtr< ::Cairo::Context >& > | signal_draw () |
Glib::SignalProxy< bool, GdkEventKey* > | signal_key_press_event () |
Event triggered by a key press will widget has focus. More... | |
Glib::SignalProxy< bool, GdkEventKey* > | signal_key_release_event () |
Event triggered by a key release will widget has focus. More... | |
Glib::SignalProxy< bool, GdkEventCrossing* > | signal_enter_notify_event () |
Event triggered by pointer entering widget area. More... | |
Glib::SignalProxy< bool, GdkEventCrossing* > | signal_leave_notify_event () |
Event triggered by pointer leaving widget area. More... | |
Glib::SignalProxy< bool, GdkEventConfigure* > | signal_configure_event () |
Event triggered by a window resizing. More... | |
Glib::SignalProxy< bool, GdkEventFocus* > | signal_focus_in_event () |
Glib::SignalProxy< bool, GdkEventFocus* > | signal_focus_out_event () |
Glib::SignalProxy< bool, GdkEventAny* > | signal_map_event () |
Glib::SignalProxy< bool, GdkEventAny* > | signal_unmap_event () |
Glib::SignalProxy< bool, GdkEventProperty* > | signal_property_notify_event () |
Glib::SignalProxy< bool, GdkEventSelection* > | signal_selection_clear_event () |
Glib::SignalProxy< bool, GdkEventSelection* > | signal_selection_request_event () |
Glib::SignalProxy< bool, GdkEventSelection* > | signal_selection_notify_event () |
Glib::SignalProxy< bool, GdkEventProximity* > | signal_proximity_in_event () |
Glib::SignalProxy< bool, GdkEventProximity* > | signal_proximity_out_event () |
Glib::SignalProxy< bool, GdkEventVisibility* > | signal_visibility_notify_event () |
Glib::SignalProxy< bool, GdkEventWindowState* > | signal_window_state_event () |
Glib::SignalProxy< void, SelectionData&, guint, guint > | signal_selection_get () |
Glib::SignalProxy< void, const SelectionData&, guint > | signal_selection_received () |
Glib::SignalProxy< void, const Glib::RefPtr< Gdk::DragContext >& > | signal_drag_begin () |
Glib::SignalProxy< void, const Glib::RefPtr< Gdk::DragContext >& > | signal_drag_end () |
Glib::SignalProxy< void, const Glib::RefPtr< Gdk::DragContext >&, SelectionData&, guint, guint > | signal_drag_data_get () |
Glib::SignalProxy< void, const Glib::RefPtr< Gdk::DragContext >& > | signal_drag_data_delete () |
Glib::SignalProxy< bool, const Glib::RefPtr< Gdk::DragContext >&, DragResult > | signal_drag_failed () |
Glib::SignalProxy< void, const Glib::RefPtr< Gdk::DragContext >&, guint > | signal_drag_leave () |
Glib::SignalProxy< bool, const Glib::RefPtr< Gdk::DragContext >&, int, int, guint > | signal_drag_motion () |
Glib::SignalProxy< bool, const Glib::RefPtr< Gdk::DragContext >&, int, int, guint > | signal_drag_drop () |
Glib::SignalProxy< void, const Glib::RefPtr< Gdk::DragContext >&, int, int, const SelectionData&, guint, guint > | signal_drag_data_received () |
Glib::SignalProxy< void, const Glib::RefPtr< Gdk::Screen >& > | signal_screen_changed () |
Glib::SignalProxy< void > | signal_composited_changed () |
Glib::SignalProxy< bool > | signal_popup_menu () |
Glib::SignalProxy< bool, int, int, bool, const Glib::RefPtr< Tooltip >& > | signal_query_tooltip () |
Glib::SignalProxy< bool, GdkEventGrabBroken* > | signal_grab_broken_event () |
Glib::SignalProxy< bool, GdkEventExpose* > | signal_damage_event () |
Glib::SignalProxy< bool, GdkEventTouch* > | signal_touch_event () |
Glib::PropertyProxy< Glib::ustring > | property_name () |
The name of the widget. More... | |
Glib::PropertyProxy_ReadOnly< Glib::ustring > | property_name () const |
The name of the widget. More... | |
Glib::PropertyProxy< Container* > | property_parent () |
The parent widget of this widget. More... | |
Glib::PropertyProxy_ReadOnly< Container* > | property_parent () const |
The parent widget of this widget. More... | |
Glib::PropertyProxy< int > | property_width_request () |
Override for width request of the widget, or -1 if natural request should be used. More... | |
Glib::PropertyProxy_ReadOnly< int > | property_width_request () const |
Override for width request of the widget, or -1 if natural request should be used. More... | |
Glib::PropertyProxy< int > | property_height_request () |
Override for height request of the widget, or -1 if natural request should be used. More... | |
Glib::PropertyProxy_ReadOnly< int > | property_height_request () const |
Override for height request of the widget, or -1 if natural request should be used. More... | |
Glib::PropertyProxy< bool > | property_visible () |
Whether the widget is visible. More... | |
Glib::PropertyProxy_ReadOnly< bool > | property_visible () const |
Whether the widget is visible. More... | |
Glib::PropertyProxy< bool > | property_sensitive () |
Whether the widget responds to input. More... | |
Glib::PropertyProxy_ReadOnly< bool > | property_sensitive () const |
Whether the widget responds to input. More... | |
Glib::PropertyProxy< bool > | property_app_paintable () |
Whether the application will paint directly on the widget. More... | |
Glib::PropertyProxy_ReadOnly< bool > | property_app_paintable () const |
Whether the application will paint directly on the widget. More... | |
Glib::PropertyProxy< bool > | property_can_focus () |
Whether the widget can accept the input focus. More... | |
Glib::PropertyProxy_ReadOnly< bool > | property_can_focus () const |
Whether the widget can accept the input focus. More... | |
Glib::PropertyProxy< bool > | property_has_focus () |
Whether the widget has the input focus. More... | |
Glib::PropertyProxy_ReadOnly< bool > | property_has_focus () const |
Whether the widget has the input focus. More... | |
Glib::PropertyProxy< bool > | property_is_focus () |
Whether the widget is the focus widget within the toplevel. More... | |
Glib::PropertyProxy_ReadOnly< bool > | property_is_focus () const |
Whether the widget is the focus widget within the toplevel. More... | |
Glib::PropertyProxy< bool > | property_focus_on_click () |
Whether the widget should grab focus when it is clicked with the mouse. More... | |
Glib::PropertyProxy_ReadOnly< bool > | property_focus_on_click () const |
Whether the widget should grab focus when it is clicked with the mouse. More... | |
Glib::PropertyProxy< bool > | property_can_default () |
Whether the widget can be the default widget. More... | |
Glib::PropertyProxy_ReadOnly< bool > | property_can_default () const |
Whether the widget can be the default widget. More... | |
Glib::PropertyProxy< bool > | property_has_default () |
Whether the widget is the default widget. More... | |
Glib::PropertyProxy_ReadOnly< bool > | property_has_default () const |
Whether the widget is the default widget. More... | |
Glib::PropertyProxy< bool > | property_receives_default () |
If TRUE, the widget will receive the default action when it is focused. More... | |
Glib::PropertyProxy_ReadOnly< bool > | property_receives_default () const |
If TRUE, the widget will receive the default action when it is focused. More... | |
Glib::PropertyProxy_ReadOnly< bool > | property_composite_child () const |
Whether the widget is part of a composite widget. More... | |
Glib::PropertyProxy< Glib::RefPtr< Style > > | property_style () |
The style of the widget, which contains information about how it will look (colors, etc). More... | |
Glib::PropertyProxy_ReadOnly< Glib::RefPtr< Style > > | property_style () const |
The style of the widget, which contains information about how it will look (colors, etc). More... | |
Glib::PropertyProxy< Gdk::EventMask > | property_events () |
The event mask that decides what kind of GdkEvents this widget gets. More... | |
Glib::PropertyProxy_ReadOnly< Gdk::EventMask > | property_events () const |
The event mask that decides what kind of GdkEvents this widget gets. More... | |
Glib::PropertyProxy< bool > | property_has_tooltip () |
Enables or disables the emission of Gtk::Widget::signal_query_tooltip() on widget. More... | |
Glib::PropertyProxy_ReadOnly< bool > | property_has_tooltip () const |
Enables or disables the emission of Gtk::Widget::signal_query_tooltip() on widget. More... | |
Glib::PropertyProxy< Glib::ustring > | property_tooltip_markup () |
Sets the text of tooltip to be the given string, which is marked up with the [Pango text markup language][PangoMarkupFormat]. More... | |
Glib::PropertyProxy_ReadOnly< Glib::ustring > | property_tooltip_markup () const |
Sets the text of tooltip to be the given string, which is marked up with the [Pango text markup language][PangoMarkupFormat]. More... | |
Glib::PropertyProxy< Glib::ustring > | property_tooltip_text () |
Sets the text of tooltip to be the given string. More... | |
Glib::PropertyProxy_ReadOnly< Glib::ustring > | property_tooltip_text () const |
Sets the text of tooltip to be the given string. More... | |
Glib::PropertyProxy_ReadOnly< Glib::RefPtr< Gdk::Window > > | property_window () const |
The widget's window if it is realized, nullptr otherwise. More... | |
Glib::PropertyProxy< bool > | property_no_show_all () |
Whether gtk_widget_show_all() should not affect this widget. More... | |
Glib::PropertyProxy_ReadOnly< bool > | property_no_show_all () const |
Whether gtk_widget_show_all() should not affect this widget. More... | |
Glib::PropertyProxy< bool > | property_double_buffered () |
Whether the widget is double buffered. More... | |
Glib::PropertyProxy_ReadOnly< bool > | property_double_buffered () const |
Whether the widget is double buffered. More... | |
Glib::PropertyProxy< Align > | property_halign () |
How to distribute horizontal space if widget gets extra space, see Gtk::Align. More... | |
Glib::PropertyProxy_ReadOnly< Align > | property_halign () const |
How to distribute horizontal space if widget gets extra space, see Gtk::Align. More... | |
Glib::PropertyProxy< Align > | property_valign () |
How to distribute vertical space if widget gets extra space, see Gtk::Align. More... | |
Glib::PropertyProxy_ReadOnly< Align > | property_valign () const |
How to distribute vertical space if widget gets extra space, see Gtk::Align. More... | |
Glib::PropertyProxy< int > | property_margin_left () |
Margin on left side of widget. More... | |
Glib::PropertyProxy_ReadOnly< int > | property_margin_left () const |
Margin on left side of widget. More... | |
Glib::PropertyProxy< int > | property_margin_right () |
Margin on right side of widget. More... | |
Glib::PropertyProxy_ReadOnly< int > | property_margin_right () const |
Margin on right side of widget. More... | |
Glib::PropertyProxy< int > | property_margin_start () |
Margin on start of widget, horizontally. More... | |
Glib::PropertyProxy_ReadOnly< int > | property_margin_start () const |
Margin on start of widget, horizontally. More... | |
Glib::PropertyProxy< int > | property_margin_end () |
Margin on end of widget, horizontally. More... | |
Glib::PropertyProxy_ReadOnly< int > | property_margin_end () const |
Margin on end of widget, horizontally. More... | |
Glib::PropertyProxy< int > | property_margin_top () |
Margin on top side of widget. More... | |
Glib::PropertyProxy_ReadOnly< int > | property_margin_top () const |
Margin on top side of widget. More... | |
Glib::PropertyProxy< int > | property_margin_bottom () |
Margin on bottom side of widget. More... | |
Glib::PropertyProxy_ReadOnly< int > | property_margin_bottom () const |
Margin on bottom side of widget. More... | |
Glib::PropertyProxy< int > | property_margin () |
Sets all four sides' margin at once. More... | |
Glib::PropertyProxy_ReadOnly< int > | property_margin () const |
Sets all four sides' margin at once. More... | |
Glib::PropertyProxy< bool > | property_hexpand () |
Whether to expand horizontally. More... | |
Glib::PropertyProxy_ReadOnly< bool > | property_hexpand () const |
Whether to expand horizontally. More... | |
Glib::PropertyProxy< bool > | property_hexpand_set () |
Whether to use the Gtk::Widget::property_hexpand() property. More... | |
Glib::PropertyProxy_ReadOnly< bool > | property_hexpand_set () const |
Whether to use the Gtk::Widget::property_hexpand() property. More... | |
Glib::PropertyProxy< bool > | property_vexpand () |
Whether to expand vertically. More... | |
Glib::PropertyProxy_ReadOnly< bool > | property_vexpand () const |
Whether to expand vertically. More... | |
Glib::PropertyProxy< bool > | property_vexpand_set () |
Whether to use the Gtk::Widget::property_vexpand() property. More... | |
Glib::PropertyProxy_ReadOnly< bool > | property_vexpand_set () const |
Whether to use the Gtk::Widget::property_vexpand() property. More... | |
Glib::PropertyProxy< bool > | property_expand () |
Whether to expand in both directions. More... | |
Glib::PropertyProxy_ReadOnly< bool > | property_expand () const |
Whether to expand in both directions. More... | |
Glib::PropertyProxy< double > | property_opacity () |
The requested opacity of the widget. More... | |
Glib::PropertyProxy_ReadOnly< double > | property_opacity () const |
The requested opacity of the widget. More... | |
Glib::PropertyProxy_ReadOnly< int > | property_scale_factor () const |
The scale factor of the widget. More... | |
Public Member Functions inherited from Gtk::Object | |
Object (Object&& src) noexcept | |
Object& | operator= (Object&& src) noexcept |
~Object () noexceptoverride | |
GObject* | gobj () |
Provides access to the underlying C GtkObject. More... | |
const GObject* | gobj () const |
Provides access to the underlying C GtkObject. More... | |
Public Member Functions inherited from Glib::Object | |
Object (const Object &)=delete | |
Object & | operator= (const Object &)=delete |
Object (Object &&src) noexcept | |
Object & | operator= (Object &&src) noexcept |
void * | get_data (const QueryQuark &key) |
void | set_data (const Quark &key, void *data) |
void | set_data (const Quark &key, void *data, DestroyNotify notify) |
void | remove_data (const QueryQuark &quark) |
void * | steal_data (const QueryQuark &quark) |
Glib::RefPtr< Glib::Object > | wrap (GObject *object, bool take_copy=false) |
Public Member Functions inherited from Glib::ObjectBase | |
ObjectBase (const ObjectBase &)=delete | |
ObjectBase & | operator= (const ObjectBase &)=delete |
void | set_property_value (const Glib::ustring &property_name, const Glib::ValueBase &value) |
void | get_property_value (const Glib::ustring &property_name, Glib::ValueBase &value) const |
void | set_property (const Glib::ustring &property_name, const PropertyType &value) |
void | get_property (const Glib::ustring &property_name, PropertyType &value) const |
void | connect_property_changed (const Glib::ustring &property_name, const sigc::slot< void > &slot) |
void | connect_property_changed (const Glib::ustring &property_name, sigc::slot< void > &&slot) |
sigc::connection | connect_property_changed_with_return (const Glib::ustring &property_name, const sigc::slot< void > &slot) |
sigc::connection | connect_property_changed_with_return (const Glib::ustring &property_name, sigc::slot< void > &&slot) |
void | freeze_notify () |
void | thaw_notify () |
virtual void | reference () const |
virtual void | unreference () const |
GObject * | gobj () |
const GObject * | gobj () const |
GObject * | gobj_copy () const |
Public Member Functions inherited from sigc::trackable | |
trackable () noexcept | |
trackable (const trackable &src) noexcept | |
trackable (trackable &&src) | |
~trackable () | |
void | add_destroy_notify_callback (void *data, func_destroy_notify func) const |
void | notify_callbacks () |
trackable & | operator= (const trackable &src) |
trackable & | operator= (trackable &&src) |
void | remove_destroy_notify_callback (void *data) const |
Public Member Functions inherited from Gtk::Buildable | |
Buildable (Buildable&& src) noexcept | |
Buildable& | operator= (Buildable&& src) noexcept |
~Buildable () noexceptoverride | |
GtkBuildable* | gobj () |
Provides access to the underlying C GObject. More... | |
const GtkBuildable* | gobj () const |
Provides access to the underlying C GObject. More... | |
void | set_name (const Glib::ustring& name) |
Sets the name of the buildable object. More... | |
Glib::ustring | get_name () const |
Gets the name of the buildable object. More... | |
Public Member Functions inherited from Glib::Interface | |
Interface () | |
Interface (Interface &&src) noexcept | |
Interface & | operator= (Interface &&src) noexcept |
Interface (const Glib::Interface_Class &interface_class) | |
Interface (GObject *castitem) | |
~Interface () noexceptoverride | |
Interface (const Interface &)=delete | |
Interface & | operator= (const Interface &)=delete |
GObject * | gobj () |
const GObject * | gobj () const |
Public Member Functions inherited from Atk::Implementor | |
Implementor (Implementor &&src) noexcept | |
Implementor & | operator= (Implementor &&src) noexcept |
~Implementor () noexceptoverride | |
AtkImplementor * | gobj () |
const AtkImplementor * | gobj () const |
Glib::RefPtr< Atk::Implementor > | wrap (AtkImplementor *object, bool take_copy=false) |
Static Public Member Functions | |
static GType | get_type () |
Get the GType for this class, for use with the underlying GObject type system. More... | |
Static Public Member Functions inherited from Gtk::Misc | |
static GType | get_type () |
Get the GType for this class, for use with the underlying GObject type system. More... | |
Static Public Member Functions inherited from Gtk::Widget | |
static GType | get_type () |
Get the GType for this class, for use with the underlying GObject type system. More... | |
static Widget* | get_current_modal_grab () |
Retrieve the widget which is currently grabbing all events. More... | |
static void | push_composite_child () |
Makes all newly-created widgets as composite children until the corresponding pop_composite_child() call. More... | |
static void | pop_composite_child () |
Cancels the effect of a previous call to push_composite_child(). More... | |
static void | set_default_direction (TextDirection dir) |
Sets the default reading direction for widgets where the direction has not been explicitly set by set_direction(). More... | |
static TextDirection | get_default_direction () |
Obtains the current default reading direction. More... | |
static Widget* | drag_get_source_widget (const Glib::RefPtr< Gdk::DragContext >& context) |
Static Public Member Functions inherited from Gtk::Buildable | |
static void | add_interface (GType gtype_implementer) |
static GType | get_type () |
Get the GType for this class, for use with the underlying GObject type system. More... | |
Static Public Member Functions inherited from Atk::Implementor | |
static void | add_interface (GType gtype_implementer) |
static GType | get_type () |
Related Functions | |
(Note that these are not member functions.) | |
Gtk::Image* | wrap (GtkImage* object, bool take_copy=false) |
A Glib::wrap() method for this object. More... | |
Related Functions inherited from Gtk::Misc | |
Gtk::Misc* | wrap (GtkMisc* object, bool take_copy=false) |
A Glib::wrap() method for this object. More... | |
Related Functions inherited from Gtk::Widget | |
Gtk::Widget* | wrap (GtkWidget* object, bool take_copy=false) |
A Glib::wrap() method for this object. More... | |
Related Functions inherited from Gtk::Buildable | |
Glib::RefPtr< Gtk::Buildable > | wrap (GtkBuildable* object, bool take_copy=false) |
A Glib::wrap() method for this object. More... | |
Additional Inherited Members | |
Public Types inherited from Glib::Object | |
typedef void(*)(gpointer data | DestroyNotify) |
Public Types inherited from sigc::trackable | |
typedef internal::func_destroy_notify | func_destroy_notify |
Protected Member Functions inherited from Gtk::Misc | |
Misc () | |
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_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_updated () |
This is a default handler for the signal signal_style_updated(). 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* gdk_event) |
This is a default handler for the signal signal_event(). More... | |
virtual bool | on_button_press_event (GdkEventButton* button_event) |
This is a default handler for the signal signal_button_press_event(). More... | |
virtual bool | on_button_release_event (GdkEventButton* release_event) |
This is a default handler for the signal signal_button_release_event(). More... | |
virtual bool | on_scroll_event (GdkEventScroll* scroll_event) |
This is a default handler for the signal signal_scroll_event(). More... | |
virtual bool | on_motion_notify_event (GdkEventMotion* motion_event) |
This is a default handler for the signal signal_motion_notify_event(). More... | |
virtual bool | on_delete_event (GdkEventAny* any_event) |
This is a default handler for the signal signal_delete_event(). More... | |
virtual bool | on_draw (const ::Cairo::RefPtr< ::Cairo::Context >& cr) |
This is a default handler for the signal signal_draw(). More... | |
virtual bool | on_key_press_event (GdkEventKey* key_event) |
This is a default handler for the signal signal_key_press_event(). More... | |
virtual bool | on_key_release_event (GdkEventKey* key_event) |
This is a default handler for the signal signal_key_release_event(). More... | |
virtual bool | on_enter_notify_event (GdkEventCrossing* crossing_event) |
This is a default handler for the signal signal_enter_notify_event(). More... | |
virtual bool | on_leave_notify_event (GdkEventCrossing* crossing_event) |
This is a default handler for the signal signal_leave_notify_event(). More... | |
virtual bool | on_configure_event (GdkEventConfigure* configure_event) |
This is a default handler for the signal signal_configure_event(). More... | |
virtual bool | on_focus_in_event (GdkEventFocus* focus_event) |
This is a default handler for the signal signal_focus_in_event(). More... | |
virtual bool | on_focus_out_event (GdkEventFocus* gdk_event) |
This is a default handler for the signal signal_focus_out_event(). More... | |
virtual bool | on_map_event (GdkEventAny* any_event) |
This is a default handler for the signal signal_map_event(). More... | |
virtual bool | on_unmap_event (GdkEventAny* any_event) |
This is a default handler for the signal signal_unmap_event(). More... | |
virtual bool | on_property_notify_event (GdkEventProperty* property_event) |
This is a default handler for the signal signal_property_notify_event(). More... | |
virtual bool | on_selection_clear_event (GdkEventSelection* selection_event) |
This is a default handler for the signal signal_selection_clear_event(). More... | |
virtual bool | on_selection_request_event (GdkEventSelection* selection_event) |
This is a default handler for the signal signal_selection_request_event(). More... | |
virtual bool | on_selection_notify_event (GdkEventSelection* selection_event) |
This is a default handler for the signal signal_selection_notify_event(). More... | |
virtual bool | on_proximity_in_event (GdkEventProximity* proximity_event) |
This is a default handler for the signal signal_proximity_in_event(). More... | |
virtual bool | on_proximity_out_event (GdkEventProximity* proximity_event) |
This is a default handler for the signal signal_proximity_out_event(). More... | |
virtual bool | on_visibility_notify_event (GdkEventVisibility* visibility_event) |
This is a default handler for the signal signal_visibility_notify_event(). More... | |
virtual bool | on_window_state_event (GdkEventWindowState* window_state_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 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 Glib::RefPtr< Atk::Object > | get_accessible_vfunc () |
virtual SizeRequestMode | get_request_mode_vfunc () const |
virtual void | get_preferred_width_vfunc (int& minimum_width, int& natural_width) const |
virtual void | get_preferred_height_for_width_vfunc (int width, int& minimum_height, int& natural_height) const |
virtual void | get_preferred_height_vfunc (int& minimum_height, int& natural_height) const |
virtual void | get_preferred_width_for_height_vfunc (int height, int& minimum_width, int& natural_width) const |
Widget () | |
void | realize () |
Creates the GDK (windowing system) resources associated with a widget. More... | |
void | unrealize () |
This function is only useful in widget implementations. More... | |
void | draw (const ::Cairo::RefPtr< ::Cairo::Context >& cr) |
Draws widget to cr. More... | |
void | set_mapped (bool mapped=true) |
Marks the widget as being realized. More... | |
void | set_realized (bool realized=true) |
Marks the widget as being realized. More... | |
void | set_has_window (bool has_window=true) |
Specifies whether widget has a Gdk::Window of its own. More... | |
void | set_window (const Glib::RefPtr< Gdk::Window >& window) |
Sets a widget's window. More... | |
void | transform_cairo_context_to_window (const ::Cairo::RefPtr< ::Cairo::Context >& cr, const Glib::RefPtr< const Gdk::Window >& window) |
Transforms the given cairo context cr from widget-relative coordinates to window-relative coordinates. More... | |
Requisition | get_requisition () const |
Retrieves the widget's requisition. More... | |
void | get_style_property_value (const Glib::ustring& the_property_name, Glib::ValueBase& value) const |
Gets the value of a style property of widget. More... | |
void | realize_if_needed () |
Protected Member Functions inherited from Glib::Object | |
Object () | |
Object (const Glib::ConstructParams &construct_params) | |
Object (GObject *castitem) | |
~Object () noexceptoverride | |
Protected Member Functions inherited from Glib::ObjectBase | |
ObjectBase () | |
ObjectBase (const char *custom_type_name) | |
ObjectBase (const std::type_info &custom_type_info) | |
ObjectBase (ObjectBase &&src) noexcept | |
ObjectBase & | operator= (ObjectBase &&src) noexcept |
virtual | ~ObjectBase () noexcept=0 |
void | initialize (GObject *castitem) |
void | initialize_move (GObject *castitem, Glib::ObjectBase *previous_wrapper) |
Protected Member Functions inherited from Gtk::Buildable | |
Buildable () | |
You should derive from this class to use it. More... | |
Protected Member Functions inherited from Atk::Implementor | |
Implementor () | |
virtual Glib::RefPtr< Object > | ref_accessibile_vfunc () |
Static Protected Member Functions inherited from Gtk::Widget | |
static bool | should_draw_window (const ::Cairo::RefPtr< const ::Cairo::Context >& cr, const Glib::RefPtr< const Gdk::Window >& window) |
This function is supposed to be called in Gtk::Widget::signal_draw() implementations for widgets that support multiple windows. More... | |
Detailed Description
A widget displaying an image.
The Gtk::Image widget displays an image. Various kinds of object can be displayed as an image; most typically, you would load a Gdk::Pixbuf ("pixel buffer") from a file, and then display that.
Gtk::Image is a subclass of Gtk::Misc, which implies that you can align it (center, left, right) and add padding to it, using Gtk::Misc methods.
Gtk::Image is a "no window" widget (has no Gdk::Window of its own), so by default does not receive events. If you want to receive events on the image, such as button clicks, place the image inside a Gtk::EventBox, then connect to the event signals on the event box.
The Image widget looks like this:
Constructor & Destructor Documentation
|
noexcept |
|
delete |
|
overridenoexcept |
Gtk::Image::Image | ( | ) |
|
explicit |
Creates an Image widget displaying the file filename.
If the file isn't found or can't be loaded, the resulting Gtk::Image will display a "broken image" icon.
If the file contains an animation, the image will contain an animation.
If you need to detect failures to load the file, use Gdk::Pixbuf::create_from_file() to load the file yourself, then create the GtkImage from the pixbuf. (Or for animations, use Gdk::PixbufAnimation::create_from_file()).
The storage type (get_storage_type()) of the returned image is not defined. It will be whatever is appropriate for displaying the file.
|
explicit |
Creates a new Image widget displaying pixbuf.
Note that this just creates an GtkImage from the pixbuf. The Gtk::Image created will not react to state changes. Should you want that, you should use the default constructor and set_from_icon_name().
Gtk::Image::Image | ( | const Gtk::StockID& | stock_id, |
IconSize | size | ||
) |
Creates am Image displaying a stock icon.
Sample stock icon identifiers are Gtk::Stock::OPEN, Gtk::Stock::EXIT. Sample stock sizes are Gtk::ICON_SIZE_MENU, Gtk::ICON_SIZE_SMALL_TOOLBAR. If the stock icon name isn't known, a "broken image" icon will be displayed instead. You can register your own stock icon names - see Gtk::IconFactory::add().
- Parameters
-
stock_id A stock icon. size A stock icon size.
- Deprecated:
- Use the default constructor and set_from_icon_name() instead.
Gtk::Image::Image | ( | const Glib::RefPtr< IconSet >& | icon_set, |
IconSize | size | ||
) |
- Deprecated:
- Use the default constructor and set_from_icon_name() instead.
|
explicit |
Member Function Documentation
void Gtk::Image::clear | ( | ) |
Resets the image to be empty.
Glib::RefPtr<Gdk::PixbufAnimation> Gtk::Image::get_animation | ( | ) |
Gets the Gdk::PixbufAnimation being displayed by the Gtk::Image.
The storage type of the image must be Gtk::IMAGE_EMPTY or Gtk::IMAGE_ANIMATION (see get_storage_type()). The caller of this function does not own a reference to the returned animation.
- Returns
- The displayed animation, or
nullptr
if the image is empty.
Glib::RefPtr<const Gdk::PixbufAnimation> Gtk::Image::get_animation | ( | ) | const |
Gets the Gdk::PixbufAnimation being displayed by the Gtk::Image.
The storage type of the image must be Gtk::IMAGE_EMPTY or Gtk::IMAGE_ANIMATION (see get_storage_type()). The caller of this function does not own a reference to the returned animation.
- Returns
- The displayed animation, or
nullptr
if the image is empty.
Glib::RefPtr<Gio::Icon> Gtk::Image::get_gicon | ( | Gtk::IconSize& | icon_size | ) |
Gets the Gio::Icon and size being displayed by the Gtk::Image.
The storage type of the image must be IMAGE_EMPTY or IMAGE_GICON (see get_storage_type()).
- Parameters
-
icon_size A place to store an icon size.
Glib::RefPtr<const Gio::Icon> Gtk::Image::get_gicon | ( | Gtk::IconSize& | icon_size | ) | const |
Gets the Gio::Icon and size being displayed by the Gtk::Image.
The storage type of the image must be IMAGE_EMPTY or IMAGE_GICON (see get_storage_type()).
- Parameters
-
icon_size A place to store an icon size.
Glib::ustring Gtk::Image::get_icon_name | ( | ) | const |
Glib::ustring Gtk::Image::get_icon_name | ( | IconSize& | size | ) |
void Gtk::Image::get_icon_set | ( | Glib::RefPtr< IconSet >& | icon_set, |
IconSize& | size | ||
) | const |
- Deprecated:
- Use get_icon_name() instead.
Glib::RefPtr<Gdk::Pixbuf> Gtk::Image::get_pixbuf | ( | ) |
Gets the Gdk::Pixbuf being displayed by the Gtk::Image.
The storage type of the image must be Gtk::IMAGE_EMPTY or Gtk::IMAGE_PIXBUF (see get_storage_type()). The caller of this function does not own a reference to the returned pixbuf.
- Returns
- The displayed pixbuf, or
nullptr
if the image is empty.
Glib::RefPtr<const Gdk::Pixbuf> Gtk::Image::get_pixbuf | ( | ) | const |
Gets the Gdk::Pixbuf being displayed by the Gtk::Image.
The storage type of the image must be Gtk::IMAGE_EMPTY or Gtk::IMAGE_PIXBUF (see get_storage_type()). The caller of this function does not own a reference to the returned pixbuf.
- Returns
- The displayed pixbuf, or
nullptr
if the image is empty.
int Gtk::Image::get_pixel_size | ( | ) | const |
Gets the pixel size used for named icons.
- Returns
- The pixel size used for named icons.
void Gtk::Image::get_stock | ( | Gtk::StockID& | stock_id, |
IconSize& | size | ||
) | const |
- Deprecated:
- Use get_icon_name() instead.
ImageType Gtk::Image::get_storage_type | ( | ) | const |
Gets the type of representation being used by the Gtk::Image to store image data.
If the Gtk::Image has no image data, the return value will be Gtk::IMAGE_EMPTY.
- Returns
- Image representation being used.
|
static |
Get the GType for this class, for use with the underlying GObject type system.
|
inline |
Provides access to the underlying C GtkObject.
|
inline |
Provides access to the underlying C GtkObject.
Glib::PropertyProxy< Glib::ustring > Gtk::Image::property_file | ( | ) |
Filename to load and display.
- 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.
Glib::PropertyProxy_ReadOnly< Glib::ustring > Gtk::Image::property_file | ( | ) | const |
Filename to load and display.
- Returns
- A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.
Glib::PropertyProxy< Glib::RefPtr<Gio::Icon> > Gtk::Image::property_gicon | ( | ) |
The GIcon displayed in the GtkImage.
For themed icons, If the icon theme is changed, the image will be updated automatically.
- 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.
Glib::PropertyProxy_ReadOnly< Glib::RefPtr<Gio::Icon> > Gtk::Image::property_gicon | ( | ) | const |
The GIcon displayed in the GtkImage.
For themed icons, If the icon theme is changed, the image will be updated automatically.
- Returns
- A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.
Glib::PropertyProxy< Glib::ustring > Gtk::Image::property_icon_name | ( | ) |
The name of the icon in the icon theme.
If the icon theme is changed, the image will be updated automatically.
- 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.
Glib::PropertyProxy_ReadOnly< Glib::ustring > Gtk::Image::property_icon_name | ( | ) | const |
The name of the icon in the icon theme.
If the icon theme is changed, the image will be updated automatically.
- Returns
- A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.
Glib::PropertyProxy< Glib::RefPtr<IconSet> > Gtk::Image::property_icon_set | ( | ) |
Icon set to display.
Deprecated: 3.10: Use Gtk::Image::property_icon_name() instead.
- Deprecated:
- Use property_icon_name() instead.
- 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.
Glib::PropertyProxy_ReadOnly< Glib::RefPtr<IconSet> > Gtk::Image::property_icon_set | ( | ) | const |
Icon set to display.
Deprecated: 3.10: Use Gtk::Image::property_icon_name() instead.
- Deprecated:
- Use property_icon_name() instead.
- Returns
- A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.
Glib::PropertyProxy< int > Gtk::Image::property_icon_size | ( | ) |
Symbolic size to use for stock icon, icon set or named icon.
- 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.
Glib::PropertyProxy_ReadOnly< int > Gtk::Image::property_icon_size | ( | ) | const |
Symbolic size to use for stock icon, icon set or named icon.
- Returns
- A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.
Glib::PropertyProxy< Glib::RefPtr<Gdk::Pixbuf> > Gtk::Image::property_pixbuf | ( | ) |
A GdkPixbuf to display.
- 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.
Glib::PropertyProxy_ReadOnly< Glib::RefPtr<Gdk::Pixbuf> > Gtk::Image::property_pixbuf | ( | ) | const |
A GdkPixbuf to display.
- Returns
- A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.
Glib::PropertyProxy< Glib::RefPtr<Gdk::PixbufAnimation> > Gtk::Image::property_pixbuf_animation | ( | ) |
GdkPixbufAnimation to display.
- 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.
Glib::PropertyProxy_ReadOnly< Glib::RefPtr<Gdk::PixbufAnimation> > Gtk::Image::property_pixbuf_animation | ( | ) | const |
GdkPixbufAnimation to display.
- Returns
- A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.
Glib::PropertyProxy< int > Gtk::Image::property_pixel_size | ( | ) |
The "pixel-size" property can be used to specify a fixed size overriding the Gtk::Image::property_icon_size() property for images of type Gtk::IMAGE_ICON_NAME.
- 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.
Glib::PropertyProxy_ReadOnly< int > Gtk::Image::property_pixel_size | ( | ) | const |
The "pixel-size" property can be used to specify a fixed size overriding the Gtk::Image::property_icon_size() property for images of type Gtk::IMAGE_ICON_NAME.
- Returns
- A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.
Glib::PropertyProxy< std::string > Gtk::Image::property_resource | ( | ) |
A path to a resource file to display.
- 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.
Glib::PropertyProxy_ReadOnly< std::string > Gtk::Image::property_resource | ( | ) | const |
A path to a resource file to display.
- Returns
- A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.
Glib::PropertyProxy< Glib::ustring > Gtk::Image::property_stock | ( | ) |
Stock ID for a stock image to display.
Deprecated: 3.10: Use Gtk::Image::property_icon_name() instead.
- Deprecated:
- Use property_icon_name() instead.
- 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.
Glib::PropertyProxy_ReadOnly< Glib::ustring > Gtk::Image::property_stock | ( | ) | const |
Stock ID for a stock image to display.
Deprecated: 3.10: Use Gtk::Image::property_icon_name() instead.
- Deprecated:
- Use property_icon_name() instead.
- Returns
- A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.
Glib::PropertyProxy_ReadOnly< ImageType > Gtk::Image::property_storage_type | ( | ) | const |
The representation being used for image data.
- Returns
- A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.
Glib::PropertyProxy< ::Cairo::RefPtr< ::Cairo::Surface> > Gtk::Image::property_surface | ( | ) |
A cairo_surface_t to display.
- 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.
Glib::PropertyProxy_ReadOnly< ::Cairo::RefPtr< ::Cairo::Surface> > Gtk::Image::property_surface | ( | ) | const |
A cairo_surface_t to display.
- Returns
- A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.
Glib::PropertyProxy< bool > Gtk::Image::property_use_fallback | ( | ) |
Whether the icon displayed in the GtkImage will use standard icon names fallback.
The value of this property is only relevant for images of type Gtk::IMAGE_ICON_NAME and Gtk::IMAGE_GICON.
- 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.
Glib::PropertyProxy_ReadOnly< bool > Gtk::Image::property_use_fallback | ( | ) | const |
Whether the icon displayed in the GtkImage will use standard icon names fallback.
The value of this property is only relevant for images of type Gtk::IMAGE_ICON_NAME and Gtk::IMAGE_GICON.
- Returns
- A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.
void Gtk::Image::set | ( | const std::string & | filename | ) |
See the Image::Image(const std::string& file) constructor for details.
- Parameters
-
filename A filename.
void Gtk::Image::set | ( | const Glib::RefPtr< Gdk::Pixbuf >& | pixbuf | ) |
See the Image::Image(const Glib::RefPtr<Gdk::Pixbuf>& pixbuf) constructor for details.
- Parameters
-
pixbuf A Gdk::Pixbuf.
void Gtk::Image::set | ( | const Gtk::StockID& | stock_id, |
IconSize | size | ||
) |
See the Image::Image(const Gtk::StockID& stock_id, IconSize size) constructor for details.
- Deprecated:
- Use set_from_icon_name() instead.
- Parameters
-
stock_id A stock icon name. size A stock icon size (Gtk::IconSize).
void Gtk::Image::set | ( | const Glib::RefPtr< IconSet >& | icon_set, |
IconSize | size | ||
) |
See new_from_icon_set() for details.
Deprecated: 3.10: Use set_from_icon_name() instead.
- Deprecated:
- Use set_from_icon_name() instead.
- Parameters
-
icon_set A Gtk::IconSet. size A stock icon size (Gtk::IconSize).
void Gtk::Image::set | ( | const Glib::RefPtr< Gdk::PixbufAnimation >& | animation | ) |
Causes the Gtk::Image to display the given animation (or display nothing, if you set the animation to nullptr
).
- Parameters
-
animation The Gdk::PixbufAnimation.
void Gtk::Image::set | ( | const Glib::RefPtr< const Gio::Icon > & | icon, |
IconSize | size | ||
) |
See new_from_gicon() for details.
- Parameters
-
icon An icon. size An icon size (Gtk::IconSize).
void Gtk::Image::set | ( | const ::Cairo::RefPtr< ::Cairo::Surface > & | surface | ) |
void Gtk::Image::set_from_icon_name | ( | const Glib::ustring & | icon_name, |
IconSize | size | ||
) |
Causes the Image to display an icon from the current icon theme.
If the icon name isn't known, a "broken image" icon will be displayed instead. If the current icon theme is changed, the icon will be updated appropriately.
- Parameters
-
icon_name An icon name. size An icon size (Gtk::IconSize).
void Gtk::Image::set_from_resource | ( | const std::string & | resource_path | ) |
See new_from_resource() for details.
- Parameters
-
resource_path A resource path or nullptr
.
void Gtk::Image::set_pixel_size | ( | int | pixel_size | ) |
Sets the pixel size to use for named icons.
If the pixel size is set to a value != -1, it is used instead of the icon size set by set_from_icon_name().
- Parameters
-
pixel_size The new pixel size.
Friends And Related Function Documentation
|
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.