QFileDialog Class

Documentation des fonctions membres

QFileDialog::QFileDialog(QWidget *parent, Qt::WindowFlags flags)

Construit une boîte de dialogue de fichier avec l'adresse parent et le widget flags.

[explicit] QFileDialog::QFileDialog(QWidget *parent = nullptr, const QString &caption = QString(), const QString &directory = QString(), const QString &filter = QString())

Construit une boîte de dialogue de fichier avec les données parent et caption qui affiche initialement le contenu du répertoire spécifié directory. Le contenu du répertoire est filtré avant d'être affiché dans la boîte de dialogue, à l'aide d'une liste de filtres séparés par des points-virgules, spécifiée par filter.

[virtual noexcept] QFileDialog::~QFileDialog()

Détruit la boîte de dialogue du fichier.

[override virtual protected] void QFileDialog::accept()

Réimplémente : QDialog::accept().

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

Réimplémente : QWidget::changeEvent(QEvent *event).

[signal] void QFileDialog::currentChanged(const QString &path)

Lorsque le fichier courant change pour des opérations locales, ce signal est émis avec le nouveau nom de fichier comme paramètre path.

Voir aussi filesSelected().

[signal] void QFileDialog::currentUrlChanged(const QUrl &url)

Lorsque le fichier en cours est modifié, ce signal est émis avec la nouvelle URL du fichier comme paramètre url.

Voir aussi urlsSelected().

QDir QFileDialog::directory() const

Renvoie le répertoire actuellement affiché dans la boîte de dialogue.

Voir aussi setDirectory().

[signal] void QFileDialog::directoryEntered(const QString &directory)

Ce signal est émis pour les opérations locales lorsque l'utilisateur entre sur le site directory.

QUrl QFileDialog::directoryUrl() const

Renvoie l'url du répertoire actuellement affiché dans la boîte de dialogue.

Voir aussi setDirectoryUrl().

[signal] void QFileDialog::directoryUrlEntered(const QUrl &directory)

Ce signal est émis lorsque l'utilisateur entre sur le site directory.

[override virtual protected] void QFileDialog::done(int result)

Réimplémente : QDialog::done(int r).

[signal] void QFileDialog::fileSelected(const QString &file)

Lorsque la sélection change pour les opérations locales et que le dialogue est accepté, ce signal est émis avec la sélection (éventuellement vide) file.

Voir également currentChanged() et QDialog::Accepted.

[signal] void QFileDialog::filesSelected(const QStringList &selected)

Lorsque la sélection change pour les opérations locales et que le dialogue est accepté, ce signal est émis avec la liste (éventuellement vide) des fichiers selected.

Voir aussi currentChanged() et QDialog::Accepted.

QDir::Filters QFileDialog::filter() const

Renvoie le filtre utilisé pour l'affichage des fichiers.

Voir aussi setFilter().

[signal] void QFileDialog::filterSelected(const QString &filter)

Ce signal est émis lorsque l'utilisateur sélectionne un site filter.

[static] QString QFileDialog::getExistingDirectory(QWidget *parent = nullptr, const QString &caption = QString(), const QString &dir = QString(), QFileDialog::Options options = ShowDirsOnly)

Il s'agit d'une fonction statique de commodité qui renvoie un répertoire existant sélectionné par l'utilisateur.

QString dir = QFileDialog::getExistingDirectory(this, tr("Open Directory"),
                                                "/home",
                                                QFileDialog::ShowDirsOnly
                                                | QFileDialog::DontResolveSymlinks);

Cette fonction crée une boîte de dialogue modale sur les fichiers avec le widget parent donné. Si parent n'est pas nullptr, la boîte de dialogue est affichée centrée sur le widget parent.

Le répertoire de travail de la boîte de dialogue est défini à dir, et le titre est défini à caption. L'un ou l'autre peut être une chaîne vide, auquel cas le répertoire actuel et un titre par défaut sont utilisés respectivement.

L'argument options contient diverses options relatives à l'exécution de la boîte de dialogue. Voir l'énumération QFileDialog::Option pour plus d'informations sur les drapeaux que vous pouvez passer. Pour garantir un dialogue de fichier natif, ShowDirsOnly doit être défini.

