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:
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.
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.
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.
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
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.
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.
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.
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.
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.
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
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
Pinapasimple ng serbisyo ng UI (User Interface) ang pagkakakilanlan at pagmamanipula ng iba't ibang mga window na bumubuo sa buong LibreOffice application:
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.