このページの内容は最新ではありません。最新版の英語を参照するには、ここをクリックします。

Callback Button

ボタンを使用した MATLAB コードの実行

• 

×

ライブラリ:
Simulink / Dashboard

説明

Callback Button ブロックは、クリックまたはボタンの押下に応答して MATLAB^® コードを実行します。ボタンを押すと、指定した時間範囲の経過後に、または指定した時間間隔でコードが実行されます。クリックと押下とで異なるコードを実行するようにブロックを構成できます。Customizable Blocks ライブラリの Callback Button ブロックを使用すると、実際のシステムにおけるボタンのようにブロックの外観をカスタマイズすることもできます。

バーチャル ボタンを押すには、Callback Button ブロックをクリックします。ポインターを押している間、ボタンが押されます。ポインターを離すと、ボタンが離されます。

コールバック関数を使ってボタンの動作を指定できます。

• 関数 PressFcns は、ボタンが押されている間実行されます。ボタンが押されている間に関数 PressFcn を 1 回だけ実行するようにボタンを構成するか、繰り返し間隔を指定できます。

• 関数 ClickFcns は、ボタンを離すと実行されます。

ポインターを離したときにボタンが押されたままになるように構成するには、[ボタン タイプ] を [ラッチ] に設定します。ラッチ ボタン タイプを選択すると、次のようになります。

• ボタンをラッチするには、ボタンをクリックします。

• ボタンのラッチを解除するには、ボタンをもう一度クリックします。

関数 PressFcn は、ボタンがラッチされている間実行されます。関数 ClickFcn は、ボタンをラッチすると 1 回実行され、ボタンのラッチを解除すると 1 回実行されます。

状態を使用して、ボタンの操作時に Callback Button ブロックの外観がどのように変化するかを指定できます。

• ボタンを押している間、ブロックは [押下] 状態になります。

• ボタンがラッチされているときにボタンを押さないと、ブロックは [ラッチ] 状態になります。

• ボタンがラッチされているときにボタンを押すと、ブロックは [ラッチかつ押下] 状態になります。

• これら 3 つのどの状態でもない場合、ブロックは [既定] 状態になります。

状態により、ポインター アクションが以下と組み合わされます。

• 状態ラベル

• 状態アイコン

• 状態イメージ

メモ

Callback Button ブロックをダブルクリックしても、シミュレーション中やブロックが選択されているときは、そのダイアログ ボックスは開きません。ブロック パラメーターを編集する場合は、[プロパティ インスペクター] を使用するか、次のようにブロック ダイアログ ボックスを開くことができます。

• ブロックが選択されておらず、モデルのシミュレーションが行われていないときに、ブロックをダブルクリックする

• ブロックを右クリックし、コンテキスト メニューから [ブロック パラメーター] を選択する

Callback Button ブロックのカスタマイズ

Callback Button ブロックをモデルに追加すると、既定の設計でブロックが事前構成されます。ブロックを既定の設計で使用することも、ブロックの外観をカスタマイズすることもできます。

ブロックの外観をカスタマイズするには、設計モードを使用します。ブロックを選択してから、次の 3 つのいずれかの方法で設計モードを開始できます。

• ブロック固有のタブの [設計] で、[編集] をクリックする。

• [プロパティ インスペクター] の [設計] タブで、[編集] をクリックする。

• ブロックの上で一時停止すると表示される省略記号で、[カスタム ブロックの編集] ボタンをクリックする。

Callback Button ブロックの設計時に、考えられる状態それぞれについてブロックの外観を構成します。[ブロック タイプ] を [モーメンタリ] に設定する場合、ブロックがもつ状態は 2 つです。[ブロック タイプ] を [ラッチ] に設定する場合、ブロックがもつ状態は 4 つです。

ブロックの上にあるツール バーを使用して、状態を切り替えることができます。各状態について、以下を行うことができます。

• 状態イメージをアップロードする。

• 状態アイコンをアップロードし、状態ラベルを基準としたアイコンの位置を指定する。

• 状態ラベルのテキスト、色、不透明度、および位置を指定する。

前景または背景イメージをアップロードするか、塗りつぶしの背景色を設定することもできます。前景と背景はすべての状態に適用されます。

