En esta página

QComboBox Class

El widget QComboBox combina un botón con una lista desplegable. Más información...

Encabezado: #include <QComboBox>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Heredado de: QWidget
Heredado por:

QFontComboBox

Tipos públicos

enum InsertPolicy { NoInsert, InsertAtTop, InsertAtCurrent, InsertAtBottom, InsertAfterCurrent, …, InsertAlphabetically }
(since 6.9) enum class LabelDrawingMode { UseStyle, UseDelegate }
enum SizeAdjustPolicy { AdjustToContents, AdjustToContentsOnFirstShow, AdjustToMinimumContentsLengthWithIcon }

Propiedades

Funciones públicas

QComboBox(QWidget *parent = nullptr)
virtual ~QComboBox()
void addItem(const QString &text, const QVariant &userData = QVariant())
void addItem(const QIcon &icon, const QString &text, const QVariant &userData = QVariant())
void addItems(const QStringList &texts)
QCompleter *completer() const
int count() const
QVariant currentData(int role = Qt::UserRole) const
int currentIndex() const
QString currentText() const
bool duplicatesEnabled() const
int findData(const QVariant &data, int role = Qt::UserRole, Qt::MatchFlags flags = static_cast<Qt::MatchFlags>(Qt::MatchExactly|Qt::MatchCaseSensitive)) const
int findText(const QString &text, Qt::MatchFlags flags = Qt::MatchExactly|Qt::MatchCaseSensitive) const
bool hasFrame() const
virtual void hidePopup()
QSize iconSize() const
void insertItem(int index, const QString &text, const QVariant &userData = QVariant())
void insertItem(int index, const QIcon &icon, const QString &text, const QVariant &userData = QVariant())
void insertItems(int index, const QStringList &list)
QComboBox::InsertPolicy insertPolicy() const
void insertSeparator(int index)
bool isEditable() const
QVariant itemData(int index, int role = Qt::UserRole) const
QAbstractItemDelegate *itemDelegate() const
QIcon itemIcon(int index) const
QString itemText(int index) const
QComboBox::LabelDrawingMode labelDrawingMode() const
QLineEdit *lineEdit() const
int maxCount() const
int maxVisibleItems() const
int minimumContentsLength() const
QAbstractItemModel *model() const
int modelColumn() const
QString placeholderText() const
void removeItem(int index)
QModelIndex rootModelIndex() const
void setCompleter(QCompleter *completer)
void setDuplicatesEnabled(bool enable)
void setEditable(bool editable)
void setFrame(bool)
void setIconSize(const QSize &size)
void setInsertPolicy(QComboBox::InsertPolicy policy)
void setItemData(int index, const QVariant &value, int role = Qt::UserRole)
void setItemDelegate(QAbstractItemDelegate *delegate)
void setItemIcon(int index, const QIcon &icon)
void setItemText(int index, const QString &text)
void setLabelDrawingMode(QComboBox::LabelDrawingMode labelDrawing)
void setLineEdit(QLineEdit *edit)
void setMaxCount(int max)
void setMaxVisibleItems(int maxItems)
void setMinimumContentsLength(int characters)
virtual void setModel(QAbstractItemModel *model)
void setModelColumn(int visibleColumn)
void setPlaceholderText(const QString &placeholderText)
void setRootModelIndex(const QModelIndex &index)
void setSizeAdjustPolicy(QComboBox::SizeAdjustPolicy policy)
void setValidator(const QValidator *validator)
void setView(QAbstractItemView *itemView)
virtual void showPopup()
QComboBox::SizeAdjustPolicy sizeAdjustPolicy() const
const QValidator *validator() const
QAbstractItemView *view() const

Funciones públicas reimplementadas

virtual bool event(QEvent *event) override
virtual QVariant inputMethodQuery(Qt::InputMethodQuery query) const override
virtual QSize minimumSizeHint() const override
virtual QSize sizeHint() const override

Ranuras públicas

