RobustToolbox/Robust.Client/Interfaces/UserInterface/IFileDialogManager.cs

using System.Threading.Tasks;

namespace Robust.Client.Interfaces.UserInterface
{
    /// <summary>
    ///     Manager for opening of file dialogs.
    /// </summary>
    /// <remarks>
    ///     File dialogs are native to the OS being ran on.
    ///     All operations are asynchronous to prevent locking up the main thread while the user makes his pick.
    /// </remarks>
    public interface IFileDialogManager
    {
        /// <summary>
        ///     Open a file dialog used for opening a single file.
        /// </summary>
        /// <returns>The path the user selected to open. Null if the user cancelled the action.</returns>
        Task<string> OpenFile();

        /// <summary>
        ///     Open a file dialog used for saving a single file.
        /// </summary>
        /// <returns>The path the user selected to save to. Null if the user cancelled the action.</returns>
        Task<string> SaveFile();

        /// <summary>
        ///     Open a file dialog used for opening a single folder.
        /// </summary>
        /// <returns>The path the user selected to open. Null if the user cancelled the action.</returns>
        Task<string> OpenFolder();
    }
}