Namespace: Consultingwerk.Windows.Controls
Class 
FormLruController Copy to Clipboard
Parent classes:
Progress.Lang.Object
Consultingwerk.Windows.Controls.FormLruController

Inherits: Progress.Lang.Object


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



Top Method Summary
Options Name Purpose
CHARACTER BuildFindPredicate (character) Builds the FindRowWhere WHERE predicate from a stored LRU item key
LoadHandler (Object, EventArgs) Handler for the Load event of the Form
StoreLruEntry () Adds an entry for the current record of the BusinessEntityAdapter to the LRU and persists the list
StoreLruEntry (character, character) Adds an explicit entry to the LRU and persists the list
ToolClickHandler (Object, ToolClickEventArgs) Handler for the ToolClick event of the UltraToolbarsManager
WireUpForm () Wires the controller to the UltraToolbarsManager (Ribbon) of the Form

Top Constructor Summary
Options Name Purpose
FormLruController (Form) Constructor for a FormLruController that does not operate on a SmartBusinessEntityAdapter
FormLruController (Form, SmartBusinessEntityAdapter, character, character) Constructor for the FormLruController class

Top Event Summary
Options Name Purpose
RecordLocated (Object, LruRecordLocatedEventArgs) Raised after an LRU entry has been clicked

Top Property Summary
Options Name Purpose
Consultingwerk.SmartComponents.Implementation.SmartBusinessEntityAdapter BusinessEntityAdapter
CHARACTER DisplayFields
CHARACTER DisplayPattern
Progress.Windows.Form Form
Consultingwerk.Windows.Controls.UltraRibbonLruController LruController
LOGICAL PerformFindRowWhere


Method Detail
Top

CHARACTER BuildFindPredicate (character)
Purpose: Builds the FindRowWhere WHERE predicate from a stored LRU item key
Notes: The item key is a Field1|Value1|Field2|Value2|... list. The field/
value pairs are joined with " and " and the whole predicate starts
with "where" (as FindRowWhere expects). Every value is wrapped in
double quotes - in a dynamic query string a value of any data type
(integer, decimal, logical, date, character) may be quoted, so no
data-type inspection is required.

Parameters:
pcItemKey CHARACTER
The pipe-delimited list of key field names and values
Returns CHARACTER
The WHERE predicate, e.g. where OrderNum = "17" and LineNum = "4"
Top

LoadHandler (Object, EventArgs)
Purpose: Handler for the Load event of the Form
Notes: Restores the LRU list into the Ribbon application menu

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

StoreLruEntry ()
Purpose: Adds an entry for the current record of the BusinessEntityAdapter
to the LRU and persists the list
Notes: Reloads the list before updating it to avoid clobbering entries
added by other open form instances

Top

StoreLruEntry (character, character)
Purpose: Adds an explicit entry to the LRU and persists the list
Notes: Use this overload for forms that do not operate on a
SmartBusinessEntityAdapter (e.g. a tree view of class names): the
caller supplies the display text and the item key directly instead
of having them derived from the current record of an adapter. The
item key is carried back unchanged in the RecordLocated event when
the entry is clicked. Reloads the list before updating it to avoid
clobbering entries added by other open form instances.

Parameters:
pcDisplayText CHARACTER
The text shown for the entry in the Ribbon application menu
pcItemKey CHARACTER
The key stored with the entry and carried back in the RecordLocated event
Top

ToolClickHandler (Object, ToolClickEventArgs)
Purpose: Handler for the ToolClick event of the UltraToolbarsManager
Notes: Re-selects the record stored with an LRU tool via FindRowWhere

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

WireUpForm ()
Purpose: Wires the controller to the UltraToolbarsManager (Ribbon) of the
Form
Notes: Resolves the UltraToolbarsManager from the Form, derives the
settings key from the Form, creates the inner LRU controller and
subscribes to the Form Load and UltraToolbarsManager ToolClick
events. Shared by both constructors.



Constructor Detail
Top

FormLruController (Form)
Purpose: Constructor for a FormLruController that does not operate on a
SmartBusinessEntityAdapter
Notes: Use this overload for forms that manage their own navigation and
store LRU entries explicitly via StoreLruEntry (display text, item
key) - e.g. a tree view of class names - rather than deriving them
from the current record of an adapter. PerformFindRowWhere is set
to false, so clicking an LRU entry raises RecordLocated directly
with the stored item key and the consuming form performs the
navigation. No SmartBusinessEntityAdapter reference is held.

Parameters:
poForm Progress.Windows.Form
The Form the controller is attached to (expected to be a Consultingwerk.Forms.BaseForm)
Top

FormLruController (Form, SmartBusinessEntityAdapter, character, character)
Purpose: Constructor for the FormLruController class
Notes: Resolves the UltraToolbarsManager from the Form, derives the
settings key from the Form and subscribes to the Form Load and
UltraToolbarsManager ToolClick events.

Parameters:
poForm Progress.Windows.Form
The Form the controller is attached to (expected to be a Consultingwerk.Forms.BaseForm)
poBusinessEntityAdapter Consultingwerk.SmartComponents.Implementation.SmartBusinessEntityAdapter
The SmartBusinessEntityAdapter carrying the records the LRU operates on
pcDisplayPattern CHARACTER
The substitute pattern used to build the LRU display text, e.g. "&1 - &2"
pcDisplayFields CHARACTER
The comma-delimited list of fields whose values fill the pattern, e.g. "CustNum,Name"


Event Detail
Top

RecordLocated (Object, LruRecordLocatedEventArgs)
Purpose: Raised after an LRU entry has been clicked
Notes: When PerformFindRowWhere is true this is only raised after the
record has actually been located in the BusinessEntityAdapter via
FindRowWhere; when false it is raised directly so the consuming
form can navigate using the item key carried in the event args.
Allows the consuming form to perform additional navigation - e.g.
synchronizing a tree view selection with the located record.

Parameters:
sender Progress.Lang.Object
The reference to the object that raised the event
e Consultingwerk.Windows.Controls.LruRecordLocatedEventArgs
The LruRecordLocatedEventArgs with the data for this event


Property Detail
Top

Consultingwerk.SmartComponents.Implementation.SmartBusinessEntityAdapter BusinessEntityAdapter

Returns Consultingwerk.SmartComponents.Implementation.SmartBusinessEntityAdapter
Top

CHARACTER DisplayFields

Returns CHARACTER
Top

CHARACTER DisplayPattern

Returns CHARACTER
Top

Progress.Windows.Form Form

Returns Progress.Windows.Form
Top

Consultingwerk.Windows.Controls.UltraRibbonLruController LruController

Returns Consultingwerk.Windows.Controls.UltraRibbonLruController
Top

LOGICAL PerformFindRowWhere

Returns LOGICAL


©2006-2026 Consultingwerk Ltd.         info@consultingwerk.de         http://www.consultingwerk.de       06.07.2026 14:39:51