Represents a common dialog box that displays available colors along with controls that enable the user to define custom colors.
This class provides a way to prompt the user to select a color. The color can be picked either through a list of preset colors or using the visual picker. Once a color is selected, the details of the new color will be shown in a GroupBox, along with a visual comparison of the old and new color.
For a full list of properties, methods and events see the API documentation.
The ColorDialog features several ways to get the perfect color. The Hex, RGB, or HSB value can be manually entered, the user can pick a value from the Preset Colors, or fine tune a value with the Visual Picker.
The ColorDialog component can be customized by applying appearances to each individual control within the dialog. This includes the textboxes, picker, and more.
To customize these controls, create a new class that inherits from ColorDialogUI, add the custom ColorDialog constructor, and modify the controls within it:
After applying the ColorDialog's DialogTemplate property to the new class, the resulting popup will look like this:
For instructions on how to use a custom template to offer advanced customization of the ColorDialog, see below.
Prompts the user to open a file from the server.
This class allows you to check whether a file exists and to open it. The ShowReadOnly property determines whether a read-only check box appears in the dialog box. The ReadOnlyChecked property indicates whether the read-only check box is checked.
Most of the core functionality for this class is found in the FileDialog class.
If you want to give the user the ability to select a folder instead of a file, use FolderBrowserDialog instead.
For a full list of properties, methods and events see the API documentation.
The OpenFileDialog is able to filter the types of files shown to the user based on a given pattern. For example, the filter C# files|.cs|All files|.* will by default show users files in the given directory ending with .cs. The filter can be modified by changing the selection in the dropdown on the bottom right.
The FileDialog.FileName property returns the path selected by the user, which is the virtual path relative to the root. To retrieve the physical path on the server use FileDialog.MapPath().
The OpenFileDialog component has an optional "?" (Help) tool that allows you to process and display information to help users navigate the control.
In order to view files, you must add at least one IFileSystemProvider to the Roots collection before showing the dialog.
The OpenFileDialog component can be customized by applying appearances to each individual control within the dialog. This includes the textboxes, picker, and more.
To customize these controls, create a new class that inherits from FileDialogUI, add the custom OpenFileDialog constructor, and modify the controls within it:
After applying the OpenFileDialog's DialogTemplate property to the new class, the resulting popup will look like this:
For instructions on how to use a custom template to offer advanced customization of the OpenFileDialog, see below.
Allows the user to select a folder from one of the Roots.
This class provides a way to prompt the user to browse, create, and eventually select a folder. Use this class when you only want to allow the user to select folders, not files. Browsing of the folders is done through a tree control. Only folders from the file system can be selected; virtual folders cannot.
Typically, after creating a new FolderBrowserDialog, you set the RootFolder to the location from which to start browsing. Optionally, you can set the SelectedPath to an absolute path of a subfolder of RootFolder that will initially be selected. You can also optionally set the Description property to provide additional instructions to the user. Finally, call the ShowDialog method to display the dialog box to the user. When the dialog box is closed and the dialog box result from ShowDialog is DialogResult.OK, the SelectedPath will be a string containing the path to the selected folder.
You can use the ShowNewFolderButton property to control if the user is able to create new folders with the New Folder button.
FolderBrowserDialog is a modal dialog box; therefore, when shown, it blocks the rest of the application until the user has chosen a folder. When a dialog box is displayed modally, no input (keyboard or mouse click) can occur except to objects on the dialog box. The program must hide or close the dialog box (usually in response to some user action) before input to the calling program can occur.
For a full list of properties, methods and events see the API documentation.
The FolderBrowserDialog component allows for setting multiple directory roots to navigate and select a file.
Directories must have the appropriate read permissions to be discoverable by the Wisej application.
The FolderBrowserDialog.SelectedPath property returns the path selected by the user, which is the virtual path relative to the root. To retrieve the physical path on the server use FileBrowserDialog.MapPath().
The FolderBrowserDialog component has an optional "?" (Help) tool that allows you to process and display information to help users navigate the control.
The FolderBrowserDialog component can be customized by applying appearances to each individual control within the dialog. This includes the tree view, buttons, and bottom panel.
To customize these controls, create a new class that inherits from FolderBrowserDialogUI, add the custom FolderBrowserDialog constructor, and modify the controls within it:
After applying the FolderBrowserDialog's DialogTemplate property to the new class, the resulting popup will look like this:
For instructions on how to use a custom template to offer advanced customization of the FolderBrowserDialog, see below.
The FolderBrowserDialog is fully customizable through the DialogTemplate property. This property, when set, will provide a custom interface for allowing users to select a directory from one of the given Roots.
To build a new custom template, create a new Inherited Window in the project.
After clicking Add, you'll be shown a list of inheritable windows. Select FolderBrowserDialogUI and click OK.
Using a custom template requires implementing a custom constructor for processing dialog initialization.
The custom constructor has one argument, a FolderBrowserDialog instance that contains the configuration required to build the dialog.
Prompts the user to select a location for saving a file on the server.
This class can either open and overwrite an existing file or create a new file.
Most of the functionality for this class is found in the FileDialog class.
For a full list of properties, methods and events see the API documentation.
The SaveFileDialog is able to filter the types of files shown to the user based on a given pattern. For example, the filter Image Files|.jpg|All files|.* will by default show users files in the given directory ending with .jpg. The filter can be modified by changing the selection in the dropdown on the bottom right.
The FileDialog.FileName property returns the path selected by the user, which is the virtual path relative to the root. To retrieve the physical path on the server use FileDialog.MapPath().
The SaveFileDialog is able to validate whether or not a certain file exists before saving it to the disk. This can help prevent overwriting an existing file.
The SaveFileDialog component has an optional "?" (Help) tool that allows you to process and display information to help users navigate the control.
In order to view files, you must add at least one IFileSystemProvider to the Roots collection before showing the dialog.
The SaveFileDialog component can be customized by applying appearances to each individual control within the dialog. This includes the textboxes, picker, and more.
To customize these controls, create a new class that inherits from FileDialogUI, add the custom FileDialog constructor, and modify the controls within it:
After applying the OpenFileDialog's DialogTemplate property to the new class, the resulting popup will look like this:
For instructions on how to use a custom template to offer advanced customization of the SaveFileDialog, see below.