ブロックの上にあるツール バーを使用して、イメージ、アイコン、状態ラベルの色と不透明度を構成します。

ブロックの設計を詳細に制御するには、プロパティ インスペクターの [設計] タブを使用します。設計の設定の正確な値を入力することができます。

[設計] タブは次の目的に使用します。

• 状態ラベルのテキストと位置を指定する。

• アイコンの位置を指定する。

• 前景イメージをアップロードする。

• 背景イメージをアップロードする。

• 塗りつぶしの背景色を設定する。

設計の編集が完了し、設計モードを終了するには、キャンバスの右上にある [X] をクリックします。

例

Callback Button ブロックを使用してモデルを初期化する

この例では、Callback Button ブロックを使用して、モデルで初期化ルーチンを実行する方法を示します。

モデルを開く

Callback Button ブロックでパラメーター値を制御する

この例では、ばねの両側に接続されている 2 つの質量で構成されるシステムの制御をモデル化します。

モデルを開く

パラメーター

プロパティ インスペクターと [ブロック パラメーター] ダイアログ ボックスを使用してブロック パラメーターの値を指定します。Dashboard ブロックのコア パラメーターを設定するには、[ブロック パラメーター] ダイアログ ボックスまたはプロパティ インスペクターの [パラメーター] タブを使用します。ブロックをカスタマイズするには、プロパティ インスペクターの [設計] タブを使用します。ブロックの [ブロック パラメーター] ダイアログ ボックスを開くには、ブロックをダブルクリックします。プロパティ インスペクターを開くには、[モデル化] タブの [設計] で [プロパティ インスペクター] を選択します。

パラメーター

Dashboard ブロックのコア パラメーターを設定するには、プロパティ インスペクターを開き、[パラメーター] タブをクリックします。

メイン

ボタン タイプ — クリックに対するボタンの応答

モーメンタリ (既定値) | ラッチ

クリックに対するブロックの応答を指定します。

• モーメンタリ — ボタンを押している間のみ状態が変化します。クリックを離すと、ボタンはその既定の状態に戻ります。

• ラッチ — ボタンをクリックしたときに状態の変更がラッチされます。もう一度クリックするまで、ボタンは押下状態のままになります。

[ボタン タイプ] を [モーメンタリ] に設定する場合、ブロックがもつ状態は次のとおりです。

• 既定 — ブロックが押されていないときの既定の状態

• 押下 — ブロックが押されているときのブロックの状態

[ボタン タイプ] を [ラッチ] に設定する場合、ブロックがもつ状態は次のとおりです。

• 既定 — ブロックが押されていないときの既定の状態。

• 押下 — [既定] 状態の間にボタンを押したときの移行状態。クリックを離すと、ブロックは [ラッチ] 状態に遷移します。

• ラッチ — ブロックが押されていないときのラッチ状態。

• ラッチかつ押下 — [ラッチ] 状態の間にボタンを押したときの移行状態。クリックを離すと、ブロックは [既定] 状態に遷移します。

プログラムでの使用

ブロック パラメーター: ButtonType

型: string または文字配列

値: 'Momentary' | 'Latch'

ボタンのテキスト — ボタンのラベル テキスト

'Callback Button' (既定値) | string | 文字配列

ボタン ラベルのテキストを指定します。ラベルは、[設計] タブの [状態] コンポーネントの [状態の選択] セクションで選択されている状態のボタンに適用されます。

プログラムでの使用

ブロックの ButtonText パラメーターを string または文字ベクトルとして指定します。

ブロック パラメーター: ButtonText

型: 文字ベクトル | string

縦横比をロック — ブロックの縦横比を維持するオプション

on (既定値) | off

Simulink^® キャンバスでブロックのサイズを変更するときに縦横比を維持する場合はこのパラメーターを選択します。

ヒント

• 縦横比がロックされている場合、新しい背景イメージを追加すると、背景イメージの縦横比に適合するようにブロックの縦横比が変更されます。

• 縦横比がロックされていない場合、新しい背景イメージを追加してもブロックの比率は変更されませんが、代わりにブロックのサイズに適合するように背景イメージが引き伸ばされたりスケーリングされたりします。

