diff --git a/doc/content/es/documents/_index.md b/doc/content/es/documents/_index.md index 68b5b6b..6410e7c 100644 --- a/doc/content/es/documents/_index.md +++ b/doc/content/es/documents/_index.md @@ -7,6 +7,61 @@ weight = 5 ### active +Documento activo. ```python +doc = app.active +app.msgbox(doc.title) +``` + + +### iteration + +Iterar en todos los documentos abiertos. + +```python +for doc in app.docs: + app.debug(doc.type, doc.title) +``` + + +### count + +Contar los documentos abiertos. + +```python +cuantos = len(app.docs) +app.debug(cuantos) +``` + + +### contain + +Verificar si un documento esta en la colección. + +```python +resultado = 'mi_archivo.ods' in app.docs +app.debug(resultado) +``` + + +### index + +Devolver por índice. + +```python +doc = app.docs[1] +app.debug(doc.type, doc.title) +``` + + +### name + +Devolver por nombre. + +```python +nombre = 'mi_archivo.ods' +if nombre in app.docs: + doc = app.docs[nombre] + app.debug(doc.type, doc.title) ``` diff --git a/doc/content/es/documents/methods/_index.md b/doc/content/es/documents/methods/_index.md new file mode 100644 index 0000000..4b3fa0b --- /dev/null +++ b/doc/content/es/documents/methods/_index.md @@ -0,0 +1,244 @@ ++++ +title = "Métodos" +weight = 2 ++++ + +### new + +Crear nuevo documento, la aplicación predeterminada es Calc. + +```python +doc = app.docs.new() +app.debug(doc.type) +``` + +Para un nuevo documento `writer`. + +```python +doc = app.docs.new('writer') +app.debug(doc.type) +``` + +Otros documentos. + +```python +doc = app.docs.new('draw') +app.debug(doc.type) + +doc = app.docs.new('impress') +app.debug(doc.type) + +doc = app.docs.new('math') +app.debug(doc.type) +``` + +Crear con argumentos. + +```python +propiedades = {'Hidden': True} +doc = app.docs.new('writer', propiedades) +mensaje = f'{doc.type} - {doc.title}' +app.msgbox(mensaje) +doc.visible = True +``` + +{{% notice tip %}} +No es necesario que el documento este visible para manipularse. +{{% /notice %}} + + +### open + +Abrir archivos. + +```python +ruta = '/home/mau/Mi_archivo.ods' +doc = app.docs.open(ruta) +``` + +{{% notice tip %}} +No es necesario pasar las rutas en formato URL. +{{% /notice %}} + + +Puede abrir cualquier archivo que sea soportado por LibreOffice. + +```python +ruta = '/home/mau/ejemplo.xlsx' +doc = app.docs.open(ruta) +``` + +Abrir con argumentos. + +```python +ruta = '/home/mau/ejemplo.ods' +argumentos = {'Password': 'siscaloburropanzon'} +doc = app.docs.open(ruta, argumentos) +``` + + +### save + +Guardar un nuevo documento. + +```python +path = '/home/mau/nuevo_documento.ods' +doc = app.docs.new() +doc.save(path) +``` + +Cualquier archivo, previamente guardado, que sea modificado puede ser guardado con: + +```python +doc.save() +``` + +Abrir un archivo existente y guardarlo con otro nombre. + +```python +ruta = '/home/mau/ejemplo.ods' +doc = app.docs.open(ruta) +nueva_ruta = '/home/mau/otro_nombre.ods' +doc.save(nueva_ruta) +``` + + +### close + +Cerrar un archivo. + +```python +doc = app.docs.new() +app.msgbox(doc.title) +doc.close() +``` + + +### to_pdf + +Exportar a PDF. + +```python +doc = app.active +ruta = '/home/mau/ejemplo.pdf' +doc.to_pdf(ruta) +``` + +Si no se establece una ruta, se devuelve el PDF en memoria. + +```python +doc = app.active +pdf = doc.to_pdf() +app.debug(pdf) +``` + + +Mire las [opciones del filtro de exportación a PDF][1], puede pasarlas como un diccionario como segundo argumento de este método. + + +### export + +Exportar a otros formatos. + +```python +doc = app.docs.new() +ruta = '/home/mau/miarchivo.xlsx' +filtro = 'xlsx' +doc.export(ruta, filtro) + +ruta = '/home/mau/miarchivo.xls' +filtro = 'xls' +doc.export(ruta, filtro) + +doc = app.docs.new('writer') +ruta = '/home/mau/miarchivo.docx' +filtro = 'docx' +doc.export(ruta, filtro) + +ruta = '/home/mau/miarchivo.doc' +filtro = 'doc' +doc.export(ruta, filtro) + +ruta = '/home/mau/miarchivo.rtf' +filtro = 'rtf' +doc.export(ruta, filtro) +``` + +Exportar en memoria. + +```python +doc = app.docs.new() +filtro = 'xlsx' +excel_doc = doc.export(filter_name=filtro) +``` + + +### set_focus + +Enviar el foco al documento. + +```python +for doc in app.docs: + app.debug(doc.title) + doc.set_focus() + app.sleep(1) +``` + + +### copy + +Copiar la selección activa al portapapeles. + +```python +doc = app.active +doc.copy() +``` + + +### paste + +Copiar el contenido del portapapeles, en la selección actual. + +```python +doc = app.active +doc.paste() +``` + + +### paste_special + +Mostrar el cuadro de diálogo `Pegado Especial`. + +{{% notice tip %}} +Solo se mostrará si existe contenido en el portapapeles. +{{% /notice %}} + +```python +doc = app.active +doc.paste_special() +``` + + +### paste_values + +Pegar solo los valores. + +```python +doc = app.active +doc.paste_values() +``` + +Si el destino no esta vacío, el usuario verá el cuadro de mensaje de confirmación. + + +### clear_undo + +La mayoría de las acciones realizadas por código, quedan en el historial de acciones, por lo que el usuario puede deshacerlas. Para eviar esto se puede limpiar este historial. + +```python +doc = app.active +doc.clear_undo() +``` + + +[1]: https://wiki.documentfoundation.org/Macros/Python_Guide/PDF_export_filter_data diff --git a/doc/content/es/documents/properties/_index.md b/doc/content/es/documents/properties/_index.md new file mode 100644 index 0000000..aaeb286 --- /dev/null +++ b/doc/content/es/documents/properties/_index.md @@ -0,0 +1,189 @@ ++++ +title = "Propiedades" +weight = 1 ++++ + +#### Propiedades comúnes a todos los documentos. + +### obj + +**Solo lectura**. Devolver el objeto original pyUNO. + +```python +doc = app.active +app.debug(type(doc)) +app.debug(type(doc.obj)) +``` + +``` +18/08/2022 21:59:05 - DEBUG - +18/08/2022 21:59:05 - DEBUG - +``` + + +### title + +Título del documento. + +```python +doc = app.active +app.debug(doc.title) +doc.title = 'Nuevo Titulo' +app.debug(doc.title) +``` + + +### type + +**Solo lectura**. Devolver el tipo de documento: calc, writer, etc. + +```python +doc = app.active +app.debug(doc.type) +``` + + +### uid + +**Solo lectura**. Devolver el valor interno RuntimeUID del documento. + +```python +doc = app.active +app.debug(doc.uid) +``` + + +### is_saved + +**Solo lectura**. Si el documento ya ha sido guardado en disco. + +```python +doc = app.active +app.debug(doc.is_saved) +``` + +### is_modified + +**Solo lectura**. Si el documento ha sido modificado. + +```python +doc = app.active +app.debug(doc.is_modified) +``` + + +### is_read_only + +**Solo lectura**. Si el documento es de solo lectura. + +```python +doc = app.active +app.debug(doc.is_read_only) +``` + + +### path + +**Solo lectura**. Devolver la ruta en disco del documento. + +```python +doc = app.active +app.debug(doc.path) +``` + + +### dir + +**Solo lectura**. Devolver solo el directorio de la ruta en disco del documento. + +```python +doc = app.active +app.debug(doc.dir) +``` + + +### file_name + +**Solo lectura**. Devolver el nombre con extensión de la ruta del documento. + +```python +doc = app.active +app.debug(doc.file_name) +``` + + +### name + +**Solo lectura**. Devolver el nombre sin extensión de la ruta del documento. + +```python +doc = app.active +app.debug(doc.name) +``` + + +### visible + +Ocultar o mostrar un documento. + +```python +doc = app.active +doc.visible = False +app.msgbox(doc.visible) +doc.visible = True +``` + +{{% notice tip %}} +No es necesario que el documento este visible para manipularse. +{{% /notice %}} + + +### zoom + +Devolver o establecer el porcentaje de zoom del documento. + +```python +doc = app.active +zoom = doc.zoom +app.msgbox(zoom) +doc.zoom = zoom * 2 +app.msgbox(doc.zoom) +doc.zoom = zoom +``` + +### status_bar + +Controlar la barra de estado, es importante siempre actualizar en otro hilo. + +```python +@app.run_in_thread +def controlar_barra_estado(sb, texto, limite): + sb.start(texto, limite) + for i in range(limite): + sb.setValue(i) + app.sleep(1) + sb.end() + return + +def main(): + doc = app.active + controlar_barra_estado(doc.status_bar, 'Línea: ', 10) + return +``` + +Es importante siempre devolver el control de la barra de estado a la aplicación con el método `end`. + + +### selection + +Devolver la selección actual. + +```python +doc = app.active +selection = doc.selection +app.debug(selection) +``` + +{{% notice warning %}} +**Cuidado**, la selección actual pueden ser muchas cosas diferentes. +{{% /notice %}} diff --git a/doc/public/404.html b/doc/public/404.html index f94e603..ac39184 100644 --- a/doc/public/404.html +++ b/doc/public/404.html @@ -9,15 +9,15 @@ 404 Page not found - - - - - - - + + + + + + + - + + + + + + + + + +
+
+
+ +
+
+ + + + +
+
+ +
+
+ + +
+
+ +
+ +
+ +
+ +

