Namespace: Consultingwerk.SmartComponents.Base
Class 
SmartViewerControl Copy to Clipboard
Parent classes:
Inherits: Consultingwerk.SmartComponents.Base.SmartUserControl
Implements: Consultingwerk.SmartComponents.Interfaces.Design.IDesignDataTarget, Consultingwerk.SmartComponents.Interfaces.Design.IDesignGroupAssignSource, Consultingwerk.SmartComponents.Interfaces.Design.IDesignViewerControl, Consultingwerk.SmartComponents.Interfaces.ISmartViewerControl, Consultingwerk.SmartComponents.Interfaces.ICheckOkToClose, IHasDesignerVerbs, Consultingwerk.SmartComponents.Interfaces.ISaveChangesOnDeactivateForm, Consultingwerk.SmartComponents.Interfaces.ISmartDataTarget, Consultingwerk.SmartComponents.Interfaces.ISmartGroupAssignSource, Consultingwerk.SmartComponents.Interfaces.ISmartGroupAssignTarget, Consultingwerk.SmartComponents.Interfaces.ISmartTableIOTarget, System.ComponentModel.ISupportInitialize
Inherited by: Consultingwerk.Windows.Framework.Authentication.SmartUserViewer, Consultingwerk.Windows.Framework.Authorization.SmartFieldSecurityItemViewerControl, Consultingwerk.Windows.Framework.Authorization.SmartGroupViewer, Consultingwerk.Windows.Framework.Authorization.SmartSecurityAssignmentViewerControl, Consultingwerk.Windows.Framework.Authorization.SmartSecurityRealmViewerControl, Consultingwerk.Windows.Framework.Authorization.SmartSecurityTokenViewerControl, Consultingwerk.Windows.Framework.Authorization.SmartToolbarSecurityItemViewerControl, Consultingwerk.Windows.Framework.Menu.SmartFunctionViewer, Consultingwerk.Windows.Framework.Menu.SmartMenuStyleViewerControl, Consultingwerk.Windows.Framework.Menu.SmartMenuViewer, Consultingwerk.Windows.Framework.Menu.SmartModuleViewer, Consultingwerk.Windows.Framework.Menu.SmartProductViewerControl, Consultingwerk.Windows.Framework.Repository.Class.SmartAttributeGroupViewerControl, Consultingwerk.Windows.Framework.Repository.Class.SmartAttributeViewerControl, Consultingwerk.Windows.Framework.Repository.Class.SmartClassTypeViewerControl, Consultingwerk.Windows.Framework.Repository.Class.SmartLinkTypeViewerControl, Consultingwerk.Windows.Framework.Repository.Class.SmartObjectTypeViewerControl, Consultingwerk.Windows.Framework.Repository.Class.SmartSupportedLinkViewerControl, Consultingwerk.Windows.Framework.Repository.Customization.SmartCustomizationResultViewerControl, Consultingwerk.Windows.Framework.Repository.Customization.SmartCustomizationTypeViewerControl, Consultingwerk.Windows.Framework.Repository.Customization.SmartCustomizationViewerControl, Consultingwerk.Windows.Framework.Scheduler.SmartSchedulerJobPlanViewerControl, Consultingwerk.Windows.Framework.Scheduler.SmartSchedulerJobStatusViewerControl, Consultingwerk.Windows.Framework.Scheduler.SmartSchedulerJobViewerControl, Consultingwerk.SmartComponents.Implementation.SmartDynamicViewer, Consultingwerk.BusinessEntityDesigner.UI.BusinessEntityViewerControl, Consultingwerk.BusinessEntityDesigner.UI.DataRelationViewerControl, Consultingwerk.BusinessEntityDesigner.UI.FieldViewerControl, Consultingwerk.BusinessEntityDesigner.UI.IndexViewerControl, Consultingwerk.BusinessEntityDesigner.UI.MemberTableViewerControl, Consultingwerk.Windows.Framework.System.SmartAttachmentRoleViewerControl, Consultingwerk.Windows.Framework.System.SmartBusinessEntityTableViewerControl, Consultingwerk.Windows.Framework.System.SmartBusinessEntityViewerControl, Consultingwerk.Windows.Framework.System.SmartCommentRoleViewerControl, Consultingwerk.Windows.Framework.System.SmartKeyFieldAssignmentTypeViewerControl, Consultingwerk.Windows.Framework.System.SmartLanguageViewer, Consultingwerk.Windows.Framework.System.SmartLoginCompanyViewer, Consultingwerk.Windows.Framework.System.SmartMessageViewerControl, Consultingwerk.Windows.Framework.System.SmartRelationViewerControl, Consultingwerk.Windows.Framework.System.SmartTableViewerControl, Consultingwerk.Windows.Framework.System.SmartTranslationViewerControl, Consultingwerk.Windows.Framework.System.SmartUiTranslationViewerControl, Consultingwerk.Windows.Framework.System.SmartValueListViewerControl

File:SmartViewerControl
Purpose:Base class for SmartComponent Library Viewer Controls
Author(s):Mike Fechner / Consultingwerk Ltd.
Created:Sat Jan 17 16:57:43 CET 2009
Notes:This class is meant to be ABSTRACT but the .NET Visual
Designer framework cannot design classes that inherit
from abstract base classes.



