1<?xml version="1.0" encoding="UTF-8"?>
2
3
4<!--***********************************************************
5 *
6 * Licensed to the Apache Software Foundation (ASF) under one
7 * or more contributor license agreements.  See the NOTICE file
8 * distributed with this work for additional information
9 * regarding copyright ownership.  The ASF licenses this file
10 * to you under the Apache License, Version 2.0 (the
11 * "License"); you may not use this file except in compliance
12 * with the License.  You may obtain a copy of the License at
13 *
14 *   http://www.apache.org/licenses/LICENSE-2.0
15 *
16 * Unless required by applicable law or agreed to in writing,
17 * software distributed under the License is distributed on an
18 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
19 * KIND, either express or implied.  See the License for the
20 * specific language governing permissions and limitations
21 * under the License.
22 *
23 ***********************************************************-->
24
25
26
27<helpdocument version="1.0">
28<meta>
29<topic id="textsbasicshared05060700xml" indexer="include" status="PUBLISH">
30<title id="tit" xml-lang="en-US">Macro</title>
31<filename>/text/sbasic/shared/05060700.xhp</filename>
32</topic>
33<history>
34<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created>
35<lastedited date="2006-02-24T10:51:24">converted from old format - fpe</lastedited>
36</history>
37</meta>
38<body>
39<section id="makro">
40<bookmark xml-lang="en-US" branch="index" id="bm_id3153894"><bookmark_value>events;linked to objects</bookmark_value>
41</bookmark><comment>UFI: removed all help ids</comment>
42<paragraph role="heading" id="hd_id3153894" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/05060700.xhp" name="Macro">Macro</link></paragraph>
43<paragraph role="paragraph" id="par_id3153748" xml-lang="en-US" l10n="U" oldref="2"><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>
44</section>
45<paragraph role="heading" id="hd_id3150503" xml-lang="en-US" level="2" l10n="U" oldref="3">Event</paragraph>
46<paragraph role="paragraph" id="par_id3149763" xml-lang="en-US" l10n="U" oldref="4"><ahelp hid="HID_MACRO_LB_EVENT">Lists the events that are relevant to the macros that are currently assigned to the selected object.</ahelp></paragraph>
47<paragraph role="paragraph" id="par_id3150670" xml-lang="en-US" l10n="U" oldref="23">The following table describes the macros and the events that can by linked to objects in your document:</paragraph>
48<table id="tbl_id3148944">
49<tablerow>
50<tablecell colspan="" rowspan="">
51<paragraph role="paragraph" id="par_id3153360" xml-lang="en-US" l10n="U" oldref="24">Event</paragraph>
52</tablecell>
53<tablecell colspan="" rowspan="">
54<paragraph role="paragraph" id="par_id3154365" xml-lang="en-US" l10n="U" oldref="25">Event trigger</paragraph>
55</tablecell>
56<tablecell colspan="" rowspan="">
57<paragraph role="paragraph" id="par_id3159149" xml-lang="en-US" l10n="U" oldref="26">OLE object</paragraph>
58</tablecell>
59<tablecell colspan="" rowspan="">
60<paragraph role="paragraph" id="par_id3148451" xml-lang="en-US" l10n="U" oldref="27">Graphics</paragraph>
61</tablecell>
62<tablecell colspan="" rowspan="">
63<paragraph role="paragraph" id="par_id3125863" xml-lang="en-US" l10n="U" oldref="28">Frame</paragraph>
64</tablecell>
65<tablecell colspan="" rowspan="">
66<paragraph role="paragraph" id="par_id3154216" xml-lang="en-US" l10n="U" oldref="29">AutoText</paragraph>
67</tablecell>
68<tablecell colspan="" rowspan="">
69<paragraph role="paragraph" id="par_id3145785" xml-lang="en-US" l10n="U" oldref="30">ImageMap area</paragraph>
70</tablecell>
71<tablecell colspan="" rowspan="">
72<paragraph role="paragraph" id="par_id3153138" xml-lang="en-US" l10n="U" oldref="31">Hyperlink</paragraph>
73</tablecell>
74</tablerow>
75<tablerow>
76<tablecell colspan="" rowspan="">
77<paragraph role="paragraph" id="par_id3155306" xml-lang="en-US" l10n="U" oldref="32">Click object</paragraph>
78</tablecell>
79<tablecell colspan="" rowspan="">
80<paragraph role="paragraph" id="par_id3152460" xml-lang="en-US" l10n="U" oldref="33">Object is selected.</paragraph>
81</tablecell>
82<tablecell colspan="" rowspan="">
83<paragraph role="paragraph" id="par_id3147348" xml-lang="en-US" l10n="U" oldref="34">x</paragraph>
84</tablecell>
85<tablecell colspan="" rowspan="">
86<paragraph role="paragraph" id="par_id3147426" xml-lang="en-US" l10n="U" oldref="35">x</paragraph>
87</tablecell>
88<tablecell colspan="" rowspan="">
89<paragraph role="paragraph" id="par_id3153951" xml-lang="en-US" l10n="U" oldref="36">x</paragraph>
90</tablecell>
91<tablecell colspan="" rowspan="">
92</tablecell>
93<tablecell colspan="" rowspan="">
94</tablecell>
95<tablecell colspan="" rowspan="">
96</tablecell>
97</tablerow>
98<tablerow>
99<tablecell colspan="" rowspan="">
100<paragraph role="paragraph" id="par_id3150116" xml-lang="en-US" l10n="U" oldref="37">Mouse over object</paragraph>
101</tablecell>
102<tablecell colspan="" rowspan="">
103<paragraph role="paragraph" id="par_id3145253" xml-lang="en-US" l10n="U" oldref="38">Mouse moves over the object.</paragraph>
104</tablecell>
105<tablecell colspan="" rowspan="">
106<paragraph role="paragraph" id="par_id3144765" xml-lang="en-US" l10n="U" oldref="39">x</paragraph>
107</tablecell>
108<tablecell colspan="" rowspan="">
109<paragraph role="paragraph" id="par_id3153418" xml-lang="en-US" l10n="U" oldref="40">x</paragraph>
110</tablecell>
111<tablecell colspan="" rowspan="">
112<paragraph role="paragraph" id="par_id3153948" xml-lang="en-US" l10n="U" oldref="41">x</paragraph>
113</tablecell>
114<tablecell colspan="" rowspan="">
115</tablecell>
116<tablecell colspan="" rowspan="">
117<paragraph role="paragraph" id="par_id3145652" xml-lang="en-US" l10n="U" oldref="42">x</paragraph>
118</tablecell>
119<tablecell colspan="" rowspan="">
120<paragraph role="paragraph" id="par_id3155066" xml-lang="en-US" l10n="U" oldref="43">x</paragraph>
121</tablecell>
122</tablerow>
123<tablerow>
124<tablecell colspan="" rowspan="">
125<paragraph role="paragraph" id="par_id3155446" xml-lang="en-US" l10n="U" oldref="44">Trigger Hyperlink</paragraph>
126</tablecell>
127<tablecell colspan="" rowspan="">
128<paragraph role="paragraph" id="par_id3154756" xml-lang="en-US" l10n="U" oldref="45">Hyperlink assigned to the object is clicked.</paragraph>
129</tablecell>
130<tablecell colspan="" rowspan="">
131<paragraph role="paragraph" id="par_id3150042" xml-lang="en-US" l10n="U" oldref="46">x</paragraph>
132</tablecell>
133<tablecell colspan="" rowspan="">
134<paragraph role="paragraph" id="par_id3151252" xml-lang="en-US" l10n="U" oldref="47">x</paragraph>
135</tablecell>
136<tablecell colspan="" rowspan="">
137<paragraph role="paragraph" id="par_id3147344" xml-lang="en-US" l10n="U" oldref="48">x</paragraph>
138</tablecell>
139<tablecell colspan="" rowspan="">
140</tablecell>
141<tablecell colspan="" rowspan="">
142</tablecell>
143<tablecell colspan="" rowspan="">
144<paragraph role="paragraph" id="par_id3146920" xml-lang="en-US" l10n="U" oldref="49">x</paragraph>
145</tablecell>
146</tablerow>
147<tablerow>
148<tablecell colspan="" rowspan="">
149<paragraph role="paragraph" id="par_id3159333" xml-lang="en-US" l10n="U" oldref="50">Mouse leaves object </paragraph>
150</tablecell>
151<tablecell colspan="" rowspan="">
152<paragraph role="paragraph" id="par_id3147003" xml-lang="en-US" l10n="U" oldref="51">Mouse moves off of the object.</paragraph>
153</tablecell>
154<tablecell colspan="" rowspan="">
155<paragraph role="paragraph" id="par_id3151278" xml-lang="en-US" l10n="U" oldref="52">x</paragraph>
156</tablecell>
157<tablecell colspan="" rowspan="">
158<paragraph role="paragraph" id="par_id3145257" xml-lang="en-US" l10n="U" oldref="53">x</paragraph>
159</tablecell>
160<tablecell colspan="" rowspan="">
161<paragraph role="paragraph" id="par_id3154122" xml-lang="en-US" l10n="U" oldref="54">x</paragraph>
162</tablecell>
163<tablecell colspan="" rowspan="">
164</tablecell>
165<tablecell colspan="" rowspan="">
166<paragraph role="paragraph" id="par_id3156139" xml-lang="en-US" l10n="U" oldref="55">x</paragraph>
167</tablecell>
168<tablecell colspan="" rowspan="">
169<paragraph role="paragraph" id="par_id3149036" xml-lang="en-US" l10n="U" oldref="56">x</paragraph>
170</tablecell>
171</tablerow>
172<tablerow>
173<tablecell colspan="" rowspan="">
174<paragraph role="paragraph" id="par_id3150785" xml-lang="en-US" l10n="U" oldref="57">Graphics load successful </paragraph>
175</tablecell>
176<tablecell colspan="" rowspan="">
177<paragraph role="paragraph" id="par_id3153705" xml-lang="en-US" l10n="U" oldref="58">Graphics are loaded successfully.</paragraph>
178</tablecell>
179<tablecell colspan="" rowspan="">
180</tablecell>
181<tablecell colspan="" rowspan="">
182<paragraph role="paragraph" id="par_id3150343" xml-lang="en-US" l10n="U" oldref="59">x</paragraph>
183</tablecell>
184<tablecell colspan="" rowspan="">
185</tablecell>
186<tablecell colspan="" rowspan="">
187</tablecell>
188<tablecell colspan="" rowspan="">
189</tablecell>
190<tablecell colspan="" rowspan="">
191</tablecell>
192</tablerow>
193<tablerow>
194<tablecell colspan="" rowspan="">
195<paragraph role="paragraph" id="par_id3150202" xml-lang="en-US" l10n="U" oldref="60">Graphics load terminated</paragraph>
196</tablecell>
197<tablecell colspan="" rowspan="">
198<paragraph role="paragraph" id="par_id3145584" xml-lang="en-US" l10n="U" oldref="61">Loading of graphics is stopped by the user (for example, when downloading the page).</paragraph>
199</tablecell>
200<tablecell colspan="" rowspan="">
201</tablecell>
202<tablecell colspan="" rowspan="">
203<paragraph role="paragraph" id="par_id3154259" xml-lang="en-US" l10n="U" oldref="62">x</paragraph>
204</tablecell>
205<tablecell colspan="" rowspan="">
206</tablecell>
207<tablecell colspan="" rowspan="">
208</tablecell>
209<tablecell colspan="" rowspan="">
210</tablecell>
211<tablecell colspan="" rowspan="">
212</tablecell>
213</tablerow>
214<tablerow>
215<tablecell colspan="" rowspan="">
216<paragraph role="paragraph" id="par_id3155089" xml-lang="en-US" l10n="U" oldref="63">Graphics load faulty</paragraph>
217</tablecell>
218<tablecell colspan="" rowspan="">
219<paragraph role="paragraph" id="par_id3153307" xml-lang="en-US" l10n="U" oldref="64">Graphics not successfully loaded, for example, if a graphic was not found.</paragraph>
220</tablecell>
221<tablecell colspan="" rowspan="">
222</tablecell>
223<tablecell colspan="" rowspan="">
224<paragraph role="paragraph" id="par_id3148840" xml-lang="en-US" l10n="U" oldref="65">x</paragraph>
225</tablecell>
226<tablecell colspan="" rowspan="">
227</tablecell>
228<tablecell colspan="" rowspan="">
229</tablecell>
230<tablecell colspan="" rowspan="">
231</tablecell>
232<tablecell colspan="" rowspan="">
233</tablecell>
234</tablerow>
235<tablerow>
236<tablecell colspan="" rowspan="">
237<paragraph role="paragraph" id="par_id3154533" xml-lang="en-US" l10n="U" oldref="66">Input of alpha characters </paragraph>
238</tablecell>
239<tablecell colspan="" rowspan="">
240<paragraph role="paragraph" id="par_id3155266" xml-lang="en-US" l10n="U" oldref="67">Text is entered from the keyboard.</paragraph>
241</tablecell>
242<tablecell colspan="" rowspan="">
243</tablecell>
244<tablecell colspan="" rowspan="">
245</tablecell>
246<tablecell colspan="" rowspan="">
247<paragraph role="paragraph" id="par_id3144768" xml-lang="en-US" l10n="U" oldref="68">x</paragraph>
248</tablecell>
249<tablecell colspan="" rowspan="">
250</tablecell>
251<tablecell colspan="" rowspan="">
252</tablecell>
253<tablecell colspan="" rowspan="">
254</tablecell>
255</tablerow>
256<tablerow>
257<tablecell colspan="" rowspan="">
258<paragraph role="paragraph" id="par_id3145659" xml-lang="en-US" l10n="U" oldref="69">Input of non-alpha characters </paragraph>
259</tablecell>
260<tablecell colspan="" rowspan="">
261<paragraph role="paragraph" id="par_id3151131" xml-lang="en-US" l10n="U" oldref="70">Nonprinting characters are entered from the keyboard, for example, tabs and line breaks.</paragraph>
262</tablecell>
263<tablecell colspan="" rowspan="">
264</tablecell>
265<tablecell colspan="" rowspan="">
266</tablecell>
267<tablecell colspan="" rowspan="">
268<paragraph role="paragraph" id="par_id3159206" xml-lang="en-US" l10n="U" oldref="71">x</paragraph>
269</tablecell>
270<tablecell colspan="" rowspan="">
271</tablecell>
272<tablecell colspan="" rowspan="">
273</tablecell>
274<tablecell colspan="" rowspan="">
275</tablecell>
276</tablerow>
277<tablerow>
278<tablecell colspan="" rowspan="">
279<paragraph role="paragraph" id="par_id3150405" xml-lang="en-US" l10n="U" oldref="72">Resize frame</paragraph>
280</tablecell>
281<tablecell colspan="" rowspan="">
282<paragraph role="paragraph" id="par_id3153972" xml-lang="en-US" l10n="U" oldref="73">Frame is resized with the mouse.</paragraph>
283</tablecell>
284<tablecell colspan="" rowspan="">
285</tablecell>
286<tablecell colspan="" rowspan="">
287</tablecell>
288<tablecell colspan="" rowspan="">
289<paragraph role="paragraph" id="par_id3152873" xml-lang="en-US" l10n="U" oldref="74">x</paragraph>
290</tablecell>
291<tablecell colspan="" rowspan="">
292</tablecell>
293<tablecell colspan="" rowspan="">
294</tablecell>
295<tablecell colspan="" rowspan="">
296</tablecell>
297</tablerow>
298<tablerow>
299<tablecell colspan="" rowspan="">
300<paragraph role="paragraph" id="par_id3148900" xml-lang="en-US" l10n="U" oldref="75">Move frame</paragraph>
301</tablecell>
302<tablecell colspan="" rowspan="">
303<paragraph role="paragraph" id="par_id3154767" xml-lang="en-US" l10n="U" oldref="76">Frame is moved with the mouse.</paragraph>
304</tablecell>
305<tablecell colspan="" rowspan="">
306</tablecell>
307<tablecell colspan="" rowspan="">
308</tablecell>
309<tablecell colspan="" rowspan="">
310<paragraph role="paragraph" id="par_id3155914" xml-lang="en-US" l10n="U" oldref="77">x</paragraph>
311</tablecell>
312<tablecell colspan="" rowspan="">
313</tablecell>
314<tablecell colspan="" rowspan="">
315</tablecell>
316<tablecell colspan="" rowspan="">
317</tablecell>
318</tablerow>
319<tablerow>
320<tablecell colspan="" rowspan="">
321<paragraph role="paragraph" id="par_id3153010" xml-lang="en-US" l10n="U" oldref="78">Before inserting AutoText</paragraph>
322</tablecell>
323<tablecell colspan="" rowspan="">
324<paragraph role="paragraph" id="par_id3147515" xml-lang="en-US" l10n="U" oldref="79">Before a text block is inserted.</paragraph>
325</tablecell>
326<tablecell colspan="" rowspan="">
327</tablecell>
328<tablecell colspan="" rowspan="">
329</tablecell>
330<tablecell colspan="" rowspan="">
331</tablecell>
332<tablecell colspan="" rowspan="">
333<paragraph role="paragraph" id="par_id3151191" xml-lang="en-US" l10n="U" oldref="80">x</paragraph>
334</tablecell>
335<tablecell colspan="" rowspan="">
336</tablecell>
337<tablecell colspan="" rowspan="">
338</tablecell>
339</tablerow>
340<tablerow>
341<tablecell colspan="" rowspan="">
342<paragraph role="paragraph" id="par_id3150956" xml-lang="en-US" l10n="U" oldref="81">After inserting AutoText</paragraph>
343</tablecell>
344<tablecell colspan="" rowspan="">
345<paragraph role="paragraph" id="par_id3147502" xml-lang="en-US" l10n="U" oldref="82">After a text block is inserted.</paragraph>
346</tablecell>
347<tablecell colspan="" rowspan="">
348</tablecell>
349<tablecell colspan="" rowspan="">
350</tablecell>
351<tablecell colspan="" rowspan="">
352</tablecell>
353<tablecell colspan="" rowspan="">
354<paragraph role="paragraph" id="par_id3147555" xml-lang="en-US" l10n="U" oldref="83">x</paragraph>
355</tablecell>
356<tablecell colspan="" rowspan="">
357</tablecell>
358<tablecell colspan="" rowspan="">
359</tablecell>
360</tablerow>
361</table>
362
363<paragraph role="heading" id="hd_id3153958" xml-lang="en-US" level="2" l10n="U" oldref="5">Macros</paragraph>
364<paragraph role="paragraph" id="par_id3150432" xml-lang="en-US" l10n="U" oldref="6">Choose the macro that you want to execute when the selected event occurs.</paragraph>
365<paragraph role="paragraph" id="par_id3147296" xml-lang="en-US" l10n="U" oldref="84">Frames allow you to link events to a function, so that the function can determine if it processes the event or $[officename] Writer.</paragraph>
366<paragraph role="heading" id="hd_id3155587" xml-lang="en-US" level="3" l10n="U" oldref="7">Category</paragraph>
367<paragraph role="paragraph" id="par_id3154068" xml-lang="en-US" l10n="U" oldref="8"><ahelp hid="HID_MACRO_GROUP">Lists the open $[officename] documents and applications. Click the name of the location where you want to save the macros.</ahelp></paragraph>
368<paragraph role="heading" id="hd_id3149744" xml-lang="en-US" level="3" l10n="U" oldref="9">Macro name</paragraph>
369<paragraph role="paragraph" id="par_id3151391" xml-lang="en-US" l10n="U" oldref="10"><ahelp hid="HID_MACRO_MACROS">Lists the available macros. Click the macro that you want to assign to the selected object.</ahelp></paragraph>
370<paragraph role="heading" id="hd_id3159260" xml-lang="en-US" level="2" l10n="U" oldref="11">Assign</paragraph>
371<paragraph role="paragraph" id="par_id3147406" xml-lang="en-US" l10n="U" oldref="12"><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>
372<paragraph role="heading" id="hd_id3150533" xml-lang="en-US" level="2" l10n="U" oldref="15">Remove</paragraph>
373<paragraph role="paragraph" id="par_id3166456" xml-lang="en-US" l10n="U" oldref="16"><variable id="aufheb"><ahelp hid="SFX2_PUSHBUTTON_RID_SFX_TP_MACROASSIGN_PB_DELETE">Removes the macro that is assigned to the selected item.</ahelp>
374</variable></paragraph>
375<paragraph role="heading" id="hd_id3159126" xml-lang="en-US" level="2" l10n="U" oldref="85">Macro selection</paragraph>
376<paragraph role="paragraph" id="par_id3149149" xml-lang="en-US" l10n="U" oldref="86"><ahelp hid="SFX2_LISTBOX_RID_SFX_TP_MACROASSIGN_LB_SCRIPTTYPE">Select the macro that you want to assign.</ahelp></paragraph>
377</body>
378</helpdocument>
379