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="textswriter0105060700xml" indexer="include" status="PUBLISH">
27<title id="tit" xml-lang="en-US">Macro</title>
28<filename>/text/swriter/01/05060700.xhp</filename>
29</topic>
30</meta>
31<body>
32<section id="makro">
33<!-- removed HID SFX2:TABPAGE:RID_SFX_TP_MACROASSIGN -->
34<paragraph role="heading" id="hd_id3145241" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/swriter/01/05060700.xhp" name="Macro">Macro</link></paragraph>
35<paragraph role="paragraph" id="par_id3158429" xml-lang="en-US" l10n="U" oldref="2"><ahelp hid="SFX2:TABPAGE:RID_SFX_TP_MACROASSIGN">Specifies the macro to run when you click a graphic, frame, or an OLE object.</ahelp></paragraph>
36</section>
37<section id="howtoget">
38<embed href="text/swriter/00/00000405.xhp#makrografik"/>
39</section>
40<bookmark xml-lang="en-US" branch="hid/CUI_HID_MACRO_HEADERTABLISTBOX" id="bm_id9825434" localize="false"/>
41<paragraph role="heading" id="hd_id3147176" xml-lang="en-US" level="2" l10n="U" oldref="3">Event</paragraph>
42<paragraph role="paragraph" id="par_id3147564" xml-lang="en-US" l10n="CHG" oldref="4"><ahelp hid="SFX2:TABPAGE:RID_SFX_TP_MACROASSIGN">Lists the events that can trigger a macro.</ahelp> Only the events that are relevant to the selected object are listed.</paragraph>
43<paragraph role="paragraph" id="par_id3149286" xml-lang="en-US" l10n="U" oldref="23">The following table lists the object types and the events that can trigger a macro:</paragraph>
44<table id="tbl_id3151173">
45<tablerow>
46<tablecell colspan="" rowspan="">
47<paragraph role="tablehead" id="par_id3152949" xml-lang="en-US" l10n="U" oldref="24">Event</paragraph>
48</tablecell>
49<tablecell colspan="" rowspan="">
50<paragraph role="tablehead" id="par_id3149808" xml-lang="en-US" l10n="U" oldref="25">Event trigger</paragraph>
51</tablecell>
52<tablecell colspan="" rowspan="">
53<paragraph role="tablehead" id="par_id3152957" xml-lang="en-US" l10n="U" oldref="26">OLE object</paragraph>
54</tablecell>
55<tablecell colspan="" rowspan="">
56<paragraph role="tablehead" id="par_id3154564" xml-lang="en-US" l10n="U" oldref="27">Graphics</paragraph>
57</tablecell>
58<tablecell colspan="" rowspan="">
59<paragraph role="tablehead" id="par_id3153675" xml-lang="en-US" l10n="U" oldref="28">Frame</paragraph>
60</tablecell>
61<tablecell colspan="" rowspan="">
62<paragraph role="tablehead" id="par_id3154473" xml-lang="en-US" l10n="U" oldref="29">AutoText</paragraph>
63</tablecell>
64<tablecell colspan="" rowspan="">
65<paragraph role="tablehead" id="par_id3149684" xml-lang="en-US" l10n="U" oldref="30">ImageMap area</paragraph>
66</tablecell>
67<tablecell colspan="" rowspan="">
68<paragraph role="tablehead" id="par_id3154197" xml-lang="en-US" l10n="U" oldref="31">Hyperlink</paragraph>
69</tablecell>
70</tablerow>
71<tablerow>
72<tablecell colspan="" rowspan="">
73<paragraph role="tablecontent" id="par_id3155182" xml-lang="en-US" l10n="U" oldref="32">Click object</paragraph>
74</tablecell>
75<tablecell colspan="" rowspan="">
76<paragraph role="tablecontent" id="par_id3149489" xml-lang="en-US" l10n="U" oldref="33">object is selected</paragraph>
77</tablecell>
78<tablecell colspan="" rowspan="">
79<paragraph role="tablecontent" id="par_id3151249" xml-lang="en-US" l10n="U" oldref="34">x</paragraph>
80</tablecell>
81<tablecell colspan="" rowspan="">
82<paragraph role="tablecontent" id="par_id3149104" xml-lang="en-US" l10n="U" oldref="35">x</paragraph>
83</tablecell>
84<tablecell colspan="" rowspan="">
85<paragraph role="tablecontent" id="par_id3147089" xml-lang="en-US" l10n="U" oldref="36">x</paragraph>
86</tablecell>
87<tablecell colspan="" rowspan="">
88</tablecell>
89<tablecell colspan="" rowspan="">
90</tablecell>
91<tablecell colspan="" rowspan="">
92</tablecell>
93</tablerow>
94<tablerow>
95<tablecell colspan="" rowspan="">
96<paragraph role="tablecontent" id="par_id3153637" xml-lang="en-US" l10n="U" oldref="37">Mouse over object</paragraph>
97</tablecell>
98<tablecell colspan="" rowspan="">
99<paragraph role="tablecontent" id="par_id3147579" xml-lang="en-US" l10n="U" oldref="38">mouse pointer moves over the object</paragraph>
100</tablecell>
101<tablecell colspan="" rowspan="">
102<paragraph role="tablecontent" id="par_id3152779" xml-lang="en-US" l10n="U" oldref="39">x</paragraph>
103</tablecell>
104<tablecell colspan="" rowspan="">
105<paragraph role="tablecontent" id="par_id3153349" xml-lang="en-US" l10n="U" oldref="40">x</paragraph>
106</tablecell>
107<tablecell colspan="" rowspan="">
108<paragraph role="tablecontent" id="par_id3149174" xml-lang="en-US" l10n="U" oldref="41">x</paragraph>
109</tablecell>
110<tablecell colspan="" rowspan="">
111</tablecell>
112<tablecell colspan="" rowspan="">
113<paragraph role="tablecontent" id="par_id3151031" xml-lang="en-US" l10n="U" oldref="42">x</paragraph>
114</tablecell>
115<tablecell colspan="" rowspan="">
116<paragraph role="tablecontent" id="par_id3145784" xml-lang="en-US" l10n="U" oldref="43">x</paragraph>
117</tablecell>
118</tablerow>
119<tablerow>
120<tablecell colspan="" rowspan="">
121<paragraph role="tablecontent" id="par_id3155910" xml-lang="en-US" l10n="U" oldref="44">Trigger Hyperlink</paragraph>
122</tablecell>
123<tablecell colspan="" rowspan="">
124<paragraph role="tablecontent" id="par_id3155857" xml-lang="en-US" l10n="U" oldref="45">hyperlink that is assigned to the object is clicked</paragraph>
125</tablecell>
126<tablecell colspan="" rowspan="">
127<paragraph role="tablecontent" id="par_id3150693" xml-lang="en-US" l10n="U" oldref="46">x</paragraph>
128</tablecell>
129<tablecell colspan="" rowspan="">
130<paragraph role="tablecontent" id="par_id3147423" xml-lang="en-US" l10n="U" oldref="47">x</paragraph>
131</tablecell>
132<tablecell colspan="" rowspan="">
133<paragraph role="tablecontent" id="par_id3145256" xml-lang="en-US" l10n="U" oldref="48">x</paragraph>
134</tablecell>
135<tablecell colspan="" rowspan="">
136</tablecell>
137<tablecell colspan="" rowspan="">
138</tablecell>
139<tablecell colspan="" rowspan="">
140<paragraph role="tablecontent" id="par_id3149554" xml-lang="en-US" l10n="U" oldref="49">x</paragraph>
141</tablecell>
142</tablerow>
143<tablerow>
144<tablecell colspan="" rowspan="">
145<paragraph role="tablecontent" id="par_id3155976" xml-lang="en-US" l10n="U" oldref="50">Mouse leaves object</paragraph>
146</tablecell>
147<tablecell colspan="" rowspan="">
148<paragraph role="tablecontent" id="par_id3149216" xml-lang="en-US" l10n="U" oldref="51">mouse pointer moves off the object</paragraph>
149</tablecell>
150<tablecell colspan="" rowspan="">
151<paragraph role="tablecontent" id="par_id3147739" xml-lang="en-US" l10n="U" oldref="52">x</paragraph>
152</tablecell>
153<tablecell colspan="" rowspan="">
154<paragraph role="tablecontent" id="par_id3146336" xml-lang="en-US" l10n="U" oldref="53">x</paragraph>
155</tablecell>
156<tablecell colspan="" rowspan="">
157<paragraph role="tablecontent" id="par_id3149841" xml-lang="en-US" l10n="U" oldref="54">x</paragraph>
158</tablecell>
159<tablecell colspan="" rowspan="">
160</tablecell>
161<tablecell colspan="" rowspan="">
162<paragraph role="tablecontent" id="par_id3148436" xml-lang="en-US" l10n="U" oldref="55">x</paragraph>
163</tablecell>
164<tablecell colspan="" rowspan="">
165<paragraph role="tablecontent" id="par_id3151082" xml-lang="en-US" l10n="U" oldref="56">x</paragraph>
166</tablecell>
167</tablerow>
168<tablerow>
169<tablecell colspan="" rowspan="">
170<paragraph role="tablecontent" id="par_id3154780" xml-lang="en-US" l10n="U" oldref="57">Graphics load successful</paragraph>
171</tablecell>
172<tablecell colspan="" rowspan="">
173<paragraph role="tablecontent" id="par_id3145304" xml-lang="en-US" l10n="U" oldref="58">graphic is loaded successfully</paragraph>
174</tablecell>
175<tablecell colspan="" rowspan="">
176</tablecell>
177<tablecell colspan="" rowspan="">
178<paragraph role="tablecontent" id="par_id3150169" xml-lang="en-US" l10n="U" oldref="59">x</paragraph>
179</tablecell>
180<tablecell colspan="" rowspan="">
181</tablecell>
182<tablecell colspan="" rowspan="">
183</tablecell>
184<tablecell colspan="" rowspan="">
185</tablecell>
186<tablecell colspan="" rowspan="">
187</tablecell>
188</tablerow>
189<tablerow>
190<tablecell colspan="" rowspan="">
191<paragraph role="tablecontent" id="par_id3154718" xml-lang="en-US" l10n="U" oldref="60">Graphics load terminated</paragraph>
192</tablecell>
193<tablecell colspan="" rowspan="">
194<paragraph role="tablecontent" id="par_id3156136" xml-lang="en-US" l10n="U" oldref="61">loading of the graphic is terminated by the user (for example, when downloading)</paragraph>
195</tablecell>
196<tablecell colspan="" rowspan="">
197</tablecell>
198<tablecell colspan="" rowspan="">
199<paragraph role="tablecontent" id="par_id3156105" xml-lang="en-US" l10n="U" oldref="62">x</paragraph>
200</tablecell>
201<tablecell colspan="" rowspan="">
202</tablecell>
203<tablecell colspan="" rowspan="">
204</tablecell>
205<tablecell colspan="" rowspan="">
206</tablecell>
207<tablecell colspan="" rowspan="">
208</tablecell>
209</tablerow>
210<tablerow>
211<tablecell colspan="" rowspan="">
212<paragraph role="tablecontent" id="par_id3155079" xml-lang="en-US" l10n="U" oldref="63">Graphics load faulty</paragraph>
213</tablecell>
214<tablecell colspan="" rowspan="">
215<paragraph role="tablecontent" id="par_id3149250" xml-lang="en-US" l10n="U" oldref="64">graphic is not successfully loaded</paragraph>
216</tablecell>
217<tablecell colspan="" rowspan="">
218</tablecell>
219<tablecell colspan="" rowspan="">
220<paragraph role="tablecontent" id="par_id3154327" xml-lang="en-US" l10n="U" oldref="65">x</paragraph>
221</tablecell>
222<tablecell colspan="" rowspan="">
223</tablecell>
224<tablecell colspan="" rowspan="">
225</tablecell>
226<tablecell colspan="" rowspan="">
227</tablecell>
228<tablecell colspan="" rowspan="">
229</tablecell>
230</tablerow>
231<tablerow>
232<tablecell colspan="" rowspan="">
233<paragraph role="tablecontent" id="par_id3148779" xml-lang="en-US" l10n="U" oldref="66">Input of alpha characters</paragraph>
234</tablecell>
235<tablecell colspan="" rowspan="">
236<paragraph role="tablecontent" id="par_id3150030" xml-lang="en-US" l10n="U" oldref="67">text is inputted</paragraph>
237</tablecell>
238<tablecell colspan="" rowspan="">
239</tablecell>
240<tablecell colspan="" rowspan="">
241</tablecell>
242<tablecell colspan="" rowspan="">
243<paragraph role="tablecontent" id="par_id3155792" xml-lang="en-US" l10n="U" oldref="68">x</paragraph>
244</tablecell>
245<tablecell colspan="" rowspan="">
246</tablecell>
247<tablecell colspan="" rowspan="">
248</tablecell>
249<tablecell colspan="" rowspan="">
250</tablecell>
251</tablerow>
252<tablerow>
253<tablecell colspan="" rowspan="">
254<paragraph role="tablecontent" id="par_id3154623" xml-lang="en-US" l10n="U" oldref="69">Input of non-alpha characters</paragraph>
255</tablecell>
256<tablecell colspan="" rowspan="">
257<paragraph role="tablecontent" id="par_id3147391" xml-lang="en-US" l10n="U" oldref="70">Nonprinting characters, such as tabs and line breaks, are entered</paragraph>
258</tablecell>
259<tablecell colspan="" rowspan="">
260</tablecell>
261<tablecell colspan="" rowspan="">
262</tablecell>
263<tablecell colspan="" rowspan="">
264<paragraph role="tablecontent" id="par_id3150666" xml-lang="en-US" l10n="U" oldref="71">x</paragraph>
265</tablecell>
266<tablecell colspan="" rowspan="">
267</tablecell>
268<tablecell colspan="" rowspan="">
269</tablecell>
270<tablecell colspan="" rowspan="">
271</tablecell>
272</tablerow>
273<tablerow>
274<tablecell colspan="" rowspan="">
275<paragraph role="tablecontent" id="par_id3149963" xml-lang="en-US" l10n="U" oldref="72">Resize frame</paragraph>
276</tablecell>
277<tablecell colspan="" rowspan="">
278<paragraph role="tablecontent" id="par_id3147284" xml-lang="en-US" l10n="U" oldref="73">frame is resized</paragraph>
279</tablecell>
280<tablecell colspan="" rowspan="">
281</tablecell>
282<tablecell colspan="" rowspan="">
283</tablecell>
284<tablecell colspan="" rowspan="">
285<paragraph role="tablecontent" id="par_id3150774" xml-lang="en-US" l10n="U" oldref="74">x</paragraph>
286</tablecell>
287<tablecell colspan="" rowspan="">
288</tablecell>
289<tablecell colspan="" rowspan="">
290</tablecell>
291<tablecell colspan="" rowspan="">
292</tablecell>
293</tablerow>
294<tablerow>
295<tablecell colspan="" rowspan="">
296<paragraph role="tablecontent" id="par_id3148713" xml-lang="en-US" l10n="U" oldref="75">Move frame</paragraph>
297</tablecell>
298<tablecell colspan="" rowspan="">
299<paragraph role="tablecontent" id="par_id3155349" xml-lang="en-US" l10n="U" oldref="76">frame is moved</paragraph>
300</tablecell>
301<tablecell colspan="" rowspan="">
302</tablecell>
303<tablecell colspan="" rowspan="">
304</tablecell>
305<tablecell colspan="" rowspan="">
306<paragraph role="tablecontent" id="par_id3155553" xml-lang="en-US" l10n="U" oldref="77">x</paragraph>
307</tablecell>
308<tablecell colspan="" rowspan="">
309</tablecell>
310<tablecell colspan="" rowspan="">
311</tablecell>
312<tablecell colspan="" rowspan="">
313</tablecell>
314</tablerow>
315<tablerow>
316<tablecell colspan="" rowspan="">
317<paragraph role="tablecontent" id="par_id3154227" xml-lang="en-US" l10n="U" oldref="78">Before inserting AutoText</paragraph>
318</tablecell>
319<tablecell colspan="" rowspan="">
320<paragraph role="tablecontent" id="par_id3155785" xml-lang="en-US" l10n="U" oldref="79">before AutoText is inserted</paragraph>
321</tablecell>
322<tablecell colspan="" rowspan="">
323</tablecell>
324<tablecell colspan="" rowspan="">
325</tablecell>
326<tablecell colspan="" rowspan="">
327</tablecell>
328<tablecell colspan="" rowspan="">
329<paragraph role="tablecontent" id="par_id3145292" xml-lang="en-US" l10n="U" oldref="80">x</paragraph>
330</tablecell>
331<tablecell colspan="" rowspan="">
332</tablecell>
333<tablecell colspan="" rowspan="">
334</tablecell>
335</tablerow>
336<tablerow>
337<tablecell colspan="" rowspan="">
338<paragraph role="tablecontent" id="par_id3145096" xml-lang="en-US" l10n="U" oldref="81">After inserting AutoText</paragraph>
339</tablecell>
340<tablecell colspan="" rowspan="">
341<paragraph role="tablecontent" id="par_id3149577" xml-lang="en-US" l10n="U" oldref="82">after AutoText is inserted</paragraph>
342</tablecell>
343<tablecell colspan="" rowspan="">
344</tablecell>
345<tablecell colspan="" rowspan="">
346</tablecell>
347<tablecell colspan="" rowspan="">
348</tablecell>
349<tablecell colspan="" rowspan="">
350<paragraph role="tablecontent" id="par_id3156237" xml-lang="en-US" l10n="U" oldref="83">x</paragraph>
351</tablecell>
352<tablecell colspan="" rowspan="">
353</tablecell>
354<tablecell colspan="" rowspan="">
355</tablecell>
356</tablerow>
357</table>
358<paragraph role="note" id="par_id3159203" xml-lang="en-US" l10n="U" oldref="89">For events that are linked to controls in forms, see <link href="text/shared/02/01170103.xhp" name="Control properties">Control properties</link> or <link href="text/shared/02/01170202.xhp" name="Form properties">Form properties</link>.</paragraph>
359<bookmark xml-lang="en-US" branch="hid/CUI_HID_MACRO_GROUP" id="bm_id4656819" localize="false"/>
360<paragraph role="heading" id="hd_id3156030" xml-lang="en-US" level="2" l10n="U" oldref="5">Macros</paragraph>
361<paragraph role="paragraph" id="par_id3156043" xml-lang="en-US" l10n="U" oldref="6"><ahelp hid=".">Specify the macro that executes when the selected event occurs.</ahelp></paragraph>
362<paragraph role="paragraph" id="par_id3156058" xml-lang="en-US" l10n="U" oldref="84">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.<comment>???</comment></paragraph>
363<paragraph role="heading" id="hd_id3149271" xml-lang="en-US" level="3" l10n="U" oldref="7">Category</paragraph>
364<paragraph role="paragraph" id="par_id3149284" xml-lang="en-US" l10n="U" oldref="8"><ahelp hid="SFX2:TABPAGE:RID_SFX_TP_MACROASSIGN">Lists the $[officename] program and any open $[officename] document.</ahelp> Within this list, select the location where you want to save the macros.</paragraph>
365<bookmark xml-lang="en-US" branch="hid/CUI_HID_MACRO_MACROS" id="bm_id3767815" localize="false"/>
366<paragraph role="heading" id="hd_id3156441" xml-lang="en-US" level="3" l10n="U" oldref="9">Macro name</paragraph>
367<paragraph role="paragraph" id="par_id3148458" xml-lang="en-US" l10n="U" oldref="10"><ahelp hid="SFX2:TABPAGE:RID_SFX_TP_MACROASSIGN">Lists the available macros. Select the macro that you want to assign to the selected event, and then click <emph>Assign</emph>.</ahelp></paragraph>
368<!-- removed HID SFX2:PUSHBUTTON:RID_SFX_TP_MACROASSIGN:PB_ASSIGN -->
369<!-- removed HID SFX2:PUSHBUTTON:RID_SFX_SMALLTP_MACROASSIGN:PB_ASSIGN -->
370<paragraph role="heading" id="hd_id3145173" xml-lang="en-US" level="2" l10n="U" oldref="11">Assign</paragraph>
371<paragraph role="paragraph" id="par_id3145197" xml-lang="en-US" l10n="CHG" oldref="12"><ahelp hid="SFX2:PUSHBUTTON:RID_SFX_SMALLTP_MACROASSIGN:PB_ASSIGN">Assigns the selected macro to the selected event.</ahelp></paragraph>
372<!-- removed HID SFX2:PUSHBUTTON:RID_SFX_TP_MACROASSIGN:PB_DELETE -->
373<!-- removed HID SFX2:PUSHBUTTON:RID_SFX_SMALLTP_MACROASSIGN:PB_DELETE -->
374<paragraph role="heading" id="hd_id3150811" xml-lang="en-US" level="2" l10n="U" oldref="15">Remove</paragraph>
375<paragraph role="paragraph" id="par_id3150882" xml-lang="en-US" l10n="U" oldref="16"><variable id="aufheb"><ahelp hid="SFX2:PUSHBUTTON:RID_SFX_SMALLTP_MACROASSIGN:PB_DELETE">Removes the macro assignment from the selected entry.</ahelp>
376</variable></paragraph>
377</body>
378</helpdocument>
379