Namespace: Consultingwerk.Windows.Framework.Repository.Rendering.Toolbar
Class 
ToolbarButtonEnableRule Copy to Clipboard
Parent classes:
Progress.Lang.Object
Consultingwerk.Windows.Framework.Repository.Rendering.Toolbar.ToolbarButtonEnableRule

Inherits: Progress.Lang.Object


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



Top Method Summary
Options Name Purpose
CellChangedHandler (Object, CellEventArgs) Event handler for the CellChange event of a SmartUpdatableBrowser
Evaluate () Evaluates the EnableRule and enables or disables the toolbar button tool based on the result
FormShownHandler (Object, EventArgs) Event handler for the Shown event of the DynamicForm
CHARACTER GetAdapterFieldLiteral (SmartDataAdapter, character) Returns the value of a field of a SmartDataAdapter as an ABL expression literal
Consultingwerk.Framework.ExpressionParser.AblExpressionEvaluator GetEvaluator () Returns the AblExpressionEvaluator instance used to evaluate the EnableRule expressions
Progress.Lang.Object GetToolbarLinkTarget () Returns the Toolbar link target of the SmartToolbarController used to resolve tokens without a form instance qualifier
InitializeRule () Initializes the EnableRule
ReevaluateHandler (Object, EventArgs) Generic event handler that re-evaluates the EnableRule
CHARACTER ResolveDataAdapterValue (SmartDataAdapter, character) Resolves the value of a property or field of a SmartDataAdapter instance as an ABL expression literal
CHARACTER ResolveDataBrowserValue (SmartBrowserControl, character) Resolves the value of a property or field of a SmartDataBrowser or SmartUpdatableBrowser instance as an ABL expression literal
CHARACTER ResolveMemberValue (Object, character) Resolves the value of a property or field of a referenced instance as an ABL expression literal
CHARACTER ResolveViewerValue (SmartViewerControl, character) Resolves the value of a property or field of a SmartViewerControl instance as an ABL expression literal
SubscribeDataAdapterEvents (SmartDataAdapter) Subscribes to the change notification events of a SmartDataAdapter
SubscribeEvents () Subscribes to the change notification events of the instances referenced by the rule tokens
SubscribeViewerFieldControl (Object, character) Subscribes to the change notification event of the editor control bound to the referenced field of a SmartViewerControl
TableIOStateChangedHandler (Object, SmartTableIOStateChangedEventArgs) Event handler for the SmartTableIOStateChanged event of viewers and updatable browsers
TokenResolvedHandler (Object, TokenResolverEventArgs) Event handler for the TokenResolved event of the TokenResolver
UpdateStateChangedHandler (Object, DataSourceUpdateStateEventArgs) Event handler for the BeginUpdateState and EndUpdateState events of a SmartDataAdapter

Top Constructor Summary
Options Name Purpose
ToolbarButtonEnableRule (ToolBase, character, DynamicForm, UltraToolbarsManager) Constructor of the ToolbarButtonEnableRule class

Top Property Summary
Options Name Purpose
CHARACTER EnableRule


Method Detail
Top

CellChangedHandler (Object, CellEventArgs)
Purpose: Event handler for the CellChange event of a SmartUpdatableBrowser
Notes: Re-evaluates the EnableRule when the user edits a grid cell

Parameters:
sender System.Object
The reference to the sender of the event
e Infragistics.Win.UltraWinGrid.CellEventArgs
The CellEventArgs with the data for this event
Top

Evaluate ()
Purpose: Evaluates the EnableRule and enables or disables the toolbar button
tool based on the result
Notes: Resolves the tokens of the EnableRule into an ABL expression using
the TokenResolver and evaluates the expression using the
AblExpressionEvaluator. When the evaluation fails, the rule is
marked invalid and the failure is logged once

Top

FormShownHandler (Object, EventArgs)
Purpose: Event handler for the Shown event of the DynamicForm
Notes: Initializes the rule once the form is shown, so that all form
instances and SmartLinks are available

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

