controlpanel Command

controlpanel 
[-o path [-a] [-f] [-r] [-p] [-m x y] [-w x y] [-y xres yres] [-t title]] 
[-q] [-b path] [-k path] [-K path] [-x path] [-c path] [-C path] 
[-s path name value [-p] [-f]]

This command is used with control panel components.

Options

-q	Quiet mode. Do not report errors.
-k path	Set the keyboard focus to this panel.
-K path	Set the keyboard focus to this panel and selects all text if it's a field.
-b path	Set the hierarchical focus to this panel, which sets the Panel Value focusselect to 1. When you click outside the panel, focusselect will return to 0. Use this flag after the panel is already open.
-x path	Move the mouse to the middle of this panel and make sure it has hierarchical focus.
-o path	Open the panels specified by path.
	-r	Halt execution of the current script until the window is closed. Use this option when creating menu type panels.
	-a	Open always on top.
	-p	Resize proportionally.
	-f	Open with no borders and no title bar.
	-m x y	Open the window at the current mouse location, offset by x and y.
	-w x y	Open the window at x,y.
	-y xres yres	Specify the window resolution.
	-t title	Specify a window title.
-c path	Close the panels specified by path.
-C path	Close the topmost panel specified by path.
-s path name value	Set a Panel Value.
	-p	Pulse the value (use with -s)
		-f	Force the value of the control panel to change even if its enable state is set to 0.

Examples

Open a control panel with no borders and no title bar:

controlpanel -o /button1 -f

Open a control panel at the current mouse location, offset by x=10 and y=20:

controlpanel -m 10 20 -o /button1

Close the panel /button1:

controlpanel -c /button1

Close the topmost panel from /button1:

controlpanel -C /button1

Pulse the state panel value of /button1:

controlpanel -p -s /button1 state 1

See Also

click, view