Difference between revisions of "PRMBAR()"

From Recital Documentation Wiki
Jump to: navigation, search
Line 16: Line 16:
  
 
==Description==
 
==Description==
The PRMBAR() function returns the prompt text from a specified bar of a specified popup.  The popup is specified in <expC>.  The popup must have been defined, but need not be active.  The name of the active popup is returned by the POPUP() function.  The bar number is specified in <expN>.  The number of the last selected bar is returned by the BAR() function.  If special characters such as hot keys '<' and disabled items '' are included in the prompts, these are removed by the PRMBAR() function.  When a popup bar is a separator, '-', PRMBAR()returns a null string.
+
The PRMBAR() function returns the prompt text from a specified bar of a specified popup.  The popup is specified in <expC>.  The popup must have been defined, but need not be active.  The name of the active popup is returned by the POPUP() function.  The bar number is specified in <expN>.  The number of the last selected bar is returned by the BAR() function.  If special characters such as hot keys '\<' and disabled items '\' are included in the prompts, these are removed by the PRMBAR() function.  When a popup bar is a separator, '\-', PRMBAR() returns a null string.
  
  

Revision as of 16:14, 2 June 2009

Class

Menus


Purpose

Function to return the prompt text from a popup bar


Syntax

PRMBAR(<expC>,<expN>)


See Also

ACTIVATE POPUP, BAR(), DEFINE BAR, DEFINE POPUP, DIALOG FIELDS, DIALOG FILES, DIALOG QUERY, DIALOG SCOPE, MENU FIELDS, MENU FILES, MENU QUERY, MENU SCOPE, ON SELECTION POPUP, POPUP(), PROMPT(), SET COMPATIBLE


Description

The PRMBAR() function returns the prompt text from a specified bar of a specified popup. The popup is specified in <expC>. The popup must have been defined, but need not be active. The name of the active popup is returned by the POPUP() function. The bar number is specified in <expN>. The number of the last selected bar is returned by the BAR() function. If special characters such as hot keys '\<' and disabled items '\' are included in the prompts, these are removed by the PRMBAR() function. When a popup bar is a separator, '\-', PRMBAR() returns a null string.


Example

set compatible to foxpro
define popup popup_1;
  from 1,26
define bar 1 of popup_1;
  prompt "Red"
define bar 2 of popup_1;
  prompt "Yellow"
define bar 3 of popup_1;
  prompt "Blue"
on selection popup popup_1 dialog box "You chose " + prmbar("POPUP_1",bar())
activate popup popup_1


Products

Recital Mirage Server, Recital Terminal Developer