Intel® Fortran Libraries Reference

Descriptions of the Library Routines 2controlid(Input) Integer. Specifies the identifier of a control within the dialog box. Can be the symbolicname for the control or the identifier number, both listed in the include (with extension .FD) file,or it can be the identifier of the dialog box.value(Input) EXTERNAL. Name of the routine to be called when the callback event occurs.index(Input; optional) Integer. Specifies which callback routine is executed when the callback eventoccurs. Necessary if the control has more than one callback routine.Results:The result type is LOGICAL(4). The result is .TRUE. if successful; otherwise, .FALSE..When a callback event occurs (for example, when you select a check box), the callback routineassociated with that callback event is called. You use DLGSETSUB to specify the subroutine to becalled. All callback routines should have the following interface:SUBROUTINE callbackname (dlg, controlid, callbacktype)!DEC$ ATTRIBUTES DEFAULT :: callbacknamecallbacknameIs the name of the callback routine.dlgRefers to the dialog box and allows the callback to change values of the dialog controls.controlidIs the name of the control that caused the callback.callbacktypeIndicates what callback is occurring (for example, DLG_CLICKED, DLG_CHANGE, orDLG_DBLCLICK).The controlid and callbacktype parameters let you write a single subroutine that can be used withmultiple callbacks from more than one control. Typically, you do this for controls comprising alogical group. You can also associate more than one callback routine with the same control, butyou must use then use index parameter to indicate which callback routine to use.The controlid can also be the identifier of the dialog box. The dialog box supports twocallbacktypes, DLG_INIT and DLG_SIZECHANGE. The DLG_INIT callback is executedimmediately after the dialog box is created with callbacktype DLG_INIT, and immediately beforethe dialog box is destroyed with callbacktype DLG_DESTROY. DLG_SIZECHANGE is calledwhen the size of a dialog is changed.2-67