Purpose

WIDGET_MANIPULATE provides dynamic manipulation of windows controls ('widgets') from an application.  These widgets are s and icons, but not any other type of Windows objects, such as radio groups and radio s.
 

Syntax

#STATUS = WIDGET_MANIPULATE ($tagname, $attribute_name)
 

Operation

#status   contains the return status:
             0 = OK
            -1 = invalid attribute name
            -2 = Tag Name unknown
            -3 = Tag Name invalid

$tagname the name of the tag being changed for the item.  1-12 character alpha variable or literal.  Note that the Tag Name is unique across an entire function.

$attribute_name the name of the attribute being changed for the item valid attributes are DISABLE, ENABLE, HIDE, and SHOW.

where

DISABLE causes the item to be non-functional.  It is greyed-out or cross-hatched (depending on the item type) to indicate it is disabled

ENABLE restores the item to full functionality.

HIDE makes the item invisible on the screen.

SHOW restores hidden items to the screen. 

Remarks

Windows Controls manipulation is limited to changing the DISABLE, ENABLE, HIDE, and SHOW properties of an item.

WIDGET_MANIPULATE may be called at any logic point within a function that the item is valid.  For formats, this means any logic for the cycle except 'LS Entry'.  For screen fields, any logic executed after the main screen (or window) containing the cycle has been created is valid (including logic points on previous cycles, as long as a new window is not opened before the field appears).

If WIDGET_MANIPULATE is called from an invalid logic point, it is ignored and no error status is issued. If a Tag Name refers to an invalid Object Type (not a , icon or bitmap icon), WIDGET_MANIPULATE is ignored, and no error status is returned.

Example 1

#STATUS=WIDGET_MANIPULATE('invoice', 'DISABLE').