En esta página

QStandardPaths Class

La clase QStandardPaths ofrece métodos para acceder a las rutas estándar. Más información...

Encabezado: #include <QStandardPaths>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core

Tipos públicos

enum LocateOption { LocateFile, LocateDirectory }
flags LocateOptions
enum StandardLocation { DesktopLocation, DocumentsLocation, FontsLocation, ApplicationsLocation, MusicLocation, …, GenericStateLocation }

Miembros públicos estáticos

QString displayName(QStandardPaths::StandardLocation type)
QString findExecutable(const QString &executableName, const QStringList &paths = QStringList())
QString locate(QStandardPaths::StandardLocation type, const QString &fileName, QStandardPaths::LocateOptions options = LocateFile)
QStringList locateAll(QStandardPaths::StandardLocation type, const QString &fileName, QStandardPaths::LocateOptions options = LocateFile)
void setTestModeEnabled(bool testMode)
QStringList standardLocations(QStandardPaths::StandardLocation type)
QString writableLocation(QStandardPaths::StandardLocation type)

Descripción detallada

Esta clase contiene funciones para consultar ubicaciones estándar en el sistema de archivos local, para tareas comunes como directorios específicos del usuario o directorios de configuración de todo el sistema.

Documentación sobre los tipos de miembros

enum QStandardPaths::LocateOption
flags QStandardPaths::LocateOptions

Esta enumeración describe los diferentes indicadores que se pueden utilizar para controlar el comportamiento de QStandardPaths::locate y QStandardPaths::locateAll.

ConstanteValorDescripción
QStandardPaths::LocateFile0x0Devuelve solo archivos
QStandardPaths::LocateDirectory0x1Devuelve solo directorios

El tipo LocateOptions es una definición de tipo (typedef) para QFlags<LocateOption>. Almacena una combinación OR de valores de LocateOption.

enum QStandardPaths::StandardLocation

Esta enumeración describe las diferentes ubicaciones que se pueden consultar mediante métodos como QStandardPaths::writableLocation, QStandardPaths::standardLocations y QStandardPaths::displayName.

QStandardPaths Describe cada ubicación a lo largo de dos ejes independientes: el ámbito de la aplicación (privado para la aplicación que realiza la llamada o compartido entre aplicaciones) y el ámbito del usuario (con raíz en los directorios del usuario que realiza la llamada o en todo el sistema). Cada valor de la enumeración que figura a continuación indica su ámbito de aplicación; las tablas de la plataforma que aparecen más abajo muestran su ámbito de usuario.

El intercambio de datos con otros usuarios queda fuera del ámbito de QStandardPaths.

Ámbito de la aplicación

Una ubicación puede ser específica de la aplicación (privada para la aplicación que la invoca) o genérica (compartida entre aplicaciones ejecutadas por el mismo usuario). Se debe dar por hecho que otras aplicaciones no pueden acceder a las ubicaciones específicas de la aplicación, incluso cuando las ejecute el mismo usuario.

Aplicaciones en entorno aislado

En el caso de las aplicaciones en entorno aislado (sandbox), en plataformas como iOS, Android o macOS, incluso las ubicaciones genéricas pueden estar arraigadas en el contenedor de entorno aislado de la aplicación (<APPROOT> en las tablas siguientes). En la práctica, esto elimina la distinción entre el ámbito de la aplicación y el del sistema, de modo que todas las ubicaciones pasan a ser, en la práctica, específicas de la aplicación, y los directorios compartidos del usuario en todo el sistema solo son accesibles a través de los selectores proporcionados por el sistema, por ejemplo, QFileDialog.

Ámbito de usuario

Una ubicación puede ser local del usuario (con raíz en el directorio de inicio o en los directorios específicos del usuario que realiza la llamada) o de todo el sistema (creada por el sistema operativo o por los gestores de paquetes, compartida entre usuarios y, por lo general, de solo lectura para las aplicaciones).

