このページの内容は最新ではありません。最新版の英語を参照するには、ここをクリックします。
Push Button
ボタンを使用してパラメーターまたは変数の値を変更
ライブラリ:
Simulink /
Dashboard
説明
Push Button ブロックを使用して、シミュレーション前またはシミュレーション中に、接続された変数またはパラメーターの値を変更します。ボタンを押している間のみに値が変更されるように、またはボタンをもう一度クリックするまで値の変更がラッチされるようにボタンを設定できます。Push Button ブロックを他の Dashboard ブロックと共に使用して、モデルを制御する対話型のダッシュボードを作成します。
Push Button ブロックをダブルクリックしても、シミュレーション中やブロックが選択されているときは、そのダイアログ ボックスは開きません。ブロック パラメーターを編集する場合は、[プロパティ インスペクター] を使用するか、次のようにブロック ダイアログ ボックスを開くことができます。
ブロックが選択されておらず、モデルのシミュレーションが行われていないときに、ブロックをダブルクリックする。
ブロックを右クリックし、コンテキスト メニューから [ブロック パラメーター] を選択する。
Push Button のアイコン
ボタンのテキストと一緒に表示されるアイコンを Push Button ブロックに追加できます。基本形状、自動車関連のインジケーター、ワイヤレス アイコンを含む事前定義されたセットからアイコンを選択できます。または、独自のカスタム アイコンをアップロードできます。組み込みアイコンの完全なリストを含む詳細については、アイコン参照してください。
Push Button ブロックにアイコンを追加するときに、ブロックの状態に応じて色が変わるようにアイコンのオンの色とオフの色を設定し、ボタンのテキストを基準にしたアイコンの配置を指定できます。たとえば、この Push Button ブロックは、オンの色が明るい緑色に指定され、ボタンのテキストの左側に配置されている円形のアイコンを使用するように設定されています。
Push Button ブロックのアイコンの設定を使用して、モデル内でのブロックの外観を設定できます。ブロックの外観をさらにカスタマイズする場合は、Customizable Blocks ライブラリの Push Button ブロックを使用することを検討してください。Customizable Blocks ライブラリの Push Button ブロックは、カスタム アイコンの追加をサポートしますが、組み込みアイコンを含みません。
Dashboard ブロックの接続
Dashboard ブロックはモデル要素への接続に端子を使用しません。Dashboard ブロックを変数やブロック パラメーターに接続するには、接続モードを使用します。接続モードを使用すると、モデル内で Dashboard ブロックを接続するプロセスが簡単になり、特に複数のブロックを一度に接続する場合に便利です。Dashboard ブロックを 1 つ接続するには、ブロック ダイアログ ボックスの [接続] テーブルを使用することもできます。
ヒント
ノーマル モードとアクセラレータ モードのシミュレーション中にモデルで Dashboard ブロックの接続を変更できます。
メモ
Dashboard ブロックは、モデル ブロック線図を更新するまで変数に接続できません。Dashboard ブロックを変数に接続するか、モデルを開いてシミュレーションを実行するまでの間に変数の値を変更するには、Ctrl + D キーを使用してモデル ブロック線図を更新します。
接続モードに切り替えるには、接続する Dashboard ブロックをキャンバスで選択します。Simulink® ツールストリップに、選択したブロックのタイプの名前が付いたタブが表示されます。ブロックのタブで [接続] をクリックします。接続モードでは、ブロックを 1 つ以上選択すると、接続に使用できるパラメーターと変数のリストが表示されます。選択した Dashboard ブロックに接続する変数またはパラメーターをリストから選択します。
選択した変数またはブロック パラメーターの値が非スカラーである場合は、[接続] テーブルの下部にあるテキスト ボックスを使用して、Dashboard ブロックに接続する要素を指定します。ベクトル、行列、または配列の要素に接続するには、3 または (1,3) のように、要素のインデックスを指定します。バスまたは構造体の要素に接続するには、ドットを使用して階層内の各レベルを示し、最上位レベルは省略して、バスまたは構造体階層のコンテキストで要素を指定します。たとえば、選択した複合変数またはパラメーター内に入れ子にされている構造体またはバス a のスカラー要素 b に接続するには a.b と指定します。
別の Dashboard ブロックを接続するには、別の Dashboard ブロックで一時停止し、その上に表示される [接続] ボタンをクリックします。次に、モデル内で信号およびブロックを選択し、接続するモデル要素を選択します。
モデルで Dashboard ブロックの接続が完了したら、[ブロック] タブで [接続完了] をクリックします。
ヒント
ShowInitialText ブロック パラメーターをもつ関数 set_param を使用して、接続されていないブロックに表示されるメッセージを非表示にできます。ブロックを接続すると、メッセージも表示されなくなります。
パラメーターのログ記録
Dashboard ブロックに接続されている調整可能なパラメーターはシミュレーション データ インスペクターに記録されます。シミュレーション データ インスペクターでは、記録された信号データと共にパラメーター値を表示できます。UI を使用して、または関数Simulink.sdi.exportRunを使用して、シミュレーション データ インスペクターからパラメーター データをエクスポートすることで、MATLAB® ワークスペースでログ記録されたパラメーター データにアクセスできます。シミュレーション データ インスペクターの UI を使用したデータのエクスポートの詳細については、ワークスペースまたはファイルへのデータのエクスポートを参照してください。パラメーター データは Simulink.SimulationData.Parameter オブジェクトに格納され、エクスポートされた Simulink.SimulationData.Dataset の要素としてアクセスできます。
制限
Dashboard Scope ブロックおよび Display ブロックを除き、Dashboard ブロックは実数のスカラー信号にのみ接続できます。
ツールストリップは、パネル内にあるブロックをサポートしません。
コメントアウトされたブロックには、ブロック ダイアログの [接続] テーブルを使用して Dashboard ブロックを接続することはできません。コメント化されたブロックに接続モードを使用して Dashboard ブロックを接続した場合、ブロックのコメントを解除するまでは Dashboard ブロックに接続された値が表示されません。
Dashboard ブロックは参照モデル内のモデル要素には接続できません。
モデルの階層構造をシミュレーションすると、参照モデル内の Dashboard ブロックで更新は実行されません。
Dashboard ブロックは、ラピッド アクセラレータ シミュレーションをサポートしていません。
シミュレーション中に Dashboard ブロックを変数またはパラメーターに接続すると、その変数またはパラメーターのデータはシミュレーション データ インスペクターに記録されません。シミュレーション データ インスペクターに変数とパラメーターのデータを記録するには、シミュレーションを実行する前に Dashboard ブロックを変数またはパラメーターに接続します。
[既定のパラメーター動作] を [インライン] に設定してエクスターナル モードでモデルをシミュレーションするときに、Dashboard ブロックがパラメーターと変数の値を変更するように見える場合があります。ただし、その変更はシミュレーションに伝播されません。たとえば、Gain ブロックには Dashboard ブロックを使用して [ゲイン] パラメーターに加えられた変更が表示されますが、シミュレーションで使用された [ゲイン] 値は変更されません。
パラメーター
接続
接続 — 接続する変数またはブロック パラメーターを選択
変数およびパラメーターの接続オプション
[接続] テーブルを使用して、制御する変数またはブロック パラメーターを選択します。ブロックを信号に接続するには、次のようにします。
1 つ以上のブロックを含むモデルで選択を行います。
接続する変数またはパラメーターを選択します。
選択した変数またはブロック パラメーターの値が非スカラーである場合は、[接続] テーブルの下部にあるテキスト ボックスを使用して、Dashboard ブロックに接続する要素を指定します。ベクトル、行列、または配列の要素に接続するには、
3または(1,3)のように、要素のインデックスを指定します。バスまたは構造体の要素に接続するには、ドットを使用して階層内の各レベルを示し、最上位レベルは省略して、バスまたは構造体階層のコンテキストで要素を指定します。たとえば、選択した複合変数またはパラメーター内に入れ子にされている構造体またはバスaのスカラー要素bに接続するにはa.bと指定します。[適用] をクリックします。
モデルの理解とデバッグを容易にするために、シミュレーション中に Dashboard ブロックをモデルの変数とパラメーターに接続することができます。
メモ
[接続] テーブル内のワークスペース変数を確認するには、Ctrl+D を使用してモデル ブロック線図を更新します。
プログラムでの使用
Dashboard ブロックを調整可能なパラメーターまたは変数にプログラムによって接続するには、Simulink.HMI.ParamSourceInfo オブジェクトを使用します。Simulink.HMI.ParamSourceInfo オブジェクトには 4 つのプロパティが含まれます。このプロパティの一部は、Dashboard ブロックのパラメーターへの接続に適用され、一部は Dashboard ブロックの変数への接続に適用されます。特定の Dashboard ブロックは、パラメーターまたは変数のいずれかに接続しているため、一部のフィールドには接続に関する値が設定されていません。
ブロック パラメーター: Binding |
型: Simulink.HMI.ParamSourceInfo |
既定の設定: [] |
メイン
ボタンのテキスト — ボタンのテキスト ラベル
Button (既定値) | string | 文字ベクトル
モデル内の Push Button ブロックに表示されるテキスト。
ヒント
ブロックの状態に応じて異なるテキストを表示するボタンを設計するには、Customizable Blocks ライブラリの Push Button ブロックを使用します。
プログラムでの使用
ブロック パラメーター: ButtonText |
| 型: string または文字配列 |
既定の設定: 'Button' |
オンの値 — ボタンが押されたとき、またはラッチされたときに、接続されているパラメーターに割り当てられる値
1 (既定値) | スカラー
ボタンが押されたとき、またはラッチされたときに、接続されているブロック パラメーターに割り当てられる値。
ヒント
[ブロック タイプ] パラメーターを使用して、クリックに対するブロックの対応を設定します。
モーメンタリ—ボタンを押している間のみ [オンの値] が適用されます。ラッチ— ボタンをクリックしたときに状態の変更がラッチされ、もう一度クリックするまで [オンの値] が適用されます。
プログラムでの使用
ブロック パラメーター: OnValue |
| 型: string または文字配列 |
既定の設定: '1' |
ボタン タイプ — クリックに対するボタンの応答
モーメンタリ (既定値) | ラッチ
クリックに対するボタンの応答を指定します。
モーメンタリ—ボタンを押している間のみ [オンの値] が適用されます。ラッチ— ボタンをクリックしたときに状態の変更がラッチされ、もう一度クリックするまで [オンの値] が適用されます。
プログラムでの使用
ブロック パラメーター: ButtonType |
| 型: string または文字配列 |
値: 'Momentary' | 'Latch' |
ラベル — ブロック ラベルの位置
Hide (既定値) | Bottom | Top
ブロック ラベルの位置。ブロックがモデル内の要素に接続されている場合、ラベルは接続された要素の名前です。
プログラムでの使用
ブロック パラメーター: LabelPosition |
| 型: 文字ベクトル |
値: 'Hide' | 'Bottom' | 'Top' |
既定の設定: 'Hide' |
書式設定
不透明度 — ブロックの背景の不透明度
1 (既定値) | スカラー
ブロックの背景の不透明度。0 ～ 1 のスカラー値として指定します。
例: 0.5
プログラムでの使用
ブロック パラメーター: Opacity |
| タイプ: スカラー |
既定の設定: 1 |
前景色 — ブロックの前景色
[r g b] ベクトル
テキストを含むブロックの前景色。標準色のパレットから色を選択するか、カスタムの色を指定できます。
プログラムでの使用
ブロックの ForegroundColor パラメーターを値が 0 から 1 の間の 1 行 3 列の [r g b] ベクトルを定義する string または文字ベクトルとして指定します。
ブロック パラメーター: ForegroundColor |
| 型: 文字ベクトル | string |
値: [r g b] ベクトル |
背景色 — 背景色
[r g b] ベクトル
背景色。標準色のパレットから色を選択するか、カスタムの色を指定できます。
プログラムでの使用
ブロックの BackgroundColor パラメーターを値が 0 から 1 の間の 1 行 3 列の [r g b] ベクトルを定義する string または文字ベクトルとして指定します。
ブロック パラメーター: BackgroundColor |
| 型: 文字ベクトル | string |
値: [r g b] ベクトル |
アイコン
アイコン — ボタンに表示されるアイコン
SVG ファイル | PNG ファイル | JPEG ファイル
ボタンのテキストと一緒にまたはボタンのテキストの代わりに表示されるアイコンを Push Button ブロックに追加できます。形状、自動車関連、ワイヤレスの組み込みアイコンから選択できます。または、独自のカスタム SVG ファイル、PNG ファイル、JPEG ファイルをアップロードしてアイコンとして使用できます。
アイコン オプションを表示するには、ブロック ダイアログ ボックスの [アイコン] タブで [アイコン タイプ] を選択します。独自のカスタム アイコンを使用するには、[カスタム] を [アイコン タイプ] として選択し、イメージ ファイルをアップロードします。
アイコンを追加する場合、以下のパラメーターを使用してアイコンの外観を設定できます。
アイコン配置 — ボタンのテキストを基準としたアイコンの配置
オンの色 — ブロックが押されるかラッチされ、[オンの値] が接続されているパラメーターに適用されているときのアイコンの色
オフの色 — ブロックが押されていないまたはラッチされていない状態で、[オンの値] が接続されているパラメーターに適用されていないときのアイコンの色
アイコンの [オンの色] と [オフの色] を指定するには、[アイコンの色をカスタマイズ] を選択しなければなりません。
形状アイコン
| アイコン | 基本形状のライブラリ ブロック名 | プログラムで使用する値 |
|---|---|---|
|
| Check1 | Check1 |
|
| Check2 | Check2 |
|
| Check3 | Check3 |
|
| Check4 | Check4 |
|
| Circle | Circle |
|
| Ex1 | Ex1 |
|
| Ex2 | Ex2 |
|
| Ex3 | Ex3 |
|
| Ex4 | Ex4 |
|
| Face | Face |
|
| Frown1 | Frown1 |
|
| Frown2 | Frown2 |
|
| Hexagon | Hexagon |
|
| Pentagon | Pentagon |
|
| Rectangle | Rectangle |
|
| Smile1 | Smile1 |
|
| Smile2 | Smile2 |
|
| Solid Face | SolidFace |
|
| Solid Frown1 | SolidFrown1 |
|
| Solid Frown2 | SolidFrown2 |
|
| Solid Smile1 | SolidSmile1 |
|
| Solid Smile2 | SolidSmile2 |
|
| Square | Square |
|
| Triangle | Triangle |
自動車関連アイコン
| アイコン | 自動車関連のインジケーター ランプのライブラリ ブロック名 | プログラムで使用する値 |
|---|---|---|
|
| Adaptive Cruise Control | AdaptiveCruiseControl |
|
| Adaptive Cruise Control Failure | AdaptiveCruiseControlFailure |
|
| Antilock Brake System | AntilockBrakeSystem |
|
| Battery | Battery |
|
| Check Engine | CheckEngine |
|
| Check Engine2 | CheckEngine2 |
|
| Cruise Control | CruiseControl |
|
| Eco Mode | EcoMode |
|
| Electronic Stability | ElectronicStability |
|
| Engine | Engine |
|
| Engine Coolant Temp | EngineCoolantTemp |
|
| Engine Failure | EngineFailure |
|
| Engine Heating | EngineHeating |
|
| Engine Oil | EngineOil |
|
| Exterior Bulb Failure | ExteriorBulbFailure |
|
| Front Fog Light | FrontFogLight |
|
| Fuel | Fuel |
|
| Hazards | Hazards |
|
| Headlamp Leveling | HeadlampLeveling |
|
| High Beams | HighBeams |
|
| Hill Descent Control | HillDescentControl |
|
| Lighting Switch | LightingSwitch |
|
| Low Beams | LowBeams |
|
| Parking Assistance | ParkingAssistance |
|
| Rear Fog Light | RearFogLight |
|
| Side Lights | SideLights |
|
| Stability Control | StabilityControl |
|
| Stability Control Off | StabilityControlOff |
|
| Tire Monitor | TireMonitor |
|
| Traction Control | TractionControl |
|
| Traction Control Off | TractionControlOff |
|
| Traction Control Failure | TractionControlFailure |
|
| Turn Signal Left | TurnSignalLeft |
|
| Turn Signal Right | TurnSignalRight |
ワイヤレス アイコン
| アイコン | アイコン名 | プログラムで使用する値 |
|---|---|---|
|
| Network | Network |
|
| Network No Signal | NetworkNoSignal |
|
| Network Transmission | NetworkTransmission |
|
| Network3G | Network3G |
|
| Network4G | Network4G |
|
| Network5G | Network5G |
ヒント
ツールストリップ内の [ボタン] タブを使用して、Push Button ブロックのアイコンを変更できます。
Push Button ブロックの外観をさらにカスタマイズする場合は、Customizable Blocks ライブラリの Push Button ブロックを使用して、独自のボタンを設計することを検討してください。
Customizable Blocks ライブラリの Push Button ブロックは、カスタム アイコンの追加をサポートしますが、組み込みアイコンを含みません。
アイコンのオンの色とオフの色は、次の SVG 要素に適用できます。
altGlyphcircleellipsepathpolygonrecttexttextPathtreftspan
プログラムでの使用
ブロック パラメーター: Icon |
| 型: string | 文字ベクトル |
既定の設定: 'Default' |
アイコン配置 — ボタンのテキストを基準としたアイコンの配置
左 (既定値) | 右 | 上 | 下 | 中央
ボタンのテキストを基準としたアイコンの配置。ボタンのテキストを指定しないと、アイコンは常にブロックの中央に配置されます。
プログラムでの使用
ブロック パラメーター: IconAlignment |
| 型: string | 文字ベクトル |
値: 'Left' | 'Right' | 'Top' | 'Bottom' | 'Center' |
既定の設定: 'Left' |
アイコンの色をカスタマイズ — アイコンのオンの色とオフの色を使用するかどうか
オフ (既定値) | オン
Push Button ブロックにアイコンを追加するときに、ブロックの状態を反映してアイコンの色が変わるようにオンの色とオフの色を指定できます。アイコンの [オンの色] と [オフの色] を使用して指定するには、[アイコンの色をカスタマイズ] を選択します。
プログラムでの使用
ブロック パラメーター: IconColor |
| 型: string | 文字ベクトル |
値: 'On' | 'Off' |
既定の設定: 'Off' |
オンの色 — ブロックが押されるかラッチされたときのアイコンの色
[r g b] ベクトル
Push Button ブロックにアイコンを追加するときに、ブロックの状態を反映してアイコンの色が変わるようにオンの色とオフの色を指定できます。[オンの色] は、ブロックが押されるかラッチされ、[オンの値] が接続されているパラメーターに適用されているときのアイコンの色を指定します。標準色のパレットから色を選択するか、カスタムの色を指定できます。
依存関係
[オンの色] パラメーターを有効にするには、[アイコンの色をカスタマイズ] を選択します。
プログラムでの使用
ブロックの IconOnColor パラメーターを値が 0 から 1 の間の、1 行 3 列の [r g b] ベクトルとして指定します。
ブロック パラメーター: IconOnColor |
型: [r g b] ベクトル |
オフの色 — ブロックが押されていないまたはラッチされていないときのアイコンの色
[r g b] ベクトル
Push Button ブロックにアイコンを追加するときに、ブロックの状態を反映してアイコンの色が変わるようにオンの色とオフの色を指定できます。[オフの色] は、ブロックが押されていないまたはラッチされていない状態で、[オンの値] が接続されているパラメーターに適用されていないときのアイコンの色を指定します。標準色のパレットから色を選択するか、カスタムの色を指定できます。
依存関係
[オンの色] パラメーターを有効にするには、[アイコンの色をカスタマイズ] を選択します。
プログラムでの使用
ブロックの IconOffColor パラメーターを値が 0 から 1 の間の、1 行 3 列の [r g b] ベクトルとして指定します。
ブロック パラメーター: IconOffColor |
型: [r g b] ベクトル |
ブロックの特性
データ型 |
|
直達 |
|
多次元信号 |
|
可変サイズの信号 |
|
ゼロクロッシング検出 |
|
拡張機能
バージョン履歴
R2015a で導入R2023b: 新しいウィンドウでパネルを開く
R2023b 以降では、新しいウィンドウでダッシュボード パネルを開くことができます。そうするには、パネルを選択し、表示された省略記号の上にマウスをポイントします。展開されたアクション メニューで、[新規ウィンドウで開く] ボタン 
をクリックします。
モデル ウィンドウとは別個に、パネルを含む新しいウィンドウを最小化および復元できます。パネル ウィンドウで、シミュレーションの実行、一時停止、停止、およびステップ実行を行うことができます。パネル ウィンドウで、パネルおよびパネルに含まれているブロックを編集できます。
パネルをモデル キャンバスに戻すには、パネル ウィンドウ ツールストリップで [キャンバスで開く] 
をクリックします。
新しいウィンドウでパネルを開く操作の詳細については、Open Panels in New Windowを参照してください。
You can also select a web site from the following list:
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)