En esta página

QFileDialog Class

Muestra un cuadro de diálogo que permite a los usuarios seleccionar archivos o directorios. Más...

Encabezado: #include <QFileDialog>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Heredado de: QDialog

Tipos públicos

enum AcceptMode { AcceptOpen, AcceptSave }
enum DialogLabel { LookIn, FileName, FileType, Accept, Reject }
enum FileMode { AnyFile, ExistingFile, Directory, ExistingFiles }
enum Option { ShowDirsOnly, DontResolveSymlinks, DontConfirmOverwrite, DontUseNativeDialog, ReadOnly, …, DontUseCustomDirectoryIcons }
flags Options
enum ViewMode { Detail, List }

Propiedades

Funciones públicas

QFileDialog(QWidget *parent, Qt::WindowFlags flags)
QFileDialog(QWidget *parent = nullptr, const QString &caption = QString(), const QString &directory = QString(), const QString &filter = QString())
virtual ~QFileDialog()
QFileDialog::AcceptMode acceptMode() const
QString defaultSuffix() const
QDir directory() const
QUrl directoryUrl() const
QFileDialog::FileMode fileMode() const
QDir::Filters filter() const
QStringList history() const
QAbstractFileIconProvider *iconProvider() const
QAbstractItemDelegate *itemDelegate() const
QString labelText(QFileDialog::DialogLabel label) const
QStringList mimeTypeFilters() const
QStringList nameFilters() const
void open(QObject *receiver, const char *member)
QFileDialog::Options options() const
QAbstractProxyModel *proxyModel() const
bool restoreState(const QByteArray &state)
QByteArray saveState() const
void selectFile(const QString &filename)
void selectMimeTypeFilter(const QString &filter)
void selectNameFilter(const QString &filter)
void selectUrl(const QUrl &url)
QStringList selectedFiles() const
QString selectedMimeTypeFilter() const
QString selectedNameFilter() const
QList<QUrl> selectedUrls() const
void setAcceptMode(QFileDialog::AcceptMode mode)
void setDefaultSuffix(const QString &suffix)
void setDirectory(const QString &directory)
void setDirectory(const QDir &directory)
void setDirectoryUrl(const QUrl &directory)
void setFileMode(QFileDialog::FileMode mode)
void setFilter(QDir::Filters filters)
void setHistory(const QStringList &paths)
void setIconProvider(QAbstractFileIconProvider *provider)
void setItemDelegate(QAbstractItemDelegate *delegate)
void setLabelText(QFileDialog::DialogLabel label, const QString &text)
void setMimeTypeFilters(const QStringList &filters)
void setNameFilter(const QString &filter)
void setNameFilters(const QStringList &filters)
void setOption(QFileDialog::Option option, bool on = true)
void setOptions(QFileDialog::Options options)
void setProxyModel(QAbstractProxyModel *proxyModel)
void setSidebarUrls(const QList<QUrl> &urls)
void setSupportedSchemes(const QStringList &schemes)
void setViewMode(QFileDialog::ViewMode mode)
QList<QUrl> sidebarUrls() const
QStringList supportedSchemes() const
bool testOption(QFileDialog::Option option) const
QFileDialog::ViewMode viewMode() const

Funciones públicas reimplementadas

virtual void setVisible(bool visible) override

Señales

void currentChanged(const QString &path)
void currentUrlChanged(const QUrl &url)
void directoryEntered(const QString &directory)
void directoryUrlEntered(const QUrl &directory)
void fileSelected(const QString &file)
void filesSelected(const QStringList &selected)
void filterSelected(const QString &filter)
void urlSelected(const QUrl &url)
void urlsSelected(const QList<QUrl> &urls)

Miembros públicos estáticos

QString getExistingDirectory(QWidget *parent = nullptr, const QString &caption = QString(), const QString &dir = QString(), QFileDialog::Options options = ShowDirsOnly)
QUrl getExistingDirectoryUrl(QWidget *parent = nullptr, const QString &caption = QString(), const QUrl &dir = QUrl(), QFileDialog::Options options = ShowDirsOnly, const QStringList &supportedSchemes = QStringList())
void getOpenFileContent(const QString &nameFilter, const std::function<void (const QString &, const QByteArray &)> &fileOpenCompleted, QWidget *parent = nullptr)
QString getOpenFileName(QWidget *parent = nullptr, const QString &caption = QString(), const QString &dir = QString(), const QString &filter = QString(), QString *selectedFilter = nullptr, QFileDialog::Options options = Options())
QStringList getOpenFileNames(QWidget *parent = nullptr, const QString &caption = QString(), const QString &dir = QString(), const QString &filter = QString(), QString *selectedFilter = nullptr, QFileDialog::Options options = Options())
QUrl 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())
QList<QUrl> 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())
QString getSaveFileName(QWidget *parent = nullptr, const QString &caption = QString(), const QString &dir = QString(), const QString &filter = QString(), QString *selectedFilter = nullptr, QFileDialog::Options options = Options())
QUrl 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())
void saveFileContent(const QByteArray &fileContent, const QString &fileNameHint, QWidget *parent = nullptr)

Funciones protegidas reimplementadas

virtual void accept() override
virtual void changeEvent(QEvent *e) override
virtual void done(int result) override

Descripción detallada

La clase QFileDialog permite a los usuarios explorar el sistema de archivos y seleccionar uno o varios archivos o directorios.

Cuadro de diálogo «Abrir archivo»

QFileDialog se utiliza habitualmente para solicitar a los usuarios que abran o guarden archivos, o que seleccionen directorios. La forma más sencilla de utilizar QFileDialog es a través de sus funciones estáticas de conveniencia, como getOpenFileName().

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

