Skip to main content

ModifyPanel

ModifyPanel [/W=winName ] [cbRGB=(r,g,b[,a]), drawInOrder=d, expand=e, fixedSize=f, frameInset=i, frameStyle=f, noEdit=e ]

The ModifyPanel operation modifies properties of the top or named graph or panel window or subwindow.

Parameters

cbRGB=(r,g,b[,a])Specifies the background color of the entire control panel or the graph's control bar area. r, g, b, and a specify the the color and optional opacity as RGBA Values.
drawInOrder=dDetermines the drawing order of controls in the control panel.
d=0:Draw tab controls before any other controls (default).
d=1:Draw all controls in the order in which they appear in the recreation macro, which is also the creation order.
The drawInOrder keyword was added in Igor Pro 8.00.
Prior to Igor Pro 8.00 tab controls (see TabControl) were always drawn before all other controls. This prevented placing a tab control inside a groupbox with a colored interior. drawInOrder=1 forces Igor to draw controls in creation order, which is the same as the order in which they appear in a recreation macro.
expand=eSets the expansion factor of the panel. Values of e greater than 1.0 make the panel, its controls, and its subwindows, appear larger than normal. e is a number between 0.25 to 8.0.
Though rarely needed, using the expand keyword, you can set the expansion of panel subwindows independent of the main panel window's expansion.
When you change the expansion of a top-level control panel window, the panel window automatically resizes itself.
The expand keyword was added in Igor Pro 9.00.
See Control Panel Expansion for further discussion.
fixedSize=f
f =0:Panel can be resized (the default).
f =1:Panel cannot be resized by the user adjusting the grow box or frame (nor maximized on Windows), but the window can be minimized (on Windows) and the MoveWindow operation can still change the size.
frameInset= iSpecifies the number of pixels by which to inset the frame of the panel subwindow. Mostly useful for overlaying panels in graphs to give a fake 3D frame a better appearance.
frameStyle= fspecifies the frame style for a panel subwindow. Values for frameStyle are:
f =0:None
f =1:Single
f =2:Indented
f =3:Raised
f =4:Text well
The last three styles are fake 3D and will look good only if the background color of the enclosing space and the panel itself is a light shade of gray.
noEdit= eSets the editability of the panel.
e =0:Editable (default).
e =1:Not editable. For a panel window, the Panel menu item is not present and the ShowTools command is ignored. For a panel subwindow, it cannot be activated by clicking.

Flags

/W= winNameModifies the control panel in the named graph or control panel window or subwindow. When omitted, action will affect the active window or subwindow.
When identifying a subwindow with winName, see Subwindow Syntax for details on forming the window hierarchy.

Details

On Windows, set r, g, and b to 65535 (maximum white) to set the background color of the control panel to track the 3D Objects color in the Appearance Tab of the Display Properties control panel.

See Also

NewPanel, Controls in Graphs