コールバック

ClickFcn — クリックに応答して実行される MATLAB コード

MATLAB コード

ボタンのクリックに応答して実行される MATLAB コード。

ボタンをクリックするたびに、クリックを離した時点で [ClickFcn] のコードが 1 回実行されます。

[ClickFcn] のコードを指定するには、ドロップダウン メニューから [ClickFcn] を選択します。メニューの下にあるテキスト ボックスにコードを入力します。

プログラムでの使用

ブロックの ClickFcn パラメーターを string または文字ベクトルとして書式設定された MATLAB コードとして指定します。

ブロック パラメーター: ClickFcn

型: 文字ベクトル | string

値: MATLAB コード

PressFcn — 押下に応答して実行される MATLAB コード

MATLAB コード

ボタンの押下に応答して実行される MATLAB コード。

ボタンが押された状態の間、[押下遅延] の時間の経過時、および [繰り返し間隔] ごとに定期的に [PressFcn] のコードが 1 回実行されます。

[PressFcn] のコードを指定するには、ドロップダウン メニューから [PressFcn] を選択します。メニューの下にあるテキスト ボックスにコードを入力します。

ボタンをどのように押すと [PressFcn] のコードが実行されるかは、[ボタン タイプ] によって決まります。

• [ボタン タイプ] が [モーメンタリ] の場合は、ボタンを押す時間にわたってクリックしたままにします。

• [ボタン タイプ] が [ラッチ] の場合は、ボタンをクリックして押しますが、クリックしたままにしません。もう一度クリックするまで、ボタンは押されたままになります。

メモ

ボタンをクリックするたびに、ボタンを押すプロセスの一環としてクリックした場合でも、クリックを離した時点で [ClickFcn] のコードが 1 回実行されます。

プログラムでの使用

ブロックの PressFcn パラメーターを string または文字ベクトルとして書式設定された MATLAB コードとして指定します。

ブロック パラメーター: PressFcn

型: 文字ベクトル | string

値: MATLAB コード

押下遅延 (ms) — ボタンを押したままにする時間

500 (既定値) | スカラー

[PressFcn] コードを実行させるために必要な時間。

依存関係

[押下遅延 (ms)] は [PressFcn] がコールバックとして選択されている場合にのみ表示されます。

プログラムでの使用

ブロックの PressDelay パラメーターを正のスカラー値として指定します。

ブロック パラメーター: PressDelay

タイプ: スカラー

繰り返し間隔 (ms) — PressFcn コードを繰り返す時間間隔

0 (既定値) | スカラー

Callback Button ブロックがまだ押されている場合に、[PressFcn] コードを再び実行した後の時間間隔。

依存関係

[繰り返し間隔 (ms)] は [PressFcn] がコールバックとして選択されている場合にのみ表示されます。

プログラムでの使用

ブロックの RepeatInterval パラメーターを正のスカラー値として指定します。

ブロック パラメーター: RepeatInterval

タイプ: スカラー

設計

Dashboard ブロックをカスタマイズするには、プロパティ インスペクターを開き、[設計] タブで [編集] をクリックします。

ボタン

縦横比をロック — ブロックの縦横比を維持するオプション

on (既定値) | off

Simulink キャンバスでブロックのサイズを変更するときに縦横比を維持する場合はこのパラメーターを選択します。

ヒント

• 縦横比がロックされている場合、新しい背景イメージを追加すると、背景イメージの縦横比に適合するようにブロックの縦横比が変更されます。

• 縦横比がロックされていない場合、新しい背景イメージを追加してもブロックの比率は変更されませんが、代わりにブロックのサイズに適合するように背景イメージが引き伸ばされたりスケーリングされたりします。

状態

状態の選択 — 設定する状態の選択

Default (既定値) | Pressed | Latched | Latched and Pressed

[状態] コンポーネントの [状態の選択] セクションのドロップダウン メニューから、設定する状態を選択します。[ボタン タイプ] が [モーメンタリ] の場合は、以下の状態を選択できます。

• 既定 — ブロックが押されていないときの既定の状態

