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  · 

QMediaImageViewer Class Reference

The QMediaImageViewer class provides a means of viewing image media. More...

    #include <QMediaImageViewer>

This class is under development and is subject to change.

Inherits QMediaObject.


Public Types

enum MediaStatus { NoMedia, LoadingMedia, LoadedMedia, InvalidMedia }
enum State { StoppedState, PlayingState, PausedState }

Properties


Public Functions

QMediaImageViewer ( QObject * parent = 0 )
~QMediaImageViewer ()
int elapsedTime () const
QMediaContent media () const
MediaStatus mediaStatus () const
State state () const
int timeout () const

Public Slots

void pause ()
void play ()
void setMedia ( const QMediaContent & media )
void setTimeout ( int timeout )
void stop ()
  • 1 public slot inherited from QObject

Signals

void elapsedTimeChanged ( int time )
void mediaChanged ( const QMediaContent & media )
void mediaStatusChanged ( QMediaImageViewer::MediaStatus status )
void stateChanged ( QMediaImageViewer::State state )

Additional Inherited Members

  • 1 public type inherited from QObject
  • 4 static public members inherited from QObject
  • 2 protected functions inherited from QMediaObject
  • 7 protected functions inherited from QObject
  • 2 protected variables inherited from QObject

Detailed Description

The QMediaImageViewer class provides a means of viewing image media.

The primary use of QMediaImageViewer is to display image media. If asked to display a non-image media type QMediaImageViewer will instead display the media's cover art or poster if a URI is available for either.

In order to actually display an image the QMediaImageViewer class must be coupled with a display output such as QVideoWidget. A display output is attached to the image viewer by passing a pointer the QMediaImageViewer instance in the constructor of the display output, and can be removed by deleting the display output.

    viewer = new QMediaImageViewer(this);

    display = new QVideoWidget(viewer);
    display->show();

QMediaImageViewer can be paired with a QMediaPlaylist to create a slide show of images. Constructing a QMediaPlaylist with a pointer to an instance of QMediaImageViewer will attach it to the image viewer; changing the playlist's selection will then change the media displayed by the image viewer. With a playlist attached QMediaImageViewer's play(), pause(), and stop() slots can be control the progression of the playlist. The timeout property determines how long an image is displayed for before progressing to the next in the playlist, and the elapsedTime property holds how the duration the current image has been displayed for.

    playlist = new QMediaPlaylist(viewer, this);
    playlist->setPlaybackMode(QMediaPlaylist::Loop);
    playlist->appendItem(image1);
    playlist->appendItem(image2);
    playlist->appendItem(image3);

    viewer->setTimeout(5000);
    viewer->play();

Member Type Documentation

enum QMediaImageViewer::MediaStatus

Enumerates the status of an image viewer's current media.

ConstantValueDescription
QMediaImageViewer::NoMedia0There is no current media.
QMediaImageViewer::LoadingMedia1The image viewer is loading the current media.
QMediaImageViewer::LoadedMedia2The image viewer has loaded the current media.
QMediaImageViewer::InvalidMedia3The current media cannot be loaded.

enum QMediaImageViewer::State

Enumerates the possible control states an image viewer may be in. The control state of an image viewer determines whether the image viewer is automatically progressing through images in an attached playlist.

ConstantValueDescription
QMediaImageViewer::StoppedState0The image viewer is stopped, and will not automatically move to the next image. The elapsedTime is fixed at 0.
QMediaImageViewer::PlayingState1The slide show is playing, and will move to the next image when the elapsedTime reaches the timeout. The elapsedTime is being incremented.
QMediaImageViewer::PausedState2The image viewer is paused, and will not automatically move the to next image. The elapsedTime is fixed at the time the image viewer was paused.


Property Documentation

elapsedTime : const int

This property holds the amount of time in milliseconds that has elapsed since the current image was loaded.

The elapsed time only increases while the image viewer is in the PlayingState. If stopped the elapsed time will be reset to 0.

Access functions:

int elapsedTime () const

Notifier signal:

void elapsedTimeChanged ( int time )

media : QMediaContent

This property holds the media an image viewer is presenting.

If the media is on a non image type the image viewer will instead display the media's cover art or poster if a URI is available for either.

Access functions:

QMediaContent media () const
void setMedia ( const QMediaContent & media )

Notifier signal:

void mediaChanged ( const QMediaContent & media )

mediaStatus : const MediaStatus

This property holds the status of the current media.

Access functions:

MediaStatus mediaStatus () const

Notifier signal:

void mediaStatusChanged ( QMediaImageViewer::MediaStatus status )

state : const State

This property holds the playlist control state of a slide show.

Access functions:

State state () const

Notifier signal:

void stateChanged ( QMediaImageViewer::State state )

timeout : int

This property holds the amount of time in milliseconds an image is displayed for before moving to the next image.

The timeout only applies if the image viewer has a playlist attached and is in the PlayingState.

Access functions:

int timeout () const
void setTimeout ( int timeout )

Member Function Documentation

QMediaImageViewer::QMediaImageViewer ( QObject * parent = 0 )

Constructs a new image viewer with the given parent.

QMediaImageViewer::~QMediaImageViewer ()

Destroys an image viewer.

void QMediaImageViewer::elapsedTimeChanged ( int time )   [signal]

Signals that the amount of time in milliseconds since the current image was loaded has changed.

This signal is emitted at a regular interval when the image viewer is in the PlayingState and an image is loaded. The notification interval is controlled by the QMediaObject::notifyInterval property.

See also timeout and QMediaObject::notifyInterval.

void QMediaImageViewer::mediaChanged ( const QMediaContent & media )   [signal]

Signals that the media an image viewer is presenting has changed.

void QMediaImageViewer::mediaStatusChanged ( QMediaImageViewer::MediaStatus status )   [signal]

Signals the the status of the current media has changed.

void QMediaImageViewer::pause ()   [slot]

Pauses a slide show.

The current media and elapsed time are retained. If resumed, the current image will be displayed for the remainder of the time out period before the next image is loaded.

void QMediaImageViewer::play ()   [slot]

Starts a slide show.

If the playlist has no current media this will start at the beginning of the playlist, otherwise it will resume from the current media.

If no playlist is attached to an image viewer this will do nothing.

void QMediaImageViewer::stateChanged ( QMediaImageViewer::State state )   [signal]

Signals that the playlist control state of an image viewer has changed.

void QMediaImageViewer::stop ()   [slot]

Stops a slide show.

The current media is retained, but the elapsed time is discarded. If resumed, the current image will be displayed for the full time out period before the next image is loaded.

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. Les développeurs ignorent-ils trop les failles découvertes dans leur code ? Prenez-vous en compte les remarques des autres ? 17
  4. Pourquoi les programmeurs sont-ils moins payés que les gestionnaires de programmes ? Manquent-ils de pouvoir de négociation ? 42
  5. Quelles nouveautés de C++11 Visual C++ doit-il rapidement intégrer ? Donnez-nous votre avis 10
  6. Adieu qmake, bienvenue qbs : Qt Building Suite, un outil déclaratif et extensible pour la compilation de projets Qt 17
  7. 2017 : un quinquennat pour une nouvelle version du C++ ? Possible, selon Herb Sutter 7
Page suivante

Le blog Digia au hasard

Logo

Créer des applications avec un style Metro avec Qt, exemples en QML et C++, un article de Digia Qt traduit par Thibaut Cuvelier

Le blog Digia est l'endroit privilégié pour la communication sur l'édition commerciale de Qt, où des réponses publiques sont apportées aux questions les plus posées au support. 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.0-tp
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