Main Content

本页的翻译已过时。点击此处可查看最新英文版本。

uibutton

创建普通按钮或状态按钮组件

说明

btn = uibutton 在新图窗中创建一个普通按钮,并返回 Button 对象。MATLAB® 调用 uifigure 函数来创建该图窗。

btn = uibutton(style) 创建指定样式的按钮。

示例

btn = uibutton(parent) 在指定的父容器中创建按钮。父容器可以是使用 uifigure 函数创建的 Figure 或其子容器之一。

示例

btn = uibutton(parent,style) 在指定的父容器中创建指定样式的 Button

示例

btn = uibutton(___,Name,Value) 使用由一个或多个 Name,Value 对组参数指定的属性创建 Button。可以将此选项与前面语法中的任何输入参数组合一起使用。

示例

全部折叠

创建普通按钮。

fig = uifigure;
btn = uibutton(fig);

通过将样式指定为 'state',创建一个状态按钮。

fig = uifigure;
btn = uibutton(fig,'state');

fig = uifigure('Name','My Figure');
pnl = uipanel(fig);
btn = uibutton(pnl); 

创建状态按钮并指定属性值。

fig = uifigure;
btn = uibutton(fig,'state',...
               'Text', 'Record',...
               'Value', true,...
               'Position',[50,100, 100, 22]);

确定状态按钮文本的字体名称。

fname = btn.FontName
fname =

Helvetica

更改按钮文本的字体名称。

btn.FontName = 'Arial Narrow';

创建一个按钮和一个 UI 坐标区。当 App 用户按下该按钮时,将创建一个图形。

在 MATLAB 路径中创建 buttonPlot.m。以下代码将创建一个窗口,其中包含一个按钮和一个 UI 坐标区。当 App 用户点击该按钮时,ButtonPushedFcn 将绘制一些数据。

function buttonPlot
% Create a figure window
fig = uifigure;

% Create a UI axes
ax = uiaxes('Parent',fig,...
            'Units','pixels',...
            'Position', [104, 123, 300, 201]);   

% Create a push button
btn = uibutton(fig,'push',...
               'Position',[420, 218, 100, 22],...
               'ButtonPushedFcn', @(btn,event) plotButtonPushed(btn,ax));
end

% Create the function for the ButtonPushedFcn callback
function plotButtonPushed(btn,ax)
        x = linspace(0,2*pi,100);
        y = sin(x);
        plot(ax,x,y)
end

运行 buttonPlot,然后点击普通按钮。MATLAB 将绘制数据。

输入参数

全部折叠

按钮的样式,指定为下列值之一:

  • 'push'

    点击一次,按钮将被按下并释放。

  • 'state'

    点击一次,按钮将保持按下或释放状态,直到再次点击为止。

父容器,指定为使用 uifigure 函数创建的 Figure 对象或其子容器之一:TabPanelButtonGroupGridLayout。如果不指定父容器,MATLAB 会调用 uifigure 函数创建新 Figure 对象充当父容器。

名称-值对组参数

指定可选的、以逗号分隔的 Name,Value 对组参数。Name 为参数名称,Value 为对应的值。Name 必须放在引号中。您可采用任意顺序指定多个名称-值对组参数,如 Name1,Value1,...,NameN,ValueN 所示。

每种类型的 Button 对象支持一组不同的属性。有关每种类型的属性和说明的完整列表,请参阅相关联的属性页。

在 R2016a 中推出