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