summaryrefslogtreecommitdiff
path: root/modules/gui/help/en_US/loadGui.xml
blob: 606b86e161e21559aa106d69a85befba77991a6c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
<?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="loadGui" xml:lang="en">
    <refnamediv>
        <refname>loadGui</refname>
        <refpurpose>Load a graphic user interface from a saved file</refpurpose>
    </refnamediv>
    <refsynopsisdiv>
        <title>Calling Sequence</title>
        <synopsis>loadGui(filename)</synopsis>
    </refsynopsisdiv>
    <refsection>
        <title>Arguments</title>
        <variablelist>
            <varlistentry>
                <term>filename</term>
                <listitem>
                    <para>character string containing the path of the file</para>
                </listitem>
            </varlistentry>
        </variablelist>
    </refsection>
    <refsection>
        <title>Description</title>
        <para>
            The <literal>loadGui</literal> function can be used to load in the
            Scilab session a graphic user interface previously saved in a file with the
            <literal>
                <link linkend="saveGui">saveGui</link>
            </literal>
            function.
        </para>
        <para>
            <literal>loadGui(filename)</literal> loads an interface saved in file
            given by its path <literal>filename</literal>.
        </para>
    </refsection>
    <refsection>
        <title>Examples</title>
        <programlisting role="example"><![CDATA[ 
// First example
f = figure("background", -2);
h = uicontrol(f, "style", "text", ...
              "string", "This is a figure", ...
              "position", [210 180 300 100], ...
              "fontsize", 24, ...
              "backgroundcolor", [1 1 1]);

saveGui(f, fullfile(TMPDIR, "foo"))
close(f)
loadGui(fullfile(TMPDIR, "foo"));

// Second example
f = figure("default_axes", "off", ...
           "dockable", "off", ...
           "figure_name", "Sélection", ...
           "axes_size", [200 200], ...
           "infobar_visible", "off", ...
           "menubar_visible", "off", ...
           "toolbar", "none", ...
           "toolbar_visible", "off", ...
           "layout", "gridbag");
           
h1 = uicontrol(f, "style", "text", ...
                "string", "Following List :", ...
                "fontsize", 15, ...
                "constraints", createConstraints("gridbag", [1 1 2 1], [1 0], "both"));
                
h2 = uicontrol(f, "style", "popupmenu", ...
                "string", ["item1"; "item2"; "item3"], ...
                "value", 1, ...
                "fontsize", 15, ...
                "constraints", createConstraints("gridbag", [1 2 2 1], [1 0], "both"), ...
                "tag", "selection");
                
h3 = uicontrol(f, "style", "pushbutton", ...
                "string", "OK", ...
                "callback", "obj = findobj(""tag"", ""selection""); mprintf(""La valeur sélectionnée est : %s.\n"", obj.string(obj.value)); close(gcf())", ...
                "fontsize", 15, ...
                "constraints", createConstraints("gridbag", [1 3 1 1], [1 0], "both", "left"));
                
h4 = uicontrol(f, "style", "pushbutton", ...
                "string", "CANCEL", ...
                "callback", "close(gcf())", ...
                "fontsize", 15, ...
                "constraints", createConstraints("gridbag", [2 3 1 1], [1 0], "both", "right"));
                
saveGui(f, "TMPDIR/foo2.xml");
close(f)
loadGui("TMPDIR/foo2.xml")


 ]]></programlisting>
    </refsection>
    <refsection role="see also">
        <title>See Also</title>
        <simplelist type="inline">
            <member>
                <link linkend="saveGui">saveGui</link>
            </member>
            <member>
                <link linkend="load">load</link>
            </member>
            <member>
                <link linkend="save">save</link>
            </member>
        </simplelist>
    </refsection>
    <refsection>
        <title>History</title>
        <revhistory>
            <revision>
                <revnumber>5.5.0</revnumber>
                <revremark>
                    Function <function>loadGui</function> introduced.
                </revremark>
            </revision>
        </revhistory>
    </refsection>
</refentry>