QCompleter Class

Documentation sur les fonctions membres

QCompleter::QCompleter(QObject *parent = nullptr)

Crée un objet « completer » à partir de l'parent on fournie.

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

Crée un objet « completer » à partir de l'parent fournie, qui propose des suggestions issues de l'model spécifiée.

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

Crée un objet QCompleter avec l'parent on fournie, qui utilise l'list on spécifiée comme source de complétions possibles.

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

Détruit l'objet « completer ».

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

Ce signal est émis lorsqu'un élément de la méthode ` popup()` est activé par l'utilisateur (en cliquant dessus ou en appuyant sur la touche Entrée). L'index s relatives à cet élément, issues de la méthode ` completionModel()`, sont fournies.

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

Ce signal est émis lorsqu'un élément de la liste « popup() » est activé par l'utilisateur (en cliquant dessus ou en appuyant sur la touche Entrée). L'text de l'élément est fournie.

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

Pour les modes « QCompleter::PopupCompletion » et « QCompletion::UnfilteredPopupCompletion », l'appel de cette fonction affiche la fenêtre contextuelle présentant les complétions actuelles. Par défaut, si « rect » n'est pas spécifié, la fenêtre contextuelle s'affiche au bas du rectangle « widget » (). Si « rect » est spécifié, la fenêtre contextuelle s'affiche sur le bord gauche du rectangle.

En mode « QCompleter::InlineCompletion », le signal highlighted() est déclenché avec la suggestion actuelle.

int QCompleter::completionCount() const

Renvoie le nombre de suggestions pour le préfixe actuel. Pour un modèle non trié contenant un grand nombre d'éléments, cette opération peut s'avérer coûteuse. Utilisez les méthodes setCurrentRow() et currentCompletion() pour parcourir toutes les suggestions.

QAbstractItemModel *QCompleter::completionModel() const

Renvoie le modèle de complétion. Le modèle de complétion est un modèle de liste en lecture seule qui contient toutes les correspondances possibles pour le préfixe de complétion actuel. Le modèle de complétion est mis à jour automatiquement pour refléter les complétions actuelles.

Voir également completionPrefix et model().

QString QCompleter::currentCompletion() const

Renvoie la chaîne de complétion actuelle. Celle-ci inclut l'completionPrefix. Utilisée conjointement avec setCurrentRow(), cette fonction permet de parcourir toutes les correspondances.

Voir également setCurrentRow() et currentIndex().

QModelIndex QCompleter::currentIndex() const

Renvoie l'index du modèle correspondant à la suggestion actuelle dans la fonction ` completionModel()`.

Voir également setCurrentRow(), currentCompletion() et model().

int QCompleter::currentRow() const

Renvoie la ligne actuelle.

Voir aussi setCurrentRow().

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

Réimplémente : QObject::event(QEvent *e).

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

Réimplémente : QObject::eventFilter(QObject *watched, QEvent *event).

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

Ce signal est émis lorsqu'un élément de la collection ` popup()` est mis en surbrillance par l'utilisateur. Il est également émis si la méthode ` complete()` est appelée avec le paramètre ` completionMode()` défini sur ` QCompleter::InlineCompletion`. L'index ` de l'élément dans la collection ` completionModel()` est fournie.

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

Ce signal est émis lorsqu'un élément de la collection ` popup()` est mis en surbrillance par l'utilisateur. Il est également émis si la méthode ` complete()` est appelée avec le paramètre ` completionMode()` défini sur ` QCompleter::InlineCompletion`. L'text ` de l'élément est fourni.

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

Renvoie le modèle qui fournit les chaînes de complétion.

Voir également setModel() et completionModel().

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

Renvoie le chemin d'accès de l'index donné. L'objet « completer » l'utilise pour obtenir le texte de complétion à partir du modèle sous-jacent.

L'implémentation par défaut renvoie l'edit role de l'élément pour les modèles de liste. Elle renvoie le chemin d'accès absolu du fichier si le modèle est de type QFileSystemModel.

Voir également ` splitPath()` .

QAbstractItemView *QCompleter::popup() const

Renvoie la fenêtre contextuelle utilisée pour afficher les suggestions.

Voir aussi setPopup().

bool QCompleter::setCurrentRow(int row)

Définit la ligne courante sur l'row spécifiée. Renvoie « true » en cas de succès ; sinon, renvoie « false ».

Cette fonction peut être utilisée conjointement avec currentCompletion() pour parcourir toutes les complétions possibles.

Voir également currentRow(), currentCompletion() et completionCount().

void QCompleter::setModel(QAbstractItemModel *model)

Définit le modèle qui fournit les suggestions pour model. L’ model peut être un modèle de liste ou un modèle arborescent. Si un modèle a déjà été défini auparavant et que QCompleter lui sert de parent, il est supprimé.

Pour plus de commodité, si model est un QFileSystemModel, QCompleter modifie son caseSensitivity pour le remplacer par Qt::CaseInsensitive sous Windows et par Qt::CaseSensitive sur les autres plateformes.

Voir également completionModel(), modelSorting et Handling Tree Models.

void QCompleter::setPopup(QAbstractItemView *popup)

Définit la fenêtre contextuelle utilisée pour afficher les suggestions sur popup. QCompleter prend en charge la gestion de la vue.

Un ` QListView ` est automatiquement créé lorsque la méthode ` completionMode()` est définie sur ` QCompleter::PopupCompletion ` ou ` QCompleter::UnfilteredPopupCompletion`. La fenêtre contextuelle par défaut affiche la méthode ` completionColumn()`.

Assurez-vous que cette fonction soit appelée avant toute modification des paramètres de la vue. Cela est nécessaire car certaines propriétés de la vue peuvent exiger qu’un modèle y soit défini (par exemple, pour masquer des colonnes dans la vue, il faut qu’un modèle y soit défini).

Voir également popup().

void QCompleter::setWidget(QWidget *widget)

Définit le widget pour lequel des suggestions sont fournies sur widget. Cette fonction est automatiquement appelée lorsqu’un « QCompleter » est défini sur un « QLineEdit » à l’aide de QLineEdit::setCompleter() ou sur un « QComboBox » à l’aide de QComboBox::setCompleter(). Le widget doit être défini explicitement lorsque des suggestions sont fournies pour des widgets personnalisés.

Voir également widget(), setModel() et setPopup().

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

Divise l'path on fournie en chaînes de caractères utilisées pour la mise en correspondance à chaque niveau dans la fonction ` model()`.

L'implémentation par défaut de splitPath() divise un chemin d'accès au système de fichiers en fonction de QDir::separator() lorsque sourceModel() est un QFileSystemModel.

Lorsqu’elle est utilisée avec des modèles de liste, le premier élément de la liste renvoyée est utilisé pour la correspondance.

Voir également ` pathFromIndex()` et ` Handling Tree Models`.

QWidget *QCompleter::widget() const

Renvoie le widget pour lequel l'objet « completer » fournit des suggestions.

Voir également setWidget().