add-prefix-and-suffix.html

/www/tags/NOV_07_2009/htdocs/42docs/users-guide/add-prefix-and-suffix.html

#
HTML | 114 lines | 103 code | 11 blank | 0 comment | 0 complexity | 3c23d419b2d06878fb58a42518318adf MD5 | raw file
Possible License(s): BSD-3-Clause, AGPL-1.0, Apache-2.0, LGPL-2.0, LGPL-3.0, GPL-2.0, CC-BY-SA-3.0, LGPL-2.1, GPL-3.0, MPL-2.0-no-copyleft-exception, IPL-1.0

<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Listing of the Macro</title><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="index.html" title="jEdit 4.2 User's Guide"><link rel="up" href="dialog-macro.html" title="Chapter 14. A Dialog-Based Macro"><link rel="previous" href="dialog-macro-intro.html" title="Use of the Macro"><link rel="next" href="macro-analysis.html" title="Analysis of the Macro"></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">Listing of the Macro</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="dialog-macro-intro.html">Prev</a> </td><th width="60%" align="center">Chapter 14. A Dialog-Based Macro</th><td width="20%" align="right"> <a accesskey="n" href="macro-analysis.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="add-prefix-and-suffix"></a>Listing of the Macro</h2></div></div><div></div></div><p>
    The macro script follows. You can find it in the jEdit
    distribution in the <tt class="filename">Text</tt> subdirectory of the
    <tt class="filename">macros</tt> directory. You can also try it out by invoking
    <span><b class="guimenu">Macros</b></span>&gt;<span><b class="guisubmenu">Text</b></span>&gt;<span><b class="guimenuitem">Add
    Prefix and Suffix</b></span>.
   </p><div class="informalexample"><table border="0" bgcolor="#E0E0E0"><tr><td><pre class="programlisting">// beginning of Add_Prefix_and_Suffix.bsh

<a name="imports"></a>// import statement (see <a href="macro-analysis.html#explain-imports" title="Import Statements">the section called &#8220;Import Statements&#8221;</a>)
import javax.swing.border.*;

