IMathcadPrimeEvents2

API ガイド > IMathcadPrimeEvents2

IMathcadPrimeEvents2 は、PTC Mathcad Prime インストールディレクトリにある Ptc.MathcadPrime.Automation.dll で宣言されている COM イベントインタフェースです。クライアントアプリケーションは、このインタフェースを使用して PTC Mathcad Prime イベントを処理できます。これを行うには、InitializeEvents2 関数を使用して IMathcadPrimeEvents2 を実装するオブジェクトを登録します。

PTC Mathcad Prime では以下の COM イベントインタフェースを使用できます。

• IMathcadPrimeEvents (廃止)

• IMathcadPrimeEvents2 (IMathcadPrimeEvents を拡張し、それに優先)

PTC は、IMathcadPrimeEvents2 を使用することをお勧めします。廃止された IMathcadPrimeEvents インタフェースについては、この API ガイドには記載されていません。

IMathcadPrimeEvents2 では以下のイベントを使用できます。

    public interface IMathcadPrimeEvents2
    {
        void OnWorksheetSaved([In] string documentFullNameArg);

        void OnWorksheetClosed([In] string documentFullNameArg,
                               [In] string documentNameArg);

        void OnWorksheetModified([In] string documentFullNameArg,
                                 [In] string documentNameArg,
                                 [In] bool isModifiedArg);

        void OnWorksheetRenamed([In] string previousFullNameArg,
                                [In] string currentFullNameArg,
                                [In] string previousDocNameArg,
                                [In] string currentDocNameArg);

        void OnWorksheetInputsOutputsSelected([In] string documentFullNameArg,
                                              [In] string documentNameArg,
                                              [In] IMathcadPrimeInputs inputsArg,
                                              [In] IMathcadPrimeOutputs outputsArg);
        void OnExit();

        void OnWorksheetStatesGenerated([In] [MarshalAs(UnmanagedType.BStr)] string documentFullNameArg,
                                        [In] [MarshalAs(UnmanagedType.BStr)] string documentNameArg,
                                        [In] WorksheetOperations operationsArg,
                                        [In] [MarshalAs(UnmanagedType.Interface)] IMathcadPrimeInputsOutputsStates itemsStatesArg,
                                        [In] [MarshalAs(UnmanagedType.Interface)] IMathcadPrimeInputsOutputsConflicts conflictsArg);

        void OnWorksheetStatesGenerating([In] string documentFullNameArg,
                                         [In] string documentNameArg,
                                         [In] WorksheetOperations operationsArg,
                                         [In] IMathcadPrimeInputsOutputsStates itemsStatesArg,
                                         [In] IMathcadPrimeInputsOutputsConflicts conflictsArg);

        void OnWorksheetRequestToUpdateInputs([In] string documentFullNameArg,
                                              [In] string documentNameArg,
                                              [In] IMathcadPrimeValuesSetter setterArg);
   }

イベントの構文と引数

OnWorksheetSaved

ワークシートを保存したときに発生します。

Syntax

void OnWorksheetSaved([In] string documentFullNameArg);

Arguments

• documentFullNameArg - ワークシートの完全な名前とパス。

OnWorksheetClosed

ワークシートが閉じられたときに発生します。

Syntax

void OnWorksheetClosed([In] string documentFullNameArg,
[In] string documentNameArg);

Arguments

• documentFullNameArg - 閉じられたワークシートの完全な名前とパス。ワークシートが未保存の新規ドキュメントである場合、引数は null です。

• documentNameArg - ワークシート名。

OnWorksheetModified

ワークシートが修正されたときに発生します。

Syntax

void OnWorksheetModified([In] string documentFullNameArg,
[In] string documentNameArg,
[In] bool isModifiedArg);

Arguments

• documentFullNameArg - 修正されたワークシートの完全な名前とパス。ワークシートが未保存の新規ドキュメントである場合、引数は null です。

