Main Content

uibutton

プッシュ ボタン コンポーネントまたは状態ボタン コンポーネントの作成

ページ内をすべて折りたたむ

構文

btn = uibutton
btn = uibutton(style)
btn = uibutton(parent)
btn = uibutton(parent,style)
btn = uibutton(___,Name,Value)

説明

btn = uibutton は、プッシュ ボタンを新しい Figure 内に作成し、Button オブジェクトを返します。MATLAB® は関数 uifigure を呼び出してこの Figure を作成します。

btn = uibutton(style) は指定されたスタイルのボタンを作成します。

例

btn = uibutton(parent) は、指定された親コンテナー内にボタンを作成します。親には、関数 uifigure を使用して作成された Figure か、またはその子コンテナーのいずれかを指定できます。

例

btn = uibutton(parent,style) は、指定された親コンテナー内に指定されたスタイルの Button を作成します。

例

btn = uibutton(___,Name,Value) は、1 つ以上の Name,Value のペアの引数で指定されたプロパティをもつ Button を作成します。このオプションは、前述の構文のすべての入力引数の組み合わせで使用できます。

例

すべて折りたたむ

プッシュ ボタンを作成します。

fig = uifigure;
btn = uibutton(fig);

UI figure window with a push button. The default button text is Button.

スタイルを 'state' として指定して、状態ボタンを作成します。

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

UI figure window with a push button. The default button text is State Button.

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

UI figure window with a panel and a button. The button is in the panel.

状態ボタンを作成し、プロパティ値を指定します。

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

UI figure window with a state button. The button text is Record. The button is dark gray.

状態ボタンのテキストのフォント名を調べます。

fname = btn.FontName

fname =

Helvetica

ボタンのテキストのフォント名を変更します。

btn.FontName = 'Arial Narrow';

ボタンと UI 座標軸を作成します。アプリ ユーザーがボタンを押すと、グラフが作成されます。

MATLAB パス上に buttonPlot.m を作成します。次のコードは、ボタンと UI 座標軸を含むウィンドウを作成します。アプリ ユーザーがボタンをクリックすると、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 がデータをプロットします。

An app inside a UI figure. The app contains a plot with some data, and a button to the right of the plot.

入力引数

すべて折りたたむ

ボタンのスタイル。次のいずれかとして指定します。

  • 'push'

    1 回クリックすると、ボタンは押して離したように表示されます。

  • 'state'

    1 回クリックすると、再度クリックするまでボタンは押された状態または離された状態のままです。

親コンテナー。関数 uifigure を使用して作成された Figure オブジェクト、またはその子コンテナー (Tab、Panel、ButtonGroup または GridLayout) のいずれかとして指定します。親コンテナーを指定しない場合、MATLAB は関数 uifigure を呼び出し、親コンテナーとして機能する新しい Figure オブジェクトを作成します。

名前と値の引数

引数のオプションのペアを Name1=Value1,...,NameN=ValueN として指定します。ここで Name は引数名で、Value は対応する値です。名前と値の引数は他の引数の後になければなりませんが、ペアの順序は重要ではありません。

R2021a より前では、コンマを使用してそれぞれの名前と値を区切り、Name を引用符で囲みます。

各タイプの Button オブジェクトは、異なるプロパティのセットをサポートします。プロパティの完全なリストと各タイプについての説明は、対応するプロパティのページを参照してください。

バージョン履歴

R2016a で導入

すべて展開する

参考

関数

プロパティ