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.IDesignToolbarTarget, Consultingwerk.SmartComponents.Interfaces.Design.IDesignViewerControl, Consultingwerk.SmartComponents.Interfaces.ISmartViewerControl, Consultingwerk.SmartComponents.Base.IAlwaysEnabledControl, Consultingwerk.SmartComponents.Interfaces.ICheckOkToClose, Consultingwerk.SmartComponents.Interfaces.IHandlesServerEvents, IHasDesignerVerbs, Consultingwerk.SmartComponents.Interfaces.ISaveChangesOnDeactivateForm, Consultingwerk.SmartComponents.Interfaces.ISmartDataTarget, Consultingwerk.SmartComponents.Interfaces.ISmartGroupAssignSource, Consultingwerk.SmartComponents.Interfaces.ISmartGroupAssignTarget, Consultingwerk.SmartComponents.Interfaces.ISmartTableIOTarget, Consultingwerk.SmartComponents.Interfaces.ISmartToolbarTarget, System.ComponentModel.ISupportInitialize
Inherited by: Consultingwerk.Windows.Framework.Repository.Object.SmartLinkViewerControl Consultingwerk.Windows.Framework.Repository.Object.SmartObjectInstanceViewerControl Consultingwerk.Windows.Framework.Repository.Object.SmartObjectMasterViewerControl Consultingwerk.Windows.Framework.Repository.Object.SmartPageViewerControl Consultingwerk.Windows.Framework.Repository.Rendering.Viewer.LazyLoadingViewerControl Consultingwerk.Windows.Framework.Repository.ScreenMapping.SmartEntityTableMappingViewerControl Consultingwerk.Windows.Framework.Repository.ScreenMapping.SmartScreenTypeViewerControl Consultingwerk.Windows.Framework.Repository.ScreenMapping.SmartUiTypeViewerControl Consultingwerk.Windows.Framework.Scheduler.SmartSchedulerJobPlanViewerControl Consultingwerk.Windows.Framework.Scheduler.SmartSchedulerJobStatusViewerControl Consultingwerk.Windows.Framework.Scheduler.SmartSchedulerJobViewerControl 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.SmartModifiedStateViewerControl 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 Consultingwerk.Windows.Framework.Web.SmartRouteViewerControl Consultingwerk.Windows.Framework.Workflow.SmartWorkflowActivityViewerControl Consultingwerk.Windows.Framework.Workflow.SmartWorkflowStatusActivityViewerControl Consultingwerk.Windows.Framework.Workflow.SmartWorkflowStatusViewerControl Consultingwerk.Windows.Framework.Workflow.SmartWorkflowSwimlaneViewerControl Consultingwerk.Windows.Framework.Workflow.SmartWorkflowViewerControl Consultingwerk.SmartComponents.Implementation.SmartDynamicViewer Consultingwerk.Windows.Framework.Authentication.SmartUserViewer Consultingwerk.Windows.Framework.Authorization.SmartFieldSecurityItemViewerControl Consultingwerk.Windows.Framework.Authorization.SmartGroupViewer Consultingwerk.Windows.Framework.Authorization.SmartSecurityAssignmentViewerControl Consultingwerk.Windows.Framework.Authorization.SmartSecurityObjectTokenViewerControl Consultingwerk.Windows.Framework.Authorization.SmartSecurityObjectViewerControl Consultingwerk.Windows.Framework.Authorization.SmartSecurityRealmViewerControl Consultingwerk.Windows.Framework.Authorization.SmartSecurityTokenViewerControl Consultingwerk.Windows.Framework.Authorization.SmartToolbarSecurityItemViewerControl Consultingwerk.Windows.Framework.Authorization.UserReportHeaderViewer 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.Repository.Field.SmartEntityFieldMappingViewerControl Consultingwerk.BusinessEntityDesigner.Plugins.BusinessEntityRelations.RelationDesignerViewer Consultingwerk.BusinessEntityDesigner.UI.BusinessEntityViewerControl Consultingwerk.BusinessEntityDesigner.UI.DataRelationViewerControl Consultingwerk.BusinessEntityDesigner.UI.FieldViewerControl Consultingwerk.BusinessEntityDesigner.UI.IndexViewerControl Consultingwerk.BusinessEntityDesigner.UI.MemberTableViewerControl




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
BeginUpdateStateHandler (Object, DataSourceUpdateStateEventArgs) Event handler for the BeginUpdateState event of the data source
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.
CleanupLookupControls () Destroys the Controls in the Viewer Control
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.
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
EnableFields (character, logical) Enables controls of the SmartViewerControl
EndInit () Invoked at the end of a Containers InitializeComponents method
EndUpdateStateHandler (Object, DataSourceUpdateStateEventArgs) Event handler for the EndUpdateState event of the data source
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
Progress.Data.BindingSource FindDesignTimeBindingSource () Attempts to locate the BindingSource that was used in a SmartViewerControl at Design Time
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.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 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 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 */
HANDLE GetScreenValuesDataset () Returns a ProDataset with the current screen values
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 Group assign Source
HandleServerEvent (EventHandlerParameter, character, character, Object, Object) Handles server side events
HandleServerEvent (Object, Object, character, character) Event handler for a server-side event
HandleServerEvent (Object, EventArgs, character) Event handler for a server-side event
HandleUiControl (UiControl, handle, Object) Returns a ProDataset with the current screen values
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
InitializeViewerUiControlHandler () Initializes the SmartViewerUiControlHandler class
LOGICAL IsControlEnabled (character, character, logical) Determines if a Control should be enabled 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 value
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
OnAfterCancelledUpdate (AfterCancelledUpdateEventArgs) Raises the AfterCancelledUpdate 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 event
OnCurrentChanged (EventArgs) Raises the CurrentChanged event
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
OnGenericEvent (EventArgs) Raises the GenericEvent
OnInitializingChanged (EventArgs) Raises the InitializingChanged event
OnLoad (EventArgs) Raises the Load event
OnSmartDataSourceChanged (EventArgs) Publishes the SmartDataSourceChanged event
OnSmartGroupAssignSourceChanged (EventArgs) Publishes the SmartGroupAssignSourceChanged event
OnSmartTableIOSourceChanged (EventArgs) Publishes the SmartGroupAssignSourceChanged event
OnSmartTableIOStateChanged (SmartTableIOStateChangedEventArgs) Publishes the SmartTableIOStateChanged event
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.
ProcessHiddenControls () Processes the registered hidden controls
RaiseGenericEvent (EventArgs) Raises the Generic Event
LOGICAL RaiseToolbarAction (Object, ToolClickEventArgs, character) Executes a Toolbar Action
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) Recurse 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) Recurse 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 ().
RegisterHiddenControl (Control) Register a hidden control
RegisterServerSideEventHandler (Control, character, character) Subscribes a Control to a server-side event handler
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
ResetViewerState (logical) Resets the state of the Viewer
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
ServerSideAfterFieldsEnabledHandler (Object, EventArgs) Event handler for AfterFieldsEnabled event
ServerSideAfterPerformLookupHandler (Object, EventArgs) Event handler for AfterPerformLookup event
ServerSideBeforeEnableFieldsHandler (Object, CancelableEventArgs) Event handler for CurrentChanged event
ServerSideClickHandler (Object, EventArgs) Event handler for Click event
ServerSideCurrentChangedHandler (Object, EventArgs) Event handler for CurrentChanged event
ServerSideEditorButtonClickHandler (Object, EditorButtonEventArgs) Event handler for EditorButtonClick event
ServerSideLeaveHandler (Object, EventArgs) Event handler for Leave event
ServerSideLoadHandler (Object, EventArgs) Event handler for Load event
ServerSideLookupCompleteHandler (Object, EventArgs) Event handler for LookupComplete event
ServerSideLookupKeyValueChangedHandler (Object, EventArgs) Event handler for LookupKeyValueChanged event
ServerSideValidatingHandler (Object, EventArgs) Event handler for Validating event
ServerSideValueChangedHandler (Object, EventArgs) Event handler for ValueChanged event
SetControlEnabled (character, character) Sets the Enable Mode for the given Controls inside the SmartViewerControl
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.
SetControlEnabled (Control[], character) Sets the Enable Mode for the given Controls inside the SmartViewerControl
SetControlEnabledFromDescriptor () Sets the ControlEnabled property of the visual controls based on the Business Entity Descriptor
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.
SubscribeControlEventHandler (Control, character, character) Subscribes a Control to an Event Handler in the Viewer Logic Class
TextChangedEventHandler (Object, EventArgs) Event handler for the TextChangedEvent event of Editor Controls on the SmartViewerControl. Initiate switching to the ModifyingData Mode if the user enters data.
ViewerDataSourceCurrentChangedHandler (Object, EventArgs) Event handler for the CurrentChanged event of the data source this Viewer is attached to
VisualValidate () Validate data entered into the DataFields
Consultingwerk.Windows.LegacyGuiMigration.Widgets.IWidgetFacade WidgetHandle (character) Returns the WidgetFacade for the given widget

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
AfterCancelledUpdate (Object, AfterCancelledUpdateEventArgs) Event fired when the viewer has successfully cancelled an update
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
CurrentChanged DELEGATE System.EventHandler Event fired when the current record changes
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
GenericEvent (Object, EventArgs) Raised from custom logic
InitializingChanged DELEGATE System.EventHandler Event fired when the Initializing 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
LOGICAL AddedRecordModified
LOGICAL AddingRecord
LOGICAL AllowCloseOfUnmodifiedNewRecord
LOGICAL CancellingUpdate
LOGICAL CopyingRecord
LOGICAL DisallowUpdateDuringAnotherUpdate
LOGICAL DisallowUpdateDuringAnotherUpdateDefault
LOGICAL EventHandlerActive
System.Windows.Forms.Control FocusControlOnAdd
System.Windows.Forms.Control FocusControlOnUpdate
LOGICAL Initializing
Consultingwerk.SmartComponents.Interfaces.Design.IDesignDataSource LinkDataSource
Consultingwerk.SmartComponents.Interfaces.Design.IDesignGroupAssignSource LinkGroupAssignSource
Consultingwerk.SmartComponents.Interfaces.Design.IDesignTableIOSource LinkTableIOSource
Consultingwerk.SmartComponents.Interfaces.Design.IDesignToolbarSource LinkToolbarSource
Consultingwerk.SmartComponents.Base.SmartViewerOptionalFeatures OptionalFeatures
LOGICAL ReadOnlyDisabled
LOGICAL SaveMode
LOGICAL SavingChanges
CHARACTER SecurityKey
Consultingwerk.SmartComponents.Interfaces.ISmartDataSource SmartDataSource
Consultingwerk.SmartComponents.Interfaces.ISmartGroupAssignSource SmartGroupAssignSource
Consultingwerk.SmartComponents.Base.ListISmartGroupAssignTarget SmartGroupAssignTargets
Consultingwerk.SmartComponents.Interfaces.ISmartTableIOSource SmartTableIOSource
CHARACTER SmartTableIOState
Consultingwerk.SmartComponents.Interfaces.ISmartToolbarSource SmartToolbarSource
LOGICAL TextChangedHandlerSuspended
Consultingwerk.SmartComponents.Enum.UpdateStateEnum UpdateState
LOGICAL UseBusinessEntityDescriptor
LOGICAL ValidateChildrenOnSaveChanges
CHARACTER ViewerLogicClass
Consultingwerk.SmartComponents.Interfaces.ISmartViewerLogic ViewerLogicObject


