1. Description du widget QComboBox PyQt5
- QComboBox est l'un des widgets les plus polyvalents de PyQt5: pour créer des menus déroulants interactifs. Il offre aux développeurs la possibilité de créer des interfaces utilisateur riches et intuitives, en permettant aux utilisateurs de sélectionner une option parmi une liste d'éléments prédéfinis. Voici une description détaillée de QComboBox :
- Le widget QComboBox est un champ de liste déroulante: qui peut contenir une liste d'éléments. Chaque élément peut être représenté par du texte simple ou par des objets plus complexes, comme des icônes ou des images. La liste d'éléments peut être définie statiquement dans le code ou générée dynamiquement à partir d'une source de données.
- Conclusion - QComboBox est un widget flexible et puissant: qui facilite la sélection d'éléments parmi une liste. Il est largement utilisé dans les applications de bureau, les interfaces graphiques et les applications interactives pour fournir aux utilisateurs une manière conviviale de choisir des options et d'interagir avec l'application de manière intuitive.
2. Caractéristiques principales de QComboBox
- Sélection d'élément unique : QComboBox permet aux utilisateurs de sélectionner un seul élément parmi la liste. Lorsque l'utilisateur ouvre le menu déroulant, il peut voir la liste complète des éléments et en choisir un.
- Gestion des signaux et des slots : QComboBox émet des signaux lorsqu'un élément est sélectionné ou lorsque la liste déroulante est ouverte ou fermée. Cela permet de réagir aux changements de sélection et de mettre à jour l'interface utilisateur en conséquence.
- Personnalisation : Les éléments de la liste peuvent être personnalisés en utilisant du texte enrichi, des icônes ou des images pour rendre la liste plus expressive et attrayante.
- Gestion de la liste d'éléments : Il est possible d'ajouter et de supprimer dynamiquement des éléments dans la liste. Vous pouvez également trier les éléments selon un ordre spécifique.
- Modèles de données : QComboBox prend en charge l'utilisation de modèles de données, tels que QStandardItemModel, pour représenter des listes complexes avec des structures hiérarchiques.
- Comportement adaptatif : En fonction de la taille de la liste déroulante et de l'espace disponible, QComboBox peut ajuster automatiquement son apparence pour afficher les éléments d'une manière adaptée à l'interface utilisateur.
- Autocomplétion : QComboBox offre la possibilité d'activer l'autocomplétion, ce qui facilite la saisie d'un élément en filtrant automatiquement les options de la liste à mesure que l'utilisateur tape du texte.
- Menus personnalisés : Il est possible de créer des menus personnalisés pour les éléments de la liste, offrant ainsi des fonctionnalités supplémentaires ou des actions spécifiques à chaque élément.
3. Syntaxe & usage du widget QComboBox
La syntaxe du widget QComboBox est relativement simple, mais elle offre de nombreuses fonctionnalités puissantes. Voici la syntaxe générale et les principaux aspects de son utilisation :
Syntaxe de base
Afin de pouvoir créer un widget QComboBox, il faut:
- Importer la classe QComboBox
- Faire une instanciation la classe QComboBox
- Ajouter les élément à l'aide de la méthode addItem
Exemple
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 |
from PyQt5.QtWidgets import QApplication, QMainWindow, QComboBox app = QApplication([]) # Crée une instance de l'application PyQt5 window = QMainWindow() # Crée une fenêtre principale (MainWindow) window.setGeometry(100, 100, 300, 200) # Création d'un objet QComboBox combo_box = QComboBox(window) combo_box.setGeometry(75, 50, 150, 20) # Ajout d'éléments à la liste déroulante (texte simple) combo_box.addItem("Élément 1") combo_box.addItem("Élément 2") combo_box.addItem("Élément 3") # Ouverture de la fenêtre principale window.show() # Lancement de l'application app.exec_() |
Remarque
Les éléments de l'objet ComboBox: Élément 1, Élément 2, Élément 3 peuvent être ajoutés simultanément en une seule fois à l'aide d'une liste en utilisant la méthode addItems() à la place de addItem().
Exemple
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 |
import sys from PyQt5.QtWidgets import QApplication, QMainWindow, QComboBox, QVBoxLayout, QWidget app = QApplication(sys.argv) window = QMainWindow() main_widget = QWidget(window) layout = QVBoxLayout(main_widget) combo_box = QComboBox(window) elements = ['Option 1', 'Option 2', 'Option 3', 'Option 4', 'Option 5'] combo_box.addItems(elements) layout.addWidget(combo_box) window.setCentralWidget(main_widget) window.setWindowTitle('Exemple de QComboBox') window.setGeometry(200, 200, 300, 150) window.show() sys.exit(app.exec_()) |
Exemple (QComboBox selon l'approche objet)
|
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 |
# Importation des classes nécessaires depuis PyQt5 from PyQt5.QtWidgets import QApplication, QWidget, QComboBox import sys # Définition de la classe principale de l'application class QComboExample(QWidget): # Méthode d'initialisation de la classe def __init__(self): # Appel du constructeur de la classe parente (QWidget) super().__init__() # Initialisation de l'interface utilisateur self.initUI() # Méthode pour initialiser l'interface utilisateur def initUI(self): # Définition du titre et des dimensions de la fenêtre principale self.setWindowTitle("Exemple de liste QComboBox PyQt5") self.setGeometry(100, 100, 300, 150) # Création d'une liste déroulante (QComboBox) self.qcombo = QComboBox(self) self.qcombo.addItems(['element1', 'element2', 'element3']) self.qcombo.setGeometry(20, 50, 200, 30) # Point d'entrée du programme if __name__ == '__main__': # Création de l'application PyQt app = QApplication([]) # Création de l'instance de la classe principale mycombobox = QComboExample() # Affichage de la fenêtre principale mycombobox.show() # Exécution de la boucle d'événements de l'application sys.exit(app.exec_()) |
4. Principaux aspects d'usage d'un objet QComboBox
- Création de l'objet QComboBox : Pour utiliser QComboBox, il faut d'abord créer une instance de ce widget. Vous pouvez le faire en spécifiant le widget parent (la fenêtre principale) lors de la création.
- Ajout d'éléments : Vous pouvez ajouter des éléments à la liste déroulante en utilisant la méthode addItem() sur l'objet QComboBox. Vous pouvez également ajouter des éléments avec des icônes ou des images en utilisant la méthode addItem() avec un objet QIcon.
- Accès aux éléments sélectionnés : Pour accéder à l'élément sélectionné dans QComboBox, vous pouvez utiliser la méthode currentText() pour obtenir le texte de l'élément sélectionné ou currentIndex() pour obtenir l'index de l'élément sélectionné.
- Signaux et slots : QComboBox émet plusieurs signaux tels que currentIndexChanged, currentTextChanged, activated, etc. Vous pouvez les connecter à des fonctions (slots) pour réagir aux changements de sélection ou d'autres interactions de l'utilisateur avec le widget.
- Modèles de données : Vous pouvez également utiliser des modèles de données tels que QStandardItemModel pour gérer des listes plus complexes avec des structures hiérarchiques.
- Gestion des événements : Vous pouvez également gérer certains événements, comme l'ouverture ou la fermeture du menu déroulant, en utilisant les méthodes showPopup() et hidePopup().
5. Exemple d'utilisation avancée avec signaux et slots
On peut aussi associer des actions à un objet QComboBox à l'aide des signaux et slots:
|
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, QMainWindow, QComboBox, QVBoxLayout, QWidget def on_combobox_changed(index): print(f"Index sélectionné : {index}, Élément sélectionné : {combo_box.currentText()}") app = QApplication(sys.argv) window = QMainWindow() main_widget = QWidget(window) layout = QVBoxLayout(main_widget) combo_box = QComboBox(window) elements = ['Option 1', 'Option 2', 'Option 3', 'Option 4', 'Option 5'] combo_box.addItems(elements) # Connexion du signal à la fonction slot combo_box.currentIndexChanged.connect(on_combobox_changed) layout.addWidget(combo_box) window.setCentralWidget(main_widget) window.setWindowTitle('Exemple de QComboBox') window.setGeometry(200, 200, 300, 150) window.show() sys.exit(app.exec_()) |
Dans cet exemple:
- Nous créons un objet QComboBox.
- Nous ajoutons ensuite une liste d'éléments ('Option 1' à 'Option 5') à ce QComboBox en utilisant la méthode addItems().
- Lorsque on exécute cet exemple, on voit un menu déroulant avec les éléments de la liste.
- Lorsqu'on sélectionne un élément dans le QComboBox, on peut également capturer cet événement en connectant le signal currentIndexChanged à une fonction.
- Cela nous permettra de réagir aux changements de sélection de l'utilisateur.
6. Liste des méthodes et attributs associés à un objet QComboBox
Un objet QComboBox est doté de nombreuses méthodes et attributs qui permettent d'améliorer son usage. Voici une liste des méthodes et des attributs les plus couramment utilisés associés au widget QComboBox dans PyQt5 :
6.1 Méthodes
- addItem(text: str): Ajoute un nouvel élément à la liste déroulante, représenté par le texte spécifié.
- addItems(items: Iterable[str]): Ajoute plusieurs éléments à la liste déroulante à partir d'un itérable de chaînes de caractères.
- insertItem(index: int, text: str): Insère un nouvel élément à la position donnée par l'index avec le texte spécifié.
- insertItems(index: int, items: Iterable[str]): Insère plusieurs éléments à partir d'un itérable de chaînes de caractères, à la position donnée par l'index.
- removeItem(index: int): Supprime l'élément à la position donnée par l'index.
- clear(): Supprime tous les éléments de la liste déroulante.
- currentIndex() -> int: Renvoie l'index de l'élément actuellement sélectionné dans la liste déroulante.
- currentText() -> str: Renvoie le texte de l'élément actuellement sélectionné dans la liste déroulante.
- count() -> int: Renvoie le nombre total d'éléments dans la liste déroulante.
- setEditText(text: str): Définit le texte du champ de saisie du QComboBox (pour les QComboBox avec saisie possible).
- setCurrentIndex(index: int): Sélectionne l'élément de la liste déroulante à la position donnée par l'index.
- setCurrentText(text: str): Sélectionne l'élément de la liste déroulante correspondant au texte spécifié.
- showPopup(): Affiche le menu déroulant avec les éléments de la liste.
- hidePopup(): Cache le menu déroulant.
- clearEditText(): Efface le texte du champ de saisie (pour les QComboBox avec saisie possible).
6.2 Attributs
- count (lecture seule) : Renvoie le nombre total d'éléments dans la liste déroulante.
- currentText (lecture seule) : Renvoie le texte de l'élément actuellement sélectionné dans la liste déroulante.
- currentIndex (lecture seule) : Renvoie l'index de l'élément actuellement sélectionné dans la liste déroulante.
- currentData (lecture seule) : Renvoie les données associées à l'élément actuellement sélectionné dans la liste déroulante (si définies).
- editable : Détermine si le QComboBox permet la saisie de texte (True) ou si seuls les éléments de la liste peuvent être sélectionnés (False).
- sizeAdjustPolicy: Définit le comportement d'ajustement de la taille du QComboBox en fonction de son contenu.
- maxCount: Définit le nombre maximum d'éléments que le QComboBox peut afficher (0 pour aucun maximum).
- minimumContentsLength: Définit la longueur minimum du champ de saisie en mode déroulant (pour les QComboBox avec saisie possible).
- model : Renvoie l'objet modèle de données utilisé par le QComboBox.
- itemDelegate : Renvoie l'objet delegate utilisé pour personnaliser l'affichage des éléments.
- validator : Renvoie l'objet validator utilisé pour valider le texte saisi dans le champ de saisie.
- currentIndexChanged : Signal émis lorsqu'un nouvel élément est sélectionné dans la liste déroulante.
- currentTextChanged : Signal émis lorsqu'un nouvel élément texte est sélectionné dans la liste déroulante.
Remarque
Ceci n'est qu'une sélection des méthodes et attributs disponibles dans le widget QComboBox. PyQt5 offre de nombreuses autres fonctionnalités pour personnaliser le comportement et l'apparence du QComboBox dans vos applications PyQt5.
Younes Derfoufi
CRMEF OUJDA