Sous Windows et macOS, cette fonction statique utilise la boîte de dialogue de fichier native et non une QFileDialog. Cependant, la boîte de dialogue de fichier native de Windows ne prend pas en charge l'affichage des fichiers dans le sélecteur de répertoire. Vous devez passer l'option DontUseNativeDialog ou définir l'attribut d'application global AA_DontUseNativeDialogs pour afficher les fichiers à l'aide de QFileDialog.

Notez que la boîte de dialogue de fichiers native de macOS n'affiche pas de barre de titre.

Sous Unix/X11, le comportement normal de la boîte de dialogue des fichiers est de résoudre et de suivre les liens symboliques. Par exemple, si /usr/tmp est un lien symbolique vers /var/tmp, la boîte de dialogue du fichier passe à /var/tmp après avoir saisi /usr/tmp. Si options inclut DontResolveSymlinks, la boîte de dialogue des fichiers traite les liens symboliques comme des répertoires normaux.

Sous Windows, la boîte de dialogue génère une boucle modale bloquante qui ne déclenche pas de QTimers, et si parent n'est pas nullptr, la boîte de dialogue est positionnée juste en dessous de la barre de titre du parent.

Voir également getOpenFileName(), getOpenFileNames() et getSaveFileName().

[static] QUrl QFileDialog::getExistingDirectoryUrl(QWidget *parent = nullptr, const QString &caption = QString(), const QUrl &dir = QUrl(), QFileDialog::Options options = ShowDirsOnly, const QStringList &supportedSchemes = QStringList())

Il s'agit d'une fonction statique de commodité qui renvoie un répertoire existant sélectionné par l'utilisateur. Si l'utilisateur appuie sur Annuler, elle renvoie une URL vide.

Cette fonction est utilisée de la même manière que QFileDialog::getExistingDirectory(). En particulier, parent, caption, dir et options sont utilisés exactement de la même manière.

La principale différence avec QFileDialog::getExistingDirectory() réside dans la possibilité offerte à l'utilisateur de sélectionner un répertoire distant. C'est pourquoi le type de retour et le type de dir est QUrl.

L'argument supportedSchemes permet de restreindre le type d'URL que l'utilisateur peut sélectionner. C'est un moyen pour l'application de déclarer les protocoles qu'elle prend en charge pour récupérer le contenu du fichier. Une liste vide signifie qu'aucune restriction n'est appliquée (par défaut). La prise en charge des fichiers locaux (schéma "file") est implicite et toujours activée ; il n'est pas nécessaire de l'inclure dans la restriction.

Dans la mesure du possible, cette fonction statique utilise la boîte de dialogue de fichier native et non une QFileDialog. Sur les plates-formes qui ne prennent pas en charge la sélection de fichiers distants, Qt permet de sélectionner uniquement des fichiers locaux.

Voir également getExistingDirectory(), getOpenFileUrl(), getOpenFileUrls() et getSaveFileUrl().

[static] void QFileDialog::getOpenFileContent(const QString &nameFilter, const std::function<void (const QString &, const QByteArray &)> &fileOpenCompleted, QWidget *parent = nullptr)

Il s'agit d'une fonction statique de commodité qui renvoie le contenu d'un fichier sélectionné par l'utilisateur.

Utilisez cette fonction pour accéder aux fichiers locaux sur Qt for WebAssembly, si le bac à sable web restreint l'accès aux fichiers. Sa mise en œuvre permet d'afficher une boîte de dialogue de fichier native dans le navigateur, où l'utilisateur sélectionne un fichier en fonction du paramètre nameFilter.

parent est ignoré sur Qt for WebAssembly. Passez parent sur d'autres plateformes, pour faire de la fenêtre contextuelle un enfant d'un autre widget. Si la plate-forme ne prend pas en charge les boîtes de dialogue de fichiers natives, la fonction revient à QFileDialog.

La fonction est asynchrone et retourne immédiatement. Le rappel fileOpenCompleted sera appelé lorsqu'un fichier aura été sélectionné et que son contenu aura été lu en mémoire.

auto fileContentReady = [](const QString &fileName, const QByteArray &fileContent) {
    if (fileName.isEmpty()) {
        // No file was selected
    } else {
        // Use fileName and fileContent
    }
};
QFileDialog::getOpenFileContent("Images (*.png *.xpm *.jpg)",  fileContentReady);

