Класс QFileOpenEvent

Класс QFileOpenEvent предоставляет событие, которое будет отправлено при запросе открытия файла или URL-адреса. Подробнее...

• Список всех членов, включая унаследованные

Открытые функции

Подробное описание

События открытия файлов будут отправлены в QApplication::instance() при запросе операционной системы об открытии файла или URL-адреса. Это событие высокого уровня, которое может быть вызвано различными действиями пользователя в зависимости от используемой среды рабочего стола; например, двойным щелчком по значку файла в Finder на macOS.

Это событие используется только для уведомления приложения о запросе. Его можно безопасно пропустить.

Примечание: Этот класс в настоящее время поддерживается только для macOS.

Пример для macOS

Для того, чтобы сгенерировать событие на macOS, приложение должно быть настроено таким образом, чтобы операционная система знала, на какие типы файлов оно должно реагировать.

Например, следующий Info.plist файл объявляет, что приложение может действовать как просмотрщик для файлов с расширением 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>CFBundleTypeExtensions</key>
            <array>
                <string>png</string>
            </array>
            <key>CFBundleTypeRole</key>
            <string>Viewer</string>
        </dict>
    </array>
</dict>
</plist>

Следующая реализация подкласса QApplication выводит путь к файлу, который, например, был перетащен на значок приложения в Dock.

#include <QApplication>
#include <QFileOpenEvent>
#include <QtDebug>

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);
            qDebug() << "Open file" << openEvent->file();
        }

        return QApplication::event(event);
    }
};

Документация по функциям-членам

QString QFileOpenEvent::file() const

Возвращает файл, который открывается.

bool QFileOpenEvent::openFile(QFile &file, QIODevice::OpenMode flags) const

Открывает QFile по file, на который ссылается это событие, в режиме, указанном в flags. Возвращает true при успехе; в противном случае возвращает false.

Это необходимо, так как некоторые файлы нельзя открыть по имени, но требуют специфической информации, хранящейся в этом событии.

Функция была введена в Qt 4.8.

QUrl QFileOpenEvent::url() const

Возвращает URL-адрес, который открывается.

Функция была введена в Qt 4.6.