TXSLib : Class TImageList

La classe TImageList est un widget qui permet d'afficher une image parmi une liste d'images chargées. Cela permet des animations simples de visualisation


Cette classe d'objet est compatible avec son utllisation sur un afficheur LCD. Voir la rubrique : LCD 7789 avec Qt


Ci-dessous un exemple d'un objet de la classe TImageList qui anime les 4 images ci-dessous :



Dialog::Dialog(QWidget *parent)
   : QDialog(parent)
{
  TXS::Init();

  // Dialogue de taille fixe
  setFixedSize(250,375);

  // Elément de l'interface opérateur
  m_pLayout = new QVBoxLayout();
  m_pImageList = new TImageList();

  m_pImageList->setFixedSize(225, 350);

  m_pImageList->Append(QCoreApplication::applicationDirPath()+"/engine1.jpg");
  m_pImageList->Append(QCoreApplication::applicationDirPath()+"/engine2.jpg");
  m_pImageList->Append(QCoreApplication::applicationDirPath()+"/engine3.jpg");
  m_pImageList->Append(QCoreApplication::applicationDirPath()+"/engine4.jpg");

  m_pLayout->addWidget(m_pImageList);
  setLayout(m_pLayout);

  // Connections signaux <--> slots
  connect(&m_Timer, SIGNAL(timeout()), this, SLOT(OnTimeout()));

  m_Timer.start(150);
}

Dialog::~Dialog()
{
  m_Timer.stop();
}

void Dialog::OnTimeout()
{
  m_pImageList->SetAtNext();
}

Relations d'héritage

- Hérite de :
   - TWidget.

Fonctions publiques

TImageList(QWidget *parent = nullptr)
boolAppend(const QDir& Dir)
boolAppend(const QPixmap& Pixmap)
boolAppend(const QString& strFileName)
voidvoid Clear()
voidvoid Copy(TImageList* pTarget)
intvoid Count()
voidbool Draw(QPainter* pPainter, const QRect& Rect)
QStringGetImageName(int Position)
QUuidGetTWidgetIdentifier()
QStringGetTWidgetIdentifierAsString()
QStringGetTWidgetName()
boolInsertAt(const int& Position, const QDir& Dir)
boolInsertAt(const int& Position, const QPixmap& Pixmap)
boolInsertAt(const int& Position, const QString& strFileName)
boolIsEmpty()
boolPrepend(const QDir& Dir)
boolPrepend(const QPixmap& Pixmap)
boolPrepend(const QString& strFileName)
boolRemoveAt(const int& Position)
boolRemoveFirst()
boolRemoveLast()
intSelectedImage()
boolSetAt(int Position)
boolSetAtFirst()
boolSetAtLast()
boolSetAtNext()
boolSetAtPrevious()


TImageList::TImageList(QWidget *parent = nullptr)

Description : Contructeur. Instancie un objet de la classe TImageList.


Paramètre : parent - type QWidget* - Pointeur vers un QWidget parent s'il existe. Ce paramètre est optionnel



bool TImageList::Append(const QDir& Dir)

Description : Ajoute toutes les images d'un répertoire en fin de liste. Le répertoire ne doit contenir que des fichiers images compatibles.


Paramètre : Dir - type QDir& - Répertoire ou se trouve les images à ajouter.


Valeur de retour : Booléen indiquant le succès ou l'echec de la fonction.



bool TImageList::Append(const QPixmap& Pixmap)

Description : Ajoute une image en fin de liste passée sous la forme d'un objet QPixmap.


Paramètre : Pixmap - type QPixmap& - Pixmap à ajouter.


Valeur de retour : Booléen indiquant le succès ou l'echec de la fonction.



bool TImageList::Append(const QString& strFileName)

Description : Ajoute une image lue depuis un fichier image en fin de liste.


Paramètre : strFileName - type QString& - Nom du fichier image.


Valeur de retour : Booléen indiquant le succès ou l'echec de la fonction.



void TImageList::Clear()

Description : Supprime toutes les images de la liste d'images.



void TImageList::Copy(TImageList* pTarget)

Description : Copie toutes les valeurs des propriétés de cet objet aux propriétés de l'objet TImageList passé en paramètre.


Paramètre : pTarget - type TImageList* - Pointeur vers un objet TImageList vers lequel sont copiées les valeurs des propriétés de cet objet



int TImageList::Count()

Description : Retourne le nombre d'images dans la liste.


Valeur de retour : Nombre d'images dans la liste.



void TImageList::Draw(QPainter* pPainter, const QRect& Rect)

Description : Permet de tracer cet objet dans un rectangle dont les coordonnées sont passées en paramètres au moyen du QPainter passé en paramètre et créé par une classe héritant du QPaintDevice.


Cette méthode est essentiellement destinée à une utilisation pour tracer sur un LCD via les classes Classe CLCD7789 et Classe CLCD7789PaintDevice de la librairie cpp2835. Voir la rubrique : LCD 7789 avec Qt


Elle peut toutefois être utilisée pour tracer dans un objet d'une classe héritant de QPaintDevice, comme QImage ou QPixmap pour créer une image de l'objet sauvegardable dans un fichier image.


Sauf cas particuliers, cette méthode ne doit pas être utilisée pour tracer sur le moniteur sur lequel fonctionne l'application qui l'héberge. La mise à jour du tracé dans cette condition est contrôlée par l'application par surcharge de la méthode protégée "QWidget::paintEvent".


