Documentation

Current Point — The current location of the mouse relative to the lower left corner of the grid area in the Layout Editor.

Position — The Position property of the selected component is a vector: [distance from left, distance from bottom, width, height], where distances are relative to the parent figure, panel, or button group.

The Position values updates as you move and resize components. The first two elements in the vector change as you move the component. The last two elements of the vector change as the height and width of the component change.

When no components are selected, the Position value displays the location and size of the figure.

Specify the push button label by setting the String property to the desired label, in this case, Button 1.

To display the & character in a label, use two & characters. The words remove, default, and factory (case sensitive) are reserved. To use one of these as a label, prepend a backslash character (\). For example, \remove yields remove.

The push button accommodates only a single line of text. If you specify more than one line, only the first line is shown. If you create a push button that is too narrow to accommodate the specified String property value, MATLAB truncates the value with an ellipsis.

If you want to set the position or size of the component to an exact value, then modify its Position property.

To add an image to a push button, assign the button's CData property as an m-by-n-by-3 array of RGB values that defines a truecolor image. You must do this programmatically in the opening function of the code file. For example, the array img defines a 16-by-64-by-3 truecolor image using random values between 0 and 1 (generated by rand).

img = rand(16,64,3);
set(handles.pushbutton1,'CData',img);

where pushbutton1 is the push button's Tag property.

See ind2rgb for information on converting a matrix X and corresponding colormap, i.e., an (X, MAP) image, to RGB (truecolor) format.

Specify the range of the slider by setting its Min property to the minimum value of the slider and its Max property to the maximum value. The Min property must be less than Max.

Specify the value indicated by the slider when it is created by setting the Value property to the appropriate number. This number must be less than or equal to Max and greater than or equal to Min. If you specify Value outside the specified range, the slider is not displayed.

The slider Value changes by a small amount when a user clicks the arrow button, and changes by a larger amount when the user clicks the trough (also called the channel). Control how the slider responds to these actions by setting the SliderStep property. Specify SliderStep as a two-element vector, [minor_step major_step], where minor_step is less than or equal to major_step. Because specifying very small values can cause unpredictable slider behavior, make both minor_step and major_step greater than 1e-6. Set major_step to the proportion of the range that clicking the trough moves the slider thumb. Setting it to 1 or higher causes the thumb to move to Max or Min when the trough is clicked.

As major_step increases, the thumb grows longer. When major_step is 1, the thumb is half as long as the trough. When major_step is greater than 1, the thumb continues to grow, slowly approaching the full length of the trough. When a slider serves as a scroll bar, you can uses this behavior to indicate how much of the document is currently visible by changing the value of major_step.

If you want to set the location or size of the component to an exact value, then modify its Position property.

The slider component provides no text description or data entry capability. Use a Static Text component to label the slider. Use an Edit Text component to enable a user to input a value to apply to the slider.

On Mac platforms, the height of a horizontal slider is constrained. If the height you set in the position vector exceeds this constraint, the displayed height of the slider is the maximum allowed. The height element of the position vector is not changed.

Specify the radio button label by setting the String property to the desired label, in this case, Indent nested functions.

To display the & character in a label, use two & characters. The words remove, default, and factory (case sensitive) are reserved. To use one of these as a label, prepend a backslash character (\). For example, \remove yields remove.

The radio button accommodates only a single line of text. If you specify more than one line, only the first line is shown. If you create a radio button that is too narrow to accommodate the specified String property value, MATLAB software truncates the value with an ellipsis.

Create the radio button with the button selected by setting its Value property to the value of its Max property (default is 1). Set Value to Min (default is 0) to leave the radio button unselected. Correspondingly, when the user selects the radio button, the software sets Value to Max, and to Min when the user deselects it.

If you want to set the position or size of the component to an exact value, then modify its Position property.