Top Method Summary
Options Name Purpose
# ActivateCurrentGridRow () Activates the current row in the linked Grid
+ ActivateEventHandler () Activates the Event Handlers for the contained controls
+ AddRecord () Add a new record to the SmartDataSource. The Method CreateRecord of SmartViewerControl gets called to Handle this Task. This Method is called by the Toolbar Classes SmartToolbarController or SmartToolStripContainer by pressing the AddRecord Tool. Enforced by Interface ISmartDataTarget.
+ AddSmartTableIOSource (ISmartTableIOSource) Adds a(nother) SmartTableIOSource to the SmartViewerControl instance
# System.Windows.Forms.Control ApplyFocusToErrorField (character) Set's focus into a field that is related to an error
# System.Windows.Forms.Control ApplyFocusToErrorField (IFieldValidationError) Set's focus into a field that is related to an error
+ AttachBindingSource (BindingSource) This Method attaches a new BindingSource given as the Parameter poBindingSource to the Objects of the current Class. The new BindingSource may have been created by a DataAdapter or reused from a SmartBrowserControl
+ BeginInit () Invoked at the beginning of a Containers InitializeComponents method
# BindingSourcePositionChanged (Object, EventArgs) Event handler for the PositionChanged event of the BindingSource this Viewer is attached to
+ CancelUpdate () Reverts the changes to the current record.
# LOGICAL ControlFocus (Control) Calls the Focus() method for a .NET Control
+ CopyRecord () Copy the current record to a new one. The Method CreateRecord of SmartViewerControl gets called to Handle this Task. This Method is called by the Toolbar Classes SmartToolbarController or SmartToolStripContainer by pressing the corresponding Tool. Enforced by Interface ISmartDataTarget.
# CreateRecord (logical) Creates a new record in the viewer. This Method is called by AddRecord and CopyRecord from the current Class but may be overridden.
# CreateVerbs () Creates Designer Verbs based on the DesignerVerbs property
Inherited from Consultingwerk.SmartComponents.Base.SmartUserControl
# CustomInitializeControlHandler (Control) Overridable method that can be used to perform custom event subscriptions
+ DeactivateEventHandler () Deactivates the Event Handlers for the contained controls
+ DeleteRecord () Delete the current record.
+ DeregisterSmartGroupAssignTarget (ISmartGroupAssignTarget) Deregister a SmartDataTarget with the SmartGroupAssignTarget Enforced by Interface ISmartGroupAssignSource.
+ DisableFields () Disable all enabled controls of the SmartViewerControl. This Method is called from inside the SmartViewerControl. Enforced by Interface ISmartDataTarget or ISmartGroupAssignTarget.
- DisableFields (logical) Disable all enabled controls of the SmartViewerControl. This Method is called from inside the SmartViewerControl. Enforced by Interface ISmartDataTarget or ISmartGroupAssignTarget.
# DisplayError (Error) Display ErrorMessages shows a predefined Error Dialog and is called from the Method SaveChanges () of the SmartViewerControl Class.
# DisplayError (Error, logical) Display ErrorMessages shows a predefined Error Dialog and is called from the Method SaveChanges () of the SmartViewerControl Class.
# EditorDropDownAfterCloseUpHandler (Object, EventArgs) Event handler for the AfterCloseUp event of an UltraDateTimeEditor. Clears the reference to the currently opened DataTime popup editor in the variable oEditorDropDownControl
# EditorDropDownAfterDropDownHandler (Object, EventArgs) Event handler for the AfterDropDown event of an UltraDateTimeEditor. Stores a reference to the currently opened DataTime popup editor in the variable oEditorDropDownControl Required to be able to start the update process in the method TextChangedHandler (in this class)
+ EnableFields (character) Enables controls of the SmartViewerControl
+ EndInit () Invoked at the end of a Containers InitializeComponents method
+ EnsureVisible () Ensures that this SmartViewerControl is visible
- EnterEditorControlHandler (Object, EventArgs) Event handler for the Enter event of an EditorButtonControlBase derived Class. Selects all content from the Controls Text Property in the UI.
+ EvaluateTableIOState () This Method sets the Property SmartTableIOState to a value according to the SmartDataSources state of the current class. Possible values for SmartTableIOState are defined in the TableIOStateEnum.
# FillBoundControlTable (Control) Populates the ttViewerBoundControls temp-table
+ LOGICAL FocusFirstEnabledEditorControl (Control) Focusses the first enabled EditorControl of the given Container Control
# FormActivatedHandler (Object, EventArgs) Event handler for the Activate event of the owning Form
# FormClosedHandler (Object, EventArgs) Handles the FormClosed event of the containing Form
- FormClosedHandler2 (Object, EventArgs) Handles the FormClosed event of the containing Form
# FormDeactivatedHandler (Object, EventArgs) Event handler for the Deactivate event of the owning Form
+ System.Collections.Generic.List <System.ComponentModel.Component> GetAllComponents () Returns a List of all Components in the Form
Inherited from Consultingwerk.SmartComponents.Base.SmartUserControl
+ System.Windows.Forms.Control GetBoundControl (character) Returns the reference to the Control that is bound to the named field of the binding source
+ System.Collections.Generic.List <System.Windows.Forms.Control> GetBoundControls (character) Returns the list of Controls that is bound to the named field of the binding source
+ GetBoundControlTable (table) Populates a temp-table with information about all bound controls in the SmartViewerControl
+ CHARACTER GetControlEnabled (Control) Returns the Enable mode for a Control from the list of Controlthat will be enabled and disabled by the Viewer based on the current Viewer state @param poControl The Control for which the Enable mode should be returned @return The CHARACTER value representing the Control Enabled mode */
+ CHARACTER GetControlSecurityEnabled (Control) Returns the security Enable mode for a Control from the list of Controls that will be enabled and disabled by the Viewer based on the current Viewer state @param poControl The Control for which the Enable mode should be returned @return The CHARACTER value representing the security Control Enabled mode */
+ System.Windows.Forms.Control GetViewerField (character) Returns the reference to a Control in the Viewer identified by the Controls Name. This Method starts a recursive search for the Control.
# System.Windows.Forms.Control GetViewerField (character, Control) Recursively searches for the Control with the given name
# Consultingwerk.SmartComponents.Interfaces.ISmartGroupAssignTarget GetViewerForBoundControl (character) Returns the reference to the SmartGroupAssignTarget that contains a Control bound to the given field name
# GroupAssignSmartTableIOStateChangedHandler (Object, SmartTableIOStateChangedEventArgs) Event handler for the SmartTableIOStateChanged event of the Groupassign Source
+ HandleValidationError (Error) Handles an error raised by validation routines
+ LOGICAL HasBoundControl (character, logical) Returns logical value indicating if the Viewer contains a Control that is bound to the named field
# InitializeControlEventHandler () Subscribe the EventHandler(s) to events of all controls added to the SmartViewerControl. The RecurseInitializeControlEventHandler is used to Handle this Task. This Method is called every Time a new Control is added to the SmartViewerControl.
# InitializeViewerLogicObject () Initializes the Viewer Logic Object
# LOGICAL IsControlEnabled (character, character, logical) Determines if a Control should be enabeld based on the SecurityEnableMode and EnableMode
+ LOGICAL IsEditorControl (Control) Returns TRUE is the Controls is recognized as an Editor Control
+ LOGICAL IsOkToClose (logical, CloseReason) Check if it is ok to close the parent form. Returns TRUE when the form can be closed. Otherwise returns FALSE. Enforced by the Interface ICheckOkToClose.
# LOGICAL IsValueChanged (Object) Returns if the current (screen-value) of a Control in the SmartViewerControl derived class has changed in comparison to the underlying buffer vaule
- LeaveHandler (Object, EventArgs) Event handler for the Leave event
# OnAddedRecordModifiedChanged (EventArgs) Raises the AddedRecordModifiedChanged
# OnAddingRecordChanged (EventArgs) Raises the AddingRecordChanged event
# OnAfterAddRecord (EventArgs) Raises the AfterAddRecord event
# OnAfterCancelUpdate (EventArgs) Raises the AfterCancelUpdate event
# OnAfterCopyRecord (EventArgs) Raises the AfterCopyRecord event
# OnAfterDeleteRecord (EventArgs) Raises the AfterDeleteRecord event
# OnAfterFieldsEnabled (EventArgs) Raises the AfterFieldsEnabled
# OnAfterSaveChanges (EventArgs) Raises the AfterSaveChanges event
# OnBeforeAddRecord (CancelEventArgs) Raises the BeforeAddRecord event
# OnBeforeCancelUpdate (CancelEventArgs) Raises the BeforeCancelUpdate event
# OnBeforeCopyRecord (CancelEventArgs) Raises the BeforeCopyRecord event
# OnBeforeDeleteRecord (CancelEventArgs) Raises the BeforeDeleteRecord event
# OnBeforeEnableFields (CancelableEventArgs) Raises the BeforeEnableFields
# OnBeforeSaveChanges (CancelEventArgs) Raises the BeforeSaveChanges event
# OnCopyingRecordChanged (EventArgs) Raises the CopyingRecordChanged
# OnEnter (EventArgs) Raises the Enter event
# OnFieldsDisabled (EventArgs) Raises the FieldsDisabled event.
# OnFieldsEnabled (EventArgs) Raises the FieldsEnabled event.
# OnFocusControlOnAddChanged (EventArgs) Raises the FocusControlOnAddChanged event
# OnFocusControlOnUpdateChanged (EventArgs) Raises the FocusControlOnUpdateChanged event
# OnLoad (EventArgs) Raises the Load event
Overrides Consultingwerk.SmartComponents.Base.SmartUserControl:OnLoad (EventArgs)
# OnSmartDataSourceChanged (EventArgs) Publishes the SmartGroupAssignSourceChanged event
# OnSmartGroupAssignSourceChanged (EventArgs) Publishes the SmartGroupAssignSourceChanged event
# OnSmartTableIOSourceChanged (EventArgs) Publishes the SmartGroupAssignSourceChanged event
# OnSmartTableIOStateChanged (SmartTableIOStateChangedEventArgs) Publishes the SmartTableIOStateChanged event
+ OnVerbClicked (character) Event Handler method for Designer Verbs
Inherited from Consultingwerk.SmartComponents.Base.SmartUserControl
# OnVisualValidating (EventArgs) Raises the VisualValidating event
- ParentChangedHandler (Object, EventArgs) Event handler to the ParentChanged event Add EventHandlers to Child Controls inside the SmartViewerControl. This Method is Executed when the SmartViewerControl is added to a Form.
# ParentFormDestroyedHandler (Object, EventArgs) Event handler for the FormDestroyed event of the owning Form
Inherited from Consultingwerk.SmartComponents.Base.SmartUserControl
# RecurseInitializeControlEventHandler (Control) Subscribe the EventHandler(s) to events of all controls added to the SmartViewerControl. This Method is called by the Method InitializeControlEventHandler () of the SmartViewerControl.
# System.Windows.Forms.Control RecurseLocateBindingControl (Control, character) Recurses through the Controls in this SmartViewerControl and nested controls searching for a Control that is bound to the named BindingProperty (a field attached to the ProBindingSource).
# RecurseLocateBindingControls (Control, Control>, character) Recurses through the Controls in this SmartViewerControl and nested controls searching for all Controls that are bound to the named BindingProperty (a field attached to the ProBindingSource).
# RecurseLookupStopTimer (Control) Stops the current timer of all Lookups
# RecursePerformLookup (Control) Performs the Lookup operation in all contained SmartLookup Controls
# RecurseReplaceBindingSource (Control, BindingSource) Internal method to replace the data bindings of all contained Controls with the actual binding source provided by a SmartDataSource.
# RecurseRestoreCurrentValues (Control) Recurese Restore the Current Values of the Controls on the Viewer after a new DataRow is created. This Method is called by the internal Method RestoreValuesForCopy (). Parameters:
# RecurseStoreCurrentValues (Control) Recurese Store the Current Values of the Controls on the Viewer before a new DataRow is created. This Method is called by the internal Method StoreValuesForCopy ().
+ RegisterSmartGroupAssignTarget (ISmartGroupAssignTarget) Register a SmartDataTarget with the SmartGroupAssignTarget This Method is executed every time a new SmartGroupAssignSource is registered to the corresponding Property of a Class implementing the Interface ISmartGroupAssignSource. Enforced by Interface ISmartGroupAssignSource.
# RemoveControlEnabled (Control) Removes a Control from the list of Controls that will be enabled and disabled by the Viewer based on the current Viewer state @param poControl The Control which shall be removed from the list of managed Controls */
# RemoveControlEnabled (Control, Control) Removes multiple Controls from the list of Controls that will be enabled and disabled by the Viewer based on the current Viewer state @param poControl1 The first Control which shall be removed from the list of managed Controls @param poControl2 The second Control which shall be removed from the list of managed Controls */
# RemoveControlEnabled (Control, Control, Control) Removes multiple Controls from the list of Controls that will be enabled and disabled by the Viewer based on the current Viewer state @param poControl1 The first Control which shall be removed from the list of managed Controls @param poControl2 The second Control which shall be removed from the list of managed Controls @param poControl3 The third Control which shall be removed from the list of managed Controls */
# RemoveControlEnabled (Control, Control, Control, Control) Removes multiple Controls from the list of Controls that will be enabled and disabled by the Viewer based on the current Viewer state @param poControl1 The first Control which shall be removed from the list of managed Controls @param poControl2 The second Control which shall be removed from the list of managed Controls @param poControl3 The third Control which shall be removed from the list of managed Controls @param poControl4 The fourth Control which shall be removed from the list of managed Controls */
# RemoveControlEnabled (Control, Control, Control, Control, Control) Removes multiple Controls from the list of Controls that will be enabled and disabled by the Viewer based on the current Viewer state @param poControl1 The first Control which shall be removed from the list of managed Controls @param poControl2 The second Control which shall be removed from the list of managed Controls @param poControl3 The third Control which shall be removed from the list of managed Controls @param poControl4 The fourth Control which shall be removed from the list of managed Controls @param poControl5 The fifth Control which shall be removed from the list of managed Controls */
+ RemoveSmartTableIOSource (ISmartTableIOSource) Removes a SmartTableIOSource from the SmartDataAdapter instance
+ RestoreValuesForCopy () Restore the Current Values of all Controls on a SmartViewerControl and in all SmartGroupAssignTargets. This Method is called by CreateRecord from the current Class. Enforced by Interface ISmartGroupAssignTarget.
+ SaveChanges () Saves the current changes to the database.
+ LOGICAL SaveChangesOnDeactivateForm (logical) Saves pending changes when a Form is deactivated
+ SetControlEnabled (Control, character) Sets the Enable Mode for a given Control inside the SmartViewerControl. Called by the Method InitializeControlEventHandler () of a SmartViewerControl derived Class.
+ SetControlEnabled (Control, Control, character) Sets the Enable Mode for two given Controls inside the SmartViewerControl. Called by the Method InitializeControlEventHandler () of a SmartViewerControl derived Class.
+ SetControlEnabled (Control, Control, Control, character) Sets the Enable Mode for three given Controls inside the SmartViewerControl. Called by the Method InitializeControlEventHandler () of a SmartViewerControl derived Class.
+ SetControlEnabled (Control, Control, Control, Control, character) Sets the Enable Mode for four given Controls inside the SmartViewerControl. Called by the Method InitializeControlEventHandler () of a SmartViewerControl derived Class.
+ SetControlEnabled (Control, Control, Control, Control, Control, character) Sets the Enable Mode for five given Controls inside the SmartViewerControl. Called by the Method InitializeControlEventHandler () of a SmartViewerControl derived Class.
- SetControlSecurityEnabled (Control, character) Sets the Enable Mode based on Security Constraints for a given Control
+ SetModifyingState () Sets the TableIOState to ModifyingData
+ SetOpenedEditorDropDownControl (Control) Set's the current opened EditorDropDownControl
+ StoreValuesForCopy () Store the Current Values of all Controls on a SmartViewerControl and do the same in all SmartGroupAssignTargets. This Method is called by CreateRecord from the current Class. Enforced by Interface ISmartGroupAssignTarget.
+ TextChangedEventHandler (Object, EventArgs) Event handler for the TextChangedEvent event of Editor Controls on the SmartViewerControl. Initiate switching to the ModifyinData Mode if the user enters data.
+ VisualValidate () Validate data entered into the DataFields

