Functions¶
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Details¶
- CinnamonDesktop.desktop_get_media_key_string(type)¶
- Parameters:
type (
int
) – TheCDesktopEnums.MediaKeyType
- Returns:
the string corresponding to the provided media key type or
None
- Return type:
Returns the
Gio.Settings
key string of the given media key type.
- CinnamonDesktop.desktop_prepend_terminal_to_vector(argc, argv)¶
-
Prepends a terminal (either the one configured as default in the user’s GNOME setup, or one of the common xterm emulators) to the passed in vector, modifying it in the process. The vector should be allocated with
GLib.malloc
, as this willGLib.free
the original vector. Also all elements must have been allocated separately. That is the standard glib/GNOME way of doing vectors however. If the integer that argc points to is negative, the size will first be computed. Also note that passing in pointers to a vector that is empty, will just create a new vector for you.
- CinnamonDesktop.desktop_thumbnail_cache_check_permissions(factory, quick)¶
- Parameters:
factory (
CinnamonDesktop.DesktopThumbnailFactory
) –quick (
bool
) –
- Return type:
- CinnamonDesktop.desktop_thumbnail_cache_fix_permissions()¶
- CinnamonDesktop.desktop_thumbnail_has_uri(pixbuf, uri)¶
- Parameters:
pixbuf (
GdkPixbuf.Pixbuf
) – an loaded thumbnail pixbufuri (
str
) – a uri
- Returns:
True
if the thumbnail is for uri- Return type:
Returns whether the thumbnail has the correct uri embedded in the Thumb::URI option in the png.
New in version 2.2.
- CinnamonDesktop.desktop_thumbnail_is_valid(pixbuf, uri, mtime)¶
- Parameters:
pixbuf (
GdkPixbuf.Pixbuf
) – an loaded thumbnailGdkPixbuf.Pixbuf
uri (
str
) – a urimtime (
int
) – the mtime
- Returns:
True
if the thumbnail has the right uri and mtime- Return type:
Returns whether the thumbnail has the correct uri and mtime embedded in the png options.
New in version 2.2.
- CinnamonDesktop.desktop_thumbnail_md5(uri)¶
- Parameters:
uri (
str
) – an uri- Returns:
A string with the MD5 digest of the uri string.
- Return type:
Calculates the MD5 checksum of the uri. This can be useful if you want to manually handle thumbnail files.
New in version 2.2.
Deprecated since version 2.22: Use
GLib.Checksum
instead
- CinnamonDesktop.desktop_thumbnail_path_for_uri(uri, size)¶
- Parameters:
uri (
str
) – an urisize (
CinnamonDesktop.DesktopThumbnailSize
) – a thumbnail size
- Returns:
an absolute filename
- Return type:
Returns the filename that a thumbnail of size size for uri would have.
New in version 2.2.
- CinnamonDesktop.desktop_thumbnail_scale_down_pixbuf(pixbuf, dest_width, dest_height)¶
- Parameters:
pixbuf (
GdkPixbuf.Pixbuf
) – aGdkPixbuf.Pixbuf
dest_width (
int
) – the desired new widthdest_height (
int
) – the desired new height
- Returns:
a scaled pixbuf
- Return type:
Scales the pixbuf to the desired size. This function is a lot faster than gdk-pixbuf when scaling down by large amounts.
New in version 2.2.
- CinnamonDesktop.installer_check_for_packages(packages, callback, *user_data)¶
- Parameters:
packages ([
str
]) – a null-terminated array of package namescallback (
CinnamonDesktop.InstallerClientCallback
) – the callback to run for the resultuser_data (
object
orNone
) – extra data to be sent to the callback
Uses packagekit to check if provided package names are installed.
- CinnamonDesktop.installer_install_packages(packages, callback, *user_data)¶
- Parameters:
packages ([
str
]) – a null-terminated array of package namescallback (
CinnamonDesktop.InstallerClientCallback
) – the callback to run for the resultuser_data (
object
orNone
) – extra data to be sent to the callback
Uses packagekit to install the provided list of packages.
- CinnamonDesktop.rr_error_quark()¶
- Returns:
a #GQuark used to identify errors coming from the GnomeRR API.
- Return type:
Returns the #GQuark that will be used for
GLib.Error
values returned by the GnomeRR API.
- CinnamonDesktop.start_systemd_scope(name, pid, description, connection, cancellable, callback, *user_data)¶
- Parameters:
name (
str
) – Name for the applicationpid (
int
) – The PID of the applicationdescription (
str
orNone
) – A description to use for the unit, orNone
connection (
Gio.DBusConnection
orNone
) – AnGio.DBusConnection
to the session bus, orNone
cancellable (
Gio.Cancellable
orNone
) –Gio.Cancellable
to usecallback (
Gio.AsyncReadyCallback
orNone
) – Callback to call when the operation is done
If the current process is running inside a user systemd instance, then move the launched PID into a transient scope. The given name will be used to create a unit name. It should be the application ID for desktop files or the executable in all other cases.
It is advisable to use this function every time where the started application can be considered reasonably independent of the launching application. Placing it in a scope creates proper separation between the programs rather than being considered a single entity by systemd.
It is always safe to call this function. Note that a successful return code does not imply that a unit has been created. It solely means that no error condition was hit sending the request.
If connection is
None
then g_dbus_get() will be called internally.Note that most callers will not need to handle errors. As such, it is normal to pass a
None
callback.
- CinnamonDesktop.start_systemd_scope_finish(res)¶
- Parameters:
res (
Gio.AsyncResult
) – AGio.AsyncResult
- Raises:
- Returns:
- Return type:
Finish an asynchronous operation to create a transient scope that was started with
CinnamonDesktop.start_systemd_scope
().Note that a successful return code does not imply that a unit has been created. It solely means that no error condition was hit sending the request.