QCompleter Class

Documentación de funciones miembro

QCompleter::QCompleter(QObject *parent = nullptr)

Construye un objeto completador con la dirección parent.

QCompleter::QCompleter(QAbstractItemModel *model, QObject *parent = nullptr)

Construye un objeto completer con el parent dado que proporciona completions del model especificado.

QCompleter::QCompleter(const QStringList &list, QObject *parent = nullptr)

Construye un objeto QCompleter con el parent dado que utiliza el list especificado como fuente de posibles terminaciones.

[override virtual noexcept] QCompleter::~QCompleter()

Destruye el objeto completador.

[signal] void QCompleter::activated(const QModelIndex &index)

Esta señal se envía cuando un elemento de la popup() es activado por el usuario. (haciendo clic o pulsando retorno). Se da el index del elemento en el completionModel().

// Connect using qOverload:
connect(completer, qOverload(&QCompleter::activated),
        receiver, &ReceiverClass::slot);

// Or using a lambda:
connect(completer, qOverload(&QCompleter::activated),
        this, [](const QModelIndex &index) { /* handle activated */ });

[signal] void QCompleter::activated(const QString &text)

Esta señal se envía cuando un elemento de popup() es activado por el usuario (haciendo clic o pulsando retorno). Se indica la dirección text del elemento.

// Connect using qOverload:
connect(completer, qOverload(&QCompleter::activated),
        receiver, &ReceiverClass::slot);

// Or using a lambda:
connect(completer, qOverload(&QCompleter::activated),
        this, [](const QString &text) { /* handle activated */ });

[slot] void QCompleter::complete(const QRect &rect = QRect())

Para los modos QCompleter::PopupCompletion y QCompletion::UnfilteredPopupCompletion, al llamar a esta función se muestra la ventana emergente con las terminaciones actuales. Por defecto, si no se especifica rect, la ventana emergente se muestra en la parte inferior de widget(). Si se especifica rect, la ventana emergente se muestra en el borde izquierdo del rectángulo.

Para el modo QCompleter::InlineCompletion, la señal highlighted() se dispara con la compleción actual.

int QCompleter::completionCount() const

Devuelve el número de terminaciones para el prefijo actual. Para un modelo sin ordenar con un gran número de elementos esto puede ser costoso. Utilice setCurrentRow() y currentCompletion() para recorrer todas las terminaciones.

QAbstractItemModel *QCompleter::completionModel() const

Devuelve el modelo de finalización. El modelo de finalización es un modelo de lista de sólo lectura que contiene todas las posibles coincidencias para el prefijo de finalización actual. El modelo de terminación se actualiza automáticamente para reflejar las terminaciones actuales.

Véase también completionPrefix y model().

QString QCompleter::currentCompletion() const

Devuelve la cadena de finalización actual. Esto incluye la completionPrefix. Cuando se utiliza junto con setCurrentRow(), se puede utilizar para iterar a través de todas las coincidencias.

Véase también setCurrentRow() y currentIndex().

QModelIndex QCompleter::currentIndex() const

Devuelve el índice del modelo de la finalización actual en completionModel().

Véase también setCurrentRow(), currentCompletion() y model().

int QCompleter::currentRow() const

Devuelve la fila actual.

Véase también setCurrentRow().

[override virtual protected] bool QCompleter::event(QEvent *ev)

Reimplementa: QObject::event(QEvent *e).

[override virtual protected] bool QCompleter::eventFilter(QObject *o, QEvent *e)

Reimplementa: QObject::eventFilter(QObject *watched, QEvent *event).

[signal] void QCompleter::highlighted(const QModelIndex &index)

Esta señal se envía cuando un elemento de popup() es resaltado por el usuario. También se envía si se llama a complete() con completionMode() establecido en QCompleter::InlineCompletion. Se indica el elemento index en completionModel().

// Connect using qOverload:
connect(completer, qOverload(&QCompleter::highlighted),
        receiver, &ReceiverClass::slot);

