Моля, подкрепете ни!

Модул msgbox

За достъп до тази команда...

Отворете менюто Инструменти - Макроси - Диспечер на макроси.


Описание

Методите на класа MsgBox в модула на Python msgbox опростяват създаването на прозорци за съобщения чрез средствата на Abstract Windowing Toolkit API. Конструкторът MsgBox създава празен диалог, в който да бъдат добавени бутони и текстове.

Икона Внимание

Този модул не е част от поддържания програмен интерфейс UNO API. Изходът към екран чрез модула msgbox трябва да се използва само при разработване или тестване.


Икона Съвет

Извършването на входно-изходните операции към екран с Python може да се постигне с LibreOfficeDev UNO API с чрез методите на услугата ScriptForge.Basic или с междуезикови обръщения от Python към Basic, както е описано в уикито.


Свойства

Име

Само за четене

Тип

Описание

numberOfLines

Не

Boolean

Позволява подмяна на височината, с която се изобразява диалогът.


Методи

Списък с методи на класа MsgBox

addButton

renderFromBoxSize

renderFromButtonSize

show


addButton

Добавя бутон в обект MsgBox().

Синтаксис:

addButton(caption: str)

Параметри:

caption: надпис на бутона.

Пример:

Вижте подробния пример по-долу.

renderFromBoxSize

Задава размерите на диалога MsgBox, както и размера на бутоните, чрез указан базов размер.

Синтаксис:

renderFromBoxSize(size=150)

Параметри:

size: размер на диалога.
Ширина: (2 * размер) / (3 * брой_бутони + 1)
Височината се задава според броя разделители Newline (нов ред) в текста на диалога.

Пример:

Вижте подробния пример по-долу.

renderFromButtonSize

Приспособява размерите на диалога MsgBox според указан размер за бутоните.

Синтаксис:

renderFromButtonSize(size=50)

Параметри:

size: размер за бутоните.
Ширина: (брой_бутони * 1.5 + 0.5) * размер
Височината се задава според броя разделители Newline (нов ред) в текста на диалога.

Пример:

Вижте подробния пример по-долу.

show

Показва варианти на MsgBox, например прозорец с информация, прозорец с предупреждение и т.н.

Синтаксис:

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

Параметри:

message: подканващият текст на диалога, който може да съдържа разделители за нов ред Newline.

decoration: не се прилага.

title: заглавие на диалога.

Пример:

Вижте подробния пример по-долу.

Подробен пример


import uno
from msgbox import MsgBox

if uno: _CTX = uno.getComponentContext()

def my_script():
    response = msgBox('Искате ли да продължите?',('Да', 'Не', 'Отказ'),'Съобщение от 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='Адаптирано от msgbox.MsgBox', button='Здрасти', title='Модул msgbox'):
    dlg = MsgBox(_CTX)  # uno.getComponentContext()
    dlg.addButton(button)
    dlg.renderFromBoxSize(345)
    dlg.show(prompt,0,title)

g_exportedScripts = (my_script,)  # Входни точки на LibreOffice
  
if __name__ == "__main__":  # Входна точка за интегрирани развойни среди
    from officehelper import SessionManager
    with SessionManager() as ctx:  # Отдалечен контекст на Python
      _CTX = ctx
      my_script()
Икона Съвет

Услугата ScriptForge.Basic предоставя алтернативи на MsgBox и InputBox, чиито сигнатури са много близки до тези на функциите на Basic.