MeeGo 1.2 Harmattan Developer Documentation Develop for the Nokia N9

QValueSpace Namespace

The QValueSpace namespace contains miscellaneous identifiers used throughtout the Publish and Subscribe API. More...

 #include <QValueSpace>

Types

enum LayerOption { UnspecifiedLayer, PermanentLayer, TransientLayer, WritableLayer, ReadOnlyLayer }
flags LayerOptions

Functions

QList<QUuid> availableLayers ()
void initValueSpaceServer ()

Macros

QVALUESPACE_CONTEXTKIT_LAYER
QVALUESPACE_NONVOLATILEREGISTRY_LAYER
QVALUESPACE_SHAREDMEMORY_LAYER
QVALUESPACE_SYMBIAN_SETTINGS_LAYER
QVALUESPACE_VOLATILEREGISTRY_LAYER

Detailed Description

The QValueSpace namespace contains miscellaneous identifiers used throughtout the Publish and Subscribe API.

Type Documentation

enum QValueSpace::LayerOption
flags QValueSpace::LayerOptions

This enum describes the behaviour of the Value Space layer. In addition this enum is used as a filter when constructing a QValueSpacePublisher or QValueSpaceSubscriber.

Constant Value Description
QValueSpace::UnspecifiedLayer 0x0000 Used as a filter to specify that any layer should be used.
QValueSpace::PermanentLayer 0x0001 Indicates that the layer uses a permanent backing store. When used as a filter only layers that use a permanent backing store will be used.
Values stored in a layer with this option will persist with in the layer after the QValueSpacePublisher that published them is destroyed. Whether the value persists in the layer after the server or device is restarted is system dependent.
This option and the TransientLayer option are mutually exclusive.
QValueSpace::TransientLayer 0x0002 Indicates that the layer does not use a permanent backing store. When used as a filter only layers that do not use permanent backing stores will be used.
Values stored in a layer with this option will be removed when the QValueSpacePublisher that published them is destroyed.
This option and the PermanentLayer option are mutually exclusive.
QValueSpace::WritableLayer 0x0004 Indicates that the layer can update its contents. When used as a filter only layers that are writable will be used.
Applications can use QValueSpacePublisher to publish values to layers that have this option.
This option and the ReadOnlyLayer option are mutually exclusive.
QValueSpace::ReadOnlyLayer 0x0008 Indicates that the layer cannot update its contents. When used as a filter only layers that are read-only will be used.
Applications can not publish values to layers with this option.
This option and the WritableLayer option are mutually exclusive.

The LayerOptions type is a typedef for QFlags<LayerOption>. It stores an OR combination of LayerOption values.

Function Documentation

QList<QUuid> QValueSpace::availableLayers ()

Returns a list of QUuids of all of the available layers.

This function was introduced in Qt Mobility 1.0.

void QValueSpace::initValueSpaceServer ()

Initialize the Value Space manager as the server. This method only needs to be called by the process acting as the server and should be called before any process in the system uses a value space class.

This function was introduced in Qt Mobility 1.0.

Macro Documentation

QVALUESPACE_CONTEXTKIT_LAYER

The UUID of the ContextKit layer as a QUuid. The actual UUID values is {2c769b9e-d949-4cd1-848f-d32241fe07ff}.

This value can be passed to the constructor of QValueSpacePublisher or QValueSpaceSubscriber to force the constructed object to only access the ContextKit layer.

You can test if the ContextKit layer is available by checking if the list returned by QValueSpace::availableLayers() contains this value.

This function was introduced in Qt Mobility 1.0.

QVALUESPACE_NONVOLATILEREGISTRY_LAYER

The UUID of the Non-Volatile Registry layer as a QUuid. The actual UUID value is {8e29561c-a0f0-4e89-ba56-080664abc017}.

This value can be passed to the constructor of QValueSpacePublisher or QValueSpaceSubscriber to force the constructed object to only access the Non-Volatile Registry layer.

You can test if the Non-Volatile Registry layer is available by checking if the list returned by QValueSpace::availableLayers() contains this value. The Non-Volatile Registry layer is only available on Windows platforms.

This function was introduced in Qt Mobility 1.0.

QVALUESPACE_SHAREDMEMORY_LAYER

The UUID of the Shared Memory layer as a QUuid. The actual UUID value is {d81199c1-6f60-4432-934e-0ce4d37ef252}.

This value can be passed to the constructor of QValueSpacePublisher or QValueSpaceSubscriber to force the constructed object to only access the Shared Memory layer.

You can test if the Shared Memory layer is available by checking if the list returned by QValueSpace::availableLayers() contains this value.

This function was introduced in Qt Mobility 1.0.

QVALUESPACE_SYMBIAN_SETTINGS_LAYER

The UUID of the Symbian Settings layer as a QUuid. The actual UUID value is {40d7b059-66ac-442f-b222-9c8ab98b9c2d}.

This value can be passed to the constructor of QValueSpacePublisher or QValueSpaceSubscriber to force the constructed object to only access the Symbian Settings layer.

You can test if the Symbian Settings layer is available by checking if the list returned by QValueSpace::availableLayers() contains this value.

This function was introduced in Qt Mobility 1.0.

QVALUESPACE_VOLATILEREGISTRY_LAYER

The UUID of the Volatile Registry layer as a QUuid. The actual UUID value is {8ceb5811-4968-470f-8fc2-264767e0bbd9}.

This value can be passed to the constructor of QValueSpacePublisher or QValueSpaceSubscriber to force the constructed object to only access the Volatile Registry layer.

You can test if the Volatile Registry layer is available by checking if the list returned by QValueSpace::availableLayers() contains this value. The Volatile Registry layer is only available on Windows platforms.

This function was introduced in Qt Mobility 1.0.