Módulu msgbox

P'aportar a esta orde...

Open Tools - Macros - Macro Manager menu.

Descripción

MsgBox class methods in msgbox Python module simplify the creation of message boxes using Abstract Windowing Toolkit API facilities. MsgBox constructor creates an empty dialog to be completed with buttons and texts.

This module is not part of supported UNO API. Output to screen with msgbox module is to be limited to development or test situations.

Performing input/output to screen with Python can the achieved using LibreOfficeDev UNO API, resorting to ScriptForge.Basic service routines or using Python to Basic inter-language calls as described on wiki.

Propiedaes

Nome	Namás de llectura	Triba	Descripción
numberOfLines	Non	Boolean	Optionally overrides dialog rendered height.

Métodos

List of Methods in MsgBox class
addButton renderFromBoxSize	renderFromButtonSize show

List of Methods in MsgBox class

addButton

Add a button to a MsgBox() object.

Syntax:

addButton(caption: str)

Parameters:

caption: Button caption.

Example:

A continuación detállase un exemplu.

renderFromBoxSize

Defines MsgBox dialog dimensions as well as size of buttons according to a specified size.

Syntax:

renderFromBoxSize(size=150)

Parameters:

size: Dialog size.
Width: ( 2 * size ) / ( 3 * numberOfbuttons + 1 )
Height is set according the number of Newline separators in dialog text.

Example:

A continuación detállase un exemplu.

renderFromButtonSize

Accommodates MsgBox dialog dimensions according to a specified size for buttons.

Syntax:

renderFromButtonSize(size=50)

Parameters:

size: Size for buttons.
Width: ( numberOfButtons * 1.5 + 0.5) * size
Height is set according the number of Newline separators in dialog text.

Example:

A continuación detállase un exemplu.

show

Displays MsgBox variations, such as information box, warning box and so on.

Syntax:

show(message: str, decoration, title: str): str

Parameters:

message: Dialog prompted text that may contain Newline separators.

decoration: n/a.

title: Dialog caption.

Example:

A continuación detállase un exemplu.

Exemplu detalláu


import uno
from msgbox import MsgBox

if uno: _CTX = uno.getComponentContext()

def my_script():
    response = msgBox('Do you want to continue?',('Yes', 'No', 'Cancel'),'A message from Python')
    infoBox(button=response)

def msgBox(prompt='', buttons=('Ok',), title='') -> str:
    dlg = MsgBox(_CTX)  # uno.getComponentContext()
    for btn in buttons:
        dlg.addButton(btn)
    dlg.renderFromButtonSize()
    dlg.numberOfLines = 15
    return dlg.show(prompt,0,title)
  
def infoBox(prompt='adapted from msgbox.MsgBox', button='Howdy', title='msgbox module'):
    dlg = MsgBox(_CTX)  # uno.getComponentContext()
    dlg.addButton(button)
    dlg.renderFromBoxSize(345)
    dlg.show(prompt,0,title)

g_exportedScripts = (my_script,)  # LibreOffice entry points
  
if __name__ == "__main__":  # entry point for IDEs
    from officehelper import SessionManager
    with SessionManager() as ctx:  # Python remote context
      _CTX = ctx
      my_script()

ScriptForge.Basic service provides MsgBox and InputBox alternatives whose signatures closely match that of Basic functions.