Ang ScriptForge Aklatan

Para ma-access ang command na ito...

Bukas Mga Tool - Macros - LibreOffice Basic - I-edit at piliin Mga Macro ng Application lalagyan.

Ang mga aklatan ng ScriptForge ay bumubuo ng isang malawak na koleksyon ng mga mapagkukunan ng macro scripting para sa LibreOffice na ma-invoke mula sa mga Basic na macro o Python script.

• Ang mga pangunahing macro ay kailangang mag-load ScriptForge aklatan gamit ang sumusunod na pahayag:
GlobalScope.BasicLibraries.loadLibrary("ScriptForge")

• Ang mga script ng Python ay nangangailangan ng pag-import mula sa scriptforge module:
mula sa scriptforge import CreateScriptService

Upang matuto nang higit pa tungkol sa kung paano lumikha at magsagawa ng mga script ng Python gamit ang ScriptForge library, basahin ang pahina ng tulong Paglikha ng Python Scripts gamit ang ScriptForge .

Ang paggamit ng mga serbisyo ng ScriptForge

Ang inilarawan na mga module at klase ay ginagamit mula sa mga script ng user bilang "Mga Serbisyo". Ang isang generic na tagabuo ng mga serbisyong iyon ay idinisenyo para sa layuning iyon para sa bawat wika.

Ang Itapon Ang pamamaraan ay magagamit sa lahat ng mga serbisyo at dapat na tawagan upang magbakante ng mga mapagkukunan pagkatapos gamitin:

Sa Basic


    GlobalScope.BasicLibraries.LoadLibrary("ScriptForge")
    Set oSvc = CreateScriptService("servicename"[, arg0, arg1, ...])
    ' ...
    oSvc.Dispose()

Sa Python


    from scriptforge import CreateScriptService
    svc = CreateScriptService('servicename'[, arg0, arg1, ...])
    # ...
    svc.Dispose()

Mga serbisyong ibinibigay ng library ng ScriptForge

Kategoryang	Mga serbisyo
LibreOffice Basic	Array Dictionary	Exception FileSystem	String TextStream
Nilalaman ng Dokumento	Base Calc Chart	Database Dataset Datasheet	Document FormDocument Writer
User Interface	Dialog DialogControl Form	FormControl Menu PopupMenu	Toolbar ToolbarButton UI
Mga utility	Basic L10N Platform	Region Services Session	Timer UnitTest

ScriptForge . Array serbisyo

Nagbibigay ng koleksyon ng mga pamamaraan para sa pagmamanipula at pagbabago ng mga array ng isang dimensyon (mga vector) at mga array ng dalawang dimensyon (mga matrice). Kabilang dito ang mga set na operasyon, pag-uuri, pag-import mula at pag-export sa mga text file.

Ang mga array na may higit sa dalawang dimensyon ay hindi maaaring gamitin sa mga pamamaraan sa serbisyong ito, ang tanging pagbubukod ay ang CountDims paraan na tumatanggap ng mga Array na may anumang bilang ng mga sukat.

Mga SFDocuments . Base serbisyo

Ang Base nagbibigay ang serbisyo ng ilang pamamaraan at katangian upang mapadali ang pamamahala at pangangasiwa ng mga dokumento ng LibreOffice Base.

Ang serbisyong ito ay malapit na nauugnay sa Dokumento serbisyo, na nagbibigay ng mga generic na pamamaraan para sa paghawak ng mga dokumento ng LibreOffice, kasama ang mga Base na dokumento. Samakatuwid, ang Base pinalawak ng serbisyo ang Dokumento serbisyo at nagbibigay ng mga karagdagang pamamaraan na partikular para sa mga Base na dokumento, na nagbibigay-daan sa mga user na:

Kumuha ng access sa database na nakapaloob sa isang Base na dokumento.
Buksan ang mga dokumento ng form na nakaimbak sa isang Base na dokumento.
Suriin kung ang isang dokumento ng form mula sa isang Base na dokumento ay kasalukuyang na-load.