[static] QString QFileDialog::getOpenFileName(QWidget *parent = nullptr, const QString &caption = QString(), const QString &dir = QString(), const QString &filter = QString(), QString *selectedFilter = nullptr, QFileDialog::Options options = Options())

Il s'agit d'une fonction statique de commodité qui renvoie un fichier existant sélectionné par l'utilisateur. Si l'utilisateur appuie sur Annuler, elle renvoie une chaîne de caractères nulle.

QString fileName = QFileDialog::getOpenFileName(this, tr("Open File"),
                                                "/home",
                                                tr("Images (*.png *.xpm *.jpg)"));

La fonction crée une boîte de dialogue modale sur les fichiers avec le widget parent donné. Si parent n'est pas nullptr, la boîte de dialogue est centrée sur le widget parent.

Le répertoire de travail de la boîte de dialogue est défini sur dir. Si dir contient un nom de fichier, ce dernier est sélectionné. Seuls les fichiers correspondant à l'adresse filter sont affichés. Le filtre sélectionné est selectedFilter. Les paramètres dir, selectedFilter et filter peuvent être des chaînes vides. Si vous souhaitez plusieurs filtres, séparez-les par ';;', par exemple :

"Images (*.png *.xpm *.jpg);;Text files (*.txt);;XML files (*.xml)"

L'argument options contient diverses options relatives à l'exécution de la boîte de dialogue. Voir l'énumération QFileDialog::Option pour plus d'informations sur les drapeaux que vous pouvez passer.

Le titre de la boîte de dialogue est défini à caption. Si caption n'est pas spécifié, un titre par défaut sera utilisé.

Sous Windows et macOS, cette fonction statique utilise la boîte de dialogue de fichier native et non une boîte de dialogue QFileDialog. Notez que la boîte de dialogue de fichier native de macOS n'affiche pas de barre de titre.

Sous Windows, la boîte de dialogue fait tourner une boucle d'événements modale bloquante qui ne distribue pas de QTimers, et si parent n'est pas nullptr, elle positionne la boîte de dialogue juste en dessous de la barre de titre du parent.

Sous Unix/X11, le comportement normal de la boîte de dialogue des fichiers est de résoudre et de suivre les liens symboliques. Par exemple, si /usr/tmp est un lien symbolique vers /var/tmp, la boîte de dialogue du fichier passe à /var/tmp après avoir saisi /usr/tmp. Si options inclut DontResolveSymlinks, la boîte de dialogue des fichiers traite les liens symboliques comme des répertoires normaux.

Voir également getOpenFileNames(), getSaveFileName() et getExistingDirectory().

[static] QStringList QFileDialog::getOpenFileNames(QWidget *parent = nullptr, const QString &caption = QString(), const QString &dir = QString(), const QString &filter = QString(), QString *selectedFilter = nullptr, QFileDialog::Options options = Options())

Il s'agit d'une fonction statique de commodité qui renvoie un ou plusieurs fichiers existants sélectionnés par l'utilisateur.

QStringList files = QFileDialog::getOpenFileNames(
                        this,
                        "Select one or more files to open",
                        "/home",
                        "Images (*.png *.xpm *.jpg)");

Cette fonction crée une boîte de dialogue modale avec le widget parent donné. Si parent n'est pas nullptr, la boîte de dialogue est centrée sur le widget parent.

Le répertoire de travail de la boîte de dialogue est défini sur dir. Si dir contient un nom de fichier, le fichier est sélectionné. Le filtre est défini sur filter de sorte que seuls les fichiers correspondant au filtre sont affichés. Le filtre sélectionné est selectedFilter. Les paramètres dir, selectedFilter et filter peuvent être des chaînes vides. Si vous avez besoin de plusieurs filtres, séparez-les par ';;', par exemple :

"Images (*.png *.xpm *.jpg);;Text files (*.txt);;XML files (*.xml)"

La légende de la boîte de dialogue est définie sur caption. Si caption n'est pas spécifié, une légende par défaut est utilisée.

Sous Windows et macOS, cette fonction statique utilise la boîte de dialogue de fichier native et non une QFileDialog. Notez que la boîte de dialogue de fichier native de macOS n'affiche pas de barre de titre.

Sous Windows, la boîte de dialogue fait tourner une boucle d'événement modal bloquante qui ne distribue pas de QTimers, et si parent n'est pas nullptr, elle positionne la boîte de dialogue juste en dessous de la barre de titre du parent.