<a name="main-routine"></a>// main routine
void prefixSuffixDialog()
{
<a name="create-dialog"></a>    // create dialog object (see <a href="macro-analysis.html#explain-create-dialog" title="Create the Dialog">the section called &#8220;Create the Dialog&#8221;</a>)
    title = &#8220;<span class="quote">Add prefix and suffix to selected lines</span>&#8221;;
    dialog = new JDialog(view, title, false);
    content = new JPanel(new BorderLayout());
    content.setBorder(new EmptyBorder(12, 12, 12, 12));
    content.setPreferredSize(new Dimension(320, 160));
    dialog.setContentPane(content);

<a name="fields-panel"></a>    // add the text fields (see <a href="macro-analysis.html#explain-fields-panel" title="
Create the Text Fields">the section called &#8220;
Create the Text Fields&#8221;</a>)
    fieldPanel = new JPanel(new GridLayout(4, 1, 0, 6));
    prefixField = new HistoryTextField(&#8220;<span class="quote">macro.add-prefix</span>&#8221;);
    prefixLabel = new JLabel(&#8220;<span class="quote">Prefix to add:</span>&#8221;);
    suffixField = new HistoryTextField(&#8220;<span class="quote">macro.add-suffix</span>&#8221;);
    suffixLabel = new JLabel(&#8220;<span class="quote">Suffix to add:</span>&#8221;);
    fieldPanel.add(prefixLabel);
    fieldPanel.add(prefixField);
    fieldPanel.add(suffixLabel);
    fieldPanel.add(suffixField);
    content.add(fieldPanel, &#8220;<span class="quote">Center</span>&#8221;);

<a name="button-panel"></a>    // add a panel containing the buttons (see <a href="macro-analysis.html#explain-button-panel" title="
Create the Buttons">the section called &#8220;
Create the Buttons&#8221;</a>)
    buttonPanel = new JPanel();
    buttonPanel.setLayout(new BoxLayout(buttonPanel,
        BoxLayout.X_AXIS));
    buttonPanel.setBorder(new EmptyBorder(12, 50, 0, 50));
    buttonPanel.add(Box.createGlue());
    ok = new JButton(&#8220;<span class="quote">OK</span>&#8221;);
    cancel = new JButton(&#8220;<span class="quote">Cancel</span>&#8221;);
    ok.setPreferredSize(cancel.getPreferredSize());
    dialog.getRootPane().setDefaultButton(ok);
    buttonPanel.add(ok);
    buttonPanel.add(Box.createHorizontalStrut(6));
    buttonPanel.add(cancel);
    buttonPanel.add(Box.createGlue());
    content.add(buttonPanel, &#8220;<span class="quote">South</span>&#8221;);

<a name="add-listeners"></a>    // register this method as an ActionListener for
    // the buttons and text fields (see <a href="macro-analysis.html#explain-add-listeners" title="Register the Action Listeners">the section called &#8220;Register the Action Listeners&#8221;</a>)
    ok.addActionListener(this);
    cancel.addActionListener(this);
    prefixField.addActionListener(this);
    suffixField.addActionListener(this);

<a name="set-visible"></a>    // locate the dialog in the center of the
    // editing pane and make it visible (see <a href="macro-analysis.html#explain-set-visible" title="Make the Dialog Visible">the section called &#8220;Make the Dialog Visible&#8221;</a>)
    dialog.pack();
    dialog.setLocationRelativeTo(view);
    dialog.setDefaultCloseOperation(JDialog.DISPOSE_ON_CLOSE);
    dialog.setVisible(true);

<a name="action-listener"></a>    // this method will be called when a button is clicked
    // or when ENTER is pressed (see <a href="macro-analysis.html#explain-action-listener" title="The Action Listener">the section called &#8220;The Action Listener&#8221;</a>)
    void actionPerformed(e)
    {
        if(e.getSource() != cancel)
        {
            processText();
        }
        dialog.dispose();
    }

<a name="process-text"></a>    // this is where the work gets done to insert
    // the prefix and suffix (see <a href="macro-analysis.html#explain-process-text" title="Get the User's Input">the section called &#8220;Get the User's Input&#8221;</a>)
    void processText()
    {
        prefix = prefixField.getText();
        suffix = suffixField.getText();
        if(prefix.length() == 0 &amp;&amp; suffix.length() == 0)
            return;
        prefixField.addCurrentToHistory();
        suffixField.addCurrentToHistory();

<a name="jEdit-calls"></a>        // text manipulation begins here using calls
        // to jEdit methods  (see <a href="macro-analysis.html#explain-jedit-calls" title="Call jEdit Methods to Manipulate Text">the section called &#8220;Call jEdit Methods to Manipulate Text&#8221;</a>)
        buffer.beginCompoundEdit();
        selectedLines = textArea.getSelectedLines();
        for(i = 0; i &lt; selectedLines.length; ++i)
        {
            offsetBOL = textArea.getLineStartOffset(
                selectedLines[i]);
            textArea.setCaretPosition(offsetBOL);
            textArea.goToStartOfWhiteSpace(false);
            textArea.goToEndOfWhiteSpace(true);
            text = textArea.getSelectedText();
            if(text == null) text = "";
            textArea.setSelectedText(prefix + text + suffix);
        }
        buffer.endCompoundEdit();
    }
}

<a name="main"></a>// this single line of code is the script's main routine
// (see <a href="macro-analysis.html#explain-main" title="The Main Routine">the section called &#8220;The Main Routine&#8221;</a>)
prefixSuffixDialog();

// end of Add_Prefix_and_Suffix.bsh</pre></td></tr></table></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="dialog-macro-intro.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="dialog-macro.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="macro-analysis.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Use of the Macro </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Analysis of the Macro</td></tr></table></div></body></html>