Sur cette page

QStyleOptionComboBox Class

La classe QStyleOptionComboBox sert à définir les paramètres de dessin d'une liste déroulante. En savoir plus...

En-tête : #include <QStyleOptionComboBox>
CMake : find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake : QT += widgets
Hérite de : QStyleOptionComplex

Types publics

enum StyleOptionType { Type }
enum StyleOptionVersion { Version }

Fonctions publiques

QStyleOptionComboBox()
QStyleOptionComboBox(const QStyleOptionComboBox &other)
QStyleOptionComboBox &operator=(const QStyleOptionComboBox &)

Variables publiques

QIcon currentIcon
QString currentText
bool editable
bool frame
QSize iconSize
QRect popupRect
Qt::Alignment textAlignment

Description détaillée

QStyleOptionButton contient toutes les informations dont les fonctions QStyle ont besoin pour tracer QComboBox.

Pour des raisons de performances, il y a peu de fonctions membres et l’accès aux variables membres est direct (c’est-à-dire à l’aide des opérateurs . ou -> ). Cela rend les structures simples à utiliser et souligne le fait qu’il s’agit simplement de paramètres utilisés par les fonctions de style.

Voir également QStyleOption, QStyleOptionComplex et QComboBox.

Documentation sur les types de membres

enum QStyleOptionComboBox::StyleOptionType

Cette énumération sert à stocker des informations sur le type de l'option de style et est définie pour chaque sous-classe de ` QStyleOption `.

ConstanteValeurDescription
QStyleOptionComboBox::TypeSO_ComboBoxLe type de l'option de style fournie (SO_ComboBox pour cette classe).

Ce type est utilisé en interne par ` QStyleOption`, ses sous-classes et la méthode ` qstyleoption_cast()` pour déterminer le type de l'option de style. En général, vous n'avez pas à vous en soucier, sauf si vous souhaitez créer votre propre sous-classe de ` QStyleOption ` et vos propres styles.

Voir également StyleOptionVersion.

enum QStyleOptionComboBox::StyleOptionVersion

Cette énumération sert à contenir des informations sur la version de l'option de style et est définie pour chaque sous-classe de ` QStyleOption `.

ConstanteValeurDescription
QStyleOptionComboBox::Version12

La version est utilisée par les sous-classes de ` QStyleOption ` pour implémenter des extensions sans rompre la compatibilité. Si vous utilisez ` qstyleoption_cast()`, vous n'avez normalement pas besoin de la vérifier.

Voir aussi StyleOptionType.

Documentation des fonctions membres

QStyleOptionComboBox::QStyleOptionComboBox()

Crée un objet `QStyleOptionComboBox` et initialise ses variables membres à leurs valeurs par défaut.

QStyleOptionComboBox::QStyleOptionComboBox(const QStyleOptionComboBox &other)

Crée une copie de l'option de style « other ».

[noexcept default] QStyleOptionComboBox &QStyleOptionComboBox::operator=(const QStyleOptionComboBox &)

Attribue par copie la variable ` other ` à cette instance de ` QStyleOptionComboBox `.

Documentation sur les variables membres

QIcon QStyleOptionComboBox::currentIcon

Cette variable contient l'icône de l'élément actuel de la liste déroulante

La valeur par défaut est une icône vide, c'est-à-dire une icône ne comportant ni image ni nom de fichier.

QString QStyleOptionComboBox::currentText

Cette variable contient le texte correspondant à l'élément actuel de la liste déroulante

La valeur par défaut est une chaîne vide.

bool QStyleOptionComboBox::editable

Cette variable indique si la liste déroulante est modifiable ou non

sa valeur par défaut est « false »

Voir également la fonction ` QComboBox::isEditable()`.

bool QStyleOptionComboBox::frame

Cette variable indique si la liste déroulante est encadrée

La valeur par défaut est « true ».

QSize QStyleOptionComboBox::iconSize

Cette variable contient la taille de l'icône de l'élément actuel de la liste déroulante

La valeur par défaut est QSize(-1, -1), c'est-à-dire une taille non valide.

QRect QStyleOptionComboBox::popupRect

Cette variable contient le rectangle de la fenêtre contextuelle de la liste déroulante

La valeur par défaut est un rectangle nul, c'est-à-dire un rectangle dont la largeur et la hauteur sont toutes deux définies sur 0.

Cette variable n'est actuellement pas utilisée. Vous pouvez l'ignorer sans risque.

Voir également QStyle::SC_ComboBoxListBoxPopup.

Qt::Alignment QStyleOptionComboBox::textAlignment

Cette variable contient l'alignement du texte actuel dans la liste déroulante

La valeur par défaut est Qt::AlignLeft | Qt::AlignVCenter.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.