Namespace: Consultingwerk.Windows.Framework.FilePicker
Class 
FilePickerForm Copy to Clipboard
Parent classes:
Progress.Windows.Form
Consultingwerk.Forms.BaseForm
Consultingwerk.Windows.Framework.FilePicker.FilePickerForm

Inherits: Consultingwerk.Forms.BaseForm
Implements: Consultingwerk.Forms.IBaseForm, ICustomTypeDescriptor, IHasDesignerVerbs, IHasSecurityKey


Navigate to: Methods | Constructors | Events | Properties | ProDatasets | Temp-Tables



Top Method Summary
Options Name Purpose
AddTempChildNode (UltraTreeNode) Adds a placeholder child node so the tree shows an expander glyph and BeforeExpand will fire on first user interaction.
ApplyModeVisibility () Adjusts control visibility for the active SelectionMode
BreadcrumbBtn_Click (Object, EventArgs) Event handler for the Click event of a breadcrumb segment button. Navigates to the tree node stored in the button's Tag.
BtnNewFolder_Click (Object, EventArgs) Event handler for the Click event of the New Folder button. Prompts the user for a name and creates a folder under the currently selected node via IFilePickerService:CreateFolder.
BtnUp_Click (Object, EventArgs) Event handler for the Click event of the Up button
Infragistics.Win.UltraWinTree.UltraTreeNode CurrentSelectedNode () Returns the current selected node, or the unknown reference if no single selection exists.
Form_KeyDown (Object, KeyEventArgs) Event handler for the KeyDown event of the form. Implements keyboard shortcuts: Ctrl+Up navigates to parent; Ctrl+Alt+N opens the New Folder dialog.
CHARACTER FullPathFor (UltraTreeNode) Returns the full, fully-qualified file-system path represented by the given node.
InitializeComponent () Initializes the Visual Design
ListViewRight_Click (Object, EventArgs) Event handler for the Click event of the right-pane list view. Updates the selected path and OK button state.
ListViewRight_DoubleClick (Object, EventArgs) Event handler for the DoubleClick event of the right-pane list view. Double-clicking a folder navigates into it; double-clicking a file submits the dialog.
LoadFilePatterns () Loads the file patterns for the current FolderScope into the pattern combo.
LoadRootFolders () Loads the root folders for the current FolderScope as top-level tree nodes, then selects and navigates into the first one.
NavigateIntoFolder (character) Navigates into a named sub-folder of the currently selected tree node by selecting the matching child node.
NavigateUp () Navigates to the parent of the currently selected tree node.
OnShown (EventArgs) Raises the Shown event
PopulateNode (UltraTreeNode) Lazy-loads sub-folder tree nodes into a node when the user expands it. Files are shown in the right pane, not the tree.
RefreshRightPane (UltraTreeNode) Populates the right-pane list view with the sub-folders (and, in file mode, the files) of the given tree node.
CHARACTER RelativeSubFolder (UltraTreeNode) Returns the relative sub-folder path for a tree node, computed by walking up to (but not including) the root node.
INTEGER RootIndex (UltraTreeNode) Returns the integer root-folder index associated with the tree node by walking up to the root.
CHARACTER SelectedPatternIndexes () Returns the indizes string of currently-selected file patterns to pass to IFilePickerService:GetFiles.
UltraCmbFilePattern_ValueChanged (Object, EventArgs) Event handler for the ValueChanged event of the file pattern combo
UltraTree_AfterSelect (Object, SelectEventArgs) Event handler for the AfterSelect event of the tree. Navigates into the selected folder: refreshes the right pane, updates the breadcrumb, and evaluates OK-button state.
UltraTree_BeforeExpand (Object, CancelableNodeEventArgs) Event handler for the BeforeExpand event of the tree
UpdateBreadcrumb (UltraTreeNode) Rebuilds the breadcrumb panel from the path segments of the given tree node and updates the Up button enabled state.
UpdateOkEnabled () Updates the SelectedPath property, the displayed path and the enabled state of the OK button based on the active selection.

Top Constructor Summary
Options Name Purpose
FilePickerForm () Default constructor

Top Property Summary
Options Name Purpose
LOGICAL AllowCreateFolder
LOGICAL FileMustExist
CHARACTER FolderScope
CHARACTER SelectedPath
Consultingwerk.Windows.Framework.FilePicker.FilePickerSelectionModeEnum SelectionMode


