<<

Contents

Search

>>

 

START_POPUPMENU

 

 

Function

 

 

Syntax:

START_POPUPMENU(<Row>,<Column>[,<Handle>])

 

<Row>

= <NUM-EXPRESSION>

<Column>

= <NUM-EXPRESSION>

<Handle>

= <NUM-EXPRESSION>

 

 

Meaning:

The popupmenu which has been created with the functions ADD_POPUPMENU is started in the window <Handle>.

 

If <Row> = -1 EBUS_SCREEN_MOUSE_ROW is used.

 

If <Column> = -1 EBUS_SCREEN_MOUSE_COL is used.

 

<Handle> specifies the window in that the popupmenu shall be displayed. <Handle> can contain the window depth or the handle of a split window or a WINDOWCALL window. If the parameter <Handle> is missing or invalid, the popupmenu is displayed in the current window.

 

The popupmenu is terminated when a menu item has been selected.

 

START_POPUPMENU returns the following results:

 

0

 No error

-1

 Runtime error

6008

 The menu is empty

 

START_POPUPMENU starts the popupmenu and returns immediately.

 

Parameter:

Row

Row position of the popupmenu

Column

Column position of the popupmenu

Handle

Window depth or handle of a split window or handle of a WINDOWCALL Window

 

Sample:

H% = ADD_POPUPMENUE("1","&Search","&Name;&City",POPUPMENU.MACRO)

...

/* Start popup menu at the current mouse cursor position

H% = START_POPUPMENU(EBUS_SCREEN_MOUSE_ROW,EBUS_SCREEN_MOUSE_COL)

 

See also:

ADD_POPUPMENU

DEL_POPUPMENU

START_MENU