QComboBox Class

Documentation sur les fonctions membres

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

Construit une combobox avec la donnée parent, en utilisant le modèle par défaut QStandardItemModel.

[virtual noexcept] QComboBox::~QComboBox()

Détruit le combobox.

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

Ce signal est envoyé lorsque l'utilisateur choisit un élément dans le combobox. L'adresse index de l'élément est transmise. Notez que ce signal est envoyé même si le choix n'est pas modifié. Si vous avez besoin de savoir quand le choix change réellement, utilisez le signal currentIndexChanged() ou currentTextChanged().

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

Ajoute un élément à la boîte combobox avec l'adresse text donnée et contenant l'adresse userData spécifiée (stockée dans l'adresse Qt::UserRole). L'élément est ajouté à la liste des éléments existants.

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

Ajoute un élément à la boîte combobox avec les adresses icon et text données, et contenant l'adresse userData spécifiée (stockée dans l'adresse Qt::UserRole). L'élément est ajouté à la liste des éléments existants.

void QComboBox::addItems(const QStringList &texts)

Ajoute chacune des chaînes de caractères de l'adresse texts à la boîte combobox. Chaque élément est ajouté à la liste des éléments existants à tour de rôle.

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

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

[slot] void QComboBox::clear()

Efface le combobox, en supprimant tous les éléments.

Remarque : si vous avez défini un modèle externe pour le combobox, ce modèle sera toujours effacé lors de l'appel de cette fonction.

[slot] void QComboBox::clearEditText()

Efface le contenu de l'édition de ligne utilisée pour l'édition dans la boîte combinée.

QCompleter *QComboBox::completer() const

Renvoie le compléteur utilisé pour compléter automatiquement le texte saisi dans la boîte combobox.

Voir aussi 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 envoyé chaque fois que l'adresse currentIndex de la boîte combobox change, que ce soit par l'interaction de l'utilisateur ou par programmation. L'adresse index de l'élément est transmise ou -1 si la boîte combobox devient vide ou si l'adresse currentIndex a été réinitialisée.

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

Ce signal est émis lorsque currentText est modifié. La nouvelle valeur est transmise en tant que text.

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

Ce signal est émis lorsque le texte du widget d'édition de ligne du combobox 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'adresse data donnée pour l'adresse role donnée ; sinon, renvoie -1.

Les flags spécifient comment les éléments de la boîte combobox sont recherchés.

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

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

Les flags spécifient comment les éléments du combobox 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()

Cache la liste des éléments du combobox s'il est actuellement visible et réinitialise l'état interne, de sorte que si la fenêtre contextuelle personnalisée a été affichée à l'intérieur de la fonction réimplémentée showPopup(), vous devez également réimplémenter la fonction hidePopup() pour cacher votre fenêtre contextuelle personnalisée et appeler l'implémentation de la classe de base pour réinitialiser l'état interne à chaque fois que votre widget de fenêtre contextuelle personnalisée est caché.

Voir également showPopup().

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

Ce signal est envoyé lorsqu'un élément de la liste déroulante du combobox est mis en évidence par l'utilisateur. L'adresse index de l'élément est transmise.

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

Initialiser option avec les valeurs de QComboBox. Cette méthode est utile pour les sous-classes qui ont besoin d'un QStyleOptionComboBox, mais qui ne veulent pas remplir toutes les informations elles-mêmes.

Voir aussi 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(Qt::InputMethodQuery query) const.

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

Insère les éléments text et userData (stockés dans Qt::UserRole) dans le combobox à l'adresse index.

Si l'indice est égal ou supérieur au nombre total d'éléments, le nouvel élément est ajouté à la liste des éléments existants. Si l'indice est nul ou négatif, le nouvel élément est ajouté à 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 Qt::UserRole) dans le combobox à l'adresse index.

Si l'indice est égal ou supérieur au nombre total d'éléments, le nouvel élément est ajouté à la liste des éléments existants. Si l'index est nul ou négatif, le nouvel élément est ajouté à 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 du site list dans la boîte combobox en tant qu'éléments distincts, en commençant par le site index spécifié.

Si l'indice est égal ou supérieur au nombre total d'éléments, les nouveaux éléments sont ajoutés à la liste des éléments existants. Si l'indice est nul ou négatif, les nouveaux éléments sont ajoutés à la liste des éléments existants.

Voir également insertItem().

void QComboBox::insertSeparator(int index)

Insère un élément séparateur dans le combobox à l'adresse index.

Si l'indice est égal ou supérieur au nombre total d'éléments, le nouvel élément est ajouté à la liste des éléments existants. Si l'index est nul ou négatif, le nouvel élément est ajouté à 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'adresse role dans l'adresse index dans le combobox, ou une adresse QVariant invalide s'il n'y a pas de données pour ce rôle.

Voir aussi setItemData().

QAbstractItemDelegate *QComboBox::itemDelegate() const

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

Voir également setItemDelegate().

QIcon QComboBox::itemIcon(int index) const

Renvoie l'icône correspondant à l'adresse index dans le combobox.

Voir aussi setItemIcon().

QString QComboBox::itemText(int index) const

Renvoie le texte de l'adresse index dans la boîte combobox.

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 l'édition de ligne utilisée pour éditer les éléments de la boîte combinée, ou nullptr s'il n'y a pas d'édition de ligne.

Seules les combo-boxes éditables ont une ligne d'édition.

Voir aussi setLineEdit().

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

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

QAbstractItemModel *QComboBox::model() const

Renvoie le modèle utilisé par la boîte combobox.

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 boîte combobox l'élément situé à l'adresse index. L'index actuel sera mis à jour si l'index est supprimé.

Cette fonction ne fait rien si index est hors de portée.

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

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

QModelIndex QComboBox::rootModelIndex() const

Renvoie l'indice de l'élément du modèle racine pour les éléments de la boîte combinée.

Voir également setRootModelIndex().

void QComboBox::setCompleter(QCompleter *completer)

Définit le completer à utiliser à la place du compléteur actuel. Si completer est nullptr, l'auto-complétion est désactivée.

Par défaut, pour une liste déroulante éditable, un QCompleter qui effectue une complétion en ligne insensible à la casse est automatiquement créé.

Voir aussi completer().

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

Définit l'adresse text dans l'édition de texte de la boîte combobox.

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

Définit les données role pour l'élément sur index donné dans le combobox à value spécifié.

Voir aussi itemData().

void QComboBox::setItemDelegate(QAbstractItemDelegate *delegate)

Définit l'élément delegate pour la liste déroulante. Le combobox devient propriétaire du délégué.

Tout délégué existant sera supprimé, mais pas effacé. QComboBox n'est pas propriétaire de delegate.

Voir également itemDelegate().

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

Définit l'adresse icon pour l'élément sur l'adresse index donnée dans le combobox.

Voir aussi itemIcon().

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

Définit l'adresse text pour l'élément sur l'adresse index donnée dans le combobox.

Voir aussi itemText().

void QComboBox::setLineEdit(QLineEdit *edit)

Définit la ligne edit à utiliser à la place du widget d'édition de ligne actuel.

La boîte combo devient propriétaire de l'édition de ligne.

Voir aussi lineEdit().

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

Définit le modèle comme étant model. model ne doit pas être nullptr. Si vous souhaitez effacer le contenu d'un modèle, appelez clear().

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

void QComboBox::setRootModelIndex(const QModelIndex &index)

Définit l'élément du modèle racine index pour les éléments de la boîte combinée.

Voir également rootModelIndex().

void QComboBox::setValidator(const QValidator *validator)

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

Voir aussi validator().

void QComboBox::setView(QAbstractItemView *itemView)

Définit la vue à utiliser dans la fenêtre contextuelle du combobox à l'adresse itemView. Le combobox est propriétaire de la vue.

Note : Si vous voulez utiliser les vues de commodité (comme QListWidget, QTableWidget ou QTreeWidget), assurez-vous d'appeler setModel() sur la combobox avec le modèle de widgets de commodité avant d'appeler cette fonction.

Voir aussi 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 du combobox. Si la liste est vide, aucun élément ne sera affiché.

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

Voir aussi hidePopup().

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

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

Cette implémentation met en cache l'indice de taille pour éviter le redimensionnement lorsque le contenu change dynamiquement. Pour invalider la valeur mise en cache, il convient de modifier l'adresse sizeAdjustPolicy.

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

Ce signal est envoyé lorsque l'utilisateur choisit un élément dans le combobox. L'adresse text de l'élément est transmise. Notez que ce signal est envoyé même si le choix n'est pas modifié. Si vous avez besoin de savoir quand le choix change réellement, utilisez le signal currentIndexChanged() ou currentTextChanged().

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

Ce signal est envoyé lorsqu'un élément de la liste déroulante du combobox est mis en évidence par l'utilisateur. L'adresse text de l'élément est transmise.

const QValidator *QComboBox::validator() const

Renvoie le validateur utilisé pour contraindre la saisie de texte dans la boîte combobox.

Voir aussi setValidator() et editable.

QAbstractItemView *QComboBox::view() const

Renvoie la vue de la liste utilisée pour la fenêtre contextuelle du combobox.

Voir aussi setView().

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

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