Namespace: Consultingwerk.SmartComponents.Tools.OERABusinessEntityTester
Class 
OERABusinessEntityTesterUserControl Copy to Clipboard
Parent classes:
Progress.Windows.UserControl
Consultingwerk.SmartComponents.Base.SmartUserControl
Consultingwerk.SmartComponents.Tools.OERABusinessEntityTester.OERABusinessEntityTesterUserControl

Inherits: Consultingwerk.SmartComponents.Base.SmartUserControl
Implements: IHasDesignerVerbs

File:OERABusinessEntityTesterUserControl
Purpose:Core user control of the Business Entity Tester and
Busisness Entity Browser tools
Author(s):Marko Rüterbories / Consultingwerk Ltd.
Created:Mon Aug 03 08:58:01 CEST 2009

Navigate to: Methods | Constructors | Events | Properties



Top Method Summary
Options Name Purpose
- AfterCheckHandler (Object, TreeViewEventArgs) Event handler for the AfterCheck event of the tree
+ AfterSelectHandler (Object, TreeViewEventArgs) Event handle for the AfterSelect event of the tree
# LOGICAL AtLeastOneNodeChecked (TreeNodeCollection) Recursivly go through all nodes and return True if at least one if checked
# CreateVerbs () Creates Designer Verbs based on the DesignerVerbs property
Inherited from Consultingwerk.SmartComponents.Base.SmartUserControl
+ FetchDataFromBackend (character) Get the BusinessEntity Data from Backend
+ FetchEntity (character) Get an empty ProDataset from a Backend business entity and populates the Tree View
- FetchEntityFromBackend (character) Get an empty ProDataset from a Backend business entity
- FillTreeViewWithTableNames () Walk though the Dataset TopBuffers and add all of them with their childs to the TreeView
+ System.Collections.Generic.List <System.ComponentModel.Component> GetAllComponents () Returns a List of all Components in the Form
Inherited from Consultingwerk.SmartComponents.Base.SmartUserControl
- System.Windows.Forms.TreeNode GetSelectedTopBuffer () Returns the top most buffer which is selected
- CHARACTER GetSelectedTopBuffer (character, character) Returns the first selected table to display in DataView and builds a list of all selected child tables from the given selected node
- InitializeComponent () Initializes the Visual Design
+ LaunchAdapter () Creates the BusinessEntityAdapter instance
- NewFetchDataRequestHandler (Object, NewFetchDataRequestEventArgs) Event handler for ther NewFetchDataRequest event of the SmartBusinessEntityAdapter instance
+ NodeMouseClickHandler (Object, TreeNodeMouseClickEventArgs) Switches the view to the table which is selected. Checks whether the table is checked (data available).
# OnLoad (EventArgs) Raises the Load event
Inherited from Consultingwerk.SmartComponents.Base.SmartUserControl
+ OnVerbClicked (character) Event Handler method for Designer Verbs
Inherited from Consultingwerk.SmartComponents.Base.SmartUserControl
# ParentFormDestroyedHandler (Object, EventArgs) Event handler for the FormDestroyed event of the owning Form
Inherited from Consultingwerk.SmartComponents.Base.SmartUserControl
- System.Windows.Forms.TreeNode RecurseDatasetRelations (handle, handle, TreeNode) Add the DatasetRelations recursively to the tree
- LOGICAL RecurseFindTreeNodeName (character, TreeNodeCollection) Find a TreeNode by Name
- CHARACTER RecurseTreeNodeNames (TreeNodeCollection) Builds a list of all selected child tables from the given selected node
- CHARACTER RecurseTreeNodeQueries (TreeNodeCollection) Build a list of all Queries stored in the Tag property of the TreeNodes
- System.Windows.Forms.TreeNode RecurseTreeNodes (TreeNodeCollection) Returns the first selected table to display in DataView
+ RemoveFilter () Removes the filter from a table.
+ SelectAll () Selects all Tree nodes
# SelectNodes (TreeNodeCollection, logical) Selects or deselectes all Tree nodes
+ SelectNone () Deselects all Tree nodes
+ ShowDataSourceQueryInfo () Shows information about the Data source query strings from the previous request
+ ShowFilterDialog () Show the Filter Dialog and apply the settings
+ ShutDownBusinessEntities () Shuts down all locally running Business Entity instances using the service adapter
- TreeViewMouseDownHandler (Object, MouseEventArgs) Event handler for the MouseDown event of the Tree View

