<?xml version="1.0" encoding="UTF-8"?>
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns3="http://www.w3.org/1999/xhtml" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="uicontextmenu" xml:lang="en">
    <refnamediv>
        <refname>uicontextmenu</refname>
        <refpurpose>Creates a contextual menu</refpurpose>
    </refnamediv>
    <refsynopsisdiv>
        <title>Syntax</title>
        <synopsis>
            h = uicontextmenu()
        </synopsis>
    </refsynopsisdiv>
    <refsection>
        <title>Description</title>
        <para>
            This function creates an empty contextual menu. The items of the menu can be added as
            children, with <link linkend="uimenu">uimenu</link>.
        </para>
        <para>
            The menu appears on the screen each time that an item is created.
        </para>
        <para>
            It is displayed exactly where the mouse pointer is, even if the pointer is out of any
            Scilab element. If the pointer is out of the computer's screen, the menu is displayed
            on the screen's edge beyond which the pointer is located.
        </para>
        <para>
            It remains at the top level foreground, in front of any Scilab GUI or any external GUI
            of external applications, as long as no mouse button is clicked anywhere, on the menu
            or outside.
        </para>
    </refsection>
    <refsection>
        <title>Example</title>
        <programlisting role="example"><![CDATA[
// Create a context menu
hMenu = uicontextmenu();

// Create the menu items (that may be submenus)
hItem1 = uimenu("Label", "Item1", "Parent", hMenu, "Callback", "disp(""Item1 clicked!"")");
hItem2 = uimenu("Label", "Item2", "Parent", hMenu, "Callback", "disp(""Item2 clicked!"")");
hItem3 = uimenu("Label", "Item3", "Parent", hMenu, "Callback", "disp(""Item3 clicked!"")");
 ]]></programlisting>
    </refsection>
    <refsection role="see also">
        <title>See also</title>
        <simplelist type="inline">
            <member>
                <link linkend="uimenu">uimenu</link>
            </member>
            <member>
                <link linkend="addmenu">addmenu</link>
            </member>
            <member>
                <link linkend="uicontrol">uicontrol</link>
            </member>
        </simplelist>
    </refsection>
</refentry>
