GetFormPtr()

FORM_PTR()

PURPOSE

This function will return a value that can be used in GET_OBJ_PROP() and the SET_OBJECT command to specify a different form from the one that is currently active.

NO OTHER PARTS

RETURN TYPE - R

Returns a numeric value that refers to the current active form.

NOTE: If there is no active form, this will be 0.

COMMENTS

By using this value in the GET_OBJ_PROP() function and the SET_OBJECT command you can access objects on forms that are loaded but not currently active. A typical use for this option would be a program in which you want to change an object on the main form depending on a value the user enters on a subsequent form that's part of the same program. You know the first form is loaded since you're still in the same program, but, because of a choice your user has made, something must change on that form before they return; a field must be made visible that was not visible previously, disabled, etc.

This will also work with forms in other programs. As long as you have the value returned by this function you can access any form in the current instance of the runtime.

NOTE: You must get this value while the form is active and current. You cannot get this value for a different form from where you are.

EXAMPLE

define formptr type R

formptr = FORM_PTR()