uipanel
Creates a frame for interactive graphical control objects in a figure.
Syntax
h = uipanel()
h = uipanel(property, value, ...)
h = uipanel(parent, property, value, ...)
Inputs
- parent
- Handle of a container object, which could be a figure, frame, uipanel, or uibuttongroup.
- property, value
-
- 'aspectratio'
- Specifies if the aspect ratio for 'backgroundimage' needs to be ignored ('off') or kept ('on'). Default value is 'off', and the 'backgroundimage' is resized to the dimensions of h.
- 'backgroundcolor'
- Specifies the background color. Valid values are 'transparent' or a real vector specifying RGB values in the range 0-255 or 0-1.
- 'backgroundimage'
- Specifies the background image; requires a path to a valid image file.
- 'bordertype'
- Specifies the border type. Valid options are 'beveledin' | 'beveledout' | 'etchedin' (default) | 'etchedout' | 'line' | 'none'
- 'borderwidth'
- Specifies the width of the border. Default value is 1.
- 'fontangle'
- Specifies the angle of the displayed font. Valid values are 'regular'(default) and 'italic'.
- 'fontname'
- Specifies the name of the displayed font.
- 'fontsize'
- Specifies the size of the displayed font.
- 'fontweight'
- Specifies the weight of the displayed font. Valid values are 'normal'(default) and 'bold'.
- 'parent'
- Specifies the parent.
- 'position'
- Position and size of h. Value is specified as a vector of form: [left top width height]. If 'units' has a value of 'normalized', values must be between 0 to 1.
- 'string'
- Text to be displayed on h.
- 'tag'
- User-defined string to tag graphical control objects.
- 'units'
- Specifies units of measurement. Valid values are 'pixels'(default) and 'normalized'. Value 'pixel' indicates that h has a fixed size and position specified by 'position'. Value 'normalized' indicates that h will be resized if parent is resized.
- 'userdata'
- User-defined numerical data.
- 'visible'
- Specifies if h is visible. Valid values are 'on'(default) and 'off'.
Outputs
- h
- Handle of the uipanel.
Example
f = gcf;
panel = uipanel(f, 'units', 'normalized', 'position', [0, 0, 0.99, 0.3], 'backgroundimage', 'image1.jpg');