OpenFileDialog.IHandler

References
public interface OpenFileDialog.IHandler : FileDialog.IHandler
Handler interface for the OpenFileDialog

Properties

CheckFileExists

bool CheckFileExists { get; set; }
Gets or sets a value indicating whether this FileDialog checks if the file exists before the user can close the dialog.
inherited fromFileDialog.IHandler

CurrentFilterIndex

int CurrentFilterIndex { get; set; }
Gets or sets the index of the current filter in the FileDialog.Filters collection
inherited fromFileDialog.IHandler

Directory

Uri Directory { get; set; }
Gets or sets the directory the file dialog will show files.
inherited fromFileDialog.IHandler

FileName

string FileName { get; set; }
Gets or sets the full name and path of the file that is selected
inherited fromFileDialog.IHandler

Filenames

#
IEnumerable<string> Filenames { get; }
Gets the full path of the files selected by the user, when MultiSelect is true.
Remarks: This will return a single file name if MultiSelect is false.
The full path of the files selected, or a single file if MultiSelect is false.

ID

string ID { get; set; }
Gets or sets an ID for the widget
inherited fromWidget.IHandler
Remarks: Some platforms may use this to identify controls (e.g. web)

MultiSelect

#
bool MultiSelect { get; set; }
Gets or sets a value indicating whether the user can select multiple files, or a single file.

NativeHandle

nint NativeHandle { get; }
Gets the native platform-specific handle for integration purposes
inherited fromWidget.IHandler

Methods

HandleEvent

void HandleEvent(string id, bool defaultEvent = false)
Called to handle a specific event
inherited fromWidget.IHandler
Remarks: Most events are late bound by this method. Instead of wiring all events, this will be called with an event string that is defined by the control. This is called automatically when attaching to events, but must be called manually when users of the control only override the event's On... method.
id (string)ID of the event to handle
defaultEvent (bool = false)True if the event is default (e.g. overridden or via an event handler subscription)

Initialize

void Initialize()
Called after the widget is constructed
inherited fromWidget.IHandler
Remarks: This gets called automatically after the control is constructed and the Widget.IHandler.Widget and Widget.Platform properties are set. When the handler has specialized construction methods, then the AutoInitializeAttribute can be used to disable automatic initialization. In this case, it is the responsibility of the subclass to call Widget.Initialize()

InsertFilter

void InsertFilter(int index, FileFilter filter)
Inserts a filter at the specified index
inherited fromFileDialog.IHandler

RemoveFilter

void RemoveFilter(int index)
Removes a filter at the specified index
inherited fromFileDialog.IHandler

ShowDialog

DialogResult ShowDialog(Window parent)
Shows the dialog with the specified parent window, blocking until a result is returned.
inherited fromCommonDialog.IHandler

UnhandleEvent

virtual void UnhandleEvent(string id)
Called when the last subscriber to an event has been removed, so the platform can stop listening for it.
inherited fromWidget.IHandler
Remarks: Only reached for events whose remove accessor uses PropertyStore.RemoveHandlerEvent(string, Delegate), and only for events that were attached because something subscribed to them. An event attached because the widget overrides its On[Event] method is never detached, since it has to keep firing regardless. Most events stay attached for the life of the widget, which costs nothing. Detaching is worth wiring up for the few that hold onto something expensive or process wide while they are attached, such as a system wide hook. Handlers deriving from WidgetHandler<TWidget> get an implementation of this that dispatches to WidgetHandler<TWidget>.DetachEvent(string), which is what to override.
id (string)ID of the event to stop handling