Al consultar ` writableLocation()` se obtiene el directorio en el que deben escribirse los archivos, que suele tener un ámbito de usuario. En el caso de las ubicaciones específicas de una aplicación, el ámbito también se limita a la aplicación que realiza la llamada.

Al consultar ` standardLocations()` se devuelve primero la ruta en la que se puede escribir (si se puede determinar), seguida de cero o más ubicaciones adicionales, incluyendo tanto las alternativas locales del usuario como las de todo el sistema. Las ubicaciones adicionales son utilizadas por ` locate()` y ` locateAll()` para buscar archivos existentes.

Aplicaciones en entorno aislado

En el caso de las aplicaciones en entorno aislado, las ubicaciones de todo el sistema suelen quedar fuera del contenedor de aislamiento de la aplicación y es posible que, desde el punto de vista de la aplicación, ni siquiera existan, y mucho menos que sean legibles o grabables. No obstante, se incluyen en las tablas de la plataforma que figuran a continuación para mantener la simetría con el caso sin entorno aislado y para abarcar aquellas aplicaciones a las que se les ha concedido acceso mediante derechos o selectores controlados por el usuario. Quienes realicen la llamada no deben dar por sentado que todas las entradas devueltas por standardLocations() existan o sean accesibles.

ConstanteValorDescripción
QStandardPaths::DesktopLocation0El directorio del escritorio del usuario. En sistemas que no cuentan con el concepto de escritorio, equivale a «HomeLocation». Genérico.
QStandardPaths::DocumentsLocation1Directorio que contiene archivos de documentos. La ruta devuelta nunca está vacía. Genérico.
QStandardPaths::FontsLocation2Directorio que contiene fuentes. Ten en cuenta que la instalación de fuentes puede requerir operaciones adicionales específicas de la plataforma. Genérico.
QStandardPaths::ApplicationsLocation3Directorio que contiene aplicaciones (ya sean ejecutables, paquetes de aplicaciones o accesos directos a ellas). Ten en cuenta que la instalación de aplicaciones puede requerir operaciones adicionales específicas de la plataforma. Los archivos, carpetas o accesos directos de este directorio son específicos de la plataforma. Genérico.
QStandardPaths::MusicLocation4Directorio que contiene música u otros archivos de audio. Si no existe dicho directorio, se devuelve una alternativa adecuada para almacenar documentos. Genérico.
QStandardPaths::MoviesLocation5Directorio que contiene películas y vídeos. Si no existe dicho directorio, se devuelve una alternativa adecuada para almacenar documentos. Genérico.
QStandardPaths::PicturesLocation6Directorio que contiene imágenes o fotos. Si no existe dicho directorio, se devuelve una alternativa adecuada para almacenar documentos. Genérico.
QStandardPaths::TempLocation7Directorio en el que se pueden almacenar archivos temporales. El valor devuelto puede ser específico de la aplicación, compartido con otras aplicaciones de este usuario o incluso de todo el sistema. La ruta devuelta nunca está vacía. Varía.
QStandardPaths::HomeLocation8El directorio de inicio del usuario (el mismo que QDir::homePath()). En sistemas Unix, equivale a la variable de entorno HOME. La ruta devuelta nunca está vacía. Genérico.
QStandardPaths::AppLocalDataLocation9La ruta de datos locales en Windows. En todas las demás plataformas, es igual a AppDataLocation. Específico de la aplicación. Este valor de enumeración se añadió en Qt 5.4.
QStandardPaths::CacheLocation10Directorio en el que deben escribirse los datos no esenciales (almacenados en caché). La ruta devuelta nunca está vacía. Específico de la aplicación.
QStandardPaths::GenericCacheLocation15Directorio en el que deben escribirse los datos no esenciales (almacenados en caché) compartidos entre aplicaciones. Ten en cuenta que la ruta devuelta puede estar vacía si el sistema no admite el concepto de caché compartida. Genérico.
QStandardPaths::GenericDataLocation11Directorio en el que se pueden almacenar los datos persistentes compartidos entre aplicaciones. La ruta devuelta nunca está vacía. Genérico.
QStandardPaths::RuntimeLocation12Directorio en el que deben escribirse los archivos de comunicación en tiempo de ejecución, como los sockets locales de Unix. La ruta devuelta puede estar vacía en algunos sistemas. Genérico.
QStandardPaths::ConfigLocation13Directorio en el que deben escribirse los archivos de configuración. La ruta devuelta nunca está vacía. Puede ser genérica o específica de la aplicación (véanse AppConfigLocation y GenericConfigLocation para variantes explícitas). Varía.
QStandardPaths::DownloadLocation14Directorio para archivos descargados. Si no existe dicho directorio, se devuelve una alternativa adecuada para almacenar documentos. Genérico.
QStandardPaths::GenericConfigLocation16Directorio en el que deben escribirse los archivos de configuración compartidos entre varias aplicaciones. La ruta devuelta nunca está vacía. Genérico.
QStandardPaths::AppDataLocation17Directorio en el que se pueden almacenar los datos persistentes de la aplicación. Para obtener una ruta en la que almacenar datos que se vayan a compartir con otras aplicaciones, utilice GenericDataLocation. La ruta devuelta nunca está vacía. En Windows, devuelve la ruta de roaming. Específico de la aplicación. Este valor de enumeración se añadió en Qt 5.4.
QStandardPaths::AppConfigLocation18Directorio en el que deben escribirse los archivos de configuración. La ruta devuelta nunca está vacía. Específico de la aplicación. Este valor de enumeración se añadió en Qt 5.5.
QStandardPaths::PublicShareLocation19Directorio en el que se pueden almacenar archivos y directorios compartidos públicamente. Tenga en cuenta que la ruta devuelta puede estar vacía si el sistema no dispone de un concepto de ubicación compartida públicamente. Genérico. Este valor de enumeración se añadió en Qt 6.4.
QStandardPaths::TemplatesLocation20Directorio en el que se pueden almacenar los archivos de plantillas. Ten en cuenta que la ruta devuelta puede estar vacía si el sistema no cuenta con el concepto de ubicación de plantillas. Genérico. Este valor de enumeración se añadió en Qt 6.4.
QStandardPaths::StateLocation (since Qt 6.7)21Directorio en el que deben escribirse los archivos de datos de estado de la aplicación. La ruta devuelta nunca está vacía. Específico de la aplicación.
QStandardPaths::GenericStateLocation (since Qt 6.7)22Directorio en el que deben escribirse los archivos de datos de estado compartidos entre aplicaciones. La ruta devuelta nunca está vacía. Genérico.

