// Copyright © 2014 The CefSharp Authors. All rights reserved.
|
//
|
// Use of this source code is governed by a BSD-style license that can be found in the LICENSE file.
|
|
using System.Collections.Generic;
|
|
namespace CefSharp
|
{
|
/// <summary>
|
/// Implement this interface to handle dialog events. The methods of this class will be called on the CEF UI thread.
|
/// </summary>
|
public interface IDialogHandler
|
{
|
/// <summary>
|
/// Runs a file chooser dialog.
|
/// </summary>
|
/// <example>
|
/// To test assign something like TempFileDialogHandler (from CefSharp.Example) to DialogHandler e.g.
|
/// <code>
|
/// browser.DialogHandler = new TempFileDialogHandler();
|
/// </code>
|
/// Example URL to use for file browsing http://www.cs.tut.fi/~jkorpela/forms/file.html#example
|
/// Simply click browse, the space next to the browse button should be populated with a randomly generated filename.
|
/// </example>
|
/// <param name="chromiumWebBrowser">the ChromiumWebBrowser control</param>
|
/// <param name="browser">the browser object</param>
|
/// <param name="mode">represents the type of dialog to display</param>
|
/// <param name="flags">further specifies behavior dialog should exhibit</param>
|
/// <param name="title">the title to be used for the dialog. It may be empty to show the default title ("Open" or "Save"
|
/// depending on the mode).</param>
|
/// <param name="defaultFilePath">is the path with optional directory and/or file name component that
|
/// should be initially selected in the dialog.</param>
|
/// <param name="acceptFilters">are used to restrict the selectable file types and may any combination of
|
/// (a) valid lower-cased MIME types (e.g. "text/*" or "image/*"),
|
/// (b) individual file extensions (e.g. ".txt" or ".png"),
|
/// (c) combined description and file extension delimited using "|" and ";" (e.g. "Image Types|.png;.gif;.jpg").</param>
|
/// <param name="selectedAcceptFilter">is the 0-based index of the filter that should be selected by default.</param>
|
/// <param name="callback">Callback interface for asynchronous continuation of file dialog requests.</param>
|
/// <returns>To display a custom dialog return true. To display the default dialog return false.</returns>
|
bool OnFileDialog(
|
IWebBrowser chromiumWebBrowser,
|
IBrowser browser,
|
CefFileDialogMode mode,
|
CefFileDialogFlags flags,
|
string title,
|
string defaultFilePath,
|
List<string> acceptFilters,
|
int selectedAcceptFilter,
|
IFileDialogCallback callback);
|
}
|
}
|
