window.bringToFront

Syntax window.bringToFront (title)
Params title is the name of a window that is open.
Action Brings the window to the front of the display. If no window with the title is open, this verb does nothing.
Returns True if the window was open and brought to the front, otherwise false.
Examples Open the examples table and the sub-table funStuff. Place the funStuff window atop the examples window and then type and execute:
window.bringToFront (@examples) // address is coerced to full Object Database path


   » true

In the following example, we use a string for the title. Type and execute:
window.bringToFront ("examples.funStuff")


   » true

Close the funStuff window. Type and execute:
window.bringToFront (@examples.funStuff)


   » false

The window is not open, so this verb cannot bring it to the front.

Be sure that the examples and examples.funStuff windows are closed. Now type and execute:
window.open (@examples.funStuff);

window.open (@examples);

window.bringToFront (@examples.funStuff)


   » true
Errors Attempting to bring to the front a window that is not open returns false but does not produce an error message.
Notes The full path name of the object in the database is also the title of the window in which it is displayed.
See Also window.open

window.sendToBack

Discuss