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

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

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

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

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

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

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

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

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

例:'icon.png'は、MATLAB パス上のアイコン ファイルを指定します。

例:'C:\Documents\icon.png'は、イメージ ファイルへの絶対パスを指定します。

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

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

例:'Arial'

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

例:14

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

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

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

フォントの色。RGB 3 成分、16 進数カラー コードまたは表にリストされたオプションのいずれかとして指定します。

RGB 3 成分および 16 進数カラー コードは、カスタム色を指定するのに役立ちます。

あるいは、名前を使用して一部の一般的な色を指定できます。次の表に、名前の付いた色オプション、等価の RGB 3 成分、および 16 進数カラー コードを示します。

MATLAB の多くのタイプのプロットで使用されている既定の色の RGB 3 成分および 16 進数カラー コードを次に示します。

背景色。RGB 3 成分、16 進数カラー コード、または表にリストされた色オプションのいずれかとして指定します。

RGB 3 成分および 16 進数カラー コードは、カスタム色を指定するのに役立ちます。

あるいは、名前を使用して一部の一般的な色を指定できます。次の表に、名前の付いた色オプション、等価の RGB 3 成分、および 16 進数カラー コードを示します。

MATLAB の多くのタイプのプロットで使用されている既定の色の RGB 3 成分および 16 進数カラー コードを次に示します。

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

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

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

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

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

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

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

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

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

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

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

アイコンとテキストの水平方向の配置。'center'、'left'または'right'として指定します。この水平方向の配置は、ボタンの境界線内の領域を基準とした相対位置です。テキストがボタンの幅全体を占める場合、このプロパティを設定しても UI の外観には影響しません。

アイコンとテキストの垂直方向の配置。'center'、'top'または'bottom'として指定します。この垂直方向の配置は、ボタンの境界線内の領域を基準とした相対位置です。テキストの高さがボタンの高さ全体を占める場合、このプロパティを設定しても UI の外観には影響しません。

ボタンのテキストを基準にしたアイコンの位置。'left'、'right'、'top'または'bottom'として指定します。Textプロパティが空の場合、アイコンではIconAlignmentプロパティではなくHorizontalAlignmentプロパティとVerticalAlignmentプロパティが使用されます。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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