Interface $interface.short_name

Interface Index (Compact) | Summary #if $interface.client_interests: | Client Interests #if $interface.docstring: | Description #if $interface.methods: | Methods #if $interface.signals: | Signals #if $interface.properties: | Properties #if $interface.tpproperties: | Telepathy Properties #if $interface.contact_attributes: | Contact Attributes #if $interface.handler_capability_tokens: | Handler Capability Tokens #if $interface.types: | Types
#if $interface.methods or $interface.signals or $interface.properties or $interface.types or $interface.tpproperties
#if $interface.client_interests

Client Interests

#for $interest in $interface.client_interests #end for
$interest.name
#end if #if $interface.methods

Methods

#for $method in $interface.methods #if $method.is_deprecated #else #end if #end for
$method.short_name ($method.get_in_args()) → $method.get_out_args() #if $method.is_deprecated: (deprecated)
#end if #if $interface.signals

Signals

#for $signal in $interface.signals #if $signal.is_deprecated #else #end if #end for
$signal.short_name ($signal.get_args()) #if $signal.is_deprecated: (deprecated)
#end if #if $interface.properties

Properties

#for $property in $interface.properties #if $property.is_deprecated #else #end if #end for
$property.short_name $property.dbus_type #if $property.type: ($property.get_type().short_name) $property.get_access() $property.get_flag_summary() #if $property.is_deprecated: (deprecated)
#end if #if $interface.tpproperties

Telepathy Properties

#for $property in $interface.tpproperties #end for
$property.short_name $property.dbus_type #if $property.type: ($property.get_type().short_name)
#end if #if $interface.contact_attributes

Contact Attributes

#for $token in $interface.contact_attributes #end for
$token.name $token.dbus_type #if $token.type: ($token.get_type().short_name)
#end if #if $interface.handler_capability_tokens

Handler Capability Tokens

#for $token in $interface.handler_capability_tokens #end for
$token.name #if $token.is_family (etc.) #end if
#end if #if $interface.types

Types

#for $type in $interface.types #if type.is_deprecated #else #end if #end for
$type.short_name $type.get_type_name() $type.dbus_type #if $type.is_deprecated: (deprecated)
#end if
#end if #if $interface.causes_havoc
WARNING: This interface is $interface.causes_havoc and is likely to cause havoc to your API/ABI if bindings are generated. Do not include this interface in libraries that care about compatibility.
#end if $interface.get_added() $interface.get_changed() $interface.get_deprecated() #if $interface.requires or $interface.xor_requires
Objects implementing this interface must also implement:
#end if #if $interface.docstring

Description

$interface.get_docstring() #end if #if $interface.client_interests

Client Interests

Set using the AddClientInterest and RemoveClientInterest methods.
#for $interest in $interface.client_interests
(Permalink)

$interest.name

$interest.get_docstring()
#end for
#end if #if $interface.methods

Methods

#for $method in $interface.methods
(Permalink)

$method.short_name ($method.get_in_args()) → $method.get_out_args()

$method.get_added() $method.get_changed() $method.get_deprecated() #if $method.no_reply
The caller should not expect a reply when calling this method.
#end if #if $method.in_args

Parameters

    #for $arg in $method.in_args
  • $arg.short_name — $arg.dbus_type #if $arg.get_type(): ($arg.get_type().short_name)
    • $arg.get_added() $arg.get_changed() $arg.get_deprecated() $arg.get_docstring() #end for
#end if #if $method.out_args

Returns

    #for $arg in $method.out_args
  • $arg.short_name — $arg.dbus_type #if $arg.get_type(): ($arg.get_type().short_name)
    • $arg.get_added() $arg.get_changed() $arg.get_deprecated() $arg.get_docstring() #end for
#end if $method.get_docstring() #if $method.possible_errors

Possible Errors

    #for $error in $method.possible_errors
  • $error.get_error().short_name
    • $error.get_added() $error.get_changed() $error.get_deprecated() $error.get_docstring() #end for
#end if
#end for
#end if #if $interface.signals

Signals

#for $signal in $interface.signals
(Permalink)

$signal.short_name ($signal.get_args())

