RadioButton のプロパティ

ラジオボタンの外観の制御

ラジオボタンは、通常はボタングループ内の一連のオプションとして表されます。ユーザーはそのうちのいずれかを選択しなければなりません。ラジオボタンの外観と動作はプロパティで制御します。ドット表記を使用して、特定のオブジェクトとプロパティを参照します。

fig = uifigure;
bg = uibuttongroup(fig);
rb = uiradiobutton(bg);
rb.Text = 'One';

ボタン

すべて展開する

`Value` — ラジオボタンの状態
`1` | `0`

ラジオボタンの状態。1 (true) または 0 (false) として指定します。特定のボタングループ内で一度に選択できるボタンは 1 つのみです。既定では、ボタングループに最初に追加されたラジオボタンの状態が 1 です。同じボタングループに追加された後続ボタンの既定の状態は 0 です。

RadioButton の Value プロパティが 1 に変更されるときに、その前に選択されていた RadioButton の Value プロパティは 0 に変更されます。さらに、親 ButtonGroup の SelectedObject プロパティ値が更新されます。

プログラムにより RadioButton の Value プロパティを 0 に変更した場合、MATLAB^® は ButtonGroup に "追加された" 最初の RadioButton の Value プロパティを 1 に設定します。追加した最初の RadioButton の Value プロパティがプログラムにより 0 に設定されている場合、MATLAB は、ButtonGroup に 2 番目に追加された RadioButton の Value プロパティを 1 に設定します。

メモ

ButtonGroup に最初に "追加" された RadioButton が、ButtonGroup の Children プロパティの最初に "リスト" される RadioButton とは限りません。

`Text` — ボタンラベル
`'Radio Button'` (既定値) | 文字ベクトル | 文字ベクトルの cell 配列 | string スカラー | string 配列 | ...

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

`Interpreter` — ボタンテキストのインタープリター
`'none'` (既定値) | `'tex'` | `'latex'` | `'html'`

ボタンテキストのインタープリター。次のいずれかとして指定します。

'none' — リテラル文字を表示します。
'tex' — TeX マークアップのサブセットを使用してテキストを解釈します。
'latex' — LaTeX マークアップのサブセットを使用してテキストを解釈します。
'html' — HTML マークアップのサブセットを使用してテキストを解釈します。

TeX マークアップ

TeX マークアップを使用して、上付き文字や下付き文字の追加、テキストへの特殊文字の挿入を行うことができます。

修飾子の効果はテキストの末尾まで適用されます。上付き文字と下付き文字は例外であり、次の 1 文字または中かっこで囲まれた文字にのみ適用されます。インタープリターを 'tex' に設定した場合にサポートされる修飾子は次のとおりです。

修飾子	説明	例
`^{ }`	上付き文字	`'text^{superscript}'`
`_{ }`	下付き文字	`'text_{subscript}'`
`\bf`	太字フォント	`'\bf text'`
`\it`	イタリックフォント	`'\it text'`
`\sl`	斜体フォント (通常はイタリックフォントと同じ)	`'\sl text'`
`\rm`	標準フォント	`'\rm text'`
`\fontname{specifier}`	フォント名 — `specifier` をフォントファミリの名前に置き換えます。これは他の修飾子と組み合わせて使用できます。	`'\fontname{Courier} text'`
`\fontsize{specifier}`	フォントサイズ — `specifier` をポイント単位の数値スカラーに置き換えます。	`'\fontsize{15} text'`
`\color{specifier}`	フォントの色 — `specifier` を、`red`、`green`、`yellow`、`magenta`、`blue`、`black`、`white`、`gray`、`darkGreen`、`orange`、`lightBlue` の色のいずれかに置き換えます。	`'\color{magenta} text'`
`\color[rgb]{specifier}`	フォントのカスタムの色 — `specifier` を RGB 3 成分に置き換えます。	`'\color[rgb]{0,0.5,0.5} text'`

次の表に、'tex' インタープリターでサポートされる特殊文字を示します。