CHARACTER GetAdapterFieldLiteral (SmartDataAdapter, character)
Purpose: Returns the value of a field of a SmartDataAdapter as an ABL
expression literal
Notes: Resolves the field value using the GetFieldValues method of the
SmartDataAdapter and quotes the value based on the data type of
the field in the bound buffer

Parameters:
poAdapter Consultingwerk.SmartComponents.Base.SmartDataAdapter
The reference to the SmartDataAdapter instance
pcFieldName CHARACTER
The (optionally buffer qualified) name of the field
Returns CHARACTER
The ABL expression literal for the field value
Top

Consultingwerk.Framework.ExpressionParser.AblExpressionEvaluator GetEvaluator ()
Purpose: Returns the AblExpressionEvaluator instance used to evaluate the
EnableRule expressions
Notes: A single instance is shared by all ToolbarButtonEnableRule instances

Returns Consultingwerk.Framework.ExpressionParser.AblExpressionEvaluator
The reference to the AblExpressionEvaluator instance
Top

Progress.Lang.Object GetToolbarLinkTarget ()
Purpose: Returns the Toolbar link target of the SmartToolbarController used
to resolve tokens without a form instance qualifier
Notes: Returns the first registered ISmartToolbarTarget that is a
SmartDataAdapter, SmartViewerControl or SmartBrowserControl

Returns Progress.Lang.Object
The reference to the Toolbar link target instance
Top

InitializeRule ()
Purpose: Initializes the EnableRule
Notes: Resolves the instance references of the rule tokens, subscribes to
the change notification events of the referenced instances and
performs the initial evaluation of the rule. When a token cannot
be resolved, the rule is marked invalid and a message is logged

Top

ReevaluateHandler (Object, EventArgs)
Purpose: Generic event handler that re-evaluates the EnableRule
Notes: Used for all System.EventHandler based change notification events
of the referenced instances and bound editor controls

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

CHARACTER ResolveDataAdapterValue (SmartDataAdapter, character)
Purpose: Resolves the value of a property or field of a SmartDataAdapter
instance as an ABL expression literal
Notes: Supported properties are Available and SmartDataSourceState. All
other member names are resolved as field values using the
GetFieldValues method

Parameters:
poAdapter Consultingwerk.SmartComponents.Base.SmartDataAdapter
The reference to the SmartDataAdapter instance
pcMember CHARACTER
The name of the property or field to resolve
Returns CHARACTER
The ABL expression literal for the value
Top

CHARACTER ResolveDataBrowserValue (SmartBrowserControl, character)
Purpose: Resolves the value of a property or field of a SmartDataBrowser or
SmartUpdatableBrowser instance as an ABL expression literal
Notes: Supported properties are SmartTableIOState, AddingRecord and
CopyingRecord (SmartUpdatableBrowser only). All other member names
are resolved from the active grid row, falling back to the
SmartDataSource of the browser

Parameters:
poBrowser Consultingwerk.SmartComponents.Base.SmartBrowserControl
The reference to the SmartBrowserControl instance
pcMember CHARACTER
The name of the property or field to resolve
Returns CHARACTER
The ABL expression literal for the value
Top

CHARACTER ResolveMemberValue (Object, character)
Purpose: Resolves the value of a property or field of a referenced instance
as an ABL expression literal
Notes: Dispatches to the type specific resolution for SmartDataAdapter,
SmartViewerControl and SmartBrowserControl instances

Parameters:
poInstance Progress.Lang.Object
The reference to the instance to resolve the member from
pcMember CHARACTER
The name of the property or field to resolve
Returns CHARACTER
The ABL expression literal for the value
Top

CHARACTER ResolveViewerValue (SmartViewerControl, character)
Purpose: Resolves the value of a property or field of a SmartViewerControl
instance as an ABL expression literal
Notes: Supported properties are SmartTableIOState, AddingRecord and
CopyingRecord. All other member names are resolved from the bound
editor control, falling back to the SmartDataSource of the viewer

