ContextMenu Method (HTMLCONTROL)


10.2, PLBCMP GUI Only

 

The ContextMenu method controls whether a right-click action on a HTMLCONTROL allows a Windows context menu to appear. By default the HTMLCONTROL 'right-click' action does not allow the context menu to appear. This method can turn on the 'right-click' context menu. This method uses the following format:

 

[label]

{object}.ContextMenu

[GIVING {return}] USING [*Flags=]{flags}]

 

Where:

label

Optional. A Program Execution Label.

object

Required. A HTMLCONTROL that has been created.

return

Optional. A Numeric Variable that returns the pass\failure values for the execution of the method.

flags

Optional. A Numeric Variable or decimal value that specifies a bit mask value that controls the behavior of this method.

Flags Affected: OVER, ZERO

Note the following:

  1. The ZERO flag is always set when the {return} value is zero which indicates that the method execution was successful. The ZERO flag is cleared if the {return} value is not zero which indicates that the method execution failed.

  2. The OVER flag is set if the {return} variable size is too small and the return value must be truncated to be stored into the variable.

  3. The {flags} value is a bit-mask value where the bit values are described as follows:
     

  4. Value

    Description

    0x0

    The bit-mask value of zero which causes the default behavior to be used. In this case, the right-click action on a HTMLCONTROL does not allow the Windows context menu to appear.

    0x1

    When this bit-mask value is on, this causes the rigth-click action on a HTMLCONTROL to show the Windows context menu.

 

 

See Also: HTMLControl Methods, Method Syntax



PL/B Language Reference HTMLCONTROL Methods Focus Method (HTMLCONTROL)