QFileDialog

La classe QFileDialog fournit une boîte de dialogue qui permet aux utilisateurs de sélectionner des fichiers ou des répertoires. Plus d'informations...

 #include <QFileDialog>

Héritage

Hérite de QDialog.

Description détaillée

La classe QFileDialog fournit une boîte de dialogue qui permet aux utilisateurs de sélectionner des fichiers ou des répertoires.

La classe QFileDialog permet à l'utilisateur de naviguer à travers le système de fichier afin de sélectionner un ou plusieurs fichiers ou répertoires.

La manière la plus simple de créer une QFileDialog est d'utiliser les fonctions statiques. Sous Windows, Mac OS X, KDE et GNOME, ces fonctions statiques appelleront si possible la boîte de dialogue native.

 fileName = QFileDialog::getOpenFileName(this,
     tr("Open Image"), "/home/jana", tr("Image Files (*.png *.jpg *.bmp)"));

Dans l'exemple ci-dessus, une boîte modale QFileDialog est créée en utilisant une fonction statique. La boîte de dialogue affiche initialement le contenu du répertoire /home/jana et affiche les fichiers correspondant aux masques donnés par la chaîne « Image Files (*.png *.jpg *.bmp) ». Le parent de la boîte de dialogue est défini à this et le titre de la fenêtre à « Open Image ».

Si vous voulez utiliser plusieurs filtres, séparez-les avec deux points-virgules. Par exemple :

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

Vous pouvez créer votre propre QFileDialog sans utiliser les fonctions statiques. En appelant setFileMode(), vous pouvez spécifier ce que l'utilisateur doit sélectionner dans la boîte de dialogue :

 QFileDialog dialog(this);
 dialog.setFileMode(QFileDialog::AnyFile);

Dans l'exemple ci-dessus, le mode de la boite de dialogue est défini à AnyFile, ce qui signifie que l'utilisateur peut sélectionner un fichier quelconque ou même spécifier un fichier qui n'existe pas. Ce mode est utile pour la création d'une boîte de dialogue « Enregistrer sous ». Utilisez ExistingFile si l'utilisateur doit sélectionner un fichier existant ou Directory si la sélection est limitée aux répertoires. Voir l'énumération QFileDialog::FileMode pour une liste complète des modes.

La propriété fileMode contient le mode opératoire de la boîte de dialogue ; il indique quels types d'objets l'utilisateur peut sélectionner. Utilisez setNameFilter() pour définir le filtre de fichiers de la boîte. Par exemple :

 dialog.setNameFilter(tr("Images (*.png *.xpm *.jpg)"));

Dans l'exemple ci-dessus, le filtre est défini comme « Images (*.png *.xpm *.jpg) », ce qui signifie que seuls les fichiers avec une extension png, xpm ou jpg seront affichés dans la QFileDialog. Vous pouvez appliquer plusieurs filtres en utilisant setNameFilters(). Utilisez selectNameFilter() pour sélectionner l'un des filtres que vous avez donnés comme filtre par défaut de la boîte.

La boîte de dialogue de fichiers possède deux modes d'affichage : List et Detail. List présente le contenu du répertoire courant sous la forme d'une liste de noms de fichiers et de répertoires. Detail affiche également une liste de noms de fichiers et de répertoires mais fournit des informations supplémentaires pour chaque nom, comme la taille du fichier et la date de modification. Définissez le mode avec setViewMode() :

 dialog.setViewMode(QFileDialog::Detail);

La dernière fonction importante que vous aurez besoin d'utiliser pour créer votre propre boîte de dialogue est selectedFiles().

 QStringList fileNames;
 if (dialog.exec())
     fileNames = dialog.selectedFiles();

Dans l'exemple ci-dessus, une boîte de dialogue modale est créée et affichée. Si l'utilisateur a cliqué sur OK, le fichier sélectionné sera enregistré dans fileName.

Le répertoire de travail de la boîte de dialogue peut être défini avec setDirectory(). Tous les fichiers du répertoire courant peuvent être sélectionnés en utilisant la fonction selectFile().

