juce_ContentSharer.h

Go to the documentation of this file.

/*
  ==============================================================================
 
   This file is part of the JUCE library.
   Copyright (c) 2022 - Raw Material Software Limited
 
   JUCE is an open source library subject to commercial or open-source
   licensing.
 
   By using JUCE, you agree to the terms of both the JUCE 7 End-User License
   Agreement and JUCE Privacy Policy.
 
   End User License Agreement: www.juce.com/juce-7-licence
   Privacy Policy: www.juce.com/juce-privacy-policy
 
   Or: You may also use this code under the terms of the GPL v3 (see
   www.gnu.org/licenses).
 
   JUCE IS PROVIDED "AS IS" WITHOUT ANY WARRANTY, AND ALL WARRANTIES, WHETHER
   EXPRESSED OR IMPLIED, INCLUDING MERCHANTABILITY AND FITNESS FOR PURPOSE, ARE
   DISCLAIMED.
 
  ==============================================================================
*/
 
#pragma once
 
namespace juce
{

class JUCE_API ContentSharer  : public DeletedAtShutdown
{
public:
    JUCE_DECLARE_SINGLETON (ContentSharer, false)
 
    
    void shareFiles (const Array<URL>& files,
                     std::function<void (bool /*success*/, const String& /*error*/)> callback);

    void shareText (const String& text,
                    std::function<void (bool /*success*/, const String& /*error*/)> callback);

    void shareImages (const Array<Image>& images,
                      std::function<void (bool /*success*/, const String& /*error*/)> callback,
                      ImageFileFormat* imageFileFormatToUse = nullptr);

    void shareData (const MemoryBlock& mb,
                    std::function<void (bool /*success*/, const String& /*error*/)> callback);
 
private:
    ContentSharer();
    ~ContentSharer();
 
    Array<File> temporaryFiles;
 
    std::function<void (bool, String)> callback;
 
  #if JUCE_CONTENT_SHARING
    struct Pimpl
    {
        virtual ~Pimpl() {}
        virtual void shareFiles (const Array<URL>& files) = 0;
        virtual void shareText (const String& text) = 0;
    };
 
    std::unique_ptr<Pimpl> pimpl;
    Pimpl* createPimpl();
 
    void startNewShare (std::function<void (bool, const String&)>);
 
    class ContentSharerNativeImpl;
    friend class ContentSharerNativeImpl;
 
    class PrepareImagesThread;
    friend class PrepareImagesThread;
    std::unique_ptr<PrepareImagesThread> prepareImagesThread;
 
    class PrepareDataThread;
    friend class PrepareDataThread;
    std::unique_ptr<PrepareDataThread> prepareDataThread;
 
    void filesToSharePrepared();
  #endif
 
    void deleteTemporaryFiles();
    void sharingFinished (bool, const String&);
};
 
} // namespace juce