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

Inherits: Progress.Lang.Object

File:SmartWindowFormController
Purpose:Delegate for shared functionality between SmartWindowsForm
and SmartRadWindowForm and SmartRadRibbonWindowForm
Author(s):Mike Fechner / Consultingwerk Ltd.
Created:Wed Apr 08 20:39:21 CEST 2015

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



Top Method Summary
Options Name Purpose
ActivateLinks (Control) Activates the Links between the active control and the SmartToolbarController
LOGICAL AnyControlInModifyingState () Returns if any control is in Modifying State
LOGICAL CheckForPendingTransactions () Checks for pending transactions in a SmartBusinessEntityAdapter in the Form or UserControl in the Form
FilterSmartBusinessEntityAdapter (Component>, Component>) Adds all SmartBusinessEntityAdapter instances (based on the ISmartCommitTarget interface) from the Source list to the Target list
FormClosingHandler (FormClosingEventArgs) Delegate for the FormClosing event handler
GetAllSmartBusinessEntityAdapterInControls (Control+ControlCollection, Component>) Loops recursively through Controls and Child-Controls and adds all SmartBusinessEntityAdapter instances to the target list
Consultingwerk.SmartComponents.Base.ListSmartDataAdapter GetLinkedDataAdapters () Returns a List of Data Adapter instances in the Form
Consultingwerk.SmartComponents.Base.ListSmartDataAdapter GetLinkedDataAdapters (SmartDataAdapter) Returns a List of Data Adapter instances in the Form
GetLinkedDataAdapters (SmartDataAdapter, ListSmartDataAdapter) Add linked SmartDataAdapter instances to a List
InitializeFrameworkBootstrap () Initializes the Framework Bootstrap
KeyDownHandler (Object, KeyEventArgs) Event handler for the KeyDown event of the Form
LoadHandler () Delegate for the Load event handler
Consultingwerk.Framework.Enum.DialogResultEnum PromptForSaveOfPendingChangesOnClose () Shows the Prompt to save pending transactions to the backend while closing the Form
LOGICAL RecurseAnyControlInModifyingState (Control) Returns if any control is in Modifying State
LOGICAL RecurseCheckIsOkToClose (Control+ControlCollection, logical, CloseReason) Recursively ask all Controls implementing the ICheckOkToClose Interface whether it is ok to close the form.
LOGICAL RecurseSaveChangesOnDeactivateForm (Control+ControlCollection, logical) Recursively checks all contained controls to save changes on Deactivate of the Form
RemoveDataLinks () Removes Data links from all contained SmartDataTargets when the Form is closed
ShowFieldInfo (Control) Shows the field info

Top Constructor Summary
Options Name Purpose
SmartWindowFormController (ISmartWindowForm) Constructor for the SmartWindowFormController class

Top Property Summary
Options Name Purpose
CHARACTER FieldInfoShortCutKey
Consultingwerk.SmartComponents.Interfaces.ISmartWindowForm Form
System.Collections.Generic.List <System.Type> MapEnterKeyControlTypeList
LOGICAL MapEnterKeyToTab


Method Detail
Top

ActivateLinks (Control)
Purpose: Activates the Links between the active control and the
SmartToolbarController
Notes: When the ActiveControl is a read-only Browse, we attempt to activate
the TableIO Link on another Data-Target of the Browsers SmartDataAdapter
That could be a Viewer with is linked to the same adapter

Parameters:
poActiveControl System.Windows.Forms.Control
The Control where the Links should be activated
Top

LOGICAL AnyControlInModifyingState ()
Purpose: Returns if any control is in Modifying State
Notes:

Returns LOGICAL
Logical value indicating if any control is in modifying state
Top

LOGICAL CheckForPendingTransactions ()
Purpose: Checks for pending transactions in a SmartBusinessEntityAdapter
in the Form or UserControl in the Form
Notes: Invoked while closing the Form, dependent on the ComponentsCollection

Returns LOGICAL
Logical value indicating if the Form can be closed
Top

FilterSmartBusinessEntityAdapter (Component>, Component>)
Purpose: Adds all SmartBusinessEntityAdapter instances (based on the ISmartCommitTarget
interface) from the Source list to the Target list
Notes:

Parameters:
poSourceList System.Collections.Generic.List
The source list to filter for ISmartCommitTarget instances
poTargetList System.Collections.Generic.List
The target list to add instances to
Top

FormClosingHandler (FormClosingEventArgs)
Purpose: Delegate for the FormClosing event handler
Notes:

Parameters:
e System.Windows.Forms.FormClosingEventArgs
The FormClosingEventArgs with the data for this event
Top

GetAllSmartBusinessEntityAdapterInControls (Control+ControlCollection, Component>)
Purpose: Loops recursively through Controls and Child-Controls and adds all
SmartBusinessEntityAdapter instances to the target list
Notes:

Parameters:
poControls System.Windows.Forms.Control+ControlCollection
The current iteration of the Controls collections
poTargetList System.Collections.Generic.List
The List<Component> to add the Components to
Top

