<?xml version="1.0" encoding="UTF-8"?>
<!--
* This file is part of the LibreOffice project.
*
* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
* file, You can obtain one at http://mozilla.org/MPL/2.0/.
*
* This file incorporates work covered by the following license notice:
*
*   Licensed to the Apache Software Foundation (ASF) under one or more
*   contributor license agreements. See the NOTICE file distributed
*   with this work for additional information regarding copyright
*   ownership. The ASF licenses this file to you under the Apache
*   License, Version 2.0 (the "License"); you may not use this file
*   except in compliance with the License. You may obtain a copy of
*   the License at http://www.apache.org/licenses/LICENSE-2.0 .
-->

<helpdocument version="1.0">
    <meta>
        <topic id="textsharedguidemacro_recordingxml" indexer="include" status="PUBLISH">
            <title id="tit" xml-lang="en-US">Recording a Macro</title>
            <filename>/text/shared/guide/macro_recording.xhp</filename>
        </topic>
    </meta>
    <body>
    <bookmark xml-lang="en-US" branch="index" id="bm_id3093440">
        <bookmark_value>macros; recording</bookmark_value>
        <bookmark_value>recording; macros</bookmark_value>
        <bookmark_value>Basic; recording macros</bookmark_value>
    </bookmark>
    <paragraph role="heading" id="hd_id3093440" xml-lang="en-US" level="1"><variable id="macro_recording"><link href="text/shared/guide/macro_recording.xhp">Recording a Macro</link>
            </variable></paragraph>
    <paragraph xml-lang="en-US" id="par_id101513461219184" role="paragraph">%PRODUCTNAME can record commands executed with the keyboard and mouse in Writer and Calc</paragraph>
    <list type="ordered">
        <listitem>
            <paragraph role="listitem" id="par_id3154749" xml-lang="en-US">Open the document for which you want to record a macro.</paragraph>
        </listitem>
        <listitem>
            <paragraph role="listitem" id="par_id3149398" xml-lang="en-US">Choose <emph>Tools - Macros - Record Macro</emph>.</paragraph>
            <paragraph role="note" id="par_id3149399" xml-lang="en-US">If <emph>Tools - Macros - Record Macro</emph> menu item is missing, make sure that macro recording feature is enabled in <switchinline select="sys"><caseinline select="MAC"><emph>%PRODUCTNAME - Preferences</emph></caseinline><defaultinline><emph>Tools - Options</emph></defaultinline></switchinline><emph> - %PRODUCTNAME - Advanced</emph>.</paragraph>
            <paragraph role="listitem" id="par_id3150275" xml-lang="en-US">You see the small <emph>Recording</emph> dialog with just one button called <emph>Stop Recording</emph>.</paragraph>
        </listitem>
        <listitem>
            <paragraph role="listitem" id="par_id3153087" xml-lang="en-US">Perform the actions you want to be recorded in the document.</paragraph>
            <paragraph role="listitem" id="par_id3150504" xml-lang="en-US">Press the Escape key to deselect an object, as the macro recorder currently does not record this action by mouse click.</paragraph>
        </listitem>
        <listitem>
            <paragraph role="listitem" id="par_id3148492" xml-lang="en-US">Click <emph>Stop Recording</emph>.</paragraph>
            <paragraph role="listitem" id="par_id3148686" xml-lang="en-US">The <emph>Macro</emph> dialog appears, in which you can save and run the macro.</paragraph>
            <paragraph role="listitem" id="par_id3159158" xml-lang="en-US">If you want to abort the recording without saving a macro, click the <emph>Close</emph> button of the <emph>Recording</emph> dialog.</paragraph>
        </listitem>
        <listitem>
            <paragraph role="listitem" id="par_id3144510" xml-lang="en-US">To save the macro, first select the object where you want the macro to be saved in the <emph>Save macro in</emph> list box.</paragraph>
        </listitem>
        <listitem>
            <paragraph role="listitem" id="par_id3148550" xml-lang="en-US">If you want the macro to be saved into a new library or module, click the <emph>New Library </emph>or <emph>New Module </emph>button and enter a name for the library or module.</paragraph>
        </listitem>
        <listitem>
            <paragraph role="listitem" id="par_id3149456" xml-lang="en-US">Enter a name for the new macro in the <emph>Macro name</emph> text box. Do not use Basic keywords as a name.</paragraph>
        </listitem>
        <listitem>
            <paragraph role="listitem" id="par_id3154138" xml-lang="en-US">Click <emph>Save</emph>.</paragraph>
        </listitem>
    </list>
    <bookmark xml-lang="en-US" branch="index" id="bm_id131513460596344">
        <bookmark_value>macro recording;limitations</bookmark_value>
    </bookmark>
    <h2 id="hd_id2486342">Limitations of the macro recorder</h2>
    <paragraph role="paragraph" id="par_id3608508" xml-lang="en-US">The following actions are <emph>not</emph> recorded:</paragraph>
    <list type="unordered">
        <listitem>
            <paragraph role="paragraph" id="par_id921353" xml-lang="en-US">Opening of windows is not recorded.</paragraph>
        </listitem>
        <listitem>
            <paragraph role="paragraph" id="par_id9296243" xml-lang="en-US">Actions carried out in another window than where the recorder was started are not recorded.</paragraph>
        </listitem>
        <listitem>
            <paragraph role="paragraph" id="par_id4269234" xml-lang="en-US">Window switching is not recorded.</paragraph>
        </listitem>
        <listitem>
            <paragraph role="paragraph" id="par_id8014465" xml-lang="en-US">Actions that are not related to the document contents are not recorded. For example, changes made in the Options dialog, macro organizer, customizing.</paragraph>
        </listitem>
        <listitem>
            <paragraph role="paragraph" id="par_id2814416" xml-lang="en-US">Selections are recorded only if they are done by using the keyboard (cursor traveling), but not when the mouse is used.</paragraph>
        </listitem>
        <listitem>
            <paragraph role="paragraph" id="par_id2522354" xml-lang="en-US">The macro recorder works only in Calc and Writer.</paragraph>
        </listitem>
    </list>
    <section id="relatedtopics">
        <paragraph role="paragraph" id="par_id3156422" xml-lang="en-US"><link href="text/shared/01/06130000.xhp">Macro</link></paragraph>
    </section>
</body>
</helpdocument>