Method Detail
Top

ActivateCurrentGridRow ()

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

Top

ActivateEventHandler ()

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

Top

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

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

System.Windows.Forms.Control ApplyFocusToErrorField (character)

Purpose: Set's focus into a field that is related to an error
Notes: Protected method, so behavior 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

System.Windows.Forms.Control ApplyFocusToErrorField (IFieldValidationError)

Purpose: Set's focus into a field that is related to an error
Notes: Protected method, so behavior 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 Control/Field to focus
Returns System.Windows.Forms.Control
The Control that the focus was applied to
Top

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

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

BeginUpdateStateHandler (Object, DataSourceUpdateStateEventArgs)

Purpose: Event handler for the BeginUpdateState event of the data source
Notes:

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

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

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

CleanupLookupControls ()

Purpose: Destroys the Controls in the Viewer Control
Notes:

Top

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
overridable 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

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

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

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

DeactivateEventHandler ()

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

Top

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

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

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

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

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

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

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

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

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

EnableFields (character, logical)

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
plEnsureVisible LOGICAL
Logical value indicating if the Viewer should ensure it's visible
Top

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

EndUpdateStateHandler (Object, DataSourceUpdateStateEventArgs)

Purpose: Event handler for the EndUpdateState event of the data source
Notes:

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

EnsureVisible ()

