summaryrefslogtreecommitdiff
path: root/modules/gui/help/en_US/clipboard.xml
blob: 5958a46efd6ea7877e737ee8b50a60a49163e3fc (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
<?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:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="en" xml:id="clipboard">
    <refnamediv>
        <refname>clipboard</refname>
        <refpurpose>Copy and paste strings to and from the system clipboard.</refpurpose>
    </refnamediv>
    <refsynopsisdiv>
        <title>Calling Sequence</title>
        <synopsis>
            clipboard("copy",data)
            str=clipboard("paste")
            clipboard("do","paste")
            clipboard("do","copy")
            clipboard("do","empty")
            clipboard(winnum,"EMF")
            clipboard(winnum,"DIB")
        </synopsis>
    </refsynopsisdiv>
    <refsection>
        <title>Arguments</title>
        <variablelist>
            <varlistentry>
                <term>data</term>
                <listitem>
                    <para>Scilab variable or data to set as the clipboard contents.</para>
                </listitem>
            </varlistentry>
            <varlistentry>
                <term>str</term>
                <listitem>
                    <para>The clipboard contents returned as a Scilab character string.</para>
                </listitem>
            </varlistentry>
            <varlistentry>
                <term>winnum</term>
                <listitem>
                    <para>Number of the graphic window to set as the clipboard contents.</para>
                </listitem>
            </varlistentry>
        </variablelist>
    </refsection>
    <refsection>
        <title>Description</title>
        <para>
            <literal>clipboard("copy",data)</literal> sets the clipboard contents to
            data. If data is not a character array, the clipboard uses <literal>sci2exp</literal> to
            convert it to a string.
        </para>
        <para>
            <literal>str = clipboard("paste")</literal> returns the current contents of
            the clipboard as a string or as an empty string (""), if the current
            clipboard contents cannot be converted to a string.
        </para>
        <para>
            <literal>clipboard("do","paste")</literal>,
            <literal>clipboard("do","copy")</literal>, <literal>clipboard("do","empty")</literal>
            performs a paste, copy or empty clipboard.
        </para>
        <para>
            <literal>clipboard(winnum,"EMF")</literal> copy a graphic window identified by his window's number in the clipboard to EMF format.
        </para>
        <para>
            <literal>clipboard(winnum,"DIB")</literal> copy a graphic window identified by his window's number in the clipboard to DIB format.
        </para>
        <para>
            Note that <literal>clipboard</literal> function works only when Scilab used in window mode.
        </para>
    </refsection>
</refentry>