Navigation:  thinBasic Modules > UI (User Interface) > MENUs >

MENU ADD STRING

Previous pageReturn to chapter overviewNext page

 

Description

 

Add a string or separator to an existing menu.

 

Syntax

 

MENU ADD STRING, hMenu, Txt, hID, State [, AT [BYCMD] Position]

 

Returns

 

None

 

Parameters

 

Name

Type

Optional

Meaning

hMenu

Number

No

Handle of the parent menu.

Txt

String

No

Text to display in the parent menu. An ampersand (&) may be used in the string to make the following letter into a command accelerator (hot-key).  The letter is underscored to signify that it is an accelerator. To create a horizontal separator instead of a text string, set Txt = "-", hID = 0, State = 0.

hID

Number

No

The unique numeric identifier for the menu item.

State

Number

No

The initial state of the menu item. See menu equates for possible values.

Position

Number

Yes

Indicates the position in the parent menu where the popup child menu is to be inserted.  If the BYCMD option is used, the popup menu is inserted prior to the menu item ID specified by Position. Otherwise, the popup menu is inserted at the physical Position within the parent menu, where Position = 1 for the first position, Position = 2 for the second, and so on.

 

Remarks

 

Restrictions

 

See also

 

Examples