Namespace: Consultingwerk.Windows.Framework.Authorization
Class 
FormAuthorizationMaintenanceForm Copy to Clipboard
Parent classes:
Progress.Windows.Form
Consultingwerk.Forms.BaseForm
Consultingwerk.SmartComponents.Base.SmartWindowForm
Consultingwerk.Windows.Framework.Authorization.FormAuthorizationMaintenanceForm

Inherits: Consultingwerk.SmartComponents.Base.SmartWindowForm
Implements: IBaseForm, ICustomTypeDescriptor, IHasDesignerVerbs, IHasPrimaryDataSourceAndTarget, IHasSecurityKey, IHasTabDataSourceCount, ISmartToolbarTarget, ISmartWindowForm


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



Top Method Summary
Options Name Purpose
ActivateTools () Updates the enabled state of the toolbar buttons
AreaHasPendingChangesChangedHandler (Object, EventArgs) Event handler for the HasPendingChangesChanged event of the security assignment grid of a security area
AreaSelectedOwnerIndexChangedHandler (Object, EventArgs) Event handler for the SelectedOwnerIndexChanged event of the security assignment grid of a security area
AssignTabImage (character, character) Assigns the image of a single security area tab
AssignTabImages () Assigns the images of the five security area tabs
CancelAreas () Cancels the pending changes of all security areas
ClearRepositoryCache () Clears the repository caches
ClearSecurityCaches () Clears the security related caches of the client session
Consultingwerk.Windows.Framework.Authorization.IFormAuthorizationAreaControl GetActiveAreaControl () Returns the IFormAuthorizationAreaControl implementation of the active tab
Consultingwerk.Windows.Framework.Authorization.IFormAuthorizationAreaControl GetAreaControl (UltraTabPageControl) Returns the IFormAuthorizationAreaControl implementation hosted on the given tab page
Consultingwerk.Windows.Framework.Authorization.IFormAuthorizationAreaControl GetAreaControlByAreaKey (character) Returns the IFormAuthorizationAreaControl implementation of the security area with the given key
Consultingwerk.Windows.Framework.Authorization.IFormAuthorizationAreaControl GetAreaControlByTabIndex (integer) Returns the IFormAuthorizationAreaControl implementation hosted on the tab with the given index
LOGICAL HasPendingChanges () Returns if one of the security areas has pending changes
InitializeComponent ()
LoadAreas () Populates the security areas from the structural data of the form and retrieves the authorization for the current owners
LoadFormStructure () Retrieves the structural data of the repository based form
OnShown (EventArgs) Override of the OnShown method to first show the form and then initiate reading the data
Consultingwerk.Windows.Framework.Authorization.FormAuthorizationMaintenanceForm OpenFormAuthorizationMaintenanceForm (character) Opens the Form Authorization Maintenance for the given repository based form
OpenObjectMaster (character) Assigns the repository based form the authorization is maintained for
ReloadAreas () Reloads the structural data of the form and the authorization of all security areas
LOGICAL SelectUserAndGroups () Displays a dialog to select the users and groups the authorization is maintained for and persists the selection in the user profile
smartToolbarController1_ToolClick (Object, ToolClickEventArgs) Event handler for the ToolClick event of the toolbar controller
StoreAreas () Stores the pending changes of all security areas
ultraTabControl1_SelectedTabChanged (Object, SelectedTabChangedEventArgs) Event handler for the SelectedTabChanged event of the tab control

Top Constructor Summary
Options Name Purpose
FormAuthorizationMaintenanceForm () Initializes a new instance of the FormAuthorizationMaintenanceForm

Top Property Summary
Options Name Purpose
CHARACTER AlternativeLoginCompanyKey
CHARACTER ObjectMasterGuid
CHARACTER ObjectMasterName


Method Detail
Top

ActivateTools ()
Purpose: Updates the enabled state of the toolbar buttons
Notes: Save Settings and Cancel are enabled when an area has pending changes,
Reload when no area has pending changes, and Restricted, Unrestricted
and Default when an owner column is selected in the grid of the active
area

Top

AreaHasPendingChangesChangedHandler (Object, EventArgs)
Purpose: Event handler for the HasPendingChangesChanged event of the security
assignment grid of a security area
Notes:

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

AreaSelectedOwnerIndexChangedHandler (Object, EventArgs)
Purpose: Event handler for the SelectedOwnerIndexChanged event of the security
assignment grid of a security area
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

AssignTabImage (character, character)
Purpose: Assigns the image of a single security area tab
Notes:

Parameters:
pcAreaKey CHARACTER
The key of the security area, one of the values of the FormAuthorizationArea class
pcImageFileName CHARACTER
The name of the image file, relative to the PROPATH
Top

AssignTabImages ()
Purpose: Assigns the images of the five security area tabs
Notes: Mirrors the images the Windows menu structure uses for the maintenance
form of the matching security items, so the areas are recognizable from
the menu. Assigned at runtime rather than through the .resx, because the
Visual Designer would otherwise have to round-trip a serialized
Infragistics Appearance object per tab

Top

CancelAreas ()
Purpose: Cancels the pending changes of all security areas
Notes:

Top

ClearRepositoryCache ()
Purpose: Clears the repository caches
Notes: Mirrors the ClearCache logic of the RuntimeRepositoryDeveloperMenuRenderer
and the DynamicLauncher - clears the repository object cache, the
dynamic browser cache and the in-memory caches of the repository
service. The caches are rebuilt on the next fetch of a repository
object, so no explicit rebuild is required

Top