void clear()
void clearEditText()
void setCurrentIndex(int index)
void setCurrentText(const QString &text)
void setEditText(const QString &text)

Señales

void activated(int index)
void currentIndexChanged(int index)
void currentTextChanged(const QString &text)
void editTextChanged(const QString &text)
void highlighted(int index)
void textActivated(const QString &text)
void textHighlighted(const QString &text)

Funciones protegidas

virtual void initStyleOption(QStyleOptionComboBox *option) const

Funciones protegidas reimplementadas

virtual void changeEvent(QEvent *e) override
virtual void contextMenuEvent(QContextMenuEvent *e) override
virtual void focusInEvent(QFocusEvent *e) override
virtual void focusOutEvent(QFocusEvent *e) override
virtual void hideEvent(QHideEvent *e) override
virtual void inputMethodEvent(QInputMethodEvent *e) override
virtual void keyPressEvent(QKeyEvent *e) override
virtual void keyReleaseEvent(QKeyEvent *e) override
virtual void mousePressEvent(QMouseEvent *e) override
virtual void mouseReleaseEvent(QMouseEvent *e) override
virtual void paintEvent(QPaintEvent *e) override
virtual void resizeEvent(QResizeEvent *e) override
virtual void showEvent(QShowEvent *e) override
virtual void wheelEvent(QWheelEvent *e) override

Descripción detallada

Cuadro combinado con lista de opciones oculta

QCombobox contraída

Cuadro combinado con lista de opciones ampliada

QCombobox desplegado

Características de visualización

Un QComboBox es una forma compacta de presentar una lista de opciones al usuario.

Un cuadro combinado es un control de selección que muestra el elemento actual y, al hacer clic en él, abre una lista de elementos seleccionables. Los cuadros combinados pueden contener tanto mapas de píxeles como cadenas de caracteres si se sobrecargan adecuadamente las funciones « insertItem()» y « setItemText()».

Funciones de edición

Un cuadro combinado puede ser editable, lo que permite al usuario modificar cada elemento de la lista. Para los cuadros combinados editables, se proporciona la función ` clearEditText()`, que borra la cadena mostrada sin modificar el contenido del cuadro combinado.

Cuando el usuario introduce una nueva cadena en un cuadro combinado editable, el widget puede insertarla o no, y puede hacerlo en varias ubicaciones. La política por defecto es InsertAtBottom, pero se puede cambiar utilizando setInsertPolicy().

Es posible restringir la entrada en un cuadro combinado editable utilizando QValidator; véase setValidator(). De forma predeterminada, se acepta cualquier entrada.

Un cuadro combinado se puede rellenar utilizando las funciones de inserción, como, por ejemplo, insertItem() y insertItems(). Los elementos se pueden modificar con setItemText(). Se puede eliminar un elemento con removeItem() y se pueden eliminar todos los elementos con clear(). El texto del elemento actual se obtiene con currentText(), y el texto de un elemento numerado se obtiene con text(). El elemento actual se puede establecer con setCurrentIndex(). El número de elementos del cuadro combinado se obtiene mediante count(); el número máximo de elementos se puede establecer con setMaxCount(). Se puede permitir la edición mediante setEditable(). En los cuadros combinados editables, se puede configurar el autocompletado mediante setCompleter() y se puede establecer si el usuario puede añadir duplicados o no mediante setDuplicatesEnabled().

Señales

Se emiten tres señales cuando cambia el elemento actual de un cuadro combinado: currentIndexChanged(), currentTextChanged() y activated(). currentIndexChanged() y currentTextChanged() se emiten siempre, independientemente de si el cambio se ha realizado mediante programación o por interacción del usuario, mientras que activated() solo se emite cuando el cambio es provocado por la interacción del usuario. La señal highlighted() se emite cuando el usuario resalta un elemento en la lista emergente del cuadro combinado. Las tres señales existen en dos versiones: una con el argumento « QString » y otra con el argumento « int ». Si el usuario selecciona o resalta un mapa de píxeles, solo se emiten las señales « int ». Cada vez que se modifica el texto de un cuadro combinado editable, se emite la señal « editTextChanged()».

