scriptforge-module

scriptforge-module bevat een uitbreidbare verzameling scriptbronnen voor LibreOfficeDev die vanuit Python-scripts kunnen worden aangeroepen. Een volledige beschrijving van deze bronnen is beschikbaar op de help-pagina van de ScriptForge-bibliotheken.

Methodes

CreateScriptService

Instantieert ScriptForge resources als "Services". Het fungeert als een generieke constructor voor alle eigenschappen, methoden of klassen van ScriptForge-diensten.

CreateScriptService(servicename: str [, arg0, arg1, ...]): svc

servicename: Een ScriptForge-servicenaam zoals 'ScriptForge.FileSystem', 'SFDialogs.Dialog' of iets dergelijks.

arg0, arg1, ...: Optionele parameters met betrekking tot de geïnstantieerde service.

      from scriptforge import CreateScriptService as getSvc
      svc = getSvc('ScriptForge.Basic')
	  svc.MsgBox('Hello')
      svc.Dispose()
    

De Dispose-methode is beschikbaar in alle services en moet worden aangeroepen om resources vrij te geven na gebruik.

De service 'ScripForge.Basic' bevat specifieke eigenschappen en methoden voor toegang tot UNO-objecten en -services, evenals andere faciliteiten.

ScriptForge class

Maakt verbinding met een actieve LibreOfficeDev-service gestart met de opdrachtregel. ScriptForge-klasse kan IDE-gebaseerde Python-scripts koppelen aan een extern LibreOfficeDev-proces voor debugdoeleinden.

opt ScriptForge(pipe = 'PIPE2LIBREOFFICE'): obj
opt ScriptForge(hostname = '', port = 0): obj

Pijplijn- en mofverbindingen sluiten elkaar uit.

pipe: Benoemde pijplijn die wordt gebruikt om de externe service LibreOfficeDev te starten. De standaardnaam is 'PIPE2LIBREOFFICE'.

hostname: '', 'localhost' of het IP-adres van de machine waarop de externe LibreOfficeDev-service wordt gehost.

port: Het poortnummer dat wordt gebruikt om LibreOfficeDev als service te starten.

Het opgeven van LibreOfficeDev werd vanaf de opdrachtregel gestart als:

      from scriptforge import CreateScriptService as getSvc
      ui = getSvc('ScriptForge.Basic')
      
      def my_script():  # hier komt de gebruikerscode
          response = ui.MsgBox('Wilt u doorgaan?',ui.MB_JaNeeAnnuleren,'Een bericht van Python')
          ui.MsgBox('scriptforge module',ui.MB_OK,reactie)
      
      g_exportedScripts = (my_script,)  # LibreOffice toegangspunten
      
      if __name__ == "__main__":  # toegangspunten voor IDEs
          # from scriptforge import ScriptForge # als sessiemanager
          # ScriptForge(pipe='PIPE2LIBREOFFICE')  # op de achtergrond uitgevoerd
          my_script()
    

Voor meer informatie over het maken en uitvoeren van Python-scripts met de scriptforge-module, lees de help-pagina Python-scripts maken met ScriptForge.

Alle scriptforge-methodes of -identifiers die beginnen met een onderstrepingsteken "_" zijn gereserveerd voor intern gebruik. Ze zijn niet bedoeld voor gebruik in Python-scripts.