Metody klasy MsgBox w module msgbox języka Python upraszczają tworzenie okienek komunikatów przy użyciu funkcji API Abstract Windowing Toolkit. Konstruktor MsgBox tworzy puste okno dialogowe, które można uzupełnić przyciskami i tekstem.
Ten moduł nie jest częścią obsługiwanego interfejsu API UNO. Dane wyjściowe na ekranie modułu msgbox należy udostępniać wyłącznie w sytuacjach rozwojowych lub testowych.
Wykonywanie operacji wejścia/wyjścia na ekranie za pomocą języka Python można osiągnąć przy użyciu interfejsu API UNO LibreOfficeDev, korzystając z procedur usługi ScriptForge.Basic lub używając języka Python do wywołań międzyjęzykowych języka Basic, jak opisano na wiki.
|
Nazwa |
Tylko do odczytu |
Typ |
Opis |
|---|---|---|---|
|
numberOfLines |
Nie |
Boolean |
Opcjonalnie zastępuje renderowaną wysokość okna dialogowego. |
Lista metod w klasie MsgBox |
||
|---|---|---|
Dodaj przycisk do obiektu MsgBox().
addButton(caption: str)
caption: opis przycisku.
Zobacz szczegółowy przykład poniżej.
Definiuje wymiary okna dialogowego MsgBox oraz rozmiar przycisków zgodnie z określonym rozmiarem.
renderFromBoxSize(size=150)
size: rozmiar okna dialogowego.
Szerokość: ( 2 * size ) / ( 3 * numberOfbuttons + 1 )
Wysokość jest ustawiana na podstawie liczby separatorów Newline w tekście okna dialogowego.
Zobacz szczegółowy przykład poniżej.
Dostosowuje wymiary okna dialogowego MsgBox do określonego rozmiaru przycisków.
renderFromButtonSize(size=50)
size: rozmiar przycisków.
Szerokość: ( numberOfButtons * 1.5 + 0.5) * size
Wysokość jest ustawiana na podstawie liczby separatorów Newline w tekście okna dialogowego.
Zobacz szczegółowy przykład poniżej.
Wyświetla różne warianty MsgBox, takie jak pole informacyjne, pole ostrzegawcze itd.
show(message: str, decoration, title: str): str
message: tekst wyświetlany w oknie dialogowym może zawierać separatory Newline.
decoration: n/d.
title: podpis okna dialogowego.
Zobacz szczegółowy przykład poniżej.
import uno
from msgbox import MsgBox
if uno: _CTX = uno.getComponentContext()
def my_script():
response = msgBox('Czy chcesz kontynuować?',('Tak', 'Nie', 'Anuluj'),'Komunikat z Pythona')
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='zaadaptowano z msgbox.MsgBox', button='Witaj', title='Moduł msgbox'):
dlg = MsgBox(_CTX) # uno.getComponentContext()
dlg.addButton(button)
dlg.renderFromBoxSize(345)
dlg.show(prompt,0,title)
g_exportedScripts = (my_script,) # punkty wejścia LibreOffice
if __name__ == "__main__": # punkt wejścia środowisk IDE
from officehelper import SessionManager
with SessionManager() as ctx: # zdalny kontekst Pythona
_CTX = ctx
my_script()
Usługa ScriptForge.Basic udostępnia alternatywy dla funkcji MsgBox i InputBox, których sygnatury ściśle odpowiadają sygnaturom funkcji Basic.