En este ejemplo, se crea un QFileDialog modal mediante una función estática. El cuadro de diálogo muestra inicialmente el contenido del directorio /home/jana y muestra los archivos que coinciden con los patrones de "Image Files (*.png *.jpg *.bmp)". El título de la ventana se establece en Open Image.

Filtros de archivos

Filtrado de archivos por nombre o extensión

Para filtrar los archivos mostrados por nombre o extensión, utilice las funciones setNameFilter() o setNameFilters(). Se pueden especificar varios filtros separándolos con dos puntos y coma (;;):

QFileDialog dialog(this);
dialog.setNameFilter(tr("Images (*.png *.xpm *.jpg);;Text files (*.txt);;XML files (*.xml)"));
dialog.exec();

Filtrar archivos por tipo MIME

Para filtrar los archivos mostrados por tipo MIME, utiliza la función setMimeTypeFilters():

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

Distinción entre mayúsculas y minúsculas en los filtros de archivos

Dependiendo de la plataforma de destino, los filtros de archivos pueden distinguir entre mayúsculas y minúsculas o no.

Modos de archivo

QFileDialog admite varios modos de archivo, que determinan lo que el usuario puede seleccionar:

QFileDialog dialog(this);
dialog.setFileMode(QFileDialog::AnyFile);
  • AnyFile: El usuario puede seleccionar cualquier archivo, incluidos aquellos que no existen (útil para los cuadros de diálogo « Save As »).
  • ExistingFile: El usuario debe seleccionar un archivo existente.
  • Directorio: El usuario puede seleccionar un directorio.

Consulta la enumeración ` QFileDialog::FileMode ` para ver la lista completa de modos.

La propiedad ` fileMode ` contiene el modo de funcionamiento actual. Utiliza ` setFileMode()` para cambiarlo.

Modos de visualización

QFileDialog ofrece dos modos de visualización:

  • Lista: Muestra los archivos y directorios en forma de lista sencilla.
  • Detalle: muestra información adicional, como el tamaño del archivo y la fecha de modificación.

Establece el modo de visualización con setViewMode():

dialog.setViewMode(QFileDialog::Detail);

Recuperación de los archivos seleccionados

Una vez aceptado el cuadro de diálogo, utiliza ` selectedFiles()` para recuperar la selección del usuario:

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

El directorio de trabajo del cuadro de diálogo se puede establecer con ` setDirectory()` (). Puedes preseleccionar un archivo utilizando ` selectFile()` ().

Notas sobre la plataforma

Por defecto, QFileDialog utiliza el cuadro de diálogo de archivos nativo de la plataforma, si está disponible. En este caso, algunas API específicas de los widgets (como layout() y itemDelegate()) pueden devolver null. Además, no todas las plataformas muestran los cuadros de diálogo de archivos con una barra de título, por lo que es posible que el texto del título no sea visible.

Para forzar el uso del cuadro de diálogo basado en widgets de Qt, configura la opción DontUseNativeDialog o el atributo de aplicación AA_DontUseNativeDialogs.

Consideraciones de seguridad

La función restoreState() deserializa un blob binario versionado que describe la disposición del separador del cuadro de diálogo, los marcadores de la barra lateral, el historial de navegación, el directorio actual y un blob de estado QHeaderView incrustado. Se validan el número mágico y la versión del formato, pero los campos individuales no se someten a ninguna otra comprobación de validez una vez aceptada la estructura externa.

Solo se debe pasar a ` restoreState()` un ` QByteArray ` que haya sido generado previamente por ` saveState()` y guardado por la misma versión —o una compatible— de la aplicación, normalmente mediante ` QSettings`. No se debe restaurar el estado desde un archivo, una configuración u otra fuente cuya procedencia no sea fiable. El estado del encabezado incrustado está sujeto a las mismas consideraciones descritas en ` QHeaderView's Security Considerations`.

Véase también QDir, QFileInfo, QFile, QColorDialog, QFontDialog y el ejemplo de diálogos estándar.

Documentación sobre los tipos de miembros

enum QFileDialog::AcceptMode

ConstanteValor
QFileDialog::AcceptOpen0
QFileDialog::AcceptSave1

enum QFileDialog::DialogLabel

ConstanteValor
QFileDialog::LookIn0
QFileDialog::FileName1
QFileDialog::FileType2
QFileDialog::Accept3
QFileDialog::Reject4

enum QFileDialog::FileMode

Esta enumeración se utiliza para indicar qué opciones puede seleccionar el usuario en el cuadro de diálogo de archivos; es decir, qué valor devuelve el cuadro de diálogo si el usuario hace clic en «Aceptar».

ConstanteValorDescripción
QFileDialog::AnyFile0El nombre de un archivo, independientemente de si existe o no.
QFileDialog::ExistingFile1El nombre de un único archivo existente.
QFileDialog::Directory2El nombre de un directorio. Se muestran tanto los archivos como los directorios. Sin embargo, el cuadro de diálogo de archivos nativo de Windows no admite la visualización de archivos en el selector de directorios.
QFileDialog::ExistingFiles3Los nombres de cero o más archivos existentes.

Véase también setFileMode().

enum QFileDialog::Option
flags QFileDialog::Options

Opciones que influyen en el comportamiento del cuadro de diálogo.