Marco de trabajo Modelo/Vista

QComboBox utiliza el marco de trabajo Modelo/Vista para su lista desplegable y para almacenar sus elementos. Por defecto, un ` QStandardItemModel ` almacena los elementos y una subclase de ` QListView ` muestra la lista desplegable. Se puede acceder directamente al modelo y a la vista (con model() y view()), pero QComboBox también proporciona funciones para establecer y obtener datos de los elementos, por ejemplo, setItemData() y itemText(). También se puede establecer un nuevo modelo y una nueva vista (mediante setModel() y setView()). Para el texto y el icono de la etiqueta del cuadro combinado, se utilizan los datos del modelo que contienen Qt::DisplayRole y Qt::DecorationRole.

Nota: Nose puede modificar el SelectionMode del view(), por ejemplo, utilizando setSelectionMode().

Véase también QLineEdit, QSpinBox, QRadioButton y QButtonGroup.

Documentación sobre tipos de miembros

enum QComboBox::InsertPolicy

Esta enumeración especifica qué debe hacer el control « QComboBox » cuando el usuario introduce una nueva cadena.

ConstanteValorDescripción
QComboBox::NoInsert0La cadena no se insertará en el cuadro combinado.
QComboBox::InsertAtTop1La cadena se insertará como primer elemento del cuadro combinado.
QComboBox::InsertAtCurrent2El elemento actual se sustituirá por la cadena.
QComboBox::InsertAtBottom3La cadena se insertará después del último elemento del cuadro combinado.
QComboBox::InsertAfterCurrent4La cadena se inserta después del elemento actual del cuadro combinado.
QComboBox::InsertBeforeCurrent5La cadena se inserta antes del elemento actual del cuadro combinado.
QComboBox::InsertAlphabetically6La cadena se inserta en el cuadro combinado siguiendo el orden alfabético.

[since 6.9] enum class QComboBox::LabelDrawingMode

Esta enumeración especifica cómo se dibuja la etiqueta del cuadro combinado.

ConstanteValorDescripción
QComboBox::LabelDrawingMode::UseStyle0El cuadro combinado utiliza el delegado de elementos ( style ) para dibujar su etiqueta.
QComboBox::LabelDrawingMode::UseDelegate1El cuadro combinado utiliza el delegado de elemento ( item delegate ) para dibujar la etiqueta. Establece un delegado de elemento adecuado cuando utilices este modo.

Esta enumeración se introdujo en Qt 6.9.

Véase también « labelDrawingMode » y el ejemplo «Books».

enum QComboBox::SizeAdjustPolicy

Esta enumeración especifica cómo debe ajustarse la indicación de tamaño del elemento « QComboBox » cuando se añade nuevo contenido o este cambia.

ConstanteValorDescripción
QComboBox::AdjustToContents0El cuadro combinado siempre se ajustará al contenido
QComboBox::AdjustToContentsOnFirstShow1El cuadro combinado se ajustará a su contenido la primera vez que se muestre.
QComboBox::AdjustToMinimumContentsLengthWithIcon2El cuadro combinado se ajustará a un valor de « minimumContentsLength » más el espacio necesario para un icono. Por motivos de rendimiento, utiliza esta política en modelos de gran tamaño.

Documentación de la propiedad

[read-only] count : int

Esta propiedad indica el número de elementos que contiene el cuadro combinado.

Por defecto, en el caso de un cuadro combinado vacío, esta propiedad tiene un valor de 0.

Funciones de acceso:

int count() const

[read-only] currentData : QVariant

Esta propiedad contiene los datos del elemento actual

De forma predeterminada, en el caso de un cuadro combinado vacío o en el que no se haya establecido ningún elemento actual, esta propiedad contiene un valor no válido QVariant.

Funciones de Access:

QVariant currentData(int role = Qt::UserRole) const

currentIndex : int

Esta propiedad contiene el índice del elemento actual en el cuadro combinado.

