Commands

This chapter is only about commands that you can create and add to a stack yourself, not about all the commands that MoStacks offers itself already.

Commands in this sense are controls that you add to a background like fields and controls of other types, that then appear on cards of that background and can be issued there. On the one hand, Command is the most "abstract" field/control type and it may seem strange at first to treat them as such, but on the other hand backgrounds cannot contain anything else than fields and controls, so commands must fit in there somehow in order to avoid an exception (which maybe would make them look less strange, but would increase the complexity of the whole system).

Commands can be visible in two ways, and thus also issued in two ways: as a button that is placed "onto" the card like all other fields and controls, that you can tap, and as an entry in the special Cmds menu, where you can select the command like any other menu entry. There are two control flags Show in menu? and Show as button in card view? to configure one or the other or both ways of command display in the Edit Controls window.

Of course a command has only value if something happens when you issue it. There are two ways to specify what should happen: Configuring the command as a standard command, and assigning a macro.

This is the list of available standard commands:

• First Card: Switch to the first card of the stack.
• Previous Card: Switch to the card before the current card.
• Next Card: Switch to the card after the current card.
• Last Card: Switch to the last card of the stack.
• Back in History: Go back one step in the history of cards.
• Forward in History: Go forward one step in the history of cards.
• Go to Card by Name: Switch to the card whose name is given as an additional parameter.
• Show Card List: Leave the card view and switch to the list view.
• Select Card: Open the card selection dialog to specify a card to switch to.

(Note that almost all of these standard command directly correspond with the little "buttons" in the navigation bar, and if you like, you can build something like that bar out of buttons.)

You assign a macro to a command control by selecting the control in the Edit Fields and Controls window, open the Edit Script window by clicking the Script... button, and then write a on select script. See also the chapter Scripting: Messages.

You can configure a standard command and assign a macro at the same time, and both will be executed if you issue the command, but this probably makes sense only rarely.