// Or using a lambda:
connect(completer, qOverload(&QCompleter::highlighted),
        this, [](const QModelIndex &index) { /* handle highlighted */ });

[signal] void QCompleter::highlighted(const QString &text)

Esta señal se envía cuando un elemento de popup() es resaltado por el usuario. También se envía si se llama a complete() con completionMode() establecido en QCompleter::InlineCompletion. Se indica el elemento text.

// Connect using qOverload:
connect(completer, qOverload(&QCompleter::highlighted),
        receiver, &ReceiverClass::slot);

// Or using a lambda:
connect(completer, qOverload(&QCompleter::highlighted),
        this, [](const QString &text) { /* handle highlighted */ });

QAbstractItemModel *QCompleter::model() const

Devuelve el modelo que proporciona cadenas de finalización.

Véase también setModel() y completionModel().

[virtual] QString QCompleter::pathFromIndex(const QModelIndex &index) const

Devuelve la ruta de la dirección index. El objeto completer lo utiliza para obtener el texto de finalización del modelo subyacente.

La implementación por defecto devuelve el edit role del elemento para los modelos de lista. Devuelve la ruta absoluta del archivo si el modelo es un QFileSystemModel.

Véase también splitPath().

QAbstractItemView *QCompleter::popup() const

Devuelve la ventana emergente utilizada para mostrar las finalizaciones.

Véase también setPopup().

bool QCompleter::setCurrentRow(int row)

Establece la fila actual en el row especificado. Devuelve true si tiene éxito; en caso contrario devuelve false.

Esta función puede utilizarse junto con currentCompletion() para recorrer todas las terminaciones posibles.

Véase también currentRow(), currentCompletion() y completionCount().

void QCompleter::setModel(QAbstractItemModel *model)

Establece el modelo que proporciona complementos a model. model puede ser un modelo de lista o un modelo de árbol. Si un modelo ya se ha establecido previamente y tiene el QCompleter como padre, se elimina.

Por comodidad, si model es un QFileSystemModel, QCompleter cambia su caseSensitivity por Qt::CaseInsensitive en Windows y Qt::CaseSensitive en otras plataformas.

Véase también completionModel(), modelSorting, y Handling Tree Models.

void QCompleter::setPopup(QAbstractItemView *popup)

Establece la ventana emergente utilizada para mostrar las finalizaciones en popup. QCompleter se apropia de la vista.

Un QListView se crea automáticamente cuando el completionMode() se establece en QCompleter::PopupCompletion o QCompleter::UnfilteredPopupCompletion. El popup por defecto muestra el completionColumn().

Asegúrese de que se llama a esta función antes de modificar la configuración de la vista. Esto es necesario ya que las propiedades de la vista pueden requerir que se haya establecido un modelo en la vista (por ejemplo, ocultar columnas en la vista requiere que se establezca un modelo en la vista).

Véase también popup().

void QCompleter::setWidget(QWidget *widget)

Establece el widget para el que se proporcionan los complementos en widget. Esta función se llama automáticamente cuando se establece un QCompleter en un QLineEdit utilizando QLineEdit::setCompleter() o en un QComboBox utilizando QComboBox::setCompleter(). El widget debe establecerse explícitamente cuando se proporcionan complementos para widgets personalizados.

Véase también widget(), setModel() y setPopup().

[virtual] QStringList QCompleter::splitPath(const QString &path) const

Divide el path dado en cadenas que se utilizan para coincidir en cada nivel en el model().

La implementación predeterminada de splitPath() divide una ruta de sistema de archivos basada en QDir::separator() cuando el sourceModel() es un QFileSystemModel.

Cuando se utiliza con modelos de lista, el primer elemento de la lista devuelta se utiliza para la correspondencia.

Véase también pathFromIndex() y Handling Tree Models.

QWidget *QCompleter::widget() const

Devuelve el widget para el que el objeto completer está proporcionando compleciones.

Véase también setWidget().