QDBusAbstractInterface¶

The QDBusAbstractInterface class is the base class for all D-Bus interfaces in the Qt D-Bus binding, allowing access to remote interfaces. More…

Inherited by: QDBusInterface, QDBusConnectionInterface

Synopsis¶

Functions¶

def asyncCall (method)
def asyncCallWithArgumentList (method, args)
def call (arg__1, arg__2)
def call (arg__1, arg__2, arg__3)
def call (arg__1, arg__2, arg__3)
def call (arg__1, arg__2, arg__3, arg__4)
def call (arg__1, arg__2, arg__3, arg__4)
def call (arg__1, arg__2, arg__3, arg__4, arg__5)
def call (arg__1, arg__2, arg__3, arg__4, arg__5)
def call (arg__1, arg__2, arg__3, arg__4, arg__5, arg__6)
def call (method)
def call (mode, method)
def callWithArgumentList (mode, method, args)
def callWithCallback (method, args, receiver, member)
def callWithCallback (method, args, receiver, member, errorSlot)
def connection ()
def interface ()
def internalConstCall (mode, method[, args=list()])
def internalPropGet (propname)
def internalPropSet (propname, value)
def isValid ()
def lastError ()
def path ()
def service ()
def setTimeout (timeout)
def timeout ()

Detailed Description¶

Generated-code classes also derive from QDBusAbstractInterface , all methods described here are also valid for generated-code classes. In addition to those described here, generated-code classes provide member functions for the remote methods, which allow for compile-time checking of the correct parameters and return values, as well as property type-matching and signal parameter-matching.

See also

The QDBus compiler QDBusInterface

class PySide6.QtDBus.QDBusAbstractInterface(service, path, interface, connection, parent)¶

Parameters

interface – str
path – str
service – str
connection – PySide6.QtDBus.QDBusConnection
parent – PySide6.QtCore.QObject

PySide6.QtDBus.QDBusAbstractInterface.asyncCall(method)¶

Parameters: method – str
Return type: PySide6.QtDBus.QDBusPendingCall

PySide6.QtDBus.QDBusAbstractInterface.asyncCallWithArgumentList(method, args)¶

Parameters

method – str
args –

Return type

PySide6.QtDBus.QDBusPendingCall

Places a call to the remote method specified by method on this interface, using args as arguments. This function returns a QDBusPendingCall object that can be used to track the status of the reply and access its contents once it has arrived.

Normally, you should place calls using asyncCall() .

PySide6.QtDBus.QDBusAbstractInterface.call(arg__1, arg__2, arg__3)¶

Parameters

arg__1 – CallMode
arg__2 – str
arg__3 – object

Return type

PySide6.QtDBus.QDBusMessage

This is an overloaded function.

Calls the method method on this interface and passes args to the method. All args must be convertible to QVariant .

If mode is NoWaitForReply, then this function will return immediately after placing the call, without waiting for a reply from the remote method. Otherwise, mode indicates whether this function should activate the Qt Event Loop while waiting for the reply to arrive.

If this function reenters the Qt event loop in order to wait for the reply, it will exclude user input. During the wait, it may deliver signals and other method calls to your application. Therefore, it must be prepared to handle a reentrancy whenever a call is placed with call() .

Note

Before Qt 5.14, this function accepted a maximum of just eight (8) arguments.

See also

callWithArgumentList()

PySide6.QtDBus.QDBusAbstractInterface.call(method)

Parameters: method – str
Return type: PySide6.QtDBus.QDBusMessage

PySide6.QtDBus.QDBusAbstractInterface.call(arg__1, arg__2, arg__3, arg__4, arg__5)

Parameters

arg__1 – str
arg__2 – object
arg__3 – object
arg__4 – object
arg__5 – object

Return type

PySide6.QtDBus.QDBusMessage

PySide6.QtDBus.QDBusAbstractInterface.call(arg__1, arg__2, arg__3, arg__4)

Parameters

arg__1 – str
arg__2 – object
arg__3 – object
arg__4 – object

Return type

PySide6.QtDBus.QDBusMessage

PySide6.QtDBus.QDBusAbstractInterface.call(arg__1, arg__2, arg__3)