文字列	記号	文字列	記号	文字列	記号
`\alpha`	α	`\upsilon`	υ	`\sim`	~
`\angle`	∠	`\phi`	ϕ	`\leq`	≤
`\ast`	`*`	`\chi`	χ	`\infty`	∞
`\beta`	β	`\psi`	ψ	`\clubsuit`	♣
`\gamma`	γ	`\omega`	ω	`\diamondsuit`	♦
`\delta`	δ	`\Gamma`	Γ	`\heartsuit`	♥
`\epsilon`	ϵ	`\Delta`	Δ	`\spadesuit`	♠
`\zeta`	ζ	`\Theta`	Θ	`\leftrightarrow`	↔
`\eta`	η	`\Lambda`	Λ	`\leftarrow`	←
`\theta`	θ	`\Xi`	Ξ	`\Leftarrow`	⇐
`\vartheta`	ϑ	`\Pi`	Π	`\uparrow`	↑
`\iota`	ι	`\Sigma`	Σ	`\rightarrow`	→
`\kappa`	κ	`\Upsilon`	ϒ	`\Rightarrow`	⇒
`\lambda`	λ	`\Phi`	Φ	`\downarrow`	↓
`\mu`	µ	`\Psi`	Ψ	`\circ`	º
`\nu`	ν	`\Omega`	Ω	`\pm`	±
`\xi`	ξ	`\forall`	∀	`\geq`	≥
`\pi`	π	`\exists`	∃	`\propto`	∝
`\rho`	ρ	`\ni`	∍	`\partial`	∂
`\sigma`	σ	`\cong`	≅	`\bullet`	•
`\varsigma`	ς	`\approx`	≈	`\div`	÷
`\tau`	τ	`\Re`	ℜ	`\neq`	≠
`\equiv`	≡	`\oplus`	⊕	`\aleph`	ℵ
`\Im`	ℑ	`\cup`	∪	`\wp`	℘
`\otimes`	⊗	`\subseteq`	⊆	`\oslash`	∅
`\cap`	∩	`\in`	∈	`\supseteq`	⊇
`\supset`	⊃	`\lceil`	⌈	`\subset`	⊂
`\int`	∫	`\cdot`	·	`\o`	ο
`\rfloor`	⌋	`\neg`	¬	`\nabla`	∇
`\lfloor`	⌊	`\times`	x	`\ldots`	...
`\perp`	⊥	`\surd`	√	`\prime`	´
`\wedge`	∧	`\varpi`	ϖ	`\0`	∅
`\rceil`	⌉	`\rangle`	〉	`\mid`	\|
`\vee`	∨	`\langle`	〈	`\copyright`	©

LaTeX マークアップ

LaTeX マークアップを使用するには、インタープリターを 'latex' に設定します。LaTeX マークアップを使用して、数式、方程式、特殊文字を書式設定して表示します。ドル記号を使用してマークアップテキストを囲みます。たとえば、インラインモードでは '$\int_1^{20} x^2 dx$'、表示モードでは '$$\int_1^{20} x^2 dx$$' を使用します。

テキストは LaTeX の既定のフォントスタイルで表示され、FontName、FontWeight、FontAngle のプロパティは無視されます。フォントスタイルを変更するには、LaTeX マークアップを使用します。

MATLAB では、大半の標準の LaTeX 数式モードコマンドがサポートされています。詳細については、サポートされる LaTeX コマンドを参照してください。

HTML マークアップ

HTML マークアップを使用するには、インタープリターを 'html' に設定します。HTML を使用したフォントスタイルの設定は、等価なフォントプロパティをオーバーライドします。たとえば、次のコードは赤いテキストのラジオボタンを作成します。

fig = uifigure;
bg = uibuttongroup(fig);
rb = uiradiobutton(bg,"Interpreter","html");
rb.Text = '<p style="color: red;">Text</p>';
rb.FontColor = "blue";

インタープリターは HTML マークアップのサブセットをサポートします。一般的なガイドラインとして、インタープリターはテキスト関連のタグとスタイルをサポートします。サポートされないタグとスタイルは無視されます。

次の表に、サポートされる要素と要素の属性を一覧します。