ConstanteValorDescripción
QFileDialog::ShowDirsOnly0x00000001Mostrar solo directorios. Por defecto, se muestran tanto los archivos como los directorios.
This option is only effective in the Directory file mode.
QFileDialog::DontResolveSymlinks0x00000002No resolver enlaces simbólicos. Por defecto, los enlaces simbólicos se resuelven.
QFileDialog::DontConfirmOverwrite0x00000004No pedir confirmación si se selecciona un archivo ya existente. Por defecto, se solicita confirmación.
This option is only effective if acceptMode is AcceptSave). It is furthermore not used on macOS for native file dialogs.
QFileDialog::DontUseNativeDialog0x00000008No utilices el cuadro de diálogo de archivos nativo de la plataforma, sino el basado en widgets que ofrece Qt.
By default, a native file dialog is shown unless you use a subclass of QFileDialog that contains the Q_OBJECT macro, the global AA_DontUseNativeDialogs application attribute is set, or the platform does not have a native dialog of the type that you require.
Para que la opción surta efecto, debes configurarla antes de modificar otras propiedades del cuadro de diálogo o de mostrarlo.
QFileDialog::ReadOnly0x00000010Indica que el modelo es de solo lectura.
QFileDialog::HideNameFilterDetails0x00000020Indica si los detalles del filtro de nombres de archivo están ocultos o no.
QFileDialog::DontUseCustomDirectoryIcons0x00000040Utiliza siempre el icono de directorio predeterminado.
Algunas plataformas permiten al usuario establecer un icono diferente, pero la búsqueda de iconos personalizados puede provocar importantes problemas de rendimiento en redes o unidades extraíbles.
Setting this will enable the DontUseCustomDirectoryIcons option in iconProvider().
Este valor de enumeración se añadió en Qt 5.2.

El tipo «Options» es una definición de tipo (typedef) para QFlags<Option>. Almacena una combinación OR de valores de «Option».

Véase también options y testOption.

enum QFileDialog::ViewMode

Esta enumeración describe el modo de visualización del cuadro de diálogo de archivos; es decir, qué información se muestra sobre cada archivo.

ConstanteValorDescripción
QFileDialog::Detail0Muestra un icono, un nombre y detalles de cada elemento del directorio.
QFileDialog::List1Muestra únicamente un icono y un nombre para cada elemento del directorio.

Véase también setViewMode().

Documentación de la propiedad

acceptMode : AcceptMode

Esta propiedad indica el modo de aceptación del cuadro de diálogo.

El modo de acción define si el cuadro de diálogo sirve para abrir o guardar archivos.

Por defecto, esta propiedad está establecida en « AcceptOpen ».

Funciones de acceso:

QFileDialog::AcceptMode acceptMode() const
void setAcceptMode(QFileDialog::AcceptMode mode)

Véase también AcceptMode.

defaultSuffix : QString

Sufijo que se añade al nombre del archivo si no se ha especificado ningún otro sufijo.

Esta propiedad especifica una cadena que se añade al nombre del archivo si aún no tiene sufijo. El sufijo se utiliza normalmente para indicar el tipo de archivo (por ejemplo, «txt» indica un archivo de texto).

