Definition
Namespace:Telerik.WinControls.UI
Assembly:Telerik.WinControls.UI.dll
Syntax:
public class RadBrowseEditorElement : RadTextBoxElement, INotifyPropertyChanged, ICustomTypeDescriptor, ISupportSystemSkin, IBindableComponent, IComponent, IDisposable, ISupportDrag, ISupportDrop, IShortcutProvider, IStylableElement, IStylableNode
Inheritance: objectDisposableObjectRadObjectRadElementVisualElementRadComponentElementRadItemRadEditorElementRadTextBoxElementRadBrowseEditorElement...
Implements:
Inherited Members
Constructors
Creates a new instance of the RadBrowseEditorElement.
public RadBrowseEditorElement()
Properties
Gets the RadButtonElement that opens the BrowseDialog.
public BrowseEditorButton BrowseButton { get; }
Gets the dialog component that will open upon pressing the browse button. The actual type depends on the DialogType property.
public Component BrowseDialog { get; }
Gets or sets the type of dialog to be opened when the browse button is pressed.
public virtual BrowseEditorDialogType DialogType { get; set; }
Determines if users can input text directly into the text field.
public bool ReadOnly { get; set; }
Gets or sets the value of the browse editor. This represents the selected file path, folder path, or font name depending on the DialogType.
public virtual string Value { get; set; }
Methods
Changes the dialog type and creates the appropriate dialog instance.
protected virtual void ChangeDialogType(BrowseEditorDialogType dialogType)
The new dialog type to set.
Creates the child elements of the RadBrowseEditorElement.
protected override void CreateChildElements()
Overrides:
Creates the BrowseEditorButton that will be placed in the browse editor and will be used to open the dialog.
protected virtual BrowseEditorButton CreateDialogButtonElement()
Creates the FolderBrowserDialog that will be opened when the browse button is clicked.
protected virtual FolderBrowserDialog CreateFolderBrowserDialog()
Creates the FontDialog that will be opened when the browse button is clicked.
Creates the OpenFileDialog that will be opened when the browse button is clicked.
protected virtual OpenFileDialog CreateOpenFileDialog()
Creates the RadOpenFolderDialog that will be opened when the browse button is clicked.
protected virtual RadOpenFolderDialog CreateRadFolderBrowserDialog()
Creates the RadOpenFileDialog that will be opened when the browse button is clicked.
protected virtual RadOpenFileDialog CreateRadOpenFileDialog()
Creates the RadSaveFileDialog that will be opened when the browse button is clicked.
protected virtual RadSaveFileDialog CreateRadSaveFileDialog()
Creates the SaveFileDialog that will be opened when the browse button is clicked.
protected virtual SaveFileDialog CreateSaveFileDialog()
Disposes managed resources and unwires event handlers.
protected override void DisposeManagedResources()
Overrides:
Initializes the dialog with the current value and appropriate settings based on the DialogType.
protected virtual void InitializeDialog()
Initializes the fields of the RadBrowseEditorElement.
protected override void InitializeFields()
Overrides:
Fires when the BrowseEditorButton is clicked.
protected virtual void OnBrowseButtonClick(EventArgs e)
The event arguments.
Fires after the dialog is closed.
protected virtual void OnDialogClosed(DialogClosedEventArgs e)
The event arguments.
Handles key down events and sets the editor value when Enter is pressed.
protected override void OnKeyDown(KeyEventArgs e)
The event arguments.
Overrides:
Handles property changed events and updates the RightToLeft property for shapes when necessary.
protected override void OnPropertyChanged(RadPropertyChangedEventArgs e)
The event arguments.
Overrides:
Handles property changing events. Filters out text property changes during value changes.
protected override void OnPropertyChanging(RadPropertyChangingEventArgs args)
The event arguments.
Overrides:
Handles the text changed event. Does not fire the event when value is being changed programmatically.
protected override void OnTextChanged(EventArgs e)
The event arguments.
Overrides:
Handles the text changing event. Cancels the event if the editor is read-only.
protected override void OnTextChanging(TextChangingEventArgs e)
The event arguments.
Overrides:
Fires right after the editor value is changed.
Fires right before the editor value is changed.
protected virtual void OnValueChanging(ValueChangingEventArgs e)
The event arguments.
Saves the value from the dialog to the editor's Value property based on the DialogType.
protected virtual void SaveValueFromDialog()
Sets the value of the editor.
protected virtual void SetEditorValue(string newValue)
The new value to set.
Unwires the event handlers for the browse button and text box.
protected virtual void UnwireEvents()
Wires the event handlers for the browse button and text box.
protected virtual void WireEvents()
Events
Fires after the dialog window is closed.
public event DialogClosedEventHandler DialogClosed
Fires after the editor value is changed.
public event EventHandler ValueChanged
Fires right before the value is changed. Cancelable event.
public event ValueChangingEventHandler ValueChanging