QCompleter Class

Dokumentation zu den Member-Funktionen

QCompleter::QCompleter(QObject *parent = nullptr)

Erstellt ein „Completer“-Objekt mit der angegebenen „ parent “.

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

Erstellt ein „Completer“-Objekt mit dem angegebenen „ parent “, das Vervollständigungsvorschläge aus dem angegebenen „ model “ bereitstellt.

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

Erstellt ein QCompleter-Objekt mit dem angegebenen „ parent “, das die angegebene „ list “ als Quelle für mögliche Vervollständigungen verwendet.

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

Löscht das „completer“-Objekt.

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

Dieses Signal wird gesendet, wenn ein Element im „ popup “ () vom Benutzer aktiviert wird (durch Klicken oder Drücken der Eingabetaste). Dabei wird die „ index “ des Elements im „ completionModel “ () übermittelt.

// 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)

Dieses Signal wird ausgelöst, wenn ein Element im „ popup()“ vom Benutzer aktiviert wird (durch Klicken oder Drücken der Eingabetaste). Die ID des Elements („ text “) wird übergeben.

// 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())

In den Modi „ QCompleter::PopupCompletion “ und „QCompletion::UnfilteredPopupCompletion“ wird durch den Aufruf dieser Funktion das Popup-Fenster mit den aktuellen Vervollständigungsvorschlägen angezeigt. Standardmäßig wird das Popup-Fenster am unteren Rand des Rechtecks „ widget()“ angezeigt, sofern „ rect “ nicht angegeben ist. Ist „ rect “ angegeben, wird das Popup-Fenster am linken Rand des Rechtecks angezeigt.

Im Modus „ QCompleter::InlineCompletion “ wird das Signal „ highlighted “ () mit der aktuellen Vervollständigung ausgelöst.

int QCompleter::completionCount() const

Gibt die Anzahl der Vervollständigungsvorschläge für das aktuelle Präfix zurück. Bei einem unsortierten Modell mit einer großen Anzahl von Elementen kann dies rechenintensiv sein. Verwenden Sie „ setCurrentRow()“ und „ currentCompletion()“, um alle Vervollständigungsvorschläge durchzugehen.

QAbstractItemModel *QCompleter::completionModel() const

Gibt das Vervollständigungsmodell zurück. Das Vervollständigungsmodell ist ein schreibgeschütztes Listenmodell, das alle möglichen Übereinstimmungen für das aktuelle Vervollständigungspräfix enthält. Das Vervollständigungsmodell wird automatisch aktualisiert, um die aktuellen Vervollständigungen widerzuspiegeln.

Siehe auch ` completionPrefix ` und ` model()`.

QString QCompleter::currentCompletion() const

Gibt die aktuelle Vervollständigungszeichenfolge zurück. Diese enthält den „ completionPrefix “. In Verbindung mit „ setCurrentRow()“ kann damit eine Iteration über alle Übereinstimmungen durchgeführt werden.

Siehe auch „ setCurrentRow()“ und „ currentIndex()“.

QModelIndex QCompleter::currentIndex() const

Gibt den Modellindex der aktuellen Vervollständigung in der Funktion „ completionModel()“ zurück.

Siehe auch setCurrentRow(), currentCompletion() und model().

int QCompleter::currentRow() const

Gibt die aktuelle Zeile zurück.

Siehe auch „ setCurrentRow()“.

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

Implementiert: ` QObject::event(QEvent *e)`.

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

Implementiert neu: ` QObject::eventFilter` (`QObject *watched, QEvent *event`).

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

Dieses Signal wird ausgelöst, wenn ein Element in der ` popup()` vom Benutzer markiert wird. Es wird außerdem ausgelöst, wenn ` complete()` aufgerufen wird und dabei ` completionMode()` auf ` QCompleter::InlineCompletion` gesetzt ist. Die ` index ` des Elements in der ` completionModel()` wird übergeben.

// 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)

Dieses Signal wird ausgelöst, wenn ein Element in der ` popup()` vom Benutzer markiert wird. Es wird außerdem ausgelöst, wenn ` complete()` aufgerufen wird und dabei ` completionMode()` auf ` QCompleter::InlineCompletion` gesetzt ist. Die ` text ` des Elements wird übergeben.

// 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