Si el primer carácter es un punto («.'»), se elimina.

Funciones de Access:

QString defaultSuffix() const
void setDefaultSuffix(const QString &suffix)

fileMode : FileMode

Esta propiedad contiene el modo de archivo del cuadro de diálogo.

El modo de archivo define el número y el tipo de elementos que se espera que el usuario seleccione en el cuadro de diálogo.

De forma predeterminada, esta propiedad está establecida en « AnyFile ».

Esta función establece las etiquetas para los valores « FileName » y « Accept » DialogLabel. Es posible establecer un texto personalizado tras llamar a setFileMode().

Funciones de acceso:

QFileDialog::FileMode fileMode() const
void setFileMode(QFileDialog::FileMode mode)

Véase también FileMode.

options : Options

Esta propiedad contiene las distintas opciones que influyen en el aspecto y el comportamiento del cuadro de diálogo.

Por defecto, todas las opciones están desactivadas.

Las opciones (en particular la opción « DontUseNativeDialog ») deben configurarse antes de modificar las propiedades del cuadro de diálogo o de mostrarlo.

No se garantiza que la configuración de las opciones mientras el cuadro de diálogo está visible tenga un efecto inmediato en el mismo (dependiendo de la opción y de la plataforma).

Configurar las opciones después de modificar otras propiedades puede hacer que estos valores no surtan efecto.

Funciones de acceso:

QFileDialog::Options options() const
void setOptions(QFileDialog::Options options)

Véanse también « setOption()» y « testOption()».

supportedSchemes : QStringList

Esta propiedad contiene los esquemas de URL a los que el cuadro de diálogo de archivos debe permitir navegar.

Al configurar esta propiedad, se puede restringir el tipo de URL que el usuario puede seleccionar. Es una forma de que la aplicación declare los protocolos que admite para recuperar el contenido del archivo. Una lista vacía significa que no se aplica ninguna restricción (valor por defecto). La compatibilidad con archivos locales (esquema «file») es implícita y está siempre habilitada; no es necesario incluirla en la restricción.

Funciones de acceso:

QStringList supportedSchemes() const
void setSupportedSchemes(const QStringList &schemes)

viewMode : ViewMode

Esta propiedad determina la forma en que se muestran los archivos y directorios en el cuadro de diálogo.

De forma predeterminada, se utiliza el modo « Detail » para mostrar información sobre archivos y directorios.

Funciones de Access:

QFileDialog::ViewMode viewMode() const
void setViewMode(QFileDialog::ViewMode mode)

Véase también ViewMode.

Documentación de las funciones de miembro

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

Crea un cuadro de diálogo de archivo con el « parent » y el « flags » indicados.

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

Crea un cuadro de diálogo de archivos con los valores parent y caption indicados, que muestra inicialmente el contenido de la ruta directory especificada. El contenido del directorio se filtra antes de mostrarse en el cuadro de diálogo, utilizando una lista de filtros separados por punto y coma especificada en filter.

[virtual noexcept] QFileDialog::~QFileDialog()

Cierra el cuadro de diálogo de archivos.

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

Reimplementa: QDialog::accept().

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

Reimplementa: ` QWidget::changeEvent(QEvent *event)`.

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

Cuando cambia el archivo actual en las operaciones locales, se emite esta señal con el nuevo nombre de archivo como parámetro « path ».

Véase también filesSelected().

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

Cuando cambia el archivo actual, se emite esta señal con la nueva URL del archivo como parámetro « url ».

Véase también urlsSelected().

QDir QFileDialog::directory() const

Devuelve el directorio que se está mostrando actualmente en el cuadro de diálogo.

Véase también setDirectory().

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

Esta señal se emite para operaciones locales cuando el usuario introduce un directory.

QUrl QFileDialog::directoryUrl() const

Devuelve la URL del directorio que se está mostrando actualmente en el cuadro de diálogo.

Véase también setDirectoryUrl().

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

Esta señal se emite cuando el usuario introduce un directory.

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

Reimplementa: QDialog::done(int r).

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

Cuando cambia la selección para las operaciones locales y se acepta el cuadro de diálogo, se emite esta señal con el file seleccionado (que puede estar vacío).

Véase también ` currentChanged()` y ` QDialog::Accepted`.

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

Cuando cambia la selección para las operaciones locales y se acepta el cuadro de diálogo, se emite esta señal con la lista (posiblemente vacía) de archivos selected.

Véase también currentChanged() y QDialog::Accepted.

QDir::Filters QFileDialog::filter() const

Devuelve el filtro que se utiliza al mostrar los archivos.

Véase también setFilter().

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

Esta señal se emite cuando el usuario selecciona un filter.

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

Esta es una función estática de uso práctico que devuelve un directorio existente seleccionado por el usuario.

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

Esta función crea un cuadro de diálogo modal de archivos con el widget « parent » especificado. Si « parent » no es « nullptr », el cuadro de diálogo se muestra centrado sobre el widget padre.

El directorio de trabajo del cuadro de diálogo se establece en dir, y el título se establece en caption. Cualquiera de estos valores puede ser una cadena vacía; en ese caso, se utilizan, respectivamente, el directorio actual y un título predeterminado.

El argumento options contiene varias opciones sobre cómo ejecutar el cuadro de diálogo. Consulta la enumeración QFileDialog::Option para obtener más información sobre los indicadores que puedes pasar. Para garantizar un cuadro de diálogo de archivos nativo, se debe establecer ShowDirsOnly.

En Windows y macOS, esta función estática utiliza el cuadro de diálogo de archivos nativo y no un ` QFileDialog`. Sin embargo, el cuadro de diálogo de archivos nativo de Windows no admite la visualización de archivos en el selector de directorios. Es necesario pasar la opción ` DontUseNativeDialog ` o establecer el atributo global de la aplicación ` AA_DontUseNativeDialogs ` para mostrar los archivos mediante un ` QFileDialog`.

Ten en cuenta que el cuadro de diálogo de archivos nativo de macOS no muestra una barra de título.

En Unix/X11, el comportamiento normal del cuadro de diálogo de archivos es resolver y seguir los enlaces simbólicos. Por ejemplo, si /usr/tmp es un enlace simbólico a /var/tmp, el cuadro de diálogo de archivos cambia a /var/tmp tras introducir /usr/tmp. Si options incluye DontResolveSymlinks, el cuadro de diálogo de archivos trata los enlaces simbólicos como directorios normales.

En Windows, el cuadro de diálogo ejecuta un bucle de eventos modal bloqueante que no envía ningún QTimer, y si parent no es nullptr, entonces coloca el cuadro de diálogo justo debajo de la barra de título del elemento padre.

Véanse también getOpenFileName(), getOpenFileNames() y getSaveFileName().

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

Esta es una función estática de uso práctico que devuelve un directorio existente seleccionado por el usuario. Si el usuario pulsa «Cancelar», devuelve una URL vacía.

La función se utiliza de forma similar a QFileDialog::getExistingDirectory(). En concreto, parent, caption, dir y options se utilizan exactamente de la misma manera.

La principal diferencia con respecto a ` QFileDialog::getExistingDirectory()` radica en la posibilidad que se ofrece al usuario de seleccionar un directorio remoto. Por eso, el tipo de retorno de ` dir ` es ` QUrl`.

El argumento supportedSchemes permite restringir el tipo de URL que el usuario puede seleccionar. Es una forma de que la aplicación declare los protocolos que admite para recuperar el contenido del archivo. Una lista vacía significa que no se aplica ninguna restricción (valor por defecto). La compatibilidad con archivos locales (esquema «file») es implícita y está siempre habilitada; no es necesario incluirla en la restricción.

Siempre que sea posible, esta función estática utiliza el cuadro de diálogo de archivos nativo en lugar de un QFileDialog. En plataformas que no admiten la selección de archivos remotos, Qt solo permite seleccionar archivos locales.

Véase también getExistingDirectory(), getOpenFileUrl(), getOpenFileUrls() y getSaveFileUrl().

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

Esta es una función estática de conveniencia que devuelve el contenido de un archivo seleccionado por el usuario.

Utiliza esta función para acceder a archivos locales en Qt para WebAssembly, si el entorno aislado web restringe el acceso a los archivos. Su implementación permite mostrar un cuadro de diálogo de archivos nativo en el navegador, donde el usuario selecciona un archivo en función del parámetro nameFilter.

parent se ignora en Qt para WebAssembly. Pasa parent en otras plataformas para que la ventana emergente sea un elemento secundario de otro widget. Si la plataforma no admite cuadros de diálogo de archivos nativos, la función recurre a QFileDialog.

La función es asíncrona y devuelve un resultado de inmediato. La llamada de retorno fileOpenCompleted se activará cuando se haya seleccionado un archivo y su contenido se haya leído en memoria.

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

Esta es una función estática de uso práctico que devuelve un archivo existente seleccionado por el usuario. Si el usuario pulsa «Cancelar», devuelve una cadena nula.

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

La función crea un cuadro de diálogo modal de archivos con el widget « parent » especificado. Si « parent » no es « nullptr », el cuadro de diálogo se muestra centrado sobre el widget padre.

El directorio de trabajo del cuadro de diálogo de archivos se establece en dir. Si dir incluye un nombre de archivo, dicho archivo queda seleccionado. Solo se muestran los archivos que coinciden con el filter especificado. El filtro seleccionado se establece en selectedFilter. Los parámetros dir, selectedFilter y filter pueden ser cadenas vacías. Si deseas utilizar varios filtros, sepáralos con «;;», por ejemplo:

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

El argumento « options » contiene diversas opciones sobre cómo ejecutar el cuadro de diálogo. Consulte la enumeración « QFileDialog::Option » para obtener más información sobre los indicadores que puede pasar.

El título del cuadro de diálogo se establece en caption. Si no se especifica caption, se utilizará un título predeterminado.

En Windows y macOS, esta función estática utiliza el cuadro de diálogo de archivos nativo y no un ` QFileDialog`. Ten en cuenta que el cuadro de diálogo de archivos nativo de macOS no muestra barra de título.

En Windows, el cuadro de diálogo ejecuta un bucle de eventos modal bloqueante que no envía ningún QTimer, y si parent no es nullptr, entonces coloca el cuadro de diálogo justo debajo de la barra de título del elemento padre.

En Unix/X11, el comportamiento normal del cuadro de diálogo de archivos es resolver y seguir los enlaces simbólicos. Por ejemplo, si /usr/tmp es un enlace simbólico a /var/tmp, el cuadro de diálogo de archivos cambia a /var/tmp tras introducir /usr/tmp. Si options incluye DontResolveSymlinks, el cuadro de diálogo de archivos trata los enlaces simbólicos como directorios normales.

Véase también getOpenFileNames(), getSaveFileName() y 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())

