QComboBox Class

Documentation sur les fonctions membres

[explicit] QComboBox::QComboBox(QWidget *parent = nullptr)

Crée une liste déroulante à partir de l'parent fourni, en utilisant le modèle par défaut QStandardItemModel.

[virtual noexcept] QComboBox::~QComboBox()

Supprime la liste déroulante.

[signal] void QComboBox::activated(int index)

Ce signal est émis lorsque l'utilisateur sélectionne un élément dans la liste déroulante. L'index s de l'élément est transmise. Notez que ce signal est émis même lorsque la sélection n'a pas changé. Si vous souhaitez savoir quand la sélection change réellement, utilisez le signal currentIndexChanged() ou currentTextChanged().

void QComboBox::addItem(const QString &text, const QVariant &userData = QVariant())

Ajoute un élément à la liste déroulante avec l'text, et contenant l'userData spécifiée (stockée dans Qt::UserRole). L'élément est ajouté à la fin de la liste des éléments existants.

void QComboBox::addItem(const QIcon &icon, const QString &text, const QVariant &userData = QVariant())

Ajoute un élément à la liste déroulante avec les valeurs « icon » et « text » indiquées, et contenant la valeur « userData » spécifiée (stockée dans « Qt::UserRole »). L'élément est ajouté à la fin de la liste des éléments existants.

void QComboBox::addItems(const QStringList &texts)

Ajoute chacune des chaînes contenues dans l'texts ion fournie à la liste déroulante. Chaque élément est ajouté à la liste des éléments existants, les uns après les autres.

[override virtual protected] void QComboBox::changeEvent(QEvent *e)

Réimplémente : QWidget::changeEvent(QEvent *event).

[slot] void QComboBox::clear()

Efface la liste déroulante en supprimant tous les éléments.

Remarque : si vous avez défini un modèle externe pour la liste déroulante, ce modèle sera tout de même effacé lors de l'appel de cette fonction.

[slot] void QComboBox::clearEditText()

Efface le contenu de la zone de saisie utilisée pour la modification dans la liste déroulante.

QCompleter *QComboBox::completer() const

Renvoie le composant de saisie semi-automatique utilisé pour compléter automatiquement le texte saisi dans la liste déroulante.

Voir également setCompleter() et editable.

[override virtual protected] void QComboBox::contextMenuEvent(QContextMenuEvent *e)

Réimplémente : QWidget::contextMenuEvent(QContextMenuEvent *event).

[signal] void QComboBox::currentIndexChanged(int index)

Ce signal est émis chaque fois que l'currentIndex, dans la liste déroulante, change, que ce soit à la suite d'une interaction de l'utilisateur ou par programmation. L'index de l'élément est transmise, ou la valeur -1 si la liste déroulante se retrouve vide ou si l'currentIndex a été réinitialisée.

[signal] void QComboBox::currentTextChanged(const QString &text)

Ce signal est émis chaque fois que la valeur de ` currentText ` change. La nouvelle valeur est transmise sous la forme ` text`.

[signal] void QComboBox::editTextChanged(const QString &text)

Ce signal est émis lorsque le texte du widget de saisie de la liste déroulante est modifié. Le nouveau texte est spécifié par text.

[override virtual] bool QComboBox::event(QEvent *event)

Réimplémente : QWidget::event(QEvent *event).

int QComboBox::findData(const QVariant &data, int role = Qt::UserRole, Qt::MatchFlags flags = static_cast<Qt::MatchFlags>(Qt::MatchExactly|Qt::MatchCaseSensitive)) const

Renvoie l'index de l'élément contenant l'data donné pour l'role donné ; sinon, renvoie -1.

Les flags spécifient la manière dont la recherche s'effectue parmi les éléments de la liste déroulante.

int QComboBox::findText(const QString &text, Qt::MatchFlags flags = Qt::MatchExactly|Qt::MatchCaseSensitive) const