+ + Métodos +

+ + + + + + +

new

+

Crear nuevo documento, la aplicación predeterminada es Calc.

+
doc = app.docs.new()
+app.debug(doc.type)
+

Para un nuevo documento writer.

+
doc = app.docs.new('writer')
+app.debug(doc.type)
+

Otros documentos.

+
doc = app.docs.new('draw')
+app.debug(doc.type)
+
+doc = app.docs.new('impress')
+app.debug(doc.type)
+
+doc = app.docs.new('math')
+app.debug(doc.type)
+

Crear con argumentos.

+
propiedades = {'Hidden': True}
+doc = app.docs.new('writer', propiedades)
+mensaje = f'{doc.type} - {doc.title}'
+app.msgbox(mensaje)
+doc.visible = True
+
+

No es necesario que el documento este visible para manipularse.

+
+ +

open

+

Abrir archivos.

+
ruta = '/home/mau/Mi_archivo.ods'
+doc = app.docs.open(ruta)
+
+

No es necesario pasar las rutas en formato URL.

+
+ +

Puede abrir cualquier archivo que sea soportado por LibreOffice.

+
ruta = '/home/mau/ejemplo.xlsx'
+doc = app.docs.open(ruta)
+

Abrir con argumentos.

+
ruta = '/home/mau/ejemplo.ods'
+argumentos = {'Password': 'siscaloburropanzon'}
+doc = app.docs.open(ruta, argumentos)
+

