マスクコールバックコード

マスクコードの追加

MATLAB^® コードを使用して、マスクの初期化およびマスクアイコンの描画ができます。コードの場所がモデルのパフォーマンスに影響を与えるため、必要とする機能を反映する場所にコードを追加してください。

目的	マスクエディターでの追加場所	プログラム上の指定
マスクの初期化	[初期化] ペイン	`MaskInitialization` パラメーター
マスクアイコンの描画	[アイコン] ペイン	`MaskDisplay` パラメーター
マスクパラメーターのコールバックコード	[パラメーターとダイアログ] ペイン	`MaskCallbacks` パラメーター

描画コマンドの実行

マスクアイコンを描画する MATLAB コードを、[アイコン] ペインの [アイコンを描画するコマンド] セクション内に配置します。Simulink^® は、以下の場合に、それらのコマンドを順次実行してマスクアイコンを再描画します。

ブロックが最初にマスクエディターのキャンバスにレンダリングされる場合
描画コマンドに依存するマスクパラメーターや値が変更された場合
ブロックの外観が、回転やその他の変更によって変更された場合

メモ

マスクアイコンを描画する MATLAB コードを [初期化] セクションに配置した場合、モデルのパフォーマンスに影響します。これは、モデルでマスクブロックが評価されるたびに Simulink でアイコンが再描画されるためです。

初期化コマンドの実行

モデル内のすべてのマスクブロック用の初期化コマンドは、以下の場合に実行されます。

ブロック線図を更新する
シミュレーションを開始する
コード生成を開始するとき
マスクの変更を適用するとき
マスクエディターまたは set_param を使用して、MaskDisplay や MaskInitialization などのマスクを定義するパラメーターのいずれかを変更するとき。
アイコンが初期化コマンドに依存する場合に、マスクブロックを回転または反転させるとき。
アイコンを描画または再描画する際に、そのアイコン描画が初期化コードに依存するとき。
ブロックのダイアログボックスまたは set_param を使用してマスクパラメーターの値を変更するとき。

モデルを開くと、Simulink は、そのモデルの最上位または開いているサブシステムに存在している可視状態のマスクブロックを見つけます。

Simulink は、これらの可視状態のマスクブロックに対してのみ、以下のいずれかの条件が満たされた上で初期化コマンドを実行します。

マスク設定されたブロックに、アイコン描画コマンドがある。

メモ
Simulink は、モデルの読み込み時にマスクブロックに初期化コマンドがあっても、アイコン描画コマンドがないと初期化しません。
マスクサブシステムがライブラリに属しており、[ライブラリブロックで内容を変更することを許可] パラメーターが有効になっている。

モデルをグラフィックスとして表示しないでメモリに読み込む場合は、マスクブロックに対して最初に実行される初期化コマンドはありません。モデルを表示しない読み込みの詳細は、モデルの読み込みおよび load_system を参照してください。

メモ

モデルが既にコンパイルされている場合 (初期化済み)、マスクブロックの調整不可のパラメーターは評価されません。

コールバックコードの実行

マスクパラメーターのコールバックコードはベースワークスペースではなく一時ワークスペースで実行されます。コールバックで作成された変数を後で使用しなければならない場合 (コールバック処理中ではなく)、これらの変数を明示的にベースワークスペースに割り当てなければなりません。

Simulink は以下の場合にコールバックコマンドを実行します。

マスクダイアログボックスを開くとき。コールバックコマンドは、最上位マスクのダイアログボックスから順番に実行されます。
マスクダイアログボックスでパラメーターの値を変更し、カーソルの位置を変更したとき。たとえば、パラメーターの値を変更してから Tab キーを押すかダイアログボックスの別のフィールドをクリックしたとき。
set_param コマンドを使用してパラメーター値を変更すると、コールバックコマンドが実行されます。
マスクダイアログボックスまたは set_param を使用してパラメーター値を変更し、[適用] または [OK] をクリックしてその変更内容を適用するとき。コールバックコマンドの後にマスク初期化コマンドが実行されます。詳細については、[コード] ペインを参照してください。
マスクブロック上にカーソルを合わせてそのブロックのツールヒントを表示する場合に、そのツールヒントにパラメーター名および値が含まれているとき。

メモ
コールバックコマンドは、ブロックのツールヒントが表示されるときにマスクダイアログボックスが開いている場合は実行されません。
Ctrl+D キーを押すか、Simulink エディターの [モデル化] タブで [モデルの更新] をクリックすることで、ブロック線図を更新するとき。
変更を保存せずにマスクダイアログボックスを閉じた場合、パラメーターのコールバックコマンドが順番に実行されます。

メモ

マスクダイアログボックスのボタンは、ボタンに関連付けられたコールバックコードの実行中は使用できません。