Esta es una función estática de uso práctico que devuelve uno o varios archivos existentes seleccionados por el usuario.

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

Esta función crea un cuadro de diálogo modal de archivos con el widget « parent » especificado. Si « parent » no es « nullptr », el cuadro de diálogo se muestra centrado sobre el widget padre.

El directorio de trabajo del cuadro de diálogo de archivos se establece en ` dir`. Si ` dir ` incluye un nombre de archivo, se selecciona dicho archivo. El filtro se establece en ` filter `, de modo que solo se muestren aquellos archivos que coincidan con el filtro. El filtro seleccionado se establece en ` selectedFilter`. Los parámetros ` dir`, ` selectedFilter ` y ` filter ` pueden ser cadenas vacías. Si necesitas varios filtros, sepáralos con «;;», por ejemplo:

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

El título del cuadro de diálogo se establece en « caption ». Si no se especifica « caption », se utiliza un título predeterminado.

En Windows y macOS, esta función estática utiliza el cuadro de diálogo de archivos nativo y no un QFileDialog. Ten en cuenta que el cuadro de diálogo de archivos nativo de macOS no muestra una barra de título.

En Windows, el cuadro de diálogo ejecuta un bucle de eventos modal bloqueante que no envía ningún QTimer, y si parent no es nullptr, entonces coloca el cuadro de diálogo justo debajo de la barra de título del elemento padre.

En Unix/X11, el comportamiento habitual del cuadro de diálogo de archivos es resolver y seguir los enlaces simbólicos. Por ejemplo, si /usr/tmp es un enlace simbólico a /var/tmp, el cuadro de diálogo de archivos cambiará a /var/tmp tras introducir /usr/tmp. El argumento options contiene varias opciones sobre cómo ejecutar el cuadro de diálogo; consulta la enumeración QFileDialog::Option para obtener más información sobre los indicadores que puedes pasar.

Véase también getOpenFileName(), getSaveFileName() y 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())

Esta es una función estática de uso práctico que devuelve un archivo existente seleccionado por el usuario. Si el usuario pulsa «Cancelar», devuelve una URL vacía.

La función se utiliza de forma similar a QFileDialog::getOpenFileName(). En concreto, parent, caption, dir, filter, selectedFilter y options se utilizan exactamente de la misma manera.

La principal diferencia con respecto a ` QFileDialog::getOpenFileName()` radica en la posibilidad que se ofrece al usuario de seleccionar un archivo remoto. Por eso, el tipo de retorno y el tipo de ` dir ` es ` QUrl`.

El argumento supportedSchemes permite restringir el tipo de URL que el usuario puede seleccionar. Es una forma de que la aplicación declare los protocolos que admitirá para recuperar el contenido del archivo. Una lista vacía significa que no se aplica ninguna restricción (valor por defecto). La compatibilidad con archivos locales (esquema «file») es implícita y siempre está habilitada; no es necesario incluirla en la restricción.

Siempre que sea posible, esta función estática utiliza el cuadro de diálogo de archivos nativo y no un ` QFileDialog`. En plataformas que no admiten la selección de archivos remotos, Qt solo permitirá seleccionar archivos locales.

Véase también getOpenFileName(), getOpenFileUrls(), getSaveFileUrl() y 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())

Se trata de una función estática de uso práctico que devuelve uno o varios archivos existentes seleccionados por el usuario. Si el usuario pulsa «Cancelar», devuelve una lista vacía.

La función se utiliza de forma similar a QFileDialog::getOpenFileNames(). En concreto, parent, caption, dir, filter, selectedFilter y options se utilizan exactamente de la misma manera.

