TXSLib : Class TLabel

La classe TLabel est un widget permettant d'afficher un texte.


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 TLabel utilisée pour donner un titre à un cadre ainsi que le code utilisé pour le configurer.



m_pLabel->setFixedHeight(30);
m_pLabel->SetMargins(5);
m_pLabel->SetText("MARCHE / ARRET");
m_pLabel->SetBorderStyle(TXS::NoFrame);
m_pLabel->SetForegroundColor(QColor(255,255,255));
m_pLabel->SetBackgroundIsTransparent(false);
m_pLabel->SetBackgroundColor(QColor(255,0,0));
QFont fnt = m_pLabel->GetFont();
fnt.setBold(true);
m_pLabel->SetFont(fnt);

Relations d'héritage

- Hérite de :
   - TWidget.

Fonctions publiques

TLabel(QWidget *parent = nullptr)
voidvoid Copy(TLabel* pTarget)
TLabel* CreateCopy(QWidget *parent = nullptr)
voidbool Draw(QPainter* pPainter, const QRect& Rect)
QUuidGetTWidgetIdentifier()
QStringGetTWidgetIdentifierAsString()
QStringGetTWidgetName()

Propriétés

Propriétés Type Ecriture Lecture
Font QFont SetFont GetFont
FontSizeAuto bool SetFontSizeIsAuto IsFontSizeAuto
ForegroundColor QColor SetForegroundColor GetForegroundColor
HrzAlignment TXS::HrzAlignment SetHrzAlignment GetHrzAlignment
Text QString SetText GetText
VrtAlignment TXS::VrtAlignment SetVrtAlignment GetVrtAlignment


TLabel::TLabel(QWidget *parent = nullptr)

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


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



void TLabel::Copy(TLabel* pTarget)

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


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



TLabel* TLabel::CreateCopy(QWidget *parent = nullptr)

Description : Crée et retourne un nouvel objet de la classe TLabel après avoir initialisé toutes ses propriétés aux valeurs de celles de l'objet utilisé pour créer le nouvel objet.


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


Valeur de retour : Pointeur vers le nouvel objet créé.



void TLabel::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.



QUuid TLabel::GetTWidgetIdentifier()

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


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



QString TLabel::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 : bfad8738-644e-4690-98bf-f6688b614469



QString TLabel::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 : TLabel



Font

Description : Cette propriété définie la police de caractères du texte.


Type : QFont

Valeur par défaut : Police par défaut de l'application

Ecriture : SetFont(const QFont& Font)

Lecture : QFont GetFont()



FontSizeAuto

Description : Cette propriété définie si la taille du texte affiché est déterminée automatiquement par le widget en fonction de sa taille à l'écran.


Type : bool

Valeur par défaut : true

Ecriture : SetFontSizeAuto(const bool& Tf)

Lecture : bool IsFontSizeAuto()



ForegroundColor

Description : Cette propriété définie la couleur du texte.


Type : QColor

Valeur par défaut : Couleur de la palette courante de l'application avec le rôle "QPalette::Dark" et la groupe "QPalette::Active". (Voir la classe QPalette de Qt)

Ecriture : void SetForegroundColor(const QColor& Color)

Lecture : QColor GetForegroundColor()



HrzAlignment

Description : Cette propriété définie l'alignement horizontal du texte dans le widget.


Type : TXS::HrzAlignment

Valeur par défaut : TXS::AlignCenter

Ecriture : void SetHrzAlignment(const TXS::HrzAlignment& Align)

Lecture : TXS::HrzAlignment GetHrzAlignment()



VrtAlignment

Description : Cette propriété définie l'alignement vertical du texte dans le widget.


Type : TXS::VrtAlignment

Valeur par défaut : TXS::AlignMiddle

Ecriture : void SetVrtAlignment(const TXS::VrtAlignment& Align)

Lecture : TXS::VrtAlignment SetVrtAlignment()