Os métodos da classe MsgBox no módulo msgbox do Python simplificam a criação de caixas de mensagem utilizando os recursos da API do Abstract Windowing Toolkit. O construtor MsgBox cria uma caixa de diálogo vazia para ser preenchida com botões e textos.
Este módulo não faz parte da API UNO suportada. A exibição no ecrã através do módulo msgbox deve limitar-se a situações de desenvolvimento ou teste.
A realização de entradas e saídas para o ecrã com Python pode ser conseguida utilizando a API LibreOfficeDev UNO, recorrendo ao ScriptForge. Rotinas de serviço básicas do ou utilizando chamadas entre linguagens Python e Basic, conforme descrito na wiki.
|
Nome |
Readonly |
Tipo |
Descrição |
|---|---|---|---|
|
numberOfLines |
Não |
Boolean |
Substitui, opcionalmente, a altura de renderização da caixa de diálogo. |
Lista de métodos da classe MsgBox |
||
|---|---|---|
Adicionar um botão a um objeto MsgBox().
addButton(caption: str)
legenda: Legenda do botão.
Veja abaixo um exemplo detalhado.
Define as dimensões da caixa de diálogo MsgBox, bem como o tamanho dos botões, de acordo com um tamanho especificado.
renderFromBoxSize(size=150)
tamanho: Tamanho da caixa de diálogo.
Largura: ( 2 * tamanho ) / ( 3 * númeroDebotões + 1 )
A altura é definida de acordo com o número de separadores Nova linha no texto da caixa de diálogo.
Veja abaixo um exemplo detalhado.
Adapta as dimensões da caixa de diálogo MsgBox de acordo com um tamanho especificado para os botões.
renderFromButtonSize(size=50)
tamanho: Tamanho dos botões.
Largura: (númeroDeBotões * 1,5 + 0,5) * tamanho
A altura é definida de acordo com o número de separadores NovaLinha no texto da caixa de diálogo.
Veja abaixo um exemplo detalhado.
Exibe variações do MsgBox, tais como caixas de informação, caixas de aviso e assim por diante.
show(message: str, decoration, title: str): str
mensagem: Texto exibido numa caixa de diálogo que pode conter separadores Newline.
decoração: n.d.
título: Legenda da caixa de diálogo.
Veja abaixo um exemplo detalhado.
import uno
from msgbox import MsgBox
if uno: _CTX = uno.getComponentContext()
def my_script():
response = msgBox('Deseja continuar?', ('Sim', 'Não', 'Cancelar'), 'Uma mensagem do 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='adaptado de msgbox.MsgBox', button='Olá', title='módulo msgbox'):
dlg = MsgBox(_CTX) # uno.getComponentContext()
dlg.addButton(button)
dlg.renderFromBoxSize(345)
dlg.show(prompt,0,title)
g_exportedScripts = (my_script,) # Pontos de entrada do LibreOffice
if __name__ == "__main__": # ponto de entrada para IDEs
from officehelper import SessionManager
com SessionManager() como ctx: # Contexto remoto do Python
_CTX = ctx
my_script()
ScriptForge.Basic fornece alternativas para MsgBox e InputBox cujas assinaturas correspondem de perto às das funções do Basic.