El índice actual puede cambiar al insertar o eliminar elementos.

Por defecto, en el caso de un cuadro combinado vacío o en el que no se haya establecido ningún elemento actual, esta propiedad tiene el valor -1.

Funciones de acceso:

int currentIndex() const
void setCurrentIndex(int index)

Señal de notificación:

void currentIndexChanged(int index)

currentText : QString

Esta propiedad contiene el texto actual

Si el cuadro combinado es editable, el texto actual es el valor que muestra el campo de texto. De lo contrario, es el valor del elemento actual o una cadena vacía si el cuadro combinado está vacío o no hay ningún elemento actual establecido.

El método setter setCurrentText() simplemente llama a setEditText() si el cuadro combinado es editable. En caso contrario, si hay un texto coincidente en la lista, currentIndex se establece en el índice correspondiente.

Funciones de acceso:

QString currentText() const
void setCurrentText(const QString &text)

Señal del notificador:

void currentTextChanged(const QString &text)

Véase también editable y setEditText().

duplicatesEnabled : bool

Esta propiedad determina si el usuario puede introducir elementos duplicados en el cuadro combinado.

Ten en cuenta que siempre es posible insertar elementos duplicados en el cuadro combinado mediante programación.

Por defecto, esta propiedad está configurada en « false » (no se permiten duplicados).

Funciones de acceso:

bool duplicatesEnabled() const
void setDuplicatesEnabled(bool enable)

editable : bool

Esta propiedad determina si el usuario puede editar el cuadro combinado.

De forma predeterminada, esta propiedad está en estado « false ». El efecto de la edición depende de la política de inserción.

Nota: Al desactivar el estado « editable », se eliminan el validador y el completador.

Funciones de acceso:

bool isEditable() const
void setEditable(bool editable)

Véase también « InsertPolicy ».

frame : bool

Esta propiedad determina si el cuadro combinado se muestra con un marco.

Si está habilitada (valor predeterminado), el cuadro combinado se muestra dentro de un marco; en caso contrario, se muestra sin marco alguno.

Funciones de Access:

bool hasFrame() const
void setFrame(bool)

iconSize : QSize

Esta propiedad define el tamaño de los iconos que se muestran en el cuadro combinado.

A menos que se especifique explícitamente, devuelve el valor predeterminado del estilo actual. Este tamaño es el máximo que pueden tener los iconos; los iconos de tamaño inferior no se amplían.

Funciones de acceso:

QSize iconSize() const
void setIconSize(const QSize &size)

insertPolicy : InsertPolicy

Esta propiedad contiene la política que se utiliza para determinar en qué posición del cuadro combinado deben aparecer los elementos introducidos por el usuario.

El valor predeterminado es « InsertAtBottom », lo que indica que los nuevos elementos aparecerán al final de la lista de elementos.

Funciones de Access:

QComboBox::InsertPolicy insertPolicy() const
void setInsertPolicy(QComboBox::InsertPolicy policy)

Véase también InsertPolicy.

[since 6.9] labelDrawingMode : LabelDrawingMode

Esta propiedad define el modo que utiliza el cuadro combinado para dibujar su etiqueta.

El valor por defecto es « UseStyle ». Al cambiar esta propiedad a « UseDelegate », asegúrate de establecer también un « item delegate » adecuado. El delegado por defecto depende del estilo y puede que no sea adecuado para dibujar la etiqueta.

Esta enumeración se introdujo en Qt 6.9.

Funciones de acceso:

QComboBox::LabelDrawingMode labelDrawingMode() const
void setLabelDrawingMode(QComboBox::LabelDrawingMode labelDrawing)

Véase también el ejemplo «Books».

maxCount : int

Esta propiedad establece el número máximo de elementos permitidos en el cuadro combinado.

Nota: Si se establece un número máximo inferior al número actual de elementos del cuadro combinado, los elementos sobrantes se omitirán. Esto también se aplica si se ha configurado un modelo externo en el cuadro combinado.