Purpose: Ensures that this SmartViewerControl is visible
Notes:

Top

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

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

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

Progress.Data.BindingSource FindDesignTimeBindingSource ()

Purpose: Attempts to locate the BindingSource that was used in a SmartViewerControl
at Design Time
Notes: This method may only be called before the SmartViewerControl:SmartDataSource
property has been assigned a value to as the Design Time BindingSource
will be disposed when attaching to the SmartDataSource's BindingSource
at runtime.
This method is helpful when building tools that may be able to query
properties such as the EntityName and EntityTable from the Design Time
BindingSource
Supported from OpenEdge

Returns Progress.Data.BindingSource
The reference to the design time binding source or ?
Top

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

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

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

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

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

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

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

GetBoundControlTable (table)

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

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

CHARACTER GetControlEnabled (Control)

Purpose: Returns the 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 Control Enabled mode
Top

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

HANDLE GetScreenValuesDataset ()

Purpose: Returns a ProDataset with the current screen values
Notes:

Returns HANDLE
The handle of the ProDataset
Top

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

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

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

GroupAssignSmartTableIOStateChangedHandler (Object, SmartTableIOStateChangedEventArgs)

Purpose: Event handler for the SmartTableIOStateChanged event of the
Group assign 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

HandleServerEvent (EventHandlerParameter, character, character, Object, Object)