HTML 要素	属性	説明
`a`	`style`, `target`, `href`, `title`	ハイパーリンク
`abbr`	`style`, `title`	略語または頭字語
`address`	`style`	連絡先情報
`article`	`style`	自己完結した単独のコンテンツ
`aside`	`style`	主な内容に間接的に関連するコンテンツ
`b`	`style`	太字フォント
`bdi`	`style`, `dir`	周囲のテキストとは異なる方向で書式設定されるコンテンツ
`bdo`	`style`, `dir`	周囲のテキストとは異なる方向で書式設定されるコンテンツ
`big`	`style`	周囲のテキストよりフォントサイズが 1 レベル大きいテキスト (HTML5 では旧式)
`blockquote`	`style`, `cite`	拡張された引用
`br`	N/A	改行
`caption`	`style`	テーブルのキャプションまたはタイトル
`center`	`style`	水平方向に中央揃えされたコンテンツ
`cite`	`style`	参照先のタイトル
`code`	`style`	コードのフラグメント
`col`	`style`, `align`, `valign`, `span`, `width`	テーブル内の列
`colgroup`	`style`, `align`, `valign`, `span`, `width`	テーブル内の列のグループ
`dd`	`style`	説明リストの用語または値
`del`	`style`, `datetime`	ドキュメントから削除されたテキスト
`details`	`style`, `open`	'開いた' 状態に切り替えた場合にのみテキストが表示される対話型ウィジェット
`dl`	`style`	説明リスト
`dt`	`style`	説明リストの用語または値
`em`	`style`	強調表示されるテキスト (通常、イタリックで表示)
`font`	`style`, `color`, `size`, `face`	指定したフォントプロパティのテキスト (HTML5 では旧式)
`footer`	`style`	フッター
`h1`. `h2`, `h3`, `h4`, `h5`, `h6`	`style`	セクション見出し — `<h1>` が見出しの最上位、`<h6>` が最下位
`header`	`style`	導入コンテンツ
`hr`	`style`	主題の区切り
`i`	`style`	周囲のコンテンツからのテキストオフセット — 既定の設定ではイタリックとしてレンダリングされる
`ins`	`style`, `datetime`	ドキュメントに挿入されたテキスト
`li`	`style`	リスト内の項目
`mark`	`style`	マークアップテキストまたは強調表示されたテキスト
`ol`	`style`	順序付きリスト
`p`	`style`	段落
`pre`	`style`	書式設定済みテキスト
`s`	`style`	取り消し線付きのテキスト
`strike`	`style`	取り消し線付きのテキスト (HTML5 では旧式)
`section`	`style`	独立したセクション
`small`	`style`	周囲のテキストよりフォントサイズが 1 レベル小さいテキスト (HTML5 では旧式)
`sub`	`style`	下付き文字
`sup`	`style`	上付き文字
`strong`	`style`	重要度が高いテキスト
`table`	`style`, `width`, `border`, `align`, `valign`	テーブル
`tbody`	`style`, `align`, `valign`	テーブル本体
`td`	`style`, `width`, `rowspan`, `colspan`, `align`, `valign`	テーブルデータセル
`tfoot`	`style`, `align`, `valign`	テーブル列をまとめる一連のテーブル行
`th`	`style`, `width`, `rowspan`, `colspan`, `align`, `valign`	セルのグループのヘッダーとして指定されたテーブルデータセル
`thead`	`style`, `align`, `valign`	列見出しを指定する一連のテーブル行
`tr`	`style`, `rowspan`, `align`, `valign`	テーブルセルの行
`tt`	`style`	固定幅テキスト (HTML5 では旧式)
`u`	`style`	非言語的注釈を使用するテキスト — 既定の設定では下線としてレンダリングされる
`ul`	`style`	順序なしリスト

これらの要素の詳細については、https://developer.mozilla.org/en-US/docs/Web/HTML/Elementを参照してください。

MATLAB コードを実行するハイパーリンクを作成するために HTML マークアップを使用するには、関数を実行するハイパーリンクの作成を参照してください。

HTML スタイル属性を使用して HTML コンテンツを書式設定できます。スタイル属性は CSS 属性とその値の文字列です。

以下の CSS 属性がサポートされています。

background-color
border-bottom
border-bottom-color
border-bottom-left-radius
border-bottom-right-radius
border-bottom-style
border-bottom-width
border-left
border-left-color
border-left-style
border-left-width
border-radius
border-right
border-right-color
border-right-style
border-right-width
border-spacing
border-style
border-top
border-top-color
border-top-left-radius
border-top-right-radius
border-top-style
border-top-width
border-width
color
direction
font-family
font-size
font-style
font-weight
height
hidden
line-height
margin
margin-bottom
margin-left
margin-right
margin-top
max-height
max-width
min-height
min-width
overflow
overflow-wrap
overflow-x
overflow-y
padding
padding-bottom
padding-left
padding-right
padding-top
text-align
text-anchor
text-decoration
text-indent
text-overflow
text-shadow
text-transform
title
translate
white-space
width