save

+

Guardar un nuevo documento.

+
path = '/home/mau/nuevo_documento.ods'
+doc = app.docs.new()
+doc.save(path)
+

Cualquier archivo, previamente guardado, que sea modificado puede ser guardado con:

+
doc.save()
+

Abrir un archivo existente y guardarlo con otro nombre.

+
ruta = '/home/mau/ejemplo.ods'
+doc = app.docs.open(ruta)
+nueva_ruta = '/home/mau/otro_nombre.ods'
+doc.save(nueva_ruta)
+

close

+

Cerrar un archivo.

+
doc = app.docs.new()
+app.msgbox(doc.title)
+doc.close()
+

to_pdf

+

Exportar a PDF.

+
doc = app.active
+ruta = '/home/mau/ejemplo.pdf'
+doc.to_pdf(ruta)
+

Si no se establece una ruta, se devuelve el PDF en memoria.

+
doc = app.active
+pdf = doc.to_pdf()
+app.debug(pdf)
+

Mire las opciones del filtro de exportación a PDF, puede pasarlas como un diccionario como segundo argumento de este método.

+

export

+

Exportar a otros formatos.

+
doc = app.docs.new()
+ruta = '/home/mau/miarchivo.xlsx'
+filtro = 'xlsx'
+doc.export(ruta, filtro)
+
+ruta = '/home/mau/miarchivo.xls'
+filtro = 'xls'
+doc.export(ruta, filtro)
+
+doc = app.docs.new('writer')
+ruta = '/home/mau/miarchivo.docx'
+filtro = 'docx'
+doc.export(ruta, filtro)
+
+ruta = '/home/mau/miarchivo.doc'
+filtro = 'doc'
+doc.export(ruta, filtro)
+
+ruta = '/home/mau/miarchivo.rtf'
+filtro = 'rtf'
+doc.export(ruta, filtro)
+

