Programming Guide - Actian

How You Can Change Field and Frame Appearance and BehaviorFM_READSpecifies that default biases for entry fields allow reading but not updating.All other fields can be selected (clicked). All menu items are enabled.FM_USER1Specifies a name that lets you create your own mode (default biases allowreading and updating)FM_USER2Specifies a name that lets you create your own mode (default biases allowreading and updating)FM_USER3Specifies a name that lets you create your own mode (default biases allowreading and updating)Although OpenROAD provides a set of default biases for each of the modes,the most useful modes are the default Update and Read modes. Switchingbetween Update and Read modes is effective when you want to change aframe from an interactive to a passive state. For example, the video_detailframe script sets the frame mode to Read to provide a view-only version of thevideo details.Because the Query, User1, User2, and User3 modes have the same defaults asUpdate mode, these modes are useful only when you want to create your owncustomized mode by explicitly setting the biases of the individual fields andmenu items in that mode. You can do this from OpenROAD Workbench usingthe Frame Editor's Bias menu or from your 4GL code with the mode-biasattributes.How You Can Use the CurMode AttributeWhen you create a frame with Workbench, OpenROAD uses Update mode asthe default mode. You can change this initial frame mode on the frame'sProperty Inspector. To change the frame mode at runtime, use the CurModeattribute of the frame's FrameExec object.The CurMode attribute specifies the current mode for a frame. When you setthis attribute, OpenROAD changes all fields and menu items on the frame tothe appropriate bias for the new mode. The CurMode attribute can be set toany valid mode.You can force the bias of an individual field or menu item to change when theframe changes modes by setting the mode-bias attribute. However, you neednot change frame modes to change the biases of individual fields. The CurBiasattribute for fields lets you set the field bias regardless of the frame mode.Creating Dynamic Frames 371