msgbox module

Beschrijving

MsgBox klassemethodes in msgbox Pythonmodule vereenvoudigen het maken van berichtenvensters met behulp van de faciliteiten van de Abstract Windowing Toolkit API. MsgBox constructor maakt een leeg dialoogvenster aan dat kan worden aangevuld met knoppen en tekst.

Deze module maakt geen deel uit van de ondersteunde UNO API. Uitvoer naar het scherm met msgbox dient beperkt te blijven tot ontwikkelings- of testsituaties.

Het uitvoeren van invoer/uitvoer naar het scherm met Python kan worden bereikt met behulp van de LibreOfficeDev UNO API, door gebruik te maken van de ScriptForge.Basic service routines of door Python-naar-Basic inter-taal aanroepen te gebruiken zoals beschreven op de wiki.

Eigenschappen

Methodes

addButton

Een knop toe aan een MsgBox()-object toevoegen.

addButton(caption: str)

bijschrift: Bijschrift (knop).

Zie onderstaand gedetailleerd voorbeeld.

renderFromBoxSize

Definieert de afmetingen van het dialoogvenster MsgBox en de grootte van de knoppen volgens een opgegeven afmeting.

renderFromBoxSize(size=150)

grootte: Dialooggrootte.
Breedte: ( 2 * size ) / ( 3 * aantalKnoppen + 1 )
De hoogte wordt ingesteld op basis van het aantal regeleinde-scheidingstekens in de dialoogtekst.

Zie onderstaand gedetailleerd voorbeeld.

renderFromButtonSize

Past de afmetingen van het dialoogvenster MsgBox aan volgens een opgegeven grootte voor knoppen.

renderFromButtonSize(size=50)

grootte: Grootte voor knoppen.
Breedte: ( numberOfButtons * 1,5 + 0,5) * grootte
De hoogte wordt ingesteld op basis van het aantal regeleinde-scheidingstekens in de dialoogtekst.

Zie onderstaand gedetailleerd voorbeeld.

show

Geeft MsgBox-varianten weer, zoals een informatievenster, waarschuwingsvenster, enzovoort.

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

bericht: Dialoogvenster gevraagde tekst die mogelijk Nieuwe regel scheidingstekens bevat.

decoratie: n/a.

titel: Dialoogvenster Bijschrift.

Zie onderstaand gedetailleerd voorbeeld.

Gedetailleerd voorbeeld

import uno
from msgbox import MsgBox

if uno: _CTX = uno.getComponentContext()

def my_script():
    response = msgBox('Wilt u doorgaan?',('Ja', 'Nee', 'Annuleren'),'Een bericht van 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='Hallo', title='msgbox module'):
    dlg = MsgBox(_CTX)  # uno.getComponentContext()
    dlg.addButton(button)
    dlg.renderFromBoxSize(345)
    dlg.show(prompt,0,title)

g_exportedScripts = (my_script,)  # Toegangspunten tot LibreOffice
  
if __name__ == "__main__":  # toegangspunt tot IDEs
    from officehelper import SessionManager
    met SessionManager() als ctx: # Python externe context
      _CTX = ctx
      my_script()

ScriptForge.Basic service biedt MsgBox en InputBox alternatieven waarvan de handtekeningen nauw aansluiten bij die van Basic-functies.