La principal diferencia con respecto a ` QFileDialog::getOpenFileNames()` radica en la posibilidad que se ofrece al usuario de seleccionar archivos remotos. Por eso, el tipo de retorno y el tipo de ` dir ` son, respectivamente, ` QList` `<QUrl>` y ` QUrl`.

El argumento supportedSchemes permite restringir el tipo de URL que el usuario puede seleccionar. Es una forma de que la aplicación declare los protocolos que admite para recuperar el contenido del archivo. Una lista vacía significa que no se aplica ninguna restricción (valor por defecto). La compatibilidad con archivos locales (esquema «file») es implícita y está siempre habilitada; no es necesario incluirla en la restricción.

Siempre que sea posible, esta función estática utiliza el cuadro de diálogo de archivos nativo y no un ` QFileDialog`. En plataformas que no admiten la selección de archivos remotos, Qt solo permitirá seleccionar archivos locales.

Véase también getOpenFileNames(), getOpenFileUrl(), getSaveFileUrl() y 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())

Esta es una función estática de ayuda que devuelve el nombre de un archivo seleccionado por el usuario. No es necesario que el archivo exista.

Crea un cuadro de diálogo modal de archivos con el widget parent especificado. Si parent no es nullptr, el cuadro de diálogo se mostrará centrado sobre el widget padre.

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

El directorio de trabajo del cuadro de diálogo de archivos se establece en dir. Si dir incluye un nombre de archivo, se selecciona dicho archivo. Solo se muestran los archivos que coinciden con filter. El filtro seleccionado se establece en selectedFilter. Los parámetros dir, selectedFilter y filter pueden ser cadenas vacías. Los filtros múltiples se separan con «;;». Por ejemplo:

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

El argumento « options » contiene varias opciones sobre cómo ejecutar el cuadro de diálogo; consulta la enumeración « QFileDialog::Option » para obtener más información sobre los indicadores que puedes pasar.

El filtro predeterminado se puede seleccionar estableciendo selectedFilter en el valor deseado.

El título del cuadro de diálogo se establece en caption. Si no se especifica caption, se utiliza un título predeterminado.

En Windows y macOS, esta función estática utiliza el cuadro de diálogo de archivos nativo y no un ` QFileDialog`.

En Windows, el cuadro de diálogo ejecuta un bucle de eventos modal bloqueante que no envía ningún QTimer, y si parent no es nullptr, coloca el cuadro de diálogo justo debajo de la barra de título del elemento padre. En macOS, con su cuadro de diálogo de archivos nativo, se ignora el argumento «filter».

En Unix/X11, el comportamiento normal del cuadro de diálogo de archivos es resolver y seguir los enlaces simbólicos. Por ejemplo, si /usr/tmp es un enlace simbólico a /var/tmp, el cuadro de diálogo de archivos cambia a /var/tmp tras introducir /usr/tmp. Si options incluye DontResolveSymlinks, el cuadro de diálogo de archivos trata los enlaces simbólicos como directorios normales.

Véase también getOpenFileName(), getOpenFileNames() y 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())

Esta es una función estática de conveniencia que devuelve un archivo seleccionado por el usuario. No es necesario que el archivo exista. Si el usuario pulsa «Cancelar», devuelve una URL vacía.

La función se utiliza de forma similar a ` QFileDialog::getSaveFileName()`. En concreto, ` parent`, ` caption`, ` dir`, ` filter`, ` selectedFilter ` y ` options ` se utilizan exactamente de la misma manera.

La principal diferencia con respecto a ` QFileDialog::getSaveFileName()` radica en la posibilidad que se ofrece al usuario de seleccionar un archivo remoto. Por eso, el tipo de retorno y el tipo de ` dir ` es ` QUrl`.

El argumento supportedSchemes permite restringir el tipo de URL que el usuario puede seleccionar. Es una forma de que la aplicación declare los protocolos que admite para guardar el contenido del archivo. Una lista vacía significa que no se aplica ninguna restricción (valor por defecto). La compatibilidad con archivos locales (esquema «file») es implícita y siempre está habilitada; no es necesario incluirla en la restricción.

Siempre que sea posible, esta función estática utiliza el cuadro de diálogo de archivos nativo y no un ` QFileDialog`. En plataformas que no admiten la selección de archivos remotos, Qt solo permitirá seleccionar archivos locales.

Véase también getSaveFileName(), getOpenFileUrl(), getOpenFileUrls() y getExistingDirectoryUrl().

QStringList QFileDialog::history() const

Devuelve el historial de navegación del cuadro de diálogo de archivos como una lista de rutas.

Véase también setHistory().

QAbstractFileIconProvider *QFileDialog::iconProvider() const

Devuelve el proveedor de iconos que utiliza el cuadro de diálogo de archivos.

Véase también setIconProvider().

QAbstractItemDelegate *QFileDialog::itemDelegate() const

Devuelve el delegado de elementos que se utiliza para mostrar los elementos en las vistas del cuadro de diálogo de campos.

Véase también setItemDelegate().

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

Devuelve el texto que aparece en el cuadro de diálogo de selección de archivos en el label especificado.

Véase también setLabelText().

QStringList QFileDialog::mimeTypeFilters() const

Devuelve los filtros de tipo MIME que se están aplicando en este cuadro de diálogo de archivos.

Véase también setMimeTypeFilters().

QStringList QFileDialog::nameFilters() const

Devuelve los filtros de tipo de archivo que se están aplicando en este cuadro de diálogo de archivos.

Véase también setNameFilters().

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

Esta función muestra el cuadro de diálogo y conecta la ranura especificada por receiver y member a la señal que informa de los cambios en la selección. Si fileMode es ExistingFiles, se trata de la señal filesSelected(), en caso contrario, es la señal fileSelected().