• documentNameArg - ワークシート名。

• isModifiedArg:

◦ True - ワークシートは修正済みとしてマークされています。

◦ False - ワークシートは未修正としてマークされています。

OnWorksheetRenamed

「名前を付けて保存」を使用してワークシートの名前が変更されたときに発生します。

Syntax

void OnWorksheetRenamed([In] string previousFullNameArg,
[In] string currentFullNameArg,
[In] string previousDocNameArg,
[In] string currentDocNameArg);

Arguments

• documentFullNameArg - 以前のワークシートの完全な名前とパス。

• documentNameArg - 現在のワークシートの完全な名前とパス。

• previousDocNameArg - 以前のワークシートの名前。

• currentDocNameArg - 現在のワークシートの名前。

OnWorksheetInputsOutputsSelected

ワークシートで入力と出力の両方またはどちらかが選択されたときに発生します。

Syntax

void OnWorksheetInputsOutputsSelected([In] string documentFullNameArg,
[In] string documentNameArg,
[In] IMathcadPrimeInputs inputsArg,
[In] IMathcadPrimeOutputs outputsArg);

Arguments

• documentFullNameArg - ワークシートの完全な名前とパス。ワークシートが未保存の新規ドキュメントである場合、引数は null です。

• documentNameArg - ワークシート名。

• inputsArg - 選択された入力のリスト。

• outputsArg - 選択された出力のリスト。

OnExit

PTC Mathcad Prime が別の COM クライアントによって、または COM 以外の方法で閉じられると発生します。

このイベントは、COM クライアントが IMathcadPrimeApplication3.Quit を使用して PTC Mathcad Prime を閉じるときには発生しません。

Syntax

void OnExit();

OnWorksheetStatesGenerated

状態の生成が完了すると発生します。

Syntax

void OnWorksheetStatesGenerated([In] [MarshalAs(UnmanagedType.BStr)] string documentFullNameArg,
[In] [MarshalAs(UnmanagedType.BStr)] string documentNameArg,
[In] WorksheetOperations operationsArg,
[In] [MarshalAs(UnmanagedType.Interface)] IMathcadPrimeInputsOutputsStates itemsStatesArg,
[In] [MarshalAs(UnmanagedType.Interface)] IMathcadPrimeInputsOutputsConflicts conflictsArg);

Arguments

• documentFullNameArg - ワークシートの完全な名前とパス。

• documentNameArg - ワークシートの名前。

• operationsArg - イベントをトリガーしたワークシート操作。

• itemsStatesArg - 入力および出力アイテムとそれらの抽出された値のリスト。

• conflictsArg - itemsStatesArg によって発生した重複のコレクション。

OnWorksheetStatesGenerating

状態の生成中に発生します。

Syntax

void OnWorksheetStatesGenerating([In] string documentFullNameArg,
[In] string documentNameArg,
[In] WorksheetOperations operationsArg,
[In] IMathcadPrimeInputsOutputsStates itemsStatesArg,
[In] IMathcadPrimeInputsOutputsConflicts conflictsArg);

Arguments

• documentFullNameArg - 状態を生成しているワークシートの完全な名前とパス。

• documentNameArg - ワークシートの名前。

• operationsArg - イベントをトリガーしたワークシート操作。

• itemsStatesArg - 入力および出力アイテムとそれらの抽出された値のリスト。

• conflictsArg - itemsStatesArg によって発生した重複のコレクション。

OnWorksheetRequestToUpdateInputs

Mathcad が入力領域の新しい値を必要とするときに発生します。

Syntax

void OnWorksheetRequestToUpdateInputs([In] string documentFullNameArg,
[In] string documentNameArg,
[In] IMathcadPrimeValuesSetter setterArg);

Arguments

• documentFullNameArg - ワークシートの完全な名前とパス。

• documentNameArg - ワークシートの名前。

• setterArg - 新しい入力値のセッター。この引数はクライアントによって指定されます。