'\"macro stdmacro
.if n .pH g1f.getfrm @(#)getfrm	40.10 of 12/15/89
.\" Copyright 1989 AT&T
.nr X
.if \nX=0 .ds x} getfrm 1F "Form and Menu Language Interpreter Utilities" "\&"
.if \nX=1 .ds x} getfrm 1F "Form and Menu Language Interpreter Utilities"
.if \nX=2 .ds x} getfrm 1F "" "\&"
.if \nX=3 .ds x} getfrm "" "" "\&"
.TH \*(x}
.SH NAME
\f4getfrm\f1 \- returns the current frameID number
.SH SYNOPSIS
\f4getfrm\f1
.SH DESCRIPTION
\f4getfrm\f1 returns the current frameID number.
The frameID number is a number assigned to the frame by FMLI and
displayed flush left in the frame's title bar.
If a frame is closed its frameID number may be reused when a new frame is
opened.
\f4getfrm\f1 takes no arguments.
.SH EXAMPLES
.PP
If a menu whose frameID is \f43\f1 defines an item to have
this \f4action\f1 descriptor:
.PP
.RS
\f(CWaction=open text stdtext \(gagetfrm\(ga\f1
.RE
.PP
the text frame defined in the definition file \f4stdtext\f1
would be passed the 
argument \f43\f1 when it is opened.
.SH NOTES
It is not a good idea to use \f4getfrm\f1 in a backquoted expression
coded on a line by itself.
Stand-alone backquoted expressions are evaluated before any descriptors
are parsed, thus the frame is not yet fully current, and may not have
been assigned a frameID number.
.ig
BUILT-IN FMLI
..
.Ee