Renvoie l'index de l'élément contenant l'text donnée ; sinon, renvoie -1.

Les flags spécifient comment les éléments de la liste déroulante sont recherchés.

[override virtual protected] void QComboBox::focusInEvent(QFocusEvent *e)

Réimplémente : QWidget::focusInEvent(QFocusEvent *event).

[override virtual protected] void QComboBox::focusOutEvent(QFocusEvent *e)

Réimplémente : QWidget::focusOutEvent(QFocusEvent *event).

[override virtual protected] void QComboBox::hideEvent(QHideEvent *e)

Réimplémente : QWidget::hideEvent(QHideEvent *event).

[virtual] void QComboBox::hidePopup()

Masque la liste des éléments de la liste déroulante si celle-ci est actuellement visible et réinitialise l'état interne, de sorte que si la fenêtre contextuelle personnalisée a été affichée dans la méthode showPopup() réimplémentée, vous devez également réimplémenter la fonction hidePopup() pour masquer votre fenêtre contextuelle personnalisée et appeler l'implémentation de la classe parente afin de réinitialiser l'état interne chaque fois que votre widget de fenêtre contextuelle personnalisé est masqué.

Voir également showPopup().

[signal] void QComboBox::highlighted(int index)

Ce signal est émis lorsqu'un élément de la liste déroulante de la liste combinée est sélectionné par l'utilisateur. L'index e de cet élément est transmise.

[virtual protected] void QComboBox::initStyleOption(QStyleOptionComboBox *option) const

Initialisez ` option ` avec les valeurs fournies à l'adresse suivante : QComboBox. Cette méthode est utile pour les sous-classes qui ont besoin d'un ` QStyleOptionComboBox`, mais ne souhaitent pas renseigner elles-mêmes toutes les informations.

Voir également QStyleOption::initFrom().

[override virtual protected] void QComboBox::inputMethodEvent(QInputMethodEvent *e)

Réimplémente : QWidget::inputMethodEvent(QInputMethodEvent *event).

[override virtual] QVariant QComboBox::inputMethodQuery(Qt::InputMethodQuery query) const

Réimplémente : ` QWidget::inputMethodQuery` (requête `Qt::InputMethodQuery` de type `const`).

void QComboBox::insertItem(int index, const QString &text, const QVariant &userData = QVariant())

Insère les éléments text et userData (stockés dans le fichier Qt::UserRole) dans la liste déroulante située à l'adresse index.

Si l’index est égal ou supérieur au nombre total d’éléments, le nouvel élément est ajouté à la fin de la liste des éléments existants. Si l’index est égal à zéro ou négatif, le nouvel élément est ajouté au début de la liste des éléments existants.

Voir également insertItems().

void QComboBox::insertItem(int index, const QIcon &icon, const QString &text, const QVariant &userData = QVariant())

Insère les éléments icon, text et userData (stockés dans le fichier Qt::UserRole) dans la liste déroulante située à l'adresse index.

Si l'index est égal ou supérieur au nombre total d'éléments, le nouvel élément est ajouté à la fin de la liste des éléments existants. Si l'index est égal à zéro ou négatif, le nouvel élément est ajouté au début de la liste des éléments existants.

Voir également insertItems().

void QComboBox::insertItems(int index, const QStringList &list)

Insère les chaînes de caractères provenant de l'list dans la liste déroulante sous forme d'éléments distincts, en commençant à l'index spécifiée.

Si l'index est égal ou supérieur au nombre total d'éléments, les nouveaux éléments sont ajoutés à la fin de la liste des éléments existants. Si l'index est égal à zéro ou négatif, les nouveaux éléments sont ajoutés au début de la liste des éléments existants.

Voir aussi insertItem().

void QComboBox::insertSeparator(int index)

Insère un élément séparateur dans la liste déroulante à l'index indiquée.

