Namespace: Consultingwerk.Studio.LegacyGuiMigration.Frame
Class 
AblFrameMigrationService Copy to Clipboard
Parent classes:
Progress.Lang.Object
Consultingwerk.Studio.LegacyGuiMigration.Frame.AblFrameMigrationService

Inherits: Progress.Lang.Object
Implements: Consultingwerk.Studio.LegacyGuiMigration.Frame.IAblFrameMigrationService


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



Top Method Summary
Options Name Purpose
CHARACTER CommentBlock (character, character, character, character, longchar) Converts a source code block into a comment
DetectRectangleLabels () Detects Labels of Rectangles
GenerateMetaViewer (logical, character, character, CreateObjectMasterParameter, logical, character, character, logical, logical) Generates a Viewer in the Repository
Consultingwerk.Framework.Collections.CharacterList GetFrameNames (character) Parses the given file and returns a list of FRAME names
Consultingwerk.Studio.LegacyGuiMigration.Frame.UserControlParser GetUserControlParser () Returns the UserControlParser instance, instantiating it on first use
LOGICAL IsUserControlFile (character) Returns TRUE when the given file represents a GUI for .NET UserControl (e.g. a SmartViewerControl) and should be parsed via the UserControlParser.
LiftExtraPropertyMarkers () Lifts the marker keys placed in ExtraProperties by the UserControlParser into the AlternativeControlType / AlternativeControlName / AlternativeControlProperties fields of ttSelectedFrameWidget so the SmartViewerBuilder and MetaViewerGenerator can use them.
OnShowMessage (ShowMessageEventArgs) Raises the ShowMessage event
OnStatusChanged (StatusChangedEventArgs) Raises the StatusChanged
Progress.Json.ObjectModel.JsonObject ParseExtraProperties (character) Parses the ExtraProperties JSON text into a JsonObject
ParseFrameWidgets (character, character, ViewerSettings) Parses the file for widgets of the given frame
Consultingwerk.BusinessEntityDesigner.Generator.Viewer.ListViewerFieldSpec PrepareViewerBuilder (SmartViewerBuilder, SmartBusinessEntityBindingSource, character, character, character, character, logical, logical) Prepares the SmartViewerBuilder (adds fields)
ProcessLookupFieldProperties (JsonObject, SourceFieldLocator) Processes Lookup Properties
StatusChangedHandler (Object, StatusChangedEventArgs) Event handler for the StatusChanged event of the Frame or Trigger Parser
TestViewerMigration (character, character, character) Tests whether the frame can be migrated to a MetaViewer
WipeUnknownAlternativeControls () Wipes unknown alternative controls

Top Constructor Summary
Options Name Purpose
AblFrameMigrationService () Returns the handle of the ttSelectedFrameWidget temp-table

Top Event Summary
Options Name Purpose
ShowMessage (Object, ShowMessageEventArgs) Raised to show a message
StatusChanged (Object, StatusChangedEventArgs) Raised when the status of the class has changed

Top Property Summary
Options Name Purpose
CHARACTER EntityName
CHARACTER EntityTable
CHARACTER EntityView
HANDLE FrameWidgetTempTable
HANDLE SelectedFrameWidgetTempTable
HANDLE TriggerDataset


Method Detail
Top

CHARACTER CommentBlock (character, character, character, character, longchar)
Purpose: Converts a source code block into a comment
Notes:

Parameters:
pcFileName CHARACTER
The name of the file being processed
pcEvent CHARACTER
The name of the event
pcWidget CHARACTER
The name of the widget
pcFrame CHARACTER
The frame name
pcSource LONGCHAR
The trigger source code
Returns CHARACTER
The commented source code block
Top

DetectRectangleLabels ()
Purpose: Detects Labels of Rectangles
Notes:

Top

GenerateMetaViewer (logical, character, character, CreateObjectMasterParameter, logical, character, character, logical, logical)
Purpose: Generates a Viewer in the Repository
Notes:

Parameters:
plCreateBindingSource LOGICAL
Logical value indicating if we're creating a data bound viewer
pcEntityName CHARACTER
The name of the Business Entity
pcEntityTables CHARACTER
The names of the Business Entity tables
poParameter Consultingwerk.SmartFramework.Repository.CreateObjectMasterParameter
The CreateObjectMasterParameter instance with the name and module of the object to be created
plUpdatingExistingMaster LOGICAL
Updating existing master
pcFileName CHARACTER
The name of the file that contained the frame
pcFrameName CHARACTER
The name of the frame that is being parsed
plAlignLeftTop LOGICAL
Align controls left/top
plParseTriggerCode LOGICAL
Parse Trigger Code
Top

Consultingwerk.Framework.Collections.CharacterList GetFrameNames (character)
Purpose: Parses the given file and returns a list of FRAME names
Notes: Routes .cls files representing a System.Windows.Forms.UserControl
through the UserControlParser. All other files are parsed by the
FrameParser.

Parameters:
pcFileName CHARACTER
The name of the file to parse
Returns Consultingwerk.Framework.Collections.CharacterList
The CharacterList of Frame names
Top

Consultingwerk.Studio.LegacyGuiMigration.Frame.UserControlParser GetUserControlParser ()
Purpose: Returns the UserControlParser instance, instantiating it on first use
Notes:

Returns Consultingwerk.Studio.LegacyGuiMigration.Frame.UserControlParser
The UserControlParser instance
Top

LOGICAL IsUserControlFile (character)
Purpose: Returns TRUE when the given file represents a GUI for .NET
UserControl (e.g. a SmartViewerControl) and should be parsed
via the UserControlParser.
Notes: Uses TYPE-OF and the ClassHelper API to verify the file is a
System.Windows.Forms.UserControl based class. The .cls file
must be resolvable on the PROPATH - turning the file name into
a class name (and parsing it later) requires it. When the file
cannot be resolved on the PROPATH a meaningful error is thrown.