Sous Unix/X11, le comportement normal de la boîte de dialogue des fichiers est de résoudre et de suivre les liens symboliques. Par exemple, si /usr/tmp est un lien symbolique vers /var/tmp, la boîte de dialogue du fichier passera à /var/tmp après avoir saisi /usr/tmp. L'argument options contient diverses options sur la manière d'exécuter la boîte de dialogue, voir l'énumération QFileDialog::Option pour plus d'informations sur les drapeaux que vous pouvez passer.

Voir aussi getOpenFileName(), getSaveFileName(), et getExistingDirectory().

[static] QUrl QFileDialog::getOpenFileUrl(QWidget *parent = nullptr, const QString &caption = QString(), const QUrl &dir = QUrl(), const QString &filter = QString(), QString *selectedFilter = nullptr, QFileDialog::Options options = Options(), const QStringList &supportedSchemes = QStringList())

Il s'agit d'une fonction statique de commodité qui renvoie un fichier existant sélectionné par l'utilisateur. Si l'utilisateur appuie sur Annuler, elle renvoie une URL vide.

Cette fonction est utilisée de la même manière que QFileDialog::getOpenFileName(). En particulier, parent, caption, dir, filter, selectedFilter et options sont utilisés exactement de la même manière.

La principale différence avec QFileDialog::getOpenFileName() réside dans la possibilité offerte à l'utilisateur de sélectionner un fichier distant. C'est pourquoi le type de retour et le type de dir est QUrl.

L'argument supportedSchemes permet de restreindre le type d'URL que l'utilisateur peut sélectionner. C'est un moyen pour l'application de déclarer les protocoles qu'elle prendra en charge pour récupérer le contenu du fichier. Une liste vide signifie qu'aucune restriction n'est appliquée (par défaut). La prise en charge des fichiers locaux (schéma "file") est implicite et toujours activée ; il n'est pas nécessaire de l'inclure dans la restriction.

Dans la mesure du possible, cette fonction statique utilise la boîte de dialogue de fichier native et non un QFileDialog. Sur les plates-formes qui ne prennent pas en charge la sélection de fichiers distants, Qt permettra de sélectionner uniquement des fichiers locaux.

Voir également getOpenFileName(), getOpenFileUrls(), getSaveFileUrl() et getExistingDirectoryUrl().

[static] QList<QUrl> QFileDialog::getOpenFileUrls(QWidget *parent = nullptr, const QString &caption = QString(), const QUrl &dir = QUrl(), const QString &filter = QString(), QString *selectedFilter = nullptr, QFileDialog::Options options = Options(), const QStringList &supportedSchemes = QStringList())

Il s'agit d'une fonction statique de commodité qui renvoie un ou plusieurs fichiers existants sélectionnés par l'utilisateur. Si l'utilisateur appuie sur Annuler, la fonction renvoie une liste vide.

Cette fonction est utilisée de la même manière que QFileDialog::getOpenFileNames(). En particulier, parent, caption, dir, filter, selectedFilter et options sont utilisés exactement de la même manière.

La principale différence avec QFileDialog::getOpenFileNames() réside dans la possibilité offerte à l'utilisateur de sélectionner des fichiers distants. C'est pourquoi le type de retour et le type de dir sont respectivement QList<QUrl> et QUrl.

L'argument supportedSchemes permet de restreindre le type d'URL que l'utilisateur peut sélectionner. C'est un moyen pour l'application de déclarer les protocoles qu'elle prend en charge pour récupérer le contenu du fichier. Une liste vide signifie qu'aucune restriction n'est appliquée (par défaut). La prise en charge des fichiers locaux (schéma "file") est implicite et toujours activée ; il n'est pas nécessaire de l'inclure dans la restriction.

Dans la mesure du possible, cette fonction statique utilise la boîte de dialogue de fichier native et non un QFileDialog. Sur les plates-formes qui ne prennent pas en charge la sélection de fichiers distants, Qt permettra de sélectionner uniquement des fichiers locaux.

Voir également getOpenFileNames(), getOpenFileUrl(), getSaveFileUrl() et getExistingDirectoryUrl().

[static] QString QFileDialog::getSaveFileName(QWidget *parent = nullptr, const QString &caption = QString(), const QString &dir = QString(), const QString &filter = QString(), QString *selectedFilter = nullptr, QFileDialog::Options options = Options())