La siguiente tabla ofrece ejemplos de rutas en diferentes sistemas operativos. La primera ruta es la ruta en la que se puede escribir (salvo que se indique lo contrario). Otras rutas adicionales, si las hay, representan ubicaciones en las que no se puede escribir.

Tipo de rutamacOSWindows
Ubicación en el escritorio«~/Escritorio»«C:/Usuarios/<USUARIO>/Escritorio»
Ubicación de «Documentos»"~/Documentos""C:/Usuarios/<USUARIO>/Documentos"
Ubicación de las fuentes"~/Biblioteca/Fuentes", "/Biblioteca/Fuentes", "/Sistema/Biblioteca/Fuentes""C:/Windows/Fuentes" (sin permiso de escritura)
Ubicación de las aplicaciones"~/Aplicaciones", "/Aplicaciones""C:/Usuarios/<USUARIO>/AppData/Roaming/Microsoft/Windows/Menú de inicio/Programas"
Ubicación de la música«~/Música»«C:/Usuarios/<USUARIO>/Música»
Ubicación de películas"~/Películas"«C:/Usuarios/<USUARIO>/Vídeos»
Ubicación de imágenes"~/Imágenes"«C:/Usuarios/<USUARIO>/Imágenes»
Ubicación temporalGenerada aleatoriamente por el sistema operativo«C:/Usuarios/<USUARIO>/AppData/Local/Temp»
Ubicación de inicio"~"«C:/Usuarios/<USUARIO>»
Ubicación de AppLocalData"~/Biblioteca/Application Support/<NOMBRE DE LA APLICACIÓN>", "/Biblioteca/Application Support/<NOMBRE DE LA APLICACIÓN>". "<DIRECTORIO DE LA APLICACIÓN>/../Recursos""C:/Usuarios/<USUARIO>/AppData/Local/<NOMBRE DE LA APLICACIÓN>", "C:/ProgramData/<NOMBRE DE LA APLICACIÓN>", "<DIRECTORIO DE LA APLICACIÓN>", "<DIRECTORIO DE LA APLICACIÓN>/data", "<DIRECTORIO DE LA APLICACIÓN>/data/<NOMBRE DE LA APLICACIÓN>"
Ubicación de la caché"~/Biblioteca/Cachés/<NOMBRE_DE_LA_APLICACIÓN>", "/Biblioteca/Cachés/<NOMBRE_DE_LA_APLICACIÓN>""C:/Usuarios/<USUARIO>/AppData/Local/<NOMBRE DE LA APLICACIÓN>/cache"
Ubicación del estado«~/Library/Preferences/<APPNAME>/State»"C:/Usuarios/<USUARIO>/AppData/Local/<NOMBRE_DE_LA_APLICACIÓN>/State", "C:/ProgramData/<NOMBRE_DE_LA_APLICACIÓN>/State"
Ubicación de datos genéricos"~/Biblioteca/Application Support", "/Biblioteca/Application Support""C:/Usuarios/<USUARIO>/AppData/Local", "C:/ProgramData", "<APPDIR>", "<APPDIR>/data"
RuntimeLocation"~/Biblioteca/Application Support"«C:/Usuarios/<USUARIO>»
ConfigLocation«~/Biblioteca/Preferencias», «/Biblioteca/Preferencias»"C:/Usuarios/<USUARIO>/AppData/Local/<NOMBRE DE LA APLICACIÓN>", "C:/ProgramData/<NOMBRE DE LA APLICACIÓN>"
GenericConfigLocation"~/Biblioteca/Preferencias", "/Biblioteca/Preferencias""C:/Usuarios/<USUARIO>/AppData/Local", "C:/ProgramData"
DownloadLocation"~/Descargas""C:/Usuarios/<USUARIO>/Descargas"
UbicaciónGenéricaDe la Caché"~/Biblioteca/Cachés", "/Biblioteca/Cachés", "/Sistema/Biblioteca/Cachés""C:/Usuarios/<USUARIO>/AppData/Local/cache"
Ubicación genérica del estado"~/Biblioteca/Preferencias/State""C:/Usuarios/<USUARIO>/AppData/Local/State", "C:/ProgramData/State"
Ubicación de AppData"~/Biblioteca/Application Support/<NOMBRE_APLICACIÓN>", "/Biblioteca/Application Support/<NOMBRE_APLICACIÓN>". "<DIRECTORIO_APLICACIÓN>/../Recursos""C:/Usuarios/<USUARIO>/AppData/Roaming/<NOMBRE DE LA APLICACIÓN>", "C:/ProgramData/<NOMBRE DE LA APLICACIÓN>", "<DIRECTORIO DE LA APLICACIÓN>", "<DIRECTORIO DE LA APLICACIÓN>/data", "<DIRECTORIO DE LA APLICACIÓN>/data/<NOMBRE DE LA APLICACIÓN>"
AppConfigLocation"~/Biblioteca/Preferencias/<NOMBRE_DE_LA_APLICACIÓN>", "/Biblioteca/Preferencias/<NOMBRE_DE_LA_APLICACIÓN>""C:/Usuarios/<USUARIO>/AppData/Local/<NOMBRE DE LA APLICACIÓN>", "C:/ProgramData/<NOMBRE DE LA APLICACIÓN>"
PublicShareLocation"~/Público""C:/Usuarios/Público"
Ubicación de plantillasno compatible"C:/Usuarios/<USUARIO>/AppData/Roaming/Microsoft/Windows/Plantillas"