Parameters:
poViewer Consultingwerk.SmartComponents.Base.SmartViewerControl
The reference to the SmartViewerControl instance
pcMember CHARACTER
The name of the property or field to resolve
Returns CHARACTER
The ABL expression literal for the value
Top

SubscribeDataAdapterEvents (SmartDataAdapter)
Purpose: Subscribes to the change notification events of a SmartDataAdapter
Notes: Each adapter instance is only subscribed once, even when referenced
by multiple rule tokens

Parameters:
poAdapter Consultingwerk.SmartComponents.Base.SmartDataAdapter
The reference to the SmartDataAdapter instance
Top

SubscribeEvents ()
Purpose: Subscribes to the change notification events of the instances
referenced by the rule tokens
Notes: For viewers and browsers the events of their SmartDataSource are
subscribed as well, so that the rule re-evaluates when navigating
to another record

Top

SubscribeViewerFieldControl (Object, character)
Purpose: Subscribes to the change notification event of the editor control
bound to the referenced field of a SmartViewerControl
Notes: Uses the CheckStateChanged/CheckedChanged event for check editors
and the TextChanged event for all other editor controls

Parameters:
poInstance Progress.Lang.Object
The reference to the instance referenced by the rule token
pcMember CHARACTER
The name of the property or field referenced by the rule token
Top

TableIOStateChangedHandler (Object, SmartTableIOStateChangedEventArgs)
Purpose: Event handler for the SmartTableIOStateChanged event of viewers and
updatable browsers
Notes: Re-evaluates the EnableRule

Parameters:
sender System.Object
The reference to the sender of the event
e Consultingwerk.SmartComponents.Base.SmartTableIOStateChangedEventArgs
The SmartTableIOStateChangedEventArgs with the data for this event
Top

TokenResolvedHandler (Object, TokenResolverEventArgs)
Purpose: Event handler for the TokenResolved event of the TokenResolver
Notes: Resolves the tokens of the EnableRule into ABL expression literals.
Tokens that do not belong to this rule are left untouched

Parameters:
sender Progress.Lang.Object
The reference to the sender of the event
e OpenEdge.Core.Util.TokenResolverEventArgs
The TokenResolverEventArgs for this event
Top

UpdateStateChangedHandler (Object, DataSourceUpdateStateEventArgs)
Purpose: Event handler for the BeginUpdateState and EndUpdateState events of
a SmartDataAdapter
Notes: Re-evaluates the EnableRule

Parameters:
sender System.Object
The reference to the sender of the event
e Consultingwerk.SmartComponents.Implementation.DataSourceUpdateStateEventArgs
The DataSourceUpdateStateEventArgs with the data for this event


Constructor Detail
Top

ToolbarButtonEnableRule (ToolBase, character, DynamicForm, UltraToolbarsManager)
Purpose: Constructor of the ToolbarButtonEnableRule class
Notes: When the DynamicForm is not yet visible, the initialization of the
rule is delayed until the form is shown so that all form instances
and SmartLinks (including the Toolbar link) are available

Parameters:
poTool Infragistics.Win.UltraWinToolbars.ToolBase
The reference to the ToolBase instance to enable/disable based on the rule
pcEnableRule CHARACTER
The EnableRule expression from the toolbar button definition
poForm Consultingwerk.Windows.Framework.Repository.Rendering.DynamicForm
The reference to the DynamicForm instance used to resolve form instance qualified tokens
poToolbarsManager Infragistics.Win.UltraWinToolbars.UltraToolbarsManager
The reference to the UltraToolbarsManager (SmartToolbarController) used to resolve unqualified tokens against the Toolbar link target


Property Detail
Top

CHARACTER EnableRule

Returns CHARACTER


©2006-2026 Consultingwerk Ltd.         info@consultingwerk.de         http://www.consultingwerk.de       20.06.2026 07:32:24