Activate Method (FLOATMENU)

9.4B, PLBCMP GUI Only

The Activate method causes a FLOATMENU to be activated at the coordinates specified by the *Left and *Top parameters. The method uses the following format:

[label]	{object}.Activate	[GIVING {return}]:
		USING [[Left=]{left*}]:
		[[Top=]{top}],[[Flags=]{flags}]

Where:

label

Optional. A Program Execution Label.

object

Required. A FLOATMENU object that is activated.

return

Optional. A Numeric Variable that receives the pass or fail result for the execution of the method.

left

Required. A Numeric Variable or decimal number that that gives the left coordinate position for the FLOATMENU. The value is a pixel value relative to the upper left corner of the screen.

top

Required. A Numeric Variable or decimal number that gives the top coordinate position for the FLOATMENU. The value is a pixel value relative to the upper left corner of the screen.

flags

Optional. A Numeric Variable or decimal number that is a bit mask to control specific behavior for the placement of the FLOATMENU. There are no special behaviors implemented at this time and the value must be zero or not specified.

Flags Affected: OVER, ZERO

Note the following:

The ZERO flag is set when the {return} value is zero. The {return} value is non-zero when the method execution fails. The ZERO flag is set to FALSE when the {return} values is non-zero. The OVER flag is set if the {return} variable is too small to contain the value and it is truncated.
The following values can be returned in the {return} variable:

Value	Meaning
0	The method was executed successfully.
1	The method failed because the {object} data type is not a FLOATMENU.
2	The {flags} value is invalid.

The {left} and {top} coordinate values can be extracted and used directly from the click event result value that is given for a WINDOW object with a NotifyIcon. See the description for the NotifyIcon method for a WINDOW object.