w

window:activate

Syntax: window:activate(title])

Activates a sub-window, identified by its window title. If the sub-window is minimized it will be restored. Only available if in MDI and Tab mode. This command is internally used by the Window menu.

Parameters

title:the title of the sub-window that should be activated

window:cascade

Syntax: window:cascade()

Cascades all sub-windows when in MDI mode. All sub-windows that are currently minimized stay minimized, they will not be restored.

window:click

Syntax: window:click( class, x, y )

Sends a mouse click event to window, identified by its class name. The event will only be sent to the first window that has the given class name, therefore you should make sure that you have only one instance of the given window when this command gets executed.

Parameters

class:name of the window class
x:x position, relative to the left border of the window (in pixels)
y:y position, relative to the top border of the window (in pixels)

window:close

Syntax: window:close( class )

Closes a window, identified by its class name. Only the first window that has the given class name will be closed, therefore you should make sure that you have only one instance of the given window when this command gets executed.

Parameters

class:name of the window class

window:minimize

Syntax: window:minimize

Minimizes the currently active sub-window when in MDI mode or the current toplevel window when in SDI or Tab mode.

window:mousemove

Syntax: window:resize( class, x, y )

Sends a mouse move event to window, identified by its class name. The event will only be sent to the first window that has the given class name, therefore you should make sure that you have only one instance of the given window when this command gets executed.

Parameters

class:name of the window class
x:x position, relative to the left border of the window (in pixels)
y:y position, relative to the top border of the window (in pixels)

window:next_sub

Syntax: window:next_sub()

Activates the next sub-window when in MDI or Tab mode. If the next sub-window is minimized it will be restored.

window:prev_sub

Syntax: window:prev_sub()

Activates the previous sub-window when in MDI or Tab mode. If the previous sub-window is minimized it will be restored.

window:resize

Syntax: window:resize( class, width, height )

Changes the size of a window, identified by its class name to a new width and height. The change will only be applied to the first window that has the given class name, therefore you should make sure that you have only one instance of the given window when this command gets executed.

Parameters

class:name of the window class
width:new width of the window (in pixels)
height:new height of the window (in pixels)

window:screenshot

Syntax: window:screenshot( class, filename )

Takes a screenshot of a window, identified by its class and saves it to a file. The screenshot will be taken from the first window that has the given class name, therefore you should make sure that you have only one instance of the given window when this command gets executed. Currently the format of the file is hardcoded and has to be *.png.

Parameters

class:name of the window class
filename:name of the file to save the screenshot, must have the extension *.png

window:sendkey

Syntax: window:sendkey( class, key code )

Sends a key press and release event to a window, identified by its class name. The key will only be sent to the first window that has the given class name, therefore you should make sure that you have only one instance of the given window when this command gets executed.

Parameters

class:name of the window class
key code:the key code that should be sent, using the same syntax as used for setting up menus

See also

Description of the parameter hotkey of the menu() command.

window:tile

Syntax: window:tile()

Tiles all sub-windows when in MDI mode, using some scheme of Plasma™. All sub-windows that are currently minimized stay minimized, they will not be restored.

window:tile_vertical

Syntax: window:tile_vertical()

Tiles all sub-windows vertically when in MDI mode. All windows that are currently minimized stay minimized, they will not be restored.