ClearSecurityCaches ()
Purpose: Clears the security related caches of the client session
Notes: Clears the restriction caches of the AuthorizationClient (security
token, object token, toolbar item and product restrictions) and of the
SecurityServiceClient (per security item restriction results). The
caches fill lazily - a cleared entry is re-evaluated on the next
security check, so no explicit rebuild is required

Top

Consultingwerk.Windows.Framework.Authorization.IFormAuthorizationAreaControl GetActiveAreaControl ()
Purpose: Returns the IFormAuthorizationAreaControl implementation of the active
tab
Notes:

Returns Consultingwerk.Windows.Framework.Authorization.IFormAuthorizationAreaControl
The reference to the IFormAuthorizationAreaControl implementation or the unknown value
Top

Consultingwerk.Windows.Framework.Authorization.IFormAuthorizationAreaControl GetAreaControl (UltraTabPageControl)
Purpose: Returns the IFormAuthorizationAreaControl implementation hosted on the
given tab page
Notes:

Parameters:
poTabPage Infragistics.Win.UltraWinTabControl.UltraTabPageControl
The reference to the UltraTabPageControl of a security area tab
Returns Consultingwerk.Windows.Framework.Authorization.IFormAuthorizationAreaControl
The reference to the IFormAuthorizationAreaControl implementation or the unknown value
Top

Consultingwerk.Windows.Framework.Authorization.IFormAuthorizationAreaControl GetAreaControlByAreaKey (character)
Purpose: Returns the IFormAuthorizationAreaControl implementation of the security
area with the given key
Notes: The tabs of the form carry the area keys of the FormAuthorizationArea
class as their tab key

Parameters:
pcAreaKey CHARACTER
The key of the security area, one of the values of the FormAuthorizationArea class
Returns Consultingwerk.Windows.Framework.Authorization.IFormAuthorizationAreaControl
The reference to the IFormAuthorizationAreaControl implementation or the unknown value
Top

Consultingwerk.Windows.Framework.Authorization.IFormAuthorizationAreaControl GetAreaControlByTabIndex (integer)
Purpose: Returns the IFormAuthorizationAreaControl implementation hosted on the
tab with the given index
Notes:

Parameters:
piTabIndex INTEGER
The index (0 based) of the tab
Returns Consultingwerk.Windows.Framework.Authorization.IFormAuthorizationAreaControl
The reference to the IFormAuthorizationAreaControl implementation or the unknown value
Top

LOGICAL HasPendingChanges ()
Purpose: Returns if one of the security areas has pending changes
Notes:

Returns LOGICAL
Logical value indicating if one of the security areas has pending changes
Top

InitializeComponent ()

Top

LoadAreas ()
Purpose: Populates the security areas from the structural data of the form and
retrieves the authorization for the current owners
Notes: Subscribes to the events of the security assignment grids of the areas
the first time the areas are loaded

Top

LoadFormStructure ()
Purpose: Retrieves the structural data of the repository based form
Notes: The structural data is read from the repository rather than from the
rendered form, so that lazy rendering of tab pages is not a limitation

Top

OnShown (EventArgs)
Purpose: Override of the OnShown method to first show the form and then initiate
reading the data
Notes:

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

Consultingwerk.Windows.Framework.Authorization.FormAuthorizationMaintenanceForm OpenFormAuthorizationMaintenanceForm (character)
Purpose: Opens the Form Authorization Maintenance for the given repository based
form
Notes: Activates an existing form of the same Object Master or starts a new one

Parameters:
pcObjectMasterName CHARACTER
The name of the Object Master of the repository based form
Returns Consultingwerk.Windows.Framework.Authorization.FormAuthorizationMaintenanceForm
The FormAuthorizationMaintenanceForm when it was launched new, the unknown value when an existing instance was activated
Top

OpenObjectMaster (character)
Purpose: Assigns the repository based form the authorization is maintained for
Notes: The structural data of the form is retrieved when the form is shown

Parameters:
pcObjectMasterName CHARACTER
The name of the Object Master of the repository based form
Top

ReloadAreas ()
Purpose: Reloads the structural data of the form and the authorization of all
security areas
Notes:

Top

LOGICAL SelectUserAndGroups ()
Purpose: Displays a dialog to select the users and groups the authorization is
maintained for and persists the selection in the user profile
Notes: The selection is persisted with the ProfileType UserSelection, the
ProfileKey FormAuthorizationMaintenance and the ProfileName OwnerList

Returns LOGICAL
Logical value indicating if a selection has been made
Top

smartToolbarController1_ToolClick (Object, ToolClickEventArgs)
Purpose: Event handler for the ToolClick event of the toolbar controller
Notes:

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

StoreAreas ()
Purpose: Stores the pending changes of all security areas
Notes:

Top

ultraTabControl1_SelectedTabChanged (Object, SelectedTabChangedEventArgs)
Purpose: Event handler for the SelectedTabChanged event of the tab control
Notes: Re-evaluates the enabled state of the toolbar buttons for the newly
selected security area

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


Constructor Detail
Top

FormAuthorizationMaintenanceForm ()
Purpose: Initializes a new instance of the FormAuthorizationMaintenanceForm
Notes:



Property Detail
Top

CHARACTER AlternativeLoginCompanyKey

Returns CHARACTER
Top

CHARACTER ObjectMasterGuid

Returns CHARACTER
Top

CHARACTER ObjectMasterName

Returns CHARACTER


Temp-Table Detail


©2006-2026 Consultingwerk Ltd.         info@consultingwerk.de         http://www.consultingwerk.de       19.09.2026 10:21:13