1*cdf0e10cSrcweir<?xml version="1.0" encoding="UTF-8"?> 2*cdf0e10cSrcweir 3*cdf0e10cSrcweir 4*cdf0e10cSrcweir 5*cdf0e10cSrcweir<!-- 6*cdf0e10cSrcweir *********************************************************************** 7*cdf0e10cSrcweir * 8*cdf0e10cSrcweir * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. 9*cdf0e10cSrcweir * 10*cdf0e10cSrcweir * Copyright 2000, 2010 Oracle and/or its affiliates. 11*cdf0e10cSrcweir * 12*cdf0e10cSrcweir * OpenOffice.org - a multi-platform office productivity suite 13*cdf0e10cSrcweir * 14*cdf0e10cSrcweir * This file is part of OpenOffice.org. 15*cdf0e10cSrcweir * 16*cdf0e10cSrcweir * OpenOffice.org is free software: you can redistribute it and/or modify 17*cdf0e10cSrcweir * it under the terms of the GNU Lesser General Public License version 3 18*cdf0e10cSrcweir * only, as published by the Free Software Foundation. 19*cdf0e10cSrcweir * 20*cdf0e10cSrcweir * OpenOffice.org is distributed in the hope that it will be useful, 21*cdf0e10cSrcweir * but WITHOUT ANY WARRANTY; without even the implied warranty of 22*cdf0e10cSrcweir * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 23*cdf0e10cSrcweir * GNU Lesser General Public License version 3 for more details 24*cdf0e10cSrcweir * (a copy is included in the LICENSE file that accompanied this code). 25*cdf0e10cSrcweir * 26*cdf0e10cSrcweir * You should have received a copy of the GNU Lesser General Public License 27*cdf0e10cSrcweir * version 3 along with OpenOffice.org. If not, see 28*cdf0e10cSrcweir * <http://www.openoffice.org/license.html> 29*cdf0e10cSrcweir * for a copy of the LGPLv3 License. 30*cdf0e10cSrcweir * 31*cdf0e10cSrcweir ************************************************************************ 32*cdf0e10cSrcweir --> 33*cdf0e10cSrcweir 34*cdf0e10cSrcweir 35*cdf0e10cSrcweir <helpdocument version="1.0"> 36*cdf0e10cSrcweir<meta> 37*cdf0e10cSrcweir<topic id="textsbasicshared01030400xml" indexer="include" status="PUBLISH"> 38*cdf0e10cSrcweir<title id="tit" xml-lang="en-US">Organizing Libraries and Modules</title> 39*cdf0e10cSrcweir<filename>/text/sbasic/shared/01030400.xhp</filename> 40*cdf0e10cSrcweir</topic> 41*cdf0e10cSrcweir</meta> 42*cdf0e10cSrcweir<body> 43*cdf0e10cSrcweir<section id="anlegenverwalten"> 44*cdf0e10cSrcweir<bookmark xml-lang="en-US" branch="index" id="bm_id3148797"><bookmark_value>libraries;organizing</bookmark_value> 45*cdf0e10cSrcweir<bookmark_value>modules;organizing</bookmark_value> 46*cdf0e10cSrcweir<bookmark_value>copying;modules</bookmark_value> 47*cdf0e10cSrcweir<bookmark_value>adding libraries</bookmark_value> 48*cdf0e10cSrcweir<bookmark_value>deleting;libraries/modules/dialogs</bookmark_value> 49*cdf0e10cSrcweir<bookmark_value>dialogs;organizing</bookmark_value> 50*cdf0e10cSrcweir<bookmark_value>moving;modules</bookmark_value> 51*cdf0e10cSrcweir<bookmark_value>organizing;modules/libraries/dialogs</bookmark_value> 52*cdf0e10cSrcweir<bookmark_value>renaming modules and dialogs</bookmark_value> 53*cdf0e10cSrcweir</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*cdf0e10cSrcweir</variable></paragraph> 55*cdf0e10cSrcweir</section> 56*cdf0e10cSrcweir<paragraph role="heading" id="hd_id3150868" xml-lang="en-US" level="2" l10n="U" oldref="4">Organizing Libraries</paragraph> 57*cdf0e10cSrcweir<paragraph role="heading" id="hd_id3125864" xml-lang="en-US" level="3" l10n="U" oldref="5">Creating a New Library</paragraph> 58*cdf0e10cSrcweir<list type="ordered"> 59*cdf0e10cSrcweir<listitem> 60*cdf0e10cSrcweir<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*cdf0e10cSrcweir</listitem> 62*cdf0e10cSrcweir<listitem> 63*cdf0e10cSrcweir<paragraph role="listitem" id="par_id3153726" xml-lang="en-US" l10n="U" oldref="8">Click the <emph>Libraries</emph> tab.</paragraph> 64*cdf0e10cSrcweir</listitem> 65*cdf0e10cSrcweir<listitem> 66*cdf0e10cSrcweir<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> 67*cdf0e10cSrcweir</listitem> 68*cdf0e10cSrcweir<listitem> 69*cdf0e10cSrcweir<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*cdf0e10cSrcweir</listitem> 71*cdf0e10cSrcweir</list> 72*cdf0e10cSrcweir<paragraph role="heading" id="hd_id3147394" xml-lang="en-US" level="3" l10n="U" oldref="48">Appending a Library</paragraph> 73*cdf0e10cSrcweir<list type="ordered"> 74*cdf0e10cSrcweir<listitem> 75*cdf0e10cSrcweir<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*cdf0e10cSrcweir</listitem> 77*cdf0e10cSrcweir<listitem> 78*cdf0e10cSrcweir<paragraph role="listitem" id="par_id3146972" xml-lang="en-US" l10n="U" oldref="50">Click the <emph>Libraries</emph> tab.</paragraph> 79*cdf0e10cSrcweir</listitem> 80*cdf0e10cSrcweir<listitem> 81*cdf0e10cSrcweir<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> 82*cdf0e10cSrcweir</listitem> 83*cdf0e10cSrcweir<listitem> 84*cdf0e10cSrcweir<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*cdf0e10cSrcweir</listitem> 86*cdf0e10cSrcweir<listitem> 87*cdf0e10cSrcweir<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*cdf0e10cSrcweir</listitem> 89*cdf0e10cSrcweir<listitem> 90*cdf0e10cSrcweir<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*cdf0e10cSrcweir</listitem> 92*cdf0e10cSrcweir<listitem> 93*cdf0e10cSrcweir<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*cdf0e10cSrcweir</listitem> 95*cdf0e10cSrcweir<listitem> 96*cdf0e10cSrcweir<paragraph role="listitem" id="par_id3147004" xml-lang="en-US" l10n="U" oldref="56">Click <emph>OK</emph> to append the library.</paragraph> 97*cdf0e10cSrcweir</listitem> 98*cdf0e10cSrcweir</list> 99*cdf0e10cSrcweir<paragraph role="heading" id="hd_id3159100" xml-lang="en-US" level="3" l10n="U" oldref="17">Deleting a Library</paragraph> 100*cdf0e10cSrcweir<list type="ordered"> 101*cdf0e10cSrcweir<listitem> 102*cdf0e10cSrcweir<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*cdf0e10cSrcweir</listitem> 104*cdf0e10cSrcweir<listitem> 105*cdf0e10cSrcweir<paragraph role="listitem" id="par_id3146808" xml-lang="en-US" l10n="U" oldref="57">Click the <emph>Libraries</emph> tab.</paragraph> 106*cdf0e10cSrcweir</listitem> 107*cdf0e10cSrcweir<listitem> 108*cdf0e10cSrcweir<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*cdf0e10cSrcweir</listitem> 110*cdf0e10cSrcweir<listitem> 111*cdf0e10cSrcweir<paragraph role="listitem" id="par_id3150361" xml-lang="en-US" l10n="U" oldref="20">Click <emph>Delete</emph>.</paragraph> 112*cdf0e10cSrcweir</listitem> 113*cdf0e10cSrcweir</list> 114*cdf0e10cSrcweir<list type="unordered"> 115*cdf0e10cSrcweir<listitem> 116*cdf0e10cSrcweir<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*cdf0e10cSrcweir</listitem> 118*cdf0e10cSrcweir<listitem> 119*cdf0e10cSrcweir<paragraph role="listitem" id="par_id3148868" xml-lang="en-US" l10n="U" oldref="59">You cannot delete the default library named "Standard".</paragraph> 120*cdf0e10cSrcweir</listitem> 121*cdf0e10cSrcweir<listitem> 122*cdf0e10cSrcweir<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*cdf0e10cSrcweir</listitem> 124*cdf0e10cSrcweir</list> 125*cdf0e10cSrcweir<paragraph role="heading" id="hd_id3147070" xml-lang="en-US" level="2" l10n="U" oldref="21">Organizing Modules and Dialogs</paragraph> 126*cdf0e10cSrcweir<paragraph role="heading" id="hd_id3155265" xml-lang="en-US" level="3" l10n="U" oldref="61">Creating a New Module or Dialog</paragraph> 127*cdf0e10cSrcweir<list type="ordered"> 128*cdf0e10cSrcweir<listitem> 129*cdf0e10cSrcweir<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*cdf0e10cSrcweir</listitem> 131*cdf0e10cSrcweir<listitem> 132*cdf0e10cSrcweir<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*cdf0e10cSrcweir</listitem> 134*cdf0e10cSrcweir<listitem> 135*cdf0e10cSrcweir<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*cdf0e10cSrcweir</listitem> 137*cdf0e10cSrcweir<listitem> 138*cdf0e10cSrcweir<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*cdf0e10cSrcweir</listitem> 140*cdf0e10cSrcweir</list> 141*cdf0e10cSrcweir<paragraph role="heading" id="hd_id3152872" xml-lang="en-US" level="3" l10n="U" oldref="25">Renaming a Module or Dialog</paragraph> 142*cdf0e10cSrcweir<list type="ordered"> 143*cdf0e10cSrcweir<listitem> 144*cdf0e10cSrcweir<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*cdf0e10cSrcweir</listitem> 146*cdf0e10cSrcweir<listitem> 147*cdf0e10cSrcweir<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*cdf0e10cSrcweir<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*cdf0e10cSrcweir</listitem> 150*cdf0e10cSrcweir<listitem> 151*cdf0e10cSrcweir<paragraph role="listitem" id="par_id3155526" xml-lang="en-US" l10n="U" oldref="28">Press Enter to confirm your changes.</paragraph> 152*cdf0e10cSrcweir</listitem> 153*cdf0e10cSrcweir</list> 154*cdf0e10cSrcweir<paragraph role="heading" id="hd_id3146963" xml-lang="en-US" level="3" l10n="U" oldref="29">Deleting a Module or Dialog</paragraph> 155*cdf0e10cSrcweir<list type="ordered"> 156*cdf0e10cSrcweir<listitem> 157*cdf0e10cSrcweir<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*cdf0e10cSrcweir</listitem> 159*cdf0e10cSrcweir<listitem> 160*cdf0e10cSrcweir<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*cdf0e10cSrcweir</listitem> 162*cdf0e10cSrcweir<listitem> 163*cdf0e10cSrcweir<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*cdf0e10cSrcweir</listitem> 165*cdf0e10cSrcweir<listitem> 166*cdf0e10cSrcweir<paragraph role="listitem" id="par_id3147248" xml-lang="en-US" l10n="U" oldref="32">Click <emph>Delete</emph>.</paragraph> 167*cdf0e10cSrcweir</listitem> 168*cdf0e10cSrcweir</list> 169*cdf0e10cSrcweir<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*cdf0e10cSrcweir<paragraph role="heading" id="hd_id3151392" xml-lang="en-US" level="2" l10n="U" oldref="33">Organizing Projects among Documents or Templates</paragraph> 171*cdf0e10cSrcweir<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*cdf0e10cSrcweir<list type="ordered"> 173*cdf0e10cSrcweir<listitem> 174*cdf0e10cSrcweir<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*cdf0e10cSrcweir</listitem> 176*cdf0e10cSrcweir<listitem> 177*cdf0e10cSrcweir<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*cdf0e10cSrcweir</listitem> 179*cdf0e10cSrcweir<listitem> 180*cdf0e10cSrcweir<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*cdf0e10cSrcweir</listitem> 182*cdf0e10cSrcweir</list> 183*cdf0e10cSrcweir</body> 184*cdf0e10cSrcweir</helpdocument> 185