Parameters

arg__1 – str
arg__2 – object
arg__3 – object

Return type

PySide6.QtDBus.QDBusMessage

This is an overloaded function.

Calls the method method on this interface and passes args to the method. All args must be convertible to QVariant .

If mode is NoWaitForReply, then this function will return immediately after placing the call, without waiting for a reply from the remote method. Otherwise, mode indicates whether this function should activate the Qt Event Loop while waiting for the reply to arrive.

If this function reenters the Qt event loop in order to wait for the reply, it will exclude user input. During the wait, it may deliver signals and other method calls to your application. Therefore, it must be prepared to handle a reentrancy whenever a call is placed with call() .

Note

Before Qt 5.14, this function accepted a maximum of just eight (8) arguments.

See also

callWithArgumentList()

PySide6.QtDBus.QDBusAbstractInterface.call(arg__1, arg__2)

Parameters

arg__1 – str
arg__2 – object

Return type

PySide6.QtDBus.QDBusMessage

Calls the method method on this interface and passes args to the method. All args must be convertible to QVariant .

The parameters to call are passed on to the remote function via D-Bus as input arguments. Output arguments are returned in the QDBusMessage reply. If the reply is an error reply, lastError() will also be set to the contents of the error message.

It can be used the following way:

value = retrieveValue()
reply = QDBusMessage()
api = interface.call("GetAPIVersion")
if api >= 14:
  reply = interface.call("ProcessWorkUnicode"), value
else:
  reply = interface.call("ProcessWork"), QLatin1String("UTF-8"), value.toUtf8()

This example illustrates function calling with 0, 1 and 2 parameters and illustrates different parameter types passed in each (the first call to "ProcessWorkUnicode" will contain one Unicode string, the second call to "ProcessWork" will contain one string and one byte array).

Note

Before Qt 5.14, this function accepted a maximum of just eight (8) arguments.

See also

callWithArgumentList()

PySide6.QtDBus.QDBusAbstractInterface.call(mode, method)

Parameters

mode – CallMode
method – str

Return type

PySide6.QtDBus.QDBusMessage

Calls the method method on this interface and passes args to the method. All args must be convertible to QVariant .

The parameters to call are passed on to the remote function via D-Bus as input arguments. Output arguments are returned in the QDBusMessage reply. If the reply is an error reply, lastError() will also be set to the contents of the error message.

It can be used the following way:

value = retrieveValue()
reply = QDBusMessage()
api = interface.call("GetAPIVersion")
if api >= 14:
  reply = interface.call("ProcessWorkUnicode"), value
else:
  reply = interface.call("ProcessWork"), QLatin1String("UTF-8"), value.toUtf8()

This example illustrates function calling with 0, 1 and 2 parameters and illustrates different parameter types passed in each (the first call to "ProcessWorkUnicode" will contain one Unicode string, the second call to "ProcessWork" will contain one string and one byte array).

Note

Before Qt 5.14, this function accepted a maximum of just eight (8) arguments.

See also

callWithArgumentList()

PySide6.QtDBus.QDBusAbstractInterface.call(arg__1, arg__2, arg__3, arg__4, arg__5, arg__6)

Parameters

arg__1 – CallMode
arg__2 – str
arg__3 – object
arg__4 – object
arg__5 – object
arg__6 – object

Return type

PySide6.QtDBus.QDBusMessage

PySide6.QtDBus.QDBusAbstractInterface.call(arg__1, arg__2, arg__3, arg__4, arg__5)

Parameters

arg__1 – CallMode
arg__2 – str
arg__3 – object
arg__4 – object
arg__5 – object

Return type

PySide6.QtDBus.QDBusMessage

PySide6.QtDBus.QDBusAbstractInterface.call(arg__1, arg__2, arg__3, arg__4)

Parameters

arg__1 – CallMode
arg__2 – str
arg__3 – object
arg__4 – object

Return type

PySide6.QtDBus.QDBusMessage

PySide6.QtDBus.QDBusAbstractInterface.callWithArgumentList(mode, method, args)¶

Parameters

mode – CallMode
method – str
args –

Return type

PySide6.QtDBus.QDBusMessage