Exportar en memoria.

+
doc = app.docs.new()
+filtro = 'xlsx'
+excel_doc = doc.export(filter_name=filtro)
+

set_focus

+

Enviar el foco al documento.

+
for doc in app.docs:
+    app.debug(doc.title)
+    doc.set_focus()
+    app.sleep(1)
+

copy

+

Copiar la selección activa al portapapeles.

+
doc = app.active
+doc.copy()
+

paste

+

Copiar el contenido del portapapeles, en la selección actual.

+
doc = app.active
+doc.paste()
+

paste_special

+

Mostrar el cuadro de diálogo Pegado Especial.

+ +

Solo se mostrará si existe contenido en el portapapeles.

+
+ +
doc = app.active
+doc.paste_special()
+

paste_values

+

Pegar solo los valores.

+
doc = app.active
+doc.paste_values()
+

Si el destino no esta vacío, el usuario verá el cuadro de mensaje de confirmación.

+

clear_undo

+

La mayoría de las acciones realizadas por código, quedan en el historial de acciones, por lo que el usuario puede deshacerlas. Para eviar esto se puede limpiar este historial.

+
doc = app.active
+doc.clear_undo()
+
+ + + + +
+ +
+ + +
+ + +
+ + + +
+ +
+
+
+ + + + + + + + + + + + + + + + + + + + diff --git a/doc/public/es/documents/methods/index.xml b/doc/public/es/documents/methods/index.xml new file mode 100644 index 0000000..ebdfb1a --- /dev/null +++ b/doc/public/es/documents/methods/index.xml @@ -0,0 +1,10 @@ + + + + Métodos on Documentación para EasyMacro + https://doc.cuates.net/easymacro/es/documents/methods/ + Recent content in Métodos on Documentación para EasyMacro + Hugo -- gohugo.io + en-us + + diff --git a/doc/public/es/documents/properties/index.html b/doc/public/es/documents/properties/index.html new file mode 100644 index 0000000..776bbfb --- /dev/null +++ b/doc/public/es/documents/properties/index.html @@ -0,0 +1,1347 @@ + + + + + + + + + + + + Propiedades :: Documentación para EasyMacro + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+ + + + +
+
+ +
+
+ + +
+
+ +
+ +
+ +
+ +

+ + Propiedades +

+ + + + + + +

Propiedades comúnes a todos los documentos.

+

obj

+

