uibuttongroup

ラジオボタンとトグルボタンを管理するボタングループの作成

構文

bg = uibuttongroup

bg = uibuttongroup(Name,Value)

bg = uibuttongroup(parent)

bg = uibuttongroup(parent,Name,Value)

説明

bg = uibuttongroup は現在の Figure 内にボタングループを作成し、ButtonGroup オブジェクトを返します。利用可能な Figure がない場合は、MATLAB^® が関数 figure を呼び出して Figure を作成します。

例

bg = uibuttongroup(Name,Value) は 1 つ以上の名前と値のペアの引数を使用して、ボタングループのプロパティ値を指定します。

bg = uibuttongroup(parent) は、指定された親コンテナー内にボタングループを作成します。親コンテナーには、関数 figure または関数 uifigure で作成された Figure か、パネルなどの子コンテナーを指定できます。uibuttongroup のプロパティの値は、関数 figure で作成されたアプリと関数 uifigure で作成されたアプリで多少異なります。詳細については、名前と値のペアの引数を参照してください。

例

bg = uibuttongroup(parent,Name,Value) は親コンテナーと、1 つ以上のプロパティ値を指定します。

例

すべて折りたたむ

ラジオボタンの選択に対するコードの応答

ユーザーがボタングループ内の異なるラジオボタンを選択したときに、直前と現在のボタン選択を MATLAB コマンドウィンドウに表示します。

この動作を確認するには、以下のコードをコピーしてエディターに貼り付け、実行します。

function myui
bg = uibuttongroup('Visible','off',...
                  'Position',[0 0 .2 1],...
                  'SelectionChangedFcn',@bselection);
              
% Create three radio buttons in the button group.
r1 = uicontrol(bg,'Style',...
                  'radiobutton',...
                  'String','Option 1',...
                  'Position',[10 350 100 30],...
                  'HandleVisibility','off');
              
r2 = uicontrol(bg,'Style','radiobutton',...
                  'String','Option 2',...
                  'Position',[10 250 100 30],...
                  'HandleVisibility','off');

r3 = uicontrol(bg,'Style','radiobutton',...
                  'String','Option 3',...
                  'Position',[10 150 100 30],...
                  'HandleVisibility','off');
              
% Make the uibuttongroup visible after creating child objects. 
bg.Visible = 'on';

    function bselection(source,event)
       disp(['Previous: ' event.OldValue.String]);
       disp(['Current: ' event.NewValue.String]);
       disp('------------------');
    end
end

関数 bselection は、event の OldValue プロパティと NewValue プロパティを表示します。

App with three grouped radio buttons labeled Option 1, Option 2, and Option 3. The first button is selected.

スクロール可能なボタングループ

Scrollable プロパティによって、境界外部にコンポーネントがあるボタングループ内でのスクロールが有効になります。スクロールは、ボタングループが関数 uifigure で作成された Figure 内にある場合にのみ可能です。App Designer では、このタイプの Figure がアプリの作成に使用されます。

ボタングループを Figure 内に作成します。6 つのトグルボタンを追加し、最初の 3 つがボタングループの上縁から外れるようにします。

fig = uifigure;
bg = uibuttongroup(fig,'Position',[20 20 196 135]);
tb1 = uitogglebutton(bg,'Position',[11 165 140 22],'Text','One');
tb2 = uitogglebutton(bg,'Position',[11 140 140 22],'Text','Two');
tb3 = uitogglebutton(bg,'Position',[11 115 140 22],'Text','Three');
tb4 = uitogglebutton(bg,'Position',[11 90 140 22],'Text','Four');
tb5 = uitogglebutton(bg,'Position',[11 65 140 22],'Text','Five');
tb6 = uitogglebutton(bg,'Position',[11 40 140 22],'Text','Six');

App with a button group with six toggle buttons. The first, second, and part of the third button are not visible.

ボタングループの Scrollable プロパティを 'on' に設定して、スクロールを有効にします。既定で、スクロールボックスが上部に表示されます。

bg.Scrollable = 'on';

Scrollable button group. The scroll bar on the left is scrolled to the top, and all the buttons are visible. The first button is selected.