Paramètre : pPainter - type QPainter* - Pointeur vers un QPainter attaché au QPaintDevice dans lequel il faut tracer l'objet.

Paramètre : Rect - type const QRect& - Coordonnées du rectangle de tracé dans le QPaintDevice.



QString TImageList::GetImageName(int Position)

Description : Retourne le nom du fichier image de l'image dans la liste à la position passée en paramètre. La chaine retournée sera invalide si la position n'existe pas ou si l'image a été ajoutée à la liste par un objet QPixmap.


Valeur de retour : Nom de fichier de l'image.



QUuid TImageList::GetTWidgetIdentifier()

Description : Retourne un UUID pour cettte classe d'objets.


Valeur de retour : UUID de cette classe d'objets.



QString TImageList::GetTWidgetIdentifierAsString()

Description : Retourne un UUID pour cettte classe d'objets.


Valeur de retour : UUID de cette classe d'objets sous forme de chaine de caractères. La valeur de l'UUID de cette est : bd4f763a-c49d-40be-beef-efac72010a1e



QString TImageList::GetTWidgetName()

Description : Retourne le nom de la classe.


Valeur de retour : Nom de cette classe d'objets sous forme de chaine de caractères. La valeur pour cette class est : TImageList



bool TImageList::InsertAt(const int& Position, const QDir& Dir)

Description : Ajoute toutes les images d'un répertoire à partir de la position passée en paramètre. Le répertoire ne doit contenir que des fichiers images compatibles.


Paramètre : Position - type int& - Position d'insertion.

Paramètre : Dir - type QDir& - Répertoire ou se trouve les images à ajouter.


Valeur de retour : Booléen indiquant le succès ou l'echec de la fonction.



bool TImageList::InsertAt(const int& Position, const QPixmap& Pixmap)

Description : Ajoute une image passée sous la forme d'un objet QPixmap à partir de la position passée en paramètre.


Paramètre : Position - type int& - Position d'insertion.

Paramètre : Pixmap - type QPixmap& - Pixmap à ajouter.


Valeur de retour : Booléen indiquant le succès ou l'echec de la fonction.



bool TImageList::InsertAt(const int& Position, const QString& strFileName)

Description : Ajoute une image lue depuis un fichier image à partir de la position passée en paramètre.


Paramètre : Position - type int& - Position d'insertion.

Paramètre : strFileName - type QString& - Nom du fichier image.


Valeur de retour : Booléen indiquant le succès ou l'echec de la fonction.



bool TImageList::IsEmpty()

Description : Retourne un booléen indiquant si la liste est vide ou non.


Valeur de retour : true si la liste est vide.



bool TImageList::Prepend(const QDir& Dir)

Description : Ajoute toutes les images d'un répertoire en début de liste. Le répertoire ne doit contenir que des fichiers images compatibles.


Paramètre : Dir - type QDir& - Répertoire ou se trouve les images à ajouter.


Valeur de retour : Booléen indiquant le succès ou l'echec de la fonction.



bool TImageList::Prepend(const QPixmap& Pixmap)

Description : Ajoute une image en début de liste passée sous la forme d'un objet QPixmap.


Paramètre : Pixmap - type QPixmap& - Pixmap à ajouter.


Valeur de retour : Booléen indiquant le succès ou l'echec de la fonction.



bool TImageList::Prepend(const QString& strFileName)

Description : Ajoute une image lue depuis un fichier image en début de liste.


Paramètre : strFileName - type QString& - Nom du fichier image.


Valeur de retour : Booléen indiquant le succès ou l'echec de la fonction.



bool TImageList::RemoveAt(int Position)

Description : Supprime de la liste l'image située à la position passée en paramètre.


Paramètre : Position - type int& - Position de suppression.

Valeur de retour : Retourne un booléen indiquant le succès ou l'echec de la fonction.



bool TImageList::RemoveFirst()

Description : Supprime la première image de la liste.


Valeur de retour : true si la liste est vide.



bool TImageList::RemoveLast()

Description : Supprime la dernière image de la liste.


Valeur de retour : true si la liste est vide.



int TImageList::SelectedImage()

Description : Retourne la position dans la liste de l'image en cours d'affichage.


Valeur de retour : Position dans la liste.



bool TImageList::SetAt(int Position)

Description : Affiche l'image située à la position passée en paramètre.


Paramètre : Position - type int& - Position de l'image à afficher.

Valeur de retour : Retourne un booléen indiquant le succès ou l'echec de la fonction.



bool TImageList::SetAtFirst()

Description : Affiche la première image de la liste.


Valeur de retour : Retourne un booléen indiquant le succès ou l'echec de la fonction.



bool TImageList::SetAtLast()

Description : Affiche la dernière image de la liste.


Valeur de retour : Retourne un booléen indiquant le succès ou l'echec de la fonction.



bool TImageList::SetAtNext()

Description : Affiche la prochaine image de la liste. Si l'image en cours est la dernière, l'image suivante affichée sera la première.


Valeur de retour : Retourne un booléen indiquant le succès ou l'echec de la fonction.



bool TImageList::SetAtPrevious()

Description : Affiche la précédente image de la liste. Si l'image en cours est la première, l'image suivante affichée sera la dernière.


Valeur de retour : Retourne un booléen indiquant le succès ou l'echec de la fonction.