Moduł scriptforge

scriptforge moduł zawiera rozszerzalną kolekcję zasobów skryptowych dla LibreOfficeDev, które można wywołać ze skryptów Pythona. Pełny opis tych zasobów jest dostępny na stronie pomocy Biblioteki ScriptForge.

Metody

CreateScriptService

Tworzy zasoby ScriptForge jako „usługi”. Działa jako ogólny konstruktor dla wszystkich metod właściwości lub klas usług ScriptForge.

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

servicename: nazwa usługi ScriptForge, taka jak „ScriptForge.FileSystem”, „SFDialogs.Dialog” lub inna.

arg0, arg1, ...: parametry opcjonalne w odniesieniu do tworzonej usługi.

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

Metoda Dispose jest dostępna we wszystkich usługach i powinna być wywoływana w celu zwolnienia zasobów po ich wykorzystaniu.

Usługa „ScripForge.Basic” zawiera dedykowane właściwości i metody, które umożliwiają dostęp do obiektów i usług UNO oraz innych udogodnień.

ScriptForge class

Łączy się z działającą usługą LibreOfficeDev uruchomioną za pomocą wiersza poleceń. Klasa ScriptForge może wiązać skrypty Pythona oparte na środowisku IDE ze zdalnym procesem LibreOfficeDev w celu debugowania.

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

Połączenia potoków i gniazd wykluczają się wzajemnie.

pipe: nazwany potok używany do uruchomienia zdalnej usługi LibreOfficeDev. Domyślna nazwa to „PIPE2LIBREOFFICE”.

hostname: '', 'localhost' lub adres IP komputera, na którym znajduje się zdalna usługa LibreOfficeDev.

port: numer portu używany do uruchomienia LibreOfficeDev jako usługi.

Podano, że LibreOfficeDev został uruchomiony z wiersza poleceń jako:

      from scriptforge import CreateScriptService as getSvc
      ui = getSvc('ScriptForge.Basic')
      
      def my_script():  # miejsce na kod użytkownika
          response = ui.MsgBox('Czy chcesz kontynuować?',ui.MB_YESNOCANCEL,'Komunikat z Pythona')
          ui.MsgBox('scriptforge module',ui.MB_OK,response)
      
      g_exportedScripts = (my_script,)  # punkty wejścia LibreOffice
      
      if __name__ == "__main__":  # punkt wejścia środowisk IDE
          # from scriptforge import ScriptForge # jako menedżer sesji
          # ScriptForge(pipe='PIPE2LIBREOFFICE')  # wykonywane w tle
          my_script()
    

Aby dowiedzieć się więcej o tworzeniu i wykonywaniu skryptów Pythona za pomocą modułu scriptforge, przeczytaj stronę pomocy Tworzenie skryptów Pythona za pomocą ScriptForge.

Wszystkie metody lub identyfikatory scriptforge poprzedzone znakiem podkreślenia „_” są zarezerwowane do użytku wewnętrznego. Nie są przeznaczone do użycia w skryptach Pythona.