get_icon_url


Description:

public string get_icon_url (string? requested_mime_type, int requested_depth, int requested_width, int requested_height, bool prefer_bigger, out string mime_type, out int depth, out int width, out int height)

Get a URL pointing to the icon most closely matching the given criteria, or null.

If requested_mime_type is set, only icons with this mime type will be returned. If requested_depth is set, only icons with this or lower depth will be returned. If requested_width and/or requested_height are set, only icons that are this size or smaller are returned, unless prefer_bigger is set, in which case the next biggest icon will be returned. The returned strings should be freed.

Parameters:

this

A DeviceInfo

requested_mime_type

The requested file format, or null for any

requested_depth

The requested color depth, or -1 for any

requested_width

The requested width, or -1 for any

requested_height

The requested height, or -1 for any

prefer_bigger

true if a bigger, rather than a smaller icon should be returned if no exact match could be found

mime_type

The location where to store the the format of the returned icon, or null. The returned string should be freed after use

depth

The location where to store the depth of the returned icon, or null

width

The location where to store the width of the returned icon, or null

height

The location where to store the height of the returned icon, or null

Returns:

a string, or null. g_free after use.