マスクハンドラー

回路図エディタと回路図APIで使用できるマスクハンドラ関数の説明

マスクハンドラーは、マスクレベルで定義できる関数であり、特定のイベントで呼び出されます。表1は、コンポーネントマスクで使用できるマスクハンドラーの概要を示しています。

1マスクハンドラー
ハンドラー名 説明
初期化
  • モデルの読み込み中、およびコンポーネントが回路図に追加されたときに呼び出されます。
  • コンポーネントを初期化するために使用されます。
  • プロパティ ハンドラーで使用できる関数を定義するために使用できます。
  • サブシステムの内部コンポーネントからアクセスできる変数を定義するために使用できます。
  • パラメータ:
    • mdl - 回路図 API オブジェクト。
    • item_handle - マスク ハンドル オブジェクト。
プリコンパイル
  • モデルのコンパイル中に、コンポーネント/マスク プロパティのハード評価 (エラーが報告される) が実行されるときに呼び出されます。
  • コンポーネント/マスク プロパティの検証を実行するために使用されます。
  • サブシステムの場合、内部コンポーネントからアクセスできる変数を使用して名前空間を更新するためにも使用できます。
  • 端末信号のタイプまたは寸法に依存するプロパティは、まだ解決されていない可能性があります。
  • パラメータ:
    • mdl - 回路図 API オブジェクト。
    • item_handle - マスク ハンドル オブジェクト。
post_resolve
  • 端末信号のタイプと次元が解決された後、モデルのコンパイル中に呼び出されます。
  • コンポーネント/マスク プロパティの検証を実行するために使用されます。
  • この時点ですべてのプロパティの値が解決されます。
  • パラメータ:
    • mdl - 回路図 API オブジェクト。
    • item_handle - マスク ハンドル オブジェクト。
定義アイコン
  • 端末信号のタイプと次元が解決された後、モデルのコンパイル中に呼び出されます。
  • コンポーネント/マスク プロパティの検証を実行するために使用されます。
  • この時点ですべてのプロパティの値が解決されます。
  • パラメータ:
    • mdl - 回路図 API オブジェクト。
    • item_handle - マスク ハンドル オブジェクト。
モデルがロードされました
  • モデルが正常にロードされた後に呼び出されます。
  • パラメータ:
    • mdl - 回路図 API オブジェクト。
    • item_handle - マスク ハンドル オブジェクト。
post_c_code_export
  • C コードのエクスポート アクションが正常に実行された後に呼び出されます。
  • パラメータ:
    • mdl - 回路図 API オブジェクト。
    • item_handle - マスク ハンドル オブジェクト。
名前が変更されました
  • コンポーネントの名前が変更された後に呼び出されます。
  • パラメータ:
    • mdl - 回路図 API オブジェクト。
    • item_handle - マスク ハンドル オブジェクト。
事前コピー
  • コンポーネントがコピーされる前に呼び出されます。
  • サブシステムをコピーすると、このハンドラーは、ハンドルが定義されている内部のすべてのコンポーネントに対して (トップダウン方式で) 呼び出されます。
  • このハンドラーは、Schematc Editor の UI のコンテキスト内で厳密に実行されます。
  • パラメータ:
    • mdl - 回路図 API オブジェクト。
    • item_handle - マスク ハンドル オブジェクト。
投稿コピー
  • コンポーネントがコピーされた後に呼び出されます。
  • サブシステムをコピーすると、このハンドラーは、ハンドルが定義されている内部のすべてのコンポーネントに対して (トップダウン方式で) 呼び出されます。
  • このハンドラーは、Schematc Editor の UI のコンテキスト内で厳密に実行されます。
  • パラメータ:
    • mdl - 回路図 API オブジェクト。
    • item_handle - マスク ハンドル オブジェクト。
事前検証
  • コンパイルの開始時、 model_initハンドラーとコンポーネント/マスク プロパティのソフト評価 (エラーは報告されない) の後に呼び出されます。
  • 検証用にコンポーネントを準備するために使用されます。
  • このハンドラーの一部のプロパティにはまだ未解決の値が残っている可能性があります。
  • パラメータ:
    • mdl - 回路図 API オブジェクト。
    • item_handle - マスク ハンドル オブジェクト。
事前削除
  • コンポーネントが削除される前に呼び出されます。
  • サブシステムを削除すると、内部のコンポーネントに対してこのハンドラーは呼び出されません。
  • パラメータ:
    • mdl - 回路図 API オブジェクト。
    • item_handle - マスク ハンドル オブジェクト。
投稿を削除
  • pre_delete がエラーで終了しない限り、コンポーネントが削除された後に呼び出されます。
  • サブシステムを削除すると、内部のコンポーネントに対してこのハンドラーは呼び出されません。
  • パラメータ:
    • mdl - 回路図 API オブジェクト。
    • item_handle - マスク ハンドル オブジェクト。
変更前
  • デフォルトのコンポーネント プロパティ ダイアログで [OK] ボタンが押された後に呼び出されます。
  • 通常、ユーザー入力を検証するために使用されます。
  • パラメータ:
    • mdl - 回路図 API オブジェクト。
    • item_handle - マスク ハンドル オブジェクト。
    • prop_entered_values - プロパティごとの現在のユーザー入力の辞書。
開ける
  • コンポーネントがダブルクリックされたときに呼び出されます。
  • このハンドラーを変更すると、コンポーネントをダブルクリックしてもデフォルトのコンポーネント プロパティ ダイアログが表示されなくなります。
  • 通常、カスタム Qt ダイアログを定義するために使用されます。
  • パラメータ:
    • mdl - 回路図 API オブジェクト。
    • item_handle - マスク ハンドル オブジェクト。
on_dialog_open
  • コンポーネントがダブルクリックされ、デフォルトのコンポーネント プロパティ ダイアログが表示されるときに呼び出されます。
  • 通常、初期プロパティ表示状態を構成するために使用されます。
  • パラメータ:
    • mdl - 回路図 API オブジェクト。
    • item_handle - マスク ハンドル オブジェクト。
ダイアログを閉じる
  • デフォルトのコンポーネント プロパティ ダイアログがユーザーによって閉じられたときに呼び出されます。
  • 終了理由に応じてコードを実行するために使用されます。
  • パラメータ:
    • mdl - 回路図 API オブジェクト。
    • item_handle - マスク ハンドル オブジェクト。
    • 理由 - ダイアログが閉じられた理由(文字列形式):
      • "reason_close_ok" - ユーザーが OK ボタンをクリックしました。

      • 「reason_close_cancel」 - ユーザーが「キャンセル」または「閉じる」ボタンをクリックしました。