PageRenderTime 85ms CodeModel.GetById 70ms app.highlight 11ms RepoModel.GetById 1ms app.codeStats 0ms

/www/tags/NOV_07_2009/htdocs/users-guide/text-transfer.html

#
HTML | 94 lines | 94 code | 0 blank | 0 comment | 0 complexity | 8e466216ae33f624b77007f8dbe30053 MD5 | raw file
 1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Transferring Text</title><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"><link rel="start" href="index.html" title="jEdit 4.3 User's Guide"><link rel="up" href="editing.html" title="Chapter 5. Editing Text"><link rel="prev" href="scrolling.html" title="Scrolling"><link rel="next" href="markers.html" title="Markers"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Transferring Text</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="scrolling.html">Prev</a> </td><th width="60%" align="center">Chapter 5. Editing Text</th><td width="20%" align="right"> <a accesskey="n" href="markers.html">Next</a></td></tr></table><hr></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="text-transfer"></a>Transferring Text</h2></div></div></div><p>jEdit provides a rich set of commands for moving and copying text.
 2        Commands are provided for moving chunks of text from buffers to
 3        <em class="firstterm">registers</em> and vice-versa. A register is a holding
 4        area for an arbitrary length of text, with a single-character name. Most
 5        other programs can only transfer text to and from the system clipboard;
 6        in jEdit, the system clipboard is just another register, with the
 7        special name <code class="filename">$</code>.</p><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557096"></a>The Clipboard</h3></div></div></div><p>jEdit offers the usual text transfer operations, that operate
 8            on the <code class="filename">$</code> register.</p><p><span class="guimenu"><strong>Edit</strong></span>&gt;<span class="guimenuitem"><strong>Cut</strong></span>
 9            (shortcut: <code class="keycap">C+x</code>) places the selected text in the
