{"id":2650,"date":"2019-03-25T17:40:34","date_gmt":"2019-03-25T20:40:34","guid":{"rendered":"http:\/\/xexeu.elipse.com.br\/pt\/kb43080-creating-back-and-next-buttons-to-navigate-between-screens\/"},"modified":"2021-08-26T13:24:07","modified_gmt":"2021-08-26T16:24:07","slug":"kb43080-creating-back-and-next-buttons-to-navigate-between-screens","status":"publish","type":"post","link":"https:\/\/kb.elipse.com.br\/en\/kb43080-creating-back-and-next-buttons-to-navigate-between-screens\/","title":{"rendered":"KB-43080: Creating Back and Next buttons to navigate Elipse E3 screens."},"content":{"rendered":"
\n

Question:<\/span><\/h2>\n

How can I add Back <\/span>and Next <\/span>buttons to the Elipse E3 project, so that they can operate similarly to the web browsers buttons of the same name?<\/p>\n

Solution:<\/span><\/h2>\n

Starting with Elipse E3 version<\/strong> 5.5<\/strong> <\/a>(and higher), there are three new methods in the FrameSet to help develop Back<\/strong> and Next<\/strong> buttons: NavigateBack<\/strong>, NavigateForward<\/strong>, and NavigateHistReset<\/strong>. There are also three new properties in this object: NavigateHistCount<\/strong>, NavigateCanGoBack<\/strong>, and NavigateCanGoForward<\/strong>. Therefore, with these new methods and properties, users can now navigate\/browse between screens via the history of screens open in a FrameSet.<\/p>\n

Versions previous to 5.5<\/h3>\n

First of all, let’s understand how these buttons (Back<\/strong> and Next<\/strong>) work in a web browser and how they can apply to Elipse E3. Whenever you visit different websites, the browser stores the browsing history of these visits. If you click the Back <\/span>button, it returns to the most recent record of the history; likewise, if you click Back <\/span>again, it will return to the previous record.<\/p>\n

Every time you click Back<\/span>, it will automatically enable the Next <\/span>button. When you change sites, either by typing the address at the top or by clicking a link, the Next <\/span>button is disabled, allowing you to just go back to previous addresses.<\/p>\n

How to implement these buttons at E3?<\/h3>\n<\/div>\n
    \n
  1. You can do so with auxiliary tags, in Viewer object, which will take part in the logic.<\/li>\n
  2. It’s also possible to do so via Open Screen<\/span> buttons<\/li>\n
  3. Or you can use Next <\/span>and Back <\/span>buttons<\/li>\n<\/ol>\n
    \n

    What you’re aiming at in this case is to store the screens history in a matrix, i.e., to have their indices correspond to the names of the open screens. The Next <\/span>and Back <\/span>buttons will access these indexes, therefore incrementing or decrementing them as needed, and open the screen corresponding to the chosen index.<\/p>\n

    The buttons that open a screen directly will update these auxiliary tags:<\/p>\n<\/div>\n