Top Constructor Summary
Options Name Purpose
+ SmartViewerControl () The Constructor initializes a new SmartViewerControl Subscribes handlers for events

Top Event Summary
Options Name Purpose
+ AddedRecordModifiedChanged DELEGATE System.EventHandler Raised when the value of the AddedRecordModified property changes
+ AddingRecordChanged DELEGATE System.EventHandler Event fired when the AddingRecord Property is changed
+ AfterAddRecord DELEGATE System.EventHandler Event fired when the viewer has successfully started an Add operation
+ AfterCancelUpdate DELEGATE System.EventHandler Event fired when the viewer has successfully cancelled an update
+ AfterCopyRecord DELEGATE System.EventHandler Event fired when the viewer has successfully started a Copy operation
+ AfterDeleteRecord DELEGATE System.EventHandler Event fired when the viewer has successfully deleted a record.
+ AfterFieldsEnabled DELEGATE System.EventHandler Raised after the fields have been enabled
+ AfterSaveChanges DELEGATE System.EventHandler Event fired when the viewer has successfully saved changes
+ BeforeAddRecord DELEGATE System.ComponentModel.CancelEventHandler Event fired when the Viewer starts adding a new record. This event is cancelable
+ BeforeCancelUpdate DELEGATE System.ComponentModel.CancelEventHandler Event fired when the Viewer begins cancelling an update. This event is cancellable
+ BeforeCopyRecord DELEGATE System.ComponentModel.CancelEventHandler Event fired when the Viewer begins copying a record. This event is cancellable
+ BeforeDeleteRecord DELEGATE System.ComponentModel.CancelEventHandler Event fired when the Viewer starts deleting a record. This event is cancellable
+ BeforeEnableFields (Object, CancelableEventArgs) Raised before the fields are enabled
+ BeforeSaveChanges DELEGATE System.ComponentModel.CancelEventHandler Event fired when the Viewer starts saving a record. This event is cancellable
+ CopyingRecordChanged DELEGATE System.EventHandler Raised when the CopyingRecord property has changed
+ FieldsDisabled DELEGATE System.EventHandler Event fired when the fields of this viewer become disabled
+ FieldsEnabled DELEGATE System.EventHandler Event fired when the fields of this viewer become enabled
+ FocusControlOnAddChanged DELEGATE System.EventHandler Event fired when the FocusControlOnAdd property changes
+ FocusControlOnUpdateChanged DELEGATE System.EventHandler Event fired when the FocusControlOnUpdate property changes
+ SmartDataSourceChanged DELEGATE System.EventHandler Event fired when the SmartDataSource Property is changed
+ SmartGroupAssignSourceChanged DELEGATE System.EventHandler Event fired when the SmartGroupAssignSource Property is changed
+ SmartTableIOSourceChanged DELEGATE System.EventHandler Event fired when the SmartTableIOSource Property is changed
+ SmartTableIOStateChanged (Object, SmartTableIOStateChangedEventArgs) Event fired whenever the SmartTableIOState property has changed
+ VisualValidating DELEGATE System.EventHandler Raised when the Viewer performs Visual Validation

Top Property Summary
Options Name Purpose
+ LOGICAL ActivateCurrentGridRowDuringEdit Gets and sets if the current Grid row should be Activated (highlighted) when starting to update in the Grid
+ LOGICAL AddedRecordModified Returns if a record being added was already modified by the user
+ LOGICAL AddingRecord Flag that indicates if we are currently in Add Mode. When CreateRecord () is called the value of the Property changes to TRUE. CancelUpdate ()or during initialization the call of EvaluateTableIOState () resets the value of the Property to FALSE.
+ LOGICAL AllowCloseOfUnmodifiedNewRecord Controls if a Form containing this SmartViewerControl instance can be closed without a prompt to the user when a record has just been created but the user has not yet changed a single field
+ LOGICAL CancellingUpdate Returns if the Viewer is currently cancelling the update
+ LOGICAL CopyingRecord Returns if the Viewer is currently copying a record
# CHARACTER DesignerVerbs Property that is used to generate Designer Verbs (actions for the Visual Designer)
Inherited from Consultingwerk.SmartComponents.Base.SmartUserControl
+ LOGICAL DesignTime Propery flags if the current instance of the SmartBindingSource is running at design time or runtime.
Inherited from Consultingwerk.SmartComponents.Base.SmartUserControl
+ LOGICAL EventHandlerActive Returns if the EventHandlers that would enter Edit mode (TextChanged, CheckChanged) are activated or not
+ System.Windows.Forms.Control FocusControlOnAdd Get/Set the Control that will automatically become focussed on Add or Copy
+ System.Windows.Forms.Control FocusControlOnUpdate Get/Set the Control that will automatically become focussed on Update
# CHARACTER HiddenProperties Property that is used to mark properties (comma-delimited list) that will be excluded from the .NET TypeDescriptor properties list
Inherited from Consultingwerk.SmartComponents.Base.SmartUserControl
+ LOGICAL Initializing Indicated that the SmartViewerControl is currrently being Initialized
+ Consultingwerk.SmartComponents.Interfaces.Design.IDesignDataSource LinkDataSource Represents the SmartDataSource property casted to a .NET Interface
+ Consultingwerk.SmartComponents.Interfaces.Design.IDesignGroupAssignSource LinkGroupAssignSource Represents the SmartGroupAssignSource property casted to a .NET Interface
+ Consultingwerk.SmartComponents.Interfaces.Design.IDesignTableIOSource LinkTableIOSource Represents the SmartTableIOSource property casted to a .NET Interface
# CHARACTER NonBrowsableProperties Property that is used to mark properties (comma-delimited list) that should not show up in the Visual Designers Property Grid
Inherited from Consultingwerk.SmartComponents.Base.SmartUserControl
# Consultingwerk.SmartComponents.Base.SmartViewerOptionalFeatures OptionalFeatures /*- Purpose: Reference to the SmartViewerOptionalFeaturesInstance that allows to toggle on or off optional features of the SmartViewerControl Notes: */
# LOGICAL ParentFormDestroyedSubscribed Returns if the FormDestroyed evengt of the containing Form has been subscribed
Inherited from Consultingwerk.SmartComponents.Base.SmartUserControl
+ LOGICAL ReadOnlyDisabled Gets and sets if Infragistics Text Editor Controls should be set ReadOnly instead of Enabled = FALSE when update is not active
+ LOGICAL SaveMode Controls if the Viewer's field remain Enabled after Save or Cancel
+ LOGICAL SavingChanges Returns if the Viewer is currently saving the changes
+ CHARACTER SecurityKey Gets and sets the Toolbar Security Key
+ Consultingwerk.SmartComponents.Interfaces.ISmartDataSource SmartDataSource Get/Set the SmartDataSource of the current Class. The SmartDataSource can be set to any class implementing the Interface ISmartDataSource. This Property is set by the developer when initializing a Control implementing the Interface ISmartDataTarget. Enforced by Interface ISmartDataTarget.
+ Consultingwerk.SmartComponents.Interfaces.ISmartGroupAssignSource SmartGroupAssignSource Property to register a SmartGroupAssignSource for the SmartViewerControl a backward handshake to the Source is done. A SmartGroupAssignSource can be every class implementing the Interface ISmartGroupAssignSource. This Property is set programatically by the developer.
+ Consultingwerk.SmartComponents.Base.ListISmartGroupAssignTarget SmartGroupAssignTargets Returns the list of SmartGroupAssignTargets as a generic list
+ Consultingwerk.SmartComponents.Interfaces.ISmartTableIOSource SmartTableIOSource Get and Set the current SmartTableIOSource of the SmartViewerControl. This Property is set by the developer when initializing a Control implementing the Interface ISmartDataTarget. Enforced by Interface ISmartDataTarget.
+ CHARACTER SmartTableIOState The SmartTableIOState property reflects the operationmode of the SmartViewerControl. Value changes of this Property are only made in the Class SmartViewerControl. Enforced by Interface ISmartDataTarget or ISmartGroupAssignTarget.
# LOGICAL TextChangedHandlerSuspended Gets and sets if text TextChangedHandler is (temporarily) suspended
+ Consultingwerk.SmartComponents.Enum.UpdateStateEnum UpdateState Returns the Update State of the Viewer
+ CHARACTER ViewerLogicClass Gets and sets the class name of the ViewerLogic class
+ Consultingwerk.SmartComponents.Interfaces.ISmartViewerLogic ViewerLogicObject Returns the reference to the ISmartViewerLogic instance that provides logic for this instance


Method Detail
Top

PROTECTED ActivateCurrentGridRow ()

Purpose: Activates the current row in the linked Grid
Notes:

Top

PUBLIC ActivateEventHandler ()

Purpose: Activates the Event Handlers for the contained controls
Notes:

Top

PUBLIC AddRecord ()

Purpose: Add a new record to the SmartDataSource. The Method CreateRecord of
SmartViewerControl gets called to Handle this Task.
This Method is called by the Toolbar Classes SmartToolbarController
or SmartToolStripContainer by pressing the AddRecord Tool.
Enforced by Interface ISmartDataTarget.
Notes:

Top

PUBLIC AddSmartTableIOSource (ISmartTableIOSource)

Purpose: Adds a(nother) SmartTableIOSource to the SmartViewerControl
instance
Notes: Enables multiple SmartTableIOSources to the SmartViewerControl

Parameters:
poSmartTableIOSource Consultingwerk.SmartComponents.Interfaces.ISmartTableIOSource
The SmartTableIOSource instance to add to the list of TableIO Sources of this Control
Top

PROTECTED System.Windows.Forms.Control ApplyFocusToErrorField (character)

Purpose: Set's focus into a field that is related to an error
Notes: Proteced method, so behaviour can be customized
Returns the focussed Control, so that visual hints may be added

Parameters:
pcFieldName CHARACTER
The name of the field to apply Focus to
Returns System.Windows.Forms.Control
The Control that the focus was applied to
Top