10            clipboard and removes it from the buffer.</p><p><span class="guimenu"><strong>Edit</strong></span>&gt;<span class="guimenuitem"><strong>Copy</strong></span>
11            (shortcut: <code class="keycap">C+c</code>) places the selected text in the
12            clipboard and leaves it in the buffer.</p><p><span class="guimenu"><strong>Edit</strong></span>&gt;<span class="guimenuitem"><strong>Paste</strong></span>
13            (shortcut: <code class="keycap">C+v</code>) inserts the clipboard contents in
14            place of the selection (or at the caret position, if there is no
15            selection).</p><p>The <span class="guimenuitem"><strong>Cut</strong></span> and
16            <span class="guimenuitem"><strong>Copy</strong></span> commands replace the old clipboard
17            contents with the selected text. There are two alternative commands
18            which add the selection at the end of the existing clipboard
19            contents, instead of replacing it.</p><p><span class="guimenu"><strong>Edit</strong></span>&gt;<span class="guisubmenu"><strong>More
20            Clipboard</strong></span>&gt;<span class="guimenuitem"><strong>Cut Append</strong></span>
21            (shortcut: <code class="keycap">C+e C+u</code>) appends the selected text to
22            the clipboard, then removes it from the buffer. After this command
23            has been invoked, the clipboard will consist of the former clipboard
24            contents, followed by a newline, followed by the selected
25            text.</p><p><span class="guimenu"><strong>Edit</strong></span>&gt;<span class="guisubmenu"><strong>More
26            Clipboard</strong></span>&gt;<span class="guimenuitem"><strong>Copy Append</strong></span>
27            (shortcut: <code class="keycap">C+e C+a</code>) is the same as <span class="guimenuitem"><strong>Cut
28            Append</strong></span> except it does not remove the selection from
29            the buffer.</p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="quick-copy"></a>Quick Copy</h3></div></div></div><p>The quick copy feature is usually found in Unix text editors.
30            Quick copy is disabled by default, but it can be enabled in the
31            <span class="guibutton"><strong>Mouse</strong></span> pane of the
32            <span class="guimenu"><strong>Utilities</strong></span>&gt;<span class="guimenuitem"><strong>Global
33            Options</strong></span> dialog box.</p><p>The quick copy feature is accessed using the middle mouse
34            button. If you do not have a three-button mouse, then either
35            <code class="keycap">Alt</code>-click (on Windows and Unix) or
36            <code class="keycap">Option</code>-click (on MacOS X). The quick copy feature
37            enables the following behavior:</p><div class="itemizedlist"><ul type="disc"><li><p>Clicking the middle mouse button in the text area
38                    inserts the most recently selected text at the clicked
39                    location. If you only have a two-button mouse, you can click
40                    the left mouse button while holding down
41                    <code class="keycap">Alt</code> instead of middle-clicking.</p></li><li><p>Dragging with the middle mouse button creates a
42                    selection without moving the caret. As soon as the mouse
43                    button is released, the selected text is inserted at the
44                    caret position and the selection is deactivated. A message
45                    is shown in the status bar while text is being selected to
46                    remind you that this is not an ordinary selection.</p></li><li><p>Holding down <code class="keycap">Shift</code> while clicking the
47                    middle mouse button will duplicate text between the caret
48                    and the clicked location.</p></li><li><p>Holding down <code class="keycap">Control</code> while clicking
49                    the middle mouse button on a bracket will insert all text in
50                    that bracket's scope at the caret position.</p></li></ul></div><p>The most recently selected text is stored in the
51            <code class="filename">%</code> register.</p><p>If jEdit is being run under Java 2 version 1.4 on Unix, you
52            will be able to transfer text with other X Windows applications
53            using the quick copy feature. On other platforms and Java versions,
54            the contents of the quick copy register are only accessible from
55            within jEdit.</p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="registers"></a>General Register Commands</h3></div></div></div><p>These commands require more keystrokes than the two methods
56            shown above, but they can operate on any register, allowing an
57            arbitrary number of text chunks to be retained at a time.</p><p>Each command prompts for a single-character register name to
58            be entered after being invoked. Pressing <code class="keycap">ESCAPE</code>
59            instead of specifying a register name cancels the operation.</p><p>Note that the content of registers other than the clipboard
60            and quick copy register are automatically saved between jEdit
61            sessions.</p><p><span class="guimenu"><strong>Edit</strong></span>&gt;<span class="guisubmenu"><strong>More
62            Clipboard</strong></span>&gt;<span class="guimenuitem"><strong>Cut to Register</strong></span>
63            (shortcut: <code class="keycap">C+r C+x <em class="replaceable"><code>key</code></em></code>)
64            stores the selected text in the specified register, removing it from
65            the buffer.</p><p><span class="guimenu"><strong>Edit</strong></span>&gt;<span class="guisubmenu"><strong>More
66            Clipboard</strong></span>&gt;<span class="guimenuitem"><strong>Copy to
67            Register</strong></span> (shortcut: <code class="keycap">C+r C+c
68            <em class="replaceable"><code>key</code></em></code>) stores the selected text in
69            the specified register, leaving it in the buffer.</p><p><span class="guimenu"><strong>Edit</strong></span>&gt;<span class="guisubmenu"><strong>More
70            Clipboard</strong></span>&gt;<span class="guimenuitem"><strong>Cut Append to
71            Register</strong></span> (shortcut: <code class="keycap">C+r C+u
72            <em class="replaceable"><code>key</code></em></code>) adds the selected text to
73            the existing contents of the specified register, and removes it from
74            the buffer.</p><p><span class="guimenu"><strong>Edit</strong></span>&gt;<span class="guisubmenu"><strong>More
75            Clipboard</strong></span>&gt;<span class="guimenuitem"><strong>Copy Append to
76            Register</strong></span> (shortcut: <code class="keycap">C+r C+a
77            <em class="replaceable"><code>key</code></em></code>) adds the selected text to
78            the existing contents of the specified register, without removing it
79            from the buffer.</p><p><span class="guimenu"><strong>Edit</strong></span>&gt;<span class="guisubmenu"><strong>More
80            Clipboard</strong></span>&gt;<span class="guimenuitem"><strong>Paste from
81            Register</strong></span> (shortcut: <code class="keycap">C+r C+v
82            <em class="replaceable"><code>key</code></em></code>) replaces the selection with
83            the contents of the specified register.</p><p>The following three commands display dialog boxes instead of
84            prompting for a register name.</p><p><span class="guimenu"><strong>Edit</strong></span>&gt;<span class="guisubmenu"><strong>More
85            Clipboard</strong></span>&gt;<span class="guimenuitem"><strong>Paste Previous</strong></span>
86            (shortcut: <code class="keycap">C+e C+v</code>) displays a dialog box listing
87            the 20 most recently copied and pasted text strings.</p><p><span class="guimenu"><strong>Edit</strong></span>&gt;<span class="guisubmenu"><strong>More
88            Clipboard</strong></span>&gt;<span class="guimenuitem"><strong>Paste Deleted</strong></span>
89            (shortcut: <code class="keycap">C+e C+y</code>) is not really a register
90            command; it displays a dialog box listing the 20 most recently
91            deleted text strings.</p><p><span class="guimenu"><strong>Edit</strong></span>&gt;<span class="guisubmenu"><strong>More
92            Clipboard</strong></span>&gt;<span class="guimenuitem"><strong>View Registers</strong></span>
93            displays a dialog box for viewing register contents, including the
94            clipboard and the quick copy.</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="scrolling.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="editing.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="markers.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Scrolling </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Markers</td></tr></table></div></body></html>