![]() |
![]() |
![]() |
Exo Reference Manual | ![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy | Properties |
#include <exo/exo.h>
ExoCellRendererIcon;
GtkCellRenderer * exo_cell_renderer_icon_new (void
);
GObject +----GInitiallyUnowned +----GtkObject +----GtkCellRenderer +----ExoCellRendererIcon
"follow-state" gboolean : Read / Write / Construct "gicon" GIcon* : Read / Write "icon" gchar* : Read / Write "size" gint : Read / Write / Construct
An ExoCellRendererIcon can be used to render an icon in a cell. It allows to render either a named icon, which is looked up using the GtkIconTheme, or an image file loaded from the file system. The icon name or absolute path to the image file is set via the icon property.
To support the ExoIconView (and GtkIconView), ExoCellRendererIcon supports rendering icons based on the state of the view if the follow-state property is set.
typedef struct _ExoCellRendererIcon ExoCellRendererIcon;
The ExoIconChooserDialog struct contains only private fields and should not be directly accessed.
GtkCellRenderer * exo_cell_renderer_icon_new (void
);
Creates a new ExoCellRendererIcon. Adjust rendering parameters using object properties,
which can be set globally via g_object_set()
. Also, with GtkCellLayout and
GtkTreeViewColumn, you can bind a property to a value in a GtkTreeModel. For example
you can bind the icon property on the
cell renderer to an icon name in the model, thus rendering a different icon in each row
of the GtkTreeView.
Returns : |
the newly allocated ExoCellRendererIcon. |
Since 0.3.1.9
"follow-state"
property"follow-state" gboolean : Read / Write / Construct
Specifies whether the icon renderer should render icon based on the selection state of the items. This is necessary for ExoIconView, which doesn't draw any item state indicators itself.
Default value: TRUE
Since 0.3.1.9
"gicon"
property"gicon" GIcon* : Read / Write
The GIcon to render. May also be NULL
in which case no icon will be
rendered for the cell.
Currently only GThemedIcons are supported which are loaded using the current icon theme.
Since 0.4.0
"icon"
property"icon" gchar* : Read / Write
The name of the themed icon to render or an absolute path to an image file
to render. May also be NULL
in which case no icon will be rendered for the
cell.
Image files are loaded via the thumbnail database, creating a thumbnail as necessary. The thumbnail database is also used to load scalable icons in the icon theme, because loading scalable icons is quite expensive these days.
Default value: NULL
Since 0.3.1.9
"size"
property"size" gint : Read / Write / Construct
The size in pixel at which to render the icon. This is also the fixed size that the renderer will request no matter if the actual icons are smaller than this size.
This improves the performance of the layouting in the icon and tree view, because during the layouting phase no icons will need to be loaded, but the icons will only be loaded when they need to be rendered, i.e. the view scrolls to the cell.
Allowed values: >= 1
Default value: 48
Since 0.3.1.9