PROTECTED System.Windows.Forms.Control ApplyFocusToErrorField (IFieldValidationError)

Purpose: Set's focus into a field that is related to an error
Notes: Proteced method, so behaviour can be customized
Returns the focussed Control, so that visual hints may be added

Parameters:
e Consultingwerk.SmartComponents.Base.IFieldValidationError
The IFieldValidationError instance that contains the information about which Contrl/Field to focus
Returns System.Windows.Forms.Control
The Control that the focus was applied to
Top

PUBLIC AttachBindingSource (BindingSource)

Purpose: This Method attaches a new BindingSource given as the Parameter
poBindingSource to the Objects of the current Class. The new
BindingSource may have been created by a DataAdapter or reused from a
SmartBrowserControl
Notes: Enforced by Interface ISmartDataTarget.
It is called by the SmartDataAdapter Class when creating a new
BindingSource or when a new SmartDataSource is registered to the
Class implementing the Interface ISmartDataTarget.
This method is also called from the SmartViewerControl destructor (while
a form is closed) to de-attach from the Binding Source. In this case
the poBindingSource reference is passed in as the unknown value.

Parameters:
poBindingSource Progress.Data.BindingSource
The BindingSource to be attached to the Controls contained in the Viewer
Top

PUBLIC BeginInit ()

Purpose: Invoked at the beginning of a Containers InitializeComponents
method
Notes: Enforced by System.ComponentModel.ISupportInitialize
See http://msdn.microsoft.com/de-de/library/system.componentmodel.isupportinitialize.begininit(VS.80).aspx

Top

PROTECTED BindingSourcePositionChanged (Object, EventArgs)

Purpose: Event handler for the PositionChanged event of the BindingSource
this Viewer is attached to
Notes: Cancels the pending timer of all Lookups contained on the Viewer

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

PUBLIC CancelUpdate ()

Purpose: Reverts the changes to the current record.
Notes: This Method is called by the Toolbar Classes SmartToolbarController
or SmartToolStripContainer by pressing the corresponding Tool.
Enforced by Interface ISmartDataTarget.

Top

PROTECTED LOGICAL ControlFocus (Control)

Purpose: Calls the Focus() method for a .NET Control
Notes: SCL-659 : A customer was setting the SET-WAIT-STATE("GENERAL") using
the WaitStateManager around all TableIO Operations - with the consequence,
that all Focus() operations on
- error message putting focus to error field
- FocusControlOnAdd, etc.
were not working anymore. Seems that .NET Controls ignore the Focus()
during the WAIT-STATE. In order to workaround those situation we have
moved all calls to the Focus() method of Viewer Controls to the
overriable method ControlFocus() that receives the Control reference
as the input parameter. This overridable method can be extended by
customers to make sure no WAIT-STATE is active anymore before the
Control:Focus() Focus() is called.

Parameters:
poControl System.Windows.Forms.Control
The reference to the .NET Control that should receive Focus
Returns LOGICAL
Logical value indicating if the input focus request was successful
Top

PUBLIC CopyRecord ()

Purpose: Copy the current record to a new one. The Method CreateRecord of
SmartViewerControl gets called to Handle this Task.
This Method is called by the Toolbar Classes SmartToolbarController
or SmartToolStripContainer by pressing the corresponding Tool.
Enforced by Interface ISmartDataTarget.
Notes:

Top

PROTECTED CreateRecord (logical)

Purpose: Creates a new record in the viewer.
This Method is called by AddRecord and CopyRecord from the current
Class but may be overridden.
Notes:

Parameters:
plCopy LOGICAL
Logical value indicating if the method has been called from AddRecord or CopyRecord, FALSE = Add new record, TRUE = Copy existing record
Top

PROTECTED CreateVerbs ()

Inherited from Consultingwerk.SmartComponents.Base.SmartUserControl
Purpose: Creates Designer Verbs based on the DesignerVerbs property
Notes:

Top

PROTECTED CustomInitializeControlHandler (Control)

Purpose: Overridable method that can be used to perform custom event
subscriptions
Notes: Empty method, needs to be overridden in a custom viewer class

Parameters:
poControl System.Windows.Forms.Control
The reference to the Control
Top

PUBLIC DeactivateEventHandler ()

Purpose: Deactivates the Event Handlers for the contained controls
Notes:

Top

PUBLIC DeleteRecord ()

Purpose: Delete the current record.
Notes: The Method DeleteRow of the SmartDataSource is called to perform
this Task. This Method is called by the Toolbar Classes SmartToolbarController
or SmartToolStripContainer by pressing the corresponding Tool.
Enforced by Interface ISmartDataTarget.

Top

PUBLIC DeregisterSmartGroupAssignTarget (ISmartGroupAssignTarget)

Purpose: Deregister a SmartDataTarget with the SmartGroupAssignTarget
Enforced by Interface ISmartGroupAssignSource.
Notes:

Parameters:
poSmartGroupAssignTarget Consultingwerk.SmartComponents.Interfaces.ISmartGroupAssignTarget
The SmartGroupAssignTarget to deregister from this SmartViewerControl instance
Top

PUBLIC DisableFields ()

Purpose: Disable all enabled controls of the SmartViewerControl.
This Method is called from inside the SmartViewerControl.
Enforced by Interface ISmartDataTarget or ISmartGroupAssignTarget.
Notes:

Top

PRIVATE DisableFields (logical)

Purpose: Disable all enabled controls of the SmartViewerControl.
This Method is called from inside the SmartViewerControl.
Enforced by Interface ISmartDataTarget or ISmartGroupAssignTarget.
Notes: Private version of Disable Fields that allows to disable fields (no
record available and SaveMode = TRUE) without raising the event that
the TableIOState was changed

Parameters:
plAssignTableIOState LOGICAL
Logical value indicating if the SmartTableIOState should be
Top

PROTECTED DisplayError (Error)

Purpose: Display ErrorMessages shows a predefined Error Dialog and is called
from the Method SaveChanges () of the SmartViewerControl Class.
Notes:

Parameters:
e Progress.Lang.Error
The error instance to visualize
Top

PROTECTED DisplayError (Error, logical)

Purpose: Display ErrorMessages shows a predefined Error Dialog and is called
from the Method SaveChanges () of the SmartViewerControl Class.
Notes:

Parameters:
e Progress.Lang.Error
The error instance to visualize
plEnsureVisible LOGICAL
Logical flag indicating if the viewer should ensure it's visible
Top

PROTECTED EditorDropDownAfterCloseUpHandler (Object, EventArgs)

Purpose: Event handler for the AfterCloseUp event of an
UltraDateTimeEditor. Clears the reference to the currently opened
DataTime popup editor in the variable oEditorDropDownControl
Notes:

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

PROTECTED EditorDropDownAfterDropDownHandler (Object, EventArgs)

Purpose: Event handler for the AfterDropDown event of an
UltraDateTimeEditor. Stores a reference to the currently opened
DataTime popup editor in the variable oEditorDropDownControl
Required to be able to start the update process in the
method TextChangedHandler (in this class)
Notes:

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

PUBLIC EnableFields (character)

Purpose: Enables controls of the SmartViewerControl
Notes: This Method is called by the Toolbar Classes SmartToolbarController
or SmartToolStripContainer by pressing the Tools for Add or Edit Data.
Enforced by Interface ISmartDataTarget or ISmartGroupAssignTarget.

Parameters:
pcFields CHARACTER
The EnableFieldsEnum value indicating if the fields are enabled for Add or Update
Top

PUBLIC EndInit ()

Purpose: Invoked at the end of a Containers InitializeComponents method
Notes: Enforced by System.ComponentModel.ISupportInitialize
See http://msdn.microsoft.com/de-de/library/system.componentmodel.isupportinitialize.endinit(VS.80).aspx

Top

PUBLIC EnsureVisible ()

Purpose: Ensures that this SmartViewerControl is visible
Notes:

Top

PRIVATE EnterEditorControlHandler (Object, EventArgs)

Purpose: Event handler for the Enter event of an EditorButtonControlBase
derived Class. Selects all content from the Controls Text Property
in the UI.
Notes:

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

PUBLIC EvaluateTableIOState ()

Purpose: This Method sets the Property SmartTableIOState to a value according
to the SmartDataSources state of the current class. Possible values
for SmartTableIOState are defined in the TableIOStateEnum.
Notes: This Method is called by the SmartDataAdapter when the
PositionChangedHandler is fired or inside the SmartViewerControl if
a new BindingSource is attached.
Enforced by ISmartDataTarget

Top

PROTECTED FillBoundControlTable (Control)

Purpose: Populates the ttViewerBoundControls temp-table
Notes: Internal method, populates records for a single control container at
a time

Parameters:
poContainer System.Windows.Forms.Control
The reference to the current control container
Top

PUBLIC LOGICAL FocusFirstEnabledEditorControl (Control)

Purpose: Focusses the first enabled EditorControl of the given Container
Control
Notes: DEFINE PRIVATE STATIC TEMP-TABLE ttTabOrder NO-UNDO
FIELD RecordOwner AS Progress.Lang.Object
FIELD ChildControl AS Progress.Lang.Object
FIELD TabOrder AS INTEGER
INDEX RecordOwner RecordOwner TabOrder .

Parameters:
poControl System.Windows.Forms.Control
The reference to the container control
Returns LOGICAL
Logical value indicating the success of this method
Top

PROTECTED FormActivatedHandler (Object, EventArgs)

Purpose: Event handler for the Activate event of the owning Form
Notes: Notes, this Event Handler is only subscribed to the Activate event
of the containing Form when the Viewer's event handlers are activated,
i.o.w the Viewer is active.

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

PROTECTED FormClosedHandler (Object, EventArgs)

Purpose: Handles the FormClosed event of the containing Form
Notes: Notes, this Event Handler is only subscribed to the FormClosed event
of the containing Form when the Viewer's event handlers are activated,
iow the Viewer is active.

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

PRIVATE FormClosedHandler2 (Object, EventArgs)

Purpose: Handles the FormClosed event of the containing Form
Notes: Notes, this Event Handler is always subscribed to the FormClosed event
of the containing Form

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

PROTECTED FormDeactivatedHandler (Object, EventArgs)

Purpose: Event handler for the Deactivate event of the owning Form
Notes: Notes, this Event Handler is only subscribed to the Deactivated event
of the containing Form when the Viewer's event handlers are activated,
iow the Viewer is active.

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

PUBLIC System.Collections.Generic.List <System.ComponentModel.Component> GetAllComponents ()

