Class
XdpPortal
Description [src]
final class Xdp.Portal : GObject.Object {
/* No available fields */
}
Context for portal calls.
The XdpPortal object provides the main context object for the portal operations of libportal.
Typically, an application will create a single XdpPortal
object with xdp_portal_new()
and use it throughout its lifetime.
Constructors
xdp_portal_initable_new
Creates a new XdpPortal
object.
xdp_portal_new
Creates a new XdpPortal
object. If D-Bus is unavailable this API will abort.
We recommend using xdp_portal_initable_new()
to safely handle this failure.
Instance methods
xdp_portal_access_camera
Request access to a camera.
xdp_portal_access_camera_finish
Finishes a camera acess request.
xdp_portal_add_notification
Sends a desktop notification.
xdp_portal_add_notification_finish
Finishes the notification request.
xdp_portal_compose_email
Presents a window that lets the user compose an email, with some pre-filled information.
xdp_portal_compose_email_finish
Finishes the compose-email request.
xdp_portal_create_remote_desktop_session
Creates a session for remote desktop.
xdp_portal_create_remote_desktop_session_finish
Finishes the create-remote-desktop request, and returns a XdpSession
.
xdp_portal_create_screencast_session
Creates a session for a screencast.
xdp_portal_create_screencast_session_finish
Finishes the create-screencast request, and returns a XdpSession
.
xdp_portal_dynamic_launcher_get_desktop_entry
This function gets the contents of a .desktop file that was previously installed by the dynamic launcher portal.
xdp_portal_dynamic_launcher_get_icon
This function gets the icon associated with a .desktop file that was previously installed by the dynamic launcher portal.
xdp_portal_dynamic_launcher_install
This function completes installation of a launcher so that the icon and name given in previous method calls will show up in the desktop environment’s menu.
xdp_portal_dynamic_launcher_launch
xdp_portal_dynamic_launcher_prepare_install
Presents a dialog to the user so they can confirm they want to install a launcher to their desktop.
xdp_portal_dynamic_launcher_prepare_install_finish
Finishes the prepare-install-launcher request, and returns
GVariant
dictionary with the following information:
xdp_portal_dynamic_launcher_request_install_token
Requests a token which can be passed to xdp_portal_dynamic_launcher_install()
to complete installation of the launcher without user interaction.
xdp_portal_dynamic_launcher_uninstall
This function uninstalls a launcher that was previously installed using the dynamic launcher portal, resulting in the .desktop file and icon being deleted.
xdp_portal_get_user_information
Gets information about the user.
xdp_portal_get_user_information_finish
Finishes the get-user-information request.
xdp_portal_is_camera_present
Returns whether any camera are present.
xdp_portal_location_monitor_start
Makes XdpPortal
start monitoring location changes.
xdp_portal_location_monitor_start_finish
Finishes a location-monitor request.
xdp_portal_location_monitor_stop
Stops location monitoring that was started with
xdp_portal_location_monitor_start()
.
xdp_portal_open_directory
Opens the directory containing the file specified by the uri
.
xdp_portal_open_directory_finish
Finishes the open-directory request.
xdp_portal_open_file
Asks the user to open one or more files.
xdp_portal_open_file_finish
Finishes the open-file request.
xdp_portal_open_pipewire_remote_for_camera
Opens a file descriptor to the pipewire remote where the camera nodes are available.
xdp_portal_open_uri
Opens uri
with an external handler.
xdp_portal_open_uri_finish
Finishes the open-uri request.
xdp_portal_pick_color
Lets the user pick a color from the screen.
xdp_portal_pick_color_finish
Finishes a pick-color request.
xdp_portal_prepare_print
Presents a print dialog to the user and returns print settings and page setup.
xdp_portal_prepare_print_finish
Finishes the prepare-print request.
xdp_portal_print_file
Prints a file.
xdp_portal_print_file_finish
Finishes the print request.
xdp_portal_remove_notification
Withdraws a desktop notification.
xdp_portal_request_background
Requests background permissions.
xdp_portal_request_background_finish
Finishes the request.
xdp_portal_save_file
Asks the user for a location to save a file.
xdp_portal_save_file_finish
Finishes the save-file request.
xdp_portal_save_files
Asks for a folder as a location to save one or more files.
xdp_portal_save_files_finish
Finishes the save-files request.
xdp_portal_session_inhibit
Inhibits various session status changes.
xdp_portal_session_inhibit_finish
Finishes the inhbit request.
xdp_portal_session_monitor_query_end_response
This method should be called within one second of
receiving a XdpPortal::session-state-changed
signal
with the ‘Query End’ state, to acknowledge that they
have handled the state change.
xdp_portal_session_monitor_start
Makes XdpPortal
start monitoring the login session state.
xdp_portal_session_monitor_start_finish
Finishes a session-monitor request.
xdp_portal_session_monitor_stop
Stops session state monitoring that was started with
xdp_portal_session_monitor_start()
.
xdp_portal_session_uninhibit
Removes an inhibitor that was created by a call
to xdp_portal_session_inhibit()
.
xdp_portal_set_background_status
Sets the status information of the application, for when it’s running in background.
xdp_portal_set_background_status_finish
Finishes setting the background status of the application.
xdp_portal_set_wallpaper
Sets a desktop background image, given by a uri.
xdp_portal_set_wallpaper_finish
Finishes the open-uri request.
xdp_portal_spawn
Creates a new copy of the applications sandbox, and runs a process in, with the given arguments.
xdp_portal_spawn_finish
Finishes the spawn request.
xdp_portal_spawn_signal
Sends a Unix signal to a process that has been spawned
by xdp_portal_spawn()
.
xdp_portal_take_screenshot
Takes a screenshot.
xdp_portal_take_screenshot_finish
Finishes a screenshot request.
xdp_portal_trash_file
Sends the file at path
to the trash can.
xdp_portal_trash_file_finish
Finishes the trash-file request.
xdp_portal_update_install
Installs an available software update.
xdp_portal_update_install_finish
Finishes an update-installation request.
xdp_portal_update_monitor_start
Makes XdpPortal
start monitoring for available software updates.
xdp_portal_update_monitor_start_finish
Finishes an update-monitor request.
xdp_portal_update_monitor_stop
Stops update monitoring that was started with
xdp_portal_update_monitor_start()
.
Signals
Xdp.Portal::location-updated
Emitted when location monitoring is enabled and the location changes.
Xdp.Portal::notification-action-invoked
Emitted when a non-exported action is activated on a notification.
Xdp.Portal::session-state-changed
Emitted when session state monitoring is enabled and the state of the login session changes or the screensaver is activated or deactivated.
Xdp.Portal::spawn-exited
Emitted when a process that was spawned with xdp_portal_spawn()
exits.
Xdp.Portal::update-available
Emitted when updates monitoring is enabled and a new update is available.
Xdp.Portal::update-progress
Emitted to indicate progress of an update installation.
Class structure
struct XdpPortalClass {
GObjectClass parent_class;
}
Class members
parent_class |
|
No description available. |
Functions
xdp_portal_running_under_flatpak
Detects if running inside of a Flatpak or WebKit sandbox.
xdp_portal_running_under_sandbox
This function tries to determine if the current process is running under a sandbox that requires the use of portals.
xdp_portal_running_under_snap
Detects if you are running inside of a Snap sandbox.