1. Description du widget QFrame
Un QFrame est un widget d'interface utilisateur dans PyQt5 qui fournit un conteneur rectangulaire pouvant être utilisé pour organiser et afficher d'autres widgets. Il est principalement utilisé pour diviser l'interface utilisateur en sections logiques ou pour encadrer un groupe de widgets connexes.
2. Caractéristiques d'un QFrame dans PyQt5
- Conteneur rectangulaire : Le QFrame est un rectangle visible sur l'écran qui peut être utilisé pour afficher d'autres widgets, tels que des boutons, des zones de texte, des images, etc.
- Style personnalisé : Vous pouvez appliquer un style personnalisé au QFrame en utilisant les feuilles de style (style sheets) de Qt. Cela vous permet de changer l'apparence du QFrame, y compris les couleurs, les bordures et autres propriétés visuelles.
- Propriétés géométriques : Vous pouvez définir la position, la taille et la géométrie du QFrame à l'intérieur de la fenêtre principale ou d'autres conteneurs.
- Contenu : Le QFrame lui-même n'affiche pas de contenu à moins que vous ne lui ajoutiez d'autres widgets en tant qu'enfants. Vous pouvez ajouter des widgets à l'intérieur du QFrame pour afficher du texte, des images ou tout autre élément interactif.
- Grille de disposition : Vous pouvez utiliser les gestionnaires de mise en page (layout managers) de PyQt5 pour organiser les widgets à l'intérieur du QFrame de manière automatique et adaptative en fonction de la taille de la fenêtre ou des changements de contenu.
- Interaction avec les événements : Comme tout widget dans PyQt5, le QFrame peut interagir avec les événements tels que les clics de souris, les pressions de touche, etc. Vous pouvez implémenter des gestionnaires d'événements pour réagir aux interactions de l'utilisateur.
- Utilisations courantes : Le QFrame est souvent utilisé pour encadrer un groupe de widgets connexes, créer des séparations entre différentes parties de l'interface utilisateur, ou pour afficher des éléments décoratifs ou des graphiques.
3. Syntaxe et usage d'un QFrame PyQt5
3.1 Syntaxe d'un QFrame
Afin de pouvoir créer et utiliser un QFrame, il faut:
- importer la classe QFrame:
|
1 |
from PyQt5.QtWidgets import QFrame |
- Faire une instanciation sur la classe QFrame:
|
1 |
frame = QFrame(parent_object) |
- On pourra aussi ajouter un style:
|
1 |
frame.setStyleSheet("style applied to the frame object") |
3.2 Exemples d'usage
Voici un exemple d'utilisation d'un QFrame simple :
Exemple1
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 |
import sys from PyQt5.QtWidgets import QApplication, QWidget, QLabel, QFrame class FrameExample(QWidget): def __init__(self): super().__init__() # main window title self.setWindowTitle("Example Of QFrame PyQt5") # define a position & dimension of the main window self.setGeometry(100, 100, 500, 300) self.init_ui() def init_ui(self): # create a QFrame self.frame = QFrame(self) # define a background color self.frame.setStyleSheet("background-color: green; border: 5px solid #0000FF;") self.frame.setGeometry(50, 50, 300, 150) if __name__ == '__main__': app = QApplication([]) winFrame = FrameExample() winFrame.show() sys.exit(app.exec_()) |
Exemple 2 (encadrer un groupe de widgets)
En générale, un QFrame est utiliser pour organiser l'interface utilisateur. Ainsi pour organiser une interface robuste et complexe on pourra créer plusieurs frames réparties selon un certain layout (QVBoxLayout, QGridLayout...) et chaque frame contient un ensemble de widgets: buttons, labels...
Voici un exemple d'utilisation d'un QFrame pour encadrer un groupe de widgets :
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 |
import sys from PyQt5.QtWidgets import QApplication, QFrame, QLabel, QVBoxLayout, QWidget class MyWindow(QWidget): def __init__(self): super().__init__() self.setGeometry(100, 100, 400, 200) self.setWindowTitle('QFrame Example') self.initUI() def initUI(self): frame1 = QFrame(self) frame1.setStyleSheet("background-color: blue; border: 2px solid #000000;") frame2 = QFrame(self) frame2.setStyleSheet("background-color: green; border: 2px solid #000000;") layout = QVBoxLayout() layout.addWidget(frame1) layout.addWidget(frame2) label1 = QLabel("Label 1", frame1) label1.setStyleSheet("font-size: 22px; color:white;") label2 = QLabel("Label 2", frame2) label2.setStyleSheet("font-size: 22px; color:white;") self.setLayout(layout) if __name__ == '__main__': app = QApplication(sys.argv) window = MyWindow() window.show() sys.exit(app.exec_()) |
4. Méthodes et attributs associés à un objet QFrame
Nous allons citer ici une liste non exhaustive, mais une liste des méthodes et attributs les plus couramment utilisés avec un objet QFrame dans PyQt5. Vous pouvez consulter la documentation officielle de PyQt5 pour obtenir une liste complète de toutes les méthodes et attributs disponibles pour la classe QFrame.
Voici une liste des méthodes et des attributs couramment utilisés associés à un objet QFrame dans PyQt5 :
4.1 Les méthodes associés à un objet QFrame
- setFrameShape(shape: int): Définit la forme du cadre. Les valeurs possibles pour shape sont QFrame.NoFrame, QFrame.Box, QFrame.Panel, QFrame.WinPanel, QFrame.HLine et QFrame.VLine.
- setFrameShadow(shadow: int): Définit l'ombre du cadre. Les valeurs possibles pour shadow sont QFrame.Plain, QFrame.Raised et QFrame.Sunken.
- setLineWidth(width: int): Définit l'épaisseur de la ligne du cadre.
- setMidLineWidth(width: int): Définit l'épaisseur de la ligne médiane du cadre.
- setStyleSheet(styleSheet: str): Applique une feuille de style (style sheet) personnalisée pour personnaliser l'apparence du cadre.
- setContentsMargins(left: int, top: int, right: int, bottom: int): Définit les marges internes du cadre pour ajuster l'emplacement des widgets enfants.
- setFrameRect(rect: QRect): Définit le rectangle qui spécifie la taille et la position du cadre.
- frameRect() -> QRect: Renvoie le rectangle du cadre.
- frameShape() -> int: Renvoie la forme du cadre.
- frameShadow() -> int: Renvoie l'ombre du cadre.
4.2 Les attributs associés à un objet QFrame
- NoFrame: Constante qui représente l'absence de cadre (0).
- Box: Constante qui représente un cadre rectangulaire (1).
- Panel: Constante qui représente un cadre de panneau (2).
- WinPanel: Constante qui représente un cadre de panneau Windows (3).
- HLine: Constante qui représente une ligne horizontale (4).
- VLine: Constante qui représente une ligne verticale (5).
- Plain: Constante qui représente une ombre simple (16).
- Raised: Constante qui représente une ombre en relief (32).
- Sunken: Constante qui représente une ombre en creux (48).
Younes Derfoufi
CRMEF OUJDA
