Libxfce4windowing.Application¶

Subclasses:: None

Methods¶

Inherited:: GObject.Object (37)
Structs:: GObject.ObjectClass (5)

	`get_class_id` ()
	`get_gicon` ()
	`get_icon` (size, scale)
	`get_instance` (window)
	`get_instances` ()
	`get_name` ()
	`get_windows` ()
	`icon_is_fallback` ()

Virtual Methods¶

Inherited:: GObject.Object (7)

Properties¶

Name	Type	Flags	Short Description
`class-id`	`str`	r	class-id
`gicon`	`Gio.Icon`	r	gicon
`instances`	`int`	r	instances
`name`	`str`	r	name
`windows`	`int`	r	windows

Signals¶

Inherited:: GObject.Object (1)

Name	Short Description
`icon-changed`	Emitted when app's icon changes.

Fields¶

Inherited:: GObject.Object (1)

Name	Type	Access	Description
parent_instance	`GObject.Object`	r

Class Details¶

class Libxfce4windowing.Application(**kwargs)¶

Bases:: GObject.Object
Abstract:: Yes
Structure:: Libxfce4windowing.ApplicationClass

get_class_id()¶

Returns:: A UTF-8 formatted string, owned by self.
Return type:: str

Fetches this application’s class id. On X11 this should be the class name of the WM_CLASS property. On Wayland, it’s the application ID, which should correspond to the basename of the application’s desktop file.

New in version 4.19.3.

get_gicon()¶

Returns:: a Gio.Icon, owned by self.
Return type:: Gio.Icon

Fetches self's icon as a size-independent Gio.Icon. If an icon cannot be found, a Gio.Icon representing a fallback icon will be returned. Whether or not the returned icon is a fallback icon can be determined using Libxfce4windowing.Application.icon_is_fallback().

New in version 4.19.1.

get_icon(size, scale)¶

Parameters:

size (int) – the desired icon size.
scale (int) – the UI scale factor.

Returns:

a GdkPixbuf.Pixbuf, owned by self, or None if self has no icon and a fallback cannot be rendered.

Return type:

GdkPixbuf.Pixbuf or None

Fetches self's icon. If self has no icon, a fallback icon may be returned. Whether or not the returned icon is a fallback icon can be determined using Libxfce4windowing.Application.icon_is_fallback().

get_instance(window)¶

Parameters:: window (Libxfce4windowing.Window) – the application window you want to get the instance of.
Returns:: The Libxfce4windowing.ApplicationInstance to which window belongs, or None if window does not belong to self, or if listing instances is not supported on the windowing environment in use. The returned Libxfce4windowing.ApplicationInstance is owned by self.
Return type:: Libxfce4windowing.ApplicationInstance or None

Finds the Libxfce4windowing.ApplicationInstance to which window belongs.

get_instances()¶

Returns:: The list of Libxfce4windowing.ApplicationInstance of self, or None if listing instances is not supported on the windowing environment in use. The list and its contents are owned by self.
Return type:: [Libxfce4windowing.ApplicationInstance] or None

Lists all instances of the application.

get_name()¶

Returns:: A UTF-8 formatted string, owned by self.
Return type:: str

Fetches this application’s human-readable name.

get_windows()¶

Returns:: The list of Libxfce4windowing.Window belonging to self. The list and its contents are owned by self.
Return type:: [Libxfce4windowing.Window]

Lists all windows belonging to the application.

icon_is_fallback()¶

Returns:: True or False, depending on if self's icon uses a fallback icon or not.
Return type:: bool

Determines if self does not have an icon, and thus a fallback icon will be returned from Libxfce4windowing.Application.get_icon() and Libxfce4windowing.Application.get_gicon().

New in version 4.19.1.

Signal Details¶

Libxfce4windowing.Application.signals.icon_changed(application)¶

Signal Name:: icon-changed
Flags:: RUN_LAST
Parameters:: application (Libxfce4windowing.Application) – The object which received the signal

Emitted when app's icon changes.

Property Details¶

Libxfce4windowing.Application.props.class_id¶

Name:: class-id
Type:: str
Default Value:: ''
Flags:: READABLE

The application class id.

New in version 4.19.3.

Libxfce4windowing.Application.props.gicon¶

Name:: gicon
Type:: Gio.Icon
Default Value:: None
Flags:: READABLE

The Gio.Icon that represents this application.

Libxfce4windowing.Application.props.instances¶

Name:: instances
Type:: int
Default Value:: None
Flags:: READABLE

The list of Libxfce4windowing.ApplicationInstance belonging to the application.

Libxfce4windowing.Application.props.name¶

Name:: name
Type:: str
Default Value:: None
Flags:: READABLE

The application name.

Libxfce4windowing.Application.props.windows¶

Name:: windows
Type:: int
Default Value:: None
Flags:: READABLE

The list of Libxfce4windowing.Window belonging to the application.