Links are not active on this page.
 PADPROMPT( ) Function

This function is undocumented in the original VFP9SP2 Help File.

Returns the text of a menu title.

PADPROMPT(cMenuTitleName [, cMenuBarName])

Parameters

cMenuTitleName

Specifies the menu title (pad) name or internal system menu title name.

cMenuBarName

Specifies the name of the menu bar containing the menu title or internal system menu bar name. When cMenuBarName is omitted the currenctly active menu bar is used as the second parameter. When no menu bar is active and cMenuBarName is omitted an error is generated.

Expand imageReturn Value

Character.

Expand imageRemarks

Menu bars are created with DEFINE MENU, which creates the menu bar, and DEFINE PAD, which creates the menu titles in the menu bar. PADPROMPT( ) also works with the Visual FoxPro menu system. A menu bar doesn't have to be active for PADPROMPT( ) to return the text for a menu title.
If a menu title was created using the backslash and less-than characters (\<) to create an access key, or a backslash (\) to disable the menu title, PADPROMPT( ) returns only the text of the menu title; it doesn't include the special characters.

Expand imageExample

In the following example, all system menu bar titles are listed:
CopyCode imageCopy Code 
? "System menu titles: "
FOR lnI = 1 TO CNTPAD("_msysmenu")
?? PADPROMPT( GETPAD( "_msysmenu", lnI), "_msysmenu") + " "
NEXT

Expand imageSee Also