uicontrol

Syntax

h = uicontrol()

h = uicontrol(property, value, ...)

h = uicontrol(parent, property, value, ...)

Inputs

parent

Handle of a container object, which could be a figure, frame, uipanel, or uibuttongroup.

Type: double | integer

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. Valid only for style types pushbutton, togglebutton and frame.

Type: string

'backgroundcolor'

Specifies the background color. Valid values are 'transparent' or a real vector specifying RGB values in the range 0-255 or 0-1.

Type: string | vector

'callback'

Callback function that is triggered when interacting with h. If value is a function handle, it must be a function that takes at least two arguments. The first argument is the handle of the uicontrol. The second argument is the event data to the uicontrol. OML passes empty data to the second argument if there is no data to the uicontrol. If value is a string, it must represent a function handle or a function name. If value is a cell, it must contain the function name/function handle in the first cell element and parameters to pass to callback function in the additional elements.

Type: cell | functionhandle | string

'createfcn'

Function that is executed when h is created. If value is a function handle, it must be a function that takes at least two arguments. The first argument is the handle, h. The second argument is ignored. If value is a string, it must represent a function handle or a function name. If value is a cell, it must contain the function name/function handle in the first cell element and parameters to pass to callback function in the additional elements. The createfcn cannot be interrupted using the interruptible property.

Type: cell | functionhandle | string

'deletefcn'

Function that is executed when h is deleted. If value is a function handle, it must be a function that takes at least two arguments. The first argument is the handle of the uicontrol. The second argument is ignored. If value is a string, it must represent a function handle or a function name. If value is a cell, it must contain the function name/function handle in the first cell element and parameters to pass to callback function in the additional elements. After it is being executed, deletefcn cannot be interrupted using the interruptible property.

Type: cell | functionhandle | string

'enable'

Specifies if h is enabled. Valid values are 'on'(default) and 'off'.

Type: string

'fontangle'

Specifies the angle of the displayed font. Valid values are 'regular'(default) and 'italic'.

Type: string

'fontname'

Specifies the name of the displayed font.

Type: string

'fontsize'

Specifies the size of the displayed font.

Type: scalar

'fontunits'

Determines if fontsize property is absolute or relative based on fontsize of the parent of handle. Valid values are 'pixels' (default) or 'normalized'.

Type: string

'fontweight'

Specifies the weight of the displayed font. Valid values are 'normal'(default) and 'bold'.

Type: string

'foregroundcolor'

Specifies the foreground color. Valid values are 'transparent' or a real vector specifying RGB values in the range 0-255 or 0-1.

Type: string | vector

'horizontalalignment'

Specifies the horizontal alignment of the text in styles edit, text and textbox. Valid values are left(default), right, center and justify.

Type: string

'interruptible'

Specifies if the callback associated with h is interruptible by the user by clicking on the Stop button in the user interface. Valid values are 'off' (default) and 'on'.

Type: string

'keypressfcn'

Function that is triggered when there is a key is pressed on h. If value is a function handle, it must be a function that takes at least two arguments. The first argument is the handle of the uicontrol. The second argument is the event data to the uicontrol, which has details on the key pressed. If value is a string, it must represent a function handle or a function name. If value is a cell, it must contain the function name/function handle in the first cell element and parameters to pass to the function in the additional elements. text and frame styles of uicontrol do not support 'keypressfcn'.

Type: cell | functionhandle | string

'max'

Defines the maximum value of h. By default, it is 1. For the 'listbox' style, set the value to greater than 1 to enable multi-selection.

Type: double | integer

'min'

Defines the minimum value of h. By default, it is 0. For the 'listbox' style, set the value to greater than 1 to enable multi-selection.

Type: double | integer

'orient'

Specifies the orientation of style slider. Valid values are horizontal (default) and vertical.

Type: string

'parent'

Specifies the parent.

Type: scalar.

'position'

Position and size of h. Value is specified as a vector of the form [left top width height]. If 'units' has a value of 'normalized', values must be between 0 to 1.

Type: vector

'sliderstep'

Specifies the value of a single step and a single page of style slider when it is moved. Must be a 2-element real vector.

