attach_imageview_by

attach_imageview_by_name

The attach_imageview_by_name function attaches an image window from the Mira desktop to a CImageView object by matching the image window's title. The new CImageView object is returned. This is a global function that is not a member of the CImageView class.

This function is useful for directly selecting an image window from the Mira desktop without pausing the script to select it from a list. For example, the script might attach an image window you created with a known title or a window that was created in a previous script. The window title can be saved and retrieved using a text file or the Windows Registry using the CRegistry class.

Syntax

CImageView = attach_imageview_by_name( sTitle )

sTitle is the target window title.

On success, a new CImageView object is returned.

On failure, nil is returned.

Example

The following script attaches an image window that was created by a previous script. The window title (name) was previously saved to the Windows Registry but the window remains on the Mira desktop. The Image Window was saved under the key "image window title". A new CImageView object is returned if the image window exists.

R = new_registry("image stuff")	-- open the registry key "image stuff"
sTitle = R.GetStr("image window title", "No Title")	-- get name of saved window, default: "No Title"
V = attach_imageview_by_name( sTitle )	-- attach the named image window
if V ~= nil then	-- if window was attached...
Printf("Window named '%s': %p\n", sTitle, V )	-- print a success message
else
Printf("Window not found\n")
end

Syntax

Example

Related Topics