入力引数

すべて折りたたむ

`parent` — 親コンテナー
`Figure` オブジェクト (既定値) | `Panel` オブジェクト | `Tab` オブジェクト | `ButtonGroup` オブジェクト | `GridLayout` オブジェクト

親コンテナー。関数 figure または関数 uifigure で作成された Figure か、子コンテナーとして指定します。

パネル、タブ、およびボタングループは、いずれのタイプの Figure でもコンテナーとすることができる。
グリッドレイアウトは、関数 uifigure で作成された Figure 内でのみコンテナーとすることができる。

名前と値の引数

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

例: uibuttongroup(Title="Options") は、ボタングループのタイトルを Options に指定します。

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

例: uibuttongroup("Title","Options") は、ボタングループのタイトルを Options に指定します。

メモ

以下にリストするプロパティは、利用できるプロパティの一部です。完全なリストについては、ButtonGroup のプロパティを参照してください。

`Title` — タイトル
文字ベクトル | string スカラー | categorical 配列

タイトル。文字ベクトル、string スカラー、または categorical 配列として指定します。このプロパティを categorical 配列として指定した場合、MATLAB は配列の最初の要素のみを表示します。

MATLAB では垂直スラッシュ ('|') 文字は改行として解釈されず、タイトル内に垂直スラッシュとして表示されます。

Unicode^® 文字を指定する場合、Unicode 10 進コードを関数 char に渡します。たとえば、['Multiples of ' char(960)] は Multiples of π として表示されます。

`BackgroundColor` — 背景色
`[0.94 0.94 0.94]` (既定値) | RGB 3 成分 | 16 進数カラーコード | `'r'` | `'g'` | `'b'` | ...

背景色。RGB 3 成分、16 進数カラーコード、または表にリストされた色オプションのいずれかとして指定します。

RGB 3 成分および 16 進数カラーコードは、カスタム色を指定するのに役立ちます。

