TXSLib : Class TFrame

La classe TFrame est un widget affichant un simple cadre. Son intérêt principal est de fournir un cadre à d'autre widgets placés dans un objet de cette classe via les classe de "Layout" de Qt.


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 TFrame utilisée comme support de layout ainsi que le code utilisé pour configurer celui-ci.



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

  // Dialogue de taille fixe
  setFixedSize(150,180);

  // Elément de l'interface opérateur
  m_pVLayout = new QVBoxLayout();
  m_pHLayout = new QHBoxLayout();
  m_pFrame = new TFrame();
  m_pSwitch = new TSwitch();
  m_pLed = new TLed();

  SetupFrame();

  m_pHLayout->addWidget(m_pFrame);
  setLayout(m_pHLayout);

  // Connections signaux <--> slots
  connect(m_pSwitch, SIGNAL(Switched(bool)), this, SLOT(OnSwitch(bool)));
}

Dialog::~Dialog()
{
}

void Dialog::SetupFrame()
{
  m_pFrame->SetCaption("Marche / Arrêt");

  m_pFrame->SetBorderStyle(TXS::WinPanel);

  m_pLed->setFixedHeight(25);
  m_pSwitch->setFixedHeight(75);

  m_pLed->SetBorderStyle(TXS::NoFrame);
  m_pSwitch->SetBorderStyle(TXS::NoFrame);

  m_pFrame->SetCaptionVisible(true);
  m_pLed->SetCaptionVisible(false);
  m_pSwitch->SetCaptionVisible(false);

  m_pSwitch->EnableOnOffText(false);

  m_pVLayout->addWidget(m_pLed);
  m_pVLayout->addWidget(m_pSwitch);

  m_pFrame->setLayout(m_pVLayout);
}

void Dialog::OnSwitch(bool State)
{
  m_pLed->SetValue(State);
}

Relations d'héritage

- Hérite de :
   - TWidget.

Fonctions publiques

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


TFrame::TFrame(QWidget *parent = nullptr)

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


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



void TFrame::Copy(TFrame* pTarget)

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


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



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

Description : Crée et retourne un nouvel objet de la classe TFrame 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 TFrame::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 TFrame::GetTWidgetIdentifier()

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


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



QString TFrame::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 : 7b81401c-209f-4f3e-89cd-ac4cc0feaff1



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