Gtk::IconSource Class Reference


Public Methods
	IconSource ()
	IconSource (GtkIconSource* gobject, bool make_a_copy=true)
	IconSource (const IconSource& other)
IconSource&	operator= (const IconSource& other)
	~IconSource ()
void	swap (IconSource& other)
GtkIconSource*	gobj ()
const GtkIconSource*	gobj () const
GtkIconSource*	gobj_copy () const
void	set_filename (const Glib::ustring& filename)
	Sets the name of an image file to use as a base image when creating icon variants for Gtk::IconSet.
void	set_pixbuf (const Glib::RefPtr<Gdk::Pixbuf>& pixbuf)
	Sets a pixbuf to use as a base image when creating icon variants for Gtk::IconSet.
Glib::ustring	get_filename () const
	Retrieves the source filename, or `0` if none is set.
Glib::RefPtr<Gdk::Pixbuf>	get_pixbuf ()
	Retrieves the source pixbuf, or `0` if none is set.
void	set_direction_wildcarded (bool setting=true)
	If the text direction is wildcarded, this source can be used as the base image for an icon in any Gtk::TextDirection.
void	set_state_wildcarded (bool setting=true)
	If the widget state is wildcarded, this source can be used as the base image for an icon in any Gtk::StateType.
void	set_size_wildcarded (bool setting=true)
	If the icon size is wildcarded, this source can be used as the base image for an icon of any size.
bool	get_size_wildcarded () const
	Gets the value set by gtk_icon_source_set_size_wildcarded().
bool	get_state_wildcarded () const
	Gets the value set by gtk_icon_source_set_state_wildcarded().
bool	get_direction_wildcarded () const
	Gets the value set by gtk_icon_source_set_direction_wildcarded().
void	set_direction (TextDirection direction)
	Sets the text direction this icon source is intended to be used with.
void	set_state (StateType state)
	Sets the widget state this icon source is intended to be used with.
void	set_size (IconSize size)
	Sets the icon size this icon source is intended to be used with.
TextDirection	get_direction () const
	Obtains the text direction this icon source applies to.
StateType	get_state () const
	Obtains the widget state this icon source applies to.
IconSize	get_size () const
	Obtains the icon size this source applies to.
Protected Attributes
GtkIconSource*	gobject_
Related Functions
(Note that these are not member functions.)
void	swap (IconSource& lhs, IconSource& rhs)
Gtk::IconSource	wrap (GtkIconSource* object, bool take_copy=false)

Constructor & Destructor Documentation

Gtk::IconSource::IconSource ( )

Gtk::IconSource::IconSource ( GtkIconSource* gobject,

bool make_a_copy = true

) [explicit]

Gtk::IconSource::IconSource ( const IconSource& other )

Gtk::IconSource::~IconSource ( )

Member Function Documentation

TextDirection Gtk::IconSource::get_direction ( ) const

Obtains the text direction this icon source applies to.
The return value is only useful/meaningful if the text direction is not wildcarded.
Returns:
Text direction this source matches.

bool Gtk::IconSource::get_direction_wildcarded ( ) const

Gets the value set by gtk_icon_source_set_direction_wildcarded().

Returns:
true if this icon source is a base for any text direction variant.

Glib::ustring Gtk::IconSource::get_filename ( ) const

Retrieves the source filename, or 0 if none is set.
The filename is not a copy, and should not be modified or expected to persist beyond the lifetime of the icon source.
Returns:
Image filename. This string must not be modified or freed.

Glib::RefPtr<Gdk::Pixbuf> Gtk::IconSource::get_pixbuf ( )

Retrieves the source pixbuf, or 0 if none is set.
The reference count on the pixbuf is not incremented.
Returns:
Source pixbuf.

IconSize Gtk::IconSource::get_size ( ) const

Obtains the icon size this source applies to.
The return value is only useful/meaningful if the icon size is not wildcarded.
Returns:
Icon size this source matches.

bool Gtk::IconSource::get_size_wildcarded ( ) const

Gets the value set by gtk_icon_source_set_size_wildcarded().

Returns:
true if this icon source is a base for any icon size variant.

StateType Gtk::IconSource::get_state ( ) const

Obtains the widget state this icon source applies to.
The return value is only useful/meaningful if the widget state is not wildcarded.
Returns:
Widget state this source matches.

bool Gtk::IconSource::get_state_wildcarded ( ) const

