<?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>