Por defecto, el valor de esta propiedad se deriva del entero con signo más alto disponible (normalmente 2147483647).

Funciones de acceso:

int maxCount() const
void setMaxCount(int max)

maxVisibleItems : int

Esta propiedad indica el tamaño máximo permitido en pantalla del cuadro combinado, medido en elementos

Por defecto, esta propiedad tiene un valor de 10.

Nota: Esta propiedad se ignora en los cuadros combinados no editables de estilos que devuelven «true» para la opción « QStyle::SH_ComboBox_Popup », como el estilo Mac o el estilo Gtk+.

Funciones de acceso:

int maxVisibleItems() const
void setMaxVisibleItems(int maxItems)

minimumContentsLength : int

Esta propiedad establece el número mínimo de caracteres que deben caber en el cuadro combinado.

El valor por defecto es 0.

Si esta propiedad se establece en un valor positivo, las funciones « minimumSizeHint()» y « sizeHint()» lo tienen en cuenta.

Funciones de acceso:

int minimumContentsLength() const
void setMinimumContentsLength(int characters)

Véase también sizeAdjustPolicy.

modelColumn : int

Esta propiedad indica qué columna del modelo está visible.

Si se configura antes de rellenar el cuadro combinado, la vista emergente no se verá afectada y mostrará la primera columna (utilizando el valor por defecto de esta propiedad).

Por defecto, esta propiedad tiene un valor de 0.

Nota: En un cuadro combinado editable, la columna visible se convertirá también en la columna por defecto ( completion column).

Funciones de acceso:

int modelColumn() const
void setModelColumn(int visibleColumn)

placeholderText : QString

Establece un texto de « placeholderText » que se muestra cuando no se ha establecido ningún índice válido.

El texto « placeholderText » se mostrará cuando se establezca un índice no válido. No se puede acceder a este texto en la lista desplegable. Si se llama a esta función antes de añadir elementos, se mostrará el texto de marcador de posición; de lo contrario, deberá llamar a setCurrentIndex(-1) mediante programación si desea mostrar dicho texto. Establezca un texto de marcador de posición vacío para restablecer la configuración.

Cuando el « QComboBox » sea editable, utiliza en su lugar QLineEdit::setPlaceholderText().

Funciones de acceso:

QString placeholderText() const
void setPlaceholderText(const QString &placeholderText)

sizeAdjustPolicy : SizeAdjustPolicy

Esta propiedad contiene la política que describe cómo cambia el tamaño del cuadro combinado cuando cambia el contenido.

El valor por defecto es « AdjustToContentsOnFirstShow ».

Funciones de acceso:

QComboBox::SizeAdjustPolicy sizeAdjustPolicy() const
void setSizeAdjustPolicy(QComboBox::SizeAdjustPolicy policy)

Véase también SizeAdjustPolicy.

Documentación de funciones de miembro

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

Crea un cuadro combinado con el parent indicado, utilizando el modelo predeterminado QStandardItemModel.

[virtual noexcept] QComboBox::~QComboBox()

Elimina el cuadro combinado.

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

Esta señal se envía cuando el usuario selecciona un elemento del cuadro combinado. Se pasa el identificador del elemento ( index ). Ten en cuenta que esta señal se envía incluso cuando la selección no cambia. Si necesitas saber cuándo cambia realmente la selección, utiliza la señal currentIndexChanged() o currentTextChanged().

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

Añade un elemento al cuadro combinado con el « text » indicado y que contiene el « userData » especificado (almacenado en el « Qt::UserRole »). El elemento se añade al final de la lista de elementos existentes.

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

Añade un elemento al cuadro combinado con los valores « icon » y « text » indicados, y que contiene el valor « userData » especificado (almacenado en « Qt::UserRole »). El elemento se añade al final de la lista de elementos existentes.

void QComboBox::addItems(const QStringList &texts)

Añade cada una de las cadenas del archivo « texts » a la lista desplegable. Cada elemento se añade al final de la lista de elementos existentes, uno tras otro.

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

