Viadeo Twitter Google Bookmarks ! Facebook Digg del.icio.us MySpace Yahoo MyWeb Blinklist Netvouz Reddit Simpy StumbleUpon Bookmarks Windows Live Favorites 
Logo Documentation Qt ·  Page d'accueil  ·  Toutes les classes  ·  Toutes les fonctions  ·  Vues d'ensemble  · 

QValueSpacePublisher Class Reference

The QValueSpacePublisher class allows applications to publish values in the Value Space. More...

 #include <QValueSpacePublisher>

Inherits QObject.

Public Functions

QValueSpacePublisher ( const QString & path, QObject * parent = 0 )
QValueSpacePublisher ( QValueSpace::LayerOptions filter, const QString & path, QObject * parent = 0 )
QValueSpacePublisher ( const QUuid & uuid, const QString & path, QObject * parent = 0 )
virtual ~QValueSpacePublisher ()
bool isConnected () const
QString path () const
void sync ()
  • 29 public functions inherited from QObject

Public Slots

void resetValue ( const QString & name )
void setValue ( const QString & name, const QVariant & data )
  • 1 public slot inherited from QObject

Signals

void interestChanged ( const QString & attribute, bool interested )

Reimplemented Protected Functions

virtual void connectNotify ( const char * member )
  • 7 protected functions inherited from QObject

Additional Inherited Members

  • 1 property inherited from QObject
  • 1 public variable inherited from QObject
  • 4 static public members inherited from QObject
  • 7 protected functions inherited from QObject
  • 2 protected variables inherited from QObject

Detailed Description

The QValueSpacePublisher class allows applications to publish values in the Value Space.

When multiple Value Space layers are available QValueSpacePublisher only publishes values to the layer with the highest order. The layers that QValueSpacePublisher can access can be limited by specifying either a filter or a QUuid at construction time.

The lifetime of values published in the Value Space is specified by the particular Value Space layer that the value is published in. For details on the different behaviors see QValueSpace::LayerOption.

Once a value is published all applications in the system will have read access to it via the QValueSpaceSubscriber class.

Although, logically, the Value Space is a simple collection of hierarchical paths, these paths can conceptually be visualized as a set of objects with attributes. For example, rather than viewing the following list as 12 distinct Value Space paths:

 /Device/Network/Interfaces/eth0/Name
 /Device/Network/Interfaces/eth0/Type
 /Device/Network/Interfaces/eth0/Status
 /Device/Network/Interfaces/eth0/BytesSent
 /Device/Network/Interfaces/eth0/BytesReceived
 /Device/Network/Interfaces/eth0/Time
 /Device/Network/Interfaces/ppp0/Name
 /Device/Network/Interfaces/ppp0/Type
 /Device/Network/Interfaces/ppp0/Status
 /Device/Network/Interfaces/ppp0/BytesSent
 /Device/Network/Interfaces/ppp0/BytesReceived
 /Device/Network/Interfaces/ppp0/Time

it can be thought of as describing two Value Space objects, { /Device/Network/Interfaces/eth0, /Device/Network/Interfaces/ppp0 }, each with the six attributes {Name, Type, Status, BytesSent, BytesReceived, Time}. The QValueSpacePublisher class encapsulates this abstraction.

For performance reasons the setting of and removing of attributes is buffered internally by the QValueSpacePublisher and applied as a batch sometime later. Normally this occurs the next time the application enters the Qt event loop, but this behavior should not be relied upon. If an application must synchronize with others, the QValueSpacePublisher::sync() and QValueSpacePublisher::syncAll() functions can be used to force the application of changes. This call is generally unnecessary, and should be used sparingly to prevent unnecessary load on the system.

See also QValueSpaceSubscriber.

Member Function Documentation

QValueSpacePublisher::QValueSpacePublisher ( const QString & path, QObject * parent = 0 )

Constructs a QValueSpacePublisher with the specified parent that publishes values under path.

QValueSpacePublisher::QValueSpacePublisher ( QValueSpace::LayerOptions filter, const QString & path, QObject * parent = 0 )

Constructs a QValueSpacePublisher with the specified parent that publishes values under path. The filter parameter is used to limit which layer this QValueSpacePublisher will access.

The constructed Value Space publisher will access the QAbstractValueSpaceLayer layer with the highest order (QAbstractValueSpaceLayer::order()) that matches filter and for which path is a valid path.

If no suitable QAbstractValueSpaceLayer layer is found, the constructed QValueSpacePublisher will be unconnected.

See also isConnected().

QValueSpacePublisher::QValueSpacePublisher ( const QUuid & uuid, const QString & path, QObject * parent = 0 )

Constructs a QValueSpacePublisher with the specified parent that publishes values under path. Only the layer identified by uuid will be accessed by this publisher.

Use of this constructor is not platform agnostic. If possible use one of the constructors that take a QAbstractValueSpaceLayer::LayerOptions parameter instead.

If a layer with a matching uuid is not found, the constructed QValueSpacePublisher will be unconnected.

See also isConnected().

QValueSpacePublisher::~QValueSpacePublisher () [virtual]

Destroys the QValueSpacePublisher. This will remove all values published by this publisher in non-permanent layers.

