Class

RadOpenFileDialogForm

Initializes a new instance of the RadOpenFileDialogForm class. Sets up the form components, localizes user interface strings, and configures the explorer control for file browsing operations.

Declaration

public RadOpenFileDialogForm()

Gets or sets the default file extension that will be appended to file names when no extension is specified. The extension should include the leading period (e.g., ".txt"). If set to null or empty, no default extension is applied.

Declaration

public string DefaultExt { get; set; }

Property Value

Implements IFileExtensionFilterable.DefaultExt

Gets or sets a value indicating whether the dialog resolves shortcut links to their target files. When true, selecting a shortcut (.lnk) file returns the path to the target file. When false, selecting a shortcut returns the path to the shortcut file itself.

Declaration

public bool DereferenceLinks { get; set; }

Property Value

Gets the ExplorerControl that provides the main file browsing interface for the dialog. This control handles file system navigation, file selection, and display of files and folders.

Declaration

public override ExplorerControl ExplorerControl { get; }

Property Value

Overrides FileDialogFormBase.ExplorerControl

Gets or sets a collection of full file paths for all files selected by the user. When MultiSelect is false, this collection contains at most one item. When MultiSelect is true, this collection contains all selected file paths.

Declaration

public IEnumerable<string> FileNames { get; protected set; }

Property Value

Implements IMultiFilesSelectable.FileNames

Gets or sets the file name filter string that determines which files are displayed in the dialog. The filter string contains filter pairs separated by the pipe character, where each pair consists of a description and pattern. For example: "Text files (.txt)|.txt|All files (.)|."

Declaration

public string Filter { get; set; }

Property Value

Implements IFileExtensionFilterable.Filter

Gets or sets the index of the currently selected filter in the file type drop-down list. The index is one-based, where 1 corresponds to the first filter in the Filter string. Setting this to 0 or an invalid index will select the first available filter.

Declaration

public int FilterIndex { get; set; }

Property Value

Implements IFileExtensionFilterable.FilterIndex

Gets or sets a value indicating whether multiple files can be selected simultaneously in the dialog. When enabled, users can select multiple files using Ctrl+click or Shift+click, and the selected files can be accessed through FileNames.

Declaration

public bool MultiSelect { get; set; }

Property Value

Implements IMultiSelectable.MultiSelect

Gets the view model that manages the data and business logic for the open file dialog. The view model provides access to the underlying data structure, state management, and operations for the dialog.

Declaration

public OpenFileDialogViewModel OpenFileDialogViewModel { get; }

Property Value

Gets or sets a value indicating whether the read-only checkbox in the dialog is currently checked. When checked, this typically indicates that the selected file should be opened in read-only mode. This property only has an effect when ShowReadOnly is set to true.

Declaration

public bool ReadOnlyChecked { get; set; }

Property Value

Gets or sets a collection of file names (without path information) for all files selected by the user. This property provides only the file names and extensions, excluding the directory path. The collection corresponds to the files in FileNames but contains only the file names.

Declaration

public IEnumerable<string> SafeFileNames { get; protected set; }

Property Value

Implements IMultiFilesSelectable.SafeFileNames

Gets or sets a value indicating whether the dialog displays a read-only checkbox. When enabled, users can indicate their intention to open the selected file in read-only mode. The state of this checkbox can be accessed through the ReadOnlyChecked property.

Declaration

public bool ShowReadOnly { get; set; }

Property Value

Determines whether the cancel operation can be executed based on the current state of the dialog. This method handles special cases such as exiting edit mode for search text boxes and breadcrumb controls.

Declaration

protected override bool CanPressedCancelExecute()

Returns

Overrides FileDialogFormBase.CanPressedCancelExecute()

Clean up any resources being used.

Declaration

protected override void Dispose(bool disposing)

Parameters

Overrides RadForm.Dispose(bool)

Creates and configures a new OpenFileDialogViewModel instance for this dialog form. This method sets up the view model with the appropriate initial directory, custom places, filtering options, and other configuration settings required for the open file dialog functionality.

Declaration

protected virtual OpenFileDialogViewModel GetViewModel()

Returns

Invokes the selected file system objects operation and attempts to execute the open command if conditions are met. This method is called when the user triggers a file selection action through various UI interactions.

Declaration

public override void InvokeSelectedFileSystemObjects()

Overrides FileDialogFormBase.InvokeSelectedFileSystemObjects()

Localizes all user interface strings displayed in the dialog form using the current localization provider. This method sets the appropriate localized text for labels, buttons, and other UI elements.

Declaration

protected virtual void LocalizeStrings()

Sets up the dialog content and configures UI elements based on the current view model state. This method handles the visibility of filter controls, read-only checkbox, and other dialog-specific elements.

Declaration

protected override void SetupDialogContent(bool addWatcher = true)

Parameters

Overrides FileDialogFormBase.SetupDialogContent(bool)