QFileOpenEvent 类

QFileOpenEvent 类提供当有打开文件或 URL 请求时将发送的事件。 更多...

头: #include <QFileOpenEvent>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui
继承: QEvent

公共函数

QString file () const
QUrl url () const

详细描述

文件打开事件会被发送给 QApplication::instance () 当操作系统请求文件或 URL 应被打开时。这是高级事件,可能由不同的用户动作 (取决于用户的桌面环境) 导致。例如:在 macOS 的 Finder 中双击文件图标。

此事件仅用于通知请求的应用程序。它可以被安全地忽略。

注意: 此类目前只支持 macOS。

macOS 范例

In order to trigger the event on macOS, the application must be configured to let the OS know what kind of file(s) it should react on.

例如,以下 Info.plist file declares that the application can act as a viewer for files with a PNG extension:

<?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>CFBundleTypeExtensions</key>
            <array>
                <string>png</string>
            </array>
            <key>CFBundleTypeRole</key>
            <string>Viewer</string>
        </dict>
    </array>
</dict>
</plist>
					

The following implementation of a QApplication subclass shows how to handle QFileOpenEvent to open the file that was, for example, dropped on the Dock icon of the application.

#include <QApplication>
#include <QDebug>
#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);
    }
};
					

Note how QFileOpenEvent::file() is not guaranteed to be the name of a local file that can be opened using QFile . The contents of the string depend on the source application.

成员函数文档编制

QString QFileOpenEvent:: file () const

Returns the name of the file that the application should open.

This is not guaranteed to be the path to a local file.

QUrl QFileOpenEvent:: url () const

Returns the url that the application should open.