QCompleter Class

Documentation des fonctions membres

QCompleter::QCompleter(QObject *parent = nullptr)

Construit un objet compléteur avec l'adresse parent.

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

Construit un objet compléteur avec l'adresse parent donnée, qui fournit des compléments à partir de l'adresse model spécifiée.

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

Construit un objet QCompleter avec l'adresse parent donnée, qui utilise l'adresse list spécifiée comme source de complétions possibles.

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

Détruit l'objet compléteur.

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

Ce signal est envoyé lorsqu'un élément du site popup() est activé par l'utilisateur. (en cliquant ou en appuyant sur return). L'adresse index de l'élément dans completionModel() est donnée.

// 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 envoyé lorsqu'un élément du site popup() est activé par l'utilisateur (en cliquant ou en appuyant sur la touche retour). L'adresse text de l'élément est donnée.

// 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 à cette fonction permet d'afficher la popup affichant les complétions en cours. Par défaut, si rect n'est pas spécifié, la fenêtre contextuelle est affichée au bas de la page widget(). Si rect est spécifié, la fenêtre contextuelle est affichée sur le bord gauche du rectangle.

Pour le mode QCompleter::InlineCompletion, le signal highlighted() est émis avec l'achèvement en cours.

int QCompleter::completionCount() const

Renvoie le nombre de compléments pour le préfixe actuel. Pour un modèle non trié comportant un grand nombre d'éléments, cette fonction peut s'avérer coûteuse. Utilisez setCurrentRow() et currentCompletion() pour parcourir toutes les complétions.

QAbstractItemModel *QCompleter::completionModel() const

Renvoie le modèle d'achèvement. 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 aussi completionPrefix et model().

QString QCompleter::currentCompletion() const

Renvoie la chaîne de complétion actuelle. Cela inclut la chaîne completionPrefix. Lorsqu'elle est utilisée avec setCurrentRow(), elle peut être utilisée pour itérer à travers toutes les correspondances.

Voir aussi setCurrentRow() et currentIndex().

QModelIndex QCompleter::currentIndex() const

Renvoie l'index du modèle de l'achèvement actuel dans le site completionModel().

Voir aussi 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 envoyé lorsqu'un élément de popup() est mis en évidence par l'utilisateur. Il est également envoyé si complete() est appelé alors que completionMode() a la valeur QCompleter::InlineCompletion. L'élément index dans completionModel() est donné.

// 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 envoyé lorsqu'un élément de popup() est mis en évidence par l'utilisateur. Il est également envoyé si complete() est appelé alors que completionMode() a la valeur QCompleter::InlineCompletion. La valeur text de l'élément est donnée.

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

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

Voir aussi setModel() et completionModel().

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

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

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

Voir également splitPath().

QAbstractItemView *QCompleter::popup() const

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

Voir aussi setPopup().

bool QCompleter::setCurrentRow(int row)

Définit la ligne actuelle à l'adresse row spécifiée. Renvoie true en cas de succès, sinon false.

Cette fonction peut être utilisée avec currentCompletion() pour itérer à travers toutes les complétions possibles.

Voir aussi currentRow(), currentCompletion() et completionCount().

void QCompleter::setModel(QAbstractItemModel *model)

Définit le modèle qui fournit des compléments à model. model peut être un modèle de liste ou un modèle d'arbre. Si un modèle a déjà été défini précédemment et qu'il a pour parent QCompleter, il est supprimé.

Par commodité, si model est un QFileSystemModel, QCompleter remplace son caseSensitivity par Qt::CaseInsensitive sous Windows et Qt::CaseSensitive sur les autres plates-formes.

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

void QCompleter::setPopup(QAbstractItemView *popup)

Définit la fenêtre contextuelle utilisée pour afficher les compléments à popup. QCompleter prend la propriété de la vue.

Une fenêtre QListView est automatiquement créée lorsque completionMode() est défini sur QCompleter::PopupCompletion ou QCompleter::UnfilteredPopupCompletion. La fenêtre contextuelle par défaut affiche completionColumn().

Assurez-vous que cette fonction est appelée avant que les paramètres de la vue ne soient modifiés. Cela est nécessaire car les propriétés de la vue peuvent exiger qu'un modèle ait été défini sur la vue (par exemple, le masquage de colonnes dans la vue exige qu'un modèle soit défini sur la vue).

Voir aussi popup().

void QCompleter::setWidget(QWidget *widget)

Définit le widget pour lequel des compléments sont fournis à 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 compléments sont fournis pour des widgets personnalisés.

Voir aussi widget(), setModel() et setPopup().

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

Fractionne l'adresse path donnée en chaînes de caractères qui sont utilisées pour établir des correspondances à chaque niveau de l'adresse model().

L'implémentation par défaut de splitPath() divise un chemin de système de fichiers basé sur QDir::separator() lorsque le 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 compléments.

Voir aussi setWidget().