GtkImage icon-size/pixel-size and GIcon


The methods set_icon_size() and set_pixel_size() of GtkImage are only documented for the icon-name property. But it seems that they also work for the gicon property.

I didn’t do systematic tests with all possible implementations of GIcon, but the few tests I did didn’t allow me to fault this, even when the GIcon is a GdkPixbuf (even if in GTK 3 icon-size is ignored in this case, but not pixel-size).

So my question is twofold:

  • Why are these methods not documented for GIcon?
  • Is it safe to use them in this case and expect that it will continue to work in the future?