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