Consultingwerk.SmartComponents.Base.ListSmartDataAdapter GetLinkedDataAdapters ()
Purpose: Returns a List of Data Adapter instances in the Form
Notes: Returns the PrimaryDataTarget (when that's a Data Adapter) and
the PrimaryDataSource as well as all their DataTarget instances

Returns Consultingwerk.SmartComponents.Base.ListSmartDataAdapter
The List of Data Adapter instances
Top

Consultingwerk.SmartComponents.Base.ListSmartDataAdapter GetLinkedDataAdapters (SmartDataAdapter)
Purpose: Returns a List of Data Adapter instances in the Form
Notes: Returns the PrimaryDataTarget (when that's a Data Adapter) and
the PrimaryDataSource or the poStart SmartDataAdapter instance
as well as all their DataTarget instances

Parameters:
poStart Consultingwerk.SmartComponents.Base.SmartDataAdapter
An optional reference to a SmartDataAdapter to use as the starting point
Returns Consultingwerk.SmartComponents.Base.ListSmartDataAdapter
The List of Data Adapter instances
Top

GetLinkedDataAdapters (SmartDataAdapter, ListSmartDataAdapter)
Purpose: Add linked SmartDataAdapter instances to a List
Notes: Used by GetLinkedDataAdapters (poStart)

Parameters:
poStart Consultingwerk.SmartComponents.Base.SmartDataAdapter
The reference to a SmartDataAdapter to use as the starting point
poList Consultingwerk.SmartComponents.Base.ListSmartDataAdapter
The list of SmartDataAdapters to add to
Top

InitializeFrameworkBootstrap ()
Purpose: Initializes the Framework Bootstrap
Notes: Allows overriding in a custom Form base class

Top

KeyDownHandler (Object, KeyEventArgs)
Purpose: Event handler for the KeyDown event of the Form
Notes:

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

LoadHandler ()
Purpose: Delegate for the Load event handler
Notes:

Top

Consultingwerk.Framework.Enum.DialogResultEnum PromptForSaveOfPendingChangesOnClose ()
Purpose: Shows the Prompt to save pending transactions to the backend while
closing the Form
Notes:

Returns Consultingwerk.Framework.Enum.DialogResultEnum
The DialogResultEnum value indicating "Yes" to save changes, "No" to not save changes and "Cancel" to not close the Form
Top

LOGICAL RecurseAnyControlInModifyingState (Control)
Purpose: Returns if any control is in Modifying State
Notes:

Parameters:
poControl System.Windows.Forms.Control
The reference to the control to test
Returns LOGICAL
Logical value indicating if any control is in modifying state
Top

LOGICAL RecurseCheckIsOkToClose (Control+ControlCollection, logical, CloseReason)
Purpose: Recursively ask all Controls implementing the ICheckOkToClose Interface
whether it is ok to close the form.
Notes:

Parameters:
poControls System.Windows.Forms.Control+ControlCollection
The System.Windows.Forms.Control+ControlCollection Collection of Controls to iterate
plShowMessage LOGICAL
When TRUE a message is Shown explaining why it is not ok to close the parent form.
poCloseReason System.Windows.Forms.CloseReason
The System.Windows.Forms.CloseReason passed from then OnFormClosing Method of the parent form giving the reason who closes the form.
Returns LOGICAL
Logical value indicating if the Form can be closed or not.
Top

LOGICAL RecurseSaveChangesOnDeactivateForm (Control+ControlCollection, logical)
Purpose: Recursively checks all contained controls to save changes on
Deactivate of the Form
Notes:

Parameters:
poControls System.Windows.Forms.Control+ControlCollection
The System.Windows.Forms.Control+ControlCollection Collection of Controls to iterate
plShowMessage LOGICAL
When TRUE a message is Shown explaining why it is not ok to close the parent form.
Returns LOGICAL
Logical value indicating if it's o.k. to move to the Activated window
Top

RemoveDataLinks ()
Purpose: Removes Data links from all contained SmartDataTargets when the Form
is closed
Notes:

Top

ShowFieldInfo (Control)
Purpose: Shows the field info
Notes:

Parameters:
poControl System.Windows.Forms.Control
The Control to display field info for


Constructor Detail
Top

SmartWindowFormController (ISmartWindowForm)
Purpose: Constructor for the SmartWindowFormController class
Notes:

Parameters:
poSmartWindowForm Consultingwerk.SmartComponents.Interfaces.ISmartWindowForm
The reference to the ISmartWindowForm that owns this controller


Property Detail
Top

CHARACTER FieldInfoShortCutKey

Returns CHARACTER
Top

Consultingwerk.SmartComponents.Interfaces.ISmartWindowForm Form

Returns Consultingwerk.SmartComponents.Interfaces.ISmartWindowForm
Top

System.Collections.Generic.List <System.Type> MapEnterKeyControlTypeList

Returns System.Collections.Generic.List <System.Type>
Top

LOGICAL MapEnterKeyToTab

Returns LOGICAL


©2006-2026 Consultingwerk Ltd.         info@consultingwerk.de         http://www.consultingwerk.de       13.04.2026 10:23:21