gio/org.gtkkn.bindings.gio/RemoteActionGroup

RemoteActionGroup

interface RemoteActionGroup : ActionGroup

The GRemoteActionGroup interface is implemented by iface@Gio.ActionGroup instances that either transmit action invocations to other processes or receive action invocations in the local process from other processes.

The interface has _full variants of the two methods on iface@Gio.ActionGroup used to activate actions: method@Gio.ActionGroup.activate_action and method@Gio.ActionGroup.change_action_state. These variants allow a ‘platform data’ struct@GLib.Variant to be specified: a dictionary providing context for the action invocation (for example: timestamps, startup notification IDs, etc).

class@Gio.DBusActionGroup implements GRemoteActionGroup. This provides a mechanism to send platform data for action invocations over D-Bus.

Additionally, method@Gio.DBusConnection.export_action_group will check if the exported iface@Gio.ActionGroup implements GRemoteActionGroup and use the _full variants of the calls if available. This provides a mechanism by which to receive platform data for action invocations that arrive by way of D-Bus.

Since

2.32

Inheritors

DBusActionGroup

Types

Companion

object Companion

Properties

gioActionGroupPointer

open override val gioActionGroupPointer: <Error class: unknown class><<Error class: unknown class>>

gioRemoteActionGroupPointer

abstract val gioRemoteActionGroupPointer: <Error class: unknown class><<Error class: unknown class>>

Functions

actionAdded

open fun actionAdded(actionName: String)

Emits the signal@Gio.ActionGroup::action-added signal on @action_group.

actionEnabledChanged

open fun actionEnabledChanged(actionName: String, enabled: Boolean)

Emits the signal@Gio.ActionGroup::action-enabled-changed signal on @action_group.

actionRemoved

open fun actionRemoved(actionName: String)

Emits the signal@Gio.ActionGroup::action-removed signal on @action_group.

actionStateChanged

open fun actionStateChanged(actionName: String, state: <Error class: unknown class>)

Emits the signal@Gio.ActionGroup::action-state-changed signal on @action_group.

activateAction

open fun activateAction(actionName: String, parameter: <Error class: unknown class>? = null)

Activate the named action within @action_group.

activateActionFull

open fun activateActionFull(actionName: String, parameter: <Error class: unknown class>? = null, platformData: <Error class: unknown class>)

Activates the remote action.

changeActionState

open fun changeActionState(actionName: String, value: <Error class: unknown class>)

Request for the state of the named action within @action_group to be changed to @value.

changeActionStateFull

open fun changeActionStateFull(actionName: String, value: <Error class: unknown class>, platformData: <Error class: unknown class>)

Changes the state of a remote action.

connectActionAdded

open fun connectActionAdded(connectFlags: <Error class: unknown class> = ConnectFlags(0u), handler: (actionName: String) -> Unit): <Error class: unknown class>

Signals that a new action was just added to the group.

connectActionEnabledChanged

open fun connectActionEnabledChanged(connectFlags: <Error class: unknown class> = ConnectFlags(0u), handler: (actionName: String, enabled: Boolean) -> Unit): <Error class: unknown class>

Signals that the enabled status of the named action has changed.

connectActionRemoved

open fun connectActionRemoved(connectFlags: <Error class: unknown class> = ConnectFlags(0u), handler: (actionName: String) -> Unit): <Error class: unknown class>

Signals that an action is just about to be removed from the group.

connectActionStateChanged

open fun connectActionStateChanged(connectFlags: <Error class: unknown class> = ConnectFlags(0u), handler: (actionName: String, <Error class: unknown class>) -> Unit): <Error class: unknown class>

Signals that the state of the named action has changed.

getActionEnabled