QComboBox Class

Documentación de las funciones miembro

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

Construye un combobox con la dirección parent, utilizando el modelo por defecto QStandardItemModel.

[virtual noexcept] QComboBox::~QComboBox()

Destruye el combobox.

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

Esta señal se envía cuando el usuario elige un elemento en el combobox. Se pasa la dirección index del elemento. Tenga en cuenta que esta señal se envía incluso cuando la elección no ha cambiado. Si necesita saber cuándo cambia realmente la elección, utilice la señal currentIndexChanged() o currentTextChanged().

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

Añade un elemento al combobox con la dirección text y que contiene la dirección userData especificada (almacenada en Qt::UserRole). El elemento se añade a la lista de elementos existentes.

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

Añade un elemento al combobox con los datos icon y text, y que contiene el userData especificado (almacenado en Qt::UserRole). El elemento se añade a la lista de elementos existentes.

void QComboBox::addItems(const QStringList &texts)

Añade cada una de las cadenas de texts al combobox. Cada elemento se añade sucesivamente a la lista de elementos existentes.

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

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

[slot] void QComboBox::clear()

Borra el combobox, eliminando todos los elementos.

Nota: Si ha establecido un modelo externo en el combobox, este modelo se borrará al llamar a esta función.

[slot] void QComboBox::clearEditText()

Borra el contenido de la línea de edición utilizada para editar en el combobox.

QCompleter *QComboBox::completer() const

Devuelve el completador que se utiliza para autocompletar la entrada de texto del combobox.

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 el currentIndex del combobox cambia, ya sea por interacción del usuario o mediante programación. Se pasa el index del elemento o -1 si el combobox se vacía o se reinicia el 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.

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

Esta señal se emite cuando se cambia el texto en el widget de edición de línea del combobox. El nuevo texto se especifica en 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 dado para el role dado ; en caso contrario devuelve -1.

flags especifica cómo se buscan los elementos en el combobox.

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

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

flags especifica cómo se buscan los elementos en el combobox.

[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 combobox si está visible en ese momento y restablece el estado interno, de modo que si la ventana emergente personalizada se mostró dentro de la reimplementación de showPopup(), entonces también tendrá que reimplementar la función hidePopup() para ocultar su ventana emergente personalizada y llamar a la implementación de la clase base para restablecer el estado interno cada vez que se oculte su widget de ventana emergente personalizada.

Véase también showPopup().

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

Esta señal se envía cuando el usuario resalta un elemento de la lista desplegable del combobox. Se pasa la dirección index del elemento.

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

Inicializa option con los valores de este QComboBox. Este método es útil para las subclases cuando necesitan un QStyleOptionComboBox, pero no quieren rellenar toda la información ellos mismos.

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

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

Inserta los elementos text y userData (almacenados en Qt::UserRole) en el combobox en el index dado.

Si el índice es igual o superior al número total de elementos, el nuevo elemento se añade a la lista de elementos existentes. Si el índice es cero o negativo, el nuevo elemento se añade a 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 combobox en el índice index.

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

Véase también insertItems().

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

Inserta las cadenas de list en el combobox como elementos separados, empezando por index.

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

Véase también insertItem().

void QComboBox::insertSeparator(int index)

Inserta un elemento separador en el combobox en la dirección index.

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

Véase también insertItem().

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

Devuelve los datos para el role dado en el index dado en el combobox, o un QVariant invá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 para el index dado en el combobox.

Véase también setItemIcon().

QString QComboBox::itemText(int index) const

Devuelve el texto para el index dado en el combobox.

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 la edición de línea utilizada para editar elementos en el cuadro combinado, o nullptr si no hay edición de línea.

Sólo los cuadros combinados editables tienen edición de línea.

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

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 el elemento en el index dado del combobox. Esto actualizará el índice actual si se elimina el índice.

Esta función no hace nada 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 del modelo raíz para los elementos del combobox.

Véase también setRootModelIndex().

void QComboBox::setCompleter(QCompleter *completer)

Establece el completer a utilizar en lugar del completador actual. Si completer es nullptr, el autocompletado se desactiva.

Por defecto, para un cuadro combinado editable, se crea automáticamente un QCompleter que realiza la compleción en línea sin distinguir mayúsculas de minúsculas.

Véase también completer().

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

Establece el text en la edición de texto del combobox.

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

Establece los datos role para el elemento en el index dado en el combobox al value especificado.

Véase también itemData().

void QComboBox::setItemDelegate(QAbstractItemDelegate *delegate)

Establece el elemento delegate para la vista de lista emergente. El combobox toma posesión del delegado.

Cualquier delegado existente será eliminado, pero no borrado. QComboBox no se apropia de delegate.

Véase también itemDelegate().

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

Establece el icon para el elemento en el index dado en el combobox.

Véase también itemIcon().

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

Establece el text para el elemento en el index dado en el combobox.

Véase también itemText().

void QComboBox::setLineEdit(QLineEdit *edit)

Establece la línea edit a utilizar en lugar del widget de edición de línea actual.

El cuadro combinado toma posesión de la edición de línea.

Véase también lineEdit().

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

Establece que el modelo sea model. model no debe ser nullptr. Si desea borrar el contenido de un modelo, llame a clear().

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

void QComboBox::setRootModelIndex(const QModelIndex &index)

Establece el elemento del modelo raíz index para los elementos del combobox.

Véase también rootModelIndex().

void QComboBox::setValidator(const QValidator *validator)

Establece el validator a utilizar en lugar del validador actual.

Véase también validator().

void QComboBox::setView(QAbstractItemView *itemView)

Establece la vista que se utilizará en la ventana emergente del combobox en la dirección itemView. El combobox toma posesión de la vista.

Nota: Si desea utilizar las vistas de conveniencia (como QListWidget, QTableWidget o QTreeWidget), asegúrese de llamar a setModel() en el combobox con el modelo de widgets de conveniencia 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 combobox. Si la lista está vacía, no se mostrará ningún elemento.

Si reimplementa esta función para mostrar una ventana emergente personalizada, asegúrese 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 sugerencia de tamaño para evitar el redimensionamiento cuando el contenido cambia dinámicamente. Para invalidar el valor almacenado en caché, cambie el sizeAdjustPolicy.

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

Esta señal se envía cuando el usuario elige un elemento en el combobox. Se pasa la dirección text del elemento. Tenga en cuenta que esta señal se envía incluso cuando la elección no ha cambiado. Si necesita saber cuándo cambia realmente la elección, utilice la señal currentIndexChanged() o currentTextChanged().

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

Esta señal se envía cuando el usuario resalta un elemento de la lista desplegable del combobox. Se pasa la dirección text del elemento.

const QValidator *QComboBox::validator() const

Devuelve el validador que se utiliza para restringir la entrada de texto para el combobox.

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

QAbstractItemView *QComboBox::view() const

Devuelve la vista de lista utilizada para la ventana emergente del combobox.

Véase también setView().

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

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