To add an image to a radio button, assign the button's CData property an m-by-n-by-3 array of RGB values that defines a truecolor image. You must do this programmatically in the opening function of the code file. For example, the array img defines a 16-by-24-by-3 truecolor image using random values between 0 and 1 (generated by rand).

img = rand(16,24,3);
set(handles.radiobutton1,'CData',img);

To manage exclusive selection of radio buttons and toggle buttons, put them in a button group. See Button Group for more information.

Specify the check box label by setting the String property to the desired label, in this case, Display file extension.

To display the & character in a label, use two & characters. The words remove, default, and factory (case sensitive) are reserved. To use one of these as a label, prepend a backslash character (\). For example, \remove yields remove.

The check box accommodates only a single line of text. If you specify a component width that is too small to accommodate the specified String property value, MATLAB software truncates the value with an ellipsis.

Create the check box with the box checked by setting the Value property to the value of the Max property (default is 1). Set Value to Min (default is 0) to leave the box unchecked. Correspondingly, when the user clicks the check box, the software sets Value to Max when the user checks the box and to Min when the user clears it.

If you want to set the position or size of the component to an exact value, then modify its Position property.

Specify the text to be displayed when the edit text component is created by setting the String property to the desired value, in this case, Enter your name here.

To display the & character in a label, use two & characters. The words remove, default, and factory (case sensitive) are reserved. To use one of these as a label, prepend a backslash character (\). For example, \remove yields remove.

To enable multiple-line input, specify the Max and Min properties so that their difference is greater than 1. For example, Max = 2, Min = 0. Max default is 1, Min default is 0. MATLAB software wraps the displayed text and adds a scroll bar if necessary. On all platforms, when the user enters a multiline text box via the Tab key, the editing cursor is placed at its previous location and no text highlights.

If Max-Min is less than or equal to 1, the edit text component allows only a single line of input. If you specify a component width that is too small to accommodate the specified text, MATLAB displays only part of that text. The user can use the arrow keys to move the cursor through the text. On all platforms, when the user enters a single-line text box via the Tab key, the entire contents is highlighted and the editing cursor is at the end of the text.

If you want to set the position or size of the component to an exact value, then modify its Position property.

You specify the text font to display in the edit box by typing the name of a font residing on your system into the FontName entry in the Property Inspector. On Microsoft^® Windows^® platforms, the default is MS Sans Serif; on Macintosh and UNIX^® platforms, the default is Helvetica.

Specify the text that appears in the component by setting the component String property to the desired text, in this case Select a data set.

To display the & character in a list item, use two & characters. The words remove, default, and factory (case sensitive) are reserved. To use one of these as a label, prepend a backslash character (\). For example, \remove yields remove.

If your component is not wide enough to accommodate the specified value, MATLAB wraps the displayed text.

If you want to set the position or size of the component to an exact value, then modify its Position property.

You can specify a text font, including its FontName, FontWeight, FontAngle, FontSize, and FontUnits properties. For details, see the previous topic, Edit Text.

Specify the pop-up menu items to be displayed by setting the String property to the desired items. Click the

button to the right of the property name to open the Property Inspector editor.

To display the & character in a menu item, use two & characters. The words remove, default, and factory (case sensitive) are reserved. To use one of these as a label, prepend a backslash character (\). For example, \remove yields remove.

If the width of the component is too small to accommodate one or more of the menu items, MATLAB truncates those items with an ellipsis.

To select an item when the component is created, set Value to a scalar that indicates the index of the selected list item, where 1 corresponds to the first item in the list. If you set Value to 2, the menu looks like this when it is created:

If you want to set the position and size of the component to exact values, then modify its Position property. The height of a pop-up menu is determined by the font size. The height you set in the position vector is ignored.

The pop-up menu does not provide for a label. Use a Static Text component to label the pop-up menu.

Specify the list of items to be displayed by setting the String property to the desired list. Use the Property Inspector editor to enter the list. You can open the editor by clicking the button to the right of the property name.