これらの属性の詳細については、https://developer.mozilla.org/en-US/docs/Web/CSS/Referenceを参照してください。

`WordWrap` — コンポーネントの幅に合わせるための右端での折り返し
`'off'` (既定値) | on/off logical 値

コンポーネントの幅に合わせるための右端での折り返し。'off' または 'on'、もしくは数値または logical 0 (false) または 1 (true) として指定します。'off' の値は false と等価であり、'on' は true と等価です。したがって、このプロパティの値を logical 値として使用できます。値は matlab.lang.OnOffSwitchState 型の on/off logical 値として格納されます。

このプロパティを使用して、表示するテキストよりコンポーネントの幅が小さい場合に水平方向に切り捨てられないようにします。

'off' — テキストは右端で折り返しされません。
'on' — テキストを新しい行に折り返して、各行がコンポーネントの幅に収まるようにし、単語が区切られないようにします (可能な場合)。

WordWrap プロパティを 'on' に設定しても、コンポーネントの高さがテキストのすべての行を表示するには小さすぎる場合には、テキストが垂直方向に切り捨てられるのを回避できません。

フォント

すべて展開する

`FontName` — フォント名
システムでサポートされているフォントの名前

フォント名。システムでサポートされているフォント名として指定します。既定のフォントは、特定のオペレーティングシステムとロケールによって異なります。

指定したフォントが利用できない場合、MATLAB は、アプリが実行中のシステムで利用可能なフォントから最もよく一致するフォントを使用します。

例: 'Arial'

`FontSize` — フォントサイズ
正の数値

フォントサイズ。正の数値として指定します。測定単位はピクセルです。既定のフォントサイズは、特定のオペレーティングシステムとロケールによって異なります。

例: 14

`FontWeight` — フォントの太さ
`'normal'` (既定値) | `'bold'`

フォントの太さ。次のいずれかの値として指定します。

'normal' — 各フォントで定義されている既定の太さ
'bold' — 'normal' よりも太い文字

すべてのフォントに太字フォントがあるとは限りません。太字がないフォントの場合、'bold' を指定すると標準フォントの太さになります。

`FontAngle` — フォントの角度
`'normal'` (既定値) | `'italic'`

フォントの角度。'normal' または 'italic' として指定します。すべてのフォントにイタリックのフォントの角度があるわけではありません。イタリックがないフォントの場合、'italic' を指定すると標準フォントの角度になります。

`FontColor` — フォントの色
`[0 0 0]` (既定値) | 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"`

対話機能

すべて展開する

`Visible` — 可視性の状態
`'on'` (既定値) | on/off logical 値

可視性の状態。'on' または 'off'、もしくは数値または logical 1 (true) または 0 (false) として指定します。'on' の値は true と等価であり、'off' は false と等価です。したがって、このプロパティの値を logical 値として使用できます。値は matlab.lang.OnOffSwitchState 型の on/off logical 値として格納されます。

'on' — オブジェクトを表示します。
'off' — オブジェクトを削除せずに非表示にします。非表示の UI コンポーネントのプロパティには引き続きアクセスできます。

アプリの起動を高速化するには、起動時に表示する必要のないすべての UI コンポーネントの Visible プロパティを 'off' に設定します。

`Enable` — ボタンの操作可能状態
`'on'` (既定値) | on/off logical 値

ボタンの操作可能状態。'on' または 'off'、もしくは数値または logical 1 (true) または 0 (false) として指定します。'on' の値は true と等価であり、'off' は false と等価です。したがって、このプロパティの値を logical 値として使用できます。値は matlab.lang.OnOffSwitchState 型の on/off logical 値として格納されます。

このプロパティを 'on' に設定した場合、ボタンの外観は、アプリユーザーがボタンを操作できることを示します。
このプロパティを 'off' に設定した場合、ボタンはグレー表示され、アプリユーザーが操作できないことを示します。

`Tooltip` — ツールヒント
`''` (既定値) | 文字ベクトル | 文字ベクトルの cell 配列 | string 配列 | 1 次元の categorical 配列

