Entrada/Saída para o ecrã

O ficheiro de saída padrão do Python não está disponível ao executar macros Python a partir do menu Ferramentas – Macros – Executar Macro... A apresentação da saída de um módulo requer a consola interativa do Python. Funcionalidades como input(), print(), repr() e str() estão disponíveis a partir do shell do Python.

% O módulo msgbox do Python propõe um método msgbox() que é ilustrado nas páginas de exemplo Criar ouvintes de eventos e Criar um manipulador de diálogos.

O LibreOffice Basic oferece as funções de E/S de ecrã InputBox(), Msgbox() e Print(). As alternativas Python existem a partir tanto do LibreOffice API Abstract Windowing Toolkit, quanto pelas chamadas para o BASIC do Python. Esta última oferece uma sintaxe intencionalmente similar ao BASIC, e utiliza um módulo Python junto com um módulo BASIC. Utiliza-se o API Scripting Framework para executar chamadas de função entre BASIC, BeanShell, JavaScript e Python.

Sintaxe Python:

MsgBox(txt, buttons=0, title=None)

InputBox(txt, title=None, default=None)

Print(txt)

Exemplos:

>>> import screen_io as ui

>>> reply = ui.InputBox('Please enter a phrase', title='Dear user', defaultValue="here..")

>>> rc = ui.MsgBox(reply, title="Confirmation of phrase")

>>> age = ui.InputBox('How old are you?', title="Hi")

>>> ui.Print(age)

Instalação:

Copie o módulo Python screen_io para As minhas macros dentro de <UserProfile>/Scripts/python/pythonpath,
Copie o módulo Basic uiScripts na biblioteca Basic padrão As minhas macros,
Reinicie o LibreOffice

Módulo Python screen_io


        # -*- coding: utf-8 -*-
        from __future__ import unicode_literals
        
        def MsgBox(prompt: str, buttons=0, title='LibreOffice') -> int:
            """ Exibe uma caixa de diálogo contendo uma mensagem e retorna um valor. """
            xScript = _getScript("_MsgBox")
            res = xScript.invoke((prompt,buttons,title), (), ())
            return res[0]
        
        def InputBox(prompt: str, title='LibreOffice', defaultValue='') -> str:
            """Exibe um prompt numa caixa de diálogo onde o utilizador pode introduzir texto."""
            xScript = _getScript("_InputBox")
            res = xScript.invoke((prompt,title,defaultValue), (), ())
            return res[0]
        
        def Print(message: str):
            """Exibe as cadeias de caracteres ou expressões numéricas especificadas numa caixa de diálogo."""
            xScript = _getScript("_Print")
            xScript.invoke((message,), (), ())
        
        import uno
        from com.sun.star.script.provider import XScript
        def _getScript(script: str, library='Standard', module='uiScripts') -> XScript:
            sm = uno.getComponentContext().ServiceManager
            mspf = sm.createInstanceWithContext("com.sun.star.script.provider.MasterScriptProviderFactory", uno.getComponentContext())
            scriptPro = mspf.createScriptProvider("")
            scriptName = "vnd.sun.star.script:"+library+"."+module+"."+script+"?language=Basic&location=application"
            xScript = scriptPro.getScript(scriptName)
            return xScript

Os métodos MsgBox e InputBox do serviço Basic incluído em as bibliotecas ScriptForge chamam diretamente as suas contrapartes nativas do Basic.

Módulo Basic uiScripts


        Option Explicit
        Private Function _MsgBox( prompt As String, Optional buttons As Integer, _
                Optional title As String ) As Integer
            _MsgBox = MsgBox( prompt, buttons, title )
        End Function
        Private Function _InputBox( prompt As String, Optional title As String, _
                Optional default As String) As String
            _InputBox = InputBox( prompt, title, default )
        End Function
        Private Sub _Print( msg As String )
            Print msg
        End Sub

A extensão Alternative Python Script Organizer (APSO) disponibiliza uma função msgbox() no seu módulo apso_utils.

Funções de E/S do ecrã

Exemplos de programação em Python

Ajuda para os scripts Python no LibreOffice

Invocar macros Basic via Python