Getting Started

Documentation

Glish

Learn More

Programming

Contact Us

Version 1.9 Build 1556

News	FAQ
Search	Home

extendoptionmenu.seteventmask - Function

	Package	display
	Module	widgets
	Tool	extendoptionmenu

Set the event mask

Synopsis
seteventmask(mask)

Arguments

mask		The event mask
		Allowed:	Vector of Bool

Returns
Bool

Description

This tool function sets the event mask. This mask indicates whether the select event will be emitted or not when you select a menu item. By default the mask is all T. You can get the current mask with the geteventmask tool function. If the mask is invalid, it returns F. New items added to the menu get a T value for their mask.

Example

- labels := "m mm cm";
- f := frame();
- m := extendoptionmenu(f, labels);
- m.seteventmask([T,F,T,T]);
- m.geteventmask();
[T F T T]
- whenever m->select do {print $value;};

In this example, when you selected the second item, no event would be emitted. Note that an element for the ellipsis is required too (element 4).