CheckBox
チェック ボックス UI コンポーネント
説明
チェック ボックス UI コンポーネントは、基本設定やオプションの状態を示します。CheckBox オブジェクトを使用して、チェック ボックスの作成後にチェック ボックスの外観と動作を変更します。
作成
uicheckbox 関数を使用してアプリでチェック ボックスを作成します。
プロパティ
チェック ボックス
チェック ボックスのラベル。次のいずれかとして指定します。
文字ベクトルまたは string スカラー — 1 行のテキストを表示します。以下に例を示します。
uicheckbox('Text','Filter');
文字ベクトル、string 配列、または 1 次元の categorical 配列の cell 配列 — 複数行のテキストを表示します。配列の各行は、1 行のテキストです。
uicheckbox('Text',{'Filter','Results'},... 'Position',[100 100 84 30]);
Text プロパティを cell 配列または string 配列に設定する場合、テキストの追加行が収まるように、Position プロパティを変更してください。
このプロパティを categorical 配列として指定した場合、MATLAB® はカテゴリの完全なセットではなく、配列内の値を使用します。
コンポーネントの幅に合わせるための右端での折り返し。'off' または 'on'、もしくは数値または logical 0 (false) または 1 (true) として指定します。'off' の値は false と等価であり、'on' の値は true と等価です。したがって、このプロパティの値を logical 値として使用できます。値は matlab.lang.OnOffSwitchState 型の on/off logical 値として格納されます。
このプロパティを使用して、表示するテキストよりコンポーネントの幅が小さい場合に水平方向に切り捨てられないようにします。
'off'— テキストは右端で折り返しされません。'on'— テキストを新しい行に折り返して、各行がコンポーネントの幅に収まるようにし、単語が区切られないようにします (可能な場合)。
WordWrap プロパティを 'on' に設定しても、コンポーネントの高さがテキストのすべての行を表示するには小さすぎる場合には、テキストが垂直方向に切り捨てられるのを回避できません。
フォントと色
フォントの色。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" |
|
次の表に、ライト テーマとダーク テーマでのプロットの既定のカラー パレットを示します。
| パレット | パレットの色 |
|---|---|
R2025a より前: ほとんどのプロットで、これらの色が既定で使用されます。 |
|
|
|
orderedcolors 関数と rgb2hex 関数を使用すると、これらのパレットの RGB 3 成分および 16 進数カラー コードを取得できます。たとえば、"gem" パレットの RGB 3 成分を取得し、16 進数カラー コードに変換します。
RGB = orderedcolors("gem");
H = rgb2hex(RGB);R2023b より前: RGB = get(groot,"FactoryAxesColorOrder") を使用して、RGB 3 成分を取得します。
R2024a より前: H = compose("#%02X%02X%02X",round(RGB*255)) を使用して、16 進数カラー コードを取得します。
対話機能
ツールヒント。文字ベクトル、文字ベクトルの cell 配列、string 配列、または 1 次元の categorical 配列として指定します。このプロパティを使用して、実行時にユーザーがポインターをコンポーネントに合わせるとメッセージが表示されるようにします。コンポーネントが無効になっている場合でも、ツールヒントは表示されます。複数行のテキストを表示するには、文字ベクトルの cell 配列または string 配列を指定します。配列の各要素は、テキストの各行になります。このプロパティを categorical 配列として指定した場合、MATLAB はカテゴリの完全なセットではなく、配列内の値を使用します。
コンテキスト メニュー。関数 uicontextmenu を使用して作成された ContextMenu オブジェクトとして指定します。このプロパティは、コンポーネントを右クリックしたときにコンテキスト メニューを表示するために使用します。
位置
チェック ボックスの内部位置とサイズ。[left bottom width height] として指定します。位置の値は、親コンテナーを基準とします。すべての測定単位はピクセルです。このプロパティ値は、チェック ボックスの Position プロパティ値と同一です。
この プロパティ は読み取り専用です。
チェック ボックスの外部位置とサイズ。[left bottom width height] として返されます。位置の値は、親コンテナーを基準とします。すべての測定単位はピクセルです。このプロパティ値は、Position プロパティ値と同一です。
レイアウト オプション。GridLayoutOptions オブジェクトとして指定します。このプロパティは、グリッド レイアウト コンテナーの子であるコンポーネントのオプションを指定します。コンポーネントがグリッド レイアウト コンテナーの子ではない場合 (たとえば、Figure またはパネルの子である場合) は、このプロパティは空で、効果はありません。しかし、コンポーネントがグリッド レイアウト コンテナーの子である場合は、GridLayoutOptions オブジェクトの Row プロパティおよび Column プロパティを設定して、グリッドの目的の行と列にコンポーネントを配置することができます。
たとえば、次のコードはチェック ボックスを親グリッドの 3 行目の 2 列目に配置します。
g = uigridlayout([4 3]); c = uicheckbox(g); c.Layout.Row = 3; c.Layout.Column = 2;
チェック ボックスが複数の行または列にまたがるようにするには、Row または Column プロパティを 2 要素のベクトルとして指定します。たとえば、次のチェック ボックスは 2 列目から 3 列目にまたがります。
c.Layout.Column = [2 3];
コールバック
コールバック実行制御
親/子
親コンテナー。Figure オブジェクトまたはその子コンテナー (Tab、Panel、ButtonGroup、GridLayout) のいずれかとして指定します。コンテナーが指定されていない場合、MATLAB は関数 uifigure を呼び出し、親コンテナーとして使用される新しい Figure オブジェクトを作成します。
識別子
この プロパティ は読み取り専用です。
グラフィックス オブジェクトのタイプ。'uicheckbox' として返されます。
オブジェクト関数
focus | UI コンポーネントにフォーカスを移動 |
例
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 を実行します。チェック ボックスをオンにして凡例を表示します。
