Open Tools - Macros - LibreOffice Basic - Edit and select Application Macros container.
Biblioteki ScriptForge rozšěrjomnu zběrku skriptowych resursow makrow za LibreOffice tworja, zo bychu so přez makra Basic abo skripty Python wuwołali.
• Makra Basic sej wužaduja, zo so biblioteka ScriptForge z pomocu slědowaceho přikaza začituje: GlobalScope.BasicLibraries.loadLibrary("ScriptForge")
• Skripty Python sej import z modula scriptforge wužaduja: from scriptforge import CreateScriptService
Zo byšće wjace wo tym zhonił, kak móžeće skripty Python z pomocu biblioteki ScriptForge wutworić a wuwjesć, čitajće stronu pomocy Skripty Python ze ScriptForge wutworić.
Słužby ScriptForge wuwołać
Wopisane module a klasy so přez wužiwarske skripty jako „Słužby“ wuwołuja. Powšitkowny konstruktor tutych słužbow je so za tón zaměr z kóždu rěč naćisnył.
Metoda Dispose je we wšěch słužbach k dispoziciji a měła so wołać, zo by resursy po wužiwanju wuswobodźiła:
Skići zběrku metodow za manipulaciju a přetworjenje matriksow z jednej dimensiju (wektory) a matriksy z dwěmaj dimensijomaj (matriksy). To operacije set, sortěrowanje, importowanje z a eksportowanje do tekstowych datajow wopřijima.
Matriksy z wjace hač dwěmaj dimensijomaj njedadźa so z metodami w tutej słužbje wužiwać, jeničke wuwzaće je metoda CountDims, kotraž matriksy z někajkejžkuli ličbu dimensijow akceptuje.
Słužba Base rjad metodow a kajkosćow skići, kotrež rjadowanje dokumentow LibreOffice Base a wobchadźenje z nimi wosnadnjeja.
Tuta słužba je wusko ze słužbu Document zwjazana, kotraž generiske metody za wobchadźenje z dokumentami LibreOffice skići, inkluziwnje dokumenty Base. Tohodla słužba Base słužbu Document rozšěrja a skićo přidatne metody, kotrež su specifiske za dokumenty Base a wužiwarjam zmóžnjeja:
Přistup k datowej bance dóstać, kotraž je w dokumenće Base wobsahowana.
Formularowe dokumenty wočinić, kotrež su w dokumenće Base składowane.
Přepruwować, hač formularowy dokument z dokumenta Base je tuchwilu začitany.
Słužba ScriptForge.Basic zběrku metodow LibreOffice Basic namjetuje, kotrež so maja w konteksće Python wuwjesć. Metody słužby Basic eksaktnu syntaksu a zadźerženje zatwarjenych funkcijow Basic reprodukuja.
Zhromadnje wužita biblioteka SFDocuments rjad metodow a kajkosćow skići, kotrež rjadowanje dokumentow LibreOffice a wobchadźenje z nimi wosnadnjeja.
Słužba SFDocuments.Calc je podklasa słužby SFDocuments.Document. Ke wšěm metodam a kajkosćam, kotrež so za słužbu Document definuja, maće z pomocu słužboweje instancy Calc přistup.
Słužba Calc koncentruje so na:
Wobchadźenje z tabelemi w dokumenće Calc (kopěrować, zasadźić, přesunyć atd.)
Wuměnjenje datow mjez datowymi strukturami Basic a wobłukami Calc
Kopěrowanje a importowanje njesměrnych datowych mnóstwow
Słužba Datasheet zmóžnja, wobsah tabelow datoweje banki kaž tež wuslědki wotprašowanjow a SQL-přikazy z pomocu datoweho napohlada Base wizualizować. Nimo toho tuta słužba zmóžnja:
Datowemu napohladej swójske menije přidać.
Přistup k hódnotam we wěstych pozicijach datoweho napohlada dóstać.
Kursor we wěstej celi datoweho napohlada pozicioněrować.
Słužba Dialog k rjadowanju dialogow přinošuje, kotrež su so přez dialogowy editor Basic wutworili abo přez dialogi, kotrež su so nimoducy wutworili. Kóžda instanca aktualneje klasy jednotliwy dialogowe polo reprezentuje, kotrež so wužiwarjej pokazuje.
Słužba DialogControl wodźenske elementy rjaduje, kotrež k dialogej słušeja, kotryž so z dialogowym editorom Basic definuje. Kóžda instanca aktualneje słužby jednotliwy wodźenski element w dialogowym polu reprezentuje.
Fokus na wotwołowanje a nastajenje hódnotow leži, kotrež so přez wodźenske elementy dialogoweho pola pokazuja. Formatěrowanje je přistupne přez kajkosći XControlModel a XControlView.
Dźiwajće na to, zo wobsah jónkróćneje kajkosće DialogControl.Value po wobsahowym typje wariěruje.
Wosebita kedźbnosć so na wodźenske elementy typa štom złožuje. Je lochko, štom pjelnić, pak hałuzu po hałuzy pak ze sadźbu hałuzow naraz. Pjelnjenje štomoweho wodźenskeho elementa da so statisce abo dynamisce wuwjesć.
Biblioteka SFDocuments metody a kajkosće skići, kotrež rjadowanje a wobdźěłowanje dokumentow LibreOffice wosnadnić.
Metody, kotrež su na wšě typy dokumentow (tekstowe dokumenty, tabelowe dokumenty, prezentacije atd.) nałožujomne, kotrež słužba SFDocuments.Document k dispoziciji staja. Někotre přikłady su:
Dokumenty wočinić, začinić a składować
Přistup k standardnym abo swójskim kajkosćam dokumentow
Słužba Exception je zběrka metodow, kotrež při pytanju za zmylkami w kodźe skriptow Basic a Python a při wobchadźenju ze zmylkami w skriptach Basic pomhaja.
Hdyž w skriptach Basic wuwjedźenskočasowy zmylk nastawa, pomhaja metody a kajkosće słužby Exception zmylkowy kontekst identifikować a dowolić, z nim wobchadźeć.
The Form service provides methods and properties to manage forms in LibreOffice documents. This service supports forms in Base, Calc and Writer documents and allows to:
The FormControl service provides access to the controls that belong to a form, a subform or a table control of a FormDocument. Each instance of the FormControl service refers to a single control in the form. This service allows users to:
Get and set the properties of the control represented by the FormControl instance.
Access the current value displayed by the control.
The FormDocument service allows to access form documents stored in LibreOffice Base documents.
In a Base document, existing form documents can be viewed by selecting View - Forms in the user interface. Each form document may be composed of one or more forms, including the main form and other sub-forms.
This service provides a number of methods related to the translation of strings with minimal impact on the program's source code. The methods provided by the L10N service can be used mainly to:
Create POT files that can be used as templates for translation of all strings in the program.
Get translated strings at runtime for the language defined in the Locale property.
The Menu service can be used to create and remove menus from the menubar of a LibreOffice document window. Each menu entry can be associated with a script or with a UNO command. This service provides the following capabilities:
Creation of menus with custom entries, checkboxes, radio buttons and separators.
The PopupMenu service can be used to create popup menus that can be associated with events or executed by scripts. This service provides the following capabilities:
Creation of popup menus with custom entries, checkboxes and radio buttons.
The main purpose of the Services module is to provide access to the CreateScriptService method, which can be called in user scripts to instantiate services that are implemented using the ScriptForge framework.
The Toolbar service allows to retrieve information related to the toolbars available for a specific document window. With this service it is possible to:
Toggle the visibility of specific toolbars.
Access information about the buttons available in each toolbar.
The ToolbarButton service allows to retrieve information related to the toolbar buttons available in a given toolbar. With this service it is possible to:
Toggle the visibility of toolbar elements.
Execute the command associated with a given toolbar button.
The UI (User Interface) service simplifies the identification and the manipulation of the different windows composing the whole LibreOffice application:
The SFDocuments shared library provides a number of methods and properties to facilitate the management and handling of LibreOffice documents.
Some methods are generic for all types of documents and are inherited from the SF_Document module, whereas other methods that are specific for Writer documents are defined in the SF_Writer module.
Kedźbu: Druhe njewopisane module ScriptForge su za interne wužiwanje wuměnjene. Jich wobsah da so bjez zdźělenki změnić.
Wšě rutiny Basic ScriptForge abo identifikatory, kotrež so z podsmužku „_“ započinaja, su za interne wužiwanje wuměnjene. Njejsu za to myslene, so w makrach Basic abo skriptach Python wužiwać.