ツールヒント。文字ベクトル、文字ベクトルの cell 配列、string 配列、または 1 次元の categorical 配列として指定します。このプロパティを使用して、実行時にユーザーがポインターをコンポーネントに合わせるとメッセージが表示されるようにします。コンポーネントが無効になっている場合でも、ツールヒントは表示されます。複数行のテキストを表示するには、文字ベクトルの cell 配列または string 配列を指定します。配列の各要素は、テキストの各行になります。このプロパティを categorical 配列として指定した場合、MATLAB はカテゴリの完全なセットではなく、配列内の値を使用します。

`ContextMenu` — コンテキストメニュー
空の `GraphicsPlaceholder` 配列 (既定値) | `ContextMenu` オブジェクト

コンテキストメニュー。関数 uicontextmenu を使用して作成された ContextMenu オブジェクトとして指定します。このプロパティは、コンポーネントを右クリックしたときにコンテキストメニューを表示するために使用します。

位置

すべて展開する

`Position` — ラジオボタンの位置とサイズ
`[10 10 91 22]` (既定値) | `[left bottom width height]`

ラジオボタンの位置とサイズ。[left bottom width height] の形式のベクトルとして指定します。次の表で、ベクトルの各要素について説明します。

要素	説明
`left`	ボタングループの内側左端からラジオボタンの外側左端までの距離
`bottom`	ボタングループの内側下端からラジオボタンの外側下端までの距離
`width`	ラジオボタン (テキストを含む) の外側の右端と左端の間の距離
`height`	ラジオボタンの外側の上端と下端の間の距離

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

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

`InnerPosition` — ラジオボタンの位置とサイズ
`[10 10 91 22]` (既定値) | `[left bottom width height]`

ラジオボタンの位置とサイズ。[left bottom width height] の形式の 4 要素ベクトルとして指定します。すべての測定単位はピクセルです。このプロパティ値は、Position プロパティと同一です。

`OuterPosition` — ラジオボタンの位置とサイズ
`[10 10 91 22]` (既定値) | `[left bottom width height]`

このプロパティは読み取り専用です。

ラジオボタンの位置とサイズ。[left bottom width height] の形式の 4 要素ベクトルとして返されます。すべての測定単位はピクセルです。このプロパティ値は、Position プロパティと同一です。

コールバック

すべて展開する

`CreateFcn` — 作成関数
`''` (既定値) | 関数ハンドル | cell 配列 | 文字ベクトル

オブジェクト作成関数。次の値のいずれかとして指定します。

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

コールバックを関数ハンドル、cell 配列、または文字ベクトルとして指定する方法の詳細については、App Designer のコールバックを参照してください。

このプロパティは、MATLAB がオブジェクトを作成するときに実行されるコールバック関数を指定します。MATLAB は CreateFcn コールバックを実行する前に、すべてのプロパティ値を初期化します。CreateFcn プロパティを指定しない場合、MATLAB は既定の作成関数を実行します。

既存のコンポーネントに CreateFcn プロパティを設定しても効果はありません。

このプロパティを関数ハンドルまたは cell 配列として指定した場合、コールバック関数の最初の引数を使用して、作成中のオブジェクトにアクセスできます。それ以外の場合は、関数 gcbo を使用してオブジェクトにアクセスします。

`DeleteFcn` — 削除関数
`''` (既定値) | 関数ハンドル | cell 配列 | 文字ベクトル

オブジェクト削除関数。次の値のいずれかとして指定します。

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

このプロパティは、MATLAB がオブジェクトを削除するときに実行されるコールバック関数を指定します。MATLAB は、オブジェクトのプロパティを破棄する前に DeleteFcn コールバックを実行します。DeleteFcn プロパティを指定しない場合、MATLAB は既定の削除関数を実行します。

このプロパティを関数ハンドルまたは cell 配列として指定した場合、コールバック関数の最初の引数を使用して、削除されるオブジェクトにアクセスできます。それ以外の場合は、関数 gcbo を使用してオブジェクトにアクセスします。

コールバック実行制御

すべて展開する

`Interruptible` — コールバックの割り込み
`'on'` (既定値) | on/off logical 値

コールバックの割り込み。'on' または 'off'、もしくは数値または logical 1 (true) または 0 (false) として指定します。'on' の値は true と等価であり、'off' は false と等価です。したがって、このプロパティの値を logical 値として使用できます。値は matlab.lang.OnOffSwitchState 型の on/off logical 値として格納されます。

このプロパティは実行中のコールバックが割り込み可能かどうかを決定します。次の 2 つのコールバックの状態について考慮する必要があります。