Places a call to the remote method specified by method on this interface, using args as arguments. This function returns the message that was received as a reply, which can be a normal ReplyMessage (indicating success) or ErrorMessage (if the call failed). The mode parameter specifies how this call should be placed.

If the call succeeds, lastError() will be cleared; otherwise, it will contain the error this call produced.

Normally, you should place calls using call() .

Warning

If you use UseEventLoop, your code must be prepared to deal with any reentrancy: other method calls and signals may be delivered before this function returns, as well as other Qt queued signals and events.

PySide6.QtDBus.QDBusAbstractInterface.callWithCallback(method, args, receiver, member)¶

Parameters

method – str
args –
receiver – PySide6.QtCore.QObject
member – str

Return type

bool

This is an overloaded function.

This function is deprecated. Please use the overloaded version.

Places a call to the remote method specified by method on this interface, using args as arguments. This function returns immediately after queueing the call. The reply from the remote function or any errors emitted by it are delivered to the slot slot on object receiver.

This function returns true if the queueing succeeded: it does not indicate that the call succeeded. If it failed, the slot will be called with an error message. lastError() will not be set under those circumstances.

See also

QDBusError QDBusMessage

PySide6.QtDBus.QDBusAbstractInterface.callWithCallback(method, args, receiver, member, errorSlot)

Parameters

method – str
args –
receiver – PySide6.QtCore.QObject
member – str
errorSlot – str

Return type

bool

Places a call to the remote method specified by method on this interface, using args as arguments. This function returns immediately after queueing the call. The reply from the remote function is delivered to the returnMethod on object receiver. If an error occurs, the errorMethod on object receiver is called instead.

This function returns true if the queueing succeeds. It does not indicate that the executed call succeeded. If it fails, the errorMethod is called. If the queueing failed, this function returns false and no slot will be called.

The returnMethod must have as its parameters the types returned by the function call. Optionally, it may have a QDBusMessage parameter as its last or only parameter. The errorMethod must have a QDBusError as its only parameter.

See also

QDBusError QDBusMessage

PySide6.QtDBus.QDBusAbstractInterface.connection()¶

Return type: PySide6.QtDBus.QDBusConnection

Returns the connection this interface is associated with.

PySide6.QtDBus.QDBusAbstractInterface.interface()¶

Return type: str

Returns the name of this interface.

PySide6.QtDBus.QDBusAbstractInterface.internalConstCall(mode, method[, args=list()])¶

Parameters

mode – CallMode
method – str
args –

Return type

PySide6.QtDBus.QDBusMessage

PySide6.QtDBus.QDBusAbstractInterface.internalPropGet(propname)¶

Parameters: propname – str
Return type: object

PySide6.QtDBus.QDBusAbstractInterface.internalPropSet(propname, value)¶

Parameters

propname – str
value – object

PySide6.QtDBus.QDBusAbstractInterface.isValid()¶

Return type: bool

Returns true if this is a valid reference to a remote object. It returns false if there was an error during the creation of this interface (for instance, if the remote application does not exist).

Note: when dealing with remote objects, it is not always possible to determine if it exists when creating a QDBusInterface .

PySide6.QtDBus.QDBusAbstractInterface.lastError()¶

Return type: PySide6.QtDBus.QDBusError

Returns the error the last operation produced, or an invalid error if the last operation did not produce an error.

PySide6.QtDBus.QDBusAbstractInterface.path()¶

Return type: str

Returns the object path that this interface is associated with.

PySide6.QtDBus.QDBusAbstractInterface.service()¶

Return type: str

Returns the name of the service this interface is associated with.

PySide6.QtDBus.QDBusAbstractInterface.setTimeout(timeout)¶

Parameters: timeout – int

Sets the timeout in milliseconds for all future DBus calls to timeout. -1 means the default DBus timeout (usually 25 seconds).

See also

timeout()

PySide6.QtDBus.QDBusAbstractInterface.timeout()¶

Return type: int

Returns the current value of the timeout in milliseconds. -1 means the default DBus timeout (usually 25 seconds).

See also

setTimeout()

Table of Contents

Previous topic

Next topic

QDBusAbstractInterface¶

Synopsis¶

Functions¶

Detailed Description¶