To display the & character in a label, use two & characters. The words remove, default, and factory (case sensitive) are reserved. To use one of these as a label, prepend a backslash character (\). For example, \remove yields remove.

If the width of the component is too small to accommodate one or more of the specified list items, MATLAB software truncates those items with an ellipsis.

Specify selection by using the Value property together with the Max and Min properties.

If the list box is not large enough to display all list entries, you can set the ListBoxTop property to the index of the item you want to appear at the top when the component is created.

If you want to set the position or size of the component to an exact value, then modify its Position property.

The list box does not provide for a label. Use a Static Text component to label the list box.

Specify the toggle button label by setting its String property to the desired label, in this case, Left/Right Tile.

To display the & character in a label, use two & characters. The words remove, default, and factory (case sensitive) are reserved. To use one of these as a label, prepend a backslash character (\). For example, \remove yields remove.

The toggle button accommodates only a single line of text. If you specify more than one line, only the first line is shown. If you create a toggle button that is too narrow to accommodate the specified String value, MATLAB truncates the text with an ellipsis.

Create the toggle button with the button selected (depressed) by setting its Value property to the value of its Max property (default is 1). Set Value to Min (default is 0) to leave the toggle button unselected (raised). Correspondingly, when the user selects the toggle button, MATLAB software sets Value to Max, and to Min when the user deselects it. The following figure shows the toggle button in the depressed position.

If you want to set the position or size of the component to an exact value, then modify its Position property.

To add an image to a toggle button, assign the button's CData property an m-by-n-by-3 array of RGB values that defines a truecolor image. You must do this programmatically in the opening function of the code file. For example, the array img defines a 16-by-64-by-3 truecolor image using random values between 0 and 1 (generated by rand).

img = rand(16,64,3);
set(handles.togglebutton1,'CData',img);

where togglebutton1 is the toggle button's Tag property.

To manage exclusive selection of radio buttons and toggle buttons, put them in a button group. See Button Group for more information.

Specify the panel title by setting the Title property to the desired value, in this case My Panel.

To display the & character in the title, use two & characters. The words remove, default, and factory (case sensitive) are reserved. To use one of these as a label, prepend a backslash character (\). For example, \remove yields remove.

Specify the location of the panel title by selecting one of the available TitlePosition property values from the pop-up menu, in this case lefttop. You can position the title at the left, middle, or right of the top or bottom of the panel.

If you want to set the position or size of the panel to an exact value, then modify its Position property.

Specify the button group title by setting the Title property to the desired value, in this case My Button Group.

To display the & character in the title, use two & characters. The words remove, default, and factory (case sensitive) are reserved. To use one of these as a label, prepend a backslash characters (\). For example, \remove yields remove.

Specify the location of the button group title by selecting one of the available TitlePosition property values from the pop-up menu, in this case lefttop. You can position the title at the left, middle, or right of the top or bottom of the button group.

If you want to set the position or size of the button group to an exact value, then modify its Position property.

Allow for tick marks to be placed outside the box that appears in the Layout Editor. The axes above looks like this in the layout editor; placement allows space at the left and bottom of the axes for tick marks. Functions that draw in the axes update the tick marks appropriately.

Use the title, xlabel, ylabel, zlabel, and text functions in the code file to label an axes component. For example,

xlh = (axes_handle,'Years')

labels the X-axis as Years. The handle of the X-axis label is xlh.

The words remove, default, and factory (case sensitive) are reserved. To use one of these in component text, prepend a backslash character (\). For example, \remove yields remove.

If you want to set the position or size of the axes to an exact value, then modify its Position property.

If you customize axes properties, some of them (or example, callbacks, font characteristics, and axis limits and ticks) may get reset to default every time you draw a graph into the axes when the NextPlot property has its default value of 'replace'. To keep customized properties as you want them, set NextPlot to 'replacechildren' in the Property Inspector, as shown here.