"実行中" コールバックは、現在実行しているコールバックです。
"割り込み" コールバックは、実行中のコールバックに割り込もうとするコールバックです。

MATLAB は、コールバックキューを処理するコマンドを実行するたびにコールバックの割り込み動作を判別します。これらのコマンドには、drawnow、figure、uifigure、getframe、waitfor、pause があります。

実行中コールバックにこれらのコマンドが含まれていない場合、割り込みは発生しません。MATLAB は、実行中コールバックの実行を先に終了させ、その後に割り込みコールバックを実行します。

実行中コールバックにこれらのいずれかのコマンドが含まれている場合、実行中コールバックを所有するオブジェクトの Interruptible プロパティに応じて割り込みが発生するかどうかが決まります。

Interruptible の値が 'off' の場合、割り込みは発生しません。代わりに、割り込みコールバックを所有するオブジェクトの BusyAction プロパティに応じて、割り込みコールバックが破棄されるかコールバックキューに追加されるかが決まります。
Interruptible の値が 'on' の場合、割り込みが発生します。MATLAB は、コールバックキューの次回処理時に、実行中コールバックの実行を停止し、割り込みコールバックを実行します。割り込みコールバックが完了した後、MATLAB は実行中だったコールバックの実行を再開します。

メモ

コールバックの割り込みと実行は、以下の状況では動作が異なります。

割り込みコールバックが DeleteFcn、CloseRequestFcn または SizeChangedFcn コールバックの場合、Interruptible プロパティの値にかかわらず割り込みが発生します。
実行中のコールバックが関数 waitfor を現在実行している場合、Interruptible プロパティの値にかかわらず割り込みが発生します。
割り込みコールバックが Timer オブジェクトで所有されている場合、Interruptible プロパティの値にかかわらずスケジュールに従ってコールバックが実行されます。

メモ

MATLAB は、割り込みが発生したときにプロパティの状態や表示を保存しません。たとえば、gca コマンドや gcf コマンドから返されたオブジェクトは、別のコールバックを実行するときに変更されている可能性があります。

`BusyAction` — コールバックキューイング
`'queue'` (既定値) | `'cancel'`

コールバックキューイング。'queue' または 'cancel' として指定します。BusyAction プロパティは MATLAB による割り込みコールバックの実行の処理方法を決定します。次の 2 つのコールバックの状態について考慮する必要があります。

"実行中" コールバックは、現在実行しているコールバックです。
"割り込み" コールバックは、実行中のコールバックに割り込もうとするコールバックです。

BusyAction プロパティによってコールバックキューイングの動作が決まるのは、次の両方の条件を満たす場合のみです。

実行中コールバックに drawnow、figure、uifigure、getframe、waitfor、pause などのコールバックキューを処理するコマンドが含まれている。
実行中コールバックを所有するオブジェクトの Interruptible プロパティの値が 'off' である。

これらの条件に当てはまる場合、割り込みコールバックを所有するオブジェクトの BusyAction プロパティに応じて MATLAB による割り込みコールバックの処理方法が決まります。BusyAction プロパティは次の値を取ることができます。

'queue' — 割り込みコールバックをキューに入れ、実行中のコールバックが終了した後に処理されるようにします。
'cancel' — 割り込みコールバックを実行しません。

`BeingDeleted` — 削除状態
on/off logical 値

このプロパティは読み取り専用です。

削除状態。matlab.lang.OnOffSwitchState 型の on/off logical 値として返されます。

MATLAB は、DeleteFcn コールバックが実行を開始すると、BeingDeleted プロパティを 'on' に設定します。コンポーネントオブジェクトが存在しなくなるまで BeingDeleted プロパティは 'on' に設定されたままです。

クエリや変更の前にオブジェクトが削除されようとしていないか確認するために BeingDeleted プロパティの値をチェックします。

親/子

すべて展開する

`Parent` — 親コンテナー
`ButtonGroup` オブジェクト

親コンテナー。ButtonGroup オブジェクトとして指定します。ButtonGroup は、関数 uifigure を使用して作成された Figure 内になければなりません。

`HandleVisibility` — オブジェクトハンドルの可視性
`'on'` (既定値) | `'callback'` | `'off'`

オブジェクトハンドルの可視性。'on'、'callback' または 'off' として指定します。