Reimplementa: ` QWidget::changeEvent(QEvent *event)`.

[slot] void QComboBox::clear()

Borra el contenido del cuadro combinado, eliminando todos los elementos.

Nota: Si has configurado un modelo externo en el cuadro combinado, este modelo también se borrará al llamar a esta función.

[slot] void QComboBox::clearEditText()

Borra el contenido del campo de edición de línea que se utiliza para editar en el cuadro combinado.

QCompleter *QComboBox::completer() const

Devuelve el componente de autocompletado que se utiliza para autocompletar el texto introducido en el cuadro combinado.

Véase también setCompleter() y editable.

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

Reimplementa: QWidget::contextMenuEvent(QContextMenuEvent *event).

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

Esta señal se envía cada vez que la propiedad ` currentIndex ` del cuadro combinado cambia, ya sea por interacción del usuario o mediante programación. Se pasa la propiedad ` index ` del elemento, o bien -1 si el cuadro combinado queda vacío o si se ha restablecido la propiedad ` currentIndex `.

Nota: Señalde notificación para la propiedad currentIndex.

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

Esta señal se emite cada vez que cambia currentText. El nuevo valor se pasa como text.

Nota: Nose emite si currentText permanece igual, aunque cambie currentIndex.

Nota: Señalde notificador para la propiedad currentText.

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

Esta señal se emite cuando se modifica el texto del control de edición de línea del cuadro combinado. El nuevo texto se especifica mediante ` text`.

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