Si l'index est égal ou supérieur au nombre total d'éléments, le nouvel élément est ajouté à la fin de la liste des éléments existants. Si l'index est égal à zéro ou négatif, le nouvel élément est ajouté au début de la liste des éléments existants.

Voir également insertItem().

QVariant QComboBox::itemData(int index, int role = Qt::UserRole) const

Renvoie les données relatives à l'role spécifié dans l'index indiquée dans la liste déroulante, ou une QVariant non valide s'il n'existe aucune donnée pour ce rôle.

Voir également setItemData().

QAbstractItemDelegate *QComboBox::itemDelegate() const

Renvoie le délégué d'élément utilisé par la vue de liste contextuelle.

Voir aussi setItemDelegate().

QIcon QComboBox::itemIcon(int index) const

Renvoie l'icône correspondant à l'index donné dans la liste déroulante.

Voir aussi setItemIcon().

QString QComboBox::itemText(int index) const

Renvoie le texte correspondant à l'index ion indiquée dans la liste déroulante.

Voir aussi setItemText().

[override virtual protected] void QComboBox::keyPressEvent(QKeyEvent *e)

Réimplémente : QWidget::keyPressEvent(QKeyEvent *event).

[override virtual protected] void QComboBox::keyReleaseEvent(QKeyEvent *e)

Réimplémente : QWidget::keyReleaseEvent(QKeyEvent *event).

QLineEdit *QComboBox::lineEdit() const

Renvoie le champ de saisie utilisé pour modifier les éléments de la liste déroulante, ou la valeur « nullptr » s'il n'y a pas de champ de saisie.

Seules les listes déroulantes modifiables disposent d'un champ de saisie.

Voir aussi setLineEdit().

[override virtual] QSize QComboBox::minimumSizeHint() const

Réimplémente une fonction d'accès pour la propriété : QWidget::minimumSizeHint.

QAbstractItemModel *QComboBox::model() const

Renvoie le modèle utilisé par la liste déroulante.

Voir aussi setModel().

[override virtual protected] void QComboBox::mousePressEvent(QMouseEvent *e)

Réimplémente : QWidget::mousePressEvent(QMouseEvent *event).

[override virtual protected] void QComboBox::mouseReleaseEvent(QMouseEvent *e)

Réimplémente : QWidget::mouseReleaseEvent(QMouseEvent *event).

[override virtual protected] void QComboBox::paintEvent(QPaintEvent *e)

Réimplémente : QWidget::paintEvent(QPaintEvent *event).

void QComboBox::removeItem(int index)

Supprime de la liste déroulante l'élément situé à l'index indiquée. Cette opération mettra à jour l'index actuel si celui-ci est supprimé.

Cette fonction ne fait rien si l'index e est hors de la plage autorisée.

[override virtual protected] void QComboBox::resizeEvent(QResizeEvent *e)

Réimplémente : QWidget::resizeEvent(QResizeEvent *event).

QModelIndex QComboBox::rootModelIndex() const

Renvoie l'index de l'élément racine du modèle pour les éléments de la liste déroulante.

Voir également setRootModelIndex().

void QComboBox::setCompleter(QCompleter *completer)

Définit l'completer à utiliser à la place de l' actuel. Si completer est nullptr, la saisie semi-automatique est désactivée.

Par défaut, pour une liste déroulante modifiable, un « QCompleter » effectuant une complétion en ligne sans distinction de casse est automatiquement créé.

Voir également completer().

[slot] void QComboBox::setEditText(const QString &text)

Définit l'text e dans le champ de saisie de texte de la liste déroulante.

void QComboBox::setItemData(int index, const QVariant &value, int role = Qt::UserRole)

Définit l’ role de données de l’élément situé à l’ index indiquée dans la liste déroulante sur l’ value spécifiée.

Voir aussi itemData().

void QComboBox::setItemDelegate(QAbstractItemDelegate *delegate)

Définit l'élément delegate pour la vue de liste contextuelle. La liste déroulante prend en charge le délégué.

