Qt 4.8: QDBusVariant Class Reference

Qt Reference Documentation

- Qt 4.8
- ALL VERSIONS

- A
- A
- A
- Print

# QDBusVariant Class Reference

The QDBusVariant class enables the programmer to identify the variant type provided by the D-Bus typesystem. More...

     #include <QDBusVariant>

Inherits: QVariant (private).

This class was introduced in Qt 4.2.

- List of all members, including inherited members

## Public Functions

| QDBusVariant ()
| QDBusVariant ( const QVariant & variant )
void | setVariant ( const QVariant & variant )
QVariant | variant () const

- 46 public functions inherited from QVariant

### Additional Inherited Members

- 3 static public members inherited from QVariant

## Detailed Description

The QDBusVariant class enables the programmer to identify the variant type provided by the D-Bus typesystem.

A D-Bus function that takes an integer, a D-Bus variant and a string as parameters can be called with the following argument list (see QDBusMessage::setArguments()):

         QList<QVariant> arguments;
         arguments << QVariant(42) << QVariant::fromValue(QDBusVariant(43)) << QVariant("hello");
         myDBusMessage.setArguments(arguments);

When a D-Bus function returns a D-Bus variant, it can be retrieved as follows:

         // call a D-Bus function that returns a D-Bus variant
         QVariant v = callMyDBusFunction();
         // retrieve the D-Bus variant
         QDBusVariant dbusVariant = qvariant_cast<QDBusVariant>(v);
         // retrieve the actual value stored in the D-Bus variant
         QVariant result = dbusVariant.variant();

The QVariant within a QDBusVariant is required to distinguish between a normal D-Bus value and a value within a D-Bus variant.

See also The QtDBus type system.

## Member Function Documentation

### QDBusVariant::QDBusVariant ()

Constructs a new D-Bus variant.

### QDBusVariant::QDBusVariant ( const QVariant & variant )

Constructs a new D-Bus variant from the given Qt variant.

See also setVariant().

### void QDBusVariant::setVariant ( const QVariant & variant )

Assigns the value of the given Qt variant to this D-Bus variant.

See also variant().

### QVariant QDBusVariant::variant () const

Returns this D-Bus variant as a QVariant object.

See also setVariant().