Enable an item

WTSupported in traditional Synergy on Windows
WNSupported in Synergy .NET on Windows
USupported on UNIX
VSupported on OpenVMS
xcall M_ENABLE([D_ENTRY,] col_id, ent_name[, ...]) 
xcall M_ENABLE(D_LIST, col_id, list_name[, ...]) 
xcall M_ENABLE(D_COLUMN, col_id[, ...]) 
xcall M_ENABLE(D_SUB, sub_name, ent_name[, ...]) 



(optional) Enables a menu entry on a placed menu column. (default)


Enables a list of menu entries on a placed menu column.


Enables a placed primary column.


Enables a submenu entry, pop‑up menu entry, or entry in a submenu to a pop‑up menu on a loaded menu column.


The ID of the column to be enabled or the column in which the entry or list is located. Col_id is returned by the M_LDCOL and MB_END subroutines. (n)


The name of the entry to enable. Ent_name is an entry name from the .ENTRY script command or MB_ENTRY. (a)


The name of the list of entries to enable. List_name is a list name from the .LIST script command or MB_LIST. (a)


The name of the submenu, pop‑up menu column, or submenu to a pop‑up menu that contains the menu entries or submenu columns to enable. (a)


M_ENABLE enables menu entries, lists of menu entries, menu columns or subcolumns, entries in pop‑up menu columns, or entries in submenus to pop‑up menu columns. It has the four forms listed above.

You can specify more than one ent_name or more than one list_name. You can also specify more than one col_id if the qualifier is D_COLUMN. But M_ENABLE can have no more than nine arguments.

Note the following:


The first example enables the entry “gl” located in the column whose ID is stored in colid(i).

xcall m_enable(colid(i), "gl")

In the second example, the entries in the list sysmgr in the column stored in colid(i) are enabled.

xcall m_enable(D_LIST, colid(i), "sysmgr")

In the third example, the columns whose IDs are stored in col1and col2 are enabled.

xcall m_enable(D_COLUMN, col1, col2)

In the last example, the submenu entry “o_owner” is enabled in the submenu named “admin.”

xcall m_enable(D_SUB, "admin", "o_owner")