主要内容

このページの翻訳は最新ではありません。ここをクリックして,英語の最新版を参照してください。

uitogglebutton

トグルボタンコンポーネントの作成

説明

结核病= uitogglebuttonは,ボタングループ内にトグルボタンを作成し,ToggleButtonオブジェクトを返します。MATLAB®は関数uifigureを呼び出してこのボタングループの親图を作成します。

结核病= uitogglebutton (は,指定されたボタングループ内にトグルボタンを作成します。ボタングループは関数uifigureで作成された数字の子であるか,または图の子コンテナー(选项卡面板ButtonGroupまたはGridLayout)を親としなければなりません。

结核病= uitogglebutton (___名称,值は1つ以上の名称,值のペアの引数を使用して,ToggleButtonのプロパティを指定します。このオプションは,前述の構文のすべての入力引数の組み合わせで使用できます。

すべて折りたたむ

トグルボタンを作成するために,まず,トグルボタンを含める图ウィンドウとボタングループを作成します。

无花果= uifigure (“位置”,[680 678 398 271]);bg = uibuttongroup(图,“位置”,[137 113 123 85]);

トグルボタンを3個作成し,それぞれの位置を指定します。

tb1 = uitogglebutton (bg,“位置”,[10 50 100 22]);tb2 = uitogglebutton (bg,“位置”,[10 28 100 22]);tb3 = uitogglebutton (bg,“位置”,[10 6 100 22]);

各トグルボタンに関連付けられているテキストを変更します。

tb1。文本=“英语”;tb2。文本=“法国”;tb3。文本=“德国”

プログラムにより,トグルボタンの選択を(德国)に変更します。

tb3。值= true;

(德国)トグルボタンのテキストのフォント名を調べます。

字体= tb3。字体名
= Helvetica字体

入力引数

すべて折りたたむ

親コンテナー。ButtonGroupオブジェクトとして指定します。ButtonGroupは,関数uifigureを使用して作成された数字,またはuifigureの子コンテナー(选项卡面板ButtonGroupまたはGridLayout)を親としなければなりません。

名前と値のペアの引数

オプションの名称,值の引数ペアをコンマ区切りで指定します。的名字は引数名で,价值は対応する値です。的名字は引用符で囲まなければなりません。Name1, Value1,…,的家のように,複数の名前と値のペアの引数を任意の順序で指定できます。

例:“文本”,“法国”は,トグルボタンに表示するテキストを“法国”に指定します。

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

トグルボタンの状態。0(押されていない)または1(押されている)として指定します。ボタングループ内で一度に選択できる(押すことができる)トグルボタンは1つのみです。价值プロパティが1に設定されている場合,トグルボタンは押されている状態で表示されます。既定では,ボタングループに最初に追加されたボタンの状態が1です。同じボタングループに追加された後続ボタンの既定の状態は0です。

ToggleButton价值プロパティが1に変更されるときに,直前に選択されていたToggleButton价值プロパティは0に変更されます。さらに,ButtonGroupSelectedObjectプロパティ値が更新されます。

プログラムによりToggleButton价值プロパティを0に変更した場合,MATLABはButtonGroupに“追加された”最初のToggleButton价值プロパティを1に設定します。追加した最初のToggleButton价值プロパティがプログラムにより0に設定されている場合,MATLABは,ButtonGroupに追加されたToggleButton价值プロパティを1に設定します。

メモ

ButtonGroupに最初に“追”加されたToggleButtonが,ButtonGroup孩子们プロパティの最初に”リスト”されるToggleButtonとは限りません。

ボタンラベル。文字ベクトル、文字ベクトルの细胞配列、字符串スカラー、string 配列、または 1 次元の categorical 配列として指定します。ボタンに 1 行のテキストのラベルを付ける場合は文字ベクトルまたは string スカラーを指定します。ボタンに複数行のテキストのラベルを付ける場合は cell 配列または string 配列を使用します。配列の各要素は、テキストの各行を表します。このプロパティを categorical 配列として指定した場合、MATLAB はカテゴリの完全なセットではなく、配列内の値を使用します。

アイコンのソースまたはファイル。文字ベクトル、字符串スカラー,またはxnx 3のトゥルーカラーイメージ配列として指定します。ファイル名には,MATLABパス上のイメージファイル名,あるいはイメージファイルへの絶対パスを指定できます。他のユーザーとアプリを共有する予定の場合は,アプリのパッケージ化を容易にするためにイメージファイルをMATLABパス上に配置します。

サポートされているイメージ形式には,JPEG, PNG、GIF, SVGまたはxnx 3のトゥルーカラーイメージ配列が含まれます。トゥルーカラーイメージ配列の詳細については,イメージの種類を参照してください。

  • 位置プロパティ値で指定されたすべての領域をボタンのテキストが占有する場合,MATLABはアイコンを表示しません。

  • アイコンに利用可能な領域がいくらかある場合,MATLABは必要に応じて,その領域に収まるようにイメージを縮小します。

例:“程序”は,MATLABパス上のアイコンファイルを指定します。

例:“C: \ \程序文件”は,イメージファイルへの絶対パスを指定します。

ボタンの位置とサイズ。[左底宽高]の形式のベクトルとして指定します。次の表で,ベクトルの各要素について説明します。

要素 説明
ボタングループの内側左端からボタンの外側左端までの距離
ボタングループの内側下端からボタンの外側下端までの距離
宽度 ボタンの外側の右端と左端の間の距離
高度 ボタンの外側の上端と下端の間の距離

位置の値は,ボタングループの"描画可能領域"を基準とした相対値です。描画可能領域は,ボタングループの境界線の内側にある領域で,タイトルが占める領域は含まれません。

すべての測定単位はピクセルです。

ヒント

  • ボタングループには任意のUIコンポーネントのタイプを含めることができますが,管理できるのはラジオボタンとトグルボタンの選択だけです。

  • ボタングループ内のラジオボタンまたはトグルボタンをアプリユーザーが選択したときにプログラムを応答させるには,ButtonGroupオブジェクトのコールバック関数SelectionChangedFcnを定義します。個々のボタンのコールバックを定義することはできません。

  • 選択されているラジオボタンまたはトグルボタンを判定するには,ButtonGroupオブジェクトのSelectedObjectプロパティをクエリします。このクエリは,コード内の任意の場所で実行できます。

  • ButtonGroupオブジェクトの可见プロパティが“关闭”に設定されている場合,それに含まれる子オブジェクトは,親ButtonGroupと共に非表示になります。ただし,個々の子オブジェクトの可见“プロパティ値”は影響を受けません。

R2016aで導入