Purpose: Handles server side events
Notes:

Parameters:
oParameter Consultingwerk.CommonUi.EventHandlerParameter
The EventHandlerParameter instance
pcTaskName CHARACTER
The name of the task
pcMethodName CHARACTER
The name of the method
sender Progress.Lang.Object
The sender of the event
e Progress.Lang.Object
The EventArgs instance (.NET or SmartComponent Library)
Top

HandleServerEvent (Object, Object, character, character)

Purpose: Event handler for a server-side event
Notes:

Parameters:
sender System.Object
The reference to the object that raised the event
e Progress.Lang.Object
The EventArgs with the data for this event
pcEventName CHARACTER
The name of the event
pcEventContext CHARACTER
The context for the event
Top

HandleServerEvent (Object, EventArgs, character)

Purpose: Event handler for a server-side event
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
pcEventName CHARACTER
The name of the event
Top

HandleUiControl (UiControl, handle, Object)

Purpose: Returns a ProDataset with the current screen values
Notes:

Parameters:
poUiControl Consultingwerk.CommonUi.UiControl
The reference to the UiControl instance to process
phDataset HANDLE
The handle of the ProDataset with the screen values
sender Progress.Lang.Object
The sender of the event
Top

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

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

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

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

InitializeViewerUiControlHandler ()

Purpose: Initializes the SmartViewerUiControlHandler class
Notes: The SmartViewerUiControlHandler is initialized when calling into
GetScreenValuesDataset, HandleUiControl and ResetViewerState
This method allows to initialize the instance earlier, especially to
store the EnabledStatus of fields earlier

Top

LOGICAL IsControlEnabled (character, character, logical)