Reimplementa: ` 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

Devuelve el índice del elemento que contiene el ` data ` indicado para el ` role` indicado; en caso contrario, devuelve -1.

Los parámetros flags especifican cómo se realizan las búsquedas en los elementos del cuadro combinado.

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

Devuelve el índice del elemento que contiene el ` text` indicado; en caso contrario, devuelve -1.

Los parámetros « flags » especifican cómo se realizan las búsquedas en los elementos del cuadro combinado.

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

Reimplementa: QWidget::focusInEvent(QFocusEvent *event).

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

Reimplementa: QWidget::focusOutEvent(QFocusEvent *event).

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

Reimplementa: QWidget::hideEvent(QHideEvent *event).

[virtual] void QComboBox::hidePopup()

Oculta la lista de elementos del cuadro combinado si está visible en ese momento y restablece el estado interno, de modo que, si se ha mostrado la ventana emergente personalizada dentro del método ` showPopup()` reimplementado, también tendrás que reimplementar la función hidePopup() para ocultar tu ventana emergente personalizada y llamar a la implementación de la clase base para restablecer el estado interno cada vez que se oculte tu widget de ventana emergente personalizado.

Véase también ` showPopup()`.

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

Esta señal se envía cuando el usuario selecciona un elemento de la lista desplegable del cuadro combinado. Se pasa el objeto ` index ` del elemento.

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

Inicializa ` option ` con los valores de esta página: QComboBox. Este método resulta útil para las subclases cuando necesitan un ` QStyleOptionComboBox`, pero no desean rellenar toda la información por sí mismas.

Véase también QStyleOption::initFrom().

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

Reimplementa: ` QWidget::inputMethodEvent(QInputMethodEvent *event)`.

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

Reimplementa: ` QWidget::inputMethodQuery` (conste `Qt::InputMethodQuery query`).

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

Inserta los elementos text y userData (almacenados en Qt::UserRole) en el cuadro combinado situado en la dirección indicada index.

Si el índice es igual o superior al número total de elementos, el nuevo elemento se añade al final de la lista de elementos existentes. Si el índice es cero o negativo, el nuevo elemento se añade al principio de la lista de elementos existentes.

Véase también insertItems().

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

Inserta los elementos icon, text y userData (almacenados en Qt::UserRole) en el cuadro combinado situado en la dirección indicada index.

Si el índice es igual o superior al número total de elementos, el nuevo elemento se añade al final de la lista de elementos existentes. Si el índice es cero o negativo, el nuevo elemento se añade al principio de la lista de elementos existentes.

Véase también insertItems().

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

Inserta las cadenas de la lista « list » en el cuadro combinado como elementos independientes, comenzando por el índice index especificado.

Si el índice es igual o superior al número total de elementos, los nuevos elementos se añaden al final de la lista de elementos existentes. Si el índice es cero o negativo, los nuevos elementos se añaden al principio de la lista de elementos existentes.

Véase también insertItem().

void QComboBox::insertSeparator(int index)

Inserta un elemento separador en el cuadro combinado en el índice especificado ( index).

Si el índice es igual o superior al número total de elementos, el nuevo elemento se añade al final de la lista de elementos existentes. Si el índice es cero o negativo, el nuevo elemento se añade al principio de la lista de elementos existentes.

Véase también insertItem().

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

Devuelve los datos correspondientes al « role » especificado en el « index » indicado en el cuadro combinado, o un « QVariant » no válido si no hay datos para este rol.

Véase también setItemData().

QAbstractItemDelegate *QComboBox::itemDelegate() const

Devuelve el delegado de elemento utilizado por la vista de lista emergente.

Véase también setItemDelegate().

QIcon QComboBox::itemIcon(int index) const

Devuelve el icono correspondiente a la cadena « index » en el cuadro combinado.

Véase también setItemIcon().

QString QComboBox::itemText(int index) const

Devuelve el texto correspondiente al valor « index » especificado en el cuadro combinado.

Véase también setItemText().

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

Reimplementa: ` QWidget::keyPressEvent(QKeyEvent *event)`.

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

Reimplementa: ` QWidget::keyReleaseEvent(QKeyEvent *event)`.

QLineEdit *QComboBox::lineEdit() const

Devuelve el campo de edición de línea que se utiliza para editar los elementos del cuadro combinado, o un objeto ` nullptr ` si no hay ningún campo de edición de línea.

Solo los cuadros combinados editables tienen un campo de texto.

Véase también setLineEdit().

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

Reimplementa una función de acceso para la propiedad: QWidget::minimumSizeHint.

QAbstractItemModel *QComboBox::model() const

Devuelve el modelo utilizado por el cuadro combinado.

Véase también setModel().

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

Reimplementa: ` QWidget::mousePressEvent(QMouseEvent *event)`.

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

Reimplementa: ` QWidget::mouseReleaseEvent(QMouseEvent *event)`.

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

Reimplementa: QWidget::paintEvent(QPaintEvent *event).

void QComboBox::removeItem(int index)

Elimina del cuadro combinado el elemento situado en la posición indicada ( index ). Esto actualizará el índice actual si dicho índice se elimina.

Esta función no realiza ninguna acción si index está fuera de rango.

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

Reimplementa: QWidget::resizeEvent(QResizeEvent *event).

QModelIndex QComboBox::rootModelIndex() const

Devuelve el índice del elemento raíz del modelo correspondiente a los elementos del cuadro combinado.

Véase también setRootModelIndex().

void QComboBox::setCompleter(QCompleter *completer)

Establece el « completer » que se utilizará en lugar del completador actual. Si « completer » es « nullptr », se desactiva la autocompletación.

De forma predeterminada, para un cuadro combinado editable, se crea automáticamente un « QCompleter » que realiza la autocompletación en línea sin distinguir entre mayúsculas y minúsculas.

Nota: El completador se elimina cuando la propiedad ` editable ` pasa a ser ` false`, o cuando el campo de edición de línea se sustituye mediante una llamada a ` setLineEdit()`. Si se establece un completador en un ` QComboBox ` que no sea editable, se ignorará.

Véase también completer().

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

Establece el valor « text » en el campo de edición de texto del cuadro combinado.

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

Establece el dato role del elemento situado en la posición indicada index del cuadro combinado en el valor especificado value.

Véase también itemData().

void QComboBox::setItemDelegate(QAbstractItemDelegate *delegate)

Establece el elemento delegate para la vista de lista emergente. El cuadro combinado asume la propiedad del delegado.

Cualquier delegado existente se eliminará, pero no se borrará. QComboBox no asume la propiedad de delegate.

Advertencia: Nodebes compartir la misma instancia de un delegado entre cuadros combinados, mapeadores de widgets o vistas. Hacerlo puede provocar un comportamiento de edición incorrecto o poco intuitivo, ya que cada vista conectada a un delegado determinado puede recibir la señal closeEditor() e intentar acceder, modificar o cerrar un editor que ya se haya cerrado.

Véase también ` itemDelegate()`.

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

Establece el valor « icon » del elemento situado en la posición « index » del cuadro combinado.

Véase también itemIcon().

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

Establece el valor « text » del elemento situado en la posición « index » del cuadro combinado.

Véase también itemText().

void QComboBox::setLineEdit(QLineEdit *edit)

Establece el cuadro de línea « edit » para que se utilice en lugar del control de edición de línea actual.

El cuadro combinado asume la propiedad del campo de edición de línea.

QCompleterNota: Dado que el cuadro combinado es el propietario del campo de edición de línea, cualquier llamada previa a ` setCompleter()` ya no tendrá ningún efecto.

Véase también ` lineEdit()`.

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

Establece el modelo como « model ». « model » no debe ser « nullptr ». Si deseas borrar el contenido de un modelo, llama a « clear()».

Nota: Si el cuadro combinado es editable, el valor « model » también se establecerá en el complemento del campo de texto.

Véase también model(), clear() y setCompleter().

void QComboBox::setRootModelIndex(const QModelIndex &index)

Establece el elemento de modelo raíz index para los elementos del cuadro combinado.

Véase también rootModelIndex().

void QComboBox::setValidator(const QValidator *validator)

Establece el « validator » que se utilizará en lugar del validador actual.

Nota: El validador se elimina cuando la propiedad ` editable ` pasa a ser ` false`.

Véase también validator().

void QComboBox::setView(QAbstractItemView *itemView)

Establece la vista que se utilizará en la ventana emergente del cuadro combinado como la especificada en itemView. El cuadro combinado asume la propiedad de la vista.

Nota: Si deseas utilizar las vistas predefinidas (como QListWidget, QTableWidget o QTreeWidget), asegúrate de llamar a setModel() en el cuadro combinado con el modelo de widgets predefinidos antes de llamar a esta función.

Véase también view().

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

Reimplementa: ` QWidget::showEvent(QShowEvent *event)`.

[virtual] void QComboBox::showPopup()

Muestra la lista de elementos del cuadro combinado. Si la lista está vacía, no se mostrará ningún elemento.

Si reimplementas esta función para mostrar una ventana emergente personalizada, asegúrate de llamar a hidePopup() para restablecer el estado interno.

Véase también hidePopup().

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

Reimplementa una función de acceso para la propiedad: QWidget::sizeHint.

Esta implementación almacena en caché la indicación de tamaño para evitar el redimensionamiento cuando el contenido cambia dinámicamente. Para invalidar el valor almacenado en caché, cambia el valor de sizeAdjustPolicy.

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

Esta señal se envía cuando el usuario selecciona un elemento en el cuadro combinado. Se pasa el ` text ` del elemento. Ten en cuenta que esta señal se envía incluso cuando la selección no cambia. Si necesitas saber cuándo cambia realmente la selección, utiliza la señal ` currentIndexChanged()` o ` currentTextChanged()`.

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

Esta señal se envía cuando el usuario selecciona un elemento de la lista desplegable del cuadro combinado. Se pasa el objeto ` text ` de dicho elemento.

const QValidator *QComboBox::validator() const

Devuelve el validador que se utiliza para restringir la entrada de texto en el cuadro combinado.

Véase también setValidator() y editable.

QAbstractItemView *QComboBox::view() const

Devuelve la vista de lista utilizada para el menú emergente del cuadro combinado.

Véase también setView().

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

Reimplementa: ` QWidget::wheelEvent(QWheelEvent *event)`.

© 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.