このプロパティは、オブジェクトの親がもつ子のリストにおけるそのオブジェクトの可視性を制御します。オブジェクトがその親オブジェクトのリストで、子として可視できない場合、オブジェクト階層の検索またはプロパティのクエリによってオブジェクトを取得する関数は、そのオブジェクトを返しません。これらの関数には、get、findobj、clf および close が含まれます。オブジェクトは参照できない場合も有効です。オブジェクトにアクセスできる場合は、そのプロパティを設定および取得して、それをオブジェクトに作用する任意の関数に渡すことができます。

HandleVisibility の値	説明
`'on'`	オブジェクトは常に参照できます。
`'callback'`	オブジェクトはコールバック内から、あるいはコールバックにより呼び出される関数から参照できます。しかし、コマンドラインから呼び出される関数からは参照できません。このオプションを使用すると、コマンドラインからのオブジェクトへのアクセスがブロックされますが、コールバック関数からのアクセスは許可されます。
`'off'`	オブジェクトは常に参照できません。このオプションは、他の関数による UI の意図しない変更を防止するために役立ちます。`HandleVisibility` を `'off'` に設定すると、その関数の実行中にオブジェクトが一時的に非表示になります。

識別子

すべて展開する

`Type` — グラフィックスオブジェクトのタイプ
`'uiradiobutton'`

このプロパティは読み取り専用です。

グラフィックスオブジェクトのタイプ。'uiradiobutton' として返されます。

`Tag` — オブジェクト識別子
`''` (既定値) | 文字ベクトル | string スカラー

オブジェクト識別子。文字ベクトルまたは string スカラーとして指定します。オブジェクトの識別子として機能する一意の Tag 値を指定できます。コードの他の部分からオブジェクトにアクセスする必要がある場合、関数 findobj を使用して Tag 値に基づいてオブジェクトを検索できます。

`UserData` — ユーザーデータ
`[]` (既定値) | 配列

ユーザーデータ。任意の MATLAB 配列として指定します。たとえば、スカラー、ベクトル、行列、cell 配列、文字配列、table、または構造体を指定できます。このプロパティを使用して、任意のデータをオブジェクトに保存します。

App Designer を使用している場合は、UserData プロパティを使用する代わりに、アプリでパブリックプロパティまたはプライベートプロパティを作成してデータを共有します。詳細については、App Designer アプリ内でのデータの共有を参照してください。

バージョン履歴

R2016a で導入

すべて展開する

R2024a: テキストでの HTML マークアップの指定と方程式の表示

テキストマークアップを有効にするには Interpreter プロパティを設定します。インタープリターを "html"、"latex"、"tex"、または "none" として指定します。インタープリターの指定は、App Designer のアプリと関数 uifigure で作成された Figure でのみサポートされます。

R2020b: ボタンのテキストの折り返し

表示するテキストより UI コンポーネントの幅が小さい場合に、テキストが水平方向に切り捨てられないようにするには、WordWrap プロパティを使用します。WordWrap プロパティを 'on' に設定すると、各行がコンポーネントに収まるようにテキストが新しい行に折り返されます。可能な限り、単語の途中での改行はされません。プロパティが 'off' に設定されている場合、テキストは折り返されません。

RadioButton のプロパティ

ボタン

Value — ラジオ ボタンの状態 1 | 0

Text — ボタン ラベル 'Radio Button' (既定値) | 文字ベクトル | 文字ベクトルの cell 配列 | string スカラー | string 配列 | ...

Interpreter — ボタン テキストのインタープリター 'none' (既定値) | 'tex' | 'latex' | 'html'

TeX マークアップ

LaTeX マークアップ

HTML マークアップ

WordWrap — コンポーネントの幅に合わせるための右端での折り返し 'off' (既定値) | on/off logical 値

フォント

FontName — フォント名 システムでサポートされているフォントの名前

FontSize — フォント サイズ 正の数値

FontWeight — フォントの太さ 'normal' (既定値) | 'bold'

FontAngle — フォントの角度 'normal' (既定値) | 'italic'

FontColor — フォントの色 [0 0 0] (既定値) | RGB 3 成分 | 16 進数カラー コード | 'r' | 'g' | 'b' | ...

対話機能

Visible — 可視性の状態 'on' (既定値) | on/off logical 値

Enable — ボタンの操作可能状態 'on' (既定値) | on/off logical 値

Tooltip — ツールヒント '' (既定値) | 文字ベクトル | 文字ベクトルの cell 配列 | string 配列 | 1 次元の categorical 配列