La señal se desconecta de la ranura cuando se cierra el cuadro de diálogo.

QAbstractProxyModel *QFileDialog::proxyModel() const

Devuelve el modelo proxy utilizado por el cuadro de diálogo de archivos. Por defecto, no hay ningún proxy configurado.

Véase también setProxyModel().

bool QFileDialog::restoreState(const QByteArray &state)

Restaura la disposición de los cuadros de diálogo, el historial y el directorio actual según lo especificado en state.

Normalmente se utiliza junto con « QSettings » para restablecer el tamaño de una sesión anterior.

Devuelve « false » si se producen errores.

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

Esta es una función estática de conveniencia que guarda un objeto ` fileContent ` en un archivo, utilizando el nombre y la ubicación elegidos por el usuario. Se puede proporcionar un objeto ` fileNameHint ` para sugerir un nombre de archivo al usuario.

Utiliza esta función para guardar contenido en archivos locales en Qt for WebAssembly, si el entorno de ejecución web restringe el acceso a los archivos. Su implementación permite mostrar un cuadro de diálogo de archivos nativo en el navegador, donde el usuario especifica un archivo de salida basado en el argumento ` fileNameHint `.

parent se ignora en Qt para WebAssembly. Pasa parent en otras plataformas para que la ventana emergente sea un elemento secundario de otro widget. Si la plataforma no admite cuadros de diálogo de archivos nativos, la función recurre a QFileDialog.

La función es asíncrona y devuelve un resultado de forma inmediata.

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

QByteArray QFileDialog::saveState() const

Guarda el estado de la disposición del cuadro de diálogo, el historial y el directorio actual.

Normalmente se utiliza junto con QSettings para recordar el tamaño de vista para una sesión futura. Se almacena un número de versión como parte de los datos.

void QFileDialog::selectFile(const QString &filename)

Selecciona la opción « filename » en el cuadro de diálogo de archivos.

Véase también selectedFiles().

void QFileDialog::selectMimeTypeFilter(const QString &filter)

Establece el tipo MIME actual filter.

void QFileDialog::selectNameFilter(const QString &filter)

Establece el tipo de archivo actual filter. Se pueden pasar varios filtros filter separándolos con punto y coma o espacios.

Véase también setNameFilter(), setNameFilters() y selectedNameFilter().

void QFileDialog::selectUrl(const QUrl &url)

Selecciona el archivo « url » indicado en el cuadro de diálogo de archivos.

Nota: La función no nativa QFileDialog solo admite archivos locales.

Véase también selectedUrls().

QStringList QFileDialog::selectedFiles() const

Devuelve una lista de cadenas que contienen las rutas absolutas de los archivos seleccionados en el cuadro de diálogo. Si no hay ningún archivo seleccionado, o si el modo no es « ExistingFiles » o « ExistingFile », la función `selectedFiles()` contiene la ruta actual de la ventana gráfica.

Véase también selectedNameFilter() y selectFile().

QString QFileDialog::selectedMimeTypeFilter() const

Devuelve el tipo MIME del archivo que el usuario ha seleccionado en el cuadro de diálogo de archivos.

QString QFileDialog::selectedNameFilter() const

Devuelve el filtro que el usuario ha seleccionado en el cuadro de diálogo de archivos.

Véase también selectedFiles().

QList<QUrl> QFileDialog::selectedUrls() const

Devuelve una lista de direcciones URL que contienen los archivos seleccionados en el cuadro de diálogo. Si no se ha seleccionado ningún archivo, o si el modo no es ExistingFiles o ExistingFile, selectedUrls() contiene la ruta actual en la ventana gráfica.

Véase también selectedNameFilter() y selectUrl().

void QFileDialog::setDirectory(const QString &directory)

Establece el valor actual de « directory » del cuadro de diálogo de archivos.

Nota: En iOS, si se establece directory en QStandardPaths::standardLocations(QStandardPaths::PicturesLocation).last(), se utiliza un cuadro de diálogo nativo de selección de imágenes para acceder al álbum de fotos del usuario. El nombre de archivo devuelto se puede cargar utilizando QFile y las API relacionadas. Para que esto esté habilitado, el archivo Info.plist asignado a QMAKE_INFO_PLIST en el archivo del proyecto debe contener la clave NSPhotoLibraryUsageDescription. Consulta la documentación de Info.plist de Apple para obtener más información sobre esta clave. Esta característica se añadió en Qt 5.5.

Véase también directory().

void QFileDialog::setDirectory(const QDir &directory)

Esta es una función sobrecargada.

void QFileDialog::setDirectoryUrl(const QUrl &directory)

Establece la URL actual de directory en el cuadro de diálogo de archivos.

Nota: El QFileDialog no nativo solo admite archivos locales.

Nota: En Windows, es posible pasar direcciones URL que representen una de las carpetas virtuales, como «Equipo» o «Red». Para ello, se pasa una dirección QUrl utilizando el esquema clsid seguido del valor CLSID sin las llaves. Por ejemplo, la URL clsid:374DE290-123F-4565-9164-39C4925E467B indica la ubicación de descarga. Para obtener una lista completa de los valores posibles, consulta la documentación de MSDN sobre KNOWNFOLDERID. Esta característica se añadió en Qt 5.5.

Véase también directoryUrl() y QUuid.

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

Establece el filtro utilizado por el modelo en filters. El filtro se utiliza para especificar el tipo de archivos que deben mostrarse.

Véase también filter().

void QFileDialog::setHistory(const QStringList &paths)

Establece el historial de navegación del cuadro de diálogo de archivos para que contenga el archivo paths.

Véase también history().

void QFileDialog::setIconProvider(QAbstractFileIconProvider *provider)