Inherited from Consultingwerk.SmartComponents.Base.SmartUserControl
Purpose: Returns a List of all Components in the Form
Notes: Supported on OpenEdge 11 only, due to dependency to the ComponentsCollection
list not available on 10.2B

Returns System.Collections.Generic.List <System.ComponentModel.Component>
The List of Components in the Form
Top

PUBLIC System.Windows.Forms.Control GetBoundControl (character)

Purpose: Returns the reference to the Control that is bound to the named field
of the binding source
Notes:

Parameters:
pcBindingPropertyName CHARACTER
The name of the field in the ProBindingSource
Returns System.Windows.Forms.Control
The reference to the resulting Control
Top

PUBLIC System.Collections.Generic.List <System.Windows.Forms.Control> GetBoundControls (character)

Purpose: Returns the list of Controls that is bound to the named field
of the binding source
Notes: Returns all Controls in the viewer and also GroupAssignLinked viewers

Parameters:
pcBindingPropertyName CHARACTER
The name of the field in the ProBindingSource
Returns System.Collections.Generic.List <System.Windows.Forms.Control>
The List of bound Controls
Top

PUBLIC GetBoundControlTable (table)

Purpose: Populates a temp-table with information about all bound controls
in the SmartViewerControl
Notes: Also processes GroupAssignTarget Viewers

Parameters:
ttViewerBoundControls TABLE
INPUT-OUTPUT TABLE with the data binding information, from Consultingwerk\SmartComponents\Base\ttViewerBoundControls.i
Top

PUBLIC CHARACTER GetControlEnabled (Control)

Purpose: Returns the Enable mode for a Control from the list of Controlthat will be enabled
and disabled by the Viewer based on the current Viewer state

Parameters:
poControl System.Windows.Forms.Control
The Control for which the Enable mode should be returned
Returns CHARACTER
The CHARACTER value representing the Control Enabled mode
Top

PUBLIC CHARACTER GetControlSecurityEnabled (Control)

Purpose: Returns the security Enable mode for a Control from the list of Controls
that will be enabled and disabled by the Viewer based on the current Viewer
state

Parameters:
poControl System.Windows.Forms.Control
The Control for which the Enable mode should be returned
Returns CHARACTER
The CHARACTER value representing the security Control Enabled mode
Top

PUBLIC System.Windows.Forms.Control GetViewerField (character)

Purpose: Returns the reference to a Control in the Viewer identified by the Controls
Name. This Method starts a recursive search for the Control.
Notes: The Method is called by the SmartLookupControls to set values to
the Controls after the Lookup Dialog has been closed.

Parameters:
pcControlName CHARACTER
Name of the Control to search
Returns System.Windows.Forms.Control
The reference to the Control or the unknown value
Top

PROTECTED System.Windows.Forms.Control GetViewerField (character, Control)

Purpose: Recursively searches for the Control with the given name
Notes: This Method is called by the Method GetViewerField (pcControlName AS CHARACTER)
of the SmartViewerControl Class.

Parameters:
pcControlName CHARACTER
Name of the Control to search
poControl System.Windows.Forms.Control
The parent control to search in
Returns System.Windows.Forms.Control
The reference to the Control or the unknown value
Top

PROTECTED Consultingwerk.SmartComponents.Interfaces.ISmartGroupAssignTarget GetViewerForBoundControl (character)

Purpose: Returns the reference to the SmartGroupAssignTarget that contains
a Control bound to the given field name
Notes:

Parameters:
pcFieldName CHARACTER
The name of the field
Returns Consultingwerk.SmartComponents.Interfaces.ISmartGroupAssignTarget
The reference to the SmartGroupAssignTarget that contains a Control bound to the given field name
Top

PROTECTED GroupAssignSmartTableIOStateChangedHandler (Object, SmartTableIOStateChangedEventArgs)

Purpose: Event handler for the SmartTableIOStateChanged event of the
Groupassign Source
Notes:

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

PUBLIC HandleValidationError (Error)

Purpose: Handles an error raised by validation routines
Notes: Displays the Error message and focusses the field that caused the error

Parameters:
poError Progress.Lang.Error
The reference to the validation error instance
Top

PUBLIC LOGICAL HasBoundControl (character, logical)

Purpose: Returns logical value indicating if the Viewer contains a Control
that is bound to the named field
Notes: Optionally includes Group Assigned viewers

Parameters:
pcBindingPropertyName CHARACTER
The name of the field in the ProBindingSource
plIncludeGroupAssignTargets LOGICAL
Logical value indicating if the method should also look in GroupAssign Target Viewers
Returns LOGICAL
Logical value indicating if a bound control exists
Top

PROTECTED InitializeControlEventHandler ()

Purpose: Subscribe the EventHandler(s) to events of all controls added to
the SmartViewerControl. The RecurseInitializeControlEventHandler is
used to Handle this Task.
This Method is called every Time a new Control is added to the
SmartViewerControl.
Notes:

Top

PROTECTED InitializeViewerLogicObject ()

Purpose: Initializes the Viewer Logic Object
Notes: The SmartViewerControl will initialize the ViewerLogicClass during
EndInit when the property ViewerLogicClass is set and the Viewer
does not have a SmartGroupAssignSource
The Viewer Logic Object will also not initialized when the ViewerLogicObject
instance is already set
Registers the ViewerLogicObject also for the SmartGroupAssignTargets

Top

PROTECTED LOGICAL IsControlEnabled (character, character, logical)

Purpose: Determines if a Control should be enabeld based on the SecurityEnableMode
and EnableMode
Notes:

Parameters:
pcSecurityEnableMode CHARACTER
The security enable mode of the current control
pcEnableMode CHARACTER
The enable mode of the current control
plAdd LOGICAL
Logical value indicating if the viewer is in Add (true) or Update (false) mode
Returns LOGICAL
Logical value indicating if the control is supposed to be enabeld or not
Top

PUBLIC LOGICAL IsEditorControl (Control)

Purpose: Returns TRUE is the Controls is recognized as an Editor Control
Notes: That is a Control the user normally enters Text

Parameters:
poControl System.Windows.Forms.Control
The reference to the Control to test
Returns LOGICAL
Logical valud indicating if the Control is a known Editor Control
Top

PUBLIC LOGICAL IsOkToClose (logical, CloseReason)

Purpose: Check if it is ok to close the parent form.
Returns TRUE when the form can be closed. Otherwise returns FALSE.
Enforced by the Interface ICheckOkToClose.
Notes:

Parameters:
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 why the form is closed
Returns LOGICAL
Logical value indicating if the parent Form may be closed
Top

PROTECTED LOGICAL IsValueChanged (Object)

Purpose: Returns if the current (screen-value) of a Control in the SmartViewerControl
derived class has changed in comparison to the underlying buffer vaule
Notes: Currently compares based on Value, Text, CheckedState or LookupKeyValue
bound values

Parameters:
poControl System.Object
The reference to the Control (type is System.Object for convenience of passing in the sender of a .NET event handler)
Returns LOGICAL
Logical value indicating if the current value has changed
Top

PRIVATE LeaveHandler (Object, EventArgs)

Purpose: Event handler for the Leave event
Notes: No longer overriding the OnLeave method as that cause unhandled
.NET Exceptions when in update mode and the containing Form was closed

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

PROTECTED OnAddedRecordModifiedChanged (EventArgs)

Purpose: Raises the AddedRecordModifiedChanged
Notes:

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

PROTECTED OnAddingRecordChanged (EventArgs)

Purpose: Raises the AddingRecordChanged event
Notes:

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

PROTECTED OnAfterAddRecord (EventArgs)

Purpose: Raises the AfterAddRecord event
Notes:

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

PROTECTED OnAfterCancelUpdate (EventArgs)

Purpose: Raises the AfterCancelUpdate event
Notes:

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

PROTECTED OnAfterCopyRecord (EventArgs)

Purpose: Raises the AfterCopyRecord event
Notes:

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

PROTECTED OnAfterDeleteRecord (EventArgs)

Purpose: Raises the AfterDeleteRecord event
Notes:

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

PROTECTED OnAfterFieldsEnabled (EventArgs)

Purpose: Raises the AfterFieldsEnabled
Notes:

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

PROTECTED OnAfterSaveChanges (EventArgs)

Purpose: Raises the AfterSaveChanges event
Notes:

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

PROTECTED OnBeforeAddRecord (CancelEventArgs)

Purpose: Raises the BeforeAddRecord event
Notes:

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

PROTECTED OnBeforeCancelUpdate (CancelEventArgs)

Purpose: Raises the BeforeCancelUpdate event
Notes:

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

PROTECTED OnBeforeCopyRecord (CancelEventArgs)

Purpose: Raises the BeforeCopyRecord event
Notes:

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

PROTECTED OnBeforeDeleteRecord (CancelEventArgs)

Purpose: Raises the BeforeDeleteRecord event
Notes:

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

PROTECTED OnBeforeEnableFields (CancelableEventArgs)

Purpose: Raises the BeforeEnableFields
Notes:

Parameters:
e Consultingwerk.CancelableEventArgs
The CancelableEventArgs with the data for the event
Top

PROTECTED OnBeforeSaveChanges (CancelEventArgs)

Purpose: Raises the BeforeSaveChanges event
Notes:

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

PROTECTED OnCopyingRecordChanged (EventArgs)

Purpose: Raises the CopyingRecordChanged
Notes:

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

PROTECTED OnEnter (EventArgs)

Purpose: Raises the Enter event
Notes:

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

PROTECTED OnFieldsDisabled (EventArgs)

Purpose: Raises the FieldsDisabled event.
Notes:

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

PROTECTED OnFieldsEnabled (EventArgs)

Purpose: Raises the FieldsEnabled event.
Notes:

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

PROTECTED OnFocusControlOnAddChanged (EventArgs)

Purpose: Raises the FocusControlOnAddChanged event
Notes:

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

PROTECTED OnFocusControlOnUpdateChanged (EventArgs)

Purpose: Raises the FocusControlOnUpdateChanged event
Notes:

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

PROTECTED OnLoad (EventArgs)

Overrides Consultingwerk.SmartComponents.Base.SmartUserControl:OnLoad (EventArgs)
Purpose: Raises the Load event
Notes: Initializes the ViewerLogic class if property is set

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

PROTECTED OnSmartDataSourceChanged (EventArgs)

Purpose: Publishes the SmartGroupAssignSourceChanged event
Notes:

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

PROTECTED OnSmartGroupAssignSourceChanged (EventArgs)

Purpose: Publishes the SmartGroupAssignSourceChanged event
Notes:

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