Il s'agit d'une fonction statique de commodité qui renvoie un nom de fichier sélectionné par l'utilisateur. Le fichier ne doit pas nécessairement exister.

Elle crée une boîte de dialogue modale avec le widget parent donné. Si parent n'est pas nullptr, la boîte de dialogue sera affichée centrée sur le widget parent.

QString fileName = QFileDialog::getSaveFileName(this, tr("Save File"),
                                                "/home/jana/untitled.png",
                                                tr("Images (*.png *.xpm *.jpg)"));

Le répertoire de travail de la boîte de dialogue est défini sur dir. Si dir contient un nom de fichier, celui-ci est sélectionné. Seuls les fichiers correspondant à filter sont affichés. Le filtre sélectionné est selectedFilter. Les paramètres dir, selectedFilter et filter peuvent être des chaînes vides. Les filtres multiples sont séparés par ';;'. Par exemple :

"Images (*.png *.xpm *.jpg);;Text files (*.txt);;XML files (*.xml)"

L'argument options contient diverses options sur la manière d'exécuter la boîte de dialogue. Voir l'énumération QFileDialog::Option pour plus d'informations sur les drapeaux que vous pouvez passer.

Le filtre par défaut peut être choisi en fixant selectedFilter à la valeur souhaitée.

Le titre de la boîte de dialogue est fixé à caption. Si caption n'est pas spécifié, un titre par défaut est utilisé.

Sous Windows et macOS, cette fonction statique utilise la boîte de dialogue de fichier native et non une QFileDialog.

Sous Windows, la boîte de dialogue génère une boucle événementielle modale bloquante qui n'envoie pas de QTimers, et si parent n'est pas nullptr, elle positionne la boîte de dialogue juste en dessous de la barre de titre du parent. Sous macOS, avec sa boîte de dialogue de fichiers native, l'argument filtre est ignoré.

Sous Unix/X11, le comportement normal de la boîte de dialogue des fichiers est de résoudre et de suivre les liens symboliques. Par exemple, si /usr/tmp est un lien symbolique vers /var/tmp, la boîte de dialogue des fichiers passe à /var/tmp après avoir saisi /usr/tmp. Si options inclut DontResolveSymlinks, la boîte de dialogue des fichiers traite les liens symboliques comme des répertoires normaux.

Voir également getOpenFileName(), getOpenFileNames() et getExistingDirectory().

[static] QUrl QFileDialog::getSaveFileUrl(QWidget *parent = nullptr, const QString &caption = QString(), const QUrl &dir = QUrl(), const QString &filter = QString(), QString *selectedFilter = nullptr, QFileDialog::Options options = Options(), const QStringList &supportedSchemes = QStringList())

Il s'agit d'une fonction statique de commodité qui renvoie un fichier sélectionné par l'utilisateur. Le fichier ne doit pas nécessairement exister. Si l'utilisateur appuie sur Annuler, la fonction renvoie une URL vide.

Cette fonction est utilisée de la même manière que QFileDialog::getSaveFileName(). En particulier, parent, caption, dir, filter, selectedFilter et options sont utilisés exactement de la même manière.

La principale différence avec QFileDialog::getSaveFileName() réside dans la possibilité offerte à l'utilisateur de sélectionner un fichier distant. C'est pourquoi le type de retour et le type de dir est QUrl.

L'argument supportedSchemes permet de restreindre le type d'URL que l'utilisateur peut sélectionner. Il permet à l'application de déclarer les protocoles qu'elle prend en charge pour enregistrer le contenu du fichier. Une liste vide signifie qu'aucune restriction n'est appliquée (par défaut). La prise en charge des fichiers locaux (schéma "file") est implicite et toujours activée ; il n'est pas nécessaire de l'inclure dans la restriction.

Dans la mesure du possible, cette fonction statique utilise la boîte de dialogue de fichier native et non un QFileDialog. Sur les plates-formes qui ne prennent pas en charge la sélection de fichiers distants, Qt permettra de sélectionner uniquement des fichiers locaux.

Voir également getSaveFileName(), getOpenFileUrl(), getOpenFileUrls() et getExistingDirectoryUrl().

QStringList QFileDialog::history() const

