2021-02-08 22:30:10 -06:00
|
|
|
|
|
|
|
1.2) Tools
|
|
|
|
^^^^^^^^^^
|
|
|
|
|
|
|
|
Remember, always import library.
|
|
|
|
|
|
|
|
.. code-block:: python
|
|
|
|
|
|
|
|
import easymacro as app
|
|
|
|
|
|
|
|
|
|
|
|
**Info from PC**
|
|
|
|
^^^^^^^^^^^^^^^^
|
|
|
|
|
|
|
|
* Operate system
|
|
|
|
|
|
|
|
.. code-block:: python
|
|
|
|
|
|
|
|
app.msgbox(app.OS)
|
|
|
|
|
|
|
|
* Current user
|
|
|
|
|
|
|
|
.. code-block:: python
|
|
|
|
|
|
|
|
app.msgbox(app.USER)
|
|
|
|
|
|
|
|
* Name PC
|
|
|
|
|
|
|
|
.. code-block:: python
|
|
|
|
|
|
|
|
app.msgbox(app.PC)
|
|
|
|
|
|
|
|
* Name desktop, only GNU/Linux
|
|
|
|
|
|
|
|
.. code-block:: python
|
|
|
|
|
|
|
|
app.msgbox(app.DESKTOP)
|
|
|
|
|
|
|
|
* Language
|
|
|
|
|
|
|
|
.. code-block:: python
|
|
|
|
|
|
|
|
app.msgbox(app.LANG)
|
|
|
|
|
|
|
|
* Language with variant
|
|
|
|
|
|
|
|
.. code-block:: python
|
|
|
|
|
|
|
|
app.msgbox(app.LANGUAGE)
|
|
|
|
|
|
|
|
* Application name
|
|
|
|
|
|
|
|
.. code-block:: python
|
|
|
|
|
|
|
|
app.msgbox(app.NAME)
|
|
|
|
|
|
|
|
* Application version
|
|
|
|
|
|
|
|
.. code-block:: python
|
|
|
|
|
|
|
|
app.msgbox(app.VERSION)
|
|
|
|
|
|
|
|
* In Windows
|
|
|
|
|
|
|
|
.. code-block:: python
|
|
|
|
|
|
|
|
app.msgbox(app.IS_WIN)
|
|
|
|
|
|
|
|
|
2021-02-08 22:39:56 -06:00
|
|
|
**Message box**
|
|
|
|
^^^^^^^^^^^^^^^
|
2021-02-08 22:30:10 -06:00
|
|
|
|
2021-02-08 22:39:56 -06:00
|
|
|
.. code-block:: python
|
|
|
|
|
|
|
|
app.msgbox(app.IS_WIN, 'My Macro')
|
|
|
|
|
|
|
|
|
|
|
|
**Show warning**
|
|
|
|
^^^^^^^^^^^^^^^^
|
|
|
|
|
|
|
|
.. code-block:: python
|
|
|
|
|
|
|
|
message = 'Caution, this action is dangerous'
|
|
|
|
title = 'My App'
|
|
|
|
app.warning(message, title)
|
|
|
|
|
|
|
|
|
|
|
|
**Show error box**
|
|
|
|
^^^^^^^^^^^^^^^^^^
|
|
|
|
|
|
|
|
.. code-block:: python
|
|
|
|
|
|
|
|
message = 'ERROR: Contact technical support'
|
|
|
|
title = 'My App'
|
|
|
|
app.errorbox(message, title)
|
|
|
|
|
|
|
|
|
|
|
|
**Make question**
|
|
|
|
^^^^^^^^^^^^^^^^^
|
|
|
|
|
|
|
|
.. code-block:: python
|
|
|
|
|
|
|
|
message = 'Is easy Python?'
|
|
|
|
title = 'My App'
|
|
|
|
result = app.question(message, title)
|
|
|
|
app.msgbox(result)
|
|
|
|
|
|
|
|
|
|
|
|
**InputBox**
|
2021-02-08 22:50:04 -06:00
|
|
|
^^^^^^^^^^^^
|
2021-02-08 22:39:56 -06:00
|
|
|
|
|
|
|
* Normal data
|
|
|
|
|
|
|
|
.. code-block:: python
|
|
|
|
|
|
|
|
message = 'Type your name'
|
|
|
|
default = ''
|
|
|
|
title = 'My App'
|
|
|
|
|
|
|
|
result = app.inputbox(message, default, title)
|
|
|
|
app.msgbox(result)
|
|
|
|
|
|
|
|
* Private data
|
|
|
|
|
|
|
|
.. code-block:: python
|
|
|
|
|
|
|
|
message = 'Type your password'
|
|
|
|
default = ''
|
|
|
|
title = 'My App'
|
|
|
|
echochar = "*"
|
|
|
|
|
|
|
|
result = app.inputbox(message, default, title, echochar)
|
|
|
|
app.msgbox(result)
|
2021-02-08 22:30:10 -06:00
|
|
|
|
|
|
|
|
2021-02-08 22:50:04 -06:00
|
|
|
**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)
|
|
|
|
|
2021-02-08 22:30:10 -06:00
|
|
|
|
2021-02-08 23:02:10 -06:00
|
|
|
**Paths and files**
|
|
|
|
^^^^^^^^^^^^^^^^^^^
|
|
|
|
|
|
|
|
* Get info path
|
|
|
|
|
|
|
|
.. code-block:: python
|
|
|
|
|
|
|
|
path = '/home/mau/myfile.ods'
|
|
|
|
p = app.paths(path)
|
|
|
|
|
|
|
|
app.debug(p.path)
|
|
|
|
app.debug(p.file_name)
|
|
|
|
app.debug(p.name)
|
|
|
|
app.debug(p.ext)
|
|
|
|
app.debug(p.url)
|
|
|
|
|
|
|
|
Or get information in a tuple
|
|
|
|
|
|
|
|
.. code-block:: python
|
|
|
|
|
|
|
|
path = '/home/mau/myfile.ods'
|
|
|
|
p = app.paths(path)
|
|
|
|
|
|
|
|
app.debug(p.info)
|
|
|
|
|
|
|
|
* Get path home
|
|
|
|
|
|
|
|
.. code-block:: python
|
|
|
|
|
|
|
|
path = app.paths.home
|
|
|
|
app.debug(path)
|
|
|
|
|
|
|
|
* Get path documents
|
|
|
|
|
|
|
|
.. code-block:: python
|
|
|
|
|
|
|
|
path = app.paths.documents
|
|
|
|
app.debug(path)
|
|
|
|
|
|
|
|
* Get path temp
|
|
|
|
|
|
|
|
.. code-block:: python
|
|
|
|
|
|
|
|
path = app.paths.temp_dir
|
|
|
|
app.debug(path)
|
|
|
|
|
|
|
|
|
2021-02-08 22:30:10 -06:00
|
|
|
.. _MRI: https://github.com/hanya/MRI
|