topStack

Typefunction
DictionaryLCS
LibraryLiveCode Script
Syntax
the topStack
topStack()
Synonymstopwindow,currentwindow
Summary

Returns the long name of the topmost stack.

Introduced1.0
OSmac, windows, linux, ios, android
Platformsdesktop, server, mobile
Example
the topStack
set the defaultStack to the topStack
Values
NameTypeDescription
return

The topStack returns the long name of a stack.

RelatedProperty: mode, name
Glossary: current stack, editable window, return, palette
Command: palette
Object: stack
Function: mainStacks
Control Structure: function
Description

Use the topStack function to find out which stack is in the current stack.

In most applications, the active window holds the current document, and menu commands operate on the active window. In LiveCode, because of the ability to open stacks in various modes, this is not necessarily the case.

Each open window has a mode associated with it. The topStack is the frontmost stack with the lowest mode.

For example, an editable window has a mode of 1, and a palette has a mode of 4. If several palettes and editable windows are open, the topStack is the frontmost editable stack, although palettes may be in front of it. If all the editable windows are then closed, the frontmost palette becomes the topStack, since there is now no window with a lower mode.

Tagswindowing