PROTECTED OnSmartTableIOSourceChanged (EventArgs)

Purpose: Publishes the SmartGroupAssignSourceChanged event
Notes:

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

PROTECTED OnSmartTableIOStateChanged (SmartTableIOStateChangedEventArgs)

Purpose: Publishes the SmartTableIOStateChanged event
Notes:

Parameters:
e Consultingwerk.SmartComponents.Base.SmartTableIOStateChangedEventArgs
The System.EventArgs with the data for this event
Top

PUBLIC OnVerbClicked (character)

Inherited from Consultingwerk.SmartComponents.Base.SmartUserControl
Purpose: Event Handler method for Designer Verbs
Notes: This method is intended to be overridden

Parameters:
pcDesignerVerb CHARACTER
The name (Label) of the Designer Verb that was invoked
Top

PROTECTED OnVisualValidating (EventArgs)

Purpose: Raises the VisualValidating event
Notes:

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

PRIVATE ParentChangedHandler (Object, EventArgs)

Purpose: Event handler to the ParentChanged event
Add EventHandlers to Child Controls inside the SmartViewerControl.
This Method is Executed when the SmartViewerControl is added to a Form.
Notes: Executed only one time.

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

PROTECTED ParentFormDestroyedHandler (Object, EventArgs)

Inherited from Consultingwerk.SmartComponents.Base.SmartUserControl
Purpose: Event handler for the FormDestroyed event of the owning Form
Notes:

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

PROTECTED RecurseInitializeControlEventHandler (Control)

Purpose: Subscribe the EventHandler(s) to events of all controls added to
the SmartViewerControl.
This Method is called by the Method InitializeControlEventHandler ()
of the SmartViewerControl.
Notes:

Parameters:
poParentControl System.Windows.Forms.Control
The The Parent Control (THIS-OBJECT), nested Container
Top

PROTECTED System.Windows.Forms.Control RecurseLocateBindingControl (Control, character)

Purpose: Recurses through the Controls in this SmartViewerControl and nested
controls searching for a Control that is bound to the named
BindingProperty (a field attached to the ProBindingSource).
Notes:

Parameters:
poParentControl System.Windows.Forms.Control
The reference to the ParentControl
pcBindingPropertyName CHARACTER
The name of the field in the ProBindingSource
Returns System.Windows.Forms.Control
The reference to the resulting Control
Top

PROTECTED RecurseLocateBindingControls (Control, Control>, character)

Purpose: Recurses through the Controls in this SmartViewerControl and nested
controls searching for all Controls that are bound to the named
BindingProperty (a field attached to the ProBindingSource).
Notes: The controls will be added to the list

Parameters:
poParentControl System.Windows.Forms.Control
The reference to the ParentControl
poList System.Collections.Generic.List
The list to add the control references to
pcBindingPropertyName CHARACTER
The name of the field in the ProBindingSource
Top

PROTECTED RecurseLookupStopTimer (Control)

Purpose: Stops the current timer of all Lookups
Notes: Invoked when a PositionChanged event occurs

Parameters:
poParentControl System.Windows.Forms.Control
The parent Control of the current iteration
Top

PROTECTED RecursePerformLookup (Control)

Purpose: Performs the Lookup operation in all contained SmartLookup Controls
Notes: Called at the begin of a Save operations

Parameters:
poParentControl System.Windows.Forms.Control
The parent Control for the current iteration
Top

PROTECTED RecurseReplaceBindingSource (Control, BindingSource)

Purpose: Internal method to replace the data bindings of all contained
Controls with the actual binding source provided by a SmartDataSource.
Notes: Initially called by the Method AttachBindingSource () of the
SmartViewerControl.
This method also applies field security from the IFieldAuthorizationProvider
implementation. When a Control is hidden, the label is also hidden. The
Label for a Control is located using the GetNextControl method of the
parent control, thus it's required that the label is standing exactly
before the Control in the Tab-Order of the Viewer.

Parameters:
poParentControl System.Windows.Forms.Control
Current Container to perform Action on
poBindingSource Progress.Data.BindingSource
New BindingSource Instance passed to the Class
Top

PROTECTED RecurseRestoreCurrentValues (Control)

Purpose: Recurese Restore the Current Values of the Controls on the Viewer
after a new DataRow is created.
This Method is called by the internal Method RestoreValuesForCopy ().
Parameters:
Notes:

Parameters:
poParentControl System.Windows.Forms.Control
The parent control of the current iteration
Top

PROTECTED RecurseStoreCurrentValues (Control)

Purpose: Recurese Store the Current Values of the Controls on the Viewer
before a new DataRow is created.
This Method is called by the internal Method StoreValuesForCopy ().
Notes:

Parameters:
poParentControl System.Windows.Forms.Control
The parent Control of the current iteration
Top

PUBLIC RegisterSmartGroupAssignTarget (ISmartGroupAssignTarget)

Purpose: Register a SmartDataTarget with the SmartGroupAssignTarget
This Method is executed every time a new SmartGroupAssignSource is
registered to the corresponding Property of a Class implementing the
Interface ISmartGroupAssignSource.
Enforced by Interface ISmartGroupAssignSource.
Notes:

Parameters:
poSmartGroupAssignTarget Consultingwerk.SmartComponents.Interfaces.ISmartGroupAssignTarget
The SmartGroupAssignTarget to register with this SmartViewerControl instance
Top

PROTECTED RemoveControlEnabled (Control)

Purpose: Removes a Control from the list of Controls that will be enabled
and disabled by the Viewer based on the current Viewer state

Parameters:
poControl System.Windows.Forms.Control
The Control which shall be removed from the list of managed Controls
Top

PROTECTED RemoveControlEnabled (Control, Control)

Purpose: Removes multiple Controls from the list of Controls that will be enabled
and disabled by the Viewer based on the current Viewer state

Parameters:
poControl1 System.Windows.Forms.Control
The first Control which shall be removed from the list of managed Controls
poControl2 System.Windows.Forms.Control
The second Control which shall be removed from the list of managed Controls
Top

PROTECTED RemoveControlEnabled (Control, Control, Control)

Purpose: Removes multiple Controls from the list of Controls that will be enabled
and disabled by the Viewer based on the current Viewer state

Parameters:
poControl1 System.Windows.Forms.Control
The first Control which shall be removed from the list of managed Controls
poControl2 System.Windows.Forms.Control
The second Control which shall be removed from the list of managed Controls
poControl3 System.Windows.Forms.Control
The third Control which shall be removed from the list of managed Controls
Top

PROTECTED RemoveControlEnabled (Control, Control, Control, Control)

Purpose: Removes multiple Controls from the list of Controls that will be enabled
and disabled by the Viewer based on the current Viewer state

Parameters:
poControl1 System.Windows.Forms.Control
The first Control which shall be removed from the list of managed Controls
poControl2 System.Windows.Forms.Control
The second Control which shall be removed from the list of managed Controls
poControl3 System.Windows.Forms.Control
The third Control which shall be removed from the list of managed Controls
poControl4 System.Windows.Forms.Control
The fourth Control which shall be removed from the list of managed Controls
Top

PROTECTED RemoveControlEnabled (Control, Control, Control, Control, Control)

Purpose: Removes multiple Controls from the list of Controls that will be enabled
and disabled by the Viewer based on the current Viewer state

Parameters:
poControl1 System.Windows.Forms.Control
The first Control which shall be removed from the list of managed Controls
poControl2 System.Windows.Forms.Control
The second Control which shall be removed from the list of managed Controls
poControl3 System.Windows.Forms.Control
The third Control which shall be removed from the list of managed Controls
poControl4 System.Windows.Forms.Control
The fourth Control which shall be removed from the list of managed Controls
poControl5 System.Windows.Forms.Control
The fifth Control which shall be removed from the list of managed Controls
Top

PUBLIC RemoveSmartTableIOSource (ISmartTableIOSource)

Purpose: Removes a SmartTableIOSource from the SmartDataAdapter
instance
Notes: Enables multiple SmartTableIOSource to the SmartDataAdapter.

Parameters:
poSmartTableIOSource Consultingwerk.SmartComponents.Interfaces.ISmartTableIOSource
The SmartTableIOSource to remove from the Viewer
Top

PUBLIC RestoreValuesForCopy ()

Purpose: Restore the Current Values of all Controls on a SmartViewerControl
and in all SmartGroupAssignTargets.
This Method is called by CreateRecord from the current Class.
Enforced by Interface ISmartGroupAssignTarget.
Notes:

Top

PUBLIC SaveChanges ()

Purpose: Saves the current changes to the database.
Notes: This Method is called by the Toolbar Classes SmartToolbarController
or SmartToolStripContainer by pressing the corresponding Tool.
Enforced by Interface ISmartDataTarget or ISmartGroupAssignTarget.

Top

PUBLIC LOGICAL SaveChangesOnDeactivateForm (logical)

Purpose: Saves pending changes when a Form is deactivated
Notes:

Parameters:
plShowMessage LOGICAL
When TRUE a message is asking the user if values should be saved. When FALSE values will be saved silently
Returns LOGICAL
True when the user did choose not to save or the save was successful, False when the control remains in Update state
Top

PUBLIC SetControlEnabled (Control, character)

Purpose: Sets the Enable Mode for a given Control inside the SmartViewerControl.
Called by the Method InitializeControlEventHandler () of a
SmartViewerControl derived Class.
Notes: Possible Values for pcEnabled (ControlEnabledEnum):
Add, Always, Never, Update, UpdateOnly

Parameters:
poControl System.Windows.Forms.Control
The Control which shall be set to the passed in Mode
pcEnabled CHARACTER
Mode to be set as defined in ControlEnabledEnum
Top

PUBLIC SetControlEnabled (Control, Control, character)

Purpose: Sets the Enable Mode for two given Controls inside the SmartViewerControl.
Called by the Method InitializeControlEventHandler () of a
SmartViewerControl derived Class.
Notes: Possible Values for pcEnabled (ControlEnabledEnum):
Add, Always, Never, Update, UpdateOnly

Parameters:
poControl1 System.Windows.Forms.Control
The first Control which shall be set to the passed in Mode
poControl2 System.Windows.Forms.Control
The second Control which shall be set to the passed in Mode
pcEnabled CHARACTER
Mode to be set as defined in ControlEnabledEnum
Top

PUBLIC SetControlEnabled (Control, Control, Control, character)

