2019-07-21

58: The UNO Dispatch Command Specifications of '.uno:GoRightToEndOfData'

<The previous article in this series | The table of contents of this series | The next article in this series>


Summary


The URL, the description, the arguments, the result information, and the related information (which can be gotten from the command execution) of the UNO dispatch command, '.uno:GoRightToEndOfData', are described.

Topics


About: UNO (Universal Network Objects)
About: LibreOffice
About: Apache OpenOffice

The table of contents of this article


Starting Context


  • The reader has knowledge of what 'UNO dispatch command' is and how to call one (if the URL and the arguments of the command are clear).

Target Context


  • The reader will know the specifications of the UNO dispatch command.

Introduction


'Orientation' is meant for the passersby who don't stand in 'Starting Context' and/or aren't enthusiastic about 'Target Context'. It doesn't contain any new technical information and can be skipped by anyone who doesn't need any orientation.



Orientation


There are some articles that explain how to execute any UNO dispatch commands and get the whole available information from the execution, in Java, in C++, in C#, in Python, and in LibreOffice or Apache OpenOffice Basic.

There are the list for the application foundations and the list for Calc of the UNO dispatch commands listed so far in this series.


Main Body


1: The Specifications


URL: .uno:GoRightToEndOfData

Description: First, let us assume that no cell is selected or the current cell is the sole selected cell; otherwise, the behavior is unfathomable for the author. . . . Second, let us define (for this article) 'next destination cell' as this: if the current cell is empty or is the rightmost cell of a consecutive non-empty cells in the row, the cell of the first non-empty cell to the right of the current cell, or the rightmost cell if there is no such a cell; otherwise, the rightmost cell of the row's consecutive non-empty cells to which the current cell belongs. . . . Third, let us define (for this article) 'n-th next destination cell' as a cell that is reached after the current cell is move to the next destination cell n times. . . . There are two modes, the moving-the-current-cell mode and the changing-the-cells-selection mode. In the moving-the-current-cell mode, this command moves the current cell to the specified-number-of-times-th next destination cell, discarding the cell selection. In the changing-the-cells-selection mode, this command changes the cells selection as though the right arrow key is pressed with the 'Shift' key pressed until the selection reaches the specified-number-of-times-th next destination cell, without moving the current cell.

Arguments (the types are UNO datum types):

NameTypeValue
ByshortThe number of times of the to-the-next-destination-cell movement, which can be plus, zero, or minus
SelbooleanWhether the mode is the changing-the-cells-selection mode or not

The related information (the value of com.sun.star.frame.FeatureStateEvent.State) (the types are UNO datum types):

Nothing.

The result information (the value of com.sun.star.frame.DispatchResultEvent.Result) (the type is a UNO datum type):

TypeValue
N/Avoid

<The previous article in this series | The table of contents of this series | The next article in this series>