uitogglebutton
トグル ボタン コンポーネントの作成
説明
tb = uitogglebuttonToggleButton オブジェクトを返します。MATLAB® は関数 uifigure を呼び出してこのボタン グループの親 Figure を作成します。
tb = uitogglebutton(parent)Figure オブジェクトの子であるか、または Figure の子コンテナー (Tab、Panel、ButtonGroup または GridLayout) を親としなければなりません。
tb = uitogglebutton(___,Name,Value)Name,Value のペアの引数を使用して、ToggleButton のプロパティを指定します。このオプションは、前述の構文のすべての入力引数の組み合わせで使用できます。
例
トグル ボタンを作成するために、まず、トグル ボタンを含める Figure ウィンドウとボタン グループを作成します。
fig = uifigure('Position',[680 678 398 271]); bg = uibuttongroup(fig,'Position',[137 113 123 85]);
トグル ボタンを 3 個作成し、それぞれの位置を指定します。
tb1 = uitogglebutton(bg,'Position',[10 50 100 22]); tb2 = uitogglebutton(bg,'Position',[10 28 100 22]); tb3 = uitogglebutton(bg,'Position',[10 6 100 22]);
各トグル ボタンに関連付けられているテキストを変更します。
tb1.Text = 'English'; tb2.Text = 'French'; tb3.Text = 'German';
プログラムにより、トグル ボタンの選択を [German] に変更します。
tb3.Value = true;
[German] トグル ボタンのテキストのフォント名を調べます。
font = tb3.FontName
font = Helvetica
入力引数
名前と値の引数
オプションの引数のペアを Name1=Value1,...,NameN=ValueN として指定します。ここで、Name は引数名で、Value は対応する値です。名前と値の引数は他の引数の後に指定しなければなりませんが、ペアの順序は重要ではありません。
R2021a より前では、コンマを使用して名前と値をそれぞれ区切り、Name を引用符で囲みます。
例: 'Text', 'French' は、トグル ボタンに表示するテキストを “French" に指定します。
以下にリストするプロパティは、利用できるプロパティの一部です。完全なリストについては、ToggleButton を参照してください。
ボタン ラベル。文字ベクトル、文字ベクトルの cell 配列、string スカラー、string 配列、または 1 次元の categorical 配列として指定します。ボタンに 1 行のテキストのラベルを付ける場合は文字ベクトルまたは string スカラーを指定します。ボタンに複数行のテキストのラベルを付ける場合は cell 配列または string 配列を使用します。配列の各要素は、テキストの各行を表します。このプロパティを categorical 配列として指定した場合、MATLAB はカテゴリの完全なセットではなく、配列内の値を使用します。
事前定義されているアイコンまたはカスタム アイコン。文字ベクトル、string スカラー、または m×n×3 のトゥルーカラー イメージ配列として指定します。
事前定義されているアイコン
次の表に、事前定義されているアイコンを指定するための値を一覧します。
| 値 | アイコン |
|---|---|
'' (既定) | アイコンは表示されません。 |
'question' |
|
'info' |
|
'success' |
|
'warning' |
|
'error' |
|
カスタム アイコン
カスタム アイコンを次の値のいずれかとして指定します。
MATLAB パス上にある SVG、JPEG、GIF または PNG イメージのファイル名を指定する文字ベクトルまたは string スカラー。あるいは、イメージ ファイルの絶対パスを指定することもできます。
m×n×3 のトゥルーカラー イメージ配列。詳細については、MATLAB でのイメージ タイプの処理を参照してください。
他のユーザーとアプリを共有する予定の場合は、アプリのパッケージ化を容易にするためにイメージ ファイルを MATLAB パス上に配置します。
Position プロパティ値で指定されたすべての領域をボタンのテキストが占有する場合、MATLAB はアイコンを表示しません。アイコンに利用可能な領域がいくらかある場合、MATLAB は必要に応じて、その領域に収まるようにイメージを縮小します。
ヒント
ボタン グループには任意の UI コンポーネントのタイプを含めることができますが、管理できるのはラジオ ボタンとトグル ボタンの選択だけです。
ボタン グループ内のラジオ ボタンまたはトグル ボタンをアプリ ユーザーが選択したときにプログラムを応答させるには、
ButtonGroupオブジェクトのコールバック関数SelectionChangedFcnを定義します。個々のボタンのコールバックを定義することはできません。選択されているラジオ ボタンまたはトグル ボタンを判定するには、
ButtonGroupオブジェクトのSelectedObjectプロパティをクエリします。このクエリは、コード内の任意の場所で実行できます。ButtonGroupオブジェクトのVisibleプロパティが'off'に設定されている場合、それに含まれる子オブジェクトは、親ButtonGroupと共に非表示になります。ただし、個々の子オブジェクトのVisible"プロパティ値" は影響を受けません。
