290 lines
4.3 KiB
ReStructuredText
290 lines
4.3 KiB
ReStructuredText
|
|
Application
|
|
-----------
|
|
|
|
Remember, always import library.
|
|
|
|
.. code-block:: python
|
|
|
|
import easymacro as app
|
|
|
|
|
|
Create instances
|
|
^^^^^^^^^^^^^^^^
|
|
|
|
* Instances without context
|
|
|
|
.. code-block:: python
|
|
|
|
toolkit = app.create_instance("com.sun.star.awt.Toolkit")
|
|
|
|
* Instances with context
|
|
|
|
.. code-block:: python
|
|
|
|
service = 'com.sun.star.awt.DialogProvider2'
|
|
dialog = app.create_instance(service, True)
|
|
|
|
|
|
* Get desktop
|
|
|
|
.. code-block:: python
|
|
|
|
desktop1 = app.create_instance('com.sun.star.frame.Desktop', True)
|
|
# ~ or
|
|
desktop2 = app.get_desktop()
|
|
|
|
app.msgbox(desktop1 == desktop2)
|
|
|
|
|
|
Current doc
|
|
^^^^^^^^^^^
|
|
|
|
.. code-block:: python
|
|
|
|
doc = app.active
|
|
app.msgbox(doc.title)
|
|
|
|
|
|
Iter docs
|
|
^^^^^^^^^
|
|
|
|
.. code-block:: python
|
|
|
|
for doc in app.docs:
|
|
app.msgbox(doc.title)
|
|
|
|
|
|
Count
|
|
^^^^^
|
|
|
|
.. code-block:: python
|
|
|
|
count = len(app.docs)
|
|
app.msgbox(count)
|
|
|
|
|
|
Get by name
|
|
^^^^^^^^^^^
|
|
|
|
.. code-block:: python
|
|
|
|
name = 'MyDoc.ods'
|
|
if name in app.docs:
|
|
doc = app.docs[name]
|
|
app.msgbox(doc.title)
|
|
|
|
|
|
If contain
|
|
^^^^^^^^^^
|
|
|
|
.. code-block:: python
|
|
|
|
result = 'myfile.ods' in app.docs
|
|
app.msgbox(result)
|
|
|
|
|
|
|
|
New
|
|
^^^
|
|
|
|
For default create new Calc document.
|
|
|
|
.. code-block:: python
|
|
|
|
doc = app.docs.new()
|
|
app.msgbox(doc.type)
|
|
|
|
|
|
For new Writer document.
|
|
|
|
.. code-block:: python
|
|
|
|
doc = app.docs.new('writer')
|
|
app.msgbox(doc.type)
|
|
|
|
|
|
With arguments.
|
|
|
|
.. code-block:: python
|
|
|
|
args= {'Hidden': True}
|
|
doc = app.docs.new('writer', args)
|
|
msg = f'{doc.type} - {doc.title}'
|
|
app.msgbox(msg)
|
|
doc.visible = True
|
|
|
|
|
|
Other documents.
|
|
|
|
.. code-block:: python
|
|
|
|
doc = app.docs.new('draw')
|
|
app.msgbox(doc.type)
|
|
|
|
doc = app.docs.new('impress')
|
|
app.msgbox(doc.type)
|
|
|
|
|
|
Open
|
|
^^^^
|
|
|
|
.. code-block:: python
|
|
|
|
path = '/home/mau/MyDoc.ods'
|
|
doc = app.docs.open(path)
|
|
|
|
|
|
While LibreOffice support format, you can open arbitrary file.
|
|
|
|
.. code-block:: python
|
|
|
|
path = '/home/mau/example.xlsx'
|
|
doc = app.docs.open(path)
|
|
|
|
|
|
With arguments.
|
|
|
|
.. code-block:: python
|
|
|
|
path = '/home/mau/example.odt'
|
|
args = {'Password': 'letmein'}
|
|
doc = app.docs.open(path, args)
|
|
|
|
|
|
Save
|
|
^^^^
|
|
|
|
.. code-block:: python
|
|
|
|
path = '/home/mau/myfile.ods'
|
|
doc = app.docs.new()
|
|
doc.save(path)
|
|
|
|
* If previously open and modify any file.
|
|
|
|
.. code-block:: python
|
|
|
|
doc.save()
|
|
|
|
* Open exists file and save with other name.
|
|
|
|
.. code-block:: python
|
|
|
|
path = '/home/mau/myfile.ods'
|
|
doc = app.docs.open(path)
|
|
new_path = '/srv/mau/other_name.ods'
|
|
doc.save(new_path)
|
|
|
|
|
|
Close
|
|
^^^^^
|
|
|
|
.. code-block:: python
|
|
|
|
doc = app.docs.new()
|
|
app.msgbox(doc.title)
|
|
doc.close()
|
|
|
|
|
|
To PDF
|
|
^^^^^^
|
|
|
|
* Save in path
|
|
|
|
.. code-block:: python
|
|
|
|
doc = app.active
|
|
path = '/home/mau/test.pdf'
|
|
doc.to_pdf(path)
|
|
|
|
* Save in memory
|
|
|
|
.. code-block:: python
|
|
|
|
doc = app.active
|
|
pdf = doc.to_pdf()
|
|
|
|
|
|
Export
|
|
^^^^^^
|
|
|
|
* Export common formats
|
|
|
|
.. code-block:: python
|
|
|
|
doc = app.docs.new()
|
|
path = '/home/mau/myfile.xlsx'
|
|
filter_name = 'xlsx'
|
|
doc.export(path, filter_name)
|
|
|
|
path = '/home/mau/myfile.xls'
|
|
filter_name = 'xls'
|
|
doc.export(path, filter_name)
|
|
|
|
doc = app.docs.new('writer')
|
|
path = '/home/mau/myfile.docx'
|
|
filter_name = 'docx'
|
|
doc.export(path, filter_name)
|
|
|
|
path = '/home/mau/myfile.doc'
|
|
filter_name = 'doc'
|
|
doc.export(path, filter_name)
|
|
|
|
* For all support formats look `Apendix`_
|
|
|
|
|
|
Fonst
|
|
^^^^^
|
|
|
|
* Get all fonts
|
|
|
|
.. code-block:: python
|
|
|
|
fonts = app.get_fonts()
|
|
for f in fonts:
|
|
print(f'Name: {f.Name} - StyleName: {f.StyleName}')
|
|
|
|
|
|
Filters
|
|
^^^^^^^
|
|
|
|
* Get all `support filters`_
|
|
|
|
.. code-block:: python
|
|
|
|
filters = app.get_filters()
|
|
ds = []
|
|
for f in filters:
|
|
data = f"UI Name: {f['UIName']} - Name: {f['Name']} - Type: {f['Type']}"
|
|
app.debug(data)
|
|
|
|
|
|
Call dispatch
|
|
^^^^^^^^^^^^^
|
|
|
|
You can call any `dispatch command`_ used only if property or method no exists in original object or in `easymacro.py`
|
|
|
|
.. code-block:: python
|
|
|
|
doc = app.active
|
|
command = '.uno:Gallery'
|
|
app.call_dispatch(doc, command)
|
|
|
|
|
|
Properties
|
|
^^^^^^^^^^
|
|
|
|
Title
|
|
~~~~~
|
|
|
|
.. code-block:: python
|
|
|
|
doc = app.active
|
|
app.msgbox(doc.title)
|
|
|
|
|
|
.. _dispatch command: https://wiki.documentfoundation.org/Development/DispatchCommands
|
|
.. _support filters: https://help.libreoffice.org/latest/en-US/text/shared/guide/convertfilters.html
|
|
.. _Apendix: apendix
|