modul scriptforge

Modul scriptforge obsahuje rozšiřitelnou kolekci skriptovacích zdrojů pro LibreOfficeDev, které lze spustit ze skriptů Pythonu. Úplný popis těchto zdrojů je k dispozici na stránce nápovědy knihoven ScriptForge.

Metody

CreateScriptService

Vytvoří instance zdrojů ScriptForge jako „služby“. Slouží jako generický konstruktor pro všechny metody vlastností nebo třídy služeb ScriptForge.

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

servicename: Název služby ScriptForge, například „ScriptForge.FileSystem“, „SFDialogs.Dialog“ nebo jiný.

arg0, arg1, ...: Volitelné parametry týkající se instance služby.

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

Metoda Dispose je k dispozici ve všech službách a měla by být volána pro uvolnění zdrojů po použití.

Služba 'ScriptForge.Basic' obsahuje specializované vlastnosti a metody pro přístup k objektům a službám UNO i k dalším funkcím.

ScriptForge class

Připojí se ke spuštěné službě LibreOfficeDev spuštěné z příkazového řádku. ScriptForge může pro účely ladění propojit skripty Pythonu spuštěné z IDE se vzdáleným procesem LibreOfficeDev.

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

Připojení pomocí roury (pipe) a socketu se vzájemně vylučují.

pipe: Pojmenovaná roura (pipe) použitá ke spuštění vzdálené služby LibreOfficeDev. Výchozí název je 'PIPE2LIBREOFFICE'.

hostname: '', 'localhost' nebo IP adresa počítače, na kterém běží vzdálená služba LibreOfficeDev.

port: Číslo portu použitého ke spuštění LibreOfficeDev jako služby.

Za předpokladu, že byl LibreOfficeDev spuštěn z příkazového řádku následujícím způsobem:

      from scriptforge import CreateScriptService as getSvc
      ui = getSvc('ScriptForge.Basic')

      def my_script():  # user code goes here
          response = ui.MsgBox('Chcete pokračovat?',ui.MB_YESNOCANCEL,'Zpráva z Python')
          ui.MsgBox('scriptforge module',ui.MB_OK,response)
      g_exportedScripts = (my_script,)  # vstupní body LibreOffice
      if __name__ == "__main__":  # vstupní bod pro IDE
          # from scriptforge import ScriptForge # as session manager
          # ScriptForge(pipe='PIPE2LIBREOFFICE')  # performed in the background
          my_script()
    

Další informace o vytváření a spouštění skriptů Pythonu pomocí modulu scriptforge naleznete na stránce nápovědy Vytváření skriptů Pythonu pomocí ScriptForge.

Všechny metody nebo identifikátory modulu scriptforge, které začínají znakem podtržítka "_", jsou vyhrazeny pro interní použití. Nejsou určeny k použití ve skriptech Pythonu.