ScriptForge . Basic serbisyo

Ang ScriptForge.Basic nagmumungkahi ang serbisyo ng isang koleksyon ng LibreOffice Basic na mga pamamaraan na isasagawa sa isang konteksto ng Python. Basic Ang mga pamamaraan ng serbisyo ay nagpaparami ng eksaktong syntax at pag-uugali ng mga Basic na builtin na function.

Mga SFDocuments . Calc serbisyo

Ang Mga SFDocuments Ang shared library ay nagbibigay ng ilang pamamaraan at katangian upang mapadali ang pamamahala at pangangasiwa ng mga dokumento ng LibreOffice.

Ang SFDocuments.Calc ang serbisyo ay isang subclass ng SFDocuments.Document serbisyo. Ang lahat ng mga pamamaraan at katangian ay tinukoy para sa Dokumento ang serbisyo ay maaari ding ma-access gamit ang a Calc halimbawa ng serbisyo.

Ang Calc ang serbisyo ay nakatuon sa:

Pangangasiwa ng mga sheet sa loob ng isang dokumento ng Calc (kopya, ipasok, ilipat, atbp)
Pagpapalitan ng data sa pagitan ng mga Pangunahing istruktura ng data at mga hanay ng Calc
Pagkopya at pag-import ng napakalaking halaga ng data

Mga SFDocuments . Tsart serbisyo

Ang Tsart nagbibigay ang serbisyo ng isang hanay ng mga katangian at pamamaraan upang mahawakan ang mga chart sa mga dokumento ng Calc. Sa serbisyong ito, posible na:

I-access ang mga bagay sa chart sa mga dokumento ng Calc at manipulahin ang mga katangian ng mga ito.
Gumawa at magpasok ng mga bagong chart sa isang dokumento ng Calc.
I-export ang mga chart bilang mga file ng imahe.

Mga SFDatabase . Database serbisyo

Ang Database nagbibigay ng access ang serbisyo sa mga database na naka-embed o inilarawan sa mga Base na dokumento. Nagbibigay ang serbisyong ito ng mga pamamaraan upang:

Kumuha ng access sa data sa mga talahanayan ng database.
Takbo PUMILI mga query at magsagawa ng mga pinagsama-samang function.
Patakbuhin ang mga pahayag ng pagkilos ng SQL tulad ng INSERT , I-UPDATE , I-DELETE , atbp.

Mga SFDatabase . Dataset serbisyo

Ang Dataset Ang serbisyo ay ginagamit upang kumatawan sa tabular na data na ginawa ng isang database. Sa serbisyong ito posible na:

Mag-navigate at i-access ang data sa isang dataset.
I-update, ipasok at alisin ang mga tala sa isang dataset.

Mga SFDatabase . Datasheet serbisyo

Ang Datasheet Binibigyang-daan ng serbisyo na mailarawan ang mga nilalaman ng mga talahanayan ng database gayundin ang mga resulta ng mga query at mga pahayag ng SQL gamit ang Data View ng Base. Bilang karagdagan, pinapayagan ng serbisyong ito na:

Magdagdag ng mga custom na menu sa view ng data.
I-access ang mga halaga sa mga partikular na posisyon ng view ng data.
Iposisyon ang cursor sa isang partikular na cell ng view ng data.

Mga SFDialog . Dialog serbisyo

Ang Dialog nag-aambag ang serbisyo sa pamamahala ng mga dialog na ginawa gamit ang Basic Editor ng Dialog o mga dialog na ginawa on-the-fly. Ang bawat pagkakataon ng kasalukuyang klase ay kumakatawan sa isang solong dialog box na ipinapakita sa user.

Mga SFDialog . DialogControl serbisyo

Ang DialogControl pinamamahalaan ng serbisyo ang mga kontrol na kabilang sa isang dialog na tinukoy sa Basic Editor ng Dialog . Ang bawat pagkakataon ng kasalukuyang serbisyo ay kumakatawan sa isang kontrol sa loob ng isang dialog box.

