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.

Sa terminolohiya ng ScriptForge ang isang serbisyo ay isang koleksyon ng mga pamamaraan at katangian na maaaring magamit para sa isang karaniwang layunin. Halimbawa, ang String Ang serbisyo ay nagbibigay ng mga pamamaraan para sa pagmamanipula ng mga string samantalang ang FileSystem nagbibigay-daan ang serbisyo para sa pagmamanipula ng mga file at folder.

Ang Mga serbisyo Ang module ng library ng ScriptForge ay nagbibigay ng mga karagdagang pamamaraan na ginagamit sa loob para magrehistro ng mga available na serbisyo o ng mga developer na interesadong palawigin ang ScriptForge sa pamamagitan ng paglikha ng mga bagong serbisyo. Ang tanging paraan na may kaugnayan para sa mga script ng user ay CreateScriptService .

CreateScriptService

Ang pamamaraang ito ay ginagamit upang i-instantiate ang isang serbisyo ng ScriptForge upang ito ay matawag sa mga script ng user.

Ang ibinalik na halaga ay isang Basic na bagay o wala kung may naganap na error.

svc.CreateScriptService(service: str, [arg0: any] ...): svc

serbisyo : Ang pangalan ng serbisyong kinilala bilang isang string sa format na "library.service":

• Ang aklatan ay isang Basic na aklatan na dapat umiral sa GlobalScope . Ang default na halaga ay "ScriptForge".

• Ang serbisyo ay isa sa mga serbisyong nakarehistro ng ScriptForge library.

arg0,... : Isang listahan ng mga argumento na kinakailangan ng invoked service.

Kung ang unang argumento ay tumutukoy sa isang event manager, kung gayon arg0 ay mandatory at dapat ay ang UNO object na kumakatawan sa event na ibinigay bilang argumento sa user macro.

    GlobalScope.BasicLibraries.loadLibrary("ScriptForge")
    'Na gagawin nang isang beses
    Dim svc As Object
    Set svc = CreateScriptService("Array")
    ' Tumutukoy sa serbisyong "ScriptForge.Array" o SF_Array
    Set svc = CreateScriptService("ScriptForge.Dictionary")
    ' Nagbabalik ng bagong walang laman na halimbawa ng klase ng diksyunaryo; "ScriptForge." ay opsyonal
    Set svc = CreateScriptService("SFDocuments.Calc")
    ' Tumutukoy sa serbisyo ng Calc, na ipinatupad sa nauugnay na library ng SFDocuments
    Set svc = CreateScriptService("Timer", True)
    ' Nagbabalik ng isang halimbawa ng klase ng Timer na nagsisimula kaagad
    Set svc = CreateScriptService("SFDocuments.DocumentEvent", oEvent)
    ' Tumutukoy sa serbisyo ng DocumentEvent na ipinatupad sa nauugnay na library ng SFDocuments
    ' Ibinabalik ang instance ng klase ng Dokumento na nagpagana ng kaganapan
  

    from scriptforge import CreateScriptService
    svc = CreateScriptService("Array")
    svc = CreateScriptService("ScriptForge.Dictionary")
    svc = CreateScriptService("SFDocuments.Calc")
    svc = CreateScriptService("Timer", True)
    svc = CreateScriptService("SFDocuments.DocumentEvent", oEvent)
  

Sinusuportahan ng mga script ng Python ang mga argumento ng keyword kapag tumatawag CreateScriptService . Ang sumusunod na halimbawa ay naglalarawan ng konseptong ito sa pamamagitan ng pagpapakita ng Timer at Dokumento mga serbisyo gamit ang mga argumento ng keyword.

    from scriptforge import CreateScriptService
    # Timer
    my_timer = CreateScriptService("Timer", start = True)
    # Document
    my_doc = CreateScriptService("Document", windowname = "some_file.ods")
  

Upang gawing mas tuluy-tuloy ang pagsusulat ng mga script ng Python, ibinibigay ng ScriptForge ang Basic serbisyo na nagbibigay-daan sa mga script ng Python na tumawag ng isang koleksyon ng mga pamamaraan na may parehong syntax at kahulugan ng kanilang mga homonymous na katutubong Basic function.

Ang sumusunod na halimbawa ay nagpapakita ng Basic serbisyo at tawag sa MsgBox pamamaraan, na katumbas ng MsgBox magagamit ang function sa Basic:

    from scriptforge import CreateScriptService
    bas = CreateScriptService("Basic")
    bas.MsgBox("Hello World!")
  

Magkaroon ng kamalayan na ang Basic ang serbisyo ay kailangang mai-instantiate sa mga script ng Python gamit ang CreateScriptService paraan.

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.