Nota: En macOS, cuando la aplicación se ejecuta en un entorno aislado (sandbox), el sistema operativo redirige de forma transparente el directorio de inicio del usuario a un contenedor específico de la aplicación en ~/Library/Containers/<BUNDLE-ID>/Data. La tabla de macOS anterior sigue siendo válida, y ~ se resuelve efectivamente como <APPROOT> para las entradas con raíz en el usuario. Las alternativas a nivel de sistema, como /Library/..., /System/Library/... y <APPDIR>/../Resources, se incluyen por simetría, pero normalmente no son accesibles sin permisos explícitos.

Tipo de rutaLinux y otros sistemas operativos UNIX
Ubicación del escritorio«~/Desktop»
Ubicación de documentos«~/Documentos»
Ubicación de las fuentes«~/.fonts», «~/.local/share/fonts», «/usr/local/share/fonts», «/usr/share/fonts»
Ubicación de las aplicaciones«~/.local/share/applications», «/usr/local/share/applications», «/usr/share/applications»
Ubicación de la música«~/Música»
Ubicación de las películas«~/Vídeos»
Ubicación de imágenes«~/Imágenes»
Ubicación temporal"/tmp"
Ubicación de inicio"~"
Ubicación de datos locales de la aplicación"~/.local/share/<NOMBRE DE LA APLICACIÓN>", "/usr/local/share/<NOMBRE DE LA APLICACIÓN>", "/usr/share/<NOMBRE DE LA APLICACIÓN>"
Ubicación de la caché"~/.cache/<NOMBRE DE LA APLICACIÓN>"
StateLocation"~/.local/state/<NOMBRE_DE_LA_APLICACIÓN>"
Ubicación de datos genéricos"~/.local/share", "/usr/local/share", "/usr/share"
Ubicación de tiempo de ejecución"/run/user/<USER>"
Ubicación de configuración"~/.config", "/etc/xdg"
Ubicación genérica de configuración"~/.config", "/etc/xdg"
Ubicación de descargas"~/Descargas"
Ubicación genérica de la caché"~/.cache"
Ubicación genérica del estado"~/.local/state"
Ubicación de datos de la aplicación"~/.local/share/<NOMBRE DE LA APLICACIÓN>", "/usr/local/share/<NOMBRE DE LA APLICACIÓN>", "/usr/share/<NOMBRE DE LA APLICACIÓN>"
Ubicación de la configuración de la aplicación"~/.config/<NOMBRE_DE_LA_APLICACIÓN>", "/etc/xdg/<NOMBRE_DE_LA_APLICACIÓN>"
Ubicación de recursos compartidos públicos"~/Public"
TemplatesLocation"~/Plantillas"
Tipo de rutaAndroidiOS
Ubicación en el escritorio"<APPROOT>/files"«<APPROOT>/Documents/Desktop»
Ubicación de documentos«<USER>/Documentos» [*], «<USER>/<APPNAME>/Documentos»«<APPROOT>/Documentos»
Ubicación de las fuentes"/system/fonts" (sin permiso de escritura)«<APPROOT>/Library/Fonts»
Ubicación de las aplicacionesNo compatible (directorio no legible)No compatible
Ubicación de la música«<USER>/Music» [*], «<USER>/<APPNAME>/Music»«<APPROOT>/Documentos/Música»
Ubicación de películas«<USUARIO>/Películas» [*], «<USUARIO>/<NOMBRE DE LA APLICACIÓN>/Películas»«<APPROOT>/Documentos/Películas»
Ubicación de imágenes"<USER>/Imágenes" [*], "<USER>/<APPNAME>/Imágenes"«<APPROOT>/Documentos/Imágenes», «assets-library://»
Ubicación temporal"<APPROOT>/cache"«<APPROOT>/tmp»
HomeLocation"<APPROOT>/files"definida por el sistema
Ubicación de datos locales de la aplicación"<APPROOT>/files", "<USER>/<APPNAME>/files"«<APPROOT>/Library/Application Support»
CacheLocation"<APPROOT>/cache", "<USER>/<APPNAME>/cache"«<APPROOT>/Library/Caches»
StateLocation"<APPROOT>/files/state""<APPROOT>/Library/Preferences/<APPNAME>/State"
Ubicación genérica del estado (hay un estado compartido)«<APPROOT>/files/state»"<APPROOT>/Library/Preferences/State"
Ubicación genérica de datos«<USER>» [*] o «<USER>/<APPNAME>/files»«<APPROOT>/Library/Application Support»
RuntimeLocation«<APPROOT>/cache»«<APPROOT>/Library/Application Support»
ConfigLocation"<APPROOT>/files/settings"«<APPROOT>/Library/Preferences»
GenericConfigLocation"<APPROOT>/files/settings" (no hay ajustes compartidos)"<APPROOT>/Library/Preferences"
DownloadLocation"<USER>/Descargas" [*], "<USER>/<APPNAME>/Descargas""<APPROOT>/Documentos/Descargas"
Ubicación de la caché genérica"<APPROOT>/cache" (no hay caché compartida)«<RAÍZ DE LA APLICACIÓN>/Biblioteca/Cachés»
Ubicación de AppData"<APPROOT>/files", "<USER>/<APPNAME>/files"«<APPROOT>/Library/Application Support»
AppConfigLocation«<APPROOT>/files/settings»«<APPROOT>/Library/Preferences/<APPNAME>»
PublicShareLocationno compatible"<APPROOT>/Public"
TemplatesLocationNo compatibleNo compatible