Method Detail
Top

AddTempChildNode (UltraTreeNode)
Purpose: Adds a placeholder child node so the tree shows an expander
glyph and BeforeExpand will fire on first user interaction.
Notes:

Parameters:
poParent Infragistics.Win.UltraWinTree.UltraTreeNode
The node to attach the placeholder to
Top

ApplyModeVisibility ()
Purpose: Adjusts control visibility for the active SelectionMode
Notes: File pattern row is only shown when picking files. The New
Folder button is hidden when AllowCreateFolder is false.

Top

BreadcrumbBtn_Click (Object, EventArgs)
Purpose: Event handler for the Click event of a breadcrumb segment button.
Navigates to the tree node stored in the button's Tag.
Notes:

Parameters:
sender System.Object
The reference to the object that raised this event
e System.EventArgs
The System.EventArgs with the data for this event
Top

BtnNewFolder_Click (Object, EventArgs)
Purpose: Event handler for the Click event of the New Folder button.
Prompts the user for a name and creates a folder under the
currently selected node via IFilePickerService:CreateFolder.
Notes:

Parameters:
sender System.Object
The reference to the object that raised this event
e System.EventArgs
The System.EventArgs with the data for this event
Top

BtnUp_Click (Object, EventArgs)
Purpose: Event handler for the Click event of the Up button
Notes:

Parameters:
sender System.Object
The reference to the object that raised this event
e System.EventArgs
The System.EventArgs with the data for this event
Top

Infragistics.Win.UltraWinTree.UltraTreeNode CurrentSelectedNode ()
Purpose: Returns the current selected node, or the unknown reference
if no single selection exists.
Notes:

Returns Infragistics.Win.UltraWinTree.UltraTreeNode
The single selected UltraTreeNode, or ? when the selection count is not exactly one
Top

Form_KeyDown (Object, KeyEventArgs)
Purpose: Event handler for the KeyDown event of the form.
Implements keyboard shortcuts: Ctrl+Up navigates to parent;
Ctrl+Alt+N opens the New Folder dialog.
Notes:

Parameters:
sender System.Object
The reference to the object that raised this event
e System.Windows.Forms.KeyEventArgs
The KeyEventArgs with the data for this event
Top

CHARACTER FullPathFor (UltraTreeNode)
Purpose: Returns the full, fully-qualified file-system path represented
by the given node.
Notes: The root folder path is resolved from the configured root
folders (by index), not from the node label - the tree only
displays the short folder name, but the value returned to the
caller must remain a fully qualified server path.

Parameters:
poNode Infragistics.Win.UltraWinTree.UltraTreeNode
The node to compute the full path for
Returns CHARACTER
The full path of the folder represented by the node
Top

InitializeComponent ()
Purpose: Initializes the Visual Design
Notes: Layout properties live in the .resx (Localizable = true).

Top

ListViewRight_Click (Object, EventArgs)
Purpose: Event handler for the Click event of the right-pane list view.
Updates the selected path and OK button state.
Notes:

Parameters:
sender System.Object
The reference to the object that raised this event
e System.EventArgs
The System.EventArgs with the data for this event
Top

ListViewRight_DoubleClick (Object, EventArgs)
Purpose: Event handler for the DoubleClick event of the right-pane list
view. Double-clicking a folder navigates into it; double-clicking
a file submits the dialog.
Notes:

Parameters:
sender System.Object
The reference to the object that raised this event
e System.EventArgs
The System.EventArgs with the data for this event
Top

LoadFilePatterns ()
Purpose: Loads the file patterns for the current FolderScope into the
pattern combo.
Notes: Shows exactly the patterns returned by GetFilePatterns; any
"All Files" entry must be defined in the scope configuration.

Top

LoadRootFolders ()
Purpose: Loads the root folders for the current FolderScope as top-level
tree nodes, then selects and navigates into the first one.
Notes:

Top

NavigateIntoFolder (character)
Purpose: Navigates into a named sub-folder of the currently selected
tree node by selecting the matching child node.
Notes:

Parameters:
pcFolderName CHARACTER
The folder name to navigate into
Top

NavigateUp ()
Purpose: Navigates to the parent of the currently selected tree node.
Notes:

