Contenuto

# Input/output su schermo

Il file output standard di Python non è disponibile quando si eseguono macro Python dal menu Strumenti – Macro - Esegui macro. La presentazione dell'output di un modulo richiede la console interattiva di Python. Funzioni quali input(), print(), repr() e str() sono disponibili dalla shell di Python.

Il modulo Python msgbox di LibreOffice propone un metodo msgbox() che è illustrato nella pagine di esempio Creazione di listener di eventi e Creare un gestore degli eventi per le finestre di dialogo.

LibreOffice Basic propone funzioni di I/O su schermo InputBox(), Msgbox() e Print(). Esistono alternative Python che si appoggiano sia sul LibreOffice API Abstract Windowing Toolkit, sia sulle chiamate alle funzioni di Python a Basic. Quest'ultima propone una sintassi che è intenzionalmente vicino a quella di Basic, e utilizza un modulo Python accanto a un modulo Basic. L'API Scripting Framework viene utilizzato per eseguire funzioni di chiamata tra i linguaggi Basic, BeanShell, JavaScript e Python.

## Sintassi Python:

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

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

Print(txt)

## Esempi:

>>> 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)

## Installazione:

- Copiate il modulo Python screen_io in Macro personali all'interno di <UserProfile>/Scripts/python/pythonpath,

- Copiate il modulo Basic uiScripts nella libreria Basic standard Macro personali,

- Riavviate LibreOffice.

### Modulo Python screen_io

            # -*- coding: utf-8 -*-
            from __future__ import unicode_literals

            def MsgBox(prompt: str, buttons=0, title='LibreOffice') -> int:
                """ Mostra un riquadro contenente un messaggio e restituisce un valore."""
                xScript = _getScript("_MsgBox")
                res = xScript.invoke((prompt,buttons,title), (), ())
                return res[0]

            def InputBox(prompt: str, title='LibreOffice', defaultValue='') -> str:
                """ Mostra una richiesta in un riquadro di dialogo in cui l'utente può inserire del testo."""
                xScript = _getScript("_InputBox")
                res = xScript.invoke((prompt,title,defaultValue), (), ())
                return res[0]

            def Print(message: str):
                """Restituisce le stringhe specificate o le espressioni numeriche in un riquadro di dialogo."""
                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

I metodi MsgBox e InputBox del servizio Basic compreso nella libreria ScriptForge chiamano direttamente i loro corrispettivi nativi in Basic.

### Modulo 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

L'estensione Alternative Python Script Organizer (APSO) offre una funzione msgbox() al di fuori del suo modulo apso_utils.

Argomenti correlati

Funzioni di I/O dello schermo

Esempi di programmazione in Python

Guida agli script Python di LibreOffice

Richiamare macro Basic da Python