Namespace: Consultingwerk.Util
Class 
GarbageCollectorHelper Copy to Clipboard
Parent classes:
Inherits: Progress.Lang.Object

File:GarbageCollectorHelper
Syntax:Static methods only, private constructor to disallow
instance creation
Author(s):Mike Fechner / Consultingwerk Ltd.
Created:Wed Jan 13 23:36:38 CET 2010
Notes:This file is intended for GUI for .NET only
Purpose: Protected default constructor.
Notes: There's no need to create instances of the helper classes



Top Method Summary
Options Name Purpose
+ ClearUltraGridColumnEditors (UltraGrid) Clears references to the UltraGrid cells EditorComponent
+ ClearUltraTreeNodes (TreeNodesCollection) Deletes nodes objects in a TreeNodes Collections
+ ClearUltraTreeNodes (UltraTree) Deletes all nodes objects in the UltraTree's Nodes Collection
+ DeleteObject (IService) Deletes an Service instance, if valid and not registered with the Service Container
+ DeleteObject (IService[]) Deletes Service instances from an Array, if valid and not registered with the Service Container
+ DeleteObject (handle) Deletes an Widget handle, if valid
+ DeleteObject (handle, handle) Deletes an Widget handle, if valid
+ DeleteObject (handle, handle, handle) Deletes an Widget handle, if valid
+ DeleteObject (handle, handle, handle, handle) Deletes an Widget handle, if valid
+ DeleteObject (handle, handle, handle, handle, handle) Deletes an Widget handle, if valid
+ DeleteObject (handle[]) Deletes an Array of Widget handles, if valid
+ DeleteObject (memptr) Deletes a MEMPTR
+ DeleteObject (Object) Deletes an Object instance, if valid
+ DeleteObject (Object[]) Deletes Object instances from an Array

Top Constructor Summary
Options Name Purpose
# GarbageCollectorHelper () Protected default constructor.


Method Detail
Top

PUBLIC ClearUltraGridColumnEditors (UltraGrid)

Purpose: Clears references to the UltraGrid cells EditorComponent
Notes: See SCL-2305 for details. Those references seem to be circular references
and cause the grid not to be GC'ed when a Form is closed. Invoked from
the BaseForm:OnFormClosed method

Parameters:
poUltraGrid Infragistics.Win.UltraWinGrid.UltraGrid
The reference to the UltraTree object
Top

PUBLIC ClearUltraTreeNodes (TreeNodesCollection)

Purpose: Deletes nodes objects in a TreeNodes Collections
Notes:

Parameters:
poNodesCollection Infragistics.Win.UltraWinTree.TreeNodesCollection
The reference to the TreeNodesCollection
Top

PUBLIC ClearUltraTreeNodes (UltraTree)

Purpose: Deletes all nodes objects in the UltraTree's Nodes Collection
Notes:

Parameters:
poUltraTree Infragistics.Win.UltraWinTree.UltraTree
The reference to the UltraTree object
Top

PUBLIC DeleteObject (IService)

Purpose: Deletes an Service instance, if valid and not registered
with the Service Container
Notes:

Parameters:
poService Ccs.Common.IService
The reference to the object to delete
Top

PUBLIC DeleteObject (IService[])

Purpose: Deletes Service instances from an Array, if valid and not registered
with the Service Container
Notes: We have noticed a potential regression in OE11.4 CQC documented in
SCL-392. It appears that passing an initialized Object[] to this method
raises the runtime error: Uninitialized array used as source of assignment.
(14906). We will investigate the issue in probably have to log a ticket
with PSC when the issue is still present in 11.4 FCS. At this time
we do not recommend to use this method.

Parameters:
poService Ccs.Common.IService
The ABL array of objects to delete
Top

PUBLIC DeleteObject (handle)

Purpose: Deletes an Widget handle, if valid
Notes:

Parameters:
phWidget HANDLE
The handle of the widget to delete
Top

PUBLIC DeleteObject (handle, handle)

Purpose: Deletes an Widget handle, if valid
Notes:

Parameters:
phWidget1 HANDLE
The handle of the widget to delete
phWidget2 HANDLE
The handle of the widget to delete
Top

PUBLIC DeleteObject (handle, handle, handle)

Purpose: Deletes an Widget handle, if valid
Notes:

Parameters:
phWidget1 HANDLE
The handle of the widget to delete
phWidget2 HANDLE
The handle of the widget to delete
phWidget3 HANDLE
The handle of the widget to delete
Top

PUBLIC DeleteObject (handle, handle, handle, handle)

Purpose: Deletes an Widget handle, if valid
Notes:

Parameters:
phWidget1 HANDLE
The handle of the widget to delete
phWidget2 HANDLE
The handle of the widget to delete
phWidget3 HANDLE
The handle of the widget to delete
phWidget4 HANDLE
The handle of the widget to delete
Top

PUBLIC DeleteObject (handle, handle, handle, handle, handle)

Purpose: Deletes an Widget handle, if valid
Notes:

Parameters:
phWidget1 HANDLE
The handle of the widget to delete
phWidget2 HANDLE
The handle of the widget to delete
phWidget3 HANDLE
The handle of the widget to delete
phWidget4 HANDLE
The handle of the widget to delete
phWidget5 HANDLE
The handle of the widget to delete
Top

PUBLIC DeleteObject (handle[])

Purpose: Deletes an Array of Widget handles, if valid
Notes:

Parameters:
phWidgets HANDLE
The array of widget handles to delete
Top

PUBLIC DeleteObject (memptr)

Purpose: Deletes a MEMPTR
Notes: Deallocates (frees) any memory associated with memptr Variable
Just doing a SET-SIZE (pmMptr) = 0 . as the MEMPTR does not need
any check if memory is already allocated or not (unlike DELETE OBJECT).
This method is just form completeness to allow a consistent coding

Parameters:
pmMptr MEMPTR
The MEMPTR to deallocate
Top

PUBLIC DeleteObject (Object)

Purpose: Deletes an Object instance, if valid
Notes:

Parameters:
poObject Progress.Lang.Object
The reference to the object to delete
Top

PUBLIC DeleteObject (Object[])

Purpose: Deletes Object instances from an Array
Notes: We have noticed a potential regression in OE11.4 CQC documented in
SCL-392. It appears that passing an initialized Object[] to this method
raises the runtime error: Uninitialized array used as source of assignment.
(14906). We will investigate the issue in probably have to log a ticket
with PSC when the issue is still present in 11.4 FCS. At this time
we do not recommend to use this method.

Parameters:
poObjects Progress.Lang.Object
The ABL array of objects to delete


Constructor Detail
Top

PROTECTED GarbageCollectorHelper ()

Purpose: Protected default constructor.
Notes: There's no need to create instances of the helper classes



©2006-2023 Consultingwerk Ltd.         info@consultingwerk.de         http://www.consultingwerk.de       15.04.2024 06:16:39