Top

OnShown (EventArgs)
Purpose: Raises the Shown event
Notes: Populates the dialog with the current scope's root folders
and file patterns.

Parameters:
e System.EventArgs
The System.EventArgs with the data for this event
Top

PopulateNode (UltraTreeNode)
Purpose: Lazy-loads sub-folder tree nodes into a node when the user
expands it. Files are shown in the right pane, not the tree.
Notes:

Parameters:
poNode Infragistics.Win.UltraWinTree.UltraTreeNode
The node being expanded
Top

RefreshRightPane (UltraTreeNode)
Purpose: Populates the right-pane list view with the sub-folders (and,
in file mode, the files) of the given tree node.
Notes: Clears the list first; safe to call with poNode = ?.

Parameters:
poNode Infragistics.Win.UltraWinTree.UltraTreeNode
The tree node whose contents to display
Top

CHARACTER RelativeSubFolder (UltraTreeNode)
Purpose: Returns the relative sub-folder path for a tree node, computed
by walking up to (but not including) the root node.
Notes:

Parameters:
poNode Infragistics.Win.UltraWinTree.UltraTreeNode
The node to compute the relative path for
Returns CHARACTER
The relative sub-folder path or an empty string for the root
Top

INTEGER RootIndex (UltraTreeNode)
Purpose: Returns the integer root-folder index associated with the
tree node by walking up to the root.
Notes:

Parameters:
poNode Infragistics.Win.UltraWinTree.UltraTreeNode
The node to resolve the root index for
Returns INTEGER
The root folder index, or 0 if not resolvable
Top

CHARACTER SelectedPatternIndexes ()
Purpose: Returns the indizes string of currently-selected file patterns
to pass to IFilePickerService:GetFiles.
Notes:

Returns CHARACTER
The comma-delimited pattern index string, or an empty string when no item is selected
Top

UltraCmbFilePattern_ValueChanged (Object, EventArgs)
Purpose: Event handler for the ValueChanged event of the file pattern combo
Notes: Reloads the right-pane file list to match the new pattern.

Parameters:
sender System.Object
The reference to the object that raised this event
e System.EventArgs
The System.EventArgs with the data for this event
Top

UltraTree_AfterSelect (Object, SelectEventArgs)
Purpose: Event handler for the AfterSelect event of the tree.
Navigates into the selected folder: refreshes the right pane,
updates the breadcrumb, and evaluates OK-button state.
Notes:

Parameters:
sender System.Object
The reference to the object that raised this event
e Infragistics.Win.UltraWinTree.SelectEventArgs
The SelectEventArgs with the data for this event
Top

UltraTree_BeforeExpand (Object, CancelableNodeEventArgs)
Purpose: Event handler for the BeforeExpand event of the tree
Notes:

Parameters:
sender System.Object
The reference to the object that raised this event
e Infragistics.Win.UltraWinTree.CancelableNodeEventArgs
The CancelableNodeEventArgs with the data for this event
Top

UpdateBreadcrumb (UltraTreeNode)
Purpose: Rebuilds the breadcrumb panel from the path segments of the
given tree node and updates the Up button enabled state.
Notes: Each segment is a flat button that re-selects its tree node.

Parameters:
poNode Infragistics.Win.UltraWinTree.UltraTreeNode
The tree node to build the breadcrumb for
Top

UpdateOkEnabled ()
Purpose: Updates the SelectedPath property, the displayed path and the
enabled state of the OK button based on the active selection.
Notes: Right-pane (listViewRight) selection takes priority; tree-node
selection provides the folder path fallback.



Constructor Detail
Top

FilePickerForm ()
Purpose: Default constructor
Notes:



Property Detail
Top

LOGICAL AllowCreateFolder

Returns LOGICAL
Top

LOGICAL FileMustExist

Returns LOGICAL
Top

CHARACTER FolderScope

Returns CHARACTER
Top

CHARACTER SelectedPath

Returns CHARACTER
Top

Consultingwerk.Windows.Framework.FilePicker.FilePickerSelectionModeEnum SelectionMode

Returns Consultingwerk.Windows.Framework.FilePicker.FilePickerSelectionModeEnum


©2006-2026 Consultingwerk Ltd.         info@consultingwerk.de         http://www.consultingwerk.de       01.06.2026 09:20:33