L'exemple Boîtes de dialogue standard montre comment utiliser QFileDialog ainsi que deux autres types de boîtes de dialogue intégrées dans Qt.

Voir aussi QDir, QFileInfo, QFile, QPrintDialog, QColorDialog, QFontDialog, Boîtes de dialogue standard et Exemple d'application.

Type

enum QFileDialog::AcceptMode

enum QFileDialog::DialogLabel

enum QFileDialog::FileMode

Cette énumération est utilisée pour indiquer ce que l'utilisateur peut sélectionner dans la boîte de dialogue, c'est-à-dire ce que la boîte retourne si l'utilisateur clique sur OK.

Cette valeur est obsolète depuis Qt 4.5 :

Voir aussi setFileMode().

typedef QFileDialog::Mode

Utilisez QFileDialog::FileMode à la place.

enum QFileDialog::Optionflags QFileDialog::Options

Le type Options est un typedef pour QFlags<Option>. Il stocke une combinaison OU de valeurs Option.

enum QFileDialog::ViewMode

Cette énumération décrit le mode d'affichage de la boîte de dialogue, c'est-à-dire les informations sur les fichiers qui seront affichées.

Voir aussi setViewMode().

Propriétés

acceptMode : AcceptMode

Cette propriété contient le mode d'acceptation de la boîte de dialogue.

Le mode d'action définit si la boîte de dialogue ouvre ou sauvegarde les fichiers.

Par défaut, cette propriété est définie à AcceptOpen.

Fonction d'accès

AcceptMode acceptMode () const

void setAcceptMode ( AcceptMode mode )

Voir aussi AcceptMode.

defaultSuffix : QString

Cette propriété contient le suffixe ajouté au nom de fichier si aucun autre suffixe n'a été spécifié.

Cette propriété spécifie une chaîne qui sera ajoutée au nom de fichier s'il n'a pas déjà de suffixe. Le suffixe est typiquement utilisé pour indiquer le type de fichier (par exemple, « txt » indique un fichier texte).

Fonction d'accès

QString defaultSuffix () const

void setDefaultSuffix ( const QString & suffix )

fileMode : FileMode

Cette propriété contient le mode de fichier de la boîte de dialogue.

Le mode de fichier définit le nombre et le type des éléments que l'utilisateur doit sélectionner dans la boîte de dialogue.

Par défaut, cette propriété est définie à AnyFile.

Cette fonction définira les libellés pour FileName et Accept DialogLabels. Il est possible de définir des textes personnalisés après l'appel à setFileMode().

Fonction d'accès

FileMode fileMode () const

void setFileMode ( FileMode mode )

Voir aussi FileMode.

options : Options

Cette propriété contient les diverses options affectant l'apparence de la boîte de dialogue.

Par défaut, toutes les options sont désactivées.

Options doivent être définies avant l'affichage de la boîte de dialogue. Si elles sont définies alors que la boîte de dialogue est visible, il n'est pas garanti qu'elles aient un effet immédiat sur la boîte de dialogue (suivant l'option et la plateforme).

Cette classe a été introduite dans Qt 4.5.

Fonction d'accès

Options options () const

void setOptions ( Options options )

Voir aussi setOption() et testOption().

viewMode : ViewMode

Cette propriété contient la façon dont les fichiers et les répertoires sont affichés dans la boîte de dialogue.

Par défaut, le mode Detail est utilisé pour afficher les informations des fichiers et des répertoires.

Fonction d'accès

ViewMode viewMode () const

void setViewMode ( ViewMode mode )

Voir aussi ViewMode.

Fonctions membres

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

Construit une boîte de dialogue de fichiers avec le parent parent et les drapeaux de widget flags.

QFileDialog::QFileDialog ( QWidget * parent = 0, const QString & caption = QString(), const QString & directory = QString(), const QString & filter = QString() )