En la tabla anterior, <APPNAME> suele ser el nombre de la organización, el nombre de la aplicación o ambos, o bien un nombre único generado durante el empaquetado. Del mismo modo, <APPROOT> es la ubicación donde está instalada esta aplicación (a menudo un entorno aislado). <APPDIR> es el directorio que contiene el ejecutable de la aplicación.

No se debe confiar en las rutas anteriores, ya que pueden cambiar según la configuración del sistema operativo, la configuración regional o en futuras versiones de Qt.

Nota: En Android, las aplicaciones con archivos abiertos en el almacenamiento externo (ubicaciones <USER>) se cerrarán si se desmonta el almacenamiento externo.

Nota: En Android 6.0 (API 23) o superior, se debe solicitar el permiso «WRITE_EXTERNAL_STORAGE» en tiempo de ejecución al utilizar QStandardPaths::writableLocation o QStandardPaths::standardLocations.

Nota: En Android, para leer o escribir en GenericDataLocation es necesario que se haya concedido el permiso READ_EXTERNAL_STORAGE/WRITE_EXTERNAL_STORAGE.

Nota: [ *] En Android 11 y versiones posteriores, ya no se puede acceder directamente a los directorios públicos en el modo de almacenamiento con ámbito. Por lo tanto, no se devuelven rutas del tipo "<USER>/DirName". En su lugar, puedes utilizar QFileDialog, que utiliza el Marco de Acceso al Almacenamiento (SAF) para acceder a dichos directorios.