Purpose: Determines if a Control should be enabled 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 enabled or not
Top

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 value indicating if the Control is a known Editor Control
Top

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

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 value
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

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

OnAddedRecordModifiedChanged (EventArgs)

Purpose: Raises the AddedRecordModifiedChanged
Notes:

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

OnAddingRecordChanged (EventArgs)

Purpose: Raises the AddingRecordChanged event
Notes:

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

OnAfterAddRecord (EventArgs)

Purpose: Raises the AfterAddRecord event
Notes:

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

OnAfterCancelledUpdate (AfterCancelledUpdateEventArgs)

Purpose: Raises the AfterCancelledUpdate event
Notes:

Parameters:
e Consultingwerk.SmartComponents.Base.AfterCancelledUpdateEventArgs
The AfterCancelledUpdateEventArgs with the data for this event
Top

OnAfterCancelUpdate (EventArgs)

Purpose: Raises the AfterCancelUpdate event
Notes:

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

OnAfterCopyRecord (EventArgs)

Purpose: Raises the AfterCopyRecord event
Notes:

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

OnAfterDeleteRecord (EventArgs)

Purpose: Raises the AfterDeleteRecord event
Notes:

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

OnAfterFieldsEnabled (EventArgs)

Purpose: Raises the AfterFieldsEnabled
Notes:

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

OnAfterSaveChanges (EventArgs)

Purpose: Raises the AfterSaveChanges event
Notes:

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

OnBeforeAddRecord (CancelEventArgs)

Purpose: Raises the BeforeAddRecord event
Notes:

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

OnBeforeCancelUpdate (CancelEventArgs)

Purpose: Raises the BeforeCancelUpdate event
Notes:

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

OnBeforeCopyRecord (CancelEventArgs)

Purpose: Raises the BeforeCopyRecord event
Notes:

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

OnBeforeDeleteRecord (CancelEventArgs)

Purpose: Raises the BeforeDeleteRecord event
Notes:

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

OnBeforeEnableFields (CancelableEventArgs)

Purpose: Raises the BeforeEnableFields
Notes:

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

OnBeforeSaveChanges (CancelEventArgs)

Purpose: Raises the BeforeSaveChanges event
Notes:

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

OnCopyingRecordChanged (EventArgs)

Purpose: Raises the CopyingRecordChanged event
Notes:

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

OnCurrentChanged (EventArgs)

Purpose: Raises the CurrentChanged event
Notes:

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

OnEnter (EventArgs)

Purpose: Raises the Enter event
Notes:

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

OnFieldsDisabled (EventArgs)

Purpose: Raises the FieldsDisabled event.
Notes:

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

OnFieldsEnabled (EventArgs)

Purpose: Raises the FieldsEnabled event.
Notes:

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

OnFocusControlOnAddChanged (EventArgs)

Purpose: Raises the FocusControlOnAddChanged event
Notes:

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

OnFocusControlOnUpdateChanged (EventArgs)

Purpose: Raises the FocusControlOnUpdateChanged event
Notes:

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

OnGenericEvent (EventArgs)

Purpose: Raises the GenericEvent
Notes:

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

OnInitializingChanged (EventArgs)

Purpose: Raises the InitializingChanged event
Notes:

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

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

OnSmartDataSourceChanged (EventArgs)

Purpose: Publishes the SmartDataSourceChanged event
Notes:

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

OnSmartGroupAssignSourceChanged (EventArgs)

Purpose: Publishes the SmartGroupAssignSourceChanged event
Notes:

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

OnSmartTableIOSourceChanged (EventArgs)

Purpose: Publishes the SmartGroupAssignSourceChanged event
Notes:

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

OnSmartTableIOStateChanged (SmartTableIOStateChangedEventArgs)

Purpose: Publishes the SmartTableIOStateChanged event
Notes:

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

OnVisualValidating (EventArgs)

Purpose: Raises the VisualValidating event
Notes:

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

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

ProcessHiddenControls ()

Purpose: Processes the registered hidden controls
Notes: Intended to make them Visible = FALSE after DataBinding has been initialized

Top

