FileDialogProvider.h

Go to the documentation of this file.

// Copyright 2015 - 2026, GIBIS-UNIFESP and the wiRedPanda contributors
// SPDX-License-Identifier: GPL-3.0-or-later

 
#pragma once
 
#include <QString>
 
class QWidget;

struct FileDialogResult
{
    QString fileName;        
    QString selectedFilter;  
};

class FileDialogProvider
{
public:
    // Same D0/D2 ABI-variant gap as App/Wiring/Port.h's destructor: FileDialogProvider is
    // abstract (getOpenFileName()/getSaveFileName() are pure virtual), so it can never be the
    // most-derived type of a real object -- its own vtable "deleting destructor" (D0) slot is
    // dead by construction. Every real instance (the static s_realProvider, or a test's
    // stack-local stub passed by address to FileDialogs::setProvider()) is destroyed via normal
    // scope/static-storage teardown, never `delete`d through this base pointer.
    virtual ~FileDialogProvider() = default; // LCOV_EXCL_LINE

    virtual QString getOpenFileName(QWidget *parent, const QString &caption,
                                    const QString &dir, const QString &filter) = 0;

    virtual FileDialogResult getSaveFileName(QWidget *parent, const QString &caption,
                                             const QString &dir, const QString &filter) = 0;
};

class RealFileDialogProvider : public FileDialogProvider
{
public:
    QString getOpenFileName(QWidget *parent, const QString &caption,
                            const QString &dir, const QString &filter) override;
 
    FileDialogResult getSaveFileName(QWidget *parent, const QString &caption,
                                     const QString &dir, const QString &filter) override;
};

namespace FileDialogs {

FileDialogProvider *provider();

FileDialogProvider *setProvider(FileDialogProvider *newProvider);
 
} // namespace FileDialogs