find-or-make-pop-up-window

Arguments: name make-function owner

Returns a window that is intended as a modal dialog for an application. If the window has previously been created by calling find-or-make-pop-up-window, it has not been closed, and its owner is the owner being requested here, then the existing window is returned. Otherwise make-function is called to create the window, and that new window is returned.

This function does not call find-application-window (as find-or-make-application-window does) to find an existing window. The only pre-existing window that this function would return is one that was created by a call to find-or-make-pop-up-window in the same process and with the same name and owner arguments.

Name is an arbitrary symbol for identifying the window. No two windows that are made with find-or-make-pop-up-window or find-or-make-application-window should use the same name.

make-function should be the name of a function that takes a single argument, which is owner, and which makes and returns a window whose name is name and whose owner is owner.

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.