RGB 3 成分は、色の赤、緑、青成分の強度を指定する 3 成分の行ベクトルです。強度値は [0,1] の範囲でなければなりません。たとえば [0.4 0.6 0.7] のようになります。
16 進数カラーコードは、ハッシュ記号 (#) で始まり、3 桁または 6 桁の 0 から F までの範囲の 16 進数が続く文字ベクトルまたは string スカラーです。これらの値では大文字小文字は区別されません。したがって、カラーコード '#FF8800'、'#ff8800'、'#F80'、および '#f80' は等価です。

あるいは、名前を使用して一部の一般的な色を指定できます。次の表に、名前の付いた色オプション、等価の RGB 3 成分、および 16 進数カラーコードを示します。

色名	省略名	RGB 3 成分	16 進数カラーコード
`"red"`	`"r"`	`[1 0 0]`	`"#FF0000"`
`"green"`	`"g"`	`[0 1 0]`	`"#00FF00"`
`"blue"`	`"b"`	`[0 0 1]`	`"#0000FF"`
`"cyan"`	`"c"`	`[0 1 1]`	`"#00FFFF"`
`"magenta"`	`"m"`	`[1 0 1]`	`"#FF00FF"`
`"yellow"`	`"y"`	`[1 1 0]`	`"#FFFF00"`
`"black"`	`"k"`	`[0 0 0]`	`"#000000"`
`"white"`	`"w"`	`[1 1 1]`	`"#FFFFFF"`

MATLAB の多くのタイプのプロットで使用されている既定の色の RGB 3 成分および 16 進数カラーコードを次に示します。

RGB 3 成分	16 進数カラーコード	外観
`[0 0.4470 0.7410]`	`"#0072BD"`
`[0.8500 0.3250 0.0980]`	`"#D95319"`
`[0.9290 0.6940 0.1250]`	`"#EDB120"`
`[0.4940 0.1840 0.5560]`	`"#7E2F8E"`
`[0.4660 0.6740 0.1880]`	`"#77AC30"`
`[0.3010 0.7450 0.9330]`	`"#4DBEEE"`
`[0.6350 0.0780 0.1840]`	`"#A2142F"`

`SelectedObject` — 現在選択されているラジオボタンまたはトグルボタン
ボタングループ内の最初のラジオボタンまたはトグルボタン (既定値)

現在選択されているラジオボタンまたはトグルボタン。uifigure ベースのアプリでは RadioButton オブジェクトまたは ToggleButton オブジェクト、figure ベースのアプリでは UIControl オブジェクトとして指定します。

ボタングループ内で現在選択されているボタンを判定するには、このプロパティ値を取得します。

現在選択されているボタンを変更するには、このプロパティ値を設定します。このプロパティを使用して選択を変更すると、MATLAB はそれに応じて、ボタングループ内の他のボタンの Value プロパティを調整します。

たとえば、ボタングループに 3 つのラジオボタンがあり、SelectedObject プロパティを radiobutton3 に設定したとします。MATLAB は、それぞれの子 RadioButton の Value プロパティを次のように設定します。

radiobutton1.Value = false;
radiobutton2.Value = false;
radiobutton3.Value = true;

つまり、SelectedObject プロパティを設定することには、ボタングループ内のボタンの Value プロパティを設定することと同じ効果があります。

`SelectionChangedFcn` — 選択変更コールバック
`''` (既定値) | 関数ハンドル | cell 配列 | 文字ベクトル

選択変更コールバック。次の値のいずれかとして指定します。

関数ハンドル。
最初の要素が関数ハンドルである cell 配列。cell 配列内のその後の要素はコールバック関数に渡される引数です。
有効な MATLAB 式を含む文字ベクトル (非推奨)。MATLAB は、この式をベースワークスペースで評価します。

このコールバックは、ユーザーがアプリでボタングループ内の別のボタンを選択したときに実行されます。ラジオボタンまたはトグルボタンの Value プロパティがプログラムにより変更される場合には実行されません。

このコールバック関数は、ユーザーのボタン操作に関する特定の情報にアクセスできます。MATLAB は、この情報を SelectionChangedData オブジェクトに格納して、2 番目の引数としてコールバック関数に渡します。App Designer では、引数は event と呼ばれます。ドット表記を使用して、オブジェクトのプロパティをクエリできます。たとえば、event.NewValue は現在選択されているボタンを返します。SelectionChangedData オブジェクトは、文字ベクトルとして指定されているコールバック関数では使用できません。

次の表に、SelectionChangedData オブジェクトのプロパティを示します。

プロパティ	説明
`OldValue`	直前に選択されていたボタン
`NewValue`	現在選択されているボタン
`Source`	コールバックを実行するコンポーネント
`EventName`	`'SelectionChanged'`

コールバックの記述の詳細については、App Designer のコールバックを参照してください。

`Position` — ボタングループの位置とサイズ。境界とタイトルを含みます。
`[left bottom width height]`

ボタングループの位置とサイズ。境界とタイトルを含みます。[left bottom width height] の形式のベクトルとして指定します。次の表で、ベクトルの各要素について説明します。

要素	説明
`left`	親コンテナーの内側左端からボタングループの外側左端までの距離
`bottom`	親コンテナーの内側下端からボタングループの外側下端までの距離
`width`	ボタングループの外側の右端と左端の間の距離
`height`	ボタングループの外側の上端と下端の間の距離

すべての測定値は、Units プロパティで指定した単位で表されます。

Position の値の基準は、親コンテナーの "描画可能領域" です。描画可能領域は、コンテナーの境界線の内側にある領域で、メニューバーやタイトルなどの装飾が占める領域は含まれません。

メモ

ボタングループがグリッドレイアウトマネージャーを親とする場合、Position プロパティの値は直ちには更新されません。Position の値を使用して、ボタングループのサイズを基準にボタングループの子のサイズを変更するには、SizeChangedFcn コールバックを使用します。

`Units` — 測定の単位
`'pixels'` | `'normalized'` | `'inches'` | `'centimeters'` | `'points'` | `'characters'`

測定の単位。次の表のいずれかの値として指定します。

単位の値	説明
`'pixels'` (`uifigure` ベースのアプリの既定)	Windows^® および Macintosh システムでのピクセル単位の距離は、システムの解像度に依存しません。 Windows システムの 1 ピクセルは 1/96 インチです。 Macintosh システムの 1 ピクセルは 1/72 インチです。 Linux^® システムでは、ピクセルのサイズは使用しているシステムの解像度によって決まります。
`'normalized'` (`figure` ベースのアプリの既定)	これらの単位は親コンテナーを基準として正規化されます。コンテナーの左下隅が `(0,0)` で、右上隅が `(1,1)` になります。
`'inches'`	インチ。
`'centimeters'`	センチメートル。
`'points'`	ポイント。1 ポイントは 1/72 インチです。
`'characters'`	これらの単位は、グラフィックスルートオブジェクトの既定の uicontrol フォントを基にしています。文字の幅 = 文字 `x` の幅。文字の高さ = 2 行のテキストのベースライン間の距離。既定の uicontrol フォントにアクセスするには、`get(groot,'defaultuicontrolFontName')` または `set(groot,'defaultuicontrolFontName')` を使用します。

MATLAB のほとんどのアプリ作成機能では距離をピクセル単位で測定するため、推奨値は 'pixels' です。親コンテナーのサイズに基づいて再スケーリングされるオブジェクトを作成するには、関数 uigridlayout を使用して作成されたグリッドレイアウトマネージャーをオブジェクトの親にします。詳細については、Lay Out Apps Programmaticallyを参照してください。

ヒント

ボタングループにはあらゆる UI コンポーネントのタイプを含めることができますが、ラジオボタンとトグルボタンの選択のみを管理します。
ボタングループ内のラジオボタンまたはトグルボタンをアプリユーザーが選択したときにプログラムを応答させるには、ボタングループのコールバック関数 SelectionChangedFcn を定義します。個々のボタンのコールバックを定義することはできません。
選択されているラジオボタンまたはトグルボタンを判定するには、ボタングループの SelectedObject プロパティをクエリします。このクエリは、コード内の任意の場所で実行できます。
ボタングループオブジェクトの Visible プロパティが 'off' に設定されている場合、その中に含まれる子オブジェクト (ボタン、他のボタングループなど) は、親であるボタングループと共に非表示になります。ただし、個々の子オブジェクトの Visible "プロパティ値" は影響を受けません。

バージョン履歴

R2006a より前に導入

すべて展開する

R2022b: `uifigure` ベースのアプリにおけるボタングループの境界幅の変更

App Designer で作成されたアプリ、および関数 uifigure を使用して作成されたアプリでは、BorderWidth プロパティを使用してボタングループの境界幅を変更します。

R2020b: 操作のオフとオンの切り替え

ユーザーの操作にボタングループが応答するかどうかを制御するには、Enable プロパティを使用します。Enable プロパティが 'on' に設定されている場合、ボタングループとその内部の UI コンポーネントが有効になっている限り、それらを操作できます。Enable プロパティが 'off' に設定されている場合、ボタングループまたはその内容を操作することはできません。

Enable プロパティは App Designer と uifigure ベースのアプリのボタングループでのみサポートされます。

uibuttongroup

構文

説明

例

ラジオ ボタンの選択に対するコードの応答

スクロール可能なボタン グループ

入力引数

parent — 親コンテナー Figure オブジェクト (既定値) | Panel オブジェクト | Tab オブジェクト | ButtonGroup オブジェクト | GridLayout オブジェクト

名前と値の引数

Title — タイトル 文字ベクトル | string スカラー | categorical 配列

BackgroundColor — 背景色 [0.94 0.94 0.94] (既定値) | RGB 3 成分 | 16 進数カラー コード | 'r' | 'g' | 'b' | ...

SelectedObject — 現在選択されているラジオ ボタンまたはトグル ボタン ボタン グループ内の最初のラジオ ボタンまたはトグル ボタン (既定値)

SelectionChangedFcn — 選択変更コールバック '' (既定値) | 関数ハンドル | cell 配列 | 文字ベクトル

Position — ボタン グループの位置とサイズ。境界とタイトルを含みます。 [left bottom width height]

Units — 測定の単位 'pixels' | 'normalized' | 'inches' | 'centimeters' | 'points' | 'characters'

ヒント