scriptforge-modul

scriptforge-modulet indeholder en udvidbar samling af skript-ressourcer til kalde LibreOfficeDev fra Python-skripter. En komplet beskrivelse af disse ressourcer kan findes på hjemmesiden for ScriptForge-biblioteker.

Metoder

CreateScriptService

Instantierer ScriptForge-ressourcer som "tjenester". Den fungerer som en generisk konstruktør for alle egenskabsmetoder eller klasser af ScriptForge-tjenester.

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

servicename (tjenestenavn): Et ScriptForge-tjenestenavn, for eksempel 'ScriptForge.FileSystem', 'SFDialogs.Dialog' eller andet.

arg0, arg1, ...: Valgfrie parametre med hensyn til den opsatte tjeneste-instans.

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

Metoden Dispose er tilgængelig i alle tjenester og bør kaldes for at frigøre ressourcer efter brug.

Tjenesten 'ScriptForge.Basic' indeholder egenskaber og metoder til at tilgå UNO-objekter og -tjenester, foruden andre faciliteter.

ScriptForge class

Forbinder til en kørende LibreOfficeDev-tjeneste startet med kommandolinjen. ScriptForge-klasse kan binde IDE-baserede Python-skripter til en ekstern LibreOfficeDev-proces til fejlsøgningsformål.

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

Kanal- og sokkel-forbindelser (pipe og socket) udelukker hinanden.

pipe: Navngivet kanal, som bruges til at starte den eksterne LibreOfficeDev-tjeneste. Standardnavnet er 'PIPE2LIBREOFFICE'.

hostname: '' (tom streng), 'localhost' eller IP-adressen på maskinen, som er vært for den eksterne LibreOfficeDev-tjeneste.

port: Det portnummer, der bliver brugt til at starte LibreOfficeDev som en tjeneste.

Givet at LibreOfficeDev var startet fra kommandolinjen som:

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

      def my_script():  # brugerkoden placeres her
          response = ui.MsgBox('Ønsker du at fortsætte?',ui.MB_YESNOCANCEL,'En besked fra Python')
          ui.MsgBox('scriptforge-modul',ui.MB_OK,response)
      g_exportedScripts = (my_script,)  # LibreOffice-indgangspunkter
      if __name__ == "__main__":  # indgangspunkter for IDE'er
          # from scriptforge import ScriptForge # som sessionsbehandler
          # ScriptForge(pipe='PIPE2LIBREOFFICE')  # udført i baggrunden
          my_script()
    

For at lære mere om, hvordan du opretter og udfører Python-skripter med brug af scriptforge-modulet, læse hjælpesiden Oprettelse af Python-skripter med ScriptForge.

Alle scriptforge-metoder eller -identifikatorer som begynder med et understregningstegn "_" er reserveret til intern brug. De er ikke beregnet til at bruge i Python-skripter.