Nota: En iOS, si se pasa QStandardPaths::standardLocations(QStandardPaths::PicturesLocation).last() como argumento a QFileDialog::setDirectory(), se utilizará 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. Esta característica se añadió en Qt 5.5.

Véase también writableLocation(), standardLocations(), displayName(), locate() y locateAll().

Documentación de funciones miembro

[static] QString QStandardPaths::displayName(QStandardPaths::StandardLocation type)

Devuelve un nombre de visualización localizado para la ubicación indicada type o un QString vacío si no se encuentra ninguna ubicación relevante.

[static] QString QStandardPaths::findExecutable(const QString &executableName, const QStringList &paths = QStringList())

Busca el ejecutable denominado « executableName » en la ruta especificada « paths », o en las rutas del sistema si « paths » está vacía.

En la mayoría de los sistemas operativos, la ruta del sistema viene determinada por la variable de entorno PATH. Los directorios en los que buscar el ejecutable se pueden establecer en el argumento paths. Para buscar tanto en tus propias rutas como en las del sistema, llama a `findExecutable` dos veces: una con `paths` definido y otra con `paths` vacío. Los enlaces simbólicos no se resuelven para mantener el comportamiento en el caso de los ejecutables cuyo funcionamiento depende del nombre con el que se invocan.

Nota: En Windows, las extensiones habituales de los ejecutables (de la variable de entorno PATHEXT) se añaden automáticamente. Por ejemplo, la llamada findExecutable("foo") busca foo.exe o foo.bat si existen.

