Procedimientos. Textos.

Macros de deslazamiento. (1)

Como complemento a la información sobre el desplazamiento del cursos por el documento, y aunque su utilidad práctica puede ser limitada, me ha parecido necesario recoger en esta entrada, y de forma sintética, macros de desplazamiento que afectan a la página, la línea y la letra. Estos son:

Los desplazamiento relacionados con el elemento mínimo (la letra) nos permiten avanzar o retroceder de posición respecto a este elemento. El código común a ambos movimientos se concreta como sigue:

dim args1(1) as new com.sun.star.beans.PropertyValue

args1(0).Name = "Count"

args1(0).Value = 1

args1(1).Name = "Select"

args1(1).Value = false

• Para [avanzar de posición] respecto a una letra podemos utilizar esta orden complementando a la estructura anterior:

dispatcher.executeDispatch(document, ".uno:GoRight", "", 0, args1())

• Y para retroceder a la anterior esta otra:

dispatcher.executeDispatch(document, ".uno:GoLeft", "", 0, args1())

El movimiento respecto a una palabra se realiza mediante dos instrucciones similares:

• Avance

dispatcher.executeDispatch(document, ".uno:GoToNextWord", "", 0, Array())

• Retroceso

dispatcher.executeDispatch(document, ".uno:GoToPrevWord", "", 0, Array())

Aunque el avance respecto a la línea ya la empleamos, resumo ahora el código necesario. Primero el común, que, como ves, es el mismo que para el desplazamiento respecto a la letra...

dim args1(1) as new com.sun.star.beans.PropertyValue
args1(0).Name = "Count"
args1(0).Value = 1
args1(1).Name = "Select"
args1(1).Value = false

... que se complementa con esta orden para avanzar hacia la [línea siguiente]

dispatcher.executeDispatch(document, ".uno:GoDown", "", 0, args1())

...y hacia la  [línea anterior]

dispatcher.executeDispatch(document, ".uno:GoUp", "", 0, args1())

Finalmente, el desplazamiento página a página se resuelve con estas dos instrucciones:

• [Avanzar] a la página siguiente:

dispatcher.executeDispatch(document, ".uno:PageDown", "", 0, Array())

• [Retroceder] a la página anterior:

dispatcher.executeDispatch(document, ".uno:PageUp", "", 0, Array()) 

NOTA

(1) Entrada actualiza a partir de una entrada publicada el 13 de octubre de 2023, titulada Writer. Desplazamiento por el documento.