Renvoie l'historique de navigation du dialogue de fichiers sous la forme d'une liste de chemins.

Voir aussi setHistory().

QAbstractFileIconProvider *QFileDialog::iconProvider() const

Renvoie le fournisseur d'icônes utilisé par le dialogue de fichiers.

Voir aussi setIconProvider().

QAbstractItemDelegate *QFileDialog::itemDelegate() const

Renvoie le délégué d'élément utilisé pour rendre les éléments dans les vues de la boîte de dialogue.

Voir aussi setItemDelegate().

QString QFileDialog::labelText(QFileDialog::DialogLabel label) const

Renvoie le texte affiché dans la boîte de dialogue du fichier dans l'adresse label spécifiée.

Voir aussi setLabelText().

QStringList QFileDialog::mimeTypeFilters() const

Renvoie les filtres de type MIME appliqués à ce dialogue de fichier.

Voir aussi setMimeTypeFilters().

QStringList QFileDialog::nameFilters() const

Renvoie les filtres de type de fichier appliqués à cette boîte de dialogue.

Voir aussi setNameFilters().

void QFileDialog::open(QObject *receiver, const char *member)

Cette fonction affiche le dialogue et connecte le slot spécifié par receiver et member au signal qui informe des changements de sélection. Si fileMode est ExistingFiles, il s'agit du signal filesSelected(), sinon il s'agit du signal fileSelected().

Le signal est déconnecté de l'emplacement lorsque la boîte de dialogue est fermée.

QAbstractProxyModel *QFileDialog::proxyModel() const

Renvoie le modèle proxy utilisé par la boîte de dialogue du fichier. Par défaut, aucun proxy n'est défini.

Voir aussi setProxyModel().

bool QFileDialog::restoreState(const QByteArray &state)

Restaure la présentation, l'historique et le répertoire actuel des dialogues à l'adresse state spécifiée.

Cette fonction est généralement utilisée en conjonction avec QSettings pour restaurer la taille d'une session passée.

Renvoie false en cas d'erreur

[static] void QFileDialog::saveFileContent(const QByteArray &fileContent, const QString &fileNameHint, QWidget *parent = nullptr)

Il s'agit d'une fonction statique de commodité qui enregistre fileContent dans un fichier, en utilisant un nom de fichier et un emplacement choisis par l'utilisateur. fileNameHint peut être fourni pour suggérer un nom de fichier à l'utilisateur.

Utilisez cette fonction pour enregistrer le contenu dans des fichiers locaux sur Qt for WebAssembly, si le bac à sable Web restreint l'accès aux fichiers. Sa mise en œuvre permet d'afficher une boîte de dialogue de fichier natif dans le navigateur, où l'utilisateur spécifie un fichier de sortie basé sur l'argument fileNameHint.

parent est ignoré sur Qt for WebAssembly. Passez parent sur d'autres plateformes, pour faire de la fenêtre contextuelle un enfant d'un autre widget. Si la plate-forme ne prend pas en charge les dialogues de fichiers natifs, la fonction revient à QFileDialog.

La fonction est asynchrone et retourne immédiatement.

QByteArray imageData; // obtained from e.g. QImage::save()
QFileDialog::saveFileContent(imageData, "myimage.png");

QByteArray QFileDialog::saveState() const

Sauvegarde l'état de la présentation de la boîte de dialogue, de l'historique et du répertoire courant.

Cette fonction est généralement utilisée en conjonction avec QSettings pour mémoriser la taille d'une session ultérieure. Un numéro de version est stocké dans les données.

void QFileDialog::selectFile(const QString &filename)

Sélectionne l'adresse filename dans la boîte de dialogue des fichiers.

Voir aussi selectedFiles().

void QFileDialog::selectMimeTypeFilter(const QString &filter)

Définit le type MIME actuel filter.

void QFileDialog::selectNameFilter(const QString &filter)

Définit le type de fichier actuel filter. Plusieurs filtres peuvent être transmis à filter en les séparant par des points-virgules ou des espaces.

Voir aussi setNameFilter(), setNameFilters(), et selectedNameFilter().

void QFileDialog::selectUrl(const QUrl &url)

Sélectionne l'adresse url dans la boîte de dialogue des fichiers.

Voir aussi selectedUrls().

QStringList QFileDialog::selectedFiles() const