Construit une boîte de dialogue de fichiers avec les parent et caption (titre) donnés qui affiche initialement le contenu du répertoire directory donné. Le contenu du répertoire est filtré avant d'être affiché dans la boîte de dialogue, en utilisant une liste de filtres avec séparateur point-virgule spécifiée par filter.

QFileDialog::~QFileDialog ()

Détruit la boîte de dialogue.

void QFileDialog::accept () [virtual protected]

Réimplémentation de QDialog::accept().

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

Réimplémentation de QWidget::changeEvent().

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

Lorsque le fichier courant change, ce signal est émis avec le nouveau nom de fichier dans le paramètre path.

Voir aussi filesSelected().

QDir QFileDialog::directory () const

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

Voir aussi setDirectory().

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

Ce signal est émis lorsque l'utilisateur entre dans directory.

Cette fonction a été introduite dans Qt 4.3.

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

Réimplémentation de QDialog::done().

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

Lorsque la sélection change et que la boîte de dialogue est acceptée, ce signal est émis avec le fichier file sélectionné, éventuellement vide.

Voir aussi currentChanged() et QDialog::Accepted.

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

Lorsque la sélection change et que la boîte de dialogue est acceptée, ce signal est émis avec la liste selected des fichiers sélectionnés, éventuellement vide.

Voir aussi currentChanged() et QDialog::Accepted.

QDir::Filters QFileDialog::filter () const

Renvoie le filtre utilisé pour afficher les fichiers.

Cette fonction a été introduite dans Qt 4.4.

Voir aussi setFilter().

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

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

Cette fonction a été introduite dans Qt 4.3.

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

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 de fichiers modale avec le widget parent donné. Si parent est différent de 0, la boîte de dialogue sera 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. Les deux peuvent être vides, auquel cas le répertoire courant et un titre par défaut seront respectivement utilisés.

L'argument options contient diverses options d'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 une boîte de dialogue native, ShowDirsOnly doit être spécifié.

Sur Windows, Mac OS X et Symbian^3, cette fonction statique utilisera la boîte de dialogue native et non une QFileDialog. Sur Windows CE, si l'appareil ne possède pas de boîte de dialogue de fichiers native, une QFileDialog sera utilisée.

Sur Unix/X11, le comportement normal de la boîte de dialogue est de résoudre et de suivre les liens symboliques (symlinks). Par exemple, si /usr/tmp est un symlink vers /var/tmp, la boîte de dialogue passera à /var/tmp à l'entrée dans /usr/tmp. Si options inclut DontResolveSymlinks, la boîte de dialogue traitera les symlinks comme des répertoires normaux.

Sur Windows la boîte de dialogue lancera une boucle d'évènements modale bloquante qui ne transmettra pas les QTimer et, si parent est différent de 0, positionnera la boîte de dialogue juste en dessous de la barre de titre du parent.

Sur Symbian^3 le paramètre options est seulement utilisé pour spécifier si la boîte de dialogue native est utilisée.

Attention : ne détruisez pas parent pendant l'exécution de la boîte de dialogue. Si vous voulez le faire, vous devez créer la boîte de dialogue vous-même en utilisant un des constructeurs de QFileDialog.

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

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

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 nulle.

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

Cette fonction crée une boîte de dialogue de fichiers modale avec le widget parent donné. Si parent est différent de 0, la boîte de dialogue sera affichée centrée sur le widget parent.

Le répertoire de travail de la boîte de dialogue est défini à dir. Si dir inclut un nom de fichier, le fichier sera sélectionné. Seuls les fichiers correspondant au filtre filter donné sont affichés. Le filtre sélectionné est défini à selectedFilter. Les paramètres dir, selectedFilter et filter peuvent être des chaînes vides. Si vous voulez des filtres multiples, séparez-les avec ';;›, par exemple :

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

L'argument options contient diverses options d'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é.

Sur Windows, Mac OS X et Symbian^3, cette fonction statique utilisera la boîte de dialogue native et non une QFileDialog.

