Fetches this application's class id. On X11 this should be the class name of the [WM_CLASS property](https://x.org/releases/X11R7.6/doc/xorg-docs/specs/ICCCM/icccm.html#wm_class_property). On Wayland, it's the [application ID](https://wayland.app/protocols/wlr-foreign-toplevel-management-unstable-v1#zwlr_foreign_toplevel_handle_v1:event:app_id), which should correspond to the basename of the application's desktop file. A UTF-8 formatted string, owned by @app. an #XfwApplication. Fetches @app's icon as a size-independent #GIcon. If an icon cannot be found, a #GIcon representing a fallback icon will be returned. Whether or not the returned icon is a fallback icon can be determined using #xfw_application_icon_is_fallback(). a #GIcon, owned by @app. an #XfwApplication. Fetches @app's icon. If @app has no icon, a fallback icon may be returned. Whether or not the returned icon is a fallback icon can be determined using #xfw_application_icon_is_fallback(). a #GdkPixbuf, owned by @app, or %NULL if @app has no icon and a fallback cannot be rendered. an #XfwApplication. the desired icon size. the UI scale factor. Finds the #XfwApplicationInstance to which @window belongs. The #XfwApplicationInstance to which @window belongs, or %NULL if @window does not belong to @app, or if listing instances is not supported on the windowing environment in use. The returned #XfwApplicationInstance is owned by @app. an #XfwApplication. the application window you want to get the instance of. Lists all instances of the application. The list of #XfwApplicationInstance of @app, or %NULL if listing instances is not supported on the windowing environment in use. The list and its contents are owned by @app. an #XfwApplication. Fetches this application's human-readable name. A UTF-8 formatted string, owned by @app. an #XfwApplication. Lists all windows belonging to the application. The list of #XfwWindow belonging to @app. The list and its contents are owned by @app. an #XfwApplication. Determines if @app does not have an icon, and thus a fallback icon will be returned from #xfw_application_get_icon() and #xfw_application_get_gicon(). %TRUE or %FALSE, depending on if @app's icon uses a fallback icon or not. an #XfwApplication. The application class id. The #GIcon that represents this application. The list of #XfwApplicationInstance belonging to the application. The application name. The list of #XfwWindow belonging to the application. Emitted when @app's icon changes. An opaque structure representing an instance of an #XfwApplication. Fetches @instance's name, which can often be the same as the application name. A string owned by @instance. an #XfwApplicationInstance. Fetches @instance's PID. The process ID of @instance, or 0 if none is available. an #XfwApplicationInstance. Lists all windows belonging to the application instance. The list of #XfwWindow belonging to @instance. The list and its contents are owned by @instance. an #XfwApplicationInstance. A macro to compare libxfce4windowing versions to determine if a particular function is available. The major version of the library, i.e. 4 The minor version of the library, i.e. 18 The micro release of the library, i.e. 0 The type of the application. See #xfw_set_client_type() for details. a regular application a pager or other user-controlled desktop component Represents a direction, either of position ("This workspace is to the left of the current workspace") or movement ("Move this window to the workspace to the right of its current workspace"). upward from the current location downward from the current location to the left of the current location to the right of the current location An error code enum describing possible errors returned by this library. the operation attempted is not supported. an internal error has occurred. A macro that evaluates to the major version of libxfce4windowing, in a format that can be used by the C pre-processor. A macro that evaluates to the micro version of libxfce4windowing, in a format that can be used by the C pre-processor. A macro that evaluates to the minor version of libxfce4windowing, in a format that can be used by the C pre-processor. Returns the name of the physical connector this monitor is connected to. This might be a string such as "eDP-1", "DP-3", or "HDMI-2". Note that in environments where the monitor is "virtual", a synthetic connector name may be returned. A string owned by @monitor. a #XfwMonitor. Returns a human-readable description of this monitor, suitable for displaying in a user interface. A string owned by @monitor. a #XfwMonitor. Returns the monitor's scaling factor. A positive fractional scale. a #XfwMonitor. Returns the #GdkMonitor that corresponds to @monitor. A #GdkMonitor. a #XfwMonitor. Retrieves an opaque identifier for this monitor. The identifier can usually be relied upon to uniquely identify this monitor (even if you have multiple identical monitors of the same make and model), assuming the monitor's hardware is set up properly. This identifier should also be stable across application and machine restarts. If the monitor's hardware is not set up properly, the identifier may not be unique. Unfortunately, this library cannot determine when this is the case. A string owned by @monitor. a #XfwMonitor. Retrieves the position and size of the monitor in logical application pixels, which are affected by the monitor's fractional scale factor. a #XfwMonitor. a #GdkRectangle. Returns the monitor's manufacturer's name, if available. A string owned by @monitor, or %NULL. a #XfwMonitor. Returns the monitor's product model name, if available. A string owned by @monitor, or %NULL. a #XfwMonitor. Retrieves the position and size of the monitor in physical device pixels. a #XfwMonitor. a #GdkRectangle. Retrieves the physical width and height of the monitor in millimeters. a #XfwMonitor. an unsigned integer. an unsigned integer. Returns the monitor's current refresh rate, in millihertz. A non-negative integer in mHz. a #XfwMonitor. Returns the monitor's scaling factor, as an integer. A positive integer scale. a #XfwMonitor. Returns the monitor's serial number, if available. Note that some manufacturers do not program their monitor's hardware with unique serial numbers. A string owned by @monitor, or %NULL. a #XfwMonitor. Returns the subpixel ordering of @monitor. A value from the #XfwMonitorSubpixel enum. a #XfwMonitor. Returns the rotation and reflection transform set on @monitor. A value from the #XfwMonitorTransform enum. a #XfwMonitor. Retrieves the workarea for @monitor, which may exclude regions of the screen for windows such as panels or docks. The returned geometry is in logical application pixels, which are affected by the monitor's integer scale factor. The origin is set to the top-left corner of the monitor. a #XfwMonitor. a #GdkRectangle. Returns whether or not @monitor has been designated as the primary monitor. %TRUE or %FALSE. a #XfwMonitor. Physical/virtual connector name. Human-readable description. UI fractional scaling factor. The #GdkMonitor corresponding to this monitor. Since 4.19.4 Physical height of the monitor in millimeters. Opaque, hopefully-unique monitor identifier. Whether or not this monitor is the primary monitor. Coordinates and size of the monitor in scaled logical pixels. Manufacturer name. Product model name. Coordinates and size of the monitor in physical device pixels. Current refresh rate, in millihertz. UI scaling factor. Product serial number. Hardware subpixel layout. Physical width of the monitor in millimeters. Describes how the color components of the physical pixels are laid out on a monitor. unknown subpixel ordering. no subpixel geometry. horizontal RGB. horizontal BGR. vertical RGB. vertical BGR. Describes the rotation and reflection applied to a monitor. no transformation applied. rotated counter-clockwise by 90 degrees. rotated counter-clockwise by 180 degrees. rotated counter-clockwise by 270 degrees. flipped along a vertical axis. flipped along a vertical axis and rotated counter-clockwise by 90 degrees. @XFW_MONITOR_TRANSFORM_FLIPPED_180: flipped along a vertical axis and rotated counter-clockwise by 180 degrees. flipped along a vertical axis and rotated counter-clockwise by 270 degrees. Retrieves the #XfwScreen instance corresponding to the default #GdkScreen. an #XfwScreen instance, with a reference owned by the caller. Retrieves the window on @screen that is currently active. an #XfwWindow, or %NULL if no window is active on @screen. an #XfwScreen. Retrieves the list of monitors currently attached and enabled on @screen. the list of #XfwMonitor on @screen, or %NULL if there are no connected/enabled monitors. The list and its contents are owned by @screen. an #XfwScreen. Returns the monitor designated as "primary". This function will do its best to return something other than %NULL. If the windowing system has no concept of a primary monitor, or if the primary monitor is unset, a likely candidate will be chosen from the list of available monitors. However, if no monitors are connected, %NULL can still be returned. @screen's primary #XfwMonitor, or %NULL. an #XfwScreen. Returns the list of all #XfwSeat instances available on @screen. a list of #XfwSeat. The list and its contents are owned by @screen. an #XfwScreen. %TRUE if the desktop is shown, %FALSE otherwise. an #XfwScreen. Retrieves the list of windows currently displayed on @screen. The list and its contents are owned by @screen. the list of #XfwWindow on @screen, or %NULL if there are no windows. The list and its contents are owned by @screen. an #XfwScreen. Retrieves the list of windows currently displayed on @screen, in stacking order, with the bottom-most window first in the returned list. the list of #XfwWindow on @screen, in stacking order, or %NULL if there are no windows. The list and its contents are owned by @screen. an #XfwScreen. Retrieves this screen's #XfwWorkspaceManager instance, which can be used to inspect and interact with @screen's workspace groups and workspaces. a #XfwWorkspaceManager instance. This instance is a singleton and is owned by @screen. an #XfwScreen. Showing the desktop minimizes the windows not minimized at the time of the query. The reverse process unminimizes those same windows, if they have not already been unminimized or destroyed. The desktop show state can be tracked via #XfwScreen:show-desktop. The state of the previously active window is always restored upon unminimization, but there is no guarantee for the rest of the window stacking order on Wayland. A request to switch to the current state is silently ignored. an #XfwScreen. %TRUE to show the desktop, %FALSE to restore the previous state. The currently-active window. The #GdkScreen instance used to construct this #XfwScreen. Whether or not to show the desktop. The #XfwWorkspaceManager that manages and describes workspace groups and workspaces on this screen instance. Emitted when a new window becomes the active window. Often the active window will receive keyboard focus. While @window is the previously-active window (if any, and may be %NULL), the newly-active window can be retrieved via #xfw_screen_get_active_window(). the previously-active window. Emitted when a monitor is added to @screen. the monitor that was added. Emitted when a monitor is removed from @screen. the monitor that was removed. Emitted when one of the following has changed about the monitors attached to @screen: * A monitor was added. * A monitor was removed. * A monitor's resolution changed (including if the scale factor changed). * A monitor was re-positioned in the global screen space. * Which monitor is primary has changed. Note that changes such as the subpixel layout or model name will not result in the emission of this signal. Connect to the propert notify signals on #XfwMonitor to be notified of changes in other aspects of the monitor. Emitted when @seat has been added to @screen. the new #XfwSeat that was added. Emitted when @seat has been added to @screen. the #XfwSeat that was removed. Emitted when a window is closed on the screen. the window that has been closed. Emitted when the window manager on @screen has changed. Note that currently this signal is not emitted on Wayland. Emitted when a new window is opened on the screen. the new window that was opened. Emitted when the order of the windows as displayed on the screen has changed. Windows, in stacking order, can be retrieved via #xfw_screen_get_windows_stacked(). Note that currently this signal is not emitted on Wayland. Returns the name or identifier of @seat. an #XfwSeat. The seat's identifier. Fetches @window's application. An #XfwApplication instance, with a reference owned by @window. an #XfwWindow. Fetches @window's capabilities bitfield. a bitfield with zero or more bits from #XfwWindowCapabilities set. an #XfwWindow. Fetches @window's class ids. On X11 this should contain the class and instance names of the [WM_CLASS property](https://x.org/releases/X11R7.6/doc/xorg-docs/specs/ICCCM/icccm.html#wm_class_property). On Wayland, it's likely to be limited to the [application ID](https://wayland.app/protocols/wlr-foreign-toplevel-management-unstable-v1#zwlr_foreign_toplevel_handle_v1:event:app_id), which should correspond to the basename of the application's desktop file. a %NULL-terminated array of strings owned by the #XfwWindow. an #XfwWindow. Fetches @window's position and size. A #GdkRectangle representing @window's geometry, which should not be modified or freed. an #XfwWindow. Fetches @window's icon as a size-independent #GIcon. If an icon cannot be found, a #GIcon representing a fallback icon will be returned. Whether or not the returned icon is a fallback icon can be determined using #xfw_window_icon_is_fallback(). a #GIcon, owned by @window. an #XfwWindow. Fetches @window's icon. If @window has no icon, a fallback icon may be returned. Whether or not the returned icon is a fallback icon can be determined using #xfw_window_icon_is_fallback(). a #GdkPixbuf, owned by @window, or %NULL if @window has no icon and a fallback cannot be rendered. an #XfwWindow. the desired icon size. the UI scale factor. Fetches the list of monitors @window is displayed on, if any. A list of #XfwMonitor instances, or %NULL. The list and its contents are owned by @window and should not be modified or freed. an #XfwWindow. Fetches @window's name/title. a window title, or %NULL if there is no title. The returned title should not be modified or freed. an #XfwWindow. Fetches the #XfwScreen instance that owns @window. A #XfwScreen instance, with a reference owned by @window. an #XfwWindow. Fetches @window's state bitfield. a bitfield with zero or more bits from #XfwWindowState set. an #XfwWindow. Fetches @window's workspace, if any. This may return %NULL if @window is not on a workspace, or is pinned to all workspaces. A #XfwWorkspace instance, with a reference owned by @window, or %NULL. an #XfwWindow. Determines if @window does not have an icon, and thus a fallback icon will be returned from #xfw_window_get_icon() and #xfw_window_get_gicon(). %TRUE or %FALSE, depending on if @window's icon uses a fallback icon or not. an #XfwWindow. The #XfwApplication that owns this window. The window's capabilities bitfield. The window's class ids. The #GIcon that represents this window. The list of #XfwMonitor<!-- -->s (if any) that the window is displayed on. The window's name or title. The #XfwScreen instances that owns this window. The window's state bitfield. The window's type or function. Emitted when @window's capabilities change. bitfield representing which state bits have changed. the new state bitfield. Emitted when at least one of the @window's class ids changes. Emitted when @window is closed. Emitted when @window's position or size changes. Emitted when @window's icon changes. Emitted when @window's name/title changes. Emitted when @window's state changes. bitfield representing which state bits have changed. the new state bitfield. Emitted when @window's type changes. the previous window type. Emitted when @window is moved to a different worksapce. Flags bitfield that describes actions that can be taken on the window. window has no capabilities. window can be minimized/hidden. window can be unminimized/unhidden. window can be maximized. window can be unmaximized/restored. window can be set fullscreen. window can be unset fullscreen. window can be shaded. window can be unshaded. window can be moved. window can be resized. window can be placed above others. always above window can be returned to the normal stacking order. window can be placed below others. always below window can be returned to the normal stacking order. window can be moved to a different workspace or can be pinned and unpinned. A flags bitfield representing various states the window can hold. window has no state bits set. window is active (and often has the keyboard focus). window is minimized/hidden. window is maximized. window is filling the entire screen. window should not be shown in pagers. window should not be shown in task lists. window is shown on al workspaces. window is hidden, except for its title bar. window is always shown above other windows. window is always shown below other windows. window is attempting to get the user's attention. Enumeration describing the windows type or function. window is a regular window. window is responsible for drawing the desktop. window is a dock or panel. window is a temporary dialog, like an error alert. window is a detached toolbar. window is a popup menu. window is a utility menu, like a tool picker or color palette. window is an application splash screen. Represents the windowing environment that is currently running. Note that for an application running on XWayland, this will return #XFW_WINDOWING_X11. the application is running under an unknown or unsupported windowing system. the application is running under an X11 server. the application is running under a Wayland comopositor. Attempts to set @workspace as the active workspace in its group. On failure, @error (if provided) will be set to a description of the error that occurred. %TRUE if workspace activation succeeded, %FALSE otherwise. If %FALSE, and @error is non-%NULL, an error will be returned that must be freed using #g_error_free(). an #XfwWorkspace. Attempts to assign @workspace to @group. On failure, @error (if provided) will be set to a description of the error that occurred. %TRUE if workspace assignment succeeded, %FALSE otherwise. If %FALSE, and @error is non-%NULL, an error will be returned that must be freed using g_error_free(). an #XfwWorkspace. an #XfwWorkspaceGroup. Fetches this workspace's capabilities bitfield. The bitfield describes what operations are available on this workspace. a #XfwWorkspaceCapabilities bitfield. an #XfwWorkspace. Fetches the position and size of the workspace in screen coordinates. The values in the returned #GdkRectangle are owned by @workspace and should not be modified. a #GdkRectangle, owned by @workspace. an #XfwWorkspace. Fetches this workspace's opaque ID. A UTF-8 formatted string, owned by @workspace. an #XfwWorkspace. Fetches the column this workspace belongs to in the workspace's group. This information can be used to lay out workspaces in a grid in a pager UI, for example. a non-negative, 0-indexed integer. an #XfwWorkspace. Fetches the row this workspace belongs to in the workspace's group. This information can be used to lay out workspaces in a grid in a pager UI, for example. a non-negative, 0-indexed integer. an #XfwWorkspace. Fetches this workspace's human-readable name. A UTF-8 formatted string, owned by @workspace. an #XfwWorkspace. Fetches the workspace that resides in @direction from the @workspace, if any. If workspace is on the edge of the layout, and @direction points off the edge of the layout, will return %NULL. a #XfwWorkspace, owned by the parent @group, or %NULL if no workspace exists in @direction. an #XfwWorkspace. an #XfwDirection. Fetches the ordinal number of this workspace. The number can be used to order workspaces in a UI representation. On X11, this number should be stable across runs of your application. On Wayland, this number depends on the order in which the compositor advertises the workspaces. This order may be stable, but may not be. a non-negative, 0-indexed integer. an #XfwWorkspace. Fetches this workspace's state bitfield. a #XfwWorkspaceState bitfield. an #XfwWorkspace. Fetches the group this workspace belongs to, if any. a #XfwWorkspaceGroup instance, owned by @workspace, or %NULL if the workspace is not a member of any groups. an #XfwWorkspace. Attempts to remove @workspace from its group. On failure, @error (if provided) will be set to a description of the error that occurred. %TRUE if workspace removal succeeded, %FALSE otherwise. If %FALSE, and @error is non-%NULL, an error will be returned that must be freed using #g_error_free(). an #XfwWorkspace. The #XfwWorkspaceCapabilities bitfield for this workspace. The #XfwWorkspaceGroup that this workspace is a member of, if any. The opaque ID of this workspace. The y-coordinate of the workspace on a 2D grid. The x-coordinate of the workspace on a 2D grid. The human-readable name of this workspace. The ordinal number of this workspace. The #XfwWorkspaceState bitfield for this workspace. Emitted when @workspace's capabilities change. a bitfield representing the capabilities that have changed. a bitfield of the new capabilities. Emitted when @workspace is assigned to an #XfwWorkspaceGroup. the group @workspace was previously in, or %NULL. Emitted when @workspace's name changes. Emitted when @workspace's state changes. a bitfield representing the state bits that have changed. a bitfield of the new state. Flags enum representing a bitfield of actions that can be performed on this workspace. workspace has no capabilities. workspace can be activated. workspace can be removed. Attempts to create a new workspace on @group. Typically, the new workspace will be appended to the existing list of workspaces. On failure, @error (if provided) will be set to a description of the error that occurred. %TRUE if workspace creation succeeded, %FALSE otherwise. If %FALSE, and @error is non-%NULL, an error will be returned that must be freed using #g_error_free(). an #XfwWorkspaceGroup. a name for the new workspace. Gets the active workspace on @group, if there is one. an #XfwWorkspace, or %NULL if there is no active workspace. an #XfwWorkspaceGroup. Returns a bitfield describing operations allowed on this @group. an #XfwWorkspaceGroupCapabilities bitfield. an #XfwWorkspaceGroup. Lists the physical monitors that this workspace group displays on. A list of #XfwMonitor, or %NULL if @group is not displayed on any monitors. The list and its contents are owned by @group. an #XfwWorkspaceGroup. Fetches the number of workspaces in @group. an unsigned integer describing the number of workspaces. an #XfwWorkspaceGroup. Fetches the #XfwWorkspaceManager instance that owns @group. a #XfwWorkspaceManager, owned by @group. an #XfwWorkspaceGroup. Lists the workspaces in @group. the list of #XfwWorkspace in @group, or %NULL if there are no workspaces. The list and its contents are owned by @group. an #XfwWorkspaceGroup. Moves the workspace group to a new location, and possibly a new monitor. On failure, @error (if provided) will be set to a description of the error that occurred. %TRUE if moving the workspace group succeeded, %FALSE otherwise. If %FALSE, and @error is non-%NULL, an error will be returned that must be freed using #g_error_free(). an #XfwWorkspaceGroup. a coordinate in the horizontal direction. a coordinate in the vertical direction. Sets the layout of @group to @rows by @columns. Note that this will not change the number of workspaces if the new layout implies a larger number of workspaces than currently exists. On failure, @error (if provided) will be set to a description of the error that occurred. %TRUE if changing the layout of @group succeede, %FALSE otherwise. If %FALSE, and @error is non-%NULL, an error will be returned that must be freed using #g_error_free(). an #XfwWorkspaceGroup. the new numbers of rows. the new number of columns. The active #XfwWorkspace on this #XfwWorkspaceGroup, or %NULL. The list of #XfwMonitor this #XfwWorkspaceGroup is displayed on. The #XfwScreen that owns this #XfwWorkspaceGroup. The #XfwWorkspaceManager instance that manages this #XfwWorkspaceGroup. The list of #XfwWorkspace in this #XfwWorkspaceGroup. Emitted when the active workspace of @group changes. the previously active #XfwWorkspace, or %NULL. Emitted when capabilities have changed on @group. a bitfield representing the capabilities that have changed. a bitfield of the new capabilities. Emitted when @group is added to a new monitor. a #XfwMonitor. Emitted when @group is removed from a monitor. a #XfwMonitor. Emitted when @group moves to a new set of monitors. Emitted when @group's viewport coordinates have changed. Emitted when @workspace joins @group. the #XfwWorkspace added to the group. Emitted when @workspace leaves @group. the #XfwWorkspace removed from the group. Flags enum representing a bitfield of actions that can be performed on this workspace group. group has no capabilities. new workspaces can be created in this group. the viewport coordinates for this group can be changed. the number of rows and columns for this group can be changed. Lists all workspace groups known to the workspace manager. the list of #XfwWorkspaceGroup managed by @manager, or %NULL if there are no workspace groups. The list and its contents are owned by @manager. an #XfwWorkspaceManager. List all workspaces known to the workspace manager. the list of #XfwWorkspace managed by @manager, or %NULL if there are no workspaces. The list and its contents are owned by @manager. an #XfwWorkspaceManager. The #XfwScreen instance that owns this workspace manager. Emitted when a new workspace is created. the newly-created workspace. Emitted when a workspace is destroyed. the workspace that was destroyed. Emitted when a new workspace group is craeted. the newly-created #XfwWorkspaceGroup. Emitted when a workspace group is destroyed. the recently-destroyed #XfwWorkspaceGroup. Flags enum representing a bitfield that describes the workspace's state. workspace has no state information. workspace is the active workspace in its group. workspace contains a window that is requesting attention. workspace should be hidden from pagers or other UI elements. workspace has a valid, visible viewport. Checks that the libxfce4windowing library in use is compatible with the given version. Generally you would pass in the constants #LIBXFCE4WINDOWING_MAJOR_VERSION, #LIBXFCE4WINDOWING_MINOR_VERSION and #LIBXFCE4WINDOWING_MICRO_VERSION as the three arguments to this function; that produces a check that the library in use is compatible with the version of libxfce4windowing the extension was compiled against. |[<!-- language="C" --> const gchar *mismatch; mismatch = libxfce4windowing_check_version(LIBXFCE4WINDOWING_MAJOR_VERSION, LIBXFCE4WINDOWING_MINOR_VERSION, LIBXFCE4WINDOWING_MICRO_VERSION); if (G_UNLIKELY(mismatch != NULL)) { g_error("Version mismatch: %s", mismatch); } ]| %NULL if the library is compatible with the given version, or a string describing the version mismatch. The returned string is owned by the library and must not be freed or modified by the caller. the required major version. the required minor version. the required micro version. Variables and functions to check the libxfce4windowing version. Sets the type of the application. This is used when sending various messages to control the behavior of other windows, to indicate the source of the control. In general, #XFW_CLIENT_TYPE_APPLICATION will be interpreted as automated control from a regular application, and #XFW_CLIENT_TYPE_PAGER will be interpreted as user-initiated control from a desktop component application like a pager or dock. This does nothing on Wayland, but is safe to call under a Wayland session. A #XfwClientType Determines the windowing environment that is currently active. A value from the #XfwWindowing enum. #XfwApplication represents an application in the common or abstract sense, i.e. it can have several windows belonging to different instances, identified by their process ID. Note that #XfwApplication is actually an interface; when obtaining an instance, an instance of a windowing-environment-specific object that implements this interface will be returned. #XfwMonitor represents a physical monitor connected to the #XfwScreen. In some virtual environments (e.g. a nested X11 or Wayland session), the monitor might instead represent an on-screen window that contains the output of the virtual environment. #XfwScreen represents a logical screen. On most windowing environments, this doesn't necessarily correspond to a single monitor, but might span multiple monitors. These days, most windowing environments will only have a single screen, even if (API-wise) more than one can be represented. The #XfwScreen instance is the main entry point into this library. You can obtain an instance using #xfw_screen_get_default(). From there, you can enumerate toplevel windows, or examine workspace groups and workspaces. Note that #XfwScreen is actually an interface; when obtaining an instance, an instance of a windowing-environment-specific object that implements this interface will be returned. #XfwSeat represents a physical monitor, keyboard, and pointing device attached to @screen. Mainly it is only needed when activating #XfwWindow instances. #XfwWindow describes a toplevel window on the screen, and provides access to the window's state, type, and actions that can be performed on it. Other metadata, like the window's title or icon, is also available. If the window supports it, actions can be taken, like minimizing, maximizing, pinning, moving between workspaces, or closing the window. Note that #XfwWindow is actually an interface; when obtaining an instance, an instance of a windowing-environment-specific object that implements this interface will be returned. #XfwWorkspace represents a single workspace within a workspace group. A workspace is usually a collection of windows that are shown together on the desktop when that workspace is the active workspace. An instance of #XfwWorkspace can be used to obtain information about the workspace, such as its name, position in the group, and capabilities. The workspace can also be activated or removed. Note that #XfwWorkspace is actually an interface; when obtaining an instance, an instance of a windowing-environment-specific object that implements this interface will be returned. Workspaces may be arranged in groups, and groups may be present on different monitors. The #XfwWorkspaceGroup can create and enumerate workspaces, as well as provide notifications when workspaces are created and destroyed. Each workspace group may have an active workspace. Workspace groups are displayed on a list of zero or more monitors, and have viewport coordinates. Note that #XfwWorkspaceGroup is actually an interface; when obtaining an instance, an instance of a windowing-environment-specific object that implements this interface will be returned. #XfwWorkspaceManager is used to enumerate and perform actions on the workspace groups present on the parent #XfwScreen. Note that #XfwWorkspaceManager is actually an interface; when obtaining an instance, an instance of a windowing-environment-specific object that implements this interface will be returned.