Navigation: ABC Library Reference > RuleManager > RulesCollection Class Methods >====== TakeAccepted (handle acceptance of error indicators) ====== | |
TakeAccepted( control )
TakeAccepted | Determines whether or not the specified control is an error indicator for one of the Rule objects managed by this RulesCollection object. If so, the TakeAccepted method displays the description of the rule and provides the user with an option to view the status of all broken rules. |
control | A numeric constant, variable, EQUATE, or expression that contains a field equate value. The control indicated by this value is assumed to have been Accepted. |
Return Data Type: BYTE
Implementation:
When the control which has been accepted is an error indicator, the description of the associated rule is displayed in a message box. This message box always provides a Close button. If the total number of broken rules found exceeds one, a second button offers to display all of them. If the Supervisor property is not NULL, this RulesCollection object uses that property to access the EnumerateBrokenRules method of its supervising RulesManagerObject rather than its own. As a result, the user gets a full list of broken rules even when the controls on a screen involve rules from more than one collection.
Example:
ThisWindow.TakeAccepted PROCEDURE
ReturnValue BYTE,AUTO
Looped BYTE
CODE
Customer.TakeAccepted(Accepted())! RulesCollection traps to determine if
! error-indicator was clicked
LOOP
IF Looped
RETURN Level:Notify
ELSE
Looped = 1
END
CASE ACCEPTED()
END
END
See Also: CheckAllRules, EnumerateBrokenRules