$signal.get_added() $signal.get_changed() $signal.get_deprecated() #if $signal.args

Parameters

    #for $arg in $signal.args
  • $arg.short_name — $arg.dbus_type #if $arg.get_type(): ($arg.get_type().short_name)
    • $arg.get_added() $arg.get_changed() $arg.get_deprecated() $arg.get_docstring() #end for
#end if $signal.get_docstring()
#end for
#end if #if $interface.properties

Properties

Accessed using the org.freedesktop.DBus.Properties interface.
#for $property in $interface.properties
(Permalink)

$property.short_name — $property.dbus_type #if $property.type: ($property.get_type().short_name)

$property.get_access()
#if $property.sometimes_immutable:
Depending on the protocol, this property may be immutable which means that it can never #if $interface.is_channel_related: change once the channel has been created. Immutable properties SHOULD appear in the channel detail list of NewChannels signals. #else change. #end if
#elif $property.immutable:
This property is immutable which means that it can never #if $interface.is_channel_related: change once the channel has been created. Immutable properties SHOULD appear in the channel detail list of NewChannels signals. #else change. #end if
#end if #if $property.sometimes_requestable:
Depending on the protocol, this property may be requestable, which means that it may be allowed in the properties hash of a channel request such as in the CreateChannel and EnsureChannel methods on Requests and ChannelDispatcher. If supported on this protocol, the property should appear in either the Fixed_Properties or Allowed_Properties of a RequestableChannelClass advertised by the CM.
#elif $property.requestable:
This property is requestable, which means that it is allowed in the properties hash of a channel request such as in the CreateChannel and EnsureChannel methods on Requests and ChannelDispatcher. The property should also appear in either the Fixed_Properties or Allowed_Properties of a RequestableChannelClass advertised by the CM.
#end if $property.get_added() $property.get_changed() $property.get_deprecated() #if $property.emits_changed == $property.EMITS_CHANGED_UPDATES
When this property changes, the org.freedesktop.DBus.Properties.PropertiesChanged signal is emitted with the new value.
#elif $property.emits_changed == $property.EMITS_CHANGED_INVALIDATES
When this property changes, the org.freedesktop.DBus.Properties.PropertiesChanged signal is emitted, but the new value is not sent.
#elif $property.emits_changed == $property.EMITS_CHANGED_NONE
The org.freedesktop.DBus.Properties.PropertiesChanged signal is not emitted when this property changes.
#end if #if $property.is_connection_parameter:

Note: Connections implementing this property SHOULD provide a corresponding parameter named $property.name with the DBus_Property flag. Clients SHOULD update this property by calling UpdateParameters on the relevant Account rather than setting the property directly; change notification is via AccountPropertyChanged.

#end if $property.get_docstring()
#end for
#end if #if $interface.tpproperties

Telepathy Properties

Accessed using the org.freedesktop.Telepathy.Properties interface.
#for $property in $interface.tpproperties
(Permalink)

$property.short_name — $property.dbus_type #if $property.type: ($property.get_type().short_name)

$property.get_added() $property.get_changed() $property.get_deprecated() $property.get_docstring()
#end for
#end if #if $interface.contact_attributes

Contact Attributes

Attributes that a contact can have, accessed with the org.freedesktop.Telepathy.Connection.Interface.Contacts interface.
#for $token in $interface.contact_attributes
(Permalink)

$token.name — $token.dbus_type #if $token.type: ($token.get_type().short_name)

$token.get_added() $token.get_changed() $token.get_deprecated() $token.get_docstring()
#end for
#end if #if $interface.handler_capability_tokens

Handler Capability Tokens

Tokens representing capabilities that a Client.Handler can have.
#for $token in $interface.handler_capability_tokens
(Permalink)

$token.name #if $token.is_family (etc.) #end if

$token.get_added() $token.get_changed() $token.get_deprecated() $token.get_docstring()
#end for
#end if #if $interface.types

Types

#for $type in $interface.types
$type.get_type_name() (Permalink)

$type.short_name — $type.dbus_type

$type.get_added() $type.get_changed() $type.get_deprecated() $type.get_docstring() $type.get_breakdown()
#end for
#end if