1<?xml version="1.0" encoding="UTF-8"?>
2
3
4
5<!--
6 ***********************************************************************
7 *
8 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
9 *
10 * Copyright 2000, 2010 Oracle and/or its affiliates.
11 *
12 * OpenOffice.org - a multi-platform office productivity suite
13 *
14 * This file is part of OpenOffice.org.
15 *
16 * OpenOffice.org is free software: you can redistribute it and/or modify
17 * it under the terms of the GNU Lesser General Public License version 3
18 * only, as published by the Free Software Foundation.
19 *
20 * OpenOffice.org is distributed in the hope that it will be useful,
21 * but WITHOUT ANY WARRANTY; without even the implied warranty of
22 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
23 * GNU Lesser General Public License version 3 for more details
24 * (a copy is included in the LICENSE file that accompanied this code).
25 *
26 * You should have received a copy of the GNU Lesser General Public License
27 * version 3 along with OpenOffice.org.  If not, see
28 * <http://www.openoffice.org/license.html>
29 * for a copy of the LGPLv3 License.
30 *
31 ************************************************************************
32 -->
33
34
35		<helpdocument version="1.0">
36<meta>
37<topic id="textsbasicshared01030400xml" indexer="include" status="PUBLISH">
38<title id="tit" xml-lang="en-US">Organizing Libraries and Modules</title>
39<filename>/text/sbasic/shared/01030400.xhp</filename>
40</topic>
41</meta>
42<body>
43<section id="anlegenverwalten">
44<bookmark xml-lang="en-US" branch="index" id="bm_id3148797"><bookmark_value>libraries;organizing</bookmark_value>
45<bookmark_value>modules;organizing</bookmark_value>
46<bookmark_value>copying;modules</bookmark_value>
47<bookmark_value>adding libraries</bookmark_value>
48<bookmark_value>deleting;libraries/modules/dialogs</bookmark_value>
49<bookmark_value>dialogs;organizing</bookmark_value>
50<bookmark_value>moving;modules</bookmark_value>
51<bookmark_value>organizing;modules/libraries/dialogs</bookmark_value>
52<bookmark_value>renaming modules and dialogs</bookmark_value>
53</bookmark><comment>mw changed"organizing;",  "dialogs;" and "renaming modules"</comment><paragraph role="heading" id="hd_id3148797" xml-lang="en-US" level="1" l10n="U" oldref="1"><variable id="01030400"><link href="text/sbasic/shared/01030400.xhp">Organizing Libraries and Modules</link>
54</variable></paragraph>
55</section>
56<paragraph role="heading" id="hd_id3150868" xml-lang="en-US" level="2" l10n="U" oldref="4">Organizing Libraries</paragraph>
57<paragraph role="heading" id="hd_id3125864" xml-lang="en-US" level="3" l10n="U" oldref="5">Creating a New Library</paragraph>
58<list type="ordered">
59<listitem>
60<paragraph role="listitem" id="par_id3152576" xml-lang="en-US" l10n="CHG" oldref="6">Choose <emph>Tools - Macros - Organize Macros - %PRODUCTNAME Basic</emph> and click <emph>Organizer</emph> or click the <emph>Select Module</emph> icon in the Basic IDE to open the <emph>Macro Organizer</emph> dialog.</paragraph>
61</listitem>
62<listitem>
63<paragraph role="listitem" id="par_id3153726" xml-lang="en-US" l10n="U" oldref="8">Click the <emph>Libraries</emph> tab.</paragraph>
64</listitem>
65<listitem>
66<paragraph role="listitem" id="par_id3149664" xml-lang="en-US" l10n="CHG" oldref="9">Select to where you want to attach the library in the <emph>Location</emph> list. If you select %PRODUCTNAME Macros &amp; Dialogs, the library will belong to the $[officename] application and will be available for all documents. If you select a document the library will be attached to this document and only available from there.</paragraph>
67</listitem>
68<listitem>
69<paragraph role="listitem" id="par_id3153365" xml-lang="en-US" l10n="U" oldref="10">Click <emph>New</emph> and insert a name to create a new library.</paragraph>
70</listitem>
71</list>
72<paragraph role="heading" id="hd_id3147394" xml-lang="en-US" level="3" l10n="U" oldref="48">Appending a Library</paragraph>
73<list type="ordered">
74<listitem>
75<paragraph role="listitem" id="par_id3153157" xml-lang="en-US" l10n="CHG" oldref="49">Choose <emph>Tools - Macros - Organize Macros - %PRODUCTNAME Basic</emph> and click <emph>Organizer</emph> or click the <emph>Select Module</emph> icon in the Basic IDE to open the <emph>Macro Organizer</emph> dialog.</paragraph>
76</listitem>
77<listitem>
78<paragraph role="listitem" id="par_id3146972" xml-lang="en-US" l10n="U" oldref="50">Click the <emph>Libraries</emph> tab.</paragraph>
79</listitem>
80<listitem>
81<paragraph role="listitem" id="par_id3145640" xml-lang="en-US" l10n="CHG" oldref="51">Select to where you want to append the library in the <emph>Location</emph> list. If you select %PRODUCTNAME Macros &amp; Dialogs, the library will belong to the $[officename] application and will be available for all documents. If you select a document the library will be appended to this document and only available from there.</paragraph>
82</listitem>
83<listitem>
84<paragraph role="listitem" id="par_id3154253" xml-lang="en-US" l10n="U" oldref="52">Click <emph>Append</emph> and select an external library to append.</paragraph>
85</listitem>
86<listitem>
87<paragraph role="listitem" id="par_id3154705" xml-lang="en-US" l10n="U" oldref="53">Select all libraries to be appended in the <emph>Append Libraries</emph> dialog. The dialog displays all libraries that are contained in the selected file.</paragraph>
88</listitem>
89<listitem>
90<paragraph role="listitem" id="par_id3163807" xml-lang="en-US" l10n="U" oldref="54">If you want to insert the library as a reference only check the <emph>Insert as reference (read-only)</emph> box. Read-only libraries are fully functional but cannot be modified in the Basic IDE.</paragraph>
91</listitem>
92<listitem>
93<paragraph role="listitem" id="par_id3145228" xml-lang="en-US" l10n="U" oldref="55">Check the <emph>Replace existing libraries</emph> box if you want existing libraries of the same name to be overwritten.</paragraph>
94</listitem>
95<listitem>
96<paragraph role="listitem" id="par_id3147004" xml-lang="en-US" l10n="U" oldref="56">Click <emph>OK</emph> to append the library.</paragraph>
97</listitem>
98</list>
99<paragraph role="heading" id="hd_id3159100" xml-lang="en-US" level="3" l10n="U" oldref="17">Deleting a Library</paragraph>
100<list type="ordered">
101<listitem>
102<paragraph role="listitem" id="par_id3150086" xml-lang="en-US" l10n="CHG" oldref="18">Choose <emph>Tools - Macros - Organize Macros - %PRODUCTNAME Basic</emph> and click <emph>Organizer</emph> or click the <emph>Select Module</emph> icon in the Basic IDE to open the <emph>Macro Organizer</emph> dialog.</paragraph>
103</listitem>
104<listitem>
105<paragraph role="listitem" id="par_id3146808" xml-lang="en-US" l10n="U" oldref="57">Click the <emph>Libraries</emph> tab.</paragraph>
106</listitem>
107<listitem>
108<paragraph role="listitem" id="par_id3158212" xml-lang="en-US" l10n="CHG" oldref="58">Select the library to be deleted from the list.</paragraph>
109</listitem>
110<listitem>
111<paragraph role="listitem" id="par_id3150361" xml-lang="en-US" l10n="U" oldref="20">Click <emph>Delete</emph>.</paragraph>
112</listitem>
113</list>
114<list type="unordered">
115<listitem>
116<paragraph role="listitem" id="par_id3152986" xml-lang="en-US" l10n="U" oldref="19">Deleting a library permanently deletes all existing modules and corresponding procedures and functions.</paragraph>
117</listitem>
118<listitem>
119<paragraph role="listitem" id="par_id3148868" xml-lang="en-US" l10n="U" oldref="59">You cannot delete the default library named "Standard".</paragraph>
120</listitem>
121<listitem>
122<paragraph role="listitem" id="par_id3146869" xml-lang="en-US" l10n="U" oldref="60">If you delete a library that was inserted as reference only the reference is deleted but not the library itself.</paragraph>
123</listitem>
124</list>
125<paragraph role="heading" id="hd_id3147070" xml-lang="en-US" level="2" l10n="U" oldref="21">Organizing Modules and Dialogs</paragraph>
126<paragraph role="heading" id="hd_id3155265" xml-lang="en-US" level="3" l10n="U" oldref="61">Creating a New Module or Dialog</paragraph>
127<list type="ordered">
128<listitem>
129<paragraph role="listitem" id="par_id3154537" xml-lang="en-US" l10n="CHG" oldref="62">Choose <emph>Tools - Macros - Organize Macros - %PRODUCTNAME Basic</emph> and click <emph>Organizer</emph> or click the <emph>Select Module</emph> icon in the Basic IDE to open the <emph>Macro Organizer</emph> dialog.</paragraph>
130</listitem>
131<listitem>
132<paragraph role="listitem" id="par_id3146781" xml-lang="en-US" l10n="CHG" oldref="63">Click the <emph>Modules</emph> tab or the <emph>Dialogs</emph> tab.</paragraph>
133</listitem>
134<listitem>
135<paragraph role="listitem" id="par_id3159206" xml-lang="en-US" l10n="CHG" oldref="64">Select the library where the module will be inserted and click <emph>New</emph>.</paragraph>
136</listitem>
137<listitem>
138<paragraph role="listitem" id="par_id3152389" xml-lang="en-US" l10n="U" oldref="65">Enter a name for the module or the dialog and click <emph>OK</emph>.</paragraph>
139</listitem>
140</list>
141<paragraph role="heading" id="hd_id3152872" xml-lang="en-US" level="3" l10n="U" oldref="25">Renaming a Module or Dialog</paragraph>
142<list type="ordered">
143<listitem>
144<paragraph role="listitem" id="par_id3159230" xml-lang="en-US" l10n="CHG" oldref="66">Choose <emph>Tools - Macros - Organize Macros - %PRODUCTNAME Basic</emph> and click <emph>Organizer</emph> or click the <emph>Select Module</emph> icon in the Basic IDE to open the <emph>Macro Organizer</emph> dialog.</paragraph>
145</listitem>
146<listitem>
147<paragraph role="listitem" id="par_id3150046" xml-lang="en-US" l10n="CHG" oldref="67">Click the module to be renamed twice, with a pause between the clicks. Enter the new name.</paragraph>
148<paragraph role="listitem" id="par_id3153801" xml-lang="en-US" l10n="CHG" oldref="27">In the Basic IDE, right-click the name of the module or dialog in the tabs at the bottom of the screen, choose <emph>Rename</emph> and type in the new name.</paragraph>
149</listitem>
150<listitem>
151<paragraph role="listitem" id="par_id3155526" xml-lang="en-US" l10n="U" oldref="28">Press Enter to confirm your changes.</paragraph>
152</listitem>
153</list>
154<paragraph role="heading" id="hd_id3146963" xml-lang="en-US" level="3" l10n="U" oldref="29">Deleting a Module or Dialog</paragraph>
155<list type="ordered">
156<listitem>
157<paragraph role="listitem" id="par_id3147547" xml-lang="en-US" l10n="CHG" oldref="68">Choose <emph>Tools - Macros - Organize Macros - %PRODUCTNAME Basic</emph> and click <emph>Organizer</emph> or click the <emph>Select Module</emph> icon in the Basic IDE to open the <emph>Macro Organizer</emph> dialog.</paragraph>
158</listitem>
159<listitem>
160<paragraph role="listitem" id="par_id3150958" xml-lang="en-US" l10n="CHG" oldref="69">Click the <emph>Modules</emph> tab or the <emph>Dialogs</emph> tab.</paragraph>
161</listitem>
162<listitem>
163<paragraph role="listitem" id="par_id3149870" xml-lang="en-US" l10n="CHG" oldref="30">Select the module or dialog to be deleted from the list. Double-click an entry to reveal sub-entries, if required.</paragraph>
164</listitem>
165<listitem>
166<paragraph role="listitem" id="par_id3147248" xml-lang="en-US" l10n="U" oldref="32">Click <emph>Delete</emph>.</paragraph>
167</listitem>
168</list>
169<paragraph role="warning" id="par_id3151339" xml-lang="en-US" l10n="U" oldref="31">Deleting a module permanently deletes all existing procedures and functions in that module.</paragraph>
170<paragraph role="heading" id="hd_id3151392" xml-lang="en-US" level="2" l10n="U" oldref="33">Organizing Projects among Documents or Templates</paragraph>
171<paragraph role="heading" id="hd_id3156400" xml-lang="en-US" level="3" l10n="U" oldref="36">Moving or copying modules between documents, templates and the application.</paragraph>
172<list type="ordered">
173<listitem>
174<paragraph role="listitem" id="par_id3146819" xml-lang="en-US" l10n="U" oldref="37">Open all documents or templates among which you want to move or copy the modules or dialogs.</paragraph>
175</listitem>
176<listitem>
177<paragraph role="listitem" id="par_id3149319" xml-lang="en-US" l10n="CHG" oldref="38">Choose <emph>Tools - Macros - Organize Macros - %PRODUCTNAME Basic</emph> and click <emph>Organizer</emph> or click the <emph>Select Module</emph> icon in the Basic IDE to open the <emph>Macro Organizer</emph> dialog.</paragraph>
178</listitem>
179<listitem>
180<paragraph role="listitem" id="par_id3145637" xml-lang="en-US" l10n="U" oldref="39">To move a module or dialog to another document, click the corresponding object in the list and drag it to the desired position. A horizontal line indicates the target position of the current object while dragging. Hold the <switchinline select="sys"><caseinline select="MAC">Command</caseinline><defaultinline>Ctrl</defaultinline></switchinline> key while dragging to copy the object instead of moving it.</paragraph>
181</listitem>
182</list>
183</body>
184</helpdocument>
185