• 押下 — ブロックが押されているときのブロックの状態

[ボタン タイプ] が [ラッチ] の場合は、以下の状態を選択できます。

• 既定 — ブロックが押されていないときの既定の状態。

• 押下 — [既定] 状態の間にボタンを押したときの移行状態。クリックを離すと、ブロックは [ラッチ] 状態に遷移します。

• ラッチ — ブロックが押されていないときのラッチ状態。

• ラッチかつ押下 — [ラッチ] 状態の間にボタンを押したときの移行状態。クリックを離すと、ブロックは [既定] 状態に遷移します。

メモ

状態については、[設計] タブの [状態] コンポーネントですべてのパラメーターを構成できます。たとえば、その状態のときにボタンに表示されるアイコンを選択できます。[状態] コンポーネントでいずれかのパラメーターを構成すると、変更内容は、[状態] コンポーネントの [状態の選択] セクションで選択されている状態に適用されます。

例: Pressed

ボタンのテキスト — ボタンのラベル テキスト

'Callback Button' (既定値) | string | 文字配列

ボタン ラベルのテキストを指定します。ラベルは、[設計] タブの [状態] コンポーネントの [状態の選択] セクションで選択されている状態のボタンに適用されます。

プログラムでの使用

ブロックの ButtonText パラメーターを string または文字ベクトルとして指定します。

ブロック パラメーター: ButtonText

型: 文字ベクトル | string

ラベルの色 — ラベルのフォントの色

[r g b] ベクトル

ラベル テキストのフォントの色を標準色のパレットから選択するか、カスタムの色を指定します。色は、[設計] タブの [状態] コンポーネントの [状態の選択] セクションで選択されている状態のラベル テキストに適用されます。

水平方向の配置 — 水平方向のボタン テキスト配置

Center (既定値) | Left | Right

ボタンのテキストの配置を設定します。

• Center:ブロックの左端と右端の中間

• Left:ブロックの左端

• Right:ブロックの右端

垂直方向の配置 — 垂直方向のボタン テキスト配置

Center (既定値) | Bottom | Top

ボタンのテキストの配置を設定します。

• Center:ブロックの上端と下端の中間

• Bottom:ブロックの下端

• Top:ブロックの上端

ラベル X オフセット — 選択した水平方向の配置設定における既定の位置からボタン テキストの中心までの水平方向のオフセット

0 (既定値) | スカラー

選択した [水平方向の配置] 設定における既定の位置からボタン テキストの中心までの水平方向のオフセットをブロックの幅の比率として指定します。オフセットが 0 のときのテキストの位置を基準に、負の値のオフセットではテキストが左に移動し、正の値のオフセットではテキストが右に移動します。

ラベル Y オフセット — 選択した垂直方向の配置設定における既定の位置からボタン テキストの中心までの垂直方向のオフセット

0 (既定値) | scalar

選択した [垂直方向の配置] 設定における既定の位置からボタン テキストの中心までの垂直方向のオフセットをブロックの高さの比率として指定します。オフセットが 0 のときのテキストの位置を基準に、負の値のオフセットではテキストが上に移動し、正の値のオフセットではテキストが下に移動します。

アイコンの配置 — ボタンのテキストを基準としたアイコンの配置

Left (既定値) | Top | Right | Bottom

ボタンのテキストを基準としたアイコンの配置を指定します。

メモ

アイコンの配置を変更するとボタンのテキストも移動しますが、テキストの指定した [X オフセット]、[Y オフセット]、[水平方向の配置]、または [垂直方向の配置] は変更されません。

幅 — イメージ幅

スカラー

イメージの幅をブロックの幅の比率として指定します。

例: 0.5

高さ — イメージ高

スカラー

イメージの高さをブロックの高さの比率として指定します。

例: 0.5

縦横比をロック — イメージの縦横比を維持するオプション

on (既定値) | off

プロパティ インスペクターを使用してイメージのサイズを変更するときに縦横比を維持する場合はこのオプションを有効にします。

イメージ X オフセット — ブロックの左端からイメージの左端までの水平方向のオフセット

スカラー

