Namespace: Consultingwerk.SmartComponents.Base
Class 
UnboundValuesHelper Copy to Clipboard
Parent classes:
Progress.Lang.Object
Consultingwerk.SmartComponents.Base.UnboundValuesHelper

Inherits: Progress.Lang.Object


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



Top Method Summary
Options Name Purpose
ApplyUnboundValues (Form, UnboundValues) Applies the values returned by a server-side event handler to the unbound editors of the given Form
Consultingwerk.CommonUi.UnboundValues CollectUnboundValues (Form) Returns the values of the unbound editors of the given Form
System.Windows.Forms.Control FindControl (Form, character) Returns the control on the given Form addressed by an unbound value key
Consultingwerk.SmartComponents.Base.SmartViewerControl FindOwningViewer (Control) Returns the SmartViewerControl hosting the given control
System.Object ToControlValue (IPrimitiveHolder) Returns the .NET value to assign to a control for a holder
Consultingwerk.IPrimitiveHolder ToHolder (Object) Returns the holder for a value read from a .NET control

Top Constructor Summary
Options Name Purpose
UnboundValuesHelper () Default constructor for UnboundValuesHelper


Method Detail
Top

ApplyUnboundValues (Form, UnboundValues)
Purpose: Applies the values returned by a server-side event handler to
the unbound editors of the given Form
Notes: Values whose key does not resolve to a control on the Form are
ignored, so a handler may return values for a Form other than
the one that raised the event without raising an error.

Parameters:
poForm System.Windows.Forms.Form
The Form to apply the unbound values to
poValues Consultingwerk.CommonUi.UnboundValues
The UnboundValues returned by the server-side event handler
Top

Consultingwerk.CommonUi.UnboundValues CollectUnboundValues (Form)
Purpose: Returns the values of the unbound editors of the given Form
Notes: Only editors that sit on a SmartViewerControl and carry no data
binding are collected. The keys are built as
<viewer name>.<control name>.

Parameters:
poForm System.Windows.Forms.Form
The Form to collect the unbound values from
Returns Consultingwerk.CommonUi.UnboundValues
The UnboundValues dictionary, never the unknown value
Top

System.Windows.Forms.Control FindControl (Form, character)
Purpose: Returns the control on the given Form addressed by an unbound
value key
Notes: Resolves both a qualified key (<viewer name>.<control name>) and
an unqualified control name, which is matched against the
SmartViewerControls of the Form in the order they are found.

Parameters:
poForm System.Windows.Forms.Form
The Form to search
pcKey CHARACTER
The key of the unbound value
Returns System.Windows.Forms.Control
The Control or the unknown value when the key does not resolve
Top

Consultingwerk.SmartComponents.Base.SmartViewerControl FindOwningViewer (Control)
Purpose: Returns the SmartViewerControl hosting the given control
Notes: Walks up the parent chain and returns the nearest
SmartViewerControl

Parameters:
poControl System.Windows.Forms.Control
The control to find the hosting viewer for
Returns Consultingwerk.SmartComponents.Base.SmartViewerControl
The SmartViewerControl or the unknown value
Top

System.Object ToControlValue (IPrimitiveHolder)
Purpose: Returns the .NET value to assign to a control for a holder
Notes: The unknown value is returned as an invalid object reference so
that ControlHelper:AssignValue clears the editor

Parameters:
poHolder Consultingwerk.IPrimitiveHolder
The holder carrying the value
Returns System.Object
The value to assign to the control
Top

Consultingwerk.IPrimitiveHolder ToHolder (Object)
Purpose: Returns the holder for a value read from a .NET control
Notes: The holder type follows the .NET type of the value, so that the
backend receives the value in the data type of the editor

Parameters:
poValue System.Object
The value read from the control
Returns Consultingwerk.IPrimitiveHolder
The IPrimitiveHolder for the value


Constructor Detail
Top

UnboundValuesHelper ()
Purpose: Default constructor for UnboundValuesHelper
Notes: Protected default constructor



©2006-2026 Consultingwerk Ltd.         info@consultingwerk.de         http://www.consultingwerk.de       16.08.2026 16:58:16