Function

GtkIconThemeget_for_screen

since: 2.4

Declaration [src]

GtkIconTheme*
gtk_icon_theme_get_for_screen (
  GdkScreen* screen
)

Description [src]

Gets the icon theme object associated with screen; if this function has not previously been called for the given screen, a new icon theme object will be created and associated with the screen. Icon theme objects are fairly expensive to create, so using this function is usually a better choice than calling than gtk_icon_theme_new() and setting the screen yourself; by using this function a single icon theme object will be shared between users.

Available since: 2.4

Parameters

screen

Type: GdkScreen

A GdkScreen.

The data is owned by the caller of the function.

Return value

Type: GtkIconTheme

A unique GtkIconTheme associated with the given screen. This icon theme is associated with the screen and can be used as long as the screen is open. Do not ref or unref it.

The data is owned by the called function.