<?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="textswriter0105060700xml" indexer="include" status="PUBLISH">
<title id="tit" xml-lang="en-US">Macro</title>
<filename>/text/swriter/01/05060700.xhp</filename>
</topic>
<history>
<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created>
</history>
</meta>
<body>
<section id="macro">
<bookmark xml-lang="en-US" branch="hid/cui/ui/eventassignpage/EventAssignPage" id="bm_id9825433" localize="false"/>
<bookmark xml-lang="en-US" branch="hid/cui/ui/eventassignpage/@@nowidget@@" id="bm_id9825433" localize="false"/>
<h1 id="hd_id3145241"><link href="text/swriter/01/05060700.xhp">Macro</link></h1>
<paragraph role="paragraph" id="par_id3158429" xml-lang="en-US"><ahelp hid="cui/ui/eventassignpage/EventAssignPage">Specifies the macro to run when you click an image, frame, or an OLE object.</ahelp></paragraph>
</section>
<section id="howtoget">
  <embed href="text/swriter/00/00000405.xhp#graphics_macro"/>
</section>
<bookmark xml-lang="en-US" branch="hid/cui/ui/eventassignpage/assignments" id="bm_id9825434" localize="false"/>
<h2 id="hd_id3147176">Event</h2>
<paragraph role="paragraph" id="par_id3147564" xml-lang="en-US"><ahelp hid="cui/ui/eventassignpage/assignments">Lists the events that can trigger a macro.</ahelp> Only the events that are relevant to the selected object are listed.</paragraph>
<paragraph role="paragraph" id="par_id3149286" xml-lang="en-US">The following table lists the object types and the events that can trigger a macro:</paragraph>
<table id="tbl_id3151173">
<tablerow>
<tablecell colspan="" rowspan="">
<paragraph role="tablehead" id="par_id3152949" xml-lang="en-US">Event</paragraph>
</tablecell>
<tablecell colspan="" rowspan="">
<paragraph role="tablehead" id="par_id3149808" xml-lang="en-US">Event trigger</paragraph>
</tablecell>
<tablecell colspan="" rowspan="">
<paragraph role="tablehead" id="par_id3152957" xml-lang="en-US">OLE object</paragraph>
</tablecell>
<tablecell colspan="" rowspan="">
<paragraph role="tablehead" id="par_id3154564" xml-lang="en-US">Image</paragraph>
</tablecell>
<tablecell colspan="" rowspan="">
<paragraph role="tablehead" id="par_id3153675" xml-lang="en-US">Frame</paragraph>
</tablecell>
<tablecell colspan="" rowspan="">
<paragraph role="tablehead" id="par_id3154473" xml-lang="en-US">AutoText</paragraph>
</tablecell>
<tablecell colspan="" rowspan="">
<paragraph role="tablehead" id="par_id3149684" xml-lang="en-US">ImageMap area</paragraph>
</tablecell>
<tablecell colspan="" rowspan="">
<paragraph role="tablehead" id="par_id3154197" xml-lang="en-US">Hyperlink</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell colspan="" rowspan="">
<paragraph role="tablecontent" id="par_id3155182" xml-lang="en-US">Click object</paragraph>
</tablecell>
<tablecell colspan="" rowspan="">
<paragraph role="tablecontent" id="par_id3149489" xml-lang="en-US">object is selected</paragraph>
</tablecell>
<tablecell colspan="" rowspan="">
<paragraph role="tablecontent" id="par_id3151249" xml-lang="en-US" localize="false">✓</paragraph>
</tablecell>
<tablecell colspan="" rowspan="">
<paragraph role="tablecontent" id="par_id3149104" xml-lang="en-US" localize="false">✓</paragraph>
</tablecell>
<tablecell colspan="" rowspan="">
<paragraph role="tablecontent" id="par_id3147089" xml-lang="en-US" localize="false">✓</paragraph>
</tablecell>
<tablecell colspan="" rowspan="">
</tablecell>
<tablecell colspan="" rowspan="">
</tablecell>
<tablecell colspan="" rowspan="">
</tablecell>
</tablerow>
<tablerow>
<tablecell colspan="" rowspan="">
<paragraph role="tablecontent" id="par_id3153637" xml-lang="en-US">Mouse over object</paragraph>
</tablecell>
<tablecell colspan="" rowspan="">
<paragraph role="tablecontent" id="par_id3147579" xml-lang="en-US">mouse pointer moves over the object</paragraph>
</tablecell>
<tablecell colspan="" rowspan="">
<paragraph role="tablecontent" id="par_id3152779" xml-lang="en-US" localize="false">✓</paragraph>
</tablecell>
<tablecell colspan="" rowspan="">
<paragraph role="tablecontent" id="par_id3153349" xml-lang="en-US" localize="false">✓</paragraph>
</tablecell>
<tablecell colspan="" rowspan="">
<paragraph role="tablecontent" id="par_id3149174" xml-lang="en-US" localize="false">✓</paragraph>
</tablecell>
<tablecell colspan="" rowspan="">
</tablecell>
<tablecell colspan="" rowspan="">
<paragraph role="tablecontent" id="par_id3151031" xml-lang="en-US" localize="false">✓</paragraph>
</tablecell>
<tablecell colspan="" rowspan="">
<paragraph role="tablecontent" id="par_id3145784" xml-lang="en-US" localize="false">✓</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell colspan="" rowspan="">
<paragraph role="tablecontent" id="par_id3155910" xml-lang="en-US">Trigger Hyperlink</paragraph>
</tablecell>
<tablecell colspan="" rowspan="">
<paragraph role="tablecontent" id="par_id3155857" xml-lang="en-US">hyperlink that is assigned to the object is clicked</paragraph>
</tablecell>
<tablecell colspan="" rowspan="">
<paragraph role="tablecontent" id="par_id3150693" xml-lang="en-US" localize="false">✓</paragraph>
</tablecell>
<tablecell colspan="" rowspan="">
<paragraph role="tablecontent" id="par_id3147423" xml-lang="en-US" localize="false">✓</paragraph>
</tablecell>
<tablecell colspan="" rowspan="">
<paragraph role="tablecontent" id="par_id3145256" xml-lang="en-US" localize="false">✓</paragraph>
</tablecell>
<tablecell colspan="" rowspan="">
</tablecell>
<tablecell colspan="" rowspan="">
</tablecell>
<tablecell colspan="" rowspan="">
<paragraph role="tablecontent" id="par_id3149554" xml-lang="en-US" localize="false">✓</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell colspan="" rowspan="">
<paragraph role="tablecontent" id="par_id3155976" xml-lang="en-US">Mouse leaves object </paragraph>
</tablecell>
<tablecell colspan="" rowspan="">
<paragraph role="tablecontent" id="par_id3149216" xml-lang="en-US">mouse pointer moves off the object</paragraph>
</tablecell>
<tablecell colspan="" rowspan="">
<paragraph role="tablecontent" id="par_id3147739" xml-lang="en-US" localize="false">✓</paragraph>
</tablecell>
<tablecell colspan="" rowspan="">
<paragraph role="tablecontent" id="par_id3146336" xml-lang="en-US" localize="false">✓</paragraph>
</tablecell>
<tablecell colspan="" rowspan="">
<paragraph role="tablecontent" id="par_id3149841" xml-lang="en-US" localize="false">✓</paragraph>
</tablecell>
<tablecell colspan="" rowspan="">
</tablecell>
<tablecell colspan="" rowspan="">
<paragraph role="tablecontent" id="par_id3148436" xml-lang="en-US" localize="false">✓</paragraph>
</tablecell>
<tablecell colspan="" rowspan="">
<paragraph role="tablecontent" id="par_id3151082" xml-lang="en-US" localize="false">✓</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell colspan="" rowspan="">
<paragraph role="tablecontent" id="par_id3154780" xml-lang="en-US">Image loaded successfully</paragraph>
</tablecell>
<tablecell colspan="" rowspan="">
<paragraph role="tablecontent" id="par_id3145304" xml-lang="en-US">image is loaded successfully</paragraph>
</tablecell>
<tablecell colspan="" rowspan="">
</tablecell>
<tablecell colspan="" rowspan="">
<paragraph role="tablecontent" id="par_id3150169" xml-lang="en-US" localize="false">✓</paragraph>
</tablecell>
<tablecell colspan="" rowspan="">
</tablecell>
<tablecell colspan="" rowspan="">
</tablecell>
<tablecell colspan="" rowspan="">
</tablecell>
<tablecell colspan="" rowspan="">
</tablecell>
</tablerow>
<tablerow>
<tablecell colspan="" rowspan="">
<paragraph role="tablecontent" id="par_id3154718" xml-lang="en-US">Image loading terminated</paragraph>
</tablecell>
<tablecell colspan="" rowspan="">
<paragraph role="tablecontent" id="par_id3156136" xml-lang="en-US">loading of the image is terminated by the user (for example, when downloading)</paragraph>
</tablecell>
<tablecell colspan="" rowspan="">
</tablecell>
<tablecell colspan="" rowspan="">
<paragraph role="tablecontent" id="par_id3156105" xml-lang="en-US" localize="false">✓</paragraph>
</tablecell>
<tablecell colspan="" rowspan="">
</tablecell>
<tablecell colspan="" rowspan="">
</tablecell>
<tablecell colspan="" rowspan="">
</tablecell>
<tablecell colspan="" rowspan="">
</tablecell>
</tablerow>
<tablerow>
<tablecell colspan="" rowspan="">
<paragraph role="tablecontent" id="par_id3155079" xml-lang="en-US">Could not load image</paragraph>
</tablecell>
<tablecell colspan="" rowspan="">
<paragraph role="tablecontent" id="par_id3149250" xml-lang="en-US">image is not successfully loaded</paragraph>
</tablecell>
<tablecell colspan="" rowspan="">
</tablecell>
<tablecell colspan="" rowspan="">
<paragraph role="tablecontent" id="par_id3154327" xml-lang="en-US" localize="false">✓</paragraph>
</tablecell>
<tablecell colspan="" rowspan="">
</tablecell>
<tablecell colspan="" rowspan="">
</tablecell>
<tablecell colspan="" rowspan="">
</tablecell>
<tablecell colspan="" rowspan="">
</tablecell>
</tablerow>
<tablerow>
<tablecell colspan="" rowspan="">
<paragraph role="tablecontent" id="par_id3148779" xml-lang="en-US">Input of alpha characters </paragraph>
</tablecell>
<tablecell colspan="" rowspan="">
<paragraph role="tablecontent" id="par_id3150030" xml-lang="en-US">text is inputted</paragraph>
</tablecell>
<tablecell colspan="" rowspan="">
</tablecell>
<tablecell colspan="" rowspan="">
</tablecell>
<tablecell colspan="" rowspan="">
<paragraph role="tablecontent" id="par_id3155792" xml-lang="en-US" localize="false">✓</paragraph>
</tablecell>
<tablecell colspan="" rowspan="">
</tablecell>
<tablecell colspan="" rowspan="">
</tablecell>
<tablecell colspan="" rowspan="">
</tablecell>
</tablerow>
<tablerow>
<tablecell colspan="" rowspan="">
<paragraph role="tablecontent" id="par_id3154623" xml-lang="en-US">Input of non-alpha characters </paragraph>
</tablecell>
<tablecell colspan="" rowspan="">
<paragraph role="tablecontent" id="par_id3147391" xml-lang="en-US">Nonprinting characters, such as tabs and line breaks, are entered</paragraph>
</tablecell>
<tablecell colspan="" rowspan="">
</tablecell>
<tablecell colspan="" rowspan="">
</tablecell>
<tablecell colspan="" rowspan="">
<paragraph role="tablecontent" id="par_id3150666" xml-lang="en-US" localize="false">✓</paragraph>
</tablecell>
<tablecell colspan="" rowspan="">
</tablecell>
<tablecell colspan="" rowspan="">
</tablecell>
<tablecell colspan="" rowspan="">
</tablecell>
</tablerow>
<tablerow>
<tablecell colspan="" rowspan="">
<paragraph role="tablecontent" id="par_id3149963" xml-lang="en-US">Resize frame</paragraph>
</tablecell>
<tablecell colspan="" rowspan="">
<paragraph role="tablecontent" id="par_id3147284" xml-lang="en-US">frame is resized</paragraph>
</tablecell>
<tablecell colspan="" rowspan="">
</tablecell>
<tablecell colspan="" rowspan="">
</tablecell>
<tablecell colspan="" rowspan="">
<paragraph role="tablecontent" id="par_id3150774" xml-lang="en-US" localize="false">✓</paragraph>
</tablecell>
<tablecell colspan="" rowspan="">
</tablecell>
<tablecell colspan="" rowspan="">
</tablecell>
<tablecell colspan="" rowspan="">
</tablecell>
</tablerow>
<tablerow>
<tablecell colspan="" rowspan="">
<paragraph role="tablecontent" id="par_id3148713" xml-lang="en-US">Move frame</paragraph>
</tablecell>
<tablecell colspan="" rowspan="">
<paragraph role="tablecontent" id="par_id3155349" xml-lang="en-US">frame is moved</paragraph>
</tablecell>
<tablecell colspan="" rowspan="">
</tablecell>
<tablecell colspan="" rowspan="">
</tablecell>
<tablecell colspan="" rowspan="">
<paragraph role="tablecontent" id="par_id3155553" xml-lang="en-US" localize="false">✓</paragraph>
</tablecell>
<tablecell colspan="" rowspan="">
</tablecell>
<tablecell colspan="" rowspan="">
</tablecell>
<tablecell colspan="" rowspan="">
</tablecell>
</tablerow>
<tablerow>
<tablecell colspan="" rowspan="">
<paragraph role="tablecontent" id="par_id3154227" xml-lang="en-US">Before inserting AutoText</paragraph>
</tablecell>
<tablecell colspan="" rowspan="">
<paragraph role="tablecontent" id="par_id3155785" xml-lang="en-US">before AutoText is inserted</paragraph>
</tablecell>
<tablecell colspan="" rowspan="">
</tablecell>
<tablecell colspan="" rowspan="">
</tablecell>
<tablecell colspan="" rowspan="">
</tablecell>
<tablecell colspan="" rowspan="">
<paragraph role="tablecontent" id="par_id3145292" xml-lang="en-US" localize="false">✓</paragraph>
</tablecell>
<tablecell colspan="" rowspan="">
</tablecell>
<tablecell colspan="" rowspan="">
</tablecell>
</tablerow>
<tablerow>
<tablecell colspan="" rowspan="">
<paragraph role="tablecontent" id="par_id3145096" xml-lang="en-US">After inserting AutoText</paragraph>
</tablecell>
<tablecell colspan="" rowspan="">
<paragraph role="tablecontent" id="par_id3149577" xml-lang="en-US">after AutoText is inserted</paragraph>
</tablecell>
<tablecell colspan="" rowspan="">
</tablecell>
<tablecell colspan="" rowspan="">
</tablecell>
<tablecell colspan="" rowspan="">
</tablecell>
<tablecell colspan="" rowspan="">
<paragraph role="tablecontent" id="par_id3156237" xml-lang="en-US" localize="false">✓</paragraph>
</tablecell>
<tablecell colspan="" rowspan="">
</tablecell>
<tablecell colspan="" rowspan="">
</tablecell>
</tablerow>
</table>