Top Constructor Summary
Options Name Purpose
+ OERABusinessEntityTesterUserControl () Initialize a new instance of the Class and subscribe to events.

Top Property Summary
Options Name Purpose
+ INTEGER BatchSize ContextMenuStrip (MS Control) from the parent Form
+ CHARACTER CustomContext CustomContext passed to SmartBusinessEntityAdapter
+ LONGCHAR CustomParameterObject Gets and sets the serialized form of the custom parameter object
# CHARACTER DesignerVerbs Property that is used to generate Designer Verbs (actions for the Visual Designer)
Inherited from Consultingwerk.SmartComponents.Base.SmartUserControl
+ LOGICAL DesignTime Propery flags if the current instance of the SmartBindingSource is running at design time or runtime.
Inherited from Consultingwerk.SmartComponents.Base.SmartUserControl
+ CHARACTER EntityName Returns the name of the Business Entity
# CHARACTER HiddenProperties Property that is used to mark properties (comma-delimited list) that will be excluded from the .NET TypeDescriptor properties list
Inherited from Consultingwerk.SmartComponents.Base.SmartUserControl
+ System.Windows.Forms.ImageList ImageList Images used to show whether a filter is applied to a table.
# CHARACTER NonBrowsableProperties Property that is used to mark properties (comma-delimited list) that should not show up in the Visual Designers Property Grid
Inherited from Consultingwerk.SmartComponents.Base.SmartUserControl
+ Consultingwerk.SmartComponents.Tools.OERABusinessEntityTester.IOERABusinessEntityTesterForm OERABusinessEntityTesterForm The parent Form used for callback to en-/disable Tools.
# LOGICAL ParentFormDestroyedSubscribed Returns if the FormDestroyed evengt of the containing Form has been subscribed
Inherited from Consultingwerk.SmartComponents.Base.SmartUserControl
+ CHARACTER StatusBarText Gets and sets the text fo the StatusBar
+ LOGICAL StatusBarVisible Gets and sets the visibility of the Status Bar
+ INTEGER StopAfter Value for StopAfter to be passed to the Service Interface
+ System.Windows.Forms.ContextMenuStrip TreeContextMenuStrip ContextMenuStrip (MS Control) from the parent Form


Method Detail
Top

PRIVATE AfterCheckHandler (Object, TreeViewEventArgs)
Purpose: Event handler for the AfterCheck event of the tree
Notes: Change settings after a table has been de-/selected

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

PUBLIC AfterSelectHandler (Object, TreeViewEventArgs)
Purpose: Event handle for the AfterSelect event of the tree
Notes: Set the Filter tools en-/disabled

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

PROTECTED LOGICAL AtLeastOneNodeChecked (TreeNodeCollection)
Purpose: Recursivly go through all nodes and return True if at least one if
checked
Notes:

Parameters:
poNodes System.Windows.Forms.TreeNodeCollection
The reference to the TreeNodeCollection to verify
Returns LOGICAL
Logical value indicating if at least one node was chaged
Top

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

Top

PUBLIC FetchDataFromBackend (character)
Purpose: Get the BusinessEntity Data from Backend
Notes: Only the first ChildTable is Joined at the moment.

Parameters:
pcEntityName CHARACTER
The name of the business entity to retrieve data from
Top

PUBLIC FetchEntity (character)
Purpose: Get an empty ProDataset from a Backend business entity and populates
the Tree View
Notes:

Parameters:
pcEntityName CHARACTER
The name of the Business Entity
Top

PRIVATE FetchEntityFromBackend (character)
Purpose: Get an empty ProDataset from a Backend business entity
Notes:

Parameters:
pcEntityName CHARACTER
The name of the Business Entity
Top

PRIVATE FillTreeViewWithTableNames ()
Purpose: Walk though the Dataset TopBuffers and add all of them with their
childs to the TreeView
Notes:

Top

