Sumário

# Entrada e Saída na tela

A saída padrão de arquivo do Python não está disponível ao executar macros Python do menu Ferramentas - Macros - Executar macros. Exibir a saída de um módulo requer a console interativa do Python. Recursos tais como input(), print(), repr() e str() estão disponíveis no interpretador do Python.

O módulo Python msgbox do LibreOffice prpõe um método msgbox() ilustrado nas páginas de exemplo Criar Event Listeners e Criar um manipulador de diálogo.

O LibreOffice Basic oferece as funções de E/S 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 screen_io para Minhas macros dentro de <UserProfile>/Scripts/python/pythonpath,

- Copie o módulo BASIC uiScripts para a biblioteca Standard Basic em 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 em uma caixa de diálogo na qual o usuário pode inserir texto."""
                xScript = _getScript("_InputBox")
                res = xScript.invoke((prompt,title,defaultValue), (), ())
                return res[0]

            def Print(message: str):
                """Direciona a saída dos strings ou das expressões numéricas especificadas para uma 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 na biblioteca ScriptForge fazem chamadas diretas às suas contrapartes 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) oferece a função msgbox() dentro do módulo apso_utils.

Tópicos relacionados

Funções de E/S de tela

Exemplos de programação em Python

Ajuda dos scripts Python do LibreOffice

Chamar macros Basic pelo Python