<variável id="scriptforge_module">scriptforge módulo</variável>

O módulo scriptforge contém uma coleção extensível de recursos de scripting para o LibreOfficeDev, que podem ser invocados a partir de scripts Python. Está disponível uma descrição completa destes recursos na página de ajuda Bibliotecas 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

servicename: 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 libertar recursos após a sua utilização.

O serviço «ScripForge.Basic» contém propriedades e métodos específicos que permitem aceder a objetos e serviços UNO, bem como a outras funcionalidades.

ScriptForge class

Liga-se a um serviço LibreOfficeDev em execução iniciado com a linha de comandos. A classe ScriptForge permite associar scripts Python executados no IDE a um processo remoto do LibreOfficeDev para fins de depuração.

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

As ligações por tubo e por encaixe excluem-se mutuamente.

pipe: Canal nomeado utilizado para iniciar o serviço remoto LibreOfficeDev. O nome predefinido é «PIPE2LIBREOFFICE».

nome do anfitrião: '', 'localhost' ou o endereço IP do computador que aloja o serviço remoto LibreOfficeDev.

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

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

      from scriptforge import CreateScriptService as getSvc
      ui = getSvc('ScriptForge.Basic')
      
      def my_script():  # o código do utilizador vai aqui
          response = ui.MsgBox('Deseja continuar?', ui.MB_YESNOCANCEL, 'Uma mensagem do Python')
          ui.MsgBox('módulo scriptforge', ui.MB_OK, resposta)
      
      g_exportedScripts = (my_script,)  # Pontos de entrada do LibreOffice
      
      if __name__ == "__main__":  # ponto de entrada para IDEs
          # import from scriptforge ScriptForge # como gestor de sessões
          # ScriptForge(pipe='PIPE2LIBREOFFICE')  # executado em segundo plano
          my_script()
    

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

Todos os métodos ou identificadores scriptforge que tenham como prefixo o carácter de sublinhado «_» estão reservados para uso interno. Não se destinam a ser utilizados em scripts Python.