Establece el proveedor de iconos que utiliza el cuadro de diálogo de archivos en el provider especificado.

Véase también iconProvider().

void QFileDialog::setItemDelegate(QAbstractItemDelegate *delegate)

Establece el delegado de elementos utilizado para mostrar los elementos en las vistas del cuadro de diálogo de archivos en el valor indicado: delegate.

Cualquier delegado existente se eliminará, pero no se borrará. QFileDialog no asume la propiedad de delegate.

Advertencia: Nodebes compartir la misma instancia de un delegado entre vistas. Hacerlo puede provocar un comportamiento de edición incorrecto o poco intuitivo, ya que cada vista conectada a un delegado determinado puede recibir la señal closeEditor() e intentar acceder, modificar o cerrar un editor que ya se haya cerrado.

Ten en cuenta que el modelo utilizado es QFileSystemModel. Cuenta con roles de datos de elementos personalizados, descritos por la enumeración Roles. Puedes utilizar un QFileIconProvider si solo deseas iconos personalizados.

Véase también itemDelegate(), setIconProvider() y QFileSystemModel.

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

Establece el « text » que se muestra en el cuadro de diálogo de archivos en el archivo especificado « label ».

Véase también labelText().

void QFileDialog::setMimeTypeFilters(const QStringList &filters)

Establece el filtro de nombres « filters » que se utiliza en el cuadro de diálogo de archivos, a partir de una lista de tipos MIME.

Método de conveniencia para setNameFilters(). Utiliza QMimeType para crear un filtro de nombres a partir de los patrones glob y la descripción definidos en cada tipo MIME.

Utiliza application/octet-stream para el filtro «Todos los archivos (*)», ya que ese es el tipo MIME básico para todos los archivos.

Al llamar a `setMimeTypeFilters` se anulan los filtros de nombre establecidos anteriormente y se modifica el valor de retorno 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();

Véase también ` mimeTypeFilters()`.

void QFileDialog::setNameFilter(const QString &filter)

Establece el filtro utilizado en el cuadro de diálogo de archivos en el valor filter especificado.

Si filter contiene un par de paréntesis con uno o más patrones de comodín para nombres de archivo, separados por espacios, solo se utilizará como filtro el texto que figura entre paréntesis. Esto significa que todas estas llamadas son equivalentes:

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

Nota: Con el cuadro de diálogo de archivos nativo de Android, se utiliza el tipo MIME que coincida con el filtro de nombre especificado, ya que solo se admiten tipos MIME.

Véase también ` setMimeTypeFilters()` y ` setNameFilters()`.

void QFileDialog::setNameFilters(const QStringList &filters)

Establece el filtro « filters » que se utiliza en el cuadro de diálogo de archivos.

Ten en cuenta que el filtro *.* no es portátil, ya que la suposición histórica de que la extensión del archivo determina su tipo no es válida en todos los sistemas operativos. Es posible que haya un archivo sin punto en su nombre (por ejemplo, Makefile). En un cuadro de diálogo de archivos nativo de Windows, *.* coincide con este tipo de archivos, mientras que en otros tipos de cuadros de diálogo de archivos puede que no coincida. Por lo tanto, es mejor utilizar * si lo que se pretende es seleccionar cualquier archivo.

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

setMimeTypeFilters() tiene la ventaja de proporcionar todos los filtros de nombre posibles para cada tipo de archivo. Por ejemplo, las imágenes JPEG tienen tres extensiones posibles; si tu aplicación puede abrir este tipo de archivos, seleccionar el tipo MIME « image/jpeg » como filtro te permite abrirlas todas.

Véase también nameFilters().

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

Establece que la opción « option » esté activada si « on » es «true»; en caso contrario, desactiva la opción « option ».

Las opciones (en particular la opción « DontUseNativeDialog ») deben configurarse antes de modificar las propiedades del cuadro de diálogo o de mostrarlo.

No se garantiza que la configuración de opciones mientras el cuadro de diálogo está visible tenga un efecto inmediato en el mismo (dependiendo de la opción y de la plataforma).

Establecer opciones después de modificar otras propiedades puede hacer que dichos valores no surtan efecto.

Véase también options y testOption().

void QFileDialog::setProxyModel(QAbstractProxyModel *proxyModel)

Establece el modelo de las vistas en el archivo proxyModel. Esto resulta útil si deseas modificar el modelo subyacente; por ejemplo, para añadir columnas, filtrar datos o añadir unidades.

Cualquier modelo proxy existente se retira, pero no se elimina. El cuadro de diálogo de archivos asume la propiedad de proxyModel.

Véase también proxyModel().

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

Establece los elementos de « urls » que se encuentran en la barra lateral.

Por ejemplo:

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()) {
    // ...
}

Entonces, el cuadro de diálogo de archivos tiene este aspecto:

Abrir el cuadro de diálogo de archivos con las URL configuradas en la barra lateral

Véase también sidebarUrls().

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

Reimplementa: ` QDialog::setVisible` (bool visible).

QList<QUrl> QFileDialog::sidebarUrls() const

Devuelve una lista de las URL que aparecen actualmente en la barra lateral

Véase también setSidebarUrls().

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

Devuelve « true » si el valor « option » proporcionado está habilitado; en caso contrario, devuelve «false».

Véase también options y setOption().

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

Cuando cambia la selección y se acepta el cuadro de diálogo, se emite esta señal con el url seleccionado (que puede estar vacío).

Véase también currentUrlChanged() y QDialog::Accepted.

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

Cuando cambia la selección y se acepta el cuadro de diálogo, se emite esta señal con la lista (posiblemente vacía) de elementos seleccionados urls.

Véase también currentUrlChanged() y QDialog::Accepted.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.