PUBLIC System.Collections.Generic.List <System.ComponentModel.Component> GetAllComponents ()
Inherited from Consultingwerk.SmartComponents.Base.SmartUserControl
Purpose: Returns a List of all Components in the Form
Notes: Supported on OpenEdge 11 only, due to dependency to the ComponentsCollection
list not available on 10.2B

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

PRIVATE System.Windows.Forms.TreeNode GetSelectedTopBuffer ()
Purpose: Returns the top most buffer which is selected
Notes:

Returns System.Windows.Forms.TreeNode
Tree reference to the topmost selected TreeNode
Top

PRIVATE CHARACTER GetSelectedTopBuffer (character, character)
Purpose: Returns the first selected table to display in DataView and builds
a list of all selected child tables from the given selected node
Notes: Returns the name of the SelectedTopBuffer with a list of checked
nodes or returns the TreeNode object of the SelectedTopBuffer

Parameters:
cCheckedNodes CHARACTER
OUTPUT Comma delimited list of checked node text
cQueryStrings CHARACTER
OUTPUT Delimited list of query strings of the selected nodes
Returns CHARACTER
The name of the topmost selected buffer
Top

PRIVATE InitializeComponent ()
Purpose: Initializes the Visual Design
Notes:

Top

PUBLIC LaunchAdapter ()
Purpose: Creates the BusinessEntityAdapter instance
Notes: Ability to specify a different SmartBusinessEntityAdapter derived
class for the data adapter using -param Adapter=.....

Top

PRIVATE NewFetchDataRequestHandler (Object, NewFetchDataRequestEventArgs)
Purpose: Event handler for ther NewFetchDataRequest event of the
SmartBusinessEntityAdapter instance
Notes: Assigns a DataSourceQueryInfo instance to the CustomParameter
property of the IFechDataRequest instance

Parameters:
sender Progress.Lang.Object
The reference to the object that raised the event
e Consultingwerk.SmartComponents.Implementation.NewFetchDataRequestEventArgs
The NewFetchDataRequestEventArgs with the data for this event
Top

PUBLIC NodeMouseClickHandler (Object, TreeNodeMouseClickEventArgs)
Purpose: Switches the view to the table which is selected. Checks whether the
table is checked (data available).
Notes:

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

PROTECTED OnLoad (EventArgs)
Inherited from Consultingwerk.SmartComponents.Base.SmartUserControl
Purpose: Raises the Load event
Notes: Subscribes the FormDestroyed event from the ParentForm

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

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

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

PROTECTED ParentFormDestroyedHandler (Object, EventArgs)
Inherited from Consultingwerk.SmartComponents.Base.SmartUserControl
Purpose: Event handler for the FormDestroyed event of the owning Form
Notes:

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

PRIVATE System.Windows.Forms.TreeNode RecurseDatasetRelations (handle, handle, TreeNode)
Purpose: Add the DatasetRelations recursively to the tree
Notes:

Parameters:
phDataHandle HANDLE
The handle of the ProDataset
phBuffer HANDLE
The current iteration of the parent buffer
poParentTreeNode System.Windows.Forms.TreeNode
The current parent tree node
Returns System.Windows.Forms.TreeNode
The tree node for the current buffer
Top

PRIVATE LOGICAL RecurseFindTreeNodeName (character, TreeNodeCollection)
Purpose: Find a TreeNode by Name
Notes: Returns TRUE if found

Parameters:
cFindTreeNodeName CHARACTER
The name of the treenode to find
oNodeCollection System.Windows.Forms.TreeNodeCollection
The reference to the TreeNodeCollection
Returns LOGICAL
Logical value indicating if the node name was found
Top

PRIVATE CHARACTER RecurseTreeNodeNames (TreeNodeCollection)
Purpose: Builds a list of all selected child tables from the given selected
node
Notes:

Parameters:
oNodeCollection System.Windows.Forms.TreeNodeCollection
The reference to the TreeNodeCollection
Returns CHARACTER
The comma delimited list of child table names
Top

PRIVATE CHARACTER RecurseTreeNodeQueries (TreeNodeCollection)
Purpose: Build a list of all Queries stored in the Tag property of the
TreeNodes
Notes:

Parameters:
oNodeCollection System.Windows.Forms.TreeNodeCollection
The reference to the TreeNodeCollection
Returns CHARACTER
The CHR(1) delimited list of query strings
Top

