Слушане на събития в документ

         # -*- coding: utf-8 -*-
         from __future__ import unicode_literals
             
         import os.path, uno, unohelper
         from com.sun.star.document import DocumentEvent, \
             XDocumentEventListener as AdapterPattern
         from com.sun.star.lang import EventObject
             
         class UiDocument(unohelper.Base, AdapterPattern):
             """ Наблюдение на събития в документ """
             '''
             адаптирано от „Скрипт на Python за наблюдение на събитието OnSave“ на
             https://forum.openoffice.org/en/forum/viewtopic.php?t=68887
             '''
             def __init__(self):
                 """ Наблюдател на събития в документ """
                 ''' докладване чрез конзолата на Access2Base.Trace ИЛИ
                 в лист 1, колона 1 за документи на Calc '''
                 ctx = uno.getComponentContext()
                 smgr = ctx.getServiceManager()
                 desktop = smgr.createInstanceWithContext(
                 'com.sun.star.frame.Desktop' , ctx)
                 self.doc = desktop.CurrentComponent
                 #self.row = 0  # извадете от коментар само за документи на Calc
                 Console.setLevel("DEBUG")
                 self.listen()  # Започване наблюдение на събития в док.
             
             @property
             def Filename(self) -> str:
                 sys_filename = uno.fileUrlToSystemPath(self.doc.URL)
                 return os.path.basename(sys_filename)
             
             def setCell(self, calcDoc, txt: str):
                 """ Извеждане събитията в колона 1 на ел. таблица в Calc """
                 sheet = calcDoc.getSheets().getByIndex(0)
                 sheet.getCellByPosition(0,self.row).setString(txt)
                 self.row = self.row + 1
             
             def listen(self, *args):  # OnLoad/OnNew възможно най-рано
                 """ Започване наблюдението на събития """
                 self.doc.addDocumentEventListener(self)
                 Console.log("ИНФОРМАЦИЯ", "Събитията в документа се регистрират", True)
             
             def sleep(self, *args):  # OnUnload най-късно (незадължително)
                 """ Спиране наблюдението на събития """
                 self.doc.removeDocumentEventListener(self)
                 Console.log("ИНФОРМАЦИЯ", "Регистрирането на събития приключи", True)
             
             def documentEventOccured(self, event: DocumentEvent):
                 """ Прехваща всички събития в док. """
                 #self.setCell(event.Source, event.EventName) # само в док. на Calc
                 Console.log("DEBUG",
                     event.EventName+" in "+self.Filename,
                     False)
             
             def disposing(self, event: EventObject):
                 """ Освобождаване на всичко """
                 self.sleep()
                 Console.show()
             
         def OnLoad(*args):  # Събитие „Отваряне на документ“
             listener = UiDocument()  # Започва слушане
             
         def OnUnload(*args):  # Събитие „Документът е затворен“
             pass  # (незадължително) изпълнявано при освобождаване
             
         g_exportedScripts = (OnLoad,)
             
         from com.sun.star.script.provider import XScript
         class Console():
             """
             Конзола на заден/преден план за докладване/регистриране изпълнението на програмата.
             """
             @staticmethod
             def trace(*args,**kwargs):
                 """ Отпечатване на списък от елементи в конзолата """
                 scr = Console._a2bScript(script='DebugPrint', module='Compatible')
                 scr.invoke((args),(),())
             @staticmethod
             def log(level: str, text: str, msgBox=False):
                 """ Доб. съобщение в конзолата, възм. подкана към потребителя """
                 scr = Console._a2bScript(script='TraceLog')
                 scr.invoke((level,text,msgBox),(),())
             @staticmethod
             def setLevel(logLevel: str):
                 """ Зад. долна граница на съобщенията"""
                 scr = Console._a2bScript(script='TraceLevel')
                 scr.invoke((logLevel,),(),())
             @staticmethod
             def show():
                 """ Показване съдържание в конзолата/диалог """
                 scr = Console._a2bScript(script='TraceConsole')
                 scr.invoke((),(),())
             @staticmethod
             def _a2bScript(script: str, library='Access2Base',
                 module='Trace') -> XScript:
                 ''' Получаване на скрипт на Basic, базиран на приложение '''
                 sm = uno.getComponentContext().ServiceManager
                 mspf = sm.createInstanceWithContext(
                     "com.sun.star.script.provider.MasterScriptProviderFactory",
                     uno.getComponentContext())
                 scriptPro = mspf.createScriptProvider("")
                 scriptName = "vnd.sun.star.script:"+library+"."+module+"."+script+"?language=Basic&location=application"
                 xScript = scriptPro.getScript(scriptName)
                 return xScript
      

         # -*- coding: utf-8 -*-
         from __future__ import unicode_literals
             
         import uno, apso_utils as ui
             
         def displayAvailableEvents():
             """ Показване на събитията, свързани с документ """
             '''
             адаптирано от DisplayAvailableEvents() от A. Pitonyak
             https://forum.openoffice.org/en/forum/viewtopic.php?&t=43689
             '''
             ctx = XSCRIPTCONTEXT.getComponentContext()
             smgr = ctx.ServiceManager
             geb = smgr.createInstanceWithContext(
                 "com.sun.star.frame.GlobalEventBroadcaster", ctx)
             events = geb.Events.getElementNames()
             ui.msgbox('; '.join(events))
             
         g_exportedScripts = (displayAvailableEvents,)