Nakatakda ang focus sa pagkuha at pagtatakda ng mga value na ipinapakita ng mga kontrol ng dialog box. Ang pag-format ay maa-access sa pamamagitan ng XControlModel at XControlView ari-arian.

Tandaan na ang natatangi DialogControl.Value Ang nilalaman ng ari-arian ay nag-iiba ayon sa uri ng kontrol.

Ang isang espesyal na pansin ay ibinibigay sa mga kontrol ng uri ng kontrol ng puno. Madaling punuin ang isang puno, alinman sa sanga sa bawat sanga, o sa isang hanay ng mga sanga nang sabay-sabay. Ang pagpo-populate sa isang kontrol ng puno ay maaaring isagawa nang static o dynamic.

ScriptForge . Diksyunaryo serbisyo

Ang diksyunaryo ay isang koleksyon ng mga pares ng key-item

Ang susi ay isang case-insensitive na string
Ang mga bagay ay maaaring anumang uri

Mga SFDocuments . Dokumento serbisyo

Ang Mga SFDocuments ang library ay nagbibigay ng mga pamamaraan at katangian upang mapadali ang pamamahala at pagmamanipula ng mga dokumento ng LibreOffice.

Ang mga pamamaraan na naaangkop para sa lahat ng uri ng mga dokumento (Mga Tekstong Dokumento, Sheet, Presentasyon, atbp) ay ibinibigay ng SFDocuments.Document serbisyo. Ang ilang mga halimbawa ay:

Pagbubukas, pagsasara at pag-save ng mga dokumento
Pag-access sa mga pamantayan o custom na katangian ng mga dokumento

ScriptForge . Exception serbisyo

Ang Exception Ang serbisyo ay isang koleksyon ng mga pamamaraan upang tumulong sa pag-debug ng code sa Basic at Python script at sa error sa paghawak sa Basic script.

Sa Mga pangunahing script , kapag may naganap na error sa run-time, ang mga pamamaraan at katangian ng Exception tulong ng serbisyo na matukoy ang konteksto ng error at payagan itong pangasiwaan ito.

ScriptForge . FileSystem serbisyo

Ang FileSystem Kasama sa serbisyo ang mga gawain sa paghawak ng mga file at folder. Susunod ang ilang halimbawa ng mga feature na ibinigay ng serbisyong ito:

I-verify kung may file o folder.
Lumikha at magtanggal ng mga folder at file.
Ilunsad ang mga dialog box para buksan/i-save ang mga file.
I-access ang listahan ng mga file sa isang folder, atbp.

Mga SFDocuments . Form serbisyo

Ang Form nagbibigay ang serbisyo ng mga pamamaraan at katangian upang pamahalaan ang mga form sa mga dokumento ng LibreOffice. Sinusuportahan ng serbisyong ito ang mga form sa mga dokumento ng Base, Calc at Writer at nagbibigay-daan sa:

Buksan at i-activate ang mga form.
Mag-navigate sa mga talaan na ipinapakita ng form.
Kumuha ng access sa mga kontrol sa loob ng form.
Kumuha ng access sa mga subform ng isang parent form.

Mga SFDocuments . FormControl serbisyo

Ang FormControl nagbibigay ng access ang serbisyo sa mga kontrol na kabilang sa isang form, isang subform o isang table na kontrol ng a FormDocument . Ang bawat pagkakataon ng FormControl serbisyo ay tumutukoy sa iisang kontrol sa form. Ang serbisyong ito ay nagpapahintulot sa mga user na:

Kunin at itakda ang mga katangian ng kontrol na kinakatawan ng FormControl halimbawa.
I-access ang kasalukuyang halaga na ipinapakita ng kontrol.
Itakda ang focus sa nais na kontrol.

Mga SFDocuments . FormDocument serbisyo

Ang FormDocument nagbibigay-daan ang serbisyo na ma-access ang mga dokumento ng form na nakaimbak sa mga dokumento ng LibreOffice Base.

