uicheckbox
チェック ボックス コンポーネントの作成
説明
は、チェック ボックスを新しい Figure ウィンドウ内に作成し、cbx = uicheckboxCheckBox オブジェクトを返します。MATLAB® は関数 uifigure を呼び出してこの Figure を作成します。
は、1 つ以上の名前と値の引数を使用して、cbx = uicheckbox(___,Name,Value)CheckBox プロパティを指定します。たとえば、uicheckbox("Value",1) は、オンになっているチェック ボックスを作成します。このオプションは、前述の構文のすべての入力引数の組み合わせで使用できます。
例
UI Figure 内にチェック ボックスを作成し、チェック ボックスのテキストを指定します。
fig = uifigure; cbx = uicheckbox(fig,"Text","Subscribe");

チェック ボックスの値をクエリします。
val = cbx.Value
val = logical
0
Value プロパティを更新して、プログラムによってチェック ボックスをオンにします。
cbx.Value = 1;

ユーザーがプロットの凡例の表示と非表示を切り替えることができるアプリを作成します。
toggleLegendApp.m という名前のファイルで、アプリを実装する関数を作成します。
UI Figure およびグリッド レイアウト マネージャーを作成してアプリをレイアウトします。
グリッド レイアウト マネージャーで UI 座標軸とチェック ボックスを作成し、座標軸にデータをプロットします。
プロットの凡例の表示と非表示を切り替える
checkBoxChangedという名前のコールバック関数を作成し、その関数をチェック ボックスのValueChangedFcnコールバック プロパティに割り当てます。コールバックの詳細については、プログラムで作成したアプリ用のコールバックの作成を参照してください。
function toggleLegendApp fig = uifigure; g = uigridlayout(fig,[2 3]); g.RowHeight = {'1x','fit'}; g.ColumnWidth = {'1x','fit','1x'}; ax = uiaxes(g); ax.Layout.Row = 1; ax.Layout.Column = [1 3]; plot(ax,magic(3)); lgd = legend(ax,"hide"); cbx = uicheckbox(g,"Text","Show legend"); cbx.Layout.Row = 2; cbx.Layout.Column = 2; cbx.ValueChangedFcn = @(src,event) checkBoxChanged(src,event,lgd); end function checkBoxChanged(src,event,lgd) val = event.Value; lgd.Visible = val; end
関数 toggleLegendApp を実行します。チェック ボックスをオンにして凡例を表示します。

入力引数
親コンテナー。Figure オブジェクトまたはその子コンテナー (Tab、Panel、ButtonGroup、GridLayout) のいずれかとして指定します。親コンテナーを指定しない場合、MATLAB は関数 uifigure を呼び出し、親コンテナーとして機能する新しい Figure オブジェクトを作成します。
名前と値の引数
オプションの引数のペアを Name1=Value1,...,NameN=ValueN として指定します。ここで、Name は引数名で、Value は対応する値です。名前と値の引数は他の引数の後に指定しなければなりませんが、ペアの順序は重要ではありません。
例: uicheckbox(Value=1) は、画面にオンの状態のチェック ボックスを表示するように指定します。
R2021a より前では、コンマを使用して名前と値をそれぞれ区切り、Name を引用符で囲みます。
例: uicheckbox("Value",1) は、画面にオンの状態のチェック ボックスを表示するように指定します。
メモ
以下にリストするプロパティは、利用できるプロパティの一部です。完全なリストについては、CheckBox を参照してください。
チェック ボックスの状態。0 (false) または 1 (true) として指定します。Value プロパティが 1 に設定されている場合、チェック ボックスはオンです。Value プロパティが 0 に設定されている場合、チェック ボックスはオフです。
値が変更されたときのコールバック。次の値のいずれかとして指定します。
関数ハンドル
最初の要素が関数ハンドルで、以降の要素がコールバック関数に渡す引数である cell 配列
ベース ワークスペース内で評価される有効な MATLAB コマンドまたは MATLAB 関数を含む string スカラーまたは文字ベクトル (非推奨)
このコールバックは、ユーザーがアプリでチェック ボックスをオンまたはオフにしたときに実行されます。チェック ボックスの値がプログラムによって変更された場合にはコールバックは実行されません。
このコールバック関数は、ユーザーのチェック ボックス操作に関する特定の情報にアクセスできます。MATLAB は、この情報を ValueChangedData オブジェクトに格納して、2 番目の引数としてコールバック関数に渡します。App Designer では、引数は event と呼ばれます。ドット表記を使用して、オブジェクトのプロパティをクエリできます。たとえば、event.PreviousValue はチェック ボックスの直前の値を返します。ValueChangedData オブジェクトは、文字ベクトルとして指定されているコールバック関数では使用できません。
次の表に、ValueChangedData オブジェクトのプロパティを示します。
| プロパティ | 値 |
|---|---|
Value | アプリ ユーザーによる最新操作の後のチェック ボックスの値。 |
PreviousValue | アプリ ユーザーによる最新操作の前のチェック ボックスの値。 |
Source | コールバックを実行するコンポーネント。 |
EventName | 'ValueChanged' |
コールバックの記述の詳細については、App Designer のコールバックを参照してください。
親を基準にしたチェック ボックスの位置とサイズ。ベクトル [left bottom width height] として指定します。次の表で、ベクトルの各要素について説明します。
| 要素 | 説明 |
|---|---|
left | 親コンテナーの内側左端からチェック ボックスの外側左端までの距離 |
bottom | 親コンテナーの内側下端からチェック ボックスの外側下端までの距離 |
width | チェック ボックスの外側の右端と左端の間の距離 |
height | チェック ボックスの外側の上端と下端の間の距離 |
Position の値の基準は、親コンテナーの "描画可能領域" です。描画可能領域は、コンテナーの境界線の内側にある領域で、メニュー バーやタイトルなどの装飾が占める領域は含まれません。
すべての測定単位はピクセルです。
例: [200 200 102 15]
バージョン履歴
R2016a で導入figure 関数を使用して作成した既存のアプリがある場合、コンポーネントの親に Figure オブジェクトを指定することで、UI コンポーネントをアプリに追加できるようになりました。
UI コンポーネントを使用する figure ベースのアプリ更新の詳細については、UIControl オブジェクトおよびコールバックの更新を参照してください。
表示するテキストより UI コンポーネントの幅が小さい場合に、テキストが水平方向に切り捨てられないようにするには、WordWrap プロパティを使用します。WordWrap プロパティを 'on' に設定すると、各行がコンポーネントに収まるようにテキストが新しい行に折り返されます。可能な限り、単語の途中での改行はされません。プロパティが 'off' に設定されている場合、テキストは折り返されません。
MATLAB Command
You clicked a link that corresponds to this MATLAB command:
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
Web サイトの選択
Web サイトを選択すると、翻訳されたコンテンツにアクセスし、地域のイベントやサービスを確認できます。現在の位置情報に基づき、次のサイトの選択を推奨します:
また、以下のリストから Web サイトを選択することもできます。
最適なサイトパフォーマンスの取得方法
中国のサイト (中国語または英語) を選択することで、最適なサイトパフォーマンスが得られます。その他の国の MathWorks のサイトは、お客様の地域からのアクセスが最適化されていません。
南北アメリカ
- América Latina (Español)
- Canada (English)
- United States (English)
ヨーロッパ
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)