Gibt das Modell zurück, das Vervollständigungszeichenfolgen bereitstellt.

Siehe auch setModel() und completionModel().

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

Gibt den Pfad für das angegebene Element „ index “ zurück. Das Completer-Objekt verwendet diesen, um den Vervollständigungstext aus dem zugrunde liegenden Modell abzurufen.

Die Standardimplementierung gibt bei Listenmodellen den „ edit role “ des Elements zurück. Handelt es sich bei dem Modell um ein „ QFileSystemModel “, wird der absolute Dateipfad zurückgegeben.

Siehe auch ` splitPath()`.

QAbstractItemView *QCompleter::popup() const

Gibt das Popup zurück, das zur Anzeige von Vervollständigungsvorschlägen verwendet wird.

Siehe auch „ setPopup()“.

bool QCompleter::setCurrentRow(int row)

Setzt die aktuelle Zeile auf den angegebenen Wert „ row “. Gibt bei Erfolg „ true “ zurück; andernfalls wird „ false “ zurückgegeben.

Diese Funktion kann zusammen mit ` currentCompletion()` verwendet werden, um alle möglichen Vervollständigungen durchzugehen.

Siehe auch „ currentRow()“, „ currentCompletion()“ und „ completionCount()“.

void QCompleter::setModel(QAbstractItemModel *model)

Legt das Modell fest, das Vervollständigungsvorschläge für „ model “ bereitstellt. Die „ model “ kann ein Listenmodell oder ein Baummodell sein. Wenn bereits zuvor ein Modell festgelegt wurde und dieses „ QCompleter “ als übergeordnetes Element hat, wird es gelöscht.

Der Einfachheit halber ändert „ QCompleter “, sofern „ model “ ein „ QFileSystemModel “ ist, dessen „ caseSensitivity “ unter Windows auf „ Qt::CaseInsensitive “ und auf anderen Plattformen auf „ Qt::CaseSensitive “.

Siehe auch completionModel(), modelSorting und Handling Tree Models.

void QCompleter::setPopup(QAbstractItemView *popup)

Legt das Popup zur Anzeige von Vervollständigungsvorschlägen auf „ popup “ fest. „ QCompleter “ übernimmt die Verantwortung für die Ansicht.

Ein „ QListView “ wird automatisch erstellt, wenn „ completionMode()“ auf „ QCompleter::PopupCompletion “ oder „ QCompleter::UnfilteredPopupCompletion “ gesetzt wird. Das Standard-Popup zeigt „ completionColumn()“ an.

Stellen Sie sicher, dass diese Funktion aufgerufen wird, bevor die Ansichtseinstellungen geändert werden. Dies ist erforderlich, da die Eigenschaften der Ansicht möglicherweise voraussetzen, dass der Ansicht ein Modell zugewiesen wurde (beispielsweise erfordert das Ausblenden von Spalten in der Ansicht, dass der Ansicht ein Modell zugewiesen wurde).

Siehe auch popup().

void QCompleter::setWidget(QWidget *widget)

Setzt das Widget, für das Vervollständigungen bereitgestellt werden, auf „ widget “. Diese Funktion wird automatisch aufgerufen, wenn ein „ QCompleter “ über „ QLineEdit::setCompleter()“ auf einem „ QLineEdit “ oder über „ QComboBox::setCompleter()“ auf einem „ QComboBox “ festgelegt wird. Bei der Bereitstellung von Vervollständigungen für benutzerdefinierte Widgets muss das Widget explizit festgelegt werden.

Siehe auch widget(), setModel() und setPopup().

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

Teilt den angegebenen „ path “ in Zeichenfolgen auf, die für den Abgleich auf jeder Ebene in der Funktion „ model()“ verwendet werden.

Die Standardimplementierung von splitPath() teilt einen Dateisystempfad auf der Grundlage von ` QDir::separator()` auf, wenn `sourceModel()` ein ` QFileSystemModel` ist.

Bei Verwendung mit Listenmodellen wird das erste Element der zurückgegebenen Liste für den Abgleich verwendet.

Siehe auch ` pathFromIndex()` und ` Handling Tree Models`.

QWidget *QCompleter::widget() const

Gibt das Widget zurück, für das das Completer-Objekt Vervollständigungsvorschläge bereitstellt.

Siehe auch „ setWidget()“.