ContextMenu — コンテキスト メニュー 空の GraphicsPlaceholder 配列 (既定値) | ContextMenu オブジェクト

位置

Position — ラジオ ボタンの位置とサイズ [10 10 91 22] (既定値) | [left bottom width height]

InnerPosition — ラジオ ボタンの位置とサイズ [10 10 91 22] (既定値) | [left bottom width height]

OuterPosition — ラジオ ボタンの位置とサイズ [10 10 91 22] (既定値) | [left bottom width height]

コールバック

CreateFcn — 作成関数 '' (既定値) | 関数ハンドル | cell 配列 | 文字ベクトル

DeleteFcn — 削除関数 '' (既定値) | 関数ハンドル | cell 配列 | 文字ベクトル

コールバック実行制御

Interruptible — コールバックの割り込み 'on' (既定値) | on/off logical 値

BusyAction — コールバック キューイング 'queue' (既定値) | 'cancel'

BeingDeleted — 削除状態 on/off logical 値

親/子

Parent — 親コンテナー ButtonGroup オブジェクト

HandleVisibility — オブジェクト ハンドルの可視性 'on' (既定値) | 'callback' | 'off'

識別子

Type — グラフィックス オブジェクトのタイプ 'uiradiobutton'

Tag — オブジェクト識別子 '' (既定値) | 文字ベクトル | string スカラー

UserData — ユーザー データ [] (既定値) | 配列

バージョン履歴

R2024a: テキストでの HTML マークアップの指定と方程式の表示

R2020b: ボタンのテキストの折り返し

参考

関数

ツール

`Value` — ラジオボタンの状態
`1` | `0`

`Text` — ボタンラベル
`'Radio Button'` (既定値) | 文字ベクトル | 文字ベクトルの cell 配列 | string スカラー | string 配列 | ...

`Interpreter` — ボタンテキストのインタープリター
`'none'` (既定値) | `'tex'` | `'latex'` | `'html'`

`WordWrap` — コンポーネントの幅に合わせるための右端での折り返し
`'off'` (既定値) | on/off logical 値

`FontName` — フォント名
システムでサポートされているフォントの名前

`FontSize` — フォントサイズ
正の数値

`FontWeight` — フォントの太さ
`'normal'` (既定値) | `'bold'`

`FontAngle` — フォントの角度
`'normal'` (既定値) | `'italic'`

`FontColor` — フォントの色
`[0 0 0]` (既定値) | RGB 3 成分 | 16 進数カラーコード | `'r'` | `'g'` | `'b'` | ...

`Visible` — 可視性の状態
`'on'` (既定値) | on/off logical 値

`Enable` — ボタンの操作可能状態
`'on'` (既定値) | on/off logical 値

`Tooltip` — ツールヒント
`''` (既定値) | 文字ベクトル | 文字ベクトルの cell 配列 | string 配列 | 1 次元の categorical 配列

`ContextMenu` — コンテキストメニュー
空の `GraphicsPlaceholder` 配列 (既定値) | `ContextMenu` オブジェクト

`Position` — ラジオボタンの位置とサイズ
`[10 10 91 22]` (既定値) | `[left bottom width height]`

`InnerPosition` — ラジオボタンの位置とサイズ
`[10 10 91 22]` (既定値) | `[left bottom width height]`

`OuterPosition` — ラジオボタンの位置とサイズ
`[10 10 91 22]` (既定値) | `[left bottom width height]`

`CreateFcn` — 作成関数
`''` (既定値) | 関数ハンドル | cell 配列 | 文字ベクトル

`DeleteFcn` — 削除関数
`''` (既定値) | 関数ハンドル | cell 配列 | 文字ベクトル

`Interruptible` — コールバックの割り込み
`'on'` (既定値) | on/off logical 値

`BusyAction` — コールバックキューイング
`'queue'` (既定値) | `'cancel'`

`BeingDeleted` — 削除状態
on/off logical 値

`Parent` — 親コンテナー
`ButtonGroup` オブジェクト

`HandleVisibility` — オブジェクトハンドルの可視性
`'on'` (既定値) | `'callback'` | `'off'`

`Type` — グラフィックスオブジェクトのタイプ
`'uiradiobutton'`

`Tag` — オブジェクト識別子
`''` (既定値) | 文字ベクトル | string スカラー

`UserData` — ユーザーデータ
`[]` (既定値) | 配列