Renvoie une liste de chaînes contenant les chemins absolus des fichiers sélectionnés dans la boîte de dialogue. Si aucun fichier n'est sélectionné, ou si le mode n'est pas ExistingFiles ou ExistingFile, selectedFiles() contient le chemin actuel dans la fenêtre de visualisation.

Voir aussi selectedNameFilter() et selectFile().

QString QFileDialog::selectedMimeTypeFilter() const

Renvoie le type de fichier que l'utilisateur a sélectionné dans la boîte de dialogue du fichier.

QString QFileDialog::selectedNameFilter() const

Renvoie le filtre que l'utilisateur a sélectionné dans la boîte de dialogue du fichier.

Voir aussi selectedFiles().

QList<QUrl> QFileDialog::selectedUrls() const

Renvoie une liste d'URL contenant les fichiers sélectionnés dans la boîte de dialogue. Si aucun fichier n'est sélectionné, ou si le mode n'est pas ExistingFiles ou ExistingFile, selectedUrls() contient le chemin actuel dans la fenêtre de visualisation.

Voir aussi selectedNameFilter() et selectUrl().

void QFileDialog::setDirectory(const QString &directory)

Définit la boîte de dialogue de fichier actuelle directory.

Voir également directory().

void QFileDialog::setDirectory(const QDir &directory)

void QFileDialog::setDirectoryUrl(const QUrl &directory)

Définit l'url actuelle de la boîte de dialogue du fichier directory.

Voir également directoryUrl() et QUuid.

void QFileDialog::setFilter(QDir::Filters filters)

Définit le filtre utilisé par le modèle à filters. Le filtre est utilisé pour spécifier le type de fichiers à afficher.

Voir aussi filter().

void QFileDialog::setHistory(const QStringList &paths)

Configure l'historique de navigation de la boîte de dialogue de fichiers pour qu'il contienne l'adresse paths.

Voir aussi history().

void QFileDialog::setIconProvider(QAbstractFileIconProvider *provider)

Définit le fournisseur d'icônes utilisé par le dialogue de fichier à l'adresse provider.

Voir aussi iconProvider().

void QFileDialog::setItemDelegate(QAbstractItemDelegate *delegate)

Définit le délégué de l'élément utilisé pour rendre les éléments dans les vues de la boîte de dialogue de fichier à l'adresse delegate.

Tout délégué existant sera supprimé, mais pas effacé. QFileDialog ne prend pas possession de delegate.

Notez que le modèle utilisé est QFileSystemModel. Il a des rôles de données d'éléments personnalisés, qui sont décrits par l'enum Roles. Vous pouvez utiliser un QFileIconProvider si vous ne voulez que des icônes personnalisées.

Voir aussi itemDelegate(), setIconProvider() et QFileSystemModel.

void QFileDialog::setLabelText(QFileDialog::DialogLabel label, const QString &text)

Définit l'adresse text affichée dans la boîte de dialogue du fichier dans l'adresse label spécifiée.

Voir aussi labelText().

void QFileDialog::setMimeTypeFilters(const QStringList &filters)

Définit le filters utilisé dans la boîte de dialogue du fichier, à partir d'une liste de types MIME.

Méthode de commodité pour setNameFilters(). Utilise QMimeType pour créer un filtre de nom à partir des motifs globaux et de la description définis dans chaque type MIME.

Utilise application/octet-stream pour le filtre "All files (*)", puisqu'il s'agit du type MIME de base pour tous les fichiers.

L'appel à setMimeTypeFilters remplace tous les filtres de noms précédemment définis et modifie la valeur de retour de nameFilters().

QStringList mimeTypeFilters({"image/jpeg", // will show "JPEG image (*.jpeg *.jpg *.jpe)
                             "image/png",  // will show "PNG image (*.png)"
                             "application/octet-stream" // will show "All files (*)"
                            });

QFileDialog dialog(this);
dialog.setMimeTypeFilters(mimeTypeFilters);
dialog.exec();

Voir aussi mimeTypeFilters().

void QFileDialog::setNameFilter(const QString &filter)

Définit le filtre utilisé dans la boîte de dialogue des fichiers à l'adresse filter.

Si filter contient une paire de parenthèses contenant un ou plusieurs motifs de filename-wildcard, séparés par des espaces, seul le texte contenu dans les parenthèses est utilisé comme filtre. Cela signifie que ces appels sont tous équivalents :