Purpose: Sets the Enable Mode for three given Controls inside the SmartViewerControl.
Called by the Method InitializeControlEventHandler () of a
SmartViewerControl derived Class.
Notes: Possible Values for pcEnabled (ControlEnabledEnum):
Add, Always, Never, Update, UpdateOnly

Parameters:
poControl1 System.Windows.Forms.Control
The first Control which shall be set to the passed in Mode
poControl2 System.Windows.Forms.Control
The second Control which shall be set to the passed in Mode
poControl3 System.Windows.Forms.Control
The third Control which shall be set to the passed in Mode
pcEnabled CHARACTER
Mode to be set as defined in ControlEnabledEnum
Top

PUBLIC SetControlEnabled (Control, Control, Control, Control, character)

Purpose: Sets the Enable Mode for four given Controls inside the SmartViewerControl.
Called by the Method InitializeControlEventHandler () of a
SmartViewerControl derived Class.
Notes: Possible Values for pcEnabled (ControlEnabledEnum):
Add, Always, Never, Update, UpdateOnly

Parameters:
poControl1 System.Windows.Forms.Control
The first Control which shall be set to the passed in Mode
poControl2 System.Windows.Forms.Control
The second Control which shall be set to the passed in Mode
poControl3 System.Windows.Forms.Control
The third Control which shall be set to the passed in Mode
poControl4 System.Windows.Forms.Control
The forth Control which shall be set to the passed in Mode
pcEnabled CHARACTER
Mode to be set as defined in ControlEnabledEnum
Top

PUBLIC SetControlEnabled (Control, Control, Control, Control, Control, character)

Purpose: Sets the Enable Mode for five given Controls inside the SmartViewerControl.
Called by the Method InitializeControlEventHandler () of a
SmartViewerControl derived Class.
Notes: Possible Values for pcEnabled (ControlEnabledEnum):
Add, Always, Never, Update, UpdateOnly

Parameters:
poControl1 System.Windows.Forms.Control
The first Control which shall be set to the passed in Mode
poControl2 System.Windows.Forms.Control
The second Control which shall be set to the passed in Mode
poControl3 System.Windows.Forms.Control
The third Control which shall be set to the passed in Mode
poControl4 System.Windows.Forms.Control
The forth Control which shall be set to the passed in Mode
poControl5 System.Windows.Forms.Control
The fifth Control which shall be set to the passed in Mode
pcEnabled CHARACTER
Mode to be set as defined in ControlEnabledEnum
Top

PRIVATE SetControlSecurityEnabled (Control, character)

Purpose: Sets the Enable Mode based on Security Constraints for a given Control
Notes: Possible Values for pcEnabled (ControlEnabledEnum):
Add, Always, Never, Update, UpdateOnly

Parameters:
poControl System.Windows.Forms.Control
The Control which shall be set to the passed in Mode
pcEnabled CHARACTER
Mode to be set as defined in ControlEnabledEnum
Top

PUBLIC SetModifyingState ()

Purpose: Sets the TableIOState to ModifyingData
Notes: Useful when modifying Viewer values through custom event handlers

Top

PUBLIC SetOpenedEditorDropDownControl (Control)

Purpose: Set's the current opened EditorDropDownControl
Notes: See Bug 1878 for details

Parameters:
poControl System.Windows.Forms.Control
The reference to the Control that currently has the list dropped down
Top

PUBLIC StoreValuesForCopy ()

Purpose: Store the Current Values of all Controls on a SmartViewerControl
and do the same in all SmartGroupAssignTargets.
This Method is called by CreateRecord from the current Class.
Enforced by Interface ISmartGroupAssignTarget.
Notes:

Top

PUBLIC TextChangedEventHandler (Object, EventArgs)

Purpose: Event handler for the TextChangedEvent event of Editor Controls on
the SmartViewerControl.
Initiate switching to the ModifyinData Mode if the user enters data.
Notes: This Method is executed every time data changes in the EditorControls
of a SmartViewerControl.
Enforced by Interface ISmartGroupAssignSource.

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

PUBLIC VisualValidate ()

Purpose: Validate data entered into the DataFields
Notes: This is a placeholder that can be overridden in a viewer control
inheriting from SmartViewerControl
Due to limitations with the .NET Visual Designer environment, this
method cannot be market ABSTRACT



Constructor Detail
Top

PUBLIC SmartViewerControl ()

Purpose: The Constructor initializes a new SmartViewerControl
Subscribes handlers for events
Notes:



Event Detail
Top

PUBLIC AddedRecordModifiedChanged DELEGATE System.EventHandler

Purpose: Raised when the value of the AddedRecordModified property changes
Notes:

Delegate: System.EventHandler
Top

PUBLIC AddingRecordChanged DELEGATE System.EventHandler

Purpose: Event fired when the AddingRecord Property is changed
Notes:

Delegate: System.EventHandler
Top

PUBLIC AfterAddRecord DELEGATE System.EventHandler

Purpose: Event fired when the viewer has successfully started an Add
operation
Notes: This event is defined using a .NET delegate, so it will show in
the PropertyGrid of the VisualDesigner

Delegate: System.EventHandler
Top

PUBLIC AfterCancelUpdate DELEGATE System.EventHandler

Purpose: Event fired when the viewer has successfully cancelled an update
Notes: This event is defined using a .NET delegate, so it will show in
the PropertyGrid of the VisualDesigner

Delegate: System.EventHandler
Top

PUBLIC AfterCopyRecord DELEGATE System.EventHandler

Purpose: Event fired when the viewer has successfully started a Copy operation
Notes: This event is defined using a .NET delegate, so it will show in
the PropertyGrid of the VisualDesigner

Delegate: System.EventHandler
Top

PUBLIC AfterDeleteRecord DELEGATE System.EventHandler

Purpose: Event fired when the viewer has successfully deleted a record.
Notes: This event is defined using a .NET delegate, so it will show in
the PropertyGrid of the VisualDesigner

Delegate: System.EventHandler
Top

PUBLIC AfterFieldsEnabled DELEGATE System.EventHandler

Purpose: Raised after the fields have been enabled
Notes:

Delegate: System.EventHandler
Top

PUBLIC AfterSaveChanges DELEGATE System.EventHandler

Purpose: Event fired when the viewer has successfully saved changes
Notes: This event is defined using a .NET delegate, so it will show in
the PropertyGrid of the VisualDesigner

Delegate: System.EventHandler
Top

PUBLIC BeforeAddRecord DELEGATE System.ComponentModel.CancelEventHandler

Purpose: Event fired when the Viewer starts adding a new record.
This event is cancelable
Notes: This event is defined using a .NET delegate, so it will show in
the PropertyGrid of the VisualDesigner

Delegate: System.ComponentModel.CancelEventHandler
Top

PUBLIC BeforeCancelUpdate DELEGATE System.ComponentModel.CancelEventHandler

Purpose: Event fired when the Viewer begins cancelling an update.
This event is cancellable
Notes: This event is defined using a .NET delegate, so it will show in
the PropertyGrid of the VisualDesigner

Delegate: System.ComponentModel.CancelEventHandler
Top

PUBLIC BeforeCopyRecord DELEGATE System.ComponentModel.CancelEventHandler

Purpose: Event fired when the Viewer begins copying a record.
This event is cancellable
Notes: This event is defined using a .NET delegate, so it will show in
the PropertyGrid of the VisualDesigner

Delegate: System.ComponentModel.CancelEventHandler
Top

PUBLIC BeforeDeleteRecord DELEGATE System.ComponentModel.CancelEventHandler

Purpose: Event fired when the Viewer starts deleting a record.
This event is cancellable
Notes: This event is defined using a .NET delegate, so it will show in
the PropertyGrid of the VisualDesigner

Delegate: System.ComponentModel.CancelEventHandler
Top

PUBLIC BeforeEnableFields (Object, CancelableEventArgs)

Purpose: Raised before the fields are enabled
Notes:

Parameters:
sender Progress.Lang.Object
The object that raised the BeforeEnableFields event
e Consultingwerk.CancelableEventArgs
The CancelableEventArgs with the data for the event
Top

PUBLIC BeforeSaveChanges DELEGATE System.ComponentModel.CancelEventHandler

Purpose: Event fired when the Viewer starts saving a record.
This event is cancellable
Notes: This event is defined using a .NET delegate, so it will show in
the PropertyGrid of the VisualDesigner

Delegate: System.ComponentModel.CancelEventHandler
Top

PUBLIC CopyingRecordChanged DELEGATE System.EventHandler

Purpose: Raised when the CopyingRecord property has changed
Notes:

Delegate: System.EventHandler
Top

PUBLIC FieldsDisabled DELEGATE System.EventHandler

Purpose: Event fired when the fields of this viewer become disabled
Notes: This event is defined using a .NET delegate, so it will show in
the PropertyGrid of the VisualDesigner

Delegate: System.EventHandler
Top

PUBLIC FieldsEnabled DELEGATE System.EventHandler

Purpose: Event fired when the fields of this viewer become enabled
Notes: This event is defined using a .NET delegate, so it will show in
the PropertyGrid of the VisualDesigner

Delegate: System.EventHandler
Top

PUBLIC FocusControlOnAddChanged DELEGATE System.EventHandler

Purpose: Event fired when the FocusControlOnAdd property changes
Notes:

Delegate: System.EventHandler
Top

PUBLIC FocusControlOnUpdateChanged DELEGATE System.EventHandler

Purpose: Event fired when the FocusControlOnUpdate property changes
Notes:

Delegate: System.EventHandler
Top

PUBLIC SmartDataSourceChanged DELEGATE System.EventHandler

Purpose: Event fired when the SmartDataSource Property is changed
Notes:

Delegate: System.EventHandler
Top

PUBLIC SmartGroupAssignSourceChanged DELEGATE System.EventHandler

Purpose: Event fired when the SmartGroupAssignSource Property is changed
Notes:

Delegate: System.EventHandler
Top

PUBLIC SmartTableIOSourceChanged DELEGATE System.EventHandler

Purpose: Event fired when the SmartTableIOSource Property is changed
Notes:

Delegate: System.EventHandler
Top

PUBLIC SmartTableIOStateChanged (Object, SmartTableIOStateChangedEventArgs)

Purpose: Event fired whenever the SmartTableIOState property has changed
Notes:

Parameters:
sender System.Object
The object that raised the event
e Consultingwerk.SmartComponents.Base.SmartTableIOStateChangedEventArgs
The SmartTableIOStateChangedEventArgs with the data for this event
Top

PUBLIC VisualValidating DELEGATE System.EventHandler

Purpose: Raised when the Viewer performs Visual Validation
Notes: May be used by Subscribers to corrent screen values before validation