RaiseGenericEvent (EventArgs)

Purpose: Raises the Generic Event
Notes: Supports raising events from the Viewer Logic Class - it's recommended
to use a derived event arg to distinguish events. This method is package-protected
as it's only meant to be used from the SmartViewerLogic class

Parameters:
e Consultingwerk.EventArgs
The Consultingwerk.EventArgs
Top

LOGICAL RaiseToolbarAction (Object, ToolClickEventArgs, character)

Purpose: Executes a Toolbar Action
Notes:

Parameters:
sender System.Object
The reference to the control that raised the ToolClick event
e Infragistics.Win.UltraWinToolbars.ToolClickEventArgs
The ToolClickEventArgs with the data for the ToolClick event
pcToolbarAction CHARACTER
The name of the method to execute
Returns LOGICAL
Logical value indicating if the action was executed
Top

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

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

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

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

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

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

RecurseRestoreCurrentValues (Control)

Purpose: Recurse 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

RecurseStoreCurrentValues (Control)

Purpose: Recurse 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

RegisterHiddenControl (Control)

Purpose: Register a hidden control
Notes: Hidden Controls are rendered Visible but Hidden at the end of the Viewer's
OnLoad method - to allow data-binding to be initialized

Parameters:
poControl System.Windows.Forms.Control
The Control to register as hidden
Top

RegisterServerSideEventHandler (Control, character, character)

Purpose: Subscribes a Control to a server-side event handler
Notes: Method in a Business Task

Parameters:
poControl System.Windows.Forms.Control
The Control contained in the Viewer
pcEventName CHARACTER
The name of the event to subscribe
pcHandlerName CHARACTER
The name of the control event handler method
Top

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

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

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

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

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

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

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

ResetViewerState (logical)

Purpose: Resets the state of the Viewer
Notes: SetControlEnabled, StyleSetName

Parameters:
plLoadEvent LOGICAL
Logical value indicating if we're called from the Load event
Top

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

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

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

ServerSideAfterFieldsEnabledHandler (Object, EventArgs)

Purpose: Event handler for AfterFieldsEnabled event
Notes: Public so that the SmartViewerUiControlHandler can call into this method

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

ServerSideAfterPerformLookupHandler (Object, EventArgs)

Purpose: Event handler for AfterPerformLookup event
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

ServerSideBeforeEnableFieldsHandler (Object, CancelableEventArgs)

Purpose: Event handler for CurrentChanged event
Notes: Public so that the SmartViewerUiControlHandler can call into this method
Sends "add", "copy" or "update" as the event context

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

ServerSideClickHandler (Object, EventArgs)

Purpose: Event handler for Click event
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

ServerSideCurrentChangedHandler (Object, EventArgs)

Purpose: Event handler for CurrentChanged event
Notes: Public so that the SmartViewerUiControlHandler can call into this method

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

ServerSideEditorButtonClickHandler (Object, EditorButtonEventArgs)

Purpose: Event handler for EditorButtonClick event
Notes:

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

ServerSideLeaveHandler (Object, EventArgs)

Purpose: Event handler for Leave event
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

ServerSideLoadHandler (Object, EventArgs)

Purpose: Event handler for Load event
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

ServerSideLookupCompleteHandler (Object, EventArgs)

Purpose: Event handler for LookupComplete event
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

ServerSideLookupKeyValueChangedHandler (Object, EventArgs)

Purpose: Event handler for LookupKeyValueChanged event
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

ServerSideValidatingHandler (Object, EventArgs)

Purpose: Event handler for Validating event
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

ServerSideValueChangedHandler (Object, EventArgs)

Purpose: Event handler for ValueChanged event
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

SetControlEnabled (character, character)

Purpose: Sets the Enable Mode for the given Controls inside the SmartViewerControl
Notes: Possible Values for pcEnabled (ControlEnabledEnum):
Add, Always, Never, Update, UpdateOnly

Parameters:
pcControlNames CHARACTER
The comma delimited list of Control Name
pcEnabled CHARACTER
Mode to be set as defined in ControlEnabledEnum
Top

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

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

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

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

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

