PowerCOBOL V11.0 Reference

6.4 BeforeClick Event

Description:	The purpose of this event is to let you verify the input to a tab page before switching to another page. If there are errors you can maintain the focus on the current page. The event is generated when a tab or Tab control button is clicked - before the Click event. If PageCancel is set to True, the Tab control does not switch to the new page. See the BeforeClick Sample Code.
Used in controls:	Tab
Used in objects:	None.
Parameters:	1. [VT_I4 - Index S9(9) COMP-5] 2. VT_I4 - OldPageIndex S9(9) COMP-5 3. VT_BOOL - PageCancel S9(4) COMP-5
Description of parameters:	Index: When the control is part of an array, Index contains the control's index in the array. OldPageIndex: Number of the tab page that is currently displayed. PageCancel: Determines whether the tab control switches to the new selected page. If you set PageCancel to POW-TRUE, the page is not switched. If you set it to POW-FALSE, the page is switched.