Delegate: System.EventHandler


Property Detail
Top

PUBLIC LOGICAL ActivateCurrentGridRowDuringEdit

Purpose: Gets and sets if the current Grid row should be Activated (highlighted)
when starting to update in the Grid
Notes:

Returns LOGICAL
Top

PUBLIC LOGICAL AddedRecordModified

Purpose: Returns if a record being added was already modified by the user
Notes:

Returns LOGICAL
Top

PUBLIC LOGICAL AddingRecord

Purpose: Flag that indicates if we are currently in Add Mode.
When CreateRecord () is called the value of the Property changes to
TRUE. CancelUpdate ()or during initialization the call of
EvaluateTableIOState () resets the value of the Property to FALSE.
Notes: To Differenciate from Modifying data

Returns LOGICAL
Top

PUBLIC LOGICAL AllowCloseOfUnmodifiedNewRecord

Purpose: Controls if a Form containing this SmartViewerControl instance can
be closed without a prompt to the user when a record has just been
created but the user has not yet changed a single field
Notes:

Returns LOGICAL
Top

PUBLIC LOGICAL CancellingUpdate

Purpose: Returns if the Viewer is currently cancelling the update
Notes: Useful in Leave event handlers of the fields contained in the
SmartViewerControl

Returns LOGICAL
Top

PUBLIC LOGICAL CopyingRecord

Purpose: Returns if the Viewer is currently copying a record
Notes: Only true when AddingRecord is also true

Returns LOGICAL
Top

PROTECTED CHARACTER DesignerVerbs

Inherited from Consultingwerk.SmartComponents.Base.SmartUserControl
Purpose: Property that is used to generate Designer Verbs (actions for the
Visual Designer)
Notes:

Returns CHARACTER
Top

PUBLIC LOGICAL DesignTime

Inherited from Consultingwerk.SmartComponents.Base.SmartUserControl
Purpose: Propery flags if the current instance of the SmartBindingSource
is running at design time or runtime.
Notes: Set during constructor using a check at the
System.ComponentModel.LicenseManager

Returns LOGICAL
Top

PUBLIC LOGICAL EventHandlerActive

Purpose: Returns if the EventHandlers that would enter Edit mode (TextChanged,
CheckChanged) are activated or not
Notes:

Returns LOGICAL
Top

PUBLIC System.Windows.Forms.Control FocusControlOnAdd

Purpose: Get/Set the Control that will automatically become focussed on Add
or Copy
Notes: This property is filled automatically during initialization

Returns System.Windows.Forms.Control
Top

PUBLIC System.Windows.Forms.Control FocusControlOnUpdate

Purpose: Get/Set the Control that will automatically become focussed on Update
Notes: This property is filled automatically during initialization

Returns System.Windows.Forms.Control
Top

PROTECTED CHARACTER HiddenProperties

Inherited from Consultingwerk.SmartComponents.Base.SmartUserControl
Purpose: Property that is used to mark properties (comma-delimited list) that
will be excluded from the .NET TypeDescriptor properties list
Notes:

Returns CHARACTER
Top

PUBLIC LOGICAL Initializing

Purpose: Indicated that the SmartViewerControl is currrently being
Initialized
Notes:

Returns LOGICAL
Top

PUBLIC Consultingwerk.SmartComponents.Interfaces.Design.IDesignDataSource LinkDataSource

Purpose: Represents the SmartDataSource property casted to a .NET Interface
Notes: Implementation of Interface in Consultingwerk.SmartComponents.dll
SCL-725 - code moved from LinkDataSource.i directly into class file

Returns Consultingwerk.SmartComponents.Interfaces.Design.IDesignDataSource
Top

PUBLIC Consultingwerk.SmartComponents.Interfaces.Design.IDesignGroupAssignSource LinkGroupAssignSource

Purpose: Represents the SmartGroupAssignSource property casted to a .NET Interface
Notes: Implementation of Interface in Consultingwerk.SmartComponents.dll
SCL-725 - code moved from LinkGroupAssignSource.i directly into class file

Returns Consultingwerk.SmartComponents.Interfaces.Design.IDesignGroupAssignSource
Top

PUBLIC Consultingwerk.SmartComponents.Interfaces.Design.IDesignTableIOSource LinkTableIOSource

Purpose: Represents the SmartTableIOSource property casted to a .NET Interface
Notes: Implementation of Interface in Consultingwerk.SmartComponents.dll
SCL-725 - code moved from LinkTableIOSource.i directly into class file

Returns Consultingwerk.SmartComponents.Interfaces.Design.IDesignTableIOSource
Top

PROTECTED CHARACTER NonBrowsableProperties

Inherited from Consultingwerk.SmartComponents.Base.SmartUserControl
Purpose: Property that is used to mark properties (comma-delimited list) that
should not show up in the Visual Designers Property Grid
Notes:

Returns CHARACTER
Top

PROTECTED Consultingwerk.SmartComponents.Base.SmartViewerOptionalFeatures OptionalFeatures

Purpose: Reference to the SmartViewerOptionalFeaturesInstance that allows
to toggle on or off optional features of the SmartViewerControl
Notes:

Returns Consultingwerk.SmartComponents.Base.SmartViewerOptionalFeatures
Top

PROTECTED LOGICAL ParentFormDestroyedSubscribed

Inherited from Consultingwerk.SmartComponents.Base.SmartUserControl
Purpose: Returns if the FormDestroyed evengt of the containing Form has been
subscribed
Notes:

Returns LOGICAL
Top

PUBLIC LOGICAL ReadOnlyDisabled

Purpose: Gets and sets if Infragistics Text Editor Controls should be set
ReadOnly instead of Enabled = FALSE when update is not active
Notes: Effective for Controls inheriting from Infragistics.Win.UltraWinEditors.UltraWinEditorMaskedControlBase
and Infragistics.Win.UltraWinEditors.TextEditorControlBase

Returns LOGICAL
Top

PUBLIC LOGICAL SaveMode

Purpose: Controls if the Viewer's field remain Enabled after Save or Cancel
Notes: When the user is using the SaveMode the fields are basically always
enabled as long as there is a record available. As soon as the user
starts entering values in the fields of the viewer, the update
operation is starting, resulting in a change of enabled buttons in the
viewer and the disablement of linked grids.

Returns LOGICAL
Top

PUBLIC LOGICAL SavingChanges

Purpose: Returns if the Viewer is currently saving the changes
Notes: Useful in Leave event handlers of the fields contained in the
SmartViewerControl

Returns LOGICAL
Top

PUBLIC CHARACTER SecurityKey

Purpose: Gets and sets the Toolbar Security Key
Notes:

Returns CHARACTER
Top

PUBLIC Consultingwerk.SmartComponents.Interfaces.ISmartDataSource SmartDataSource

Purpose: Get/Set the SmartDataSource of the current Class. The SmartDataSource
can be set to any class implementing the Interface ISmartDataSource.
This Property is set by the developer when initializing a Control
implementing the Interface ISmartDataTarget.
Enforced by Interface ISmartDataTarget.
Notes: If a new SmartDataSource is set the DataBinding of all fields is updated.

Returns Consultingwerk.SmartComponents.Interfaces.ISmartDataSource
Top

PUBLIC Consultingwerk.SmartComponents.Interfaces.ISmartGroupAssignSource SmartGroupAssignSource

Purpose: Property to register a SmartGroupAssignSource for the SmartViewerControl
a backward handshake to the Source is done.
A SmartGroupAssignSource can be every class implementing the Interface
ISmartGroupAssignSource.
This Property is set programatically by the developer.
Notes:

Returns Consultingwerk.SmartComponents.Interfaces.ISmartGroupAssignSource
Top

PUBLIC Consultingwerk.SmartComponents.Base.ListISmartGroupAssignTarget SmartGroupAssignTargets

Purpose: Returns the list of SmartGroupAssignTargets as a generic list
Notes:

Returns Consultingwerk.SmartComponents.Base.ListISmartGroupAssignTarget
Top

PUBLIC Consultingwerk.SmartComponents.Interfaces.ISmartTableIOSource SmartTableIOSource

Purpose: Get and Set the current SmartTableIOSource of the SmartViewerControl.
This Property is set by the developer when initializing a Control
implementing the Interface ISmartDataTarget.
Enforced by Interface ISmartDataTarget.
Notes: Cannot be changed while the SmartViewerControl is in ModifyingData mode.

Returns Consultingwerk.SmartComponents.Interfaces.ISmartTableIOSource
Top

PUBLIC CHARACTER SmartTableIOState

Purpose: The SmartTableIOState property reflects the operationmode of the
SmartViewerControl.
Value changes of this Property are only made in the Class
SmartViewerControl.
Enforced by Interface ISmartDataTarget or ISmartGroupAssignTarget.
Notes: Possible values (TableIOStateEnum):
- AddCopyAllowed
- FieldsDisabled
- FieldsEnabled
- ModifyingData
- NoDataSource
- NoParentRecordAvailable

Returns CHARACTER
Top

PROTECTED LOGICAL TextChangedHandlerSuspended

Purpose: Gets and sets if text TextChangedHandler is (temporarily) suspended
Notes: The TextChangedHandler controls setting the SmartTableIOState of the
SmartViewerControl to modifying data. There may be situations in
custom control developement where this might need to be turned off
temporarily. Setting this flag to TRUE is less work, than calling
the DeactivateEventHandler and ActivateEventHandler

Returns LOGICAL
Top

PUBLIC Consultingwerk.SmartComponents.Enum.UpdateStateEnum UpdateState

Purpose: Returns the Update State of the Viewer
Notes: Possible values are Add, Copy, Update or View

Returns Consultingwerk.SmartComponents.Enum.UpdateStateEnum
Top

PUBLIC CHARACTER ViewerLogicClass

Purpose: Gets and sets the class name of the ViewerLogic class
Notes: This property should only be set for independent SmartViewerControl
instances of the source of a group assign link. The value of the
property will be ignored for group assign targets
The class named here, needs to implement the
Consultingwerk.SmartComponents.Implementation.ISmartViewerLogic
interface

Returns CHARACTER
Top

PUBLIC Consultingwerk.SmartComponents.Interfaces.ISmartViewerLogic ViewerLogicObject

Purpose: Returns the reference to the ISmartViewerLogic instance that provides
logic for this instance
Notes:

Returns Consultingwerk.SmartComponents.Interfaces.ISmartViewerLogic


©2006-2016 Consultingwerk Ltd.         info@consultingwerk.de         http://www.consultingwerk.de       26.08.2016 08:31:20