<paragraph role="note" id="par_id3159203" xml-lang="en-US">For events that are linked to controls in forms, see <link href="text/shared/02/01170103.xhp">Control properties</link> or <link href="text/shared/02/01170202.xhp">Form properties</link>.</paragraph>
<h2 id="hd_id3156030">Assigned Action</h2>
<paragraph role="paragraph" id="par_id3156043" xml-lang="en-US">Specify the macro that executes when the selected event occurs.</paragraph>
<paragraph role="paragraph" id="par_id3156058" xml-lang="en-US">Frames allow you to link certain events to a function that then decides if the event is handled by $[officename] Writer or by the function. See the $[officename] Basic Help for more information.</paragraph>
<bookmark xml-lang="en-US" branch="hid/cui/ui/eventassignpage/libraries" id="bm_id4656819" localize="false"/>
<h3 id="hd_id3149271">Macro From</h3>
<paragraph role="paragraph" id="par_id3149284" xml-lang="en-US"><ahelp hid="cui/ui/eventassignpage/libraries">Lists the $[officename] program and any open $[officename] document.</ahelp> Within this list, select the location where you want to pick the macro from.</paragraph>
<bookmark xml-lang="en-US" branch="hid/cui/ui/eventassignpage/macros" id="bm_id3767815" localize="false"/>
<h3 id="hd_id3156441">Existing Macros</h3>
<paragraph role="paragraph" id="par_id3148458" xml-lang="en-US"><ahelp hid="cui/ui/eventassignpage/macros">Lists the available macros. Select the macro that you want to assign to the selected event, and then click <emph>Assign</emph>.</ahelp></paragraph>
<bookmark xml-lang="en-US" branch="hid/cui/ui/eventassignpage/assign" id="bm_id3767816" localize="false"/>
<h2 id="hd_id3145173">Assign</h2>
<paragraph role="paragraph" id="par_id3145197" xml-lang="en-US"><ahelp hid="cui/ui/eventassignpage/assign">Assigns the selected macro to the selected event.</ahelp></paragraph>
<bookmark xml-lang="en-US" branch="hid/cui/ui/eventassignpage/delete" id="bm_id3767817" localize="false"/>
<h2 id="hd_id3150811">Remove</h2>
<paragraph role="paragraph" id="par_id3150882" xml-lang="en-US"><variable id="aufheb"><ahelp hid="cui/ui/eventassignpage/delete">Removes the macro assignment from the selected entry.</ahelp>
</variable></paragraph>
</body>
</helpdocument>