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 Collabora Office 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.

Collabora Office Basic propone funzioni di I/O su schermo InputBox(), Msgbox() e Print(). Esistono alternative Python che si appoggiano sia sul Collabora Office 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 Collabora Office.

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.