Sur Windows la boîte de dialogue lancera une boucle d'évènements modale bloquante qui ne transmettra pas les QTimer et, si parent est différent de 0, positionnera la boîte de dialogue juste en dessous de la barre de titre du parent.

Sur Unix/X11, le comportement normal de la boîte de dialogue est de résoudre et de suivre les liens symboliques (symlinks). Par exemple, si /usr/tmp est un symlink vers /var/tmp, la boîte de dialogue passera à /var/tmp à l'entrée dans /usr/tmp. Si options inclut DontResolveSymlinks, la boîte de dialogue traitera les symlinks comme des répertoires normaux.

Sur Symbian^3 le paramètre selectedFilter n'a pas de signification et le paramètre options est seulement utilisé pour spécifier si la boîte de dialogue native est utilisée.

Attention : ne détruisez pas parent pendant l'exécution de la boîte de dialogue. Si vous voulez le faire, vous devez créer la boîte de dialogue vous-même en utilisant un des constructeurs de QFileDialog.

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

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

Il s'agit d'une fonction statique de commodité qui renvoie un ou plusieurs fichier(s) existant(s) 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 de fichiers modale avec le widget parent donné. Si parent est différent de 0, la boîte de dialogue sera affichée centrée sur le widget parent.

Le répertoire de travail de la boîte de dialogue est défini à dir. Si dir inclut un nom de fichier, le fichier sera sélectionné. Seuls les fichiers correspondant au filtre filter donné sont affichés. Le filtre sélectionné est défini à selectedFilter. Les paramètres dir, selectedFilter et filter peuvent être des chaînes vides. Si vous voulez des filtres multiples, séparez-les avec ';;›, par exemple :

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

L'argument options contient diverses options d'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é.

Sur Windows, Mac OS X et Symbian^3, cette fonction statique utilisera la boîte de dialogue native et non une QFileDialog.

Sur Windows la boîte de dialogue lancera une boucle d'évènements modale bloquante qui ne transmettra pas les QTimer et, si parent est différent de 0, positionnera la boîte de dialogue juste en dessous de la barre de titre du parent.

Sur Unix/X11, le comportement normal de la boîte de dialogue est de résoudre et de suivre les liens symboliques (symlinks). Par exemple, si /usr/tmp est un symlink vers /var/tmp, la boîte de dialogue passera à /var/tmp à l'entrée dans /usr/tmp. Si options inclut DontResolveSymlinks, la boîte de dialogue traitera les symlinks comme des répertoires normaux.

Note : si vous voulez itérer sur la liste des fichiers, vous devez itérer sur une copie. Par exemple :

 QStringList list = files;
 QStringList::Iterator it = list.begin();
 while(it != list.end()) {
     myProcessing(*it);
     ++it;
 }

Sur Symbian^3 le paramètre selectedFilter n'a pas de signification et le paramètre options est seulement utilisé pour spécifier si la boîte de dialogue native est utilisée.

Attention : ne détruisez pas parent pendant l'exécution de la boîte de dialogue. Si vous voulez le faire, vous devez créer la boîte de dialogue vous-même en utilisant un des constructeurs de QFileDialog.

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

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

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

Cette fonction crée une boîte de dialogue de fichiers modale avec le widget parent donné. Si parent est différent de 0, 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 à dir. Si dir inclut un nom de fichier, le fichier sera sélectionné. Seuls les fichiers correspondant au filtre filter donné sont affichés. Le filtre sélectionné est défini à selectedFilter. Les paramètres dir, selectedFilter et filter peuvent être des chaînes vides. Si vous voulez des filtres multiples, séparez-les avec ';;›, par exemple :

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

L'argument options contient diverses options d'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 filtre par défaut peut être choisi en spécifiant la valeur désirée pour selectedFilter.

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é.

Sur Windows, Mac OS X et Symbian^3, cette fonction statique utilisera la boîte de dialogue native et non une QFileDialog.

Sur Windows la boîte de dialogue lancera une boucle d'évènements modale bloquante qui ne transmettra pas les QTimer et, si parent est différent de 0, positionnera la boîte de dialogue juste en dessous de la barre de titre du parent.

