MB_END

Define the end of a new column

WSupported on Windows

USupported on Unix

VSupported on OpenVMS

NSupported in Synergy .NET

xcall MB_END(control, column_id)

Arguments

control

The menu control structure. (a)

column_id

Returned with the ID of the menu column that is created. (n)

Discussion

MB_END ends a menu column specification session. Use this subroutine when you are building a new menu column at runtime.

After you call MB_END, you can’t change the contents of the column.

If you specified D_NOLOAD in the MB_COLUMN call, the value returned in column_id cannot be passed to some Toolkit routines. See the MB_COLUMN Discussion for details.

See also

• MB_COLUMN routine for more information on the menu control structure
• .END script command for information on terminating the current window definition

Examples

The following example creates a menu column with three entries. The ID of the new menu column is returned in colid.

xcall mb_column(menuctl, "colors", "Color Choices")
xcall mb_entry(menuctl, "color_1", "red")
xcall mb_entry(menuctl, "color_2", "blue")
xcall mb_entry(menuctl, "color_3", "yellow")
xcall mb_end(menuctl, colid)

Also see the MB_BLANK Examples, which use all the “MB_xxx” subroutines.