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

File:DockManagerHelper
Purpose:Helper class that supports custom serialization/
deserialization of the Infragistics UltraDockManager
component
Syntax:Static methods only, private constructor to disallow
instance creation
Author(s):Mike Fechner / Consultingwerk Ltd.
Created:Tue Jul 05 20:22:52 CEST 2011
Notes:When serializing/deserializing the settings we do assume
that the key of a Pane



Top Method Summary
Options Name Purpose
# EnsureKeys (DockablePanesCollection) Ensures that all DockablePanes / DockableGroupPanes in the collection have a Key. If no Key is present, a GUID will be used
+ EnsureKeys (UltraDockManager) Ensures that all DockAreaPanes in the UltraDockManager have a Key. If no Key is present, a GUID will be used
# RestoreDockablePaneSettings (DockableGroupPane) Restores the child DockableControlPanes/DockableGroupPanes for the given paren (DockableGroupPane).
# RestoreDockAreaSettings (DockAreasCollection) Restores the DockAreas for the given DockAreasCollection (direct childs of the UltraDockManager)
+ RestoreDockManagerSettings (UltraDockManager, dataset) Restores the settings of the UltraDockManager from the given dsDockManagerSettins ProDataset
+ RestoreFromSettingsService (UltraDockManager, character) Restores the Settings of the UltraDockManager from the ISettingsService
# StoreDockablePaneSettings (DockablePanesCollection) Stores the settings of the Panes in the given DockablePanesCollection
# StoreDockAreaSettings (DockAreasCollection) Stores the settings of the DockAreaPanes
+ StoreDockManagerSettings (UltraDockManager, dataset) Stores the settings of the UltraDockManager and returns them in the dsDockManagerSettings Dataset.
+ StoreToSettingsService (UltraDockManager, character) Stores the current Settings of the UltraDockManager to the ISettingsService

Top Constructor Summary
Options Name Purpose
# DockManagerHelper () Disallow instance creation


Method Detail
Top

PROTECTED EnsureKeys (DockablePanesCollection)

Purpose: Ensures that all DockablePanes / DockableGroupPanes in the collection
have a Key. If no Key is present, a GUID will be used
Notes: Recursive function. The purpose of this method is to work around
the fact that the Dockable Panes InternalId is not accessible. When
serializing we assume that the Keys are GUID to serve as InternalId's
when deserializing (constructor parameters)

Parameters:
poPanes Infragistics.Win.UltraWinDock.DockablePanesCollection
The DockablePanesCollection to ensure that all panes have a key
Top

PUBLIC EnsureKeys (UltraDockManager)

Purpose: Ensures that all DockAreaPanes in the UltraDockManager have a Key.
If no Key is present, a GUID will be used
Notes: Recursive function. The purpose of this method is to work around
the fact that the DockAreaPanes InternalId is not accessible. When
serializing we assume that the Keys are GUID to serve as InternalId's
when deserializing (constructor parameters)

Parameters:
poDockManager Infragistics.Win.UltraWinDock.UltraDockManager
The reference to the UltraDockManager instance
Top

PROTECTED RestoreDockablePaneSettings (DockableGroupPane)

Purpose: Restores the child DockableControlPanes/DockableGroupPanes for the
given paren (DockableGroupPane).
Notes: Since the DockAreaPanes inherit from the DockableGroupPanes this
method is recursively used for DockableControlPanes/DockableGroupPanes
at any given level

Parameters:
poPane Infragistics.Win.UltraWinDock.DockableGroupPane
The reference to the DockableGroupPane
Top

PROTECTED RestoreDockAreaSettings (DockAreasCollection)

Purpose: Restores the DockAreas for the given DockAreasCollection (direct
childs of the UltraDockManager)
Notes: Calls RestoreDockablePaneSettings (poPane AS DockableGroupPane) to
restore the Panes or the DockAreaPanes

Parameters:
poAreas Infragistics.Win.UltraWinDock.DockAreasCollection
The reference to the DockAreasCollection
Top

PUBLIC RestoreDockManagerSettings (UltraDockManager, dataset)

Purpose: Restores the settings of the UltraDockManager from the given
dsDockManagerSettins ProDataset
Notes:

Parameters:
poDockManager Infragistics.Win.UltraWinDock.UltraDockManager
The reference to the UltraDockManager instance
dsDockManagerSettings DATASET
DATASET with the Dockmanager Settings, from Consultingwerk/Util/TempTables/dsDockManagerSettings.i
Top

PUBLIC RestoreFromSettingsService (UltraDockManager, character)

Purpose: Restores the Settings of the UltraDockManager from the ISettingsService
Notes: Uses the Key "DockManagerSettings", typically used inside the
OnLoad method of a Form

Parameters:
poDockManager Infragistics.Win.UltraWinDock.UltraDockManager
The UltraDockManager instance to restore the settings for
pcSettingsKey CHARACTER
The Settings Key (Form Identifier) to load the settings from
Top

PROTECTED StoreDockablePaneSettings (DockablePanesCollection)

Purpose: Stores the settings of the Panes in the given DockablePanesCollection
Notes: Uses the Key as the InternalId (.NET GUID compatibility required)

Parameters:
poPanes Infragistics.Win.UltraWinDock.DockablePanesCollection
The reference to the DockablePanesCollection
Top

PROTECTED StoreDockAreaSettings (DockAreasCollection)

Purpose: Stores the settings of the DockAreaPanes
Notes: Recursively calls StoreDockablePaneSettings (oArea:Panes), uses the
Key as the InternalId (.NET GUID compatibility required)

Parameters:
poAreas Infragistics.Win.UltraWinDock.DockAreasCollection
The reference to the DockAreasCollection
Top

PUBLIC StoreDockManagerSettings (UltraDockManager, dataset)

Purpose: Stores the settings of the UltraDockManager and returns them in the
dsDockManagerSettings Dataset.
Notes:

Parameters:
poDockManager Infragistics.Win.UltraWinDock.UltraDockManager
The reference to the UltraDockManager instance
dsDockManagerSettings DATASET
OUTPUT DATASET with the dockmanager settings, from Consultingwerk/Util/TempTables/dsDockManagerSettings.i
Top

PUBLIC StoreToSettingsService (UltraDockManager, character)

Purpose: Stores the current Settings of the UltraDockManager to the
ISettingsService
Notes: Uses the Key "DockManagerSettings", typically used inside the
OnFormClosing method of a Form

Parameters:
poDockManager Infragistics.Win.UltraWinDock.UltraDockManager
The UltraDockManager instance to store the settings from
pcSettingsKey CHARACTER
The Settings Key (Form Identifier) to save the settings under


Constructor Detail
Top

PROTECTED DockManagerHelper ()

Purpose: Disallow instance creation
Notes:



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