scriptforge módulo

O módulo scriptforge contém uma coleção extensível de recursos de script para o LibreOfficeDev, que podem ser chamados a partir de scripts em Python. Uma descrição completa desses recursos está disponível na página de ajuda Bibliotecas do ScriptForge.

Métodos

CreateScriptService

Instancia os recursos ScriptForge como “Serviços”. Funciona como um construtor genérico para todas as propriedades, métodos ou classes dos serviços ScriptForge.

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

nome do serviço: Um nome de serviço do ScriptForge, como 'ScriptForge.FileSystem', 'SFDialogs.Dialog' ou outro.

arg0, arg1, ...: Parâmetros opcionais relativos ao serviço instanciado.

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

O método Dispose está disponível em todos os serviços e deve ser chamado para liberar recursos após o uso.

O serviço 'ScripForge.Basic' contém propriedades e métodos específicos que acessam objetos e serviços UNO, além de outros recursos.

ScriptForge class

Conecta-se a um serviço LibreOfficeDev em execução iniciado com a linha de comando. A classe ScriptForge permite vincular scripts Python baseados em IDE a um processo remoto do LibreOfficeDev para fins de depuração.

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

Conexões do tipo pipe e socket são mutuamente exclusivas.

pipe: Canal nomeado usado para iniciar o serviço remoto LibreOfficeDev. O nome padrão é 'PIPE2LIBREOFFICE'.

nome do host: '', 'localhost' ou o endereço IP da máquina que hospeda o serviço remoto LibreOfficeDev.

porta: O número da porta usado para iniciar o LibreOfficeDev como um serviço.

Desde que o LibreOfficeDev tenha sido iniciado a partir da linha de comando da seguinte forma:

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

      def my_script():  # o código do usuário vai aqui
          response = ui.MsgBox('Deseja continuar?', ui.MB_YESNOCANCEL, 'Uma mensagem do Python')
          ui.MsgBox('scriptforge module',ui.MB_OK,response)
      g_exportedScripts = (my_script,)  # Pontos de entrada do LibreOffice
      if __name__ == "__main__":  # ponto de entrada para IDEs
          # importando ScriptForge do scriptforge # como gerenciador de sessão
          # ScriptForge(pipe='PIPE2LIBREOFFICE')  # executado em segundo plano
          my_script()
    

Para saber mais sobre como criar e executar scripts em Python usando o módulo scriptforge, leia a página de ajuda Criação de scripts em Python com o ScriptForge.

Todos os métodos ou identificadores do scriptforge que começam com o caractere de sublinhado “_” são reservados para uso interno. Eles não devem ser utilizados em scripts de Python.