SetControlEnabled (Control[], character)

Purpose: Sets the Enable Mode for the given Controls inside the SmartViewerControl
Notes: Possible Values for pcEnabled (ControlEnabledEnum):
Add, Always, Never, Update, UpdateOnly

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

SetControlEnabledFromDescriptor ()

Purpose: Sets the ControlEnabled property of the visual controls
based on the Business Entity Descriptor
Notes:

Top

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

SetModifyingState ()

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

Top

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

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

SubscribeControlEventHandler (Control, character, character)

Purpose: Subscribes a Control to an Event Handler in the Viewer Logic Class
Notes: The event handler method needs to be PROTECTED in the Viewer Logic Class

Parameters:
poControl System.Windows.Forms.Control
The Control contained in the Viewer
pcEventName CHARACTER
The name of the event to subscribe
pcHandlerName CHARACTER
The name of the control event handler method
Top

TextChangedEventHandler (Object, EventArgs)

Purpose: Event handler for the TextChangedEvent event of Editor Controls on
the SmartViewerControl.
Initiate switching to the ModifyingData 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

ViewerDataSourceCurrentChangedHandler (Object, EventArgs)

Purpose: Event handler for the CurrentChanged event of the data source
this Viewer is attached to
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

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

Top

Consultingwerk.Windows.LegacyGuiMigration.Widgets.IWidgetFacade WidgetHandle (character)

Purpose: Returns the WidgetFacade for the given widget
Notes:

Parameters:
pcName CHARACTER
The name of the widget to return the name for
Returns Consultingwerk.Windows.LegacyGuiMigration.Widgets.IWidgetFacade
The IWidgetFacade reference or ? when the widget cannot be located


Constructor Detail
Top

SmartViewerControl ()

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



Event Detail
Top

AddedRecordModifiedChanged DELEGATE System.EventHandler

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

Delegate: System.EventHandler
Top

AddingRecordChanged DELEGATE System.EventHandler

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

Delegate: System.EventHandler
Top

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

AfterCancelledUpdate (Object, AfterCancelledUpdateEventArgs)

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
This event fires after the AfterCancelUpdate has fired and all update
status is reset

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

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

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

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

AfterFieldsEnabled DELEGATE System.EventHandler

Purpose: Raised after the fields have been enabled
Notes:

Delegate: System.EventHandler
Top

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

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

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

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

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

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

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

CopyingRecordChanged DELEGATE System.EventHandler

Purpose: Raised when the CopyingRecord property has changed
Notes:

Delegate: System.EventHandler
Top

CurrentChanged DELEGATE System.EventHandler

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

Delegate: System.EventHandler
Top

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

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

FocusControlOnAddChanged DELEGATE System.EventHandler

Purpose: Event fired when the FocusControlOnAdd property changes
Notes:

Delegate: System.EventHandler
Top

FocusControlOnUpdateChanged DELEGATE System.EventHandler

Purpose: Event fired when the FocusControlOnUpdate property changes
Notes:

Delegate: System.EventHandler
Top

GenericEvent (Object, EventArgs)

Purpose: Raised from custom logic
Notes: Support raising an event from a viewer logic class

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

InitializingChanged DELEGATE System.EventHandler

Purpose: Event fired when the Initializing property changes
Notes:

Delegate: System.EventHandler
Top

SmartDataSourceChanged DELEGATE System.EventHandler

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

Delegate: System.EventHandler
Top

SmartGroupAssignSourceChanged DELEGATE System.EventHandler

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

Delegate: System.EventHandler
Top

SmartTableIOSourceChanged DELEGATE System.EventHandler

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

Delegate: System.EventHandler
Top

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

VisualValidating DELEGATE System.EventHandler

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

Delegate: System.EventHandler


Property Detail
Top

LOGICAL ActivateCurrentGridRowDuringEdit


Returns LOGICAL
Top

LOGICAL AddedRecordModified


Returns LOGICAL
Top

LOGICAL AddingRecord