Devuelve la ruta absoluta del archivo ejecutable o una cadena vacía si no se encuentra.

Si el executableName proporcionado es una ruta absoluta que apunta a un ejecutable, se devuelve su ruta limpia.

[static] QString QStandardPaths::locate(QStandardPaths::StandardLocation type, const QString &fileName, QStandardPaths::LocateOptions options = LocateFile)

Busca un archivo o directorio llamado « fileName » en las ubicaciones predeterminadas de « type ».

El indicador « options » permite especificar si se deben buscar archivos o directorios. De forma predeterminada, este indicador está establecido en « LocateFile ».

Devuelve la ruta absoluta al primer archivo o directorio encontrado; en caso contrario, devuelve una cadena vacía.

[static] QStringList QStandardPaths::locateAll(QStandardPaths::StandardLocation type, const QString &fileName, QStandardPaths::LocateOptions options = LocateFile)

Busca todos los archivos o directorios con el nombre « fileName » en las ubicaciones estándar de « type ».

El indicador « options » permite especificar si se buscan archivos o directorios. De forma predeterminada, este indicador está establecido en « LocateFile ».

Devuelve la lista de todos los archivos que se han encontrado.

[static] void QStandardPaths::setTestModeEnabled(bool testMode)

Si testMode es true, se activa un «modo de prueba» especial en QStandardPaths, que cambia las ubicaciones en las que se puede escribir para que apunten a directorios de prueba. Esto evita que las pruebas automáticas lean o escriban en la configuración del usuario actual.

Afecta a las ubicaciones en las que los programas de prueba podrían escribir archivos: GenericDataLocation, AppDataLocation, ConfigLocation, GenericConfigLocation, AppConfigLocation, StateLocation, GenericStateLocation, GenericCacheLocation y CacheLocation. El resto de ubicaciones no se ven afectadas.

En Unix, XDG_DATA_HOME se establece en ~/.qttest/share, XDG_CONFIG_HOME se establece en ~/.qttest/config, XDG_STATE_HOME se establece en ~/.qttest/state y XDG_CACHE_HOME se establece en ~/.qttest/cache.

En macOS, los datos se guardan en ~/.qttest/Application Support, la caché en ~/.qttest/Cache y la configuración en ~/.qttest/Preferences.

En Windows, todo se guarda en un directorio llamado «qttest» dentro de %APPDATA%.

[static] QStringList QStandardPaths::standardLocations(QStandardPaths::StandardLocation type)

Devuelve todos los directorios en los que se encuentran los archivos de tipo « type ».

La lista de directorios se ordena de mayor a menor prioridad, comenzando por writableLocation() si se puede determinar. Esta lista está vacía si no se han definido ubicaciones para el tipo.

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

[static] QString QStandardPaths::writableLocation(QStandardPaths::StandardLocation type)

Devuelve el directorio en el que deben guardarse los archivos de « type », o una cadena vacía si no se puede determinar la ubicación.

Nota: Es posible quela ubicación de almacenamiento devuelta no exista; es decir, puede que el sistema o el usuario tengan que crearla.

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