Sur Unix/X11, le comportement normal de la boîte de dialogue est de résoudre et de suivre les liens symboliques (symlinks). Par exemple, si /usr/tmp est un symlink vers /var/tmp, la boîte de dialogue passera à /var/tmp à l'entrée dans /usr/tmp. Si options inclut DontResolveSymlinks, la boîte de dialogue traitera les symlinks comme des répertoires normaux.

Sur Symbian^3 les paramètres filter et selectedFilter n'ont pas de signification et le paramètre options est seulement utilisé pour spécifier si la boîte de dialogue native est utilisée.

Attention : ne détruisez pas parent pendant l'exécution de la boîte de dialogue. Si vous voulez le faire, vous devez créer la boîte de dialogue vous-même en utilisant un des constructeurs de QFileDialog.

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

QStringList QFileDialog::history () const

Renvoie l'historique de navigation de la boîte de dialogue sous la forme d'une liste de chemins.

Voir aussi setHistory().

QFileIconProvider * QFileDialog::iconProvider () const

Renvoie le fournisseur d'icône utilisé par la boîte de dialogue.

Voir aussi setIconProvider().

QAbstractItemDelegate * QFileDialog::itemDelegate () const

Renvoie le délégué utilisé pour dessiner les éléments des vues dans la boîte de dialogue.

Voir aussi setItemDelegate().

QString QFileDialog::labelText ( DialogLabel label ) const

Renvoie le texte affiché dans la boîte de dialogue pour le libellé label spécifié.

Voir aussi setLabelText().

QStringList QFileDialog::nameFilters () const

Renvoie les filtres de types de fichiers actifs pour cette boîte de dialogue.

Cette fonction a été introduite dans Qt 4.4.

Voir aussi setNameFilters().

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

Il s'agit d'une fonction surchargée.

Cette fonction connecte un des signaux de la boîte au slot spécifié par receiver et member. Le signal spécifique est filesSelected() si fileMode est ExistingFiles et fileSelected() si fileMode a une autre valeur.

Le signal sera déconnecté du slot lorsque la boîte de dialogue sera fermée.

Cette fonction a été introduite dans Qt 4.5.

QAbstractProxyModel * QFileDialog::proxyModel () const

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

Voir aussi setProxyModel().

bool QFileDialog::restoreState ( const QByteArray & state )

Restaure la disposition, l'historique et le répertoire courant à l'état state spécifié.

Cette fonction est typiquement utilisée en conjonction avec des QSettings pour restaurer les paramètres d'une session précédente.

Renvoie false en cas d'erreur.

Cette fonction a été introduite dans Qt 4.3.

QByteArray QFileDialog::saveState () const

Sauvegarde la disposition, l'historique et le répertoire courant.

Cette fonction est typiquement utilisée en conjonction avec des QSettings pour enregistrer les paramètres pour une session future. Un numéro de version est enregistré avec les données.

Cette fonction a été introduite dans Qt 4.3.

void QFileDialog::selectFile ( const QString & filename )

Sélectionne le nom de fichier filename donné dans la boîte de dialogue.

Voir aussi selectedFiles().

void QFileDialog::selectNameFilter ( const QString & filter )

Définit le filtre de types de fichier courant à filter. Des filtres multiples peuvent être passés dans filter en les séparant avec des points-virgules ou des espaces.

Cette fonction a été introduite dans Qt 4.4.

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

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 actuellement visible dans le champ fichier.

Voir aussi selectedNameFilter() et selectFile().

QString QFileDialog::selectedNameFilter () const

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

Cette fonction a été introduite dans Qt 4.4.

Voir aussi selectedFiles().

void QFileDialog::setDirectory ( const QString & directory )

Déinit le répertoire courant de la boîte de dialogue.

Voir aussi directory().

void QFileDialog::setDirectory ( const QDir & directory )

Il s'agit d'une fonction surchargée.

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

