xref: /help/source/text/shared/01/06140500.xhp (revision 1f63165a8f02d96fbdb0b9b8bea287389edb1121)
1<?xml version="1.0" encoding="UTF-8"?>
2<!--
3 * This file is part of the LibreOffice project.
4 *
5 * This Source Code Form is subject to the terms of the Mozilla Public
6 * License, v. 2.0. If a copy of the MPL was not distributed with this
7 * file, You can obtain one at http://mozilla.org/MPL/2.0/.
8 *
9 * This file incorporates work covered by the following license notice:
10 *
11 *   Licensed to the Apache Software Foundation (ASF) under one or more
12 *   contributor license agreements. See the NOTICE file distributed
13 *   with this work for additional information regarding copyright
14 *   ownership. The ASF licenses this file to you under the Apache
15 *   License, Version 2.0 (the "License"); you may not use this file
16 *   except in compliance with the License. You may obtain a copy of
17 *   the License at http://www.apache.org/licenses/LICENSE-2.0 .
18 -->
19<helpdocument version="1.0">
20<meta>
21  <topic id="textshared0106140500xml" indexer="include" status="PUBLISH">
22  <title id="tit">Events</title>
23  <filename>/text/shared/01/06140500.xhp</filename>
24  </topic>
25</meta>
26<body>
27<section id="events">
28  <bookmark branch="index" id="bm_id3152427"><bookmark_value>customizing; events</bookmark_value>
29    <bookmark_value>events; customizing</bookmark_value>
30  </bookmark>
31  <bookmark branch="hid/cui/ui/eventsconfigpage/EventsConfigPage" id="bm_id1163922274" localize="false"/>
32  <bookmark branch="hid/cui/ui/macroassignpage/MacroAssignPage" id="bm_id1163922276" localize="false"/>
33  <bookmark branch="hid/cui/ui/macroassignpage/@@nowidget@@" id="bm_id1163922276" localize="false"/>
34  <bookmark branch="hid/cui/ui/macroassigndialog/MacroAssignDialog" id="bm_id1163922277" localize="false"/>
35  <bookmark branch="hid/cui/ui/macroassigndialog/@@nowidget@@" id="bm_id1163922277" localize="false"/>
36  <h1 id="hd_id3152427"><variable id="h1"><link href="text/shared/01/06140500.xhp">Events</link></variable></h1>
37  <paragraph role="paragraph" id="par_id3152937"><variable id="assignaction"><ahelp hid=".">Assigns macros to program events. The assigned macro runs automatically every time the selected event occurs.</ahelp></variable></paragraph>
38</section>
39<section id="howtoget">
40  <embed href="text/shared/00/00000406.xhp#events"/>
41  <!-- Choose Dialog Editor - Properties View - Events tab. -->
42</section>
43<switch select="appl">
44  <case select="CALC">
45    <embed href="text/scalc/01/events_sheet.xhp#sheetevents"/>
46  </case>
47</switch>
48<bookmark branch="hid/cui/ui/eventsconfigpage/savein" id="bm_id1163975" localize="false"/><h2 id="par_idN1060A">Save In</h2>
49<paragraph role="paragraph" id="par_idN1060E"><ahelp hid="cui/ui/eventsconfigpage/savein">Select first where to save the event binding, in the current document or in %PRODUCTNAME.</ahelp></paragraph>
50<note id="par_id3153662">A macro that is saved with a document can only be run when that document is opened.</note>
51<bookmark branch="hid/cui/ui/eventsconfigpage/events" id="bm_id1800286" localize="false"/>
52<bookmark branch="hid/cui/ui/macroassignpage/assignments" id="bm_id18002861" localize="false"/>
53<bookmark branch="hid/CUI_HID_MACRO_HEADERTABLISTBOX" id="bm_id1800287" localize="false"/>
54<paragraph role="paragraph" id="par_idN1061A"><ahelp hid=".">The big list box lists the events and the assigned macros. After you selected the location in the <emph>Save In</emph> list box, select an event in the big list box. Then click <emph>Assign Macro</emph>.</ahelp></paragraph>
55<bookmark branch="hid/cui/ui/macroassignpage/assign" id="bm_id755672891" localize="false"/>
56<bookmark branch="hid/cui/ui/eventsconfigpage/macro" id="bm_id752891" localize="false"/>
57<h2 id="hd_id3159258">Assign Macro</h2>
58<paragraph role="paragraph" id="par_id3156152"><ahelp hid=".">Opens the <link href="text/shared/01/06130020.xhp">Macro Selector</link> dialog to assign a macro to the selected event.</ahelp></paragraph>
59<bookmark branch="hid/ cui/ui/assigncomponentdialog/@@nowidget@@" id="bm_id411685039364972" localize="false"/>
60<h2 id="hd_id751568966764822">Assign Component...</h2>
61<paragraph role="paragraph" id="par_id111568966885228">Opens the <literal>Assign Component</literal> dialog to set a <link href="text/sbasic/python/python_handler.xhp">custom UNO command</link> for the selected event.</paragraph>
62<note id="par_id291568910019716">Component assignment is proposed for controls in the Dialog Editor.</note>
63<bookmark branch="hid/cui/ui/eventsconfigpage/delete" id="bm_id9109164.00000001" localize="false"/>
64<bookmark branch="hid/cui/ui/macroassignpage/delete" id="bm_id9109164341" localize="false"/>
65<h2 id="hd_id3154046">Remove Macro</h2>
66<paragraph role="paragraph" id="par_id3152349"><ahelp hid=".">Deletes the macro or component assignment for the selected event.</ahelp></paragraph>
67<section id="relatedtopics">
68<paragraph role="paragraph" id="par_id3159147"><link href="text/swriter/01/05060700.xhp">List of events</link></paragraph>
69<embed href="text/shared/guide/configure_overview.xhp#configure_overview"/>
70  <paragraph role="paragraph" id="par_id831568910303156"><link href="text/sbasic/python/python_handler.xhp">Creating a Dialog Handler</link></paragraph>
71  <paragraph role="paragraph" id="par_id731685035928996" localize="false"><embedvar href="text/scalc/01/events_sheet.xhp#h1" markup="ignore"/></paragraph>
72</section>
73</body>
74</helpdocument>
75