PRIVATE System.Windows.Forms.TreeNode RecurseTreeNodes (TreeNodeCollection)
Purpose: Returns the first selected table to display in DataView
Notes:

Parameters:
oNodeCollection System.Windows.Forms.TreeNodeCollection
The reference to the TreeNodeCollection
Returns System.Windows.Forms.TreeNode
The reference to the first selected TreeNode
Top

PUBLIC RemoveFilter ()
Purpose: Removes the filter from a table.
Notes:

Top

PUBLIC SelectAll ()
Purpose: Selects all Tree nodes
Notes:

Top

PROTECTED SelectNodes (TreeNodeCollection, logical)
Purpose: Selects or deselectes all Tree nodes
Notes:

Parameters:
poNodes System.Windows.Forms.TreeNodeCollection
The reference to the TreeNodeCollection
plSelected LOGICAL
Logical value indicating if the tree nodes should be selected or not
Top

PUBLIC SelectNone ()
Purpose: Deselects all Tree nodes
Notes:

Top

PUBLIC ShowDataSourceQueryInfo ()
Purpose: Shows information about the Data source query strings from the previous
request
Notes:

Top

PUBLIC ShowFilterDialog ()
Purpose: Show the Filter Dialog and apply the settings
Notes:

Top

PUBLIC ShutDownBusinessEntities ()
Purpose: Shuts down all locally running Business Entity instances using
the service adapter
Notes: Assumption is, that the Business Entity Tester is running the
Business Entities locally. Otherwise this will need to be implemented
as a call to the AppServer(s)

Top

PRIVATE TreeViewMouseDownHandler (Object, MouseEventArgs)
Purpose: Event handler for the MouseDown event of the Tree View
Notes: Enable/Disable the Remove Filter context-menu item when the user
right clicks on the tree view - before the context menu is opened

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


Constructor Detail
Top

PUBLIC OERABusinessEntityTesterUserControl ()
Purpose: Initialize a new instance of the Class and subscribe to events.
Notes:



Property Detail
Top

PUBLIC INTEGER BatchSize
Purpose: ContextMenuStrip (MS Control) from the parent Form
Notes:

Returns INTEGER
Top

PUBLIC CHARACTER CustomContext
Purpose: CustomContext passed to SmartBusinessEntityAdapter
Notes:

Returns CHARACTER
Top

PUBLIC LONGCHAR CustomParameterObject
Purpose: Gets and sets the serialized form of the custom parameter object
Notes:

Returns LONGCHAR
Top

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

Returns CHARACTER
Top

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

Returns LOGICAL
Top

PUBLIC CHARACTER EntityName
Purpose: Returns the name of the Business Entity
Notes:

Returns CHARACTER
Top

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

Returns CHARACTER
Top

PUBLIC System.Windows.Forms.ImageList ImageList
Purpose: Images used to show whether a filter is applied to a table.
Notes:

Returns System.Windows.Forms.ImageList
Top

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

Returns CHARACTER
Top

PUBLIC Consultingwerk.SmartComponents.Tools.OERABusinessEntityTester.IOERABusinessEntityTesterForm OERABusinessEntityTesterForm
Purpose: The parent Form used for callback to en-/disable Tools.
Notes:

Returns Consultingwerk.SmartComponents.Tools.OERABusinessEntityTester.IOERABusinessEntityTesterForm
Top

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

Returns LOGICAL
Top

PUBLIC CHARACTER StatusBarText
Purpose: Gets and sets the text fo the StatusBar
Notes:

Returns CHARACTER
Top

PUBLIC LOGICAL StatusBarVisible
Purpose: Gets and sets the visibility of the Status Bar
Notes:

Returns LOGICAL
Top

PUBLIC INTEGER StopAfter
Purpose: Value for StopAfter to be passed to the Service Interface
Notes: Allows limiting the execution time of queries executed on the backend

Returns INTEGER
Top

PUBLIC System.Windows.Forms.ContextMenuStrip TreeContextMenuStrip
Purpose: ContextMenuStrip (MS Control) from the parent Form
Notes:

Returns System.Windows.Forms.ContextMenuStrip


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