Returns LOGICAL
Top

LOGICAL AllowCloseOfUnmodifiedNewRecord


Returns LOGICAL
Top

LOGICAL CancellingUpdate


Returns LOGICAL
Top

LOGICAL CopyingRecord


Returns LOGICAL
Top

LOGICAL DisallowUpdateDuringAnotherUpdate


Returns LOGICAL
Top

LOGICAL DisallowUpdateDuringAnotherUpdateDefault


Returns LOGICAL
Top

LOGICAL EventHandlerActive


Returns LOGICAL
Top

System.Windows.Forms.Control FocusControlOnAdd


Returns System.Windows.Forms.Control
Top

System.Windows.Forms.Control FocusControlOnUpdate


Returns System.Windows.Forms.Control
Top

LOGICAL Initializing


Returns LOGICAL
Top

Consultingwerk.SmartComponents.Interfaces.Design.IDesignDataSource LinkDataSource


Returns Consultingwerk.SmartComponents.Interfaces.Design.IDesignDataSource
Top

Consultingwerk.SmartComponents.Interfaces.Design.IDesignGroupAssignSource LinkGroupAssignSource


Returns Consultingwerk.SmartComponents.Interfaces.Design.IDesignGroupAssignSource
Top

Consultingwerk.SmartComponents.Interfaces.Design.IDesignTableIOSource LinkTableIOSource


Returns Consultingwerk.SmartComponents.Interfaces.Design.IDesignTableIOSource
Top

Consultingwerk.SmartComponents.Interfaces.Design.IDesignToolbarSource LinkToolbarSource


Returns Consultingwerk.SmartComponents.Interfaces.Design.IDesignToolbarSource
Top

Consultingwerk.SmartComponents.Base.SmartViewerOptionalFeatures OptionalFeatures


Returns Consultingwerk.SmartComponents.Base.SmartViewerOptionalFeatures
Top

LOGICAL ReadOnlyDisabled


Returns LOGICAL
Top

LOGICAL SaveMode


Returns LOGICAL
Top

LOGICAL SavingChanges


Returns LOGICAL
Top

CHARACTER SecurityKey


Returns CHARACTER
Top

Consultingwerk.SmartComponents.Interfaces.ISmartDataSource SmartDataSource


Returns Consultingwerk.SmartComponents.Interfaces.ISmartDataSource
Top

Consultingwerk.SmartComponents.Interfaces.ISmartGroupAssignSource SmartGroupAssignSource


Returns Consultingwerk.SmartComponents.Interfaces.ISmartGroupAssignSource
Top

Consultingwerk.SmartComponents.Base.ListISmartGroupAssignTarget SmartGroupAssignTargets


Returns Consultingwerk.SmartComponents.Base.ListISmartGroupAssignTarget
Top

Consultingwerk.SmartComponents.Interfaces.ISmartTableIOSource SmartTableIOSource


Returns Consultingwerk.SmartComponents.Interfaces.ISmartTableIOSource
Top

CHARACTER SmartTableIOState


Returns CHARACTER
Top

Consultingwerk.SmartComponents.Interfaces.ISmartToolbarSource SmartToolbarSource


Returns Consultingwerk.SmartComponents.Interfaces.ISmartToolbarSource
Top

LOGICAL TextChangedHandlerSuspended


Returns LOGICAL
Top

Consultingwerk.SmartComponents.Enum.UpdateStateEnum UpdateState


Returns Consultingwerk.SmartComponents.Enum.UpdateStateEnum
Top

LOGICAL UseBusinessEntityDescriptor


Returns LOGICAL
Top

LOGICAL ValidateChildrenOnSaveChanges


Returns LOGICAL
Top

CHARACTER ViewerLogicClass


Returns CHARACTER
Top

Consultingwerk.SmartComponents.Interfaces.ISmartViewerLogic ViewerLogicObject


Returns Consultingwerk.SmartComponents.Interfaces.ISmartViewerLogic


Temp-Table Detail

Temp-Table ttViewerBoundControls

Defined in:


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