Please note that the recommended version of Scilab is 2025.0.0. This page might be outdated.
See the recommended documentation of this function
Gridbag Constraints Properties
Description of the gridbag constraints set of properties.
Syntax
constraints = createConstraints("gridbag") constraints = createConstraints("gridbag", grid) constraints = createConstraints("gridbag", grid, weight) constraints = createConstraints("gridbag", grid, weight, fill) constraints = createConstraints("gridbag", grid, weight, fill, anchor) constraints = createConstraints("gridbag", grid, weight, fill, anchor, padding) constraints = createConstraints("gridbag", grid, weight, fill, anchor, padding, preferredsize)
Arguments
- grid
[pos_x, pos_y, width, height]a 1-by-4 matrix of double, [0, 0, 0, 0] by default.pos_xandpos_xare the coordinates of the element on a virtual grid.widthandheightare the width and height of the element on the virtual grid.- weight
[weight_x, weight_y]a 1-by-2 matrix of doubles, [0, 0] by default.The weights applied for the resize on either axes.
A larger value means the element will get more space during resize.
- fill
A string
{"none"} | "horizontal" | "vertical" | "both"
Indicates how to fill the available space during resize on either direction (or both).
- anchor
A string
{"center"} | "upper" | "upper_right" | "right" | "lower_right" | "lower" | "lower_left" | "left" | "upper_left"
Tells where to anchor the element when it is smaller than the area it is nested in.
- padding
[pad_x, pad_y]a 1-by-2 matrix of doubles, [0 0] by defaultPadding between this element and elements around it.
- preferred_size
[p_size_x, p_size_y]a 1-by-2 matrix of doubles, [-1 -1] by defaultPreferred size in pixel when not constrained, used to avoid changing the size when resizing the nesting frame.
- constraints
The created constraints.
Examples
//Creates the figure with a gridbag layout f = figure( ... "dockable" , "off",... "infobar_visible" , "off",... "toolbar" , "none",... "menubar_visible" , "off",... "menubar" , "none",... "default_axes" , "off",... "layout" , "gridbag",... "visible" , "on"); redf_grid = [1, 1, 2, 1]; //Red frame is placed at 1x1 and is a 2x1 rectangle greenf_grid = [3, 1, 1, 2]; //Green frame is at 3x1 and is a 1x2 rectangle bluef_grid = [1, 2, 1, 1]; //Blue frame is at 2x1 and is a 1x1 rectangle yelf_grid = [1, 3, 2, 2]; //Yellow frame is at 1x3 and is a 2x2 rectangle magf_grid = [3, 4, 1, 1]; //Magenta frame is at 3x4 and is a 1x1 rectangle cyanf_grid = [2, 2, 1, 1]; //Cyan is at 2x2 and is a 1x1 rectangle whitf_grid = [3, 3, 1, 1]; //White is at 3x3 and is a 1x1 rectangle c = createConstraints("gridbag",[1, 1, 1, 1], [1, 1], "both", "center", [0, 0], [50, 50]); c.grid = redf_grid; u_grid1 = uicontrol(f , ... "style" , "frame" , ... "backgroundcolor" , [1 0 0] , ... "constraints" , c); sleep(500); c.grid = greenf_grid; c.weight = [0.1,1]; //Last column will fill horizontal space 10 times less than other columns u_grid2 = uicontrol(f , ... "style" , "frame" , ... "backgroundcolor" , [0 1 0] , ... "constraints" , c); sleep(500); c.grid = bluef_grid; c.weight = [1,1]; c.fill = "none" //This will force the blue square to be at the preferred size u_grid3 = uicontrol(f , ... "style" , "frame" , ... "backgroundcolor" , [0 0 1] , ... "constraints" , c); sleep(500); c.grid = cyanf_grid; c.fill = "vertical" // this will fill the empty space with cyan vertically c.anchor = "right" //this will position the cyan stripe on the right c.padding = [100,0] //this will extend the cyan stripe horizontally up to 100 pixel if space is available u_grid1 = uicontrol(f , ... "style" , "frame" , ... "backgroundcolor" , [0 1 1] , ... "constraints" , c); sleep(500); c.grid = yelf_grid; c.fill = "both"; c.anchor ="center"; c.padding = [0,0]; u_grid4 = uicontrol(f , ... "style" , "frame" , ... "backgroundcolor" , [1 1 0] , ... "constraints" , c); sleep(500); c.grid = whitf_grid; c.weight = [0.1,1] u_grid1 = uicontrol(f , ... "style" , "frame" , ... "backgroundcolor" , [1 1 1] , ... "constraints" , c); sleep(500); c.grid = magf_grid; c.weight = [0.1,1] u_grid5 = uicontrol(f , ... "style" , "frame" , ... "backgroundcolor" , [1 0 1] , ... "constraints" , c);
Description
This functions creates the gridbag constraints to set the uicontrols constraints attribute.
See also
- layout — Description of the different layouts and constraints for uicontrols and figures.
- uicontrol — create a Graphic User Interface object
- uicontrol_properties — Description of the uicontrol properties.
History
| Version | Description |
| 5.5.0 | Function createBorder introduced. |
| Report an issue | ||
| << Grid Layout Options Properties | Layouts | Gridbag Layout Options Properties >> |