Namespace: Consultingwerk.SmartComponents.Implementation
Class 
SmartDynamicViewer Copy to Clipboard
Parent classes:
Inherits: Consultingwerk.SmartComponents.Base.SmartViewerControl
Implements: Consultingwerk.Design.SmartComponents.Viewer.IDynamicViewerControl, Consultingwerk.SmartComponents.Interfaces.Design.IDesignDataTarget, Consultingwerk.SmartComponents.Interfaces.Design.IDesignGroupAssignSource, Consultingwerk.SmartComponents.Interfaces.Design.IDesignToolbarTarget, Consultingwerk.SmartComponents.Interfaces.Design.IDesignViewerControl, Consultingwerk.SmartComponents.Interfaces.ISmartViewerControl, IAlwaysEnabledControl, ICheckOkToClose, IHandlesServerEvents, IHasDesignerVerbs, ISaveChangesOnDeactivateForm, ISmartDataTarget, ISmartGroupAssignSource, ISmartGroupAssignTarget, ISmartTableIOTarget, ISmartToolbarTarget, System.ComponentModel.ISupportInitialize

File:SmartDynamicViewer
Purpose:A dynamic viewer that can be styled by end users at runtime
Description:This viewer control can be connected to a SmartDataAdapter
and the user can dynamically drop fields from the
SmartDataAdapter's binding source schema to the design
Author(s):Mike Fechner / Consultingwerk Ltd.
Created:Tue Nov 09 21:11:40 CET 2010
Notes:Due to license restrictions the user will drop Microsoft
System.Windows.Forms controls to the design canvas, not
Infragistics Controls - this would require an Infragistics
developers license by the end user



Top Method Summary
Options Name Purpose
AttachBindingSource (BindingSource) Overrides AttachBindingSource in the SmartViewerControl class
CloseDesigner () Closes the Visual Designer instance
EndInit () Loads the stored settings using the LoadSettings method and creates the Control instances using the InitializeControls method
InitializeControls () Creates the Control instances for all fields in the ttViewerDesign temp-table (read by the LoadSettings method)
InitializeControls (character, BindingSource, Control) Creates the Control instances in a container
InitializeControlsWithoutBindingSource () Creates the Control instances for all fields in the ttViewerDesign temp-table (read by the LoadSettings method)
InitializeTabControl (character, BindingSource, Control) Initializes a UltraTabControl
InvokeDesigner () Overlays the SmartDynamicViewer with the Designer.
LoadSettings () Loads the Layout of the dynamic viewer.
ProcessControlProperties (character, Control) Processes specific default property values based on the Type of the Control
SaveDesigner (Control) Saves the current design using the SaveSettings method and closes the Visual Designer
SaveSettings () Saves the Layout of the dynamic viewer.
CHARACTER SubstituteType (character) Performs generic type substitution (Microsoft to Infragistics equivalent)

Top Constructor Summary
Options Name Purpose
SmartDynamicViewer () Creates a new instance of the SmartDynamicViewer class

Top Property Summary
Options Name Purpose
Infragistics.Win.UltraWinToolbars.UltraToolbarsManager DesignerToolbar
CHARACTER SettingsKey
System.Collections.Generic.Dictionary <System.String> SubstituteDynamicControls
LOGICAL SubstituteTypes


Method Detail
Top

AttachBindingSource (BindingSource)

Purpose: Overrides AttachBindingSource in the SmartViewerControl class
Notes: Attaches Event handles to the viewer fields

Parameters:
poBindingSource Progress.Data.BindingSource
The BindingSource (typically of a DataAdapter) used by this SmartDynamicViewer
Top

CloseDesigner ()

Purpose: Closes the Visual Designer instance
Notes:

Top

EndInit ()

Purpose: Loads the stored settings using the LoadSettings method and
creates the Control instances using the InitializeControls method
Notes:

Top

InitializeControls ()

Purpose: Creates the Control instances for all fields in the
ttViewerDesign temp-table (read by the LoadSettings method)
Notes:

Top

InitializeControls (character, BindingSource, Control)

Purpose: Creates the Control instances in a container
Notes: Recursive method to allow nested containers (e.g. tab folder, group box)

Parameters:
pcContainerInstanceId CHARACTER
The key of the Container to render contained controls
poBindingSource Progress.Data.BindingSource
The reference to the BindingSource component
poParentControl System.Windows.Forms.Control
The reference to the parent control (matching the pcContainerInstanceId)
Top

InitializeControlsWithoutBindingSource ()

Purpose: Creates the Control instances for all fields in the
ttViewerDesign temp-table (read by the LoadSettings method)
Notes:

Top

InitializeTabControl (character, BindingSource, Control)

Purpose: Initializes a UltraTabControl
Notes:

Parameters:
pcContainerInstanceId CHARACTER
The key of the Container to render contained controls (the UltraTabControl)
poBindingSource Progress.Data.BindingSource
The reference to the BindingSource component
poParentControl System.Windows.Forms.Control
The reference to the parent control (matching the pcContainerInstanceId)
Top

InvokeDesigner ()

Purpose: Overlays the SmartDynamicViewer with the Designer.
Notes: Begins the visual design process from the end user

Top

LoadSettings ()

Purpose: Loads the Layout of the dynamic viewer.
Notes: This method is intended to be overridden. By default an XML file
in the application root folder is used.

Top

ProcessControlProperties (character, Control)

Purpose: Processes specific default property values based on the Type of the Control
Notes:

Parameters:
pcType CHARACTER
The Type of the Control
poControl System.Windows.Forms.Control
The reference to the Control
Top

SaveDesigner (Control)

Purpose: Saves the current design using the SaveSettings method and closes
the Visual Designer
Notes:

Parameters:
poTemplateControl System.Windows.Forms.Control
The reference to the Visual Designer root control
Top

SaveSettings ()

Purpose: Saves the Layout of the dynamic viewer.
Notes: This method is intended to be overridden. By default an XML file
in the application root folder is created.

Top

CHARACTER SubstituteType (character)

Purpose: Performs generic type substitution (Microsoft to Infragistics equivalent)
Notes:

Parameters:
pcBaseType CHARACTER
The Type name used at design time
Returns CHARACTER
The Type name used at runtime


Constructor Detail
Top

SmartDynamicViewer ()

Purpose: Creates a new instance of the SmartDynamicViewer class
Notes: The SettingsKey will be generated as a GUID in the constructor of
this class. Typically this GUID will be overridden by a GUID
that was generated at the time the Control was added to a Form in
the Visual Designer



Property Detail
Top

Infragistics.Win.UltraWinToolbars.UltraToolbarsManager DesignerToolbar


Returns Infragistics.Win.UltraWinToolbars.UltraToolbarsManager
Top

CHARACTER SettingsKey


Returns CHARACTER
Top

System.Collections.Generic.Dictionary <System.String> SubstituteDynamicControls


Returns System.Collections.Generic.Dictionary <System.String>
Top

LOGICAL SubstituteTypes


Returns LOGICAL


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