select-recent-tab

Arguments: (tab-control tab-control) index

Selects a tab of tab-control (which must be a tab-control) that is in the stack of all tabs that have been selected. This method would typically be called by keyboard shortcuts for selecting recently-viewed tabs (as seen in some IDE dialogs when right-clicking a tab).

An index of 1 selects the tab that was selected most recently before the currently selected tab was selected, an index of 2 selects the tab that was selected just before that one, and so on. If index is greater than the number of tabs that have been selected so far, then nothing is done. An index of zero would select the currently selected tab, which is not useful.

Each tab may appear in the stack only once, reflecting its most recent selection; so if the user selected tabs A, B, C, B, and D in that order, then the stack would contain (D B C A), and so an index of 2 would select C while 3 would select A. When a tab is deleted, it is removed from the stack.

Copyright (c) 1998-2016, Franz Inc. Oakland, CA., USA. All rights reserved.
This page was not revised from the 8.1 page.
Created 2010.1.21.