Solo lectura. Devolver el objeto original pyUNO.

+
doc = app.active
+app.debug(type(doc))
+app.debug(type(doc.obj))
+
18/08/2022 21:59:05 - DEBUG - <class 'easymacro.easycalc.LOCalc'>
+18/08/2022 21:59:05 - DEBUG - <class 'pyuno'>
+

title

+

Título del documento.

+
doc = app.active
+app.debug(doc.title)
+doc.title = 'Nuevo Titulo'
+app.debug(doc.title)
+

type

+

Solo lectura. Devolver el tipo de documento: calc, writer, etc.

+
doc = app.active
+app.debug(doc.type)
+

uid

+

Solo lectura. Devolver el valor interno RuntimeUID del documento.

+
doc = app.active
+app.debug(doc.uid)
+

is_saved

+

Solo lectura. Si el documento ya ha sido guardado en disco.

+
doc = app.active
+app.debug(doc.is_saved)
+

is_modified

+

Solo lectura. Si el documento ha sido modificado.

+
doc = app.active
+app.debug(doc.is_modified)
+

is_read_only

+

Solo lectura. Si el documento es de solo lectura.

+
doc = app.active
+app.debug(doc.is_read_only)
+

path

+

Solo lectura. Devolver la ruta en disco del documento.

+
doc = app.active
+app.debug(doc.path)
+

dir

+

Solo lectura. Devolver solo el directorio de la ruta en disco del documento.

+
doc = app.active
+app.debug(doc.dir)
+

file_name

+

Solo lectura. Devolver el nombre con extensión de la ruta del documento.

+
doc = app.active
+app.debug(doc.file_name)
+

name

+

Solo lectura. Devolver el nombre sin extensión de la ruta del documento.

+
doc = app.active
+app.debug(doc.name)
+

visible

+

Ocultar o mostrar un documento.

+
doc = app.active
+doc.visible = False
+app.msgbox(doc.visible)
+doc.visible = True
+
+

No es necesario que el documento este visible para manipularse.

+
+ +

zoom

+

Devolver o establecer el porcentaje de zoom del documento.

+
doc = app.active
+zoom = doc.zoom
+app.msgbox(zoom)
+doc.zoom = zoom * 2
+app.msgbox(doc.zoom)
+doc.zoom = zoom
+

status_bar

+

Controlar la barra de estado, es importante siempre actualizar en otro hilo.

+
@app.run_in_thread
+def controlar_barra_estado(sb, texto, limite):
+    sb.start(texto, limite)
+    for i in range(limite):
+        sb.setValue(i)
+        app.sleep(1)
+    sb.end()
+    return
+
+def main():
+    doc = app.active
+    controlar_barra_estado(doc.status_bar, 'Línea: ', 10)
+    return
+

Es importante siempre devolver el control de la barra de estado a la aplicación con el método end.

+

selection

+

Devolver la selección actual.

+
doc = app.active
+selection = doc.selection
+app.debug(selection)
+
+

Cuidado, la selección actual pueden ser muchas cosas diferentes.

+
+ + + + + + +
+ +
+ + +
+ + +
+ + + +
+ +
+
+
+ + + + + + + + + + + + + + + + + + + + diff --git a/doc/public/es/documents/properties/index.xml b/doc/public/es/documents/properties/index.xml new file mode 100644 index 0000000..0404236 --- /dev/null +++ b/doc/public/es/documents/properties/index.xml @@ -0,0 +1,10 @@ + + + + Propiedades on Documentación para EasyMacro + https://doc.cuates.net/easymacro/es/documents/properties/ + Recent content in Propiedades on Documentación para EasyMacro + Hugo -- gohugo.io + en-us + + diff --git a/doc/public/es/index.html b/doc/public/es/index.html index 05b6dbc..8ed5a9e 100644 --- a/doc/public/es/index.html +++ b/doc/public/es/index.html @@ -12,22 +12,22 @@ :: Documentación para EasyMacro - - - - - - - - - - + + + + + + + + + + - + - + - +