<?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="textsbasicshared05060700xml" indexer="include" status="PUBLISH"> <title id="tit" xml-lang="en-US">Macro</title> <filename>/text/sbasic/shared/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="index" id="bm_id3153894"><bookmark_value>events;linked to objects</bookmark_value> </bookmark> <paragraph role="heading" id="hd_id3153894" xml-lang="en-US" level="1"><link href="text/sbasic/shared/05060700.xhp" name="Macro">Macro</link></paragraph> <paragraph role="paragraph" id="par_id3153748" xml-lang="en-US"><ahelp hid=".">Choose the macro that you want to execute when the selected graphic, frame, or OLE object is selected.</ahelp> Depending on the object that is selected, the function is either found on the <emph>Macro</emph> tab of the <emph>Object</emph> dialog, or in the <emph>Assign Macro</emph> dialog.</paragraph> </section> <paragraph role="heading" id="hd_id3150503" xml-lang="en-US" level="2">Event</paragraph> <paragraph role="paragraph" id="par_id3149763" xml-lang="en-US"><ahelp hid="cui/ui/eventassignpage/assignments">Lists the events that are relevant to the macros that are currently assigned to the selected object.</ahelp></paragraph> <paragraph role="paragraph" id="par_id3150670" xml-lang="en-US">The following table describes the macros and the events that can by linked to objects in your document:</paragraph> <table id="tbl_id3148944"> <tablerow> <tablecell colspan="" rowspan=""> <paragraph role="tablehead" id="par_id3153360" xml-lang="en-US">Event</paragraph> </tablecell> <tablecell colspan="" rowspan=""> <paragraph role="tablehead" id="par_id3154365" xml-lang="en-US">Event trigger</paragraph> </tablecell> <tablecell colspan="" rowspan=""> <paragraph role="tablehead" id="par_id3159149" xml-lang="en-US">OLE object</paragraph> </tablecell> <tablecell colspan="" rowspan=""> <paragraph role="tablehead" id="par_id3148451" xml-lang="en-US">Graphics</paragraph> </tablecell> <tablecell colspan="" rowspan=""> <paragraph role="tablehead" id="par_id3125863" xml-lang="en-US">Frame</paragraph> </tablecell> <tablecell colspan="" rowspan=""> <paragraph role="tablehead" id="par_id3154216" xml-lang="en-US">AutoText</paragraph> </tablecell> <tablecell colspan="" rowspan=""> <paragraph role="tablehead" id="par_id3145785" xml-lang="en-US">ImageMap area</paragraph> </tablecell> <tablecell colspan="" rowspan=""> <paragraph role="tablehead" id="par_id3153138" xml-lang="en-US">Hyperlink</paragraph> </tablecell> </tablerow> <tablerow> <tablecell colspan="" rowspan=""> <paragraph role="paragraph" id="par_id3155306" xml-lang="en-US">Click object</paragraph> </tablecell> <tablecell colspan="" rowspan=""> <paragraph role="paragraph" id="par_id3152460" xml-lang="en-US">Object is selected.</paragraph> </tablecell> <tablecell colspan="" rowspan=""> <paragraph role="paragraph" id="par_id3147348" xml-lang="en-US" localize="false">✓</paragraph> </tablecell> <tablecell colspan="" rowspan=""> <paragraph role="paragraph" id="par_id3147426" xml-lang="en-US" localize="false">✓</paragraph> </tablecell> <tablecell colspan="" rowspan=""> <paragraph role="paragraph" id="par_id3153951" 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="paragraph" id="par_id3150116" xml-lang="en-US">Mouse over object</paragraph> </tablecell> <tablecell colspan="" rowspan=""> <paragraph role="paragraph" id="par_id3145253" xml-lang="en-US">Mouse moves over the object.</paragraph> </tablecell> <tablecell colspan="" rowspan=""> <paragraph role="paragraph" id="par_id3144765" xml-lang="en-US" localize="false">✓</paragraph> </tablecell> <tablecell colspan="" rowspan=""> <paragraph role="paragraph" id="par_id3153418" xml-lang="en-US" localize="false">✓</paragraph> </tablecell> <tablecell colspan="" rowspan=""> <paragraph role="paragraph" id="par_id3153948" xml-lang="en-US" localize="false">✓</paragraph> </tablecell> <tablecell colspan="" rowspan=""> </tablecell> <tablecell colspan="" rowspan=""> <paragraph role="paragraph" id="par_id3145652" xml-lang="en-US" localize="false">✓</paragraph> </tablecell> <tablecell colspan="" rowspan=""> <paragraph role="paragraph" id="par_id3155066" xml-lang="en-US" localize="false">✓</paragraph> </tablecell> </tablerow> <tablerow> <tablecell colspan="" rowspan=""> <paragraph role="paragraph" id="par_id3155446" xml-lang="en-US">Trigger Hyperlink</paragraph> </tablecell> <tablecell colspan="" rowspan=""> <paragraph role="paragraph" id="par_id3154756" xml-lang="en-US">Hyperlink assigned to the object is clicked.</paragraph> </tablecell> <tablecell colspan="" rowspan=""> <paragraph role="paragraph" id="par_id3150042" xml-lang="en-US" localize="false">✓</paragraph> </tablecell> <tablecell colspan="" rowspan=""> <paragraph role="paragraph" id="par_id3151252" xml-lang="en-US" localize="false">✓</paragraph> </tablecell> <tablecell colspan="" rowspan=""> <paragraph role="paragraph" id="par_id3147344" xml-lang="en-US" localize="false">✓</paragraph> </tablecell> <tablecell colspan="" rowspan=""> </tablecell> <tablecell colspan="" rowspan=""> </tablecell> <tablecell colspan="" rowspan=""> <paragraph role="paragraph" id="par_id3146920" xml-lang="en-US" localize="false">✓</paragraph> </tablecell> </tablerow> <tablerow> <tablecell colspan="" rowspan=""> <paragraph role="paragraph" id="par_id3159333" xml-lang="en-US">Mouse leaves object </paragraph> </tablecell> <tablecell colspan="" rowspan=""> <paragraph role="paragraph" id="par_id3147003" xml-lang="en-US">Mouse moves off of the object.</paragraph> </tablecell> <tablecell colspan="" rowspan=""> <paragraph role="paragraph" id="par_id3151278" xml-lang="en-US" localize="false">✓</paragraph> </tablecell> <tablecell colspan="" rowspan=""> <paragraph role="paragraph" id="par_id3145257" xml-lang="en-US" localize="false">✓</paragraph> </tablecell> <tablecell colspan="" rowspan=""> <paragraph role="paragraph" id="par_id3154122" xml-lang="en-US" localize="false">✓</paragraph> </tablecell> <tablecell colspan="" rowspan=""> </tablecell> <tablecell colspan="" rowspan=""> <paragraph role="paragraph" id="par_id3156139" xml-lang="en-US" localize="false">✓</paragraph> </tablecell> <tablecell colspan="" rowspan=""> <paragraph role="paragraph" id="par_id3149036" xml-lang="en-US" localize="false">✓</paragraph> </tablecell> </tablerow> <tablerow> <tablecell colspan="" rowspan=""> <paragraph role="paragraph" id="par_id3150785" xml-lang="en-US">Graphics load successful </paragraph> </tablecell> <tablecell colspan="" rowspan=""> <paragraph role="paragraph" id="par_id3153705" xml-lang="en-US">Graphics are loaded successfully.</paragraph> </tablecell> <tablecell colspan="" rowspan=""> </tablecell> <tablecell colspan="" rowspan=""> <paragraph role="paragraph" id="par_id3150343" 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="paragraph" id="par_id3150202" xml-lang="en-US">Graphics load terminated</paragraph> </tablecell> <tablecell colspan="" rowspan=""> <paragraph role="paragraph" id="par_id3145584" xml-lang="en-US">Loading of graphics is stopped by the user (for example, when downloading the page).</paragraph> </tablecell> <tablecell colspan="" rowspan=""> </tablecell> <tablecell colspan="" rowspan=""> <paragraph role="paragraph" id="par_id3154259" 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="paragraph" id="par_id3155089" xml-lang="en-US">Graphics load faulty</paragraph> </tablecell> <tablecell colspan="" rowspan=""> <paragraph role="paragraph" id="par_id3153307" xml-lang="en-US">Graphics not successfully loaded, for example, if a graphic was not found.</paragraph> </tablecell> <tablecell colspan="" rowspan=""> </tablecell> <tablecell colspan="" rowspan=""> <paragraph role="paragraph" id="par_id3148840" 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="paragraph" id="par_id3154533" xml-lang="en-US">Input of alpha characters </paragraph> </tablecell> <tablecell colspan="" rowspan=""> <paragraph role="paragraph" id="par_id3155266" xml-lang="en-US">Text is entered from the keyboard.</paragraph> </tablecell> <tablecell colspan="" rowspan=""> </tablecell> <tablecell colspan="" rowspan=""> </tablecell> <tablecell colspan="" rowspan=""> <paragraph role="paragraph" id="par_id3144768" 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="paragraph" id="par_id3145659" xml-lang="en-US">Input of non-alpha characters </paragraph> </tablecell> <tablecell colspan="" rowspan=""> <paragraph role="paragraph" id="par_id3151131" xml-lang="en-US">Nonprinting characters are entered from the keyboard, for example, tabs and line breaks.</paragraph> </tablecell> <tablecell colspan="" rowspan=""> </tablecell> <tablecell colspan="" rowspan=""> </tablecell> <tablecell colspan="" rowspan=""> <paragraph role="paragraph" id="par_id3159206" 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="paragraph" id="par_id3150405" xml-lang="en-US">Resize frame</paragraph> </tablecell> <tablecell colspan="" rowspan=""> <paragraph role="paragraph" id="par_id3153972" xml-lang="en-US">Frame is resized with the mouse.</paragraph> </tablecell> <tablecell colspan="" rowspan=""> </tablecell> <tablecell colspan="" rowspan=""> </tablecell> <tablecell colspan="" rowspan=""> <paragraph role="paragraph" id="par_id3152873" 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="paragraph" id="par_id3148900" xml-lang="en-US">Move frame</paragraph> </tablecell> <tablecell colspan="" rowspan=""> <paragraph role="paragraph" id="par_id3154767" xml-lang="en-US">Frame is moved with the mouse.</paragraph> </tablecell> <tablecell colspan="" rowspan=""> </tablecell> <tablecell colspan="" rowspan=""> </tablecell> <tablecell colspan="" rowspan=""> <paragraph role="paragraph" id="par_id3155914" 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="paragraph" id="par_id3153010" xml-lang="en-US">Before inserting AutoText</paragraph> </tablecell> <tablecell colspan="" rowspan=""> <paragraph role="paragraph" id="par_id3147515" xml-lang="en-US">Before a text block is inserted.</paragraph> </tablecell> <tablecell colspan="" rowspan=""> </tablecell> <tablecell colspan="" rowspan=""> </tablecell> <tablecell colspan="" rowspan=""> </tablecell> <tablecell colspan="" rowspan=""> <paragraph role="paragraph" id="par_id3151191" xml-lang="en-US" localize="false">✓</paragraph> </tablecell> <tablecell colspan="" rowspan=""> </tablecell> <tablecell colspan="" rowspan=""> </tablecell> </tablerow> <tablerow> <tablecell colspan="" rowspan=""> <paragraph role="paragraph" id="par_id3150956" xml-lang="en-US">After inserting AutoText</paragraph> </tablecell> <tablecell colspan="" rowspan=""> <paragraph role="paragraph" id="par_id3147502" xml-lang="en-US">After a text block is inserted.</paragraph> </tablecell> <tablecell colspan="" rowspan=""> </tablecell> <tablecell colspan="" rowspan=""> </tablecell> <tablecell colspan="" rowspan=""> </tablecell> <tablecell colspan="" rowspan=""> <paragraph role="paragraph" id="par_id3147555" xml-lang="en-US" localize="false">✓</paragraph> </tablecell> <tablecell colspan="" rowspan=""> </tablecell> <tablecell colspan="" rowspan=""> </tablecell> </tablerow> </table> <paragraph role="heading" id="hd_id3153958" xml-lang="en-US" level="2">Macros</paragraph> <paragraph role="paragraph" id="par_id3150432" xml-lang="en-US">Choose the macro that you want to execute when the selected event occurs.</paragraph> <paragraph role="paragraph" id="par_id3147296" xml-lang="en-US">Frames allow you to link events to a function, so that the function can determine if it processes the event or $[officename] Writer.</paragraph> <paragraph role="heading" id="hd_id3155587" xml-lang="en-US" level="3">Category</paragraph> <paragraph role="paragraph" id="par_id3154068" xml-lang="en-US"><ahelp hid="cui/ui/eventassignpage/libraries">Lists the open $[officename] documents and applications. Click the name of the location where you want to save the macros.</ahelp></paragraph> <paragraph role="heading" id="hd_id3149744" xml-lang="en-US" level="3">Macro name</paragraph> <paragraph role="paragraph" id="par_id3151391" xml-lang="en-US"><ahelp hid="cui/ui/eventassignpage/macros">Lists the available macros. Click the macro that you want to assign to the selected object.</ahelp></paragraph> <paragraph role="heading" id="hd_id3159260" xml-lang="en-US" level="2">Assign</paragraph> <paragraph role="paragraph" id="par_id3147406" xml-lang="en-US"><ahelp hid="SFX2_PUSHBUTTON_RID_SFX_TP_MACROASSIGN_PB_ASSIGN">Assigns the selected macro to the specified event.</ahelp> The assigned macro's entries are set after the event.</paragraph> <paragraph role="heading" id="hd_id3150533" xml-lang="en-US" level="2">Remove</paragraph> <paragraph role="paragraph" id="par_id3166456" xml-lang="en-US"><variable id="aufheb"><ahelp hid="SFX2_PUSHBUTTON_RID_SFX_TP_MACROASSIGN_PB_DELETE">Removes the macro that is assigned to the selected item.</ahelp> </variable></paragraph> <paragraph role="heading" id="hd_id3159126" xml-lang="en-US" level="2">Macro selection</paragraph> <paragraph role="paragraph" id="par_id3149149" xml-lang="en-US"><ahelp hid="SFX2_LISTBOX_RID_SFX_TP_MACROASSIGN_LB_SCRIPTTYPE">Select the macro that you want to assign.</ahelp></paragraph> </body> </helpdocument>