Type: vector

'string'

Text to be displayed on h.

Type: string | cell

'style'

Property of uicontrol for creating different types of control objects. Valid values for this property are:

'buttongroup'

Creates a group which can be used to manage related radio buttons.

'checkbox'

Creates a checkbox. By default, if there is a string associated with a checkbox, the string has the focus and a checkbox can be toggled using it.

'edit'

Creates a single line text editor.

'textbox'

Creates a multi-line text editor. A key combination of SHIFT + ENTER will result in a new line in the editor. A key press of just ENTER will trigger the callback function.

'frame'

Creates a frame, which can be used as a parent when creating uicontrol objects to group them. This is similar to the uipanel.

'listbox'

Creates a list box. Searches can be executed on the string property using uisearchbox.

'popupmenu'

Creates a popup menu. Searches can be executed on the string property using uisearchbox.

'pushbutton'

Creates a button if no 'style' is specified. A uicontextmenu can be attached to this style, where a context menu is displayed with a right-mouse click.

'radiobutton'

Creates radiobuttons.

'slider'

Creates a slider to select an integral value from a range.

'slidebutton'

Creates a slide button, which can be switched off and on.

'text'

Creates a label.

'togglebutton'

Creates a toggle button. A uicontextmenu can be attached to this style, where a context menu is displayed with a right-mouse click.

'waitbar'

Creates a progress bar.

'tag'

User-defined string to tag graphical control objects.

Type: string

'tickinterval'

Specifies the interval between tickmarks of style slider. Valid values are non-negative integers. 0 is the default value where the ticks will be at a value between sliderstep values.

Type: integer

'tickmarks'

Specifies the position of the tickmarks of style slider. Valid values are 'nomarks' (default), 'above', 'below' or 'both'.

Type: string

'tooltipstring'

Tooltip to display.

Type: string

'tracking'

If tracking is 'on' (default), callback function will be executed as style slider is dragged. Otherwise, the callback function is executed once the user releases the slider. Valid values are 'on' (default) and 'off'.

Type: string

'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.

Type: string

'userdata'

User-defined numerical data.

Type: complex | mtx | scalar

'value'

Current value of h.

Type: double | integer

'verticalalignment'

Specifies the vertical alignment of the text in styles edit and text. Valid values are top, bottom and middle (default).

Type: string

'visible'

Specifies if h is visible. Valid values are 'on' (default) and 'off'.

Type: string

Outputs

h

Handle of the uicontrol.

Examples

Create a push button with a callback function:

close all;
figure('units', 'normalized', 'position', [0.25 0.25 0.5 0.5])
axes('units', 'normalized', 'position', [0.2 0.05 0.8 0.8]);
uicontrol('units', 'normalized', 'position', [0.02 0.05 0.16 0.05], 'string', 'plot', 'callback', @plot_rnd);
				
function plot_rnd(handle, callbackdata)
	plot(rand(1, 30));
	disp(handle);
end

Click the button in the figure:

close all;
classdef callback_demo
    methods
        function cal_method(this, handle, data, varargin)
                display('Button is clicked - class method')
        end

        function init_gui(Self)
            handles.fig = figure('position',[600 400 300 300]);
            handles.ptb = uicontrol(handles.fig,'style','pushbutton','string','Button','units','normalized','position',
            [0.25 0.25 0.5 0.25],'callback', @(src, event)cal_method(Self, src, event));
        end
    end
end

inst = callback_demo;
callback_demo.init_gui();

classdef callback_demo < handle    	
    methods
        function cal_method(self, handle, data, varargin)
            display('Button is clicked - class method')
        end
	
        function init_gui(self)
            handles.fig = figure('position',[600 400 300 300]);
            handles.ptb =uicontrol(handles.fig,'style','pushbutton','string','demo_button','units','norm','position',
            [0.25 0.25 0.5 0.25],'callback', @(src, event)self.cal_method(self, src, event));
        end
    end
end

inst = callback_demo;
callback_demo.init_gui();

Comments

When setting the value of 'style', a short form can be used as long as there is only one match for it. For example, 'pop' can be set for 'popupmenu'.