Tout délégué existant sera supprimé, mais pas effacé. ` QComboBox ` ne prend pas possession de ` delegate`.

Voir également ` itemDelegate()`.

void QComboBox::setItemIcon(int index, const QIcon &icon)

Définit la propriété « icon » de l'élément situé à l'index indiquée dans la liste déroulante.

Voir également itemIcon().

void QComboBox::setItemText(int index, const QString &text)

Définit la propriété « text » de l'élément situé à l'index spécifiée dans la liste déroulante.

Voir aussi itemText().

void QComboBox::setLineEdit(QLineEdit *edit)

Définit la zone de saisie « line edit » à utiliser à la place du widget de saisie de ligne actuel.

La liste déroulante prend en charge le champ de saisie.

Voir également ` lineEdit()`.

[virtual] void QComboBox::setModel(QAbstractItemModel *model)

Définit le modèle sur « model ». « model » ne doit pas être « nullptr ». Si vous souhaitez effacer le contenu d'un modèle, appelez la fonction « clear() ».

Voir également model(), clear() et setCompleter().

void QComboBox::setRootModelIndex(const QModelIndex &index)

Définit l'élément de modèle racine index pour les éléments de la liste déroulante.

Voir également rootModelIndex().

void QComboBox::setValidator(const QValidator *validator)

Définit le validateur « validator » à utiliser à la place du validateur actuel.

Voir également validator().

void QComboBox::setView(QAbstractItemView *itemView)

Définit la vue à utiliser dans la fenêtre contextuelle de la liste déroulante sur la vue spécifiée itemView. La liste déroulante prend en charge la vue.

Remarque : si vous souhaitez utiliser les vues prédéfinies (telles que QListWidget, QTableWidget ou QTreeWidget), veillez à appeler la méthode setModel() sur la liste déroulante avec le modèle de widgets prédéfini avant d’appeler cette fonction.

Voir également view().

[override virtual protected] void QComboBox::showEvent(QShowEvent *e)

Réimplémente : QWidget::showEvent(QShowEvent *event).

[virtual] void QComboBox::showPopup()

Affiche la liste des éléments de la liste déroulante. Si la liste est vide, aucun élément ne s'affichera.

Si vous réimplémentez cette fonction pour afficher une fenêtre contextuelle personnalisée, veillez à appeler hidePopup() pour réinitialiser l'état interne.

Voir également hidePopup().

[override virtual] QSize QComboBox::sizeHint() const

Réimplémente une fonction d'accès pour la propriété : QWidget::sizeHint.

Cette implémentation met en cache l'indication de taille afin d'éviter tout redimensionnement lorsque le contenu change de manière dynamique. Pour invalider la valeur mise en cache, modifiez la propriété sizeAdjustPolicy.

[signal] void QComboBox::textActivated(const QString &text)

Ce signal est émis lorsque l'utilisateur sélectionne un élément dans la liste déroulante. L'text s de cet élément est transmise. Notez que ce signal est émis même si le choix n'a pas changé. Si vous souhaitez savoir à quel moment le choix change réellement, utilisez le signal currentIndexChanged() ou currentTextChanged().

[signal] void QComboBox::textHighlighted(const QString &text)

Ce signal est émis lorsqu'un élément de la liste déroulante d'une liste combinée est sélectionné par l'utilisateur. L'text e de cet élément est transmise.

const QValidator *QComboBox::validator() const

Renvoie le validateur utilisé pour valider la saisie de texte dans la liste déroulante.

Voir également setValidator() et editable.

QAbstractItemView *QComboBox::view() const

Renvoie la vue de liste utilisée pour la fenêtre contextuelle de la liste déroulante.

Voir aussi setView().

[override virtual protected] void QComboBox::wheelEvent(QWheelEvent *e)

Réimplémente : QWidget::wheelEvent(QWheelEvent *event).