[<<Previous Entry]
[^^Up^^]
[Next Entry>>]
[Menu]
[About The Guide]
POPMENU ( aPop, nTRow, nLCol, nBarRow ) -> nChoice
Creates a PopUp-Window and returns the chosen Row.
Colors are predefined via SetPref().
PARAMETER:
aPop Array with 4 Dimensions:
<cText>, <xRet>, <lSelect>, <cMessage>, <cShortCut>
nTRow TopRow of the MenuWindow
nLCol LeftColumn of the MenuWindow
nBarRow Row, in which the MenuBar is set
needed for the Mouse: If the Mouse meets the MenuBar
all Windows will be closed
(ReturnValues = K_MOUSE, otherwise K_ESC)
RETURN VALUES:
ReturnValues of the Menu:
If it's a valid choice the 'aBar [x, nRet]' value, defined
in the MenuArray, will be returned.
Unless:
you defined a SubMenu-Array in it -> this will result in a PopUpMenu
or
a defined a CodeBlock in it, which sets the .-Tag.
In this case nothing will be returned, because the Menu is not canceled.
The following ReturnValues are predefined (SoundVis.ch):
B_ESC 0 will be returned if ESC is pressed
B_LEFT -1 Cursor Left -> Internal, MenuItem +1
B_RIGHT -2 Cursor Right -> Internal, MenuItem -1
B_MOUSE -4 Internal, new Menu chosen by Mouse
Structure of the MenuArray:
Each element of the array has at least one and a maximum of five
dimensions. You'll find the defines in SoundVis.ch ( again )
aPop [x, MEN_TEXT] cText
MenuText, Hotkey is the character after the HotKey-Marker '~'
If {A_SEP} is put here, PopMenu will draw a seperation-line
In this case (and only in this case) the element hast only
one dimension !
aPop [x, MEN_RET] nRet
A numeric ReturnValue cancels the Menu and returns this value,
a SubArray in here pops up another Sub-PopUpMenu. If a CodeBlock
is in it, the ReturnValue ( .T. or .F. ) will set the
CheckMarker '.' ( .T. means set, well... )
aPop [x, MEN_SEL] lSel
is this Item selectable ? if so -> put .T. in here
aPop [x, MEN_DESC] cDesc
Description of the MenuItem, the Hotkey-Marker '~'
will display the following word in a different color
Optional:
aPop [x, MEN_CUT] cText
Description of the ShortCut key-defines, like, for example
'ALT-F4' might get you back to DOS ( hello, Windows )
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson