IDialogHandlerOnFileDialog Method |
Version 130.1.90
Runs a file chooser dialog.
Namespace: CefSharpAssembly: CefSharp (in CefSharp.dll) Version: 129.0.110.0 (129.0.110.0)
Syntax bool OnFileDialog(
IWebBrowser chromiumWebBrowser,
IBrowser browser,
CefFileDialogMode mode,
string title,
string defaultFilePath,
IReadOnlyCollection<string> acceptFilters,
IReadOnlyCollection<string> acceptExtensions,
IReadOnlyCollection<string> acceptDescriptions,
IFileDialogCallback callback
)
bool OnFileDialog(
IWebBrowser^ chromiumWebBrowser,
IBrowser^ browser,
CefFileDialogMode mode,
String^ title,
String^ defaultFilePath,
IReadOnlyCollection<String^>^ acceptFilters,
IReadOnlyCollection<String^>^ acceptExtensions,
IReadOnlyCollection<String^>^ acceptDescriptions,
IFileDialogCallback^ callback
)
Parameters
- chromiumWebBrowser IWebBrowser
- the ChromiumWebBrowser control
- browser IBrowser
- the browser object
- mode CefFileDialogMode
- represents the type of dialog to display
- title String
- the title to be used for the dialog. It may be empty to show the default title ("Open" or "Save"
depending on the mode).
- defaultFilePath String
- is the path with optional directory and/or file name component that
should be initially selected in the dialog.
- acceptFilters IReadOnlyCollectionString
- 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").
- acceptExtensions IReadOnlyCollectionString
- provides the semicolon-delimited expansion of MIME
types to file extensions (if known, or empty string otherwise).
- acceptDescriptions IReadOnlyCollectionString
-
Provides the descriptions for MIME types (if known, or empty string otherwise).
For example, the 'image/*' mime type might have extensions ".png;.jpg;.bmp;..." and description 'Image Files'
- callback IFileDialogCallback
- Callback interface for asynchronous continuation of file dialog requests.
Return Value
BooleanTo display a custom dialog return true. To display the default dialog return false.
Example
To test assign something like TempFileDialogHandler (from CefSharp.Example) to DialogHandler e.g.
browser.DialogHandler = new TempFileDialogHandler();
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.
See Also