MSM-Workstation
Macros

Go back to the alphabetic list of macros
Go back to the first page of this tutorial

%%KillWin ( WinName )

Kill a window. GUI-only.

WinName A string literal (without quotes) representing the name of a window, or an at-sign followed by the name of a local variable (@name) where the value of that variable is expected to be equal to the name of a window at run-time.

If there is a need to destroy a window created by %%OpenWin or called by %%DoWin and hidden on %%Return or %%Cancel, the macro %%CloseWin should be used instead.

For closing the current window, the macros %%Cancel and %%Return are the most appropriate.

For closing other windows, non-modal ones that were opened using %%OpenWin, or modal ones that used the option Hide when a %%Cancel or %%Return was executed, the macro %%CloseWin is the most appropriate.

The macro %%KillWin should only be used for windows that were created by other software than the MSM ViEW-Builder, e.g. by directly merging structures into ^$Window, or by using the macro %%MergeWin.

Example

%%KillWin(Test)
Kill a window called "Test".

See also

%%MergeCtl, %%KillCtl and %%MergeWin.