ブロックの左端からイメージの左端までの水平方向のオフセットをブロックの幅の比率として指定します。オフセットが 0 のときのイメージの位置を基準に、負の値のオフセットではイメージが左に移動し、正の値のオフセットではイメージが右に移動します。

例: 1

イメージ Y オフセット — ブロックの上端からイメージの上端までの垂直方向のオフセット

スカラー

ブロックの上端からイメージの上端までの垂直方向のオフセットをブロックの高さの比率として指定します。オフセットが 0 のときのイメージの位置を基準に、負の値のオフセットではイメージが上に移動し、正の値ではイメージが下に移動します。

例: 1

背景イメージ

背景色の使用 — ボタンの塗りつぶしの背景色を指定するオプション

on (既定値) | off

ブロックの背景イメージを提供するか、ボタンの塗りつぶしの背景色を選択できます。ボタンの塗りつぶしの背景色を選択するには、このパラメーターを選択します。ブロックの背景イメージを提供するには、このパラメーターをクリアします。

メモ

• ボタンの塗りつぶしの背景色を設定した場合、状態イメージは表示されません。状態イメージを表示するには、[背景色の使用] をオフにします。

• Simulink ツールストリップの [書式設定] タブを使用して背景色を変更すると、背景イメージが削除され、[背景色の使用] パラメーターがオンになります。

例: on

色 — ボタンの背景色

[r g b] ベクトル

ボタンの塗りつぶしの背景色を選択するには、[背景色の使用] パラメーターを有効にします。次に、背景色を標準色のパレットから選択するか、カスタムの色を指定します。

メモ

塗りつぶしの背景色を設定した場合、状態イメージは表示されません。状態イメージを表示するには、プロパティ インスペクターの [設計] タブの [背景イメージ] コンポーネントで、[背景色の使用] をオフにします。

ヒント

Simulink ツールストリップの [書式設定] タブで [背景色] を指定することもできます。

ブロックのテキストの色を指定するには、[フォントの色] パラメーターを使用します。

プログラムでの使用

ブロックの BackgroundColor パラメーターを値が 0 から 1 の間の string または文字ベクトルとして書式設定された 1 行 3 列の [r g b] ベクトルとして指定します。

ブロック パラメーター: BackgroundColor

型: 文字ベクトル | string

値: [r g b] ベクトル

不透明度 — ボタンの背景の不透明度

1 (既定値) | スカラー

塗りつぶしの背景色の不透明度を 0 ～ 1 のスカラー値として指定します。

例: 0.5

角の半径 — ボタンの背景色をもつ領域の角の半径

スカラー

塗りつぶしの背景色でカバーされる領域の角の半径を指定します。

例: 0.25

前景イメージ

イメージ X オフセット — ブロックの左端からイメージの左端までの水平方向のオフセット

スカラー

ブロックの左端からイメージの左端までの水平方向のオフセットをブロックの幅の比率として指定します。オフセットが 0 のときのイメージの位置を基準に、負の値のオフセットではイメージが左に移動し、正の値のオフセットではイメージが右に移動します。

例: 1

イメージ Y オフセット — ブロックの上端からイメージの上端までの垂直方向のオフセット

スカラー

ブロックの上端からイメージの上端までの垂直方向のオフセットをブロックの高さの比率として指定します。オフセットが 0 のときのイメージの位置を基準に、負の値のオフセットではイメージが上に移動し、正の値ではイメージが下に移動します。

例: 1

幅 — イメージ幅

スカラー

イメージの幅をブロックの幅の比率として指定します。

例: 0.5

高さ — イメージ高

スカラー

イメージの高さをブロックの高さの比率として指定します。

例: 0.5

縦横比をロック — イメージの縦横比を維持するオプション

on (既定値) | off

プロパティ インスペクターを使用してイメージのサイズを変更するときに縦横比を維持する場合はこのパラメーターを選択します。

ブロックの特性

データ型
直達	いいえ
多次元信号	いいえ
可変サイズの信号	いいえ
ゼロクロッシング検出	いいえ

ヒント

モデル内の変数またはパラメーターの値を変更するボタンを設計するには、Push Button ブロックを使用します。

拡張機能

C/C++ コード生成

