按钮标签, specified as a character vector, cell array of character vectors, string scalar, string array, or 1-D categorical array. Specify a character vector or string scalar to label the button with a single line of text. Use a cell array or string array to label the button with multiple lines of text. Each element in the array represents a separate line of text. If you specify this property as a categorical array, MATLAB^®使用数组中的值，而不是完整的类别。

单词包装以适应组件宽度，指定为'离开'或者'on'，或作为数字或逻辑0(false) or1(真的). A value of'离开'相当于false， 和'on'相当于真的。Thus, you can use the value of this property as a logical value. The value is stored as an on/off logical value of typematlab.lang.OnoffSwitchState.。

使用此属性以防止在组件的宽度小于要显示的文本时水平剪裁。

设置WordWrap.property to'on'does not prevent text from getting clipped vertically when the height of the component is too small to display all the lines of text.

图标源或文件，指定为字符向量，字符串标量或者m-经过-n-3-3 TrueColor图像数组。If you specify a file name, it can be an image file name on the MATLAB path or a full path to an image file. If you plan to share an app with others, put the image file on the MATLAB path to facilitate app packaging.

Supported image formats include JPEG, PNG, GIF, SVG, orm-经过-n-3-3 TrueColor图像数组。有关TrueColor图像阵列的更多信息，请参阅Image Types。

例子：'icon.png'指定MATLAB路径上的图标文件。

例子：'c：\ documents \ icon.png'指定图像文件的完整路径。

字体名称, specified as a system supported font name. The default font depends on the specific operating system and locale.

如果指定的字体不可用，则Matlab使用应用程序正在运行的系统上可用的字体之间的最佳匹配。

例子：'arial'

Font size, specified as a positive number. The units of measurement are pixels. The default font size depends on the specific operating system and locale.

例子：14.

字体重量，指定为其中一个值：

Not all fonts have a bold font weight. Therefore, specifying a bold font weight can result in the normal font weight.

Font angle, specified as'normal'或者'italic'。将此属性设置为斜体selects a slanted version of the font, if it is available on the app user’s system.

字体颜色，指定为RGB三联网，十六进制颜色代码或表中列出的选项之一。

RGB三元组和十六进制颜色代码对于指定自定义颜色很有用。

Alternatively, you can specify some common colors by name. This table lists the named color options, the equivalent RGB triplets, and hexadecimal color codes.

以下是RGB三元组和十六进制颜色代码，用于默认颜色MATLAB在许多类型的图中使用。

背景颜色, specified as an RGB triplet, a hexadecimal color code, or one of the color options listed in the table.

RGB三元组和十六进制颜色代码对于指定自定义颜色很有用。

Alternatively, you can specify some common colors by name. This table lists the named color options, the equivalent RGB triplets, and hexadecimal color codes.

以下是RGB三元组和十六进制颜色代码，用于默认颜色MATLAB在许多类型的图中使用。

可见性状态，指定为'on'或者'离开'，或作为数字或逻辑1(真的) or0(false). A value of'on'相当于真的， 和'离开'相当于false。Thus, you can use the value of this property as a logical value. The value is stored as an on/off logical value of typematlab.lang.OnoffSwitchState.。

To make your app start faster, set the可见的property to'离开'对于不需要在启动时显示的所有UI组件。

运营状态，指定为'on'或者'离开'，或作为数字或逻辑1(真的) or0(false). A value of'on'相当于真的， 和'离开'相当于false。Thus, you can use the value of this property as a logical value. The value is stored as an on/off logical value of typematlab.lang.OnoffSwitchState.。

Tooltip, specified as a character vector, cell array of character vectors, string array, or 1-D categorical array. Use this property to display a message when the user hovers the pointer over the component at run time. The tooltip displays even when the component is disabled. To display multiple lines of text, specify a cell array of character vectors or a string array. Each element in the array becomes a separate line of text. If you specify this property as a categorical array, MATLAB uses the values in the array, not the full set of categories.

上下文菜单, specified as a上下文菜单使用的对象UIContextMenu.功能。右键单击组件时，请使用此属性显示上下文菜单。

按钮的位置和大小，指定为表单的向量[左下宽度]。This table describes each element in the vector.

这Position值相对于drawable areaof the parent container. The drawable area is the area inside the borders of the container and does not include the area occupied by decorations such as a menu bar or title.

所有测量均以像素为单位。

按钮的位置和大小, specified as a four element vector of the form[左下宽度]。所有测量均以像素为单位。此属性值与此属性相同Position财产。

此属性是只读的。

按钮的位置和大小，作为表单的四个元素矢量返回[左下宽度]。所有测量均以像素为单位。此属性值与此属性相同Position财产。

Horizontal alignment of the icon and text, specified as'中央','剩下'， 或者'正确的'。这horizontal alignment is relative to the area inside the borders of the button. Setting this property when the text spans the full width of the button has no apparent effect in the UI.

Vertical alignment of the icon and the text, specified as'中央','top'， 或者'底部'。这vertical alignment is relative to the area inside the borders of the button. Setting this property when the text height fills the height of the button has no apparent effect in the UI.

