1cdf0e10cSrcweir<?xml version="1.0" encoding="UTF-8"?> 2cdf0e10cSrcweir 3d33d0967SAndrew Rist<!--*********************************************************** 4a136aadcSmseidel * 5d33d0967SAndrew Rist * Licensed to the Apache Software Foundation (ASF) under one 6d33d0967SAndrew Rist * or more contributor license agreements. See the NOTICE file 7d33d0967SAndrew Rist * distributed with this work for additional information 8d33d0967SAndrew Rist * regarding copyright ownership. The ASF licenses this file 9d33d0967SAndrew Rist * to you under the Apache License, Version 2.0 (the 10d33d0967SAndrew Rist * "License"); you may not use this file except in compliance 11d33d0967SAndrew Rist * with the License. You may obtain a copy of the License at 12a136aadcSmseidel * 13d33d0967SAndrew Rist * http://www.apache.org/licenses/LICENSE-2.0 14a136aadcSmseidel * 15d33d0967SAndrew Rist * Unless required by applicable law or agreed to in writing, 16d33d0967SAndrew Rist * software distributed under the License is distributed on an 17d33d0967SAndrew Rist * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY 18d33d0967SAndrew Rist * KIND, either express or implied. See the License for the 19d33d0967SAndrew Rist * specific language governing permissions and limitations 20d33d0967SAndrew Rist * under the License. 21a136aadcSmseidel * 22d33d0967SAndrew Rist ***********************************************************--> 23d33d0967SAndrew Rist 24a136aadcSmseidel<helpdocument version="1.0"> 25cdf0e10cSrcweir<meta> 26cdf0e10cSrcweir<topic id="textsbasicshared01030400xml" indexer="include" status="PUBLISH"> 27cdf0e10cSrcweir<title id="tit" xml-lang="en-US">Organizing Libraries and Modules</title> 28cdf0e10cSrcweir<filename>/text/sbasic/shared/01030400.xhp</filename> 29cdf0e10cSrcweir</topic> 30cdf0e10cSrcweir</meta> 31cdf0e10cSrcweir<body> 32cdf0e10cSrcweir<section id="anlegenverwalten"> 33*e91968a5Smseidel<bookmark xml-lang="en-US" branch="index" id="bm_id3148797"> 34*e91968a5Smseidel<bookmark_value>libraries;organizing</bookmark_value> 35cdf0e10cSrcweir<bookmark_value>modules;organizing</bookmark_value> 36cdf0e10cSrcweir<bookmark_value>copying;modules</bookmark_value> 37cdf0e10cSrcweir<bookmark_value>adding libraries</bookmark_value> 38cdf0e10cSrcweir<bookmark_value>deleting;libraries/modules/dialogs</bookmark_value> 39cdf0e10cSrcweir<bookmark_value>dialogs;organizing</bookmark_value> 40cdf0e10cSrcweir<bookmark_value>moving;modules</bookmark_value> 41cdf0e10cSrcweir<bookmark_value>organizing;modules/libraries/dialogs</bookmark_value> 42cdf0e10cSrcweir<bookmark_value>renaming modules and dialogs</bookmark_value> 43cdf0e10cSrcweir</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> 44cdf0e10cSrcweir</variable></paragraph> 45cdf0e10cSrcweir</section> 46cdf0e10cSrcweir<paragraph role="heading" id="hd_id3150868" xml-lang="en-US" level="2" l10n="U" oldref="4">Organizing Libraries</paragraph> 47cdf0e10cSrcweir<paragraph role="heading" id="hd_id3125864" xml-lang="en-US" level="3" l10n="U" oldref="5">Creating a New Library</paragraph> 48cdf0e10cSrcweir<list type="ordered"> 49cdf0e10cSrcweir<listitem> 50cdf0e10cSrcweir<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> 51cdf0e10cSrcweir</listitem> 52cdf0e10cSrcweir<listitem> 53cdf0e10cSrcweir<paragraph role="listitem" id="par_id3153726" xml-lang="en-US" l10n="U" oldref="8">Click the <emph>Libraries</emph> tab.</paragraph> 54cdf0e10cSrcweir</listitem> 55cdf0e10cSrcweir<listitem> 56cdf0e10cSrcweir<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 & 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> 57cdf0e10cSrcweir</listitem> 58cdf0e10cSrcweir<listitem> 59cdf0e10cSrcweir<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> 60cdf0e10cSrcweir</listitem> 61cdf0e10cSrcweir</list> 62cdf0e10cSrcweir<paragraph role="heading" id="hd_id3147394" xml-lang="en-US" level="3" l10n="U" oldref="48">Appending a Library</paragraph> 63cdf0e10cSrcweir<list type="ordered"> 64cdf0e10cSrcweir<listitem> 65cdf0e10cSrcweir<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> 66cdf0e10cSrcweir</listitem> 67cdf0e10cSrcweir<listitem> 68cdf0e10cSrcweir<paragraph role="listitem" id="par_id3146972" xml-lang="en-US" l10n="U" oldref="50">Click the <emph>Libraries</emph> tab.</paragraph> 69cdf0e10cSrcweir</listitem> 70cdf0e10cSrcweir<listitem> 71cdf0e10cSrcweir<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 & 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> 72cdf0e10cSrcweir</listitem> 73cdf0e10cSrcweir<listitem> 74cdf0e10cSrcweir<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> 75cdf0e10cSrcweir</listitem> 76cdf0e10cSrcweir<listitem> 77cdf0e10cSrcweir<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> 78cdf0e10cSrcweir</listitem> 79cdf0e10cSrcweir<listitem> 80cdf0e10cSrcweir<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> 81cdf0e10cSrcweir</listitem> 82cdf0e10cSrcweir<listitem> 83cdf0e10cSrcweir<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> 84cdf0e10cSrcweir</listitem> 85cdf0e10cSrcweir<listitem> 86cdf0e10cSrcweir<paragraph role="listitem" id="par_id3147004" xml-lang="en-US" l10n="U" oldref="56">Click <emph>OK</emph> to append the library.</paragraph> 87cdf0e10cSrcweir</listitem> 88cdf0e10cSrcweir</list> 89cdf0e10cSrcweir<paragraph role="heading" id="hd_id3159100" xml-lang="en-US" level="3" l10n="U" oldref="17">Deleting a Library</paragraph> 90cdf0e10cSrcweir<list type="ordered"> 91cdf0e10cSrcweir<listitem> 92cdf0e10cSrcweir<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> 93cdf0e10cSrcweir</listitem> 94cdf0e10cSrcweir<listitem> 95cdf0e10cSrcweir<paragraph role="listitem" id="par_id3146808" xml-lang="en-US" l10n="U" oldref="57">Click the <emph>Libraries</emph> tab.</paragraph> 96cdf0e10cSrcweir</listitem> 97cdf0e10cSrcweir<listitem> 98cdf0e10cSrcweir<paragraph role="listitem" id="par_id3158212" xml-lang="en-US" l10n="CHG" oldref="58">Select the library to be deleted from the list.</paragraph> 99cdf0e10cSrcweir</listitem> 100cdf0e10cSrcweir<listitem> 101cdf0e10cSrcweir<paragraph role="listitem" id="par_id3150361" xml-lang="en-US" l10n="U" oldref="20">Click <emph>Delete</emph>.</paragraph> 102cdf0e10cSrcweir</listitem> 103cdf0e10cSrcweir</list> 104cdf0e10cSrcweir<list type="unordered"> 105cdf0e10cSrcweir<listitem> 106cdf0e10cSrcweir<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> 107cdf0e10cSrcweir</listitem> 108cdf0e10cSrcweir<listitem> 109cdf0e10cSrcweir<paragraph role="listitem" id="par_id3148868" xml-lang="en-US" l10n="U" oldref="59">You cannot delete the default library named "Standard".</paragraph> 110cdf0e10cSrcweir</listitem> 111cdf0e10cSrcweir<listitem> 112cdf0e10cSrcweir<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> 113cdf0e10cSrcweir</listitem> 114cdf0e10cSrcweir</list> 115cdf0e10cSrcweir<paragraph role="heading" id="hd_id3147070" xml-lang="en-US" level="2" l10n="U" oldref="21">Organizing Modules and Dialogs</paragraph> 116cdf0e10cSrcweir<paragraph role="heading" id="hd_id3155265" xml-lang="en-US" level="3" l10n="U" oldref="61">Creating a New Module or Dialog</paragraph> 117cdf0e10cSrcweir<list type="ordered"> 118cdf0e10cSrcweir<listitem> 119cdf0e10cSrcweir<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> 120cdf0e10cSrcweir</listitem> 121cdf0e10cSrcweir<listitem> 122cdf0e10cSrcweir<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> 123cdf0e10cSrcweir</listitem> 124cdf0e10cSrcweir<listitem> 125cdf0e10cSrcweir<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> 126cdf0e10cSrcweir</listitem> 127cdf0e10cSrcweir<listitem> 128cdf0e10cSrcweir<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> 129cdf0e10cSrcweir</listitem> 130cdf0e10cSrcweir</list> 131cdf0e10cSrcweir<paragraph role="heading" id="hd_id3152872" xml-lang="en-US" level="3" l10n="U" oldref="25">Renaming a Module or Dialog</paragraph> 132cdf0e10cSrcweir<list type="ordered"> 133cdf0e10cSrcweir<listitem> 134cdf0e10cSrcweir<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> 135cdf0e10cSrcweir</listitem> 136cdf0e10cSrcweir<listitem> 137cdf0e10cSrcweir<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> 138cdf0e10cSrcweir<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> 139cdf0e10cSrcweir</listitem> 140cdf0e10cSrcweir<listitem> 141cdf0e10cSrcweir<paragraph role="listitem" id="par_id3155526" xml-lang="en-US" l10n="U" oldref="28">Press Enter to confirm your changes.</paragraph> 142cdf0e10cSrcweir</listitem> 143cdf0e10cSrcweir</list> 144cdf0e10cSrcweir<paragraph role="heading" id="hd_id3146963" xml-lang="en-US" level="3" l10n="U" oldref="29">Deleting a Module or Dialog</paragraph> 145cdf0e10cSrcweir<list type="ordered"> 146cdf0e10cSrcweir<listitem> 147cdf0e10cSrcweir<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> 148cdf0e10cSrcweir</listitem> 149cdf0e10cSrcweir<listitem> 150cdf0e10cSrcweir<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> 151cdf0e10cSrcweir</listitem> 152cdf0e10cSrcweir<listitem> 153cdf0e10cSrcweir<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> 154cdf0e10cSrcweir</listitem> 155cdf0e10cSrcweir<listitem> 156cdf0e10cSrcweir<paragraph role="listitem" id="par_id3147248" xml-lang="en-US" l10n="U" oldref="32">Click <emph>Delete</emph>.</paragraph> 157cdf0e10cSrcweir</listitem> 158cdf0e10cSrcweir</list> 159cdf0e10cSrcweir<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> 160cdf0e10cSrcweir<paragraph role="heading" id="hd_id3151392" xml-lang="en-US" level="2" l10n="U" oldref="33">Organizing Projects among Documents or Templates</paragraph> 161cdf0e10cSrcweir<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> 162cdf0e10cSrcweir<list type="ordered"> 163cdf0e10cSrcweir<listitem> 164cdf0e10cSrcweir<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> 165cdf0e10cSrcweir</listitem> 166cdf0e10cSrcweir<listitem> 167cdf0e10cSrcweir<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> 168cdf0e10cSrcweir</listitem> 169cdf0e10cSrcweir<listitem> 170cdf0e10cSrcweir<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> 171cdf0e10cSrcweir</listitem> 172cdf0e10cSrcweir</list> 173cdf0e10cSrcweir</body> 174cdf0e10cSrcweir</helpdocument> 175