Définit le filtre du modèle à filters. Le filtre spécifie les types de fichiers à afficher.

Cette fonction a été introduite dans Qt 4.4.

Voir aussi filter().

void QFileDialog::setHistory ( const QStringList & paths )

L'historique de navigation de la boîte de dialogue devient la liste de chemins paths donnée.

Voir aussi history().

void QFileDialog::setIconProvider ( QFileIconProvider * provider )

Définit le provider donné comme fournisseur d'icônes de la boîte de dialogue.

Voir aussi iconProvider().

void QFileDialog::setItemDelegate ( QAbstractItemDelegate * delegate )

Définit delegate comme délégué utilisé pour dessiner les éléments des vues dans la boîte de dialogue.

Attention : vous ne devez pas partager une même instance de délégué entre plusieurs vues. Si vous le faites, le comportement d'édition peut être incorrect ou non intuitif car chaque vue connectée à un délégué donné peut recevoir le signal closeEditor() et tenter d'accéder à, modifier ou fermer un éditeur déjà fermé.

Notez que le modèle utilisé est QFileSystemModel. Il possède des rôles d'élément personnalisés décrits par l'énumération Roles. Vous pouvez utiliser QFileIconProvider si vous voulez uniquement des icônes personnalisées.

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

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

Spécifie le texte affiché dans la boîte de dialogue pour le libellé label spécifié.

Voir aussi labelText().

void QFileDialog::setNameFilter ( const QString & filter )

Définit filter comme filtre de la boîte de dialogue.

Si filter contient une paire de parenthèses contenant une ou plusieurs séquences quelquechose*autrechose séparées par des espaces, alors seul le texte contenu dans les parenthèses est utilisé comme filtre. Ceci signifie que ces appels sont équivalents :

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

Cette fonction a été introduite dans Qt 4.4.

Voir aussi setNameFilters().

void QFileDialog::setNameFilters ( const QStringList & filters )

Définit les filtres utilisés dans la boîte de dialogue.

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

Cette fonction a été introduite dans Qt 4.4.

Voir aussi nameFilters().

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

Active l'option donnée si on vaut true ; sinon, désactive l'option donnée.

Cette fonction a été introduite dans Qt 4.5.

Voir aussi options et testOption().

void QFileDialog::setProxyModel ( QAbstractProxyModel * proxyModel )

Spécifie le proxyModel donné comme modèle pour les vues. Ceci permet de modifier le modèle sous-jacent, par exemple pour ajouter des colonnes, des données de filtrage ou des disques.

Un modèle proxy préexistant sera retiré mais non supprimé. La boîte de dialogue devient propriétaire du proxyModel.

Cette fonction a été introduite dans Qt 4.3.

Voir aussi proxyModel().

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

Définit les URL du menu latéral.

Par exemple :

     QList<QUrl> urls;
     urls << QUrl::fromLocalFile("/home/gvatteka/dev/qt-45")
          << QUrl::fromLocalFile(QDesktopServices::storageLocation(QDesktopServices::MusicLocation));
 
     QFileDialog dialog;
     dialog.setSidebarUrls(urls);
     dialog.setFileMode(QFileDialog::AnyFile);
     if(dialog.exec()) {
         // ...
     }

La boîte de dialogue aura alors cette apparence :

Cette fonction a été introduite dans Qt 4.3.

Voir aussi sidebarUrls().

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

Réimplémentation de QWidget::setVisible().

QList<QUrl> QFileDialog::sidebarUrls () const

Renvoie la liste des URL actuellement présentes dans le menu latéral.

Cette fonction a été introduite dans Qt 4.3.

Voir aussi setSidebarUrls().

bool QFileDialog::testOption ( Option option ) const

Renvoie true si l'option donnée est activée ; sinon, renvoie false.

Cette fonction a été introduite dans Qt 4.5.

Voir aussi options et setOption().

Remerciements

Merci à Dimitry Ernot, ainsi qu'à Ilya Diallo et Claude Leloup pour la traduction !