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: |
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
QCombobox contraída |
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.
| Constante | Valor | Descripción |
|---|---|---|
QComboBox::NoInsert | 0 | La cadena no se insertará en el cuadro combinado. |
QComboBox::InsertAtTop | 1 | La cadena se insertará como primer elemento del cuadro combinado. |
QComboBox::InsertAtCurrent | 2 | El elemento actual se sustituirá por la cadena. |
QComboBox::InsertAtBottom | 3 | La cadena se insertará después del último elemento del cuadro combinado. |
QComboBox::InsertAfterCurrent | 4 | La cadena se inserta después del elemento actual del cuadro combinado. |
QComboBox::InsertBeforeCurrent | 5 | La cadena se inserta antes del elemento actual del cuadro combinado. |
QComboBox::InsertAlphabetically | 6 | La 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.
| Constante | Valor | Descripción |
|---|---|---|
QComboBox::LabelDrawingMode::UseStyle | 0 | El cuadro combinado utiliza el delegado de elementos ( style ) para dibujar su etiqueta. |
QComboBox::LabelDrawingMode::UseDelegate | 1 | El 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.
| Constante | Valor | Descripción |
|---|---|---|
QComboBox::AdjustToContents | 0 | El cuadro combinado siempre se ajustará al contenido |
QComboBox::AdjustToContentsOnFirstShow | 1 | El cuadro combinado se ajustará a su contenido la primera vez que se muestre. |
QComboBox::AdjustToMinimumContentsLengthWithIcon | 2 | El 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.