Gets the value set by gtk_icon_source_set_state_wildcarded().

Returns:
true if this icon source is a base for any widget state variant.

const GtkIconSource* Gtk::IconSource::gobj ( ) const [inline]

GtkIconSource* Gtk::IconSource::gobj ( ) [inline]

GtkIconSource* Gtk::IconSource::gobj_copy ( ) const

IconSource& Gtk::IconSource::operator= ( const IconSource& other )

void Gtk::IconSource::set_direction ( TextDirection direction )

Sets the text direction this icon source is intended to be used with.
Setting the text direction on an icon source makes no difference if the text direction is wildcarded. Therefore, you should usually call gtk_icon_source_set_direction_wildcarded() to un-wildcard it in addition to calling this function.
Parameters:

direction Text direction this source applies to.

void Gtk::IconSource::set_direction_wildcarded ( bool setting = true )

If the text direction is wildcarded, this source can be used as the base image for an icon in any Gtk::TextDirection.
If the text direction is not wildcarded, then the text direction the icon source applies to should be set with gtk_icon_source_set_direction(), and the icon source will only be used with that text direction.
Gtk::IconSet prefers non-wildcarded sources (exact matches) over wildcarded sources, and will use an exact match when possible.
Parameters:

setting true to wildcard the text direction.

void Gtk::IconSource::set_filename ( const Glib::ustring& filename )

Sets the name of an image file to use as a base image when creating icon variants for Gtk::IconSet.
The filename must be absolute.
Parameters:

filename Image file to use.

void Gtk::IconSource::set_pixbuf ( const Glib::RefPtr<Gdk::Pixbuf>& pixbuf )

Sets a pixbuf to use as a base image when creating icon variants for Gtk::IconSet.
If an icon source has both a filename and a pixbuf set, the pixbuf will take priority.
Parameters:

pixbuf Pixbuf to use as a source.

void Gtk::IconSource::set_size ( IconSize size )

Sets the icon size this icon source is intended to be used with.
Setting the icon size on an icon source makes no difference if the size is wildcarded. Therefore, you should usually call gtk_icon_source_set_size_wildcarded() to un-wildcard it in addition to calling this function.
Parameters:

size Icon size this source applies to.

void Gtk::IconSource::set_size_wildcarded ( bool setting = true )

If the icon size is wildcarded, this source can be used as the base image for an icon of any size.
If the size is not wildcarded, then the size the source applies to should be set with gtk_icon_source_set_size() and the icon source will only be used with that specific size.
Gtk::IconSet prefers non-wildcarded sources (exact matches) over wildcarded sources, and will use an exact match when possible.
Gtk::IconSet will normally scale wildcarded source images to produce an appropriate icon at a given size, but will not change the size of source images that match exactly.
Parameters:

setting true to wildcard the widget state.

void Gtk::IconSource::set_state ( StateType state )

Sets the widget state this icon source is intended to be used with.
Setting the widget state on an icon source makes no difference if the state is wildcarded. Therefore, you should usually call gtk_icon_source_set_state_wildcarded() to un-wildcard it in addition to calling this function.
Parameters:

state Widget state this source applies to.

void Gtk::IconSource::set_state_wildcarded ( bool setting = true )

If the widget state is wildcarded, this source can be used as the base image for an icon in any Gtk::StateType.
If the widget state is not wildcarded, then the state the source applies to should be set with gtk_icon_source_set_state() and the icon source will only be used with that specific state.
Gtk::IconSet prefers non-wildcarded sources (exact matches) over wildcarded sources, and will use an exact match when possible.
Gtk::IconSet will normally transform wildcarded source images to produce an appropriate icon for a given state, for example lightening an image on prelight, but will not modify source images that match exactly.
Parameters:

setting true to wildcard the widget state.

void Gtk::IconSource::swap ( IconSource& other )

Friends And Related Function Documentation

void swap ( IconSource& lhs,

IconSource& rhs

) [related]

Gtk::IconSource wrap ( GtkIconSource* object,

bool take_copy = false

) [related]

Member Data Documentation

GtkIconSource* Gtk::IconSource::gobject_ [protected]

The documentation for this class was generated from the following file:

iconsource.h

Gtk::IconSource Class Reference

Public Methods

Protected Attributes

Related Functions

Constructor & Destructor Documentation

Member Function Documentation

Friends And Related Function Documentation

Member Data Documentation