Gtk::IconSize Class Reference
Represents registered icon sizes. More...
Public Member Functions | |
| IconSize () | |
| IconSize (BuiltinIconSize size) | |
| IconSize (int size) | |
| operator int () const | |
Static Public Member Functions | |
| static bool | lookup (IconSize size, int& width, int& height) |
| Obtains the pixel size of a semantic icon size, possibly modified by user preferences for the default Gtk::Settings. | |
| static bool | lookup (IconSize size, int& width, int& height, const Glib::RefPtr< Gtk::Settings >& settings) |
| Obtains the pixel size of a semantic icon size, possibly modified by user preferences for a particular Gtk::Settings. | |
| static IconSize | register_new (const Glib::ustring& name, int width, int height) |
| Registers a new icon size, along the same lines as ICON_SIZE_MENU, etc. | |
| static void | register_alias (const Glib::ustring& alias, IconSize target) |
| Registers alias as another name for target so calling from_name() with alias as argument will return target. | |
| static IconSize | from_name (const Glib::ustring& name) |
| Looks up the icon size associated with name. | |
| static Glib::ustring | get_name (IconSize size) |
| Gets the canonical name of the given icon size. | |
Detailed Description
Represents registered icon sizes.You can also use a Gtk::BuiltinIconSize instead of an IconSize.
Constructor& Destructor Documentation
| Gtk::IconSize::IconSize | ( | ) | [inline] |
| Gtk::IconSize::IconSize | ( | BuiltinIconSize | size | ) | [inline] |
| Gtk::IconSize::IconSize | ( | int | size | ) | [inline, explicit] |
Member Function Documentation
| static IconSize Gtk::IconSize::from_name | ( | const Glib::ustring & | name | ) | [static] |
Looks up the icon size associated with name.
- Parameters:
-
name the name to look up. result The icon size with the given name.
| static Glib::ustring Gtk::IconSize::get_name | ( | IconSize | size | ) | [static] |
Gets the canonical name of the given icon size.
- Parameters:
-
size size AnIconSize.
- Returns:
- The name of the given icon size.
| static bool Gtk::IconSize::lookup | ( | IconSize | size, | |
| int & | width, | |||
| int & | height, | |||
| const Glib::RefPtr< Gtk::Settings >& | settings | |||
| ) | [static] |
Obtains the pixel size of a semantic icon size, possibly modified by user preferences for a particular Gtk::Settings.
Normally size would be Gtk::ICON_SIZE_MENU, Gtk::ICON_SIZE_BUTTON, etc. This function isn't normally needed because Gtk::Widget::render_icon() is the usual way to get an icon for rendering - then just look at the size of the rendered pixbuf. The rendered pixbuf may not even correspond to the width/height returned by IconSize::lookup(), because themes are free to render the pixbuf however they like, including changing the usual size.
- Parameters:
-
size An icon size. width Location to store icon width. height Location to store icon height. settings A Gtk::Settings object, used to determine which set of user preferences to used.
- Returns:
- true if size was a valid size.
| static bool Gtk::IconSize::lookup | ( | IconSize | size, | |
| int & | width, | |||
| int & | height | |||
| ) | [static] |
Obtains the pixel size of a semantic icon size, possibly modified by user preferences for the default Gtk::Settings.
Normally size would be Gtk::ICON_SIZE_MENU, Gtk::ICON_SIZE_BUTTON, etc. This function isn't normally needed because Gtk::Widget::render_icon() is the usual way to get an icon for rendering - then just look at the size of the rendered pixbuf. The rendered pixbuf may not even correspond to the width/height returned by IconSize::lookup(), because themes are free to render the pixbuf however they like, including changing the usual size.
- Parameters:
-
size An icon size. width Location to store icon width. height Location to store icon height.
- Returns:
- true if size was a valid size.
| Gtk::IconSize::operator int | ( | ) | const [inline] |
| static void Gtk::IconSize::register_alias | ( | const Glib::ustring & | alias, | |
| IconSize | target | |||
| ) | [static] |
Registers alias as another name for target so calling from_name() with alias as argument will return target.
- Parameters:
-
alias An alias for target. target An existing icon size.
| static IconSize Gtk::IconSize::register_new | ( | const Glib::ustring & | name, | |
| int | width, | |||
| int | height | |||
| ) | [static] |
Registers a new icon size, along the same lines as ICON_SIZE_MENU, etc.
Returns the integer value for the size.
- Parameters:
-
name Name of the icon size. width The icon width. height The icon height.
- Returns:
- Integer value representing the size.
The documentation for this class was generated from the following file:
- gtkmm/enums.h
