QFileOpenEvent Class
La clase QFileOpenEvent proporciona un evento que se envía cuando se produce una solicitud para abrir un archivo o una URL. Más información...
| Encabezado: | #include <QFileOpenEvent> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| Heredado de: | QEvent |
- Lista de todos los miembros, incluidos los heredados
- Miembros obsoletos
- QFileOpenEvent forma parte de las clases de eventos.
Funciones públicas
Funciones protegidas
| QFileOpenEvent(QFileOpenEvent &&) | |
| QFileOpenEvent & | operator=(QFileOpenEvent &&) |
| QFileOpenEvent & | operator=(const QFileOpenEvent &other) |
Descripción detallada
Los eventos de apertura de archivos se enviarán a la clase ` QApplication::instance()` cuando el sistema operativo solicite que se abra un archivo o una URL. Se trata de un evento de alto nivel que puede ser provocado por diferentes acciones del usuario en función de la plataforma; por ejemplo, al hacer doble clic en un archivo en el Finder o al arrastrar un archivo al icono de la aplicación en el Dock en macOS, o al compartir un archivo desde otra aplicación en iOS.
Este evento solo se utiliza para notificar a la aplicación una solicitud. Se puede ignorar sin problema si no se debe abrir el archivo.
Plataformas de Apple
Para activar el evento en las plataformas de Apple, la aplicación debe estar configurada para indicar al sistema operativo ante qué tipo de archivos debe reaccionar.
Por ejemplo, el siguiente archivo « Info.plist » declara que la aplicación puede actuar como visor de archivos PNG:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>CFBundleDocumentTypes</key>
<array>
<dict>
<key>LSItemContentTypes</key>
<array>
<string>public.png</string>
</array>
<key>CFBundleTypeRole</key>
<string>Viewer</string>
</dict>
</array>
</dict>
</plist>La siguiente clave también es necesaria en iOS para que la aplicación aparezca como una acción de «Abrir con» en, por ejemplo, la aplicación Archivos:
<key>UISupportsDocumentBrowser</key>
<true/>La siguiente implementación de una subclase de ` QApplication ` muestra cómo gestionar `QFileOpenEvent` para abrir el archivo que, por ejemplo, se ha arrastrado y soltado sobre el icono de la aplicación en el Dock.
#include <QApplication>
#include <QDebug>
#include <QFile>
#include <QFileOpenEvent>
#include <QPushButton>
class MyApplication : public QApplication
{
public:
MyApplication(int &argc, char **argv)
: QApplication(argc, argv)
{
}
bool event(QEvent *event) override
{
if (event->type() == QEvent::FileOpen) {
QFileOpenEvent *openEvent = static_cast<QFileOpenEvent *>(event);
const QUrl url = openEvent->url();
if (url.isLocalFile()) {
QFile localFile(url.toLocalFile());
// read from local file
} else if (url.isValid()) {
// process according to the URL's schema
} else {
// parse openEvent->file()
}
}
return QApplication::event(event);
}
};Ten en cuenta que no se garantiza que « QFileOpenEvent::file() » sea el nombre de un archivo local que se pueda abrir mediante ` QFile`. El contenido de la cadena depende de la aplicación de origen.
Documentación de las funciones miembro
[protected delete] QFileOpenEvent::QFileOpenEvent(QFileOpenEvent &&)
Crea una instancia de ` QFileOpenEvent`. Esta función se ha eliminado.
QString QFileOpenEvent::file() const
Devuelve el nombre del archivo que la aplicación debe abrir.
No se garantiza que sea la ruta a un archivo local.
QUrl QFileOpenEvent::url() const
Devuelve la URL que debe abrir la aplicación.
[protected delete] QFileOpenEvent &QFileOpenEvent::operator=(QFileOpenEvent &&)
Asigna mediante «Move» el objeto « other » a esta instancia de « QFileOpenEvent ». Esta función se elimina.
[noexcept protected default] QFileOpenEvent &QFileOpenEvent::operator=(const QFileOpenEvent &other)
Asigna por copia other a esta instancia de QFileOpenEvent.
© 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.