Simulink® Coder™ を使用して C および C++ コードを生成します。

Dashboard ブロックはコード生成時に無視されます。

バージョン履歴

R2017b で導入

R2023b: 新しいウィンドウでパネルを開く

R2023b 以降では、新しいウィンドウでダッシュボード パネルを開くことができます。そうするには、パネルを選択し、表示された省略記号の上にマウスをポイントします。展開されたアクション メニューで、[新規ウィンドウで開く] ボタン をクリックします。

モデル ウィンドウとは別個に、パネルを含む新しいウィンドウを最小化および復元できます。パネル ウィンドウで、シミュレーションの実行、一時停止、停止、およびステップ実行を行うことができます。パネル ウィンドウで、パネルおよびパネルに含まれているブロックを編集できます。

パネルをモデル キャンバスに戻すには、パネル ウィンドウ ツールストリップで [キャンバスで開く] をクリックします。

新しいウィンドウでパネルを開く操作の詳細については、Open Panels in New Windowを参照してください。

R2023a: [パネル] タブを Simulink ツールストリップに固定

モデルにダッシュボード パネルを追加すると、Simulink ツールストリップに [パネル] タブが表示され、パネルの管理や編集のためのオプションが表示されます。

以前は、パネルが選択されているときしか [パネル] タブが表示されませんでした。R2023a 以降では、パネルが選択されていないときも [パネル] タブが表示されたままになります。

また、[パネル] タブに次の新しいオプションが追加されています。

• 空のパネルを追加できます。

• 選択したパネルの名前を変更できます。

• 選択したパネルを非表示にできます。

R2023a: Dashboard ライブラリと Customizable Blocks ライブラリの Callback Button ブロックで同じカスタマイズを使用

R2023a 以降では、Dashboard ライブラリの Callback Button ブロックは、Customizable Blocks ライブラリの Callback Button ブロックと同じカスタマイズ オプションを使用します。

R2022b: パネル内のカスタマイズ可能な Dashboard ブロックに対する元に戻す/やり直しのサポート

R2022b 以降では、パネル内にあるカスタマイズ可能な Dashboard ブロックに対する変更を元に戻したりやり直したりできます。

変更を元に戻すかやり直すには、次のようにします。

1. パネルまたはパネル内のブロックをクリックします。

2. 変更を元に戻すには Ctrl+Z を押し、変更をやり直すには Ctrl+Y を押します。

メモ

キーボード ショートカットは Windows^® に基づいています。Mac では、Ctrl ではなく command (⌘) を押します。

R2022b: ツールストリップにおけるパネルのサポート

R2022b 以降では、パネルやそれに含まれる Dashboard ブロックを Simulink ツールストリップを使用して管理および編集できます。

パネル内の Dashboard ブロックをクリックすると、ブロックのツールストリップ タブが表示されます。たとえば、Circular Gauge ブロックをクリックすると、[ゲージ] タブがツールストリップに表示されます。

パネルをクリックすると、[パネル] タブがツールストリップに表示されます。タブには次のオプションがあります。

• モデルのパネルの可視性を管理する。

• 非表示でないすべてのパネルを現在のビュー内に収める。

• 選択したパネルを折りたたむ。

• パネルのサイズや内容をカスタマイズする。

• 選択したパネルにカスタムの背景イメージを設定する。

• 選択したパネルに新しいタブを追加する。

R2020b: Simulink ツールストリップにおける Dashboard ブロックのサポート

R2020b 以降では、モデルで Simulink ライブラリの Dashboard ライブラリのブロックや Aerospace Blockset™ Flight Control Analysis ライブラリの Flight Instruments ライブラリのブロックを選択したときに、Simulink ツールストリップの [ブロック] タブがブロック固有のタブに変わります。ツールストリップから、選択したブロックを接続または切断したり、接続を変更したりできます。選択したブロックに接続されたモデル要素にジャンプしたり、選択したブロックをパネルに追加したりできます。

R2019a: Dashboard ブロックのプログラムによる追加と構成

R2019a 以降では、add_block や set_param などの関数を使用して Dashboard ライブラリのブロックをモデルで作成および構成できます。

参考

Push Button | Callback Button