Sa isang Base na dokumento, ang mga umiiral na dokumento ng form ay maaaring matingnan sa pamamagitan ng pagpili Tingnan - Mga Form sa user interface. Ang bawat dokumento ng form ay maaaring binubuo ng isa o higit pang mga form, kabilang ang pangunahing form at iba pang mga sub-form.

ScriptForge . L10N serbisyo

Nagbibigay ang serbisyong ito ng ilang pamamaraan na nauugnay sa pagsasalin ng mga string na may kaunting epekto sa source code ng programa. Ang mga pamamaraan na ibinigay ng L10N ang serbisyo ay maaaring gamitin pangunahin sa:

Lumikha ng mga POT file na maaaring magamit bilang mga template para sa pagsasalin ng lahat ng mga string sa programa.
Kumuha ng mga isinaling string sa runtime para sa wikang tinukoy sa Lokal ari-arian.

SFWidgets . Menu serbisyo

Ang Menu maaaring gamitin ang serbisyo upang lumikha at mag-alis ng mga menu mula sa menubar ng isang window ng dokumento ng LibreOffice. Ang bawat entry sa menu ay maaaring iugnay sa isang script o sa isang utos ng UNO. Ang serbisyong ito ay nagbibigay ng mga sumusunod na kakayahan:

Paglikha ng mga menu na may mga custom na entry, checkbox, radio button at separator.
Dekorasyon ng mga item sa menu na may mga icon at tooltip.

ScriptForge . Plataporma serbisyo

Ang Plataporma nagbibigay ang serbisyo ng isang koleksyon ng mga katangian tungkol sa kasalukuyang kapaligiran ng pagpapatupad at konteksto, tulad ng:

Ang platform ng hardware (arkitektura, bilang ng CPU, uri ng makina, atbp)
Impormasyon ng operating system (uri ng OS, release, bersyon, atbp)
Ang bersyon ng LibreOffice
Ang kasalukuyang user name

SFWidgets . PopupMenu serbisyo

Ang PopupMenu maaaring gamitin ang serbisyo upang lumikha ng mga popup menu na maaaring iugnay sa mga kaganapan o isagawa ng mga script. Ang serbisyong ito ay nagbibigay ng mga sumusunod na kakayahan:

Paglikha ng mga popup menu na may mga custom na entry, checkbox at radio button.
Dekorasyon ng mga item sa menu na may mga icon at tooltip.

ScriptForge . Rehiyon serbisyo

Ang Rehiyon Nagbibigay ang serbisyo ng isang koleksyon ng mga katangian at pamamaraan upang mahawakan ang mga aspeto ng programming na nauugnay sa lokal at rehiyon, tulad ng:

Pag-access sa mga setting ng lokal at nakadepende sa rehiyon gaya ng pag-format ng numero, pera at mga timezone.
Kino-convert ang mga timezone at kalkulahin ang mga offset ng Daylight Saving Time (DST).
Pagbabago ng mga numero sa teksto sa anumang sinusuportahang wika.

ScriptForge . Mga serbisyo serbisyo

Ang pangunahing layunin ng Mga serbisyo module ay upang magbigay ng access sa CreateScriptService paraan, na maaaring tawagan sa mga script ng gumagamit upang i-instantiate ang mga serbisyong ipinatupad gamit ang balangkas ng ScriptForge.

ScriptForge.Session serbisyo

Ang Sesyon ang serbisyo ay nagtitipon ng iba't ibang pangkalahatang layunin na pamamaraan tungkol sa:

ang kapaligiran sa pag-install o pagpapatupad
UNO introspection
ang panawagan ng mga panlabas na script o programa

ScriptForge . String serbisyo

Ang String nagbibigay ang serbisyo ng isang koleksyon ng mga pamamaraan para sa pagproseso ng string. Ang mga pamamaraang ito ay maaaring gamitin sa:

