Xファンクションビルダ

Xファンクションビルダ ツール：XファンクションビルダをクリックしてXファンクションビルダを開きます。

Xファンクション名

Xファンクション編集ボックスでXファンクション名を入力します。

Xファンクションの名前として、既存のLabTalkマクロ、OGSファイル、LabTalkコマンド、LabTalkで呼び出し可能なOriginC関数の名前は使用しないでください。 同じ名前のものがある場合、呼びだされる順番は、LabTalkマクロ > LabTalk OGS > Xファンクション > LabTalkで呼び出し可能なOriginC関数 > LabTalkコマンド の順になります。

X-Function VariableXファンクション変数

X-Function Variable Type変数データタイプとデフォルト値

Xファンクションは、下記のように様々なデータ型を提供します。

1. 基本データ型
   • データ型は double, string, int
   • デフォルト値は、数値に対しては0、文字列に対しては空です。
2. Originの合成データ型
   • データ型はvector、vector<string>、vector<complex>、matrix
   • 例えば、vectorはワークシート列を入力または出力に接続できます。
   • デフォルト値は <active>、<new>、<unassigned>にできます。
   • 詳細はOrigin CヘルプのComposite Data Typesを参照してください。
3. Originオブジェクトタイプ
   • データ型は、Column、Range、GraphLayer 、および他のOriginオブジェクトタイプ
   • デフォルト値は <active>、<new>、<input>、<unassigned>にできます。
   • Origin C は、GetNツリー文字列値からOriginオブジェクトを取得するBOOL okxf_resolve_string_get_origin_object(LPCSTR lpcsz, OriginObject* pObj) 関数を提供します。
   • 詳細は、Origin CヘルプのInternal Origin Objectsをご覧ください。
4. TreeNodeタイプ
   • データ型は、TreeNode, ReportData, ReportTreeです。TreeNode iは入力、ReportData および ReportTreeは出力です。
5. Origin図形オブジェクトコントロール
   • データ型はButtonInfo, LineInfo, TextInfoなどです。
   • Xファンクションビルダで組み込みXファンクションOriginEXE\X-Functions\Data Manipulation\curve translate.OXFを開き、サンプルとして使用法を見ることができます。
6. レポートタイプ
   • データ型は、 ReportData, ReportTreeです。
   • 詳細はXファンクションチュートリアルの章のXファンクションのレポートツリーサンプル を参照してください。

X-Function Dialog Controls制御型

Xファンクションビルダ内の制御列の変数グリッドで異なる制御文字列を指定したら、Xファンクションダイアログでのユーザインターフェースコントロールの異なるタイプを簡単に作成できます。

if( nGetNDialog > 0 )
    trGetN.var.SetAttribute(STR_COMBO_ATTRIB, "|aa|bb|cc");

X-Function Option Stringsオプション文字列

オプション文字列で特殊文字列をセットし、変数の操作を指定できます。 例えば、再計算をデフォルトモードでセットしたり、数値の桁数をセットしたり、出力オブジェクトのデフォルト名をセットできます。詳細は、リファレンス：Xファンクションのオプション文字列をご覧ください。

X-Function Dialog ThemeテーマID

テーマIDは、Xファンクションダイアログテーマファイルで使われ、デフォルト値は0です。すべての変数のテーマIDを0(デフォルト)にする場合、テーマファイル内のテーマIDは1から始まる変数のインデックスに従って変換されます。

既存のテーマファイルと互換性を持たせるために、変数を既存のXファンクションに挿入したいとき、以下のようにする必要があります。(変数を最後に追加する場合は必要ありません)

1. 変数を挿入する前に、テーマIDを0から変数のインデックスに変更します。
2. 変数を挿入します。
3. 繰り返しを避けるため、挿入した変数のテーマIDを最大値にします。

X-Function Tree Viewツリービュー

ツリービューボタンをクリックしてツリービューに切り替えます。ツリービュー内の設定は、Xファンクションダイアログを作成したり、OriginメニューにXファンクションを追加したり、ドキュメントを追加する時に主に使用されます。詳細は、次の章のXファンクションを編集するを確認してください。