图标的位置相对于按钮文本，指定为'剩下','正确的','top'， 或者'底部'。如果是Text属性是空的,那么the icon uses theHorizontalAlignment和VerticalAlignment属性而不是iconAlignment.财产。

布局选项，指定为aGridLayoutOptions目的。This property specifies options for components that are children of grid layout containers. If the component is not a child of a grid layout container (for example, it is a child of a figure or panel), then this property is empty and has no effect. However, if the component is a child of a grid layout container, you can place the component in the desired row and column of the grid by setting the排和柱子properties on theGridLayoutOptions目的。

例如，此代码将按钮放在其父网格的第三行和第二列中。

g = uigrivlayout（[4 3]）;B = UIBUTTON（G）;B.Layout.Row = 3;b.layout.column = 2;

要使按钮跨越多行或列，请指定排或者柱子属性作为双元素矢量。例如，此按钮跨栏2通过3:

b.layout.column = [2 3];

按钮按下回调，指定为其中一个值：

当用户单击应用程序中的按钮时执行此回调。

This callback function can access specific information about the user’s interaction with the button. MATLAB passes this information in abuttonpusheddata.object as the second argument to your callback function. In App Designer, the argument is called事件。You can query the object’s properties using dot notation. For example,event.source.returns theButton目的。这buttonpusheddata.object is not available to callback functions specified as character vectors.

这following table lists the properties of thebuttonpusheddata.目的。

For more information about writing callbacks, seeWrite Callbacks in App Designer。

对象创建函数，指定为其中一个值：

有关将回调作为函数句柄，小区阵列或字符向量的更多信息，请参阅Write Callbacks in App Designer。

此属性指定MATLAB创建对象时要执行的回调函数。MATLAB在执行之前初始化所有属性值CreateFcn.打回来。如果您没有指定CreateFcn.属性，然后matlab执行默认的创建功能。

设置CreateFcn.现有组件上的属性无效。

如果将此属性指定为函数句柄或单元格数组，则可以访问使用回调函数的第一个参数创建的对象。否则，使用gcbo.访问对象的函数。

Object deletion function, specified as one of these values:

有关将回调作为函数句柄，小区阵列或字符向量的更多信息，请参阅Write Callbacks in App Designer。

This property specifies a callback function to execute when MATLAB deletes the object. MATLAB executes thedeletefcn.callback before destroying the properties of the object. If you do not specify thedeletefcn.属性，然后matlab执行默认删除函数。

If you specify this property as a function handle or cell array, you can access the object that is being deleted using the first argument of the callback function. Otherwise, use thegcbo.访问对象的函数。

回调中断, specified as'on'或者'离开'，或作为数字或逻辑1(真的) or0(false). A value of'on'相当于真的， 和'离开'相当于false。Thus, you can use the value of this property as a logical value. The value is stored as an on/off logical value of typematlab.lang.OnoffSwitchState.。

This property determines if a running callback can be interrupted. There are two callback states to consider:

每当matlab调用回调时，回调尝试中断运行的回调（如果存在）。这Interruptibleproperty of the object owning the running callback determines if interruption is allowed.

标准队列，指定为'队列'或者'取消'。这BusyActionproperty determines how MATLAB handles the execution of interrupting callbacks. There are two callback states to consider:

Whenever MATLAB invokes a callback, that callback attempts to interrupt a running callback. TheInterruptible拥有运行回调的对象的属性确定是否允许中断。如果不允许中断，那么BusyActionproperty of the object owning the interrupting callback determines if it is discarded or put in the queue. These are possible values of theBusyAction财产：

此属性是只读的。

Deletion status, returned as an on/off logical value of typematlab.lang.OnoffSwitchState.。

马铃薯sets the呈扭曲property to'on'当。。。的时候deletefcn.回调开始执行。这呈扭曲property remains set to'on'直到组件对象不再存在。

检查价值呈扭曲属性来验证object is not about to be deleted before querying or modifying it.

父容器, specified as a数字使用的对象Uifigure.功能，或其中一个子容器：标签,Panel,buttongroup.， 或者GridLayout。If no container is specified, MATLAB calls theUifigure.function to create a new数字用作父容器的对象。

Visibility of the object handle, specified as'on','callback'， 或者'离开'。

This property controls the visibility of the object in its parent's list of children. When an object is not visible in its parent's list of children, it is not returned by functions that obtain objects by searching the object hierarchy or querying properties. These functions include得到,findobj.,clf， 和close。即使它们不可见，对象也有效。如果可以访问对象，则可以设置和获取其属性，并将其传递给对象上运行的任何功能。

此属性是只读的。

图形对象的类型, returned as'Uibutton'。

对象标识符，指定为字符向量或字符串标量。您可以指定一个唯一的标签作为对象的标识符的值。当您需要访问代码中其他地方的对象时，可以使用findobj.function to search for the object based on the标签价值。

用户数据，指定为任何MATLAB阵列。例如，您可以指定标量，向量，矩阵，单元格数组，字符数组，表或结构。使用此属性在对象上存储任意数据。

如果您在App Designer中工作，请在应用程序中创建公共或私有属性以共享数据而不是使用用户数据财产。有关更多信息，请参阅在App Designer应用程序中共享数据。