Parameters:
pcFileName CHARACTER
The file name
Returns LOGICAL
Logical value
Top

LiftExtraPropertyMarkers ()
Purpose: Lifts the marker keys placed in ExtraProperties by the
UserControlParser into the AlternativeControlType /
AlternativeControlName / AlternativeControlProperties fields
of ttSelectedFrameWidget so the SmartViewerBuilder and
MetaViewerGenerator can use them.
Notes: SCL-4882

Top

OnShowMessage (ShowMessageEventArgs)
Purpose: Raises the ShowMessage event
Notes:

Parameters:
e Consultingwerk.Framework.ShowMessageEventArgs
The ShowMessageEventArgs
Top

OnStatusChanged (StatusChangedEventArgs)
Purpose: Raises the StatusChanged
Notes:

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

Progress.Json.ObjectModel.JsonObject ParseExtraProperties (character)
Purpose: Parses the ExtraProperties JSON text into a JsonObject
Notes: ObjectModelParser:Parse requires the longchar to carry a UTF
codepage - a longchar inheriting the session codepage (e.g.
ISO8859-1) is rejected with error 16063. FIX-CODEPAGE on the
freshly declared longchar (still empty) sets the required UTF-8
codepage before the value is assigned.

Parameters:
pcExtraProperties CHARACTER
The ExtraProperties JSON text
Returns Progress.Json.ObjectModel.JsonObject
The parsed JsonObject, or the unknown reference
Top

ParseFrameWidgets (character, character, ViewerSettings)
Purpose: Parses the file for widgets of the given frame
Notes: Populates ttSelectedFrameWidget temp-table

Parameters:
pcFileName CHARACTER
The name of the file to parse
pcFrameName CHARACTER
The name of the frame
poViewerSettings Consultingwerk.Studio.LegacyGuiMigration.Frame.ViewerSettings
The viewer settings for this call
Top

Consultingwerk.BusinessEntityDesigner.Generator.Viewer.ListViewerFieldSpec PrepareViewerBuilder (SmartViewerBuilder, SmartBusinessEntityBindingSource, character, character, character, character, logical, logical)
Purpose: Prepares the SmartViewerBuilder (adds fields)
Notes:

Parameters:
poBuilder Consultingwerk.BusinessEntityDesigner.Generator.Viewer.SmartViewerBuilder
The SmartViewerBuilder instance to prepare
poBindingSource Consultingwerk.SmartComponents.Implementation.SmartBusinessEntityBindingSource
The SmartBusinessEntityBindingSource with the reference schema
pcFileName CHARACTER
The name of the ABL source code containing the frame
pcFrameName CHARACTER
The name of the FRAME that is being processed
pcClassName CHARACTER
The name of the class
pcPackageName CHARACTER
The name of the package
plAlignLeftTop LOGICAL
Align controls left/top
plParseTriggerCode LOGICAL
Parse Trigger Code
Returns Consultingwerk.BusinessEntityDesigner.Generator.Viewer.ListViewerFieldSpec
The list of viewer field specs to pass to the builder with the Generate() method
Top

ProcessLookupFieldProperties (JsonObject, SourceFieldLocator)
Purpose: Processes Lookup Properties
Notes: Maps field names to Business Entity fields

Parameters:
poProperties Progress.Json.ObjectModel.JsonObject
The JsonObject with the field properties
poMapper Consultingwerk.BusinessEntityDesigner.Services.SourceFieldLocator
The SourceFieldLocator instance that maps fields to the Business Entity
Top

StatusChangedHandler (Object, StatusChangedEventArgs)
Purpose: Event handler for the StatusChanged event of the Frame or Trigger
Parser
Notes:

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

TestViewerMigration (character, character, character)
Purpose: Tests whether the frame can be migrated to a MetaViewer
Notes: Populates the ttSelectedFrameWidget temp-table via ParseFrameWidgets
and determines if the frame is ready for migration
or "This frame is not yet ready for migration"

Parameters:
pcFileName CHARACTER
The name of the file to parse
pcFrameName CHARACTER
The name of the frame to test
pcStatus CHARACTER
OUTPUT The migration status: "This frame can be migrated"
Top

WipeUnknownAlternativeControls ()
Purpose: Wipes unknown alternative controls
Notes: Sets AlternativeControlType to "" when AlternativeControlName is not set



Constructor Detail
Top

AblFrameMigrationService ()
Purpose: Returns the handle of the ttSelectedFrameWidget temp-table
Notes:



Event Detail
Top

ShowMessage (Object, ShowMessageEventArgs)
Purpose: Raised to show a message
Notes:

Parameters:
sender Progress.Lang.Object
The object that raised the StatusChanged event
e Consultingwerk.Framework.ShowMessageEventArgs
The ShowMessageEventArgs with the data for the event
Top

StatusChanged (Object, StatusChangedEventArgs)
Purpose: Raised when the status of the class has changed
Notes:

Parameters:
sender Progress.Lang.Object
The object that raised the StatusChanged event
e Consultingwerk.StatusChangedEventArgs
The StatusChangedEventArgs with the data for the event


Property Detail
Top

CHARACTER EntityName

Returns CHARACTER
Top

CHARACTER EntityTable

Returns CHARACTER
Top

CHARACTER EntityView

Returns CHARACTER
Top

HANDLE FrameWidgetTempTable

Returns HANDLE
Top

HANDLE SelectedFrameWidgetTempTable

Returns HANDLE
Top

HANDLE TriggerDataset

Returns HANDLE


Temp-Table Detail


©2006-2026 Consultingwerk Ltd.         info@consultingwerk.de         http://www.consultingwerk.de       01.06.2026 09:18:20