Patunayan ang mga nilalaman ng mga string
I-format ang mga string sa pamamagitan ng pag-trim, pagbibigay-katwiran o pagbabalot ng mga nilalaman nito
Gumamit ng mga regular na expression upang maghanap at palitan ang mga substring
Ilapat ang mga algorithm ng hash sa mga string, atbp.

ScriptForge . TextStream serbisyo

Ang TextStream Ang serbisyo ay ginagamit upang sunod-sunod na basahin at isulat ang mga file na binuksan o nilikha gamit ang ScriptForge.FileSystem serbisyo.

Ang mga pamamaraan OpenTextFile at CreateTextFile mula sa FileSystem serbisyo ay nagbabalik ng isang halimbawa ng TextStream serbisyo.

ScriptForge . Timer serbisyo

Ang Timer sinusukat ng serbisyo ang dami ng oras na kinakailangan upang patakbuhin ang mga script ng user.

A Timer mga hakbang mga tagal . Maaari itong maging:

Nagsimula, upang ipahiwatig kung kailan magsisimulang magsukat ng oras.
Nasuspinde, upang i-pause ang pagsukat ng oras ng pagtakbo.
Ipinagpatuloy, upang ipagpatuloy ang pagsubaybay sa oras ng pagtakbo pagkatapos masuspinde ang Timer.
Na-restart, na magkansela ng mga nakaraang pagsukat at simulan ang Timer sa zero.

SFWidgets . Toolbar serbisyo

Ang Toolbar nagbibigay-daan ang serbisyo na makuha ang impormasyong nauugnay sa mga toolbar na magagamit para sa isang partikular na window ng dokumento. Sa serbisyong ito, posible na:

I-toggle ang visibility ng mga partikular na toolbar.
I-access ang impormasyon tungkol sa mga button na available sa bawat toolbar.

SFWidgets . ToolbarButton serbisyo

Ang ToolbarButton nagbibigay-daan ang serbisyo na makuha ang impormasyong nauugnay sa mga pindutan ng toolbar na magagamit sa isang naibigay na toolbar. Sa serbisyong ito, posible na:

I-toggle ang visibility ng mga elemento ng toolbar.
Isagawa ang utos na nauugnay sa isang ibinigay na toolbar na pindutan.

ScriptForge . UI serbisyo

Pinapasimple ng serbisyo ng UI (User Interface) ang pagkakakilanlan at pagmamanipula ng iba't ibang mga window na bumubuo sa buong LibreOffice application:

Pagpili ng Windows
Paglipat at pagbabago ng laki ng Windows
Mga setting ng statusbar
Pagpapakita ng isang lumulutang na progress bar
Paglikha ng mga bagong bintana
Access sa pinagbabatayan na "mga dokumento"

SFUnitTests . UnitTest serbisyo

Ang UnitTest nagbibigay ang serbisyo ng isang balangkas para sa pag-automate ng mga pagsubok sa unit gamit ang Basic na wika, kabilang ang kakayahang:

Pagsama-samahin ang mga test case sa mga test suite at unit test.
Ibahagi ang setup at shutdown code sa mga test case.
Iulat ang mga resulta ng pagsusulit gamit ang Console .

Mga SFDocuments . Manunulat serbisyo

Ang Mga SFDocuments Ang shared library ay nagbibigay ng ilang pamamaraan at katangian upang mapadali ang pamamahala at pangangasiwa ng mga dokumento ng LibreOffice.

Ang ilang mga pamamaraan ay generic para sa lahat ng uri ng mga dokumento at minana mula sa SF_Document module, samantalang ang iba pang mga pamamaraan na partikular para sa mga dokumento ng Writer ay tinukoy sa SF_Writer modyul.

Tandaan: Iba pa ScriptForge ang mga hindi inilarawang module ay nakalaan para sa panloob na paggamit. Ang kanilang nilalaman ay maaaring magbago nang walang abiso.

Lahat ScriptForge Ang mga pangunahing gawain o identifier na may prefix na may underscore na character na "_" ay nakalaan para sa panloob na paggamit. Ang mga ito ay hindi nilalayong gamitin sa Basic macros o Python script.