dialog.setNameFilter("All C++ files (*.cpp *.cc *.C *.cxx *.c++)");
dialog.setNameFilter("*.cpp *.cc *.C *.cxx *.c++");

Voir également setMimeTypeFilters() et setNameFilters().

void QFileDialog::setNameFilters(const QStringList &filters)

Définit le filters utilisé dans la boîte de dialogue du fichier.

Notez que le filtre *.* n'est pas portable, car l'hypothèse historique selon laquelle l'extension du fichier détermine le type de fichier n'est pas cohérente sur tous les systèmes d'exploitation. Il est possible d'avoir un fichier dont le nom ne comporte pas de point (par exemple, Makefile). Dans une boîte de dialogue de fichiers Windows, *.* correspond à de tels fichiers, alors que dans d'autres types de boîtes de dialogue de fichiers, il peut ne pas correspondre. Il est donc préférable d'utiliser * si vous souhaitez sélectionner n'importe quel fichier.

const QStringList filters({"Image files (*.png *.xpm *.jpg)",
                           "Text files (*.txt)",
                           "Any files (*)"
                          });
QFileDialog dialog(this);
dialog.setNameFilters(filters);
dialog.exec();

setMimeTypeFilters() a l'avantage de fournir tous les filtres de noms possibles pour chaque type de fichier. Par exemple, les images JPEG ont trois extensions possibles ; si votre application peut ouvrir de tels fichiers, le fait de sélectionner le type mime image/jpeg comme filtre vous permet de les ouvrir tous.

Voir également nameFilters().

void QFileDialog::setOption(QFileDialog::Option option, bool on = true)

Active l'option option si on est vrai ; sinon, efface l'option option.

Les options (en particulier l'option DontUseNativeDialog ) doivent être définies avant de modifier les propriétés de la boîte de dialogue ou de l'afficher.

La définition d'options alors que la boîte de dialogue est visible ne garantit pas un effet immédiat sur la boîte de dialogue (en fonction de l'option et de la plate-forme).

Le fait de définir des options après avoir modifié d'autres propriétés peut faire en sorte que ces valeurs n'aient aucun effet.

Voir également options et testOption().

void QFileDialog::setProxyModel(QAbstractProxyModel *proxyModel)

Définit le modèle des vues à l'adresse proxyModel. Cela est utile si vous souhaitez modifier le modèle sous-jacent, par exemple pour ajouter des colonnes, filtrer des données ou ajouter des lecteurs.

Tout modèle proxy existant est supprimé, mais pas effacé. La boîte de dialogue du fichier devient propriétaire du fichier proxyModel.

Voir également proxyModel().

void QFileDialog::setSidebarUrls(const QList<QUrl> &urls)

Définit les urls qui se trouvent dans la barre latérale.

Par exemple :

QList<QUrl> urls;
urls << QUrl::fromLocalFile("/Users/foo/Code/qt5")
     << QUrl::fromLocalFile(QStandardPaths::standardLocations(QStandardPaths::MusicLocation).first());

QFileDialog dialog;
dialog.setSidebarUrls(urls);
dialog.setFileMode(QFileDialog::AnyFile);
if (dialog.exec()) {
    // ...
}

La boîte de dialogue du fichier ressemble alors à ceci :

Voir aussi sidebarUrls().

[override virtual] void QFileDialog::setVisible(bool visible)

Réimplémente : QDialog::setVisible(bool visible).

QList<QUrl> QFileDialog::sidebarUrls() const

Retourne une liste d'urls qui sont actuellement dans la barre latérale

Voir aussi setSidebarUrls().

bool QFileDialog::testOption(QFileDialog::Option option) const

Renvoie true si le site option est activé ; sinon, renvoie false.

Voir aussi options et setOption().

[signal] void QFileDialog::urlSelected(const QUrl &url)

Lorsque la sélection change et que le dialogue est accepté, ce signal est émis avec la sélection (éventuellement vide) url.

Voir également currentUrlChanged() et QDialog::Accepted.

[signal] void QFileDialog::urlsSelected(const QList<QUrl> &urls)

Lorsque la sélection change et que le dialogue est accepté, ce signal est émis avec la liste (éventuellement vide) des urls sélectionnés.

Voir également currentUrlChanged() et QDialog::Accepted.