void QValueSpacePublisher::connectNotify ( const char * member ) [virtual protected]

Reimplemented from QObject::connectNotify().

Registers this QValueSpacePublisher for notifications when QValueSpaceSubscribers are interested in values under path().

Generally you do not need to call this function as it is automatically called when connections are made to this classes signals. member is the signal that has been connected.

If you reimplement this virtual function it is important that you call this implementation from your implementation.

See also interestChanged().

void QValueSpacePublisher::interestChanged ( const QString & attribute, bool interested ) [signal]

Signal that is emitted when interest in attribute changes. If interested is true at least on QValueSpaceSubscriber is interested in the value of attribute.

bool QValueSpacePublisher::isConnected () const

Returns true if this QValueSpacePublisher is connected to an available layer; otherwise returns false.

QString QValueSpacePublisher::path () const

Returns the path that this QValueSpacePublisher refers to.

void QValueSpacePublisher::resetValue ( const QString & name ) [slot]

Removes the value name and all sub-attributes from the system.

For example:

 QValueSpacePublisher publisher("/Device");
 publisher.setValue("State", "Starting");
 publisher.setValue("State/Memory", "1000");
 publisher.sync();
 // QValueSpaceSubscriber("/Device/State").value() == QVariant("Starting")
 // QValueSpaceSubscriber("/Device/State/Memory").value() == QVariant("1000")

 publisher.resetValue("State");
 publisher.sync();
 // QValueSpaceSubscriber("/Device/State").value() == QVariant();
 // QValueSpaceSubscriber("/Device/State/Memory").value() == QVariant();

void QValueSpacePublisher::setValue ( const QString & name, const QVariant & data ) [slot]

Sets the value name on the publisher to data. If name is empty, this call will set the value of this publisher's path.

For example:

 QValueSpacePublisher publisher("/Device");
 publisher.setValue("State", "Starting");
 publisher.sync();

 // QValueSpaceSubscriber("/Device/State").value() == QVariant("Starting")

void QValueSpacePublisher::sync ()

Forcibly sync all Value Space publisher using the same layer as this publisher.

For performance reasons attribute changes are batched internally by QValueSpacePublisher instances. In cases where the visibility of changes must be synchronized with other processes, calling this function will flush these batches. By the time this function returns, all other processes in the system will be able to see the attribute changes.

Generally, calling this function is unnecessary.

X

Thank you for giving your feedback.

Make sure it is related to this specific page. For more general bugs and requests, please use the Qt Bug Tracker.

[0]; s.parentNode.insertBefore(ga, s); })();
Publicité

Best Of

Actualités les plus lues

Semaine
Mois
Année
  1. « Quelque chose ne va vraiment pas avec les développeurs "modernes" », un développeur à "l'ancienne" critique la multiplication des bibliothèques 94
  2. Apercevoir la troisième dimension ou l'utilisation multithreadée d'OpenGL dans Qt, un article des Qt Quarterly traduit par Guillaume Belz 0
  3. Pourquoi les programmeurs sont-ils moins payés que les gestionnaires de programmes ? Manquent-ils de pouvoir de négociation ? 45
  4. Les développeurs ignorent-ils trop les failles découvertes dans leur code ? Prenez-vous en compte les remarques des autres ? 17
  5. Les développeurs détestent-ils les antivirus ? Un programmeur manifeste sa haine envers ces solutions de sécurité 6
  6. Quelles nouveautés de C++11 Visual C++ doit-il rapidement intégrer ? Donnez-nous votre avis 10
  7. Qt Commercial : Digia organise un webinar gratuit le 27 mars sur la conception d'interfaces utilisateur et d'applications avec le framework 0
Page suivante

Le Qt Quarterly au hasard

Logo

Conserver la réactivité de l'IHM

Qt Quarterly est la revue trimestrielle proposée par Nokia et à destination des développeurs Qt. Ces articles d'une grande qualité technique sont rédigés par des experts Qt. Lire l'article.

Communauté

Ressources

Liens utiles

Contact

  • Vous souhaitez rejoindre la rédaction ou proposer un tutoriel, une traduction, une question... ? Postez dans le forum Contribuez ou contactez-nous par MP ou par email (voir en bas de page).

Qt dans le magazine

Cette page est une traduction d'une page de la documentation de Qt, écrite par Nokia Corporation and/or its subsidiary(-ies). Les éventuels problèmes résultant d'une mauvaise traduction ne sont pas imputables à Nokia. Qt qtmobility-1.1
Copyright © 2012 Developpez LLC. Tous droits réservés Developpez LLC. Aucune reproduction, même partielle, ne peut être faite de ce site et de l'ensemble de son contenu : textes, documents et images sans l'autorisation expresse de Developpez LLC. Sinon, vous encourez selon la loi jusqu'à 3 ans de prison et jusqu'à 300 000 E de dommages et intérêts. Cette page est déposée à la SACD.
Vous avez déniché une erreur ? Un bug ? Une redirection cassée ? Ou tout autre problème, quel qu'il soit ? Ou bien vous désirez participer à ce projet de traduction ? N'hésitez pas à nous contacter ou par MP !
 
 
 
 
Partenaires

Hébergement Web