origin c プログラミングガイド...iii 目次 1 origin c のイントロダクション........

Origin C プログラミングガイド

このマニュアルの内容の終更新は 2010 年 9 月です。

このマニュアルの新の情報は Originlab 社の wiki サイトをご覧ください

wiki.OriginLab.com

Copyright © 2011 by OriginLab Corporation

このマニュアルのいかなる部分も、OriginLab Corporation の文書による許可無く、理由の如何に

因らず、どのような形式であっても複製または送信することを禁じます。

OriginLab、Origin、LabTalk は、OriginLab Corporation の登録商標または商標です。その他、

記載されている会社名、製品名は、各社の商標および登録商標です。

このマニュアルは、(株)ライトストーンの協力により、翻訳・制作したものです。

OriginLab Corporation

One Roundhouse Plaza

Northampton, MA 01060

USA

(413) 586-2013

(800) 969-7720

Fax (413) 585-0126

www.OriginLab.com

iii

目次

11 Origin C のイントロダクション ...................................................................................... 1

1.1 基本機能 ......................................................................................................................... 1 1.2 Hello World チュートリアル .......................................................................................... 1

22 言語の基本 .................................................................................................................. 5

2.1 データ型と変数 ............................................................................................................... 5 2.1.1 ANSI C データ型 ............................................................................................................ 5 2.1.2 Origin C のコンポジットデータ型 ................................................................................. 5 2.1.3 色 .................................................................................................................................... 6

2.2 演算子 ............................................................................................................................. 8 2.2.1 算術演算子 ...................................................................................................................... 8 2.2.2 比較演算子 ...................................................................................................................... 9 2.2.3 論理演算子 .................................................................................................................... 10 2.2.4 ビット演算子 ................................................................................................................ 11

2.3 フロー制御ステートメント .......................................................................................... 12 2.3.1 if ステートメント .......................................................................................................... 12 2.3.2 switch ステートメント ................................................................................................. 13 2.3.3 for ステートメント........................................................................................................ 13 2.3.4 while ステートメント ................................................................................................... 14 2.3.5 ジャンプステートメント ............................................................................................... 14 2.3.6 foreach ステートメント ................................................................................................ 15

2.4 関数 ............................................................................................................................... 15 2.4.1 グローバル関数 ............................................................................................................. 15 2.4.2 ユーザ定義関数 ............................................................................................................. 16

2.5 クラス ........................................................................................................................... 17 2.5.1 Origin 定義クラス ........................................................................................................ 17 2.5.2 ユーザ定義クラス ......................................................................................................... 17

2.6 エラーと例外処理 ......................................................................................................... 18

33 事前定義のクラス ...................................................................................................... 21

3.1 分析クラス .................................................................................................................... 21 3.2 アプリケーションコミュニケーションクラス ............................................................. 21 3.3 コンポジットデータ型のクラス ................................................................................... 22 3.4 内部 Origin オブジェクトクラス ................................................................................. 25 3.5 システムクラス ............................................................................................................. 38

目次

iv

3.6 ユーザインターフェースのコントロールクラス ......................................................... 38 3.7 ユーティリティクラス ................................................................................................. 43

44 Origin C コードの作成と使用 .................................................................................... 45

4.1 Origin C ファイルの作成と編集.................................................................................. 45 4.1.1 概要............................................................................................................................... 45 4.1.2 ファイルの種類 ............................................................................................................. 46 4.1.3 ワークスペース表示...................................................................................................... 47 4.1.4 コードビルダのクィックスタート ................................................................................ 49

4.2 コンパイル、リンク、ロード ...................................................................................... 50 4.2.1 コンパイルとリンク...................................................................................................... 50 4.2.2 ビルドの自動化 ............................................................................................................. 51 4.2.3 スクリプトでビルドする .............................................................................................. 52 4.2.4 エラーを識別する ......................................................................................................... 53

4.3 デバッグする ............................................................................................................... 54 4.3.1 コードビルダでデバッグする ....................................................................................... 54 4.3.2 デバッグのマクロ ......................................................................................................... 54

4.4 コンパイルした関数を使用する .................................................................................. 56 4.4.1 LabTalk スクリプトから Origin C 関数にアクセスする .............................................. 56 4.4.2 値の設定ダイアログでの関数を定義する ..................................................................... 60

4.5 Origin C コードを配布する ......................................................................................... 61 4.5.1 ソースコードを配布する .............................................................................................. 61 4.5.2 アプリケーションを配布する ....................................................................................... 61

55 ワークブックと行列ブック ........................................................................................... 65

5.1 ワークシート ............................................................................................................... 66 5.1.1 ワークシートの追加と削除 ........................................................................................... 66 5.1.2 ワークブック内のワークシートにアクセスする ........................................................... 67 5.1.3 ワークシートを並べ替える ........................................................................................... 68 5.1.4 ワークシートをコピーする ........................................................................................... 68 5.1.5 ワークシートをフォーマットする ................................................................................ 69 5.1.6 セルを統合する ............................................................................................................. 70

5.2 列 ................................................................................................................................. 70 5.2.1 次数............................................................................................................................... 70 5.2.2 データ型、フォーマット、サブフォーマット .............................................................. 71 5.2.3 データ操作 .................................................................................................................... 72 5.2.4 列ラベル ....................................................................................................................... 73 5.2.5 数式で値をセットする .................................................................................................. 74

5.3 行列シート ................................................................................................................... 74 5.3.1 行列オブジェクトにアクセスする ................................................................................ 74

目次

v

5.3.2 行列オブジェクトの追加と削除 .................................................................................... 75 5.3.3 データまたはイメージとして表示を設定 ...................................................................... 75

5.4 行列 ............................................................................................................................... 76 5.4.1 次数 ............................................................................................................................... 76 5.4.2 データ型とフォーマット ............................................................................................... 76 5.4.3 ラベル ........................................................................................................................... 77 5.4.4 データ値 ........................................................................................................................ 79 5.4.5 数式で値をセットする .................................................................................................. 80

5.5 仮想行列 ....................................................................................................................... 80 5.6 データ操作 .................................................................................................................... 81

5.6.1 ワークシート選択を行う ............................................................................................... 81 5.6.2 ワークシート内の表示範囲を設定する ......................................................................... 82 5.6.3 ワークシートに大きなデータセットを配置する ........................................................... 82 5.6.4 ワークシートの埋め込みグラフにアクセスする ........................................................... 83 5.6.5 ワークシートデータのソート ....................................................................................... 83 5.6.6 ワークシートデータをマスクする ................................................................................ 84 5.6.7 LT の条件でワークシートからデータを抽出する ......................................................... 85 5.6.8 2 つのワークシートのデータを比較する ...................................................................... 86

5.7 データ変換 .................................................................................................................... 87 5.7.1 ワークシートグリッディング ....................................................................................... 87

66 グラフ ......................................................................................................................... 91

6.1 グラフの作成と編集 ..................................................................................................... 92 6.1.1 グラフウィンドウを作成する ....................................................................................... 92 6.1.2 グラフページのフォーマットを取得する ...................................................................... 92 6.1.3 グラフページのフォーマットをセットする .................................................................. 92 6.1.4 グラフレイヤのフォーマットを取得する ...................................................................... 92 6.1.5 グラフレイヤのフォーマットをセットする .................................................................. 92 6.1.6 追加の線を表示する ...................................................................................................... 93 6.1.7 グリッド線を表示する .................................................................................................. 93 6.1.8 軸スケールを設定する .................................................................................................. 94 6.1.9 軸フォーマットを取得する ........................................................................................... 94 6.1.10 軸ラベルを設定する ...................................................................................................... 94 6.1.11 上 X 軸を表示する ......................................................................................................... 95 6.1.12 軸刻みを編集する ......................................................................................................... 95 6.1.13 軸目盛ラベルを編集する ............................................................................................... 95

6.2 データプロットを追加する .......................................................................................... 96 6.2.1 2D プロット (XY, Y エラー, 縦棒/横棒) ........................................................................ 96 6.2.2 3D プロット .................................................................................................................. 97 6.2.3 等高線図 ........................................................................................................................ 98 6.2.4 イメージプロット ......................................................................................................... 99 6.2.5 複数軸 ........................................................................................................................... 99

目次

vi

6.2.6 複数区分グラフ(X 軸を共有した複数レイヤ) .............................................................. 100 6.3 データプロットを編集する ........................................................................................ 101

6.3.1 データマーカーを追加する ......................................................................................... 101 6.3.2 色をセットする ........................................................................................................... 102 6.3.3 フォーマットツリーを取得する .................................................................................. 102 6.3.4 折れ線グラフのフォーマットをセットする ................................................................ 103 6.3.5 あるデータプロットから別のプロットにフォーマットをコピーする......................... 103 6.3.6 散布図のフォーマットをセットする........................................................................... 104 6.3.7 グループ化した線＋シンボルのフォーマットを設定する .......................................... 105 6.3.8 カラーマップ設定を設定する ..................................................................................... 105

6.4 レイヤを管理する ...................................................................................................... 107 6.4.1 区分グラフを作成する ................................................................................................ 107 6.4.2 グラフウィンドウにレイヤを追加する ....................................................................... 108 6.4.3 レイヤを配置する ....................................................................................................... 109 6.4.4 レイヤを移動する ....................................................................................................... 109 6.4.5 レイヤサイズの変更.................................................................................................... 109 6.4.6 2 つのレイヤを入れ替える .......................................................................................... 110 6.4.7 レイヤを整列する ....................................................................................................... 110 6.4.8 レイヤをリンクする.................................................................................................... 111 6.4.9 レイヤ単位をセットする ............................................................................................ 111

6.5 図形オブジェクトの作成とアクセス ......................................................................... 112 6.5.1 図形オブジェクトを作成する ..................................................................................... 112 6.5.2 プロパティを設定する ................................................................................................ 113 6.5.3 位置とサイズを設定する ............................................................................................ 113 6.5.4 接続プロパティを更新する ......................................................................................... 114 6.5.5 表示プロパティを取得およびセットする ................................................................... 114 6.5.6 プログラミング制御.................................................................................................... 114 6.5.7 凡例を更新する ........................................................................................................... 115 6.5.8 グラフにテーブルオブジェクトを追加する ................................................................ 115

77 データ操作 .............................................................................................................. 117

7.1 数値データ ................................................................................................................. 117 7.1.1 欠損値 ......................................................................................................................... 117 7.1.2 精度と比較 .................................................................................................................. 117 7.1.3 数値を文字列に変換する ............................................................................................ 118 7.1.4 vector .......................................................................................................................... 118 7.1.5 行列............................................................................................................................. 119 7.1.6 TreeNode .................................................................................................................... 119 7.1.7 複素数 ......................................................................................................................... 120 7.1.8 DataRange ................................................................................................................. 120

7.2 文字列データ ............................................................................................................. 122 7.2.1 文字列(ストリング)変数 .............................................................................................. 122

目次

vii

7.2.2 文字列を数値に変換する ............................................................................................. 122 7.2.3 数値/文字列を別の文字列に追加する .......................................................................... 122 7.2.4 部分文字列を検索 ....................................................................................................... 123 7.2.5 部分文字列の置換 ....................................................................................................... 123 7.2.6 パス文字列の関数 ....................................................................................................... 123

7.3 日付と時間データ ....................................................................................................... 124 7.3.1 現在の日時データを取得 ............................................................................................. 124 7.3.2 ユリウス日を文字列に変換 ......................................................................................... 125 7.3.3 文字列をユリウス日に変換 ......................................................................................... 125

88 プロジェクト .............................................................................................................. 127

8.1 プロジェクトを管理する ............................................................................................ 127 8.1.1 プロジェクトを開く/保存する .................................................................................... 127 8.1.2 プロジェクトを別のプロジェクトに追加する ............................................................ 127 8.1.3 修正フラグ .................................................................................................................. 127

8.2 フォルダを管理する ................................................................................................... 128 8.2.1 フォルダを作成し、そのパスを取得する .................................................................... 128 8.2.2 アクティブフォルダを取得する .................................................................................. 128 8.2.3 フォルダをアクティブにする ..................................................................................... 128 8.2.4 指定したページのパスを取得 ..................................................................................... 129 8.2.5 ページ/フォルダを別の場所に移動する ...................................................................... 129

8.3 ページにアクセスする ................................................................................................ 129 8.3.1 名前とインデックスでページにアクセスする ............................................................ 129 8.3.2 アクティブページとレイヤを取得する ....................................................................... 130 8.3.3 foreach を使う ............................................................................................................ 130

8.4 メタデータにアクセスする ........................................................................................ 131 8.4.1 データ範囲にアクセスする ......................................................................................... 131 8.4.2 アクセスツリー ........................................................................................................... 131

8.5 操作にアクセスする ................................................................................................... 135 8.5.1 すべての操作のリスト ................................................................................................ 135 8.5.2 ワークシートが階層であるかのチェック .................................................................... 135 8.5.3 レポートシートにアクセスする .................................................................................. 136

99 インポート ................................................................................................................ 137

9.1 データをインポートする ............................................................................................ 137 9.1.1 ASCII データファイルをワークシートにインポート ................................................. 137 9.1.2 ASCII データファイルを行列シートにインポート ..................................................... 139 9.1.3 インポートフィルタを使ってデータをインポートする .............................................. 139

9.2 画像のインポート ....................................................................................................... 140 9.2.1 イメージを行列にインポート ..................................................................................... 141

目次

viii

9.2.2 イメージをワークシートセルに挿入する ................................................................... 142 9.2.3 イメージをグラフにインポートする........................................................................... 142

1100 エクスポート ............................................................................................................ 143

10.1 ワークシートのエクスポート .................................................................................... 143 10.2 グラフのエクスポート ............................................................................................... 144 10.3 行列のエクスポート .................................................................................................. 144

10.3.1 行列を ASCII データファイルにエクスポート ........................................................... 144 10.3.2 行列からイメージを画像ファイルにエクスポート ..................................................... 145

1111 分析とアプリケーション ............................................................................................ 147

11.1 数学 ............................................................................................................................ 147 11.1.1 正規化 ......................................................................................................................... 147 11.1.2 補間/補外 .................................................................................................................... 148 11.1.3 積分............................................................................................................................. 148 11.1.4 微分............................................................................................................................. 152

11.2 統計 ............................................................................................................................ 153 11.2.1 列と行の記述統計量.................................................................................................... 153 11.2.2 度数カウント .............................................................................................................. 153 11.2.3 相関係数 ..................................................................................................................... 154 11.2.4 正規性の検定 .............................................................................................................. 154

11.3 カーブフィッティング ............................................................................................... 155 11.3.1 非線形フィット ........................................................................................................... 155 11.3.2 FDF ファイルにアクセスする .................................................................................... 157

11.4 信号処理 ..................................................................................................................... 158 11.4.1 スムージング .............................................................................................................. 158 11.4.2 FFT............................................................................................................................. 158 11.4.3 FFT フィルタ ............................................................................................................. 159 11.4.4 ウェーブレット分析.................................................................................................... 159

11.5 ピークと基線 ............................................................................................................. 160 11.5.1 基線を作成する ........................................................................................................... 160 11.5.2 基線を削除する ........................................................................................................... 160 11.5.3 ピークを検索する ....................................................................................................... 161 11.5.4 ピークの積分とフィット ............................................................................................ 162

11.6 NAG 関数を使用する ................................................................................................ 163 11.6.1 ヘッダファイル ........................................................................................................... 163 11.6.2 エラー構造体 .............................................................................................................. 163 11.6.3 コールバック関数 ....................................................................................................... 164 11.6.4 Origin からデータを取得する NAG 関数 ................................................................... 165

目次

ix

1122 出力オブジェクト ....................................................................................................... 169

12.1 結果ログ ..................................................................................................................... 169 12.2 スクリプトウィンドウ ................................................................................................ 169 12.3 ノートウィンドウ ....................................................................................................... 170 12.4 レポートシート ........................................................................................................... 170

1133 データベースへのアクセス ....................................................................................... 171

13.1 データベースからのインポート ................................................................................. 171 13.2 データベースへのエクスポート ................................................................................. 172 13.3 SQLite データベースへのアクセス ............................................................................ 173

1144 LabTalk へのアクセス ............................................................................................. 175

14.1 LabTalk の数値を取得およびセットする .................................................................. 175 14.2 LabTalk の文字列値を取得およびセットする ........................................................... 176 14.3 LabTalk スクリプトを実行する ................................................................................. 176 14.4 Origin C コードに LabTalk スクリプトを埋め込む .................................................. 177

1155 ユーザインターフェース ............................................................................................ 179

15.1 ウエイトカーソル ....................................................................................................... 179 15.2 コモンダイアログボックス ........................................................................................ 180

15.2.1 入力ボックス .............................................................................................................. 180 15.2.2 メッセージボックス .................................................................................................... 180 15.2.3 プログレスボックス .................................................................................................... 181 15.2.4 ファイルダイアログ .................................................................................................... 181

15.3 GetN ダイアログ ........................................................................................................ 182 15.3.1 GETN マクロ .............................................................................................................. 182 15.3.2 イベントハンドリング ................................................................................................ 185

15.4 グラフからデータポイントを取得 .............................................................................. 185 15.5 グラフにコントロールを追加する .............................................................................. 186

1166 ダイアログビルダ ..................................................................................................... 189

16.1 単純な Hello World ダイアログ ................................................................................. 190 16.1.1 VC でリソース DLL を作成する ................................................................................. 190 16.1.2 Origin C でリソース DLL を使用する ........................................................................ 195

16.2 ウィザードダイアログ ................................................................................................ 195 16.3 グラフプレビューダイアログ ..................................................................................... 197

16.3.1 ダイアログリソースを準備する .................................................................................. 197

目次

x

16.3.2 ソースファイルを準備する ......................................................................................... 197 16.3.3 必要なヘッダをインクルードする .............................................................................. 197 16.3.4 ユーザ定義プレビュークラスを追加する ................................................................... 197 16.3.5 ダイアログクラスを追加する ..................................................................................... 199 16.3.6 ダイアログを開く ....................................................................................................... 200

16.4 スプリッターダイアログ ........................................................................................... 200 16.4.1 ダイアログリソースを準備する .................................................................................. 200 16.4.2 ソースファイルを準備する ......................................................................................... 201 16.4.3 ヘッダファイルをインクルードする........................................................................... 201 16.4.4 ユーザ定義 Splitter クラスを追加する ....................................................................... 201 16.4.5 ユーザ定義 Splitter ダイアログクラスを追加する ..................................................... 204 16.4.6 ダイアログを開く ....................................................................................................... 205

1177 X ファンクション ....................................................................................................... 207

17.1 X ファンクションを作成する .................................................................................... 207 17.1.1 単純な X ファンクションの作成 ................................................................................. 207 17.1.2 X ファンクションビルダ ............................................................................................. 210 17.1.3 コードビルダでプログラミングする........................................................................... 216 17.1.4 グラフプレビュー付きの GetN ダイアログボックスを作成する ................................ 225 17.1.5 イメージ GetN ダイアログを作成する ....................................................................... 229 17.1.6 カスタムダイアログを作成する .................................................................................. 233 17.1.7 ウィザードダイアログを作成する .............................................................................. 236 17.1.8 X ファンクションでガジェットを作成する ................................................................ 244

17.2 X ファンクションをカスタマイズする ...................................................................... 256 17.2.1 製品メニューに X ファンクションを入れる ............................................................... 256 17.2.2 X ファンクションにドキュメントを追加する ............................................................ 259 17.2.3 ダイアログにカスタムボタンを追加する ................................................................... 259

17.3 X ファンクションを使う ........................................................................................... 262 17.3.1 スクリプトから X ファンクションを呼び出す ............................................................ 262 17.3.2 Origin C で X ファンクションを呼び出す .................................................................. 263

17.4 X ファンクションのサンプル .................................................................................... 265 17.4.1 X ファンクション GUI のコントロールを構築する .................................................... 265 17.4.2 Ｘファンクションでグラフブラウザダイアログを開く .............................................. 269 17.4.3 X ファンクション ReportTree サンプル .................................................................... 272 17.4.4 X ファンクション ReportData サンプル .................................................................... 277

1188 外部リソースへのアクセス ....................................................................................... 283

18.1 外部 DLL にアクセスする ......................................................................................... 283 18.2 外部アプリケーションにアクセスする ..................................................................... 284

目次

xi

1199 リファレンス .............................................................................................................. 287

19.1 クラスの階層 .............................................................................................................. 287 19.2 コレクション .............................................................................................................. 290 19.3 X ファンクションのオプション文字列 ....................................................................... 292

19.3.1 A - 再計算モード ......................................................................................................... 292 19.3.2 B - ブラウザダイアログオプション ............................................................................ 296 19.3.3 C - その他のオプション .............................................................................................. 296 19.3.4 E - 実行制御 ................................................................................................................ 297 19.3.5 F - ダイアログ数値表示フォーマット ......................................................................... 297 19.3.6 FT - データプロット選択フィルタ .............................................................................. 298 19.3.7 FV - 出力変数のソースを指定する ............................................................................. 299 19.3.8 G - GUI 上のコントロールをグループ化する ............................................................. 299 19.3.9 H - 結果テーブルのスタイルをセットする ................................................................. 301 19.3.10 I - 入力範囲コントロールの動作を制限する ............................................................... 303 19.3.11 M - 複数行文字列のサポート ...................................................................................... 308 19.3.12 N - 出力オブジェクトのデフォルト名 ........................................................................ 308 19.3.13 O - X ファンクションを実行した後出力オブジェクトの操作を設定する ................... 309 19.3.14 P - GUI の編集可能なコントロールをセットする ...................................................... 309 19.3.15 R - ダイアログのコンボボックスの動作を制限する ................................................... 311 19.3.16 S - 入力変数のデフォルトのデータ選択を定義する ................................................... 312 19.3.17 SV - X ファンクションダイアログコンボボックスの文字列項目をサポートする ...... 313 19.3.18 T - テーマから変数をスキップする ............................................................................ 313 19.3.19 U - オプションとして出力を指定する ........................................................................ 313 19.3.20 V - 不可視のコントロールを指定する ......................................................................... 316 19.3.21 Z - 変数コントロールの編集可否をセットするチェックボックスを追加する ............ 316

2200 索引 ......................................................................................................................... 319

1

11 Origin C のイントロダクション Origin には 2 つのプログラミング言語があります。Origin C と LabTalk です。

このガイドは Origin C プログラミング言語について説明しています。また、X ファンクションを作成す

る方法やダイアログビルダダイアログを制御する方法も示しています。X ファンクションは、ツールを

作成するための Origin 内のフレームワークです。ダイアログビルダは、フローティングツール、ダイ

アログボックス、ウィザードのようなカスタムダイアログを作成および制御することができます。

このガイドは、Origin ヘルプメニューからアクセスできる言語リファレンスと一緒に使用しましょう。

詳細なサンプルを含む新のデモのソースコードは wiki サイト(wiki.OriginLab.com)にあります。

1.1 基本機能 Origin C は、ANSI C プログラミング言語のシンタックスに基づく高機能なプログラミング言語です。

さらに、Origin C はクラス、ストリーム内での変数宣言、オーバーロード関数、参照、デフォルトの関

数引数などを含む多くの C++の機能をサポートしています。Origin C は、C#プログラミング言語か

らコレクションおよび foreach と using ステートメントをサポートしています。

Origin C プログラムは、コードビルダという Origin の開発環境(IDE)で開発されます。コードビルダ

には、シンタックスのハイライト、ワークスペースウィンドウ、コンパイラ、リンカ、デバッガを持つソース

コードのエディタを含んでいます。コードビルダについての詳細は、ヘルプ:プログラミング：コードビ

ルダを参照してください。

Origin C を使うと、Origin のデータインポートと取り扱い、グラフ作成、分析、イメージエクスポート

機能など完全に制御することができます。Origin C で作成したアプリケーションは、Origin のスクリ

プト言語である LabTalk より高速に実行します。

1.2 Hello World チュートリアルこのチュートリアルは、Origin C 関数を作成するコードビルダコードビルダを使用して、Origin から

関数にアクセスする方法を示しています。関数自体はとても単純ですが、ここで提供されているステ

ップは、Origin C 関数を記述し始める手助けとなります。

Origin の標準ツールバーのコードビルダボタンをクリックし、コードビルダを開きます。

1.2 Hello World チュートリアル

2 Origin C のイントロダクション

コードビルダで、コードビルダの新規作成ボタンをクリックし、新規ファイルダイアログを開きます。

ダイアログのリストボクスから C ファイルを選択し、ファイル名テキストボックスでと入力します。

OK をクリックし、新しいファイルがコードビルダのマルチドキュメントインターフェース(MDI)で開きま

す。

次の Origin C コードをコピーし、// Start your functions here という行の下に入力しま

す。

int test()

{

printf("hello, world¥n"); // テキストを出力する printf 関数の呼び出し

// ¥n は改行を表す

return 0; // 関数を抜け、呼び出し元に 0 を返す

}

コードビルダの標準ツールバーのビルドボタンをクリックして、 HelloWorld.C ソースファイルを

コンパイル、リンクします。コードビルダの出力ウィンドウは次のように表示されます。


Origin C のイントロダクション 3

Origin でこの関数を使用することができます。例えば、Origin のスクリプトウィンドウでこの関数を呼

び出すことができます。スクリプトウィンドウが開かない場合、メニューからウィンドウ：スクリプトウィンド

ウメニューを選択して、開きます。

スクリプトウィンドウに test という関数名を入力し、ENTER キーを押し、コマンドを実行します。

Origin C 関数が実行され、hello, world という文字が次の行に表示されます。


4 Origin C のイントロダクション

スクリプトウィンドウに加え、コードビルダで LabTalk コンソールウィンドウから関数を呼び出すことが

できます。このコンソールウィンドウが開かない場合、コードビルダで表示：LabTalk コンソールを選

択します。

Origin C ファイルが問題なくコンパイルリンクされると、ファイル内で定義したすべ

ての関数は、LabTalk スクリプトをサポートしている Origin 内のどこからでもスク

リプトコマンドとして呼び出すことができます。関数パラメータおよび戻り値は、スク

リプトからアクセス可能なある基準に合致する必要があります。詳細については、

LabTalk ヘルプファイルの LabTalk プログラミング:LabTalk ガイド:X ファンク

ションおよび Origin C 関数の呼び出し：Origin C 関数の章をご覧ください。こ

のヘルプファイルは Origin のヘルプ:プログラミング：LabTalk メニューからアク

セスできます。

5

22 言語の基本 Origin C は、ANSI C/C++プログラミング言語に基づいています。これは、Origin C が同じデータ

型、演算子、フロー制御、ユーザ定義の関数、クラス、エラー、例外処理をサポートしているということ

です。次のセクションでは、Origin C のこれらの領域について詳細に説明します。

2.1 データ型と変数

2.1.1 ANSI C データ型 Origin C は、char, short, int, float, double, void 型などのすべての ANSI C データ型をサポー

トしています。さらに、これらのデータ型のそれぞれを配列にすることができ、ポインタで指定すること

もできます。

char name[50]; // 文字列の配列を宣言 unsigned char age; // 符号無し 8 ビット整数型を宣言 unsigned short year; // 符号無し 16 ビット整数型を宣言

2.1.2 Origin C のコンポジットデータ型配列を宣言する C シンタックスがサポートされていますが、Origin C は 1 次元または 2 次元配列の

データ型の操作を簡単にする string, vector, matrix クラスを提供しています。これらのデータ型

は、char, byte, short, word, int, uint, complex を含みます。ベクター型は、文字列配列のの型

にできますが、行列はできません。行列は数値型のみにすることができます。

string str = "hello, world¥n"; // 文字列を宣言し、初期化 vector<double> vA1 = {1.5, 1.8, 1.1}; // double 型の宣言と初期化 vector vA2 = {2.5, 2.8, 2.1, 2.4}; vector<string> vs(3); // 文字列配列を宣言 vs[0] = "This "; // 文字列を各文字列配列の項目に割り当て vs[1] = "is "; vs[2] = "test"; matrix<int> mA1; // 整数の行列を宣言 matrix mA2; // double 型の行列を宣言 // NOTE:double 型は、データ型が、ベクターおよび行列変数の


6 言語の基本

// 宣言で指定されていないときに、暗黙に使われます。

Origin C で提供される別の役立つクラスは、complex クラスです。complex クラスは、実数と虚数の

両方を含む数値データ型をサポートします。

complex cc(4.5, 7.8); // 複素数値 // 実数コンポーネントは 4.5 にセットされ // 虚数のコンポーネントは 7.8 にセット out_complex("value = ", cc); // 出力は複素数値

2.1.3 色 Origin C の色は、DWORD 値で表されます。これらの値は、Origin の内部カラーパレットへのイン

デックスにしたり、実際に RGB 値を混合することができます。

パレットのインデックス Origin の内部のパレットは 24 色含んでいます。Origin の内部のカラーパレットへのインデックスは

0 から 23 までの値です。Origin C は、これらの値に固定の名前を提供しています。それぞれの名

前は、プレフィックス SYSCOLOR_ に色の名前を続けます。次の表は、24 色の名前とインデックス

です。

インデッ

クス名前

インデッ

クス名前

0 SYSCOLOR_BLACK 12 SYSCOLOR_DKCYAN

1 SYSCOLOR_RED 13 SYSCOLOR_ROYAL

2 SYSCOLOR_GREEN 14 SYSCOLOR_ORANGE

3 SYSCOLOR_BLUE 15 SYSCOLOR_VIOLET

4 SYSCOLOR_CYAN 16 SYSCOLOR_PINK


言語の基本 7

5 SYSCOLOR_MAGENTA 17 SYSCOLOR_WHITE

6 SYSCOLOR_YELLOW 18 SYSCOLOR_LTGRAY

7 SYSCOLOR_DKYELLOW 19 SYSCOLOR_GRAY

8 SYSCOLOR_NAVY 20 SYSCOLOR_LTYELLOW

9 SYSCOLOR_PURPLE 21 SYSCOLOR_LTCYAN

10 SYSCOLOR_WINE 22 SYSCOLOR_LTMAGENTA

11 SYSCOLOR_OLIVE 23 SYSCOLOR_DKGRAY

DWORD dwColor = SYSCOLOR_ORANGE;

自動カラー自動として参照される特別なカラーインデックスがあります。このインデックスが使われると、要素はそ

の親と同じ色で色付けされます。すべての要素が自動インデックスをサポートしているわけではありま

せん。要素に対する Origin のグラフィカルユーザインターフェースを見て、自動インデックスがサポ

ートされているかどうかを決定します。

自動インデックス値が必要なときに INDEX_COLOR_AUTOMATIC マクロが使われます。

DWORD dwColor = INDEX_COLOR_AUTOMATIC;

RGB 値 Origin の色の値は、RGB 値を表すこともできます。RGB 値は、8 ビットの赤、緑、青の成分で構成

されます。これらの値は、RGB マクロを使って簡単に行うことができます。

DWORD brown = RGB(139,69,19); // 茶色

2.2 演算子

8 言語の基本

RGB マクロから返される値は、Origin の色の値として直接使うことができません。RGB2OCOLORマクロを使って、RGB 値を Origin の色の値に変換する必要があります。

DWORD brown = RGB2OCOLOR(RGB(139,69,19)); // 茶色

Origin の色値が RGB 値を表しているのか、パレット内のインデックスを表しているのかを知る必要

がある場合、OCOLOR_IS_RGB マクロを使うことができます。値が RGB 値を表す場合、このマクロ

は True を返し、それ以外の場合 False を返します。

if( OCOLOR_IS_RGB(ocolor) ) out_str("color value represents an RGB color"); else out_str("color value represents a color index");

Origin の色の値が RGB 値を表すことが分かったら、GET_CRF_FROM_RGBOCOLOR マクロ

を使って、Origin の色の値から RGB 値を抽出することができます。

if( OCOLOR_IS_RGB(ocolor) ) { DWORD rgb = GET_CRF_FROM_RGBOCOLOR(ocolor); printf("red = %d, green = %d, blue = %d¥n", GetRValue(rgb), GetGValue(rgb), GetBValue(rgb)); }

2.2 演算子演算子は、ANSI C と同じ算術演算子、論理演算子、比較演算子、ビット演算子をサポートします。

次のセクションは 4 種類の演算子とその用法を示します。

2.2.1 算術演算子

演算子目的

* 乗法

/ 除法

% 剰余 (余り)

2.2 演算子

言語の基本 9

+ 加法

- 減法

^ 指数（下記 Note を参照。）

Note：デフォルトで、Origin C は、指数演算子としてキャレット(^)を扱います。これは LabTalk と一

貫性を持つために行われています。ANSI C では、キャレット(^)を排他論理和演算子として使いま

す。コードの前に特別な pragma ステートメントを使って強制的に Origin C がキャレット(^)を排他

論理和演算子として使うようにすることができます。

out_int("10 raised to the 3rd is ", 10^3); #pragma xor(push, FALSE) out_int("10 XOR 3 is ", 10^3);

整数を別の整数で除算すると整数の結果となります。

double a = 100 / 22; out_double("100 / 22 is ", a);

剰余演算子は、左オペランドを右オペランドで割った余りを計算します。この演算子は整数のオペラ

ンドにのみ適用します。

out_int("The remainder of 11 divided by 2 is ", 11 % 2);

2.2.2 比較演算子比較演算子は、True または False を評価し、True は 1、False は 0 を返します。

演算子目的

> より大きい

>= 以上

< より小さい

2.2 演算子

10 言語の基本

<= 以下

== 等しい

!= 等しくない

if( aa >= 0 ) out_str("aa is greater than or equal to zero"); if( 12 == aa ) out_str("aa is equal to twelve"); if( aa < 99 ) out_str("aa is less than 99");

2.2.3 論理演算子論理演算子は、True または False を評価し、True は 1、False は 0 を返します。オペランドは左か

ら右へ評価されます。論理式全体が決まったら評価が終わります。

演算子目的

! 等しくない

&& および

|| または

次の 2 つのサンプルを考えます。

expr1A && expr2 expr1B || expr2

2.2 演算子

言語の基本 11

expr1A が False または expr1B が True として評価されると、expr2 は評価されません。この動作

は、プログラマにはメリットであり、効率的なコードを記述できます。次は、順序の重要性を明確に表

したものです。

if( NULL != ptr && ptr->dataValue < upperLimit ) process_data(ptr);

上記の例で、ptr が NULL に等しいと、if 式全体は False に評価されます。ptr が NULL の場合、

NULL ポインタから dataValue メンバーを読み取ると、アプリケーションが直ちに終了するので、

dataValue が upperLimit と比較されないことが重要です。

2.2.4 ビット演算子ビット演算子は個々のビットをテストし、設定します。演算子は、オペランドをビットの配列として扱いま

す。ビット演算子のオペランドは不可欠なタイプでなければなりません。

演算子目的

~ 補数

<< 左にシフト

>> 右にシフト

& かつ

^ 排他論理和(XOR)、下記 Note を参照。

| 論理和 OR

Note：デフォルトで、Origin C は、指数演算子としてキャレット(^)を扱います。これは LabTalk と一

貫性を持つために行われています。ANSI C では、キャレット(^)を排他論理和演算子として使いま

す。コードの前に特別な pragma ステートメントを使って強制的に Origin C がキャレット(^)を排他

論理和演算子として使うようにすることができます。

2.3 フロー制御ステートメント

12 言語の基本

out_int("10 raised to the 3rd is ", 10^3); #pragma xor(push, FALSE) out_int("10 XOR 3 is ", 10^3);

2.3 フロー制御ステートメント Origin C は、 if, if-else, switch, for, while, do-while, goto, break, continue を含む ANSI Cのすべてのフロー制御をサポートしています。さらに、Origin C は C#の foreach サポートし、オブ

ジェクトのコレクションをループすることができます。

2.3.1 if ステートメント if ステートメントは、条件分岐に使われ、条件が True の場合にステートメントブロックを実行します。

if-else ステートメントは、if ステートメントに似ていますが、if-else ステートメントは、条件の結果が

False の場合に代替えのステートメントブロックを実行します。

次は、異なる入力タイプを使った、Origin C の if ステートメントのサンプルです。

bool bb = true; // ブール型 if( bb ) { out_str("bb is true"); } int nn = 5; if( nn ) // 整数型, 0 = False, 非ゼロ = true { out_str("nn not 0"); } double* pData = NULL; if( NULL == pData ) // ポインタが NULL の場合にチェック { out_str("Pointer pData is NULL"); }

次は、Origin C の単純な if-else ブロックです。if ブロックと else ブロックがブレース{}で囲まれてい

ます。

if( bRet ) { out_str("Valid input"); // bRet が True のとき } else { out_str("INVALID input"); // bRet が False のとき }


言語の基本 13

if ステートメントが 1 つのステートメントしか持たない場合、ブレースは任意です。これは、上記のコー

ドがブレース無しで書けるということです。

if( bRet ) out_str("Valid input"); // bRet が True のとき else out_str("INVALID input"); // bRet が False のとき

2.3.2 switch ステートメント switch ステートメントは、相互に排他的な選択肢によって、異なるステートメントブロックを実行する

必要があるときに使われます。

case は、昇順の整数で、switch ステートメントに整数の引数で与えられる数値で開始します。 break コマンドは、どのケースでも switch ブロックを抜けます。

switch( nType ) // 整数型の値条件に { case 1: case 2: out_str("Case 1 or 2"); break; case 3: out_str("Case 3"); // break キーワードがここにないと case 4 を実行 case 4: out_str("Case 4"); break; default: out_str("Other cases"); break; }

2.3.3 for ステートメント for ステートメントは、指定した回数または各要素がインデックスで参照しているデータの配列によっ

て、1 つ以上のステートメントを実行するのに使われます。

char str[] = "This is a string"; for( int index = 0; index < strlen(str); index++ ) { printf("char at %2d is %c¥n", index, str[index]); }


14 言語の基本

2.3.4 while ステートメント while と do-while ステートメントは、条件が合致するまでステートメントブロックを実行します。while ステートメントは、ループの初に条件を検査し、 do-while ステートメントは、ループの後に条件

を検査します。

int count = 0; while( count < 10 ) // 条件が True の場合にステートメントを実行 { out_int("count = ", count); count++; } int count = 0; do { out_int("count = ", count); count++; } while( count < 10 ); // 条件が True の場合にステートメントを実行

2.3.5 ジャンプステートメントジャンプステートメントは、関数の範囲内で、無条件に別のステートメントにジャンプするのに使いま

す。break, continue, goto ステートメントがジャンプステートメントです。次のサンプルはこれらのジ

ャンプステートメントを示すものです。

break ステートメント for( int index = 0; index < 10; index++ ) { if( pow(index, 2) > 10 ) break; // ループの終了 out_int("index = ", index); }

continue ステートメント printf("The odd numbers from 1 to 10 are:"); for( int index = 1; index <= 10; index++ ) { if( mod(index, 2) == 0 ) continue; // 次のインデックス printf("%d¥n", index); }

2.4 関数

言語の基本 15

goto ステートメント out_str("Begin"); goto Mark1; out_str("Skipped statement"); Mark1: out_str("First statement after Mark1");

2.3.6 foreach ステートメント foreach ステートメントは、オブジェクトのコレクションをループするのに使われます。次のコードは、

プロジェクト内のすべてのページをループし、その名前とタイプを出力します。

foreach(PageBase pg in Project.Pages) { printf("%s is of type %d¥n", pg.GetName(), pg.GetType()); }

Origin C のクラスに基づくすべての Collection のリストについてはコレクションのセクションを参照

してください。

2.4 関数

2.4.1 グローバル関数 Origin C はさまざまな操作を実行する数多くのグローバル関数を提供しています。これらのグロー

バル関数は 26 個のカテゴリーに分類されます。

基本 I/O

文字および文字列操作

COM

通信

曲線

データ変換

データ範囲

日時

2.4 関数

16 言語の基本

ファイル I/O

ファイル管理

フィッティング

画像処理

インポートとエクスポート

内部 Origin オブジェクト

LabTalk インターフェース

数学関数

数学

行列変換とグリッディング

メモリ管理

NAG

信号処理

スペクトル分析

統計

システム

ツリー

ユーザインターフェース

サンプル付きの完全な関数リストについては、Origin C の wiki サイトのグローバル関数セクション

をご覧ください。

2.4.2 ユーザ定義関数 Origin C は、ユーザ定義関数をサポートしています。Origin C のプログラマは引数の選択肢およ

び戻り型を受け付ける関数を作成することができます。そして、それらの関数は、その引数を操作し、

目的を成し遂げます。

以下のコードは、1 つの引数だけで double 型の値を返し、double 型の値を受け入れる

my_function という関数を作成します。

double my_function(double dData) { dData += 10;

2.5 クラス

言語の基本 17

return dData; }

以下の断片的なコードは、上記の関数を呼び出す方法を示しています。

double d = 3.3; // double 型の値として d を宣言 d = my_function(d); // 上記関数の呼び出し out_double("d == ", d); // d の新しい値を出力

Origin C 関数は Lab Talk から呼び出すことができます。

d = 3.3; // d に 3.3 を割り当て d = my_function(d); // 上記関数を呼び出し d=; // d の新しい値を出力

2.5 クラス Origin C は、数多くの組込みクラスをサポートしていますが、ユーザが自分自身のクラスを作成する

こともできます。

2.5.1 Origin 定義クラス Origin C には、Origin の異なるデータ型とユーザインターフェースオブジェクト操作する事前定義

のクラスがあります。これらのクラスを使うと、操作を実行する Origin C コードを素早く書くことができ

ます。このセクションは、基本クラスについて、これらのクラスが提供している機能の概要を説明して

います。Origin の定義クラスの詳細およびサンプルについては、次の章、事前定義のクラスまたは

Origin C の wiki サイトをご覧ください。

2.5.2 ユーザ定義クラス Origin C は、ユーザ定義クラスをサポートしています。ユーザ定義クラスでは、Origin C のプログラ

マがメソッド(メンバー関数)とデータメンバーを持つ自分自身のオブジェクトを作成することができま

す。

次のコードは、2 つのメソッド GetName と SetName を持つ Book というクラスを作成するものです。

class Book { public: string GetName() { return m_strName; } void SetName(LPCSTR lpcszName)

2.6 エラーと例外処理

18 言語の基本

{ m_strName = lpcszName; } private: string m_strName; };

そして、以下は、上記のメソッドとクラスの定義を使った簡単なサンプルで、Book クラスのインスタン

スを宣言し、SetName を使って名前を付け、GetName を使って名前を出力します。

void test_class() { Book OneBook; // Book オブジェクトを宣言 // Book オブジェクトに対して名前をセット/取得する関数の呼び出し OneBook.SetName("ABC"); out_str(OneBook.GetName()); }

上記のサンプルはとても単純なものです。クラスの機能、例えば、コンストラクタ/デコンストラクタやバ

ーチャルメソッドなどについて詳しく知りたければ、Origin の¥Samples¥Origin C Examples¥Programming Guide¥Extending Origin C サブフォルダにある EasyLR.c、EasyLR.h、EasyFit.h ファイルをご覧ください。

2.6 エラーと例外処理 Origin C は、C++ の try, catch, throw ステートメントを使って、例外処理をサポートしています。

try ブロックは、try キーワードの後にブレースで囲んだ 1 つ以上のステートメントで構成されます。

try ブロックの直後は、catch ハンドラーです。Origin C は、整数の引数を受け付ける catch ハンド

ラーを 1 つだけサポートします。catch キーワードの後には、ブレースで囲まれた 1 つ以上のステー

トメントとなります。

try { LPSTR lpdest = NULL; // NULL ポインタ strcpy(lpdest, "Test"); // エラーを起こすために NULL にコピー } catch(int nErr) { out_int("Error = ", nErr); }

try ブロック内のステートメントを実行することで try-catch が動作します。エラーが発生すると、実行

は catch ブロックにジャンプします。エラーが発生しなければ、catch ブロックは無視されます。

throw キーワードは任意であり、エラーをトリガーにし、catch ブロックへのジャンプを実行します。

void TryCatchThrowEx() {

2.6 エラーと例外処理

言語の基本 19

try { DoSomeWork(4); // 成功を表示するために有効な数字を渡す DoSomeWork(-1); // エラーを引き起こすために無効な数字を渡す } catch(int iErr) { printf("Error code = %d¥n", iErr); } } void DoSomeWork(double num) { if( num < 0 ) throw 100; // 強制的にエラー if( 0 == num ) throw 101; // 強制的にエラー double result = sqrt(num) / log(num); printf("sqrt(%f) / log(%f) = %g¥n", num, num, result); }

21

33 事前定義のクラスこのセクションでは、Origin C の事前定義のクラスについて説明しています。 Origin C 組込クラス

間の関係についての詳細な情報は、クラス階層をご覧ください。

3.1 分析クラス次のクラスは、データ分析を実行するのに使われます。詳細については、ヘルプ Origin C Reference の Classes の Analysis を参照してください。

クラス簡単な説明

NLFitContext このクラスは、フィット関数の情報だけでなく、Origin C でフィット関数を

組み込むことで生成される現在の評価の状態にアクセスするメソッドを

提供します。

NLFitSession

このクラスはより高いレベルの Origin クラスです。フィットの評価手順を

組み込む目的で、わかりやすいインターフェースを持つ NLFit を包含

します。それは、NLFit ダイアログのカーネルです。このクラスは、

Origin のインターフェースの処理から生じる複雑さを処理できるので、

Origin C でコーディングすることをお勧めします。

3.2 アプリケーションコミュニケーションクラス次のクラスは、Origin と他のアプリケーション間との通信を可能にするのに使用されます。詳細につ

いては、ヘルプ Origin C Reference の Classes の Application Communication を参照してく

ださい。

3.3 コンポジットデータ型のクラス

22 事前定義のクラス


Matlab Origin と MATLAB 間の通信を可能にするのに使用されます。

3.3 コンポジットデータ型のクラス以下のクラスは、コンポジットデータ型のクラスです。詳細については、ヘルプ Origin C Reference の Classes の Composite Data Type を参照してください。


CategoricalData

CategoricalData 型のデータセットは、整数の配列です。この配

列は、テキスト型の Origin の内部データセットに結びつけられ、

動的に割り当てられます。この型のデータセットは(1 から始まる)インデックスを参照してカテゴリーにテキスト値をマッピングします。マッピングインデックスのテキスト値は、CategoricalMap のデー

タメンバーに保存されます。

CategoricalMap

CategoricalMap 型のデータセットはテキスト値の配列です。こ

の配列は、動的に割り当てられ、サイズが決まりますが、Originの内部データセットに結びつけられません。このデータセットは、

固有のテキスト値を含み、これは英数字でソートされ、通常

CategoricalData タイプに結びついたオブジェクトの要素で参照

されます。

complex このクラスは、複素数型の数値データを扱うのに使われます。複

素数の実数部と虚数部の両方を含みます。

Curve このクラスは、curvebase および vectorbase クラスから派生し、メ

ソッドとプロパティが継承されています。Curve 型のオブジェクト

は、GraphLayer クラスで定義されたメソッドを使って簡単にプロ


事前定義のクラス 23

ットでき、Y データセットと関連の X データセットで構成されます。

例えば、行番号に対してプロットされるデータセットは、関連の Xデータセットを含みません。

curvebase

vectorbase クラスから派生したこのクラスは、メソッドとプロパティ

を継承し、基底クラスであり、Curve 型のクラスを取り扱うのに使

用します。curvebase 型のオブジェクトは構築することができず、

Curve のような派生クラスが代わりに使われます。

Dataset

このクラスは、vector および vectorbase クラスから派生し、そのメ

ソッドとプロパティを継承しています。Dataset 型は配列であり、

動的に割り当てられ、大きさが決まります。Origin の内部データ

セットに結びつけることも、結びつけないこともできます。デフォル

トで、Dataset は double 型ですが、char, byte, short, word, int, uint, complex などの基本データ型にすることもできます (string は不可)。シンタックス Dataset<type> は、Dataset のこ

れらの型を構築するのに使うことができます。

Matrix

このクラスは、matrix および matrixbase クラスから派生し、その

メソッドとプロパティを受け継いでいます。Matrix (M は大文字)は 2 次元配列で、動的に割り当てられ、大きさが決まり、Originの内部行列ウィンドウに結びついています。Matrix のデフォルト

の型は、double 型ですが、char, byte, short, word, int, uint, complex などの基本データ型にすることもできます (string は不

可)。シンタックス Matrix<type> は、Matrix のこれらの型を構

築するのに使うことができます。

このクラスは、内部の Origin 行列内のデータにアクセスするのに

使われ、MatrixObject クラスは行列のスタイルを制御するのに

使われます。すなわち、MatrixObject と Matrix クラスの関係

は、Column と Dataset クラスの関係と同じです。

Origin 行列(Matrix オブジェクトで参照)内のセルに表示されて

いるデータ値は、通常、ワークシート内では、Z 値として参照さ

れ、関連する X と Y 値は、それぞれ行列の列と行に線形でマッ

ピングされます。



matrix

このクラスは、matrixbase クラスから派生し、そのメソッドとプロパ

ティを受け継いでいます。matrix (m は小文字)は 2 次元配列

で、動的に割り当てられ、大きさが決まり、Origin の内部行列ウィ

ンドウには結びついておらず、柔軟性が提供されます。matrixのデフォルトの型は、double 型ですが、char, byte, short, word, int, uint, complex などの基本データ型にすることもでき

ます (string は不可)。シンタックス matrix<type> は、matrixのこれらの型を構築するのに使うことができます。

matrixbase

このクラスは、matrix と Matrix クラスを取り扱う基底クラスです。

つまり、matrixbase 型のオブジェクトは構築することができず、

matrix や Matrix のような派生クラスのオブジェクトが代わりに使

われます。

PropertyNode このクラスは、Bool, int, float, double, string, vector, matrix, picture などの異なるデータタイプのプロパティに対して使われま

す。

string

このクラスは、文字の null で終わる配列を構築するのに使われ、

MFC CString オブジェクトに似ています。文字列(テキストデー

タ)を操作する多くのメソッドは、このクラスで定義されます。シンタ

ックス vector<string> で vector クラスと一緒に使って、文字列

配列を定義できます。

Tree このクラスは、Origin C ツリーを XML ファイルとして保存したり、

XML ファイルから Origin C ツリーにロードするのに使用できま

す。

TreeNode このクラスは、複数レベルのツリーを構築し、ツリーを横断し、ツリ

ーノードの属性にアクセスするいくつかのメソッドを提供します。

TreeNodeCollection このクラスは、番号付きの名前のプレフィックスで子ツリーノードの

3.4 内部 Origin オブジェクトクラス


コレクションを取得するのに使われます。

vectorbase

このクラスは、vector と Dataset クラスを取り扱う基底クラスです。

つまり、この型のオブジェクトは構築することができず、vector や

Dataset のような派生クラスのオブジェクトが代わりに使われま

す。

vector

このクラスは、vectorbase クラスから派生し、そのメソッドとプロパ

ティを受け継いでいます。vector は配列で、動的に割り当てら

れ、大きさが決まり、Origin の内部データセットには結びついて

おらず、柔軟性が提供されます。vector のデフォルトの型は、

double 型ですが、char, byte, short, word, int, uint, complex, string などの基本データ型にすることもできます。シン

タックス vector<type> は、vector のこれらの型を構築するのに

使うことができます。

3.4 内部 Origin オブジェクトクラス次のクラスは、Origin オブジェクトを取り扱うのに使われます。詳細については、ヘルプ Origin C Reference の Classes の Internal Origin Object を参照してください。


Axis このクラスは、OriginObject クラスから派生され、Originの軸にアクセスするのに使うことができます。Origin の軸

は、Origin ページのレイヤに含まれます。

AxisObject

このクラスは、OriginObject クラスから派生され、軸刻

み、グリッド線、ラベルを含む Origin の軸オブジェクトに

アクセスするのに使うことができます。Origin の軸オブジ

ェクトは、Origin のグラフページの軸に含まれます。



Collection

このクラスは、ページ(プロジェクトファイル内のすべての

PageBase オブジェクトのコレクション)などさまざまな

Origin 内部オブジェクトのコレクションのテンプレートを提

供します。このクラスは暗黙のテンプレート化された型 _TemplType を含み、これはコレクションの 1 つの要素の

型です。例えば、Project クラスの Pages コレクションのテ

ンプレート化された型(Collection<PageBase> Pages;) は PageBase です。

各コレクションは、通常親クラスを持ち、そのデータメンバ

ーはコレクションです。例えば、Project には、すべてのペ

ージが含まれるので、Collection<PageBase> Pages はProject クラスのメンバーの 1 つです。そのため、各コレク

ションは内部オブジェクトに接続されたり、接続されなかっ

たりできます。

すべてのコレクションは、Collection クラスで定義されるメ

ソッドを使うことができます。foreach ループは、コレクショ

ン内の各エレメントを一度にループするも役立つ方法

です。

CollectionEmbeddedPages このクラスは、ワークシート内に埋め込まれたページにアク

セスするのに使われます。

Column

このクラスは、DataObject, DataObjectBase および

OriginObject クラスから派生し、そのメソッドとプロパティ

を継承しています。このクラスで、メソッドとプロパティは

Origin ワークシート列に対して提供されます。ワークシー

トオブジェクトは、Column オブジェクトのコレクションを含

み、各 Column オブジェクトは Dataset を持ちます。

Column オブジェクトは、主に関連 Dataset のデータの

スタイルを制御するのに使用します。

Column オブジェクトは、ラッパーオブジェクトで、これは

Origin の内部の列オブジェクトを参照しますが、実際に

はそれは Origin 内には存在しません。



DataObject

このクラスは DataObjectBase クラスから派生され、ワー

クシートの列と行列のオブジェクトの基底クラスです。

Origin のデータオブジェクトは、Origin ページのレイヤ

に含まれます。例えば、列(データオブジェクト)は、ワーク

シートウィンドウ(ページ)のワークシート(レイヤ)に含まれま

す。

DataObjectBase

このクラスは抜粋した基底クラスで、DataObject と DataPlot に関連したクラスタイプを取り扱うメソッドとプロ

パティを提供します。つまり、この型のオブジェクトは構築

することができず、DataObject, Column, MatrixObject, DataPlot のような派生クラスのオブジェ

クトが代わりに使われます。

DataPlot

このクラスは、DataObjectBase および OriginObject ク

ラスから派生し、そのメソッドとプロパティを受け継いでい

ます。このクラスで、メソッドとプロパティは Origin データ

プロットに対して提供されます。Origin の内部データプロ

ットオブジェクトは、Origin のデータプロットの特徴を保存

するのに使われ、グラフページ上のグラフレイヤに含まれ

ます。

DataPlot オブジェクトはラッパーオブジェクトで、これは

Origin の内部のデータプロットを参照しますが、実際に

はそれは Origin 内には存在しません。つまり、複数のラ

ッパーオブジェクトは、同じ内部 Origin オブジェクトを参

照できます。

DataRange

データ範囲の構築やワークシート、行列、グラフウィンドウ

にデータをアクセスするために、このクラスにはメソッドとプ

ロパティがあります。このクラスは、データ自体を持たず、

ページ名、シート名(グラフに対してレイヤインデックス)、行/列のインデックス(グラフに対してデータプロットのイン

デックス)でデータ範囲を保持するだけです。複数データ

範囲が DataRange オブジェクトに含まれ、部分データ範

囲はデータシート全体、1 つの列、1 つの行、連続した複



数列、連続した複数行にすることができます。

DataRangeEx このクラスは、DataRange の拡張クラスです。

DatasetObject このクラスは、非数値データセットにアクセスするのに使わ

れ、通常、これは Column オブジェクトのメンバーです。

Datasheet

このクラスは、Layer および OriginObject クラスから派生

し、そのメソッドとプロパティを継承しています。このクラス

は、Origin のワークシートと行列レイヤを扱うのに使われ

ます。

Folder

プロジェクトエクスプローラは、Windows エクスプローラの

ようなフォルダ/サブフォルダ構造を持つ Origin 内のユー

ザインターフェースです。これは、Origin プロジェクトファ

イル内のグラフ、レイアウト、行列、ノート、ワークシートウィ

ンドウを整理したり、アクセスするのに使用します。

Folder クラスは、プロジェクトエクスプローラのメソッドとプ

ロパティにアクセスでき、すべての Origin ページとプロジ

ェクトエクスプローラフォルダのコレクションを含みます。

Folder オブジェクトは、ラッパーオブジェクトで、これは

Origin の内部のプロジェクトエクスプローラオブジェクトを

参照しますが、実際にはそれは Origin 内には存在しま

せん。つまり、複数のラッパーオブジェクトは、同じ内部

Origin オブジェクトを参照できます。

fpoint3d このクラスは、3 次元空間の (x, y, z) 座標に対して

double 型のデータポイントを扱うのに使われます。

fpoint このクラスは、2 次元 (x, y) 座標に対して double 型のデ

ータポイントを扱うのに使われます。



GetGraphPoints このクラスは、画面上のポイントの位置(x, y)を取得したり、

Origin のグラフウィンドウからデータポイントを取得するの

に使います。

GraphLayer



で、メソッドとプロパティは Origin グラフレイヤに対して提

供されます。

内部の Origin グラフページには、1 つ以上のグラフレイ

ヤが含まれ、グラフレイヤには、1 つ以上のデータプロット

が含まれます。つまり、GraphPage クラスは

GraphLayer オブジェクトのコレクションを含み、

GraphLayer クラスは DataPlot オブジェクトのコレクショ

ンを含みます。GraphLayer オブジェクトは、ラッパーオ

ブジェクトで、これは Origin の内部のグラフレイヤオブジ

ェクトを参照しますが、実際にはそれは Origin 内には存

在しません。複数のラッパーオブジェクトは、同じ内部


GraphObject

このクラスは、OriginObject クラスから派生し、そのメソッ

ドとプロパティを受け継いでいます。このクラスでは、メソッ

ドとプロパティが Origin のグラフオブジェクトを取り扱うた

めに提供され、これにはテキスト注釈、図形オブジェクト

(矩形、矢印、線オブジェクトなど)、データプロットのスタイ

ルフォルダ、関心のある領域(ROI)を含みます。

Origin のグラフオブジェクトは、一般に、Origin ページ

上のレイヤに含まれ、GraphLayer クラスは

GraphObjects のコレクションを含みます。Graph オブジ

ェクトは、ラッパーオブジェクトで、これは Origin の内部の

グラフオブジェクトを参照しますが、実際にはそれは

Origin 内には存在しません。複数のラッパーオブジェクト

は、同じ内部 Origin オブジェクトを参照できます。

GraphPage このクラスは、Page, PageBase および OriginObject ク

ラスから派生し、そのメソッドとプロパティを継承していま



す。このクラスで、メソッドとプロパティは Origin グラフペ

ージ(ウィンドウ)を取り扱うために提供されます。

GraphPage オブジェクトは、ラッパーオブジェクトで、これ

は Origin の内部のグラフページオブジェクトを参照しま

すが、それは Origin 内には存在しません。つまり、複数

のラッパーオブジェクトは、同じ内部 Origin オブジェクト

を参照できます。

Project クラスは、開いているプロジェクトファイル内の

GraphPages という GraphPage オブジェクトのコレクショ

ンを含みます。GraphPage オブジェクトは、Origin のグ

ラフページ上のレイヤを位置付け、アクセスするのに使わ

れ、DataPlots や GraphicObjects などのレイヤ内のオ

ブジェクトにアクセスするのに使うこともできます。

GraphPageBase このクラスは、GraphPage と LayoutPage の基底クラス

です。

Grid

このクラスは、データシートウィンドウ(Origin のワークシー

トと行列シート)のフォーマットをセットするのに使われま

す。データ選択、列/行ラベルの表示、セルのテキストの

色、セルの統合など、特別な関数もこのクラスで提供され

ています。

GroupPlot

このクラスは、OriginObject クラスから派生され、Originのグループプロットを取り扱うのに使うことができます。

GroupPlot のオブジェクトは、Origin ページのレイヤに

含まれます。

Layer


ドとプロパティを受け継いでいます。このクラスで、メソッド

とプロパティは Origin 内部のレイヤを取り扱うために提供

されます。ノートページを除く、すべての Origin ページ

(ウィンドウ)には 1 つ以上のレイヤを含みます。Origin オ

ブジェクトは、通常ページ上にあり、ページに含まれるレイ

ヤに含まれます。多くのグラフオブジェクトはレイヤに含ま



れ、Layer クラスはグラフオブジェクトのコレクションを含み

ます。

Layer オブジェクトは、ラッパーオブジェクトで、これは

Origin の内部のレイヤオブジェクトを参照しますが、実際

にはそれは Origin 内には存在しません。複数のラッパー

オブジェクトは、同じ内部 Origin オブジェクトを参照でき

ます。

LayoutPage

このクラスは、Page, PageBase および OriginObject ク


ます。このクラスで、メソッドとプロパティは Origin の内部

レイアウトページ(ウィンドウ)を取り扱うために提供されま

す。Project クラスは LayoutPage オブジェクトのコレクシ

ョンを含みます。

LayoutPage オブジェクトは、ラッパーオブジェクトで、こ

れは Origin の内部のレイアウトページオブジェクトを参

照しますが、それは Origin 内には存在しません。複数の

ラッパーオブジェクトは、同じ内部 Origin オブジェクトを

参照できます。

Layout



で、メソッドとプロパティは Origin 内部のレイアウトレイヤ

を取り扱うために提供されます。Origin のレイアウトペー

ジは、他のオブジェクトを含むレイアウトレイヤを含みま

す。

Layout オブジェクトは、ラッパーオブジェクトで、これは

Origin の内部のレイアウトページオブジェクトを参照しま

すが、それは Origin 内には存在しません。複数のラッパ

ーオブジェクトは、同じ内部 Origin オブジェクトを参照で

きます。

MatrixLayer このクラスは、Datasheet, Layer および OriginObject ク


ます。このクラスで、メソッドとプロパティは Origin の行列



ページの行列レイヤを取り扱うために提供されます。

Origin の行列は、多くの行列オブジェクトを含み、

MatrixLayer クラスは行列レイヤ内の行列オブジェクトの

コレクションを含みます。

MatrixLayer オブジェクトは、ラッパーオブジェクトで、こ

れは Origin の内部の行列レイヤオブジェクトを参照しま

すが、実際にはそれは Origin 内には存在しません。複

数のラッパーオブジェクトは、同じ内部 Origin オブジェク

トを参照できます。

MatrixObject

このクラスは、DataObject, DataObjectBase および

OriginObject クラスから派生し、そのメソッドとプロパティ

を継承しています。このクラスは、Origin の行列オブジェ

クトを扱うのに使われます。

MatrixObject は、内部の Origin 行列内のデータのスタ

イルを制御するのに使われ、Matrix クラスは行列のデー

タにアクセスするのに使われます。つまり、Column クラス

が Dataset クラスと同じ関係を持つように、

MatrixObject クラスは Matrix と同じ関係を持ちます。

言い換えれば、ワークシート列(Column)がデータセット

(Dataset)を保持するように、Origin の内部行列オブジェ

クト(MatrixObject)は行列データセット(Matrix)を保持し

ます。行列のセルに表示されているデータ値は、Z 値とし

て参照され、関連する X と Y 値は、それぞれ行列の列と

行に線形でマッピングされます。仮に MatrixLayer に対

して 1 つの MatrixObject しかないとしても、

MatrixLayer は、MatrixObjects のコレクションを持ちま

す。

MatrixObject は、ラッパーオブジェクトで、これは

Origin の内部の行列オブジェクトを参照しますが、実際

にはそれは Origin 内には存在しません。複数のラッパー

オブジェクトは、同じ内部 Origin オブジェクトを参照でき

ます。

MatrixPage このクラスは、Page, PageBase および MatrixPage クラ



スから派生し、そのメソッドとプロパティを受け継いでいま

す。このクラスで、メソッドとプロパティは Origin の内部行

列ページ(ウィンドウ)を取り扱うために提供されます。

MatrixPage オブジェクトは、ラッパーオブジェクトで、こ

れは Origin の内部の行列ページオブジェクトを参照しま

すが、それは Origin 内には存在しません。複数のラッパ

ーオブジェクトは、同じ内部 Origin オブジェクトを参照で

きます。

Project クラスは、開いているプロジェクトファイル内の

MatrixPages という MatrixPage オブジェクトのコレクシ

ョンを含みます。MatrixPage オブジェクトは、Origin の

行列ページ上のレイヤを位置付け、アクセスするのに使わ

れ、MatrixObjects や GraphicObjects などのレイヤ内

のオブジェクトにアクセスするのに使うこともできます。

Note

このクラスは、PageBase および OriginObject クラスから

派生し、そのメソッドとプロパティを受け継いでいます。こ

のクラスで、メソッドとプロパティは Origin の内部ノートペ

ージ(ウィンドウ)を取り扱うために提供されます。Project ク

ラスは Note オブジェクトのコレクションを含みます。

Note オブジェクトは、ラッパーオブジェクトで、これは

Origin の内部のノートページを参照しますが、実際には

それは Origin 内には存在しません。複数のラッパーオブ

ジェクトは、同じ内部 Origin オブジェクトを参照できま

す。

OriginObject

このクラスは、すべての Origin オブジェクトの Origin Cの基底クラスです。メンバー関数とデータメンバーは、す

べての Origin オブジェクトに対して、このクラスで提供さ

れます。

Page

このクラスは、PageBase および OriginObject クラスから

派生し、そのメソッドとプロパティを継承しています。このク

ラスで、1 つ以上のレイヤを含む Origin 内部のページ(ノートウィンドウを除く)を扱うためにメソッドとプロパティが提



供されます。Page クラスは、ページ内のレイヤのコレクシ

ョンを含みます。

Page オブジェクトは、ラッパーオブジェクトで、これは

Origin の内部のページオブジェクトを参照しますが、そ

れは Origin 内には存在しません。複数のラッパーオブジ

ェクトは、同じ内部 Origin オブジェクトを参照できます。

PageBase

このクラスは、Origin 内部のページ(ウィンドウ)に対してメ

ソッドとプロパティを提供します。通常、このクラスは 2 つ

の方法のうちの 1 つで使われます。1 つの方法は、

PageBase オブジェクトを一般的な関数のパラメータとし

て使い、特定の Page オブジェクトを使わずに行います。

もう 1 つの方法は、PageBase オブジェクトを不明なアク

ティブページに接続するものです。どちらの方法も、特定

のページオブジェクトを取り扱うことができます。Note, GraphPage, WorksheetPage, LayoutPage, MatrixPage を含む派生ページ型の抽象クラスとして動

作することが、このクラスの目的にもなっています。

point このクラスは、整数の (x, y) 座標を持つ 2 次元の平面に

あるデータポイントを扱うのに使われます。

Project

このクラスは、Origin プロジェクトファイルのほとんどのオ

ブジェクトにアクセスするメソッドとプロパティを提供しま

す。Project クラスは、Project ファイル内の異なるページ

タイプのコレクション、すべてのデータセット(ワークシート

列ではない一時データセット)のコレクションを含みます。

このクラスは、ActiveCurve, ActiveLayer, ActiveFolder を含む RootFolder プロパティだけでなく、

プロジェクトファイルのアクティブオブジェクトを取得するメ

ソッドを提供します。

Project オブジェクトは、ラッパーオブジェクトで、これは

Origin の内部のプロジェクトオブジェクトを参照します

が、実際にはそれは Origin 内には存在しません。一度

に 1 つのプロジェクトファイルだけを Origin で開くことが



できるので、すべての Project オブジェクトは現在開いて

いるプロジェクトファイルを参照します。

ROIObject

このクラスは、GraphObject クラスから派生し、そのメソッ


とプロパティは Origin の関心のある領域(ROI)に対して

提供されます。Origin の ROI は、Origin 行列内の関心

のある領域を識別するのに使われます。

ROIObject は、ラッパーオブジェクトで、これは Origin の

内部の ROI オブジェクトを参照しますが、実際にはそれ

は Origin 内には存在しません。複数のラッパーオブジェ

クトは、同じ内部 Origin オブジェクトを参照できます。

Scale



とプロパティは Origin の軸スケールを取り扱うために提

供されます。2 つのスケールオブジェクト (X スケールト Yスケール)がグラフページの各グラフレイヤに含まれます。

Scale オブジェクトは、ラッパーオブジェクトで、これは

Origin の内部のスケールオブジェクトを参照しますが、実

際にはそれは Origin 内には存在しません。これは、複数

のラッパーオブジェクトが同じ内部 Origin オブジェクトを

参照できるということです。

storage

Origin は、バイナリタイプ(TreeNode 型)と INI タイプ (INIFile 型)の情報を、WorksheetPage, Column, Folder, GraphPage, GraphLayer, DataPlot, Projectなどの OriginObject から派生した Origin C オブジェク

トにすることができる Origin オブジェクトに保存します。

StyleHolder

このクラスは、GraphObject および OriginObject クラス

から派生し、そのメソッドとプロパティを継承しています。こ

のクラスで、メソッドとプロパティはデータプロットスタイルホ

ルダに提供されます。データプロットスタイルホルダは、プ



ロットタイプ情報を保存するのに使われます。

Styleholder オブジェクトは、ラッパーオブジェクトで、これ

は Origin の内部のスタイルホルダオブジェクトを参照しま

すが、実際にはそれは Origin 内には存在しません。複

数のラッパーオブジェクトは、同じ内部 Origin オブジェク

トを参照できます。

UndoBlock このクラスは、プロジェクトに安全にアクセスする 2 つの関

数 UndoBlockBegin() と UndoBlockEnd()を提供して

います。

WorksheetPage

このクラスは、Page, PageBase および OriginObject ク

ラスから派生し、そのメソッドとプロパティを継承していま

す。このクラスで、メソッドとプロパティは Origin の内部ワ

ークシートページ(ウィンドウ)に提供されます。Project クラ

スは WorksheetPage オブジェクトのコレクションを含みま

す。

WorksheetPage オブジェクトは、ラッパーオブジェクト

で、これは Origin の内部のワークシートページオブジェ

クトを参照しますが、実際にはそれは Origin 内には存在

しません。複数のラッパーオブジェクトは、同じ内部


Worksheet

このクラスは、Datasheet, Layer および OriginObject ク


ます。このクラスで、メソッドとプロパティは Origin のワー

クシートページのワークシートレイヤを取り扱うために提供

されます。Origin のワークシートは、多くのワークシート列

を含み、Worksheet クラスはワークシート内のすべての列

のコレクションを含みます。

Worksheet オブジェクトは、ラッパーオブジェクトで、これ

は Origin の内部のワークシートオブジェクトを参照します

が、実際にはそれは Origin 内には存在しません。複数

のラッパーオブジェクトは、同じ内部 Origin オブジェクト



を参照できます。

XYRange

このクラスは、DataRange クラスから派生し、そのメソッド

とプロパティを受け継いでいます。このクラスで定義したク

ラスを使うことで、データ範囲は、1 つの独立変数(X)と 1つの従属変数(Y)を持ち、行列およびワークシートから得

ることができ、行列およびワークシートに配置することがで

きます。これはグラフウィンドウにプロットを作成するのに使

用することもできます。

DataRange クラスのように、XYRange クラスは、データ

自体を持たず、ページ名、シート名(グラフに対してレイヤ

インデックス)、行/列のインデックス(グラフに対してデータ

プロットのインデックス)でデータ範囲を保持するだけで

す。すべての XYRange オブジェクトには複数の XY デ

ータ範囲を含めることができます。

XYRangeComplex

このクラスは、XYRange および DataRange クラスから派

生し、そのメソッドとプロパティを継承しています。このクラ

スは、行列とワークシートウィンドウに対する複素数型の

XY データセットを取得し、セットするのに使われます。

DataRange クラスのように、XYRangeComplex クラス

は、データ自体を持たず、ページ名、シート名、行/列のイ

ンデックスでデータ範囲を保持するだけです。すべての

XYRangeComplex オブジェクトには複数の XY 複素数

データ範囲を含めることができます。

XYZRange

このクラスは、DataRange クラスから派生し、そのメソッド

とプロパティを受け継いでいます。このクラスは、行列とワ

ークシートウィンドウに対する XYZ データセットを取得し、

セットするのに使われます。

DataRange クラスのように、XYZRange クラスは、データ

自体を持たず、ページ名、シート名、行/列のインデックス

でデータ範囲を保持するだけです。すべての

XYZRange オブジェクトには複数の XYZ データ範囲を

3.5 システムクラス


含めることができます。

3.5 システムクラス次のクラスは、システム設定に関するものです。詳細については、ヘルプ Origin C Reference のClasses の System を参照してください。


file

このクラスは、バッファされない I/O(ディスクに直接アクセス)を使って、バイナ

リファイルの読み書きの許可を制御するのに使用されます。これは MFC の

CFile クラスに似ています。テキストファイルへのバッファされるストリーム I/Oに対する stdioFile クラスも参照してください。

INIFile このクラスは、初期化ファイルに保存されるデータにアクセスするのに使われ

ます。

Registry このクラスのメソッドは、Windows レジストリにアクセスするのに使われます。

stdioFile

このクラスは、File クラスから派生し、そのメソッドとプロパティを受け継いでい

ます。このクラスは、バッファされるストリーム I/O を使って、テキストファイルと

バイナリファイルの読み書きの許可を制御するのに使用されます。しかし、この

クラスは stdin, stdout, stderr へのストリーム I/O をサポートしません。バイナ

リファイルへのバッファされない I/O に対する File クラスも参照してください。

3.6 ユーザインターフェースのコントロールクラス次のクラスは、ユーザインターフェースに関するものです。詳細については、ヘルプ Origin C Reference の Classes の User Interface Control を参照してください。

* という印が付いているクラスは、DeveloperKit がインストールされている Origin で利用できます。

3.6 ユーザインターフェースのコントロールクラス



*BitmapRadioButton このクラスはビットマップボタンコントロールの機能を提供しま

す。

*Button

このクラスはボタンコントロールの機能を提供します。ボタンコン

トロールは、クリックでオンオフできる小さな矩形の子ウィンドウで

す。ボタンをクリックすると、その外観が変わります。標準的なボ

タンには、チェックボックス、ラジオボタン、プッシュボタンが含ま

れます。

*CmdTarget

このクラスは、メッセージマップアーキテクチャの基底クラスで

す。メッセージマップは、コマンドまたはメッセージを記述したメ

ンバー関数に送るのに使われ、メンバー関数はコマンドまたはメ

ッセージを取り扱います。(コマンドはメニュー、コマンドボタン、

アクセラレータキーからのメッセージです。)

次の 2 つの主要なフレームワーククラスがこのクラスから派生さ

れます。Window と ObjectCmdTarget メッセージを取り扱うた

めの新しいクラスを作成するには、これらの 2 つのクラスの一方

から新しいクラスを派生するだけです。CmdTarget から直接派

生する必要はありません。

*CodeEdit このクラスは、RichEdit クラスから派生されたものです。これ

は、コーディングしているテキストでキーワードに対して再定義し

た色を表示するのに使われます。

*ColorText このクラスは、DeveloperKit がインストールされている Originパッケージのみで利用できます。

*ComboBox このクラスはコンボボックスコントロールを定義するのに使われま

す。



*Control このクラスはすべてのコントロールの基本機能を提供します。

*DeviceContext このクラスはデバイスコンテキストオブジェクトを定義するのに使

われます。

*Dialog このクラスは、画面上でダイアログボックスを表示するための基

本クラスです。

*DialogBar このクラスは、Origin C ベースのダイアログを持つドッキング可

能なコントロールを作成するのに使われます。

*DynaControl

このクラスは、編集ボックス、コンボボックス、チェックボックス、ラ

ジオボタンなどのさまざまなタイプのカスタマイズしたインターフ

ェースコントロールを動的に生成します。値は、ツリーノードで保

存され、ダイアログ上でツリー構造として表示されます。

*Edit このクラスは編集コントロールを作成するのに使われます。編集

コントロールは矩形の子ウィンドウで、テキストを入力することが

できます。

*GraphControl

このクラスは、OriginControls、Contorol と Window クラスか

ら派生し、そのメソッドとプロパティを受け継いでいます。このクラ

スで定義したメソッドは、ダイアログ内で指定したコントロール内

で Origin グラフを表示するのに使うことができます。

GraphObjTool このクラスは、GraphObjCurveTool の基底クラスです。Originのグラフウィンドウ上で、関心のある領域でデータを含む矩形を

作成し、管理するのに使われます。

GraphObjCurveTool このクラスは、vectorbase クラスから派生し、そのメソッドとプロ

パティを受け継いでいます。これらのメソッドとプロパティを使っ



て、Origin のグラフウィンドウ上で、関心のある領域でデータを

含む矩形を作成し、管理するのに使われます。このクラスは、コ

ンテキストメニューおよび関連のイベント関数を追加するための

メソッドを提供します。

*ListBox このクラスはリストボックスを定義するのに使われます。リストボッ

クスは、表示と選択に対する文字列項目のリストを表示します。

*Menu このクラスは、メニューを作成、トラッキング、更新、削除などの

取り扱うために使われます。

*OriginControls このクラスは、ダイアログボックスで Origin ウィンドウを表示する

ための基底クラスです。

*PictureControl このクラスは、ダイアログのコントロール内で PictureHolder オ

ブジェクトを塗りつぶすのに使われます。

progressBox

このクラスは、プログレスダイアログボックスを開いて、制御する

ためのメソッドとプロパティを提供します。プログレスボックスは、

ソフトウェアがデータを処理中であることを示す小さなダイアログ

ボックスです。このダイアログボックスは、処理の進行状況の割

合を表示するプログレスバーを含みます。プログレスダイアログ

は、通常、反復ループに使用します。

*PropertyPage このクラスは、ウィザードダイアログでプロパティシートの個々の

ページオブジェクトを作成するのに使われます。

*PropertySheet このクラスは、ウィザードダイアログでプロパティシートを作成す

るのに使われます。1 つのプロパティシートオブジェクトには、複

数のプロパティページオブジェクトを含むことができます。



*RichEdit

このクラスは、テキストフォーマットのためのメソッドを提供しま

す。rich edit コントロールはウィンドウで、その中のテキストを

記述したり、編集できます。テキストは文字やパラグラフのフォー

マットにすることができます。

*Slider

slider コントロールは、スライダと任意の刻みを持つウィンドウ

です。スライダは、マウスまたはキーボードの矢印キーで移動で

き、コントロールは通知メッセージを送信して変更を実装しま

す。

*SpinButton spin ボタンコントロールは、コントロールでのスクロール位置や

表示している数値などの値を増加または減少させるのに使用す

る一対の矢印ボタンです。この値は、現在の位置を呼びます。

*TabControl

タブコントロールは、ダイアログの異なるタブの下にある異なる情

報を表示するのに使われます。このクラスは、コントロールのグ

ループを表示するのにタブ項目を追加／削除するメソッドを提

供します。

waitCursor ウェイトカーソルは、ソフトウェアがデータを処理中であることを

示す視覚的な印です。このクラスは、ウェイトカーソルを開いて、

制御するためのメソッドとプロパティを提供します。

*Window このクラスは、すべての Windows クラスの基底クラスです。これ

は MFC の CWnd クラスに似ています。

*WizardControl このクラスは、ダイアログ内でステップ毎に何かを実装するウィザ

ードのコントロールを作成するのに使われます。このクラスで利

用できるメソッドは、ステップを追加/削除することができます。

*WizardSheet このクラスは、ウィザードダイアログでプロパティシートを作成す

るのに使われます。プロパティシートには、1 つ以上のページオ

3.7 ユーティリティクラス


ブジェクトを含めることができます。

*WorksheetControl

このクラスは、OriginControls, Control および Window クラス

から派生し、そのメソッドとプロパティを継承しています。このクラ

スで利用できるメソッドは、ダイアログ内の指定したコントロール

内で Origin のワークシートを表示するのに使うことができます。

*WndContainer このクラスは、派生した制御クラスの基底クラスです。

3.7 ユーティリティクラス次のクラスについての詳細は、ヘルプ Origin C Reference の Classes の Utility を参照してくだ

さい。


Array

このクラスは、ほぼすべてのデータ型とオブジェクトのコレクションです。

Array::IsOwner が TRUE のとき、配列はオブジェクトに割り当てられるメモリ

を所有します。そして配列のサイズが変わったり、破棄されるとオブジェクトは

削除されます。

BitsHex このクラスは、バイトベクター(1 と 0)を 16 進文字列に圧縮したり、16 進文字列

をバイトベクターに非圧縮するのに使われます。

Profiler このクラスは、処理が遅い関数を見つけるため、さまざまな関数の呼び出し時

間を測定するのに使われます。

45

44 Origin C コードの作成と使用

4.1 Origin C ファイルの作成と編集

4.1.1 概要コードビルダは、Origin C と LabTalk プログラミングの統合開発環境(IDE)です。コードビルダは、

Origin C のプログラムを記述／編集したり、コンパイルリンクしたり、デバッグしたり、実行するための

ツールを提供します。Origin C コードは、テキストエディタで書くことができますが、コードビルダのワ

ークスペースに追加して、コンパイルリンクする必要があります。

コードビルダウィンドウ



4.1.2 ファイルの種類 Origin C は 4 種類のファイル、ソース、オブジェクト、プリプロセス、ワークスペースを利用します。

ソースファイル (*.c, *.cpp, *.h) ソースファイルは、実際にはテキストファイルで、人間が読むことができる Origin C コードを含みます。

コードビルダや他のテキストエディタで作成することができ、どの場所にでも保存できます。コードビ

ルダのテキストエディタは、シンタックスの色付け、内容に応じたヘルプ、デバッグの機能があります。

ソースファイルがコンパイル、リンク、ロードされるまで、それらを Origin で使用することはできません。

オブジェクトファイル (*.ocb) ソースファイルがコンパイルされるとき、オブジェクトファイルが生成されます。オブジェクトファイルは

ソースファイルと同じファイル名を持ちますが、ファイル拡張子は、*.ocb となります。オブジェクトファ

イルは、コンピュータが読むことができ、Origin はその関数を呼び出して実行します。Origin は、

初にソースファイルをコンパイルし、そして、ソースファイルが変更されたら再コンパイルします。

Origin 内のオブジェクトファイルは、バージョンに依存し、それらを共有することはできません。関数

や Origin C アプリケーションを共有する場合、代わりにプリプロセスファイルを共有します。

プリプロセスファイル (*.op) デフォルトで、Origin はソースファイルをコンパイルし、オブジェクトファイルを生成します。しかし、下

記のシステム変数はオブジェクトファイルの代わりにプリオウロセスファイルを生成するのに変更する

ことができます。プリプロセスファイルは、コンパイルする必要がありますが、コードの共有に対して次

のようなメリットがあります。

Origin のバージョンに依存しない関数はソースコードを共有せずに共有できるビルド処理がソースファイルよりも高速

オブジェクト(OCB)またはプリプロセス(OP)ファイルのどちらかを生成することができるシステム変数

は、@OCS, @OCSB, @OCSE です。スクリプトウィンドウまたはコードビルダの LabTalk コンソール

でそれらの値を変更できます。例えば、スクリプトウィンドウで、次のように入力します。

@OCSB=0; // コンパイルで、OP ファイルを生成


Origin C コードの作成と使用 47

@OCS この変数のデフォルト値は 1 で、これは OCB ファイルまたは OP ファイルを作成します。@OCS=0の場合、コンパイラは OCB ファイルまたは OP ファイルを作成しません。

@OCSB @OCSB=1 がデフォルト値で、これはコンパイル時にオブジェクトを生成します。OP ファイルを生成

するには、OP ファイルがコンパイル時に生成された後、@OCSB=0 とセットします。OP ファイルは、

ソースファイルと同じフォルダ内に保存され、同じファイル名を持ちますが、拡張子が OP となります。

@OCS=0 の場合、この変数は意味がありません。

@OCSE この変数は、OriginPro でのみ利用できます。デフォルト値は 0 です。@OCSE=1 をセットした後、

コンパイラは暗号化された OP ファイルを生成し、人間が読むことができません。暗号化された OPファイルは Origin または OriginPro のバージョンでロードでき、リンクできます。Note: この変数は、

@OCSB=0 のときにのみ意味を持ちます。

ワークスペースファイル (*.ocw) コードビルダで、数多くの Origin C ソースファイルを含むプロジェクトを作成または使用できます。こ

れらのファイルは、フォルダ内で階層で統合化されていたり、されていない場合があります。このよう

なファイルを、プロジェクトを切り替える度に、ロードするのはとても不便です。

このような理由で、User フォルダに含まれる構造およびファイルはワークスペースファイルに保存す

ることができます。ワークスペースファイルをコードビルダにロードする際に、プロジェクトは直前に保

存した状態に戻ります。割り当てられた構造が何であっても、すべてのソースファイルが利用できます。

4.1.3 ワークスペース表示コードビルダワークスペースには次の 4 つのフォルダがあります。

Project フォルダ System フォルダ Temporary フォルダ User フォルダ



ワークスペース表示

各フォルダ内のファイルは、次の異なるイベントでコンパイルリンクします。

Project Project フォルダ内のファイルは、現在の Origin プロジェクトファイル(*.OPJ)に保存されます。それ

らを含む Origin プロジェクトファイルを開く際に、それらはコードビルダワークスペースのプロジェクト

フォルダに追加されます。それらは自動的にコンパイルリンクされ、プロジェクトファイルを開きます。

System System フォルダ内のファイルは、Windows フォルダ内に外部的に保存されます(通常 Origin Cフォルダまたはそのサブフォルダの 1 つ)。それらは、自動的にコードビルダワークスペースの

System フォルダに追加され、Origin が起動したときにコンパイル、リンクされます。

Temporary Project, System, User フォルダ内にリストされていないすべてのファイルは、Origin を使用してい

るときにロードされ、コンパイルされ、Temporary フォルダに現れます。例えば、グラフをエクスポート

4.2 コンパイル、リンク、ロード


する場合、グラフエクスポートを取り扱うために使われるすべてのファイルは、Temporary フォルダ

に現れます。

User User フォルダのファイルは Windows フォルダに外部的に保存され、手動でコードビルダの Userフォルダに追加され、コードビルダ内でコンパイルリンクされます。

4.1.4 コードビルダのクィックスタート 2,3 のステップでコードビルダを開始できます。

キーボードで Alt+4 を押すか、コードビルダボタンをクリックして、コードビルダを開きます。

Ctrl-N または新規ツールバーボタンをクリックして、新しいソースコードファイルを作成します。新規

ファイルダイアログが現れたら、ソースコードファイルの名前を入力し、Enter キーを押し、OK ボタン

をクリックします。

エディタウィンドウが開きます。エディタウィンドウの後の行に行き、Enter キーを押して、新しい空

白行を開始します。次の関数を入力します。

void HelloWorld()

{

printf("Hello World, from Origin C¥n");

}

この関数を呼び出す前に、コードをコンパイルリンクする必要があります。 Shift+F8 を押すか、ツー

ルバーのビルドボタンをクリックして行うことができます。

出力ウィンドウにコンパイルリンクの処理を表示します。エラーが現れたら、関数をチェックし、エラー

を訂正します。エラーが現れなければ、関数は呼び出す準備ができています。

コマンドウィンドウと結果ウィンドウの上部をクリックします。関数名を入力し、Enter キーを押します。

コマンドウィンドウと結果ウィンドウの下部で、関数名、入力した行が表示され、それに続いて関数の

出力行があります。

これらのステップは、コードビルダで行うことができますが、Origin C ファイルを効率よく記述したり、

デバッグしたり、実行する助けとなる詳細設定があります、。これらについては、後に続くセクションで

説明しています。



4.2 コンパイル、リンク、ロード Origin C 関数にアクセスする前に、C コードビルダでコンパイルリンク(ビルド)する必要があります。

エラー無く関数をコンパイルリンクしたら、自動的にロードされ、現在の Origin セッションでアクセス

できます。今後の Origin セッションで関数にアクセスするには、再ロードし、リンクする必要がありま

す。この処理は素早く、自動化することができます。

この章では、Origin C のソースファイルとプリプロセスファイルを手動または自動でビルドする方法

について説明します。

4.2.1 コンパイルとリンク Origin C のソースファイルまたはプリプロセスファイルで定義した関数を作成するため、以下のステ

ップを行う必要があります。

ファイルをコードビルダワークスペースに追加するファイルをコンパイルするすべての関連ファイルをリンクし、必要に応じて関連ファイルもコンパイルし、作成したオブ

ジェクトファイルをロードする

すべてのファイルをコンパイルし、リンクする処理は、ビルドとして行われます。

ファイルをコードビルダワークスペースに追加するソースファイルまたはプリプロセスファイルをコンパイルリンクする前に、ファイルは、次のコードビルダ

ワークスペースフォルダの 1 つに追加する必要があります。Project, User, System, Temporary.すべてのソースファイルは、初に作成されるか、User フォルダにロードされます。

ファイルをコンパイルする

ファイルをワークスペースに追加した後、 (コンパイルボタンをクリックして)コンパイルし、オブジ

ェクトファイルを生成する必要があります。オブジェクトファイルは、ソースファイルまたはプリプロセス

ファイルと同じ名前で、OCB という拡張子を持ちます。オブジェクトファイルは、アプリケーションデー

タフォルダに保存されます。古いバージョンでは、ファイルは User Files¥OCTemp フォルダに保

存されます。



ワークスペースをビルドする

アクティブなファイルとすべての関連ファイルをビルドするには、ビルドボタンを選択するか、す

べてをリビルドボタンを選択し、ワークスペース内のすべてのファイルをビルドします。作成した

オブジェクトファイルは、自動的にメモリにロードされ、リンクされ、ファイルに定義した関数は Originの中で実行可能になります。

オブジェクトファイルが生成されると、その後のビルド処理がより高速になります。ソースファイルとプリ

プロセスファイルに変更が無ければ、コードビルダはオブジェクトファイルを直接ロードし、リンクしま

すが、ファイルをリビルドしません。

ビルドとすべてをビルドの違い

ビルド:与えられたフォルダがコードビルダでアクティブフォルダで、ビルドツールバーボタンがク

リックされると、そのフォルダ内のすべてのファイルがコンパイルリンクされます。

すべてをビルド: コードビルダのすべてをリビルドボタンがクリックされると、コードビルダのすべてのフォルダ内のファイルがコンパイルリンクされます。

4.2.2 ビルドの自動化初に、すべての Origin C ソースファイルまたはプリプロセスファイルが User フォルダ内で作成さ

れ、開かれます。そして、上記で述べたように Origin C ソースファイルを手動でビルドします。しかし、

ビルド処理を自動化するとメリットがあります。

これは、コードビルダのフォルダ構造を使用することで行なったり、機能的に少しの違いがあったり、

起動時のビルドオプションを利用して、行うことができます。

コードビルダの Project フォルダにファイルを追加すると、関連の Origin プロジェクトが開いたとき

に、自動的にビルドされます。

コードビルダの System フォルダにファイルを追加すると、Origin 起動時に自動的にビルドされます。

Origin プロジェクトまたはコードビルダプロジェクトが起動または開いたときに、System フォルダ内

のファイルもリビルドされます。

起動時にビルドオプションは、Origin 起動時に直前に開いたコードビルダワークスペースをビルド

します。



Project フォルダにファイルを追加する次の方法で、System フォルダにファイルを追加できます。

Project フォルダを右クリックして、「ファイルの追加」を選びます。

別のワークスペースフォルダからファイルをドラッグし、Project フォルダにドラッグします。

System フォルダにファイルを追加する次の方法で、System フォルダにファイルを追加できます。

System フォルダを右クリックして、「ファイルの追加」を選びます。

別のワークスペースフォルダからファイルをドラッグし、System フォルダにドラッグします。

Origin.ini ファイルの OriginCSystem セクションを編集します。Origin が実行していないときに、

このセクションを編集する必要があります。セクションには、各ファイルのエントリーが含まれます。

起動時にビルド Origin が起動したときに、Origin C ワークスペースの System フォルダの内容を確認し、変更が見

つかったら、コンパイルリンクしようとします。また、起動にビルドオプションを有効にして、User フォ

ルダ内のファイルにこの手順を行うことができます。

コードビルダをアクティブにします。

ワークスペースの表示が見えていない場合、表示メニューのワークスペースを選びます。

Origin C ワークスペースを右クリックします。

起動にビルド項目がチェックされていない場合、クリックします。

次回 Origin を起動すると、User フォルダ内のファイルがチェックされ、変更があったファイルをコン

パイルリンクします。

4.2.3 スクリプトでビルドする Origin C 関数を LabTalk スクリプトで呼び出す場合、ソースファイルがコンパイルリンクされている

必要があります。そして、LabTalk コマンド Run.LoadOC を使って、指定したソースファイルをコン

パイルリンクします。例えば、

ファイル->新規ワークスペース...を選択し、新しいワークスペースを作成します。Temporary フォル

ダは空にしておきます。



コマンドウィンドウで次のスクリプトを実行し... dragNdrop.c ファイルとその関連ファイルすべてが

Temporary フォルダにロードされ、コンパイルされます。

if(run.LoadOC(OriginLab¥dragNdrop.c, 16) != 0)

{

type "Failed to load dragNdrop.c!";

return 0;

}

4.2.4 エラーを識別するコードビルダでソースファイルをコンパイルリンクするとき、コンパイルおよびリンクの結果はコードビル

ダの出力ウィンドウに表示されます。

コンパイルリンクが問題なく行われた場合、出力ウィンドウにはソースファイルがコンパイルされたこと

が表示されます。Done! という行により、問題がなかったことが分かります。

コンパイルリンク中にエラーが発生したら、出力ウィンドウには、ファイル名、行番号、エラーが発生し

たことが表示されます。出力ウィンドウ内のエラー行をダブルクリックして、ソースファイルをアクティブ

にし、エラーを含むコード行にカーソルを移動します。

4.3 デバッグする



4.3.1 コードビルダでデバッグするコードビルダには、Origin C や LabTalk のコードをデバッグする機能があります。ブレークポイント

をセットしたり、解除でき、関数にステップイン、ステップアウトしてコードを 1 度に 1 行ずつ実行した

り、変数内の値を監視することができます。デバッグはデフォルトで有効になっています。デバッグメ

ニューのブレークポイントを有効にするを使ってデバッグをオンまたはオフにすることができます。メ

ニュー項目の隣にチェックボックスがある場合、デバッグ機能はオンです。

デバッガについての詳細は、コードビルダユーザガイドにあります。これは Origin のヘルプ：プログ

ラミング：コードビルダメニューにあります。

4.3.2 デバッグのマクロ Origin C は、多くの用途を持つ複数パラメータを定義することができます。デバッグ中に助けとなる

用途のような 2 つの ASSERT マクロとデバッグステートメントを含むマクロがあります。次のセクショ

ンはサンプルコードを含み、詳細にこれらのマクロを説明します。サンプルファイル DebugMacros.cは、Origin の¥Samples¥Origin C Examples¥Programming Guide¥Introduction to Origin C サブフォルダにあります。

ASSERT マクロ Origin C は、ASSERT マクロを提供し、プログラム開発中に論理エラーを認識します。Origin C の

ASSERT マクロは次のシンタックスを持ちます。

ASSERT(condition)

ASSERT を含む関数が呼ばれると、条件が false (0)と評価されるとき、ASSERT がメッセージボッ

クスを開きます。診断メッセージは、アサーション失敗の場所で、ソースファイルと行番号を示します。

つまり、関数が変数値がゼロでない値を期待している場合、次のコード行を追加して、変数がゼロの

場合に警告します。

ASSERT(myVar != 0);

次のサンプルでは、ベクターbb の大きさが、ベクターaa の大きさと等しくない場合、診断メッセージ

ボックスはアサーション失敗を示します。

void AssertMacro(int imax = 10) { vector<int> aa(imax); vector<int> bb;



for (int ii = 0; ii < aa.GetSize(); ii++) aa[ii] = ii; bb = 10 * aa; // imax += 1; ASSERT(bb.GetSize() == imax); for (ii = 0; ii < bb.GetSize(); ii++) printf("bb[%d]=%d ¥n", ii, bb[ii]); }

コメントアウトされた imax+=1; の行を持つ上記の関数を実行すると、ASSERT メッセージボックス

は現れません。しかし、imax+=1; の行のコメントを外し、(リビルドすると)下記の ASSERT メッセー

ジが出力されます。

はいをクリックすると、コードビルダのテキストエディタに適切なソースファイル(DebugMacros.c)が開

き、デバッグで ASSERT メッセージボックスを生成する行で停止します。

ステートメントをデバッグする多くのプログラマは、プログラムの流れを指示するコードを開発し、変数の値を表示するコードを開発

する際に、出力ステートメントを使います。

4.4 コンパイルした関数を使用する


出力マクロを作成する

便利なデバッグのテクニックは、出力マクロを定義し、そのマクロを下図のように配置することです。

#define DBG_OUT(_text, _value) out_int(_text, _value); void DebugStatements() { int ii; DBG_OUT("ii at t0 = ", ii) ii++; DBG_OUT("ii at t1 = ", ii) ii++; DBG_OUT("ii at t2 = ", ii) ii++; DBG_OUT("ii at t3 = ", ii) printf("Finished running DebugMacros."); }

デバッグマクロの本体をコメントアウトする

開発期間中に、マクロの本体を上記で定義したようにしたままにすると、デバッグメッセージがメッセ

ージボックスに表示されます。しかし、開発が完了したら(または安定的な動作になったら)、マクロを

下記のように再定義し、デバッグステートメントを非表示にすることができます。

#define DBG_OUT(_text, _value) // out_int(_text, _value);

DBG_OUT マクロの本体をコメントアウトし、リビルドすると、その使用の可能なインスタンスを除去せ

ずに、将来再利用するためにそれらを保存して、デバッグステートメントを非表示にすることができま

す。コードは再び修正したり、デバッグする必要はなく、マクロの本体を単に非コメントにするだけで

す。

4.4 コンパイルした関数を使用する Origin C 関数をコンパイル、リンク、ロードしたら、Origin で使用する準備ができています。これは

名前で関数を呼び出し、LabTalk スクリプトコマンドを受け付ける Origin のどの場所からでも必要

な引数を提供できるということです。このような場所は、スクリプトウィンドウ、コマンドウィンドウ、

Origin GUI 内のカスタムボタンがあります。LabTalk スクリプトガイドのスクリプトの実行の章では、

Origin C 関数を使用することができる Origin 内のすべての場所についての詳細があります。

4.4.1 LabTalk スクリプトから Origin C 関数にアクセスする Origin C 関数は、他の Origin C や LabTalk スクリプトから呼び出すことができます。このセクショ

ンでは、Origin C 関数を LabTalk からアクセスする方法について説明しています。



Origin C コードから LabTalk にアクセスすることについての情報は、LabTalk にアクセスするの章を参照してください。

LabTalk から Origin C 関数にアクセスする関数定義の前に Origin C コードに pragma ステートメントを配置して、Origin C コードにアクセス

する LabTalk を制御できます。

#pragma labtalk(0) // LabTalk で OC 関数を無効に void foo0() { } #pragma labtalk(1) // LabTalk で OC 関数を有効に (デフォルト) void foo1() { } #pragma labtalk(2) // '''run -oc''' LabTalk コマンドが必要 void foo2() { }

上記のコードは、foo0 を LabTalk からの呼び出しを禁止し、foo1 は LabTalk から呼び出すことが

でき、foo2 は、run -oc コマンドを使って、LabTalk から呼び出すことができます。2 番目の

pragma をコメントアウトしていると、foo0 と foo1 の両方が LabTalk から呼び出すことができません。

これは、1 つの pragma ステートメントが pragma の後のすべての関数に適用され、次の pragmaまたはファイルの後まで続きます。

Origin C 関数にアクセスする LabTalk を制御する LabTalk のシステム変数もあります。変数は @OC で、そのデフォルトは 1 であり、アクセス可能ということです。変数を 0 にセットするとアクセス不

可となります。

Lab Talk から呼び出すことができる関数を一覧表示する LabTalk の list コマンドは、LabTalk から呼び出すことができる Origin C 関数のすべての名前を

出力するのに使用できます。オプションを使って、関数を一覧表示する形式を変更することができま

す。

list f; // LabTalk から呼び出し可能な関数の一覧 list fs; // string を返す関数の一覧 list fv; // vector を返す関数の一覧 list fn; // numeric を返す関数の一覧 list fo; // void を返す関数の一覧



@OC=0 という設定は、Origin C 関数を LabTalk で非表示にし、そのため list f コマンドは結果を

表示しません。

関数に引数を渡す LabTalk スクリプトは Origin C の内部で使用しているすべてのデータ型をサポートしているわけで

はありません。次の表は、与えられた引数(戻り)の型で Origin C 関数を呼び出すときに、渡される

(返される)LabTalk 変数の型です。後の列は、引数の型が参照によって渡すことができるかどう

かを示しています。

Origin C LabTalk 参照で渡すことが可能?

int int はい

double double はい

string string はい

bool int いいえ

matrix matrix range はい

vector<int> dataset はい

vector<double> dataset はい

vector<complex> dataset いいえ

vector<string> dataset, string array* いいえ



* 文字列配列は参照で渡すことができません。

上記の表が示すように、string, int, double 型の Origin C 関数の引数は LabTalk から値または

参照で渡すことができます。しかし、Origin C 関数は実行時に渡される型で記述しなければなりま

せん。

値で渡す

以下は、LabTalk から Origin C に値で引数を渡すサンプルです。各サンプルに対するフォーマッ

トは、Origin C 関数の宣言の行を与え、LabTalk のコードを使って呼び出されます。Origin C 関

数の本体は、変数を渡すというサンプルに対しては重要ではないので、除外しています。

関数の単純なケースは、引数を受け付け、double 型の引数を受付け、double 型を返します。

double square(double a) // Origin C 関数の宣言 double dd = 3.2; // LabTalk 関数の呼び出し double ss = square(dd); ss =; // ss = 10.24

ここで、データタイプに割り当てるデータセット変数または範囲を使って、vector 引数を取り、vectorを返す Origin C 関数が LabTalk から呼ばれます。

vector<string> PassStrArray(vector<string> strvec)

LabTalk から 3 つの方法で呼び出すことができます。

dataset dA, dB; dB = Col(B); dA=PassStrArray(dB); Col(A)=PassStrArray(Col(B)); // または Col を直接使い、Col = dataset // または LabTalk 範囲が使われる range ra = [Book1]1!1, rb = [Book1]1!2; ra = PassStrArray(rb);

リファレンスで渡す

以下の Origin C 関数に対して、引数宣言内のアンパサンド & の文字は、引数が参照で渡されて

いることを示しています。

double increment(double& a, double dStep) double d = 4; increment(d, 6); type -a "d = $(d)"; // d = 10

次は、参照で渡すいくつかの引数とそれ以外を値で渡すサンプルです。

int get_min_max_double_arr(vector<double> vd, double& min, double& max) dataset ds = data(2, 30, 2);



double dMin, dMax; get_min_max_double_arr(ds, dMin, dMax); //または列からデータセットを使う、Col(A)にデータがあること get_min_max_double_arr(Col(A), dMin, dMax);

次のサンプルは、LabTalk の matrix range 変数を Origin C 関数に参照で渡すことを示していま

す。

// データを vector から matrix にセット void set_mat_data(const vector<double>& vd, matrix& mat) { mat.SetSize(4,4); mat.SetByVector(vd); } range mm = [MBook1]1!1; dataset ds = data(0, 30, 2); set_mat_data(ds, mm);

同じ名前を持つ関数の優先規則ユーザ定義またはグローバルな Origin C 関数が組み込みの LabTalk 関数と同じ名前を持つとき、

LabTalk の vecotr 表記を使う時を除いて、Origin C 関数が優先順位が高くなります。

優先順位:

LabTalk 関数(vector) Origin C 関数 LabTalk 関数(scalar)

通常の LabTalk 関数(値の範囲を戻し、vector 表記で使われる)は、同じ名前の Origin C 関数よ

りも優先順位が高くなります。それ以外の場合には、Origin C 関数が呼ばれます。

4.4.2 値の設定ダイアログでの関数を定義する列または行列のどちらかの値の設定メニューで現れるダイアログボックスで、Origin C を使って関数

を定義することができます。

Origin C 関数が Origin プロジェクトの一部としてビルドされると、---コードビルダの Project または

System に自動的に配置されるか、user フォルダ内の関数を手動でビルドするかのいずれか---(列と行列の両方)の値の設定ダイアログの F(x) のユーザ定義セクションで利用できます。F(x) メニュ

ーの異なるセクションに関数を割り当てるには、関数ヘッダの一部として、新しいセクション名を含む

pragma を発行します。例えば、次のコードは、Math セクションに関数 add2num を追加し、統計

セクションに関数 mean2num を追加します。

4.5 Origin C コードを配布する


#pragma labtalk(1,Math) double add2num(double a, double b) { return a + b; } #pragma labtalk(1,Statistics) double mean2num(double a, double b) { return (a + b)/2; }

この方法で、多くの関数を 1 つのソースファイル内で定義し、ビルドし、F(x) メニューの目的の場所

で直ちに利用できます。

F(x) メニューに追加される関数は、次の制約に従います。

関数の戻り型は、void 型にすることはできません。関数は引数の型に対して、参照またはポインタを持つことはできません。


4.5.1 ソースコードを配布する Origin ユーザは、ソースファイル(.C または.CPP)またはプリプロセスファイル(.OP)のいずれかを配

布することで、他の人と Origin C ソースコードを共有することができます。

他の人がアプリケーションのソースコードを見る必要がなければ、ソースファイル(.C または.CPP)ではなくプリプロセスファイル(.OP)を配布することをお勧めします。詳細については、 Origin C ファイ

ルの作成と編集のセクションにあるプリプロセスファイル (*.op) をご覧ください。

4.5.2 アプリケーションを配布するアプリケーションを作成したら、1 つのパッケージファイルとして、他のユーザにアプリケーションを配

布することができます。

パッケージマネジャを使って、すべてのアプリケーションファイルを 1 つのパッケジファイル(.OPX)にまとめることができます。アプリケーションファイルをパッケージに追加するときには、プリプロセスフ

ァイル(.OP)またはソースファイル(.C または.CPP)を追加することに注意してください。両方を追加す

る必要はありません。

ユーザは、パッケージファイルを Origin に直接ドロップしてインストールすることができます。



以下は、すべてのアプリケーションファイルを 1 つの OPX にパッケージする方法を示すサンプルで

す。ユーザは、パッケージファイルを Origin にドロップし、ボタンをクリックしてソースファイルを実行

することができます。

Origin C ファイルを準備します。コードビルダで、ファイル->新規作成メニューから MyButton.c と

いう新しい c ファイルを作成し、以下のコードをそこにコピーして、ユーザファイルフォルダの

OriginC サブフォルダに保存します。

void OnButtonClick()

{

Worksheet wks = Project.ActiveLayer();

DataRange dr;

dr.Add(wks, 0, "X");

dr.Add(wks, 1, "Y");

GraphPage gp;

gp.Create();

GraphLayer gl = gp.Layers(0);

int nn = gl.AddPlot(dr);

gl.Rescale();

}

MyButton.ogs という OGS ファイルを作成し、Origin C ソースコードをロードし、関数を呼びます。

以下のコードをコピーし、ユーザファイルフォルダに保存します。

[Main]

if(0 == Run.LoadOC(%Y¥OriginC¥MyButton.c))

{

OnButtonClick;

}

Origin メニューから、表示->ツールバーを選択します。ツールバーのカスタム化ダイアログで、ボタ

ングループタブを選び、新規作成をクリックして、ボタングループの作成ダイアログを開きます。グル

ープ名として MyButton をセットし、ボタンの数は 1 のままにし、ビットマップにはユーザファイルフ

ォルダから Userdef.bmp ファイルを選び、OK ボタンをクリックします。名前を付けて保存ダイアログ

で、保存ボタンをクリックして、MyButton.ini ファイルをデフォルトパスに保存します。

ツールバーのカスタム化ダイアログで、ボタンをクリックして選び、設定をクリックしてボタン設定

ダイアログを開きます。ファイル名に MyButton.ogs を選び、セクション名に Main と入力し、OK ボ

タンをクリックしてダイアログを選びます。



エクスポートをクリックして、ボタングループのエクスポートダイアログを開き、ファイルの追加をクリック

して、上記 MyButton.c ファイルを選びます。

エクスポートをクリックし、名前を付けて保存ダイアログで、保存をクリックして指定したフォルダに

MyButton.OPX ファイルを保存します。

ツール->パッケージマネジャーメニューを選び、開いたダイアログボックスで、ファイル->開くを選び、

MyButton.OPX ファイルを開きます。グリッド表示の LabTalk スクリプト->インストール後にスクリプ

ト Run.LoadOC(%Y¥OriginC¥HelloWorld.c); を入力し、Origin C ソースファイルをロードします。

Origin に OPX ファイルをドロップしてこのアプリケーションをインストールするときに、このスクリプト

が実行します。

65

55 ワークブックと行列ブック Origin C の WorksheetPage と MatrixPage クラスは、それぞれ Origin ワークブックと行列ブック

を操作するものです。各ブックには、シートのコレクションが含まれ、各シートには、Column または MatrixObject のコレクションが含まれます。

ワークブック／行列ブックを作成する Create メソッドを使って新しいブックを作成します。

// ColStat テンプレートを使って非表示のワークブックを作成 WorksheetPage wksPg; wksPg.Create("ColStat", CREATE_HIDDEN); MatrixPage matPg; matPg.Create("Origin"); // Origin テンプレートを使って行列ブックを作成

ワークブック／行列ブックにアクセスする既存のワークブックまたは行列ブックにアクセスする方法が複数あります。使用する方法は、ワークブ

ックおよび行列ブックの両方に対して同じです。

Project クラスは、プロジェクト内のすべてのワークブックまたは行列ブックのコレクションを含みます。

次のサンプルは、それらをループして処理する方法を示しています。

foreach(WorksheetPage wksPg in Project.WorksheetPages) out_str(wksPg.GetName()); // output workbook name foreach(MatrixPage matPg in Project.MatrixPages) out_str(matPg.GetName()); // output matrix book name

Collection クラスの Item メソッドにインデックスを渡して、ワークブックまたは行列ブックにアクセスで

きます。

GraphPage grPg; grPg = Project.GraphPages.Item(2); if( grPg ) // 3 番目の行列ブックがあれば out_str(grPg.GetName()); // 行列ブック名を出力

ワークブックまたは行列ブックの名前をクラスコンストラクタに渡してワークブックまたは行列ブックにア

クセスできます。

WorksheetPage wksPg("Book1"); if( wksPg ) // "Book1"というワークブックがあれば

5.1 ワークシート

66 ワークブックと行列ブック

wksPg.SetName("MyBook1"); // ワークブックの名前を変更

ワークブック／行列ブックを削除するすべての Origin C の内部クラスは、OriginObject クラスから派生したものです。このクラスは、オブ

ジェクトを破棄するのに使用する Destroy メソッドがあります。ワークブックまたは行列ブックでこのメ

ソッドを呼び出すと、ワークブックまたは行列ブック、それらの中にあるすべてのシート、各シート内の

すべての列または行列オブジェクトを削除します。

GraphPage grPg; grPg = Project.GraphPages.Item(0); // プロジェクト内の初のワークブックを取得 if( grPg ) // ワークブックがあれば grPg.Destroy(); // ワークブックを削除

ワークブック／行列ブックを複製する WorksheetPage クラス(ワークブックに対して)、MatrixPage クラス(行列ブックに対して)、GraphPage クラス(グラフウィンドウに対して)は、すべて Page クラスから派生したものです。このクラ

スは、元のページを複製するのに使用する Clone メソッドがあります。

// データおよびスタイルと一緒に"Book1", "MBook1", "Graph1"を複製 // 呼び出す前にこれらのウィンドウが存在していることを確認 WorksheetPage wksPage("Book1"); WorksheetPage wksPage2 = wksPage.Clone(); MatrixPage matPage("MBook1"); MatrixPage matPage2 = matPage.Clone(); GraphPage gp("Graph1"); GraphPage gp2 = gp.Clone();

5.1 ワークシート Origin C には、WorksheetPage 内のワークシートを操作する Worksheet クラスがあります。ワー

クブックはワークシートのコレクションを含み、ワークシートは Column のコレクションを含みます。

Worksheet クラスは、Layer クラスから派生されたものです。

5.1.1 ワークシートの追加と削除 WorksheetPage クラスの AddLayer メソッドを使ってワークシートをワークブックに追加します。

// "Book1"というワークブックにアクセス WorksheetPage wksPage("Book1");


ワークブックと行列ブック 67

// ワークブックに新しいシートを追加 int index = wksPage.AddLayer("New Sheet"); // 新しいワークシートにアクセス Worksheet wksNew = wksPage.Layers(index); // 新しいワークシートをアクティブにセット set_active_layer(wksNew);

Destroy メソッドを使ってワークシートを削除します。

Worksheet wks = Project.ActiveLayer(); if( wks ) // アクティブレイヤがワークシートであれば wks.Destroy(); // ワークシートを削除

5.1.2 ワークブック内のワークシートにアクセスする名前でワークシートにアクセスする方法には 2 つあります。レイヤの完全な名前をコンストラクタまた

は Attach メソッドに渡すことができます。レイヤの完全名には角括弧内のページ名に続けてレイヤ

名を含みます。

// wksPage がアクセスしたいシートを保持する有効な WorksheetPage string strFullName = "[" + wksPage.GetName() + "]" + "Sheet1";

完全レイヤ名を使ってワークシートにアクセスできます。

// 新しい Worksheet インスタンスを構築し、それを名前を付けたシートに接続 Worksheet wks1(strFullName); // 既存の Worksheet インスタンスを名前を付けたシートに接続 wks2.Attach(strFullName);

ワークブックには、ワークシートのコエｒクションを含めることができます。foreach ステートメントを使っ

て、指定したワークブック内のすべてのワークシートをループできます。

WorksheetPage wksPage("Book1"); foreach(Layer wks in wksPage.Layers) out_str(wks.GetName());

名前またはインデックスで特定のワークシートにアクセスできます。

//ページ Book1 には 2 つのワークシートがあり //それぞれ Sheet1 および Sheet2 という名前とする WorksheetPage wksPage("Book1"); Worksheet wksFirst = wksPage.Layers(0); //インデックスで Worksheet wksSecond = wksPage.Layers("Sheet2"); //名前で



5.1.3 ワークシートを並べ替える Reorder メソッドは、ワークブック内のワークシートの位置を変更することができます。

// この例は、アクティブワークブックに 2 つのシートがある // アクティブレイヤからアクティブページを取得 WorksheetPage wksPage; Worksheet wks = Project.ActiveLayer(); if( wks ) wksPage = wks.GetPage(); // 2 番目のワークシートを 1 番目に移動 if( wksPage.Reorder(1, 0) ) out_str("Reorder sheets successfully");

5.1.4 ワークシートをコピーする Page::AddLayer メソッドは、あるページから別のページにレイヤをコピーするのに使われ、

GraphPage, WorksheetPage, MatrixPage で使用できます。

次のサンプルは、アクティブフォルダからすべてのワークシートをドラッグして、アクティブワークブック

に統合する方法を示しています。

WorksheetPage wksPageDest = Project.Pages(); if( !wksPageDest ) // アクティブウィンドウが無いか、アクティブウィンドウがワークシートではない return; bool bKeepSourceLayer = false; // コピー後、元のレイヤを削除 Folder fld = Project.ActiveFolder(); foreach(PageBase pb in fld.Pages) { WorksheetPage wbSource(pb); if(!wbSource) continue;//ワークブックではない if(wbSource.GetName() == wksPageDest.GetName()) continue;//目的のブックをスキップ // ワークシートを目的のブックにコピーし、元のブックから削除 foreach(Layer lay in wbSource.Layers) { Worksheet wks = lay; wksPageDest.AddLayer(wks, 0, bKeepSourceLayer); } wbSource.Destroy();// 空のワークブックを破棄 }



5.1.5 ワークシートをフォーマットするワークシートは、テーマツリーを使ってプログラムでフォーマットできます。下の例は、既存のテーマツ

リーを取得し、保存するものです。

// ワークシートからフォーマットツリーを取得 Worksheet wks = Project.ActiveLayer(); Tree tr; tr = wks.GetFormat(FPB_ALL, FOB_ALL, TRUE, TRUE); out_tree(tr); // ツリーをスクリプトウィンドウに出力

または、テーマツリーを次の 3 つのステップで構築します。初に、ワークシートを作成し、いくつか

データを挿入します。

// ワークシートを作成 Worksheet wks; wks.Create("Origin"); wks.SetCell(0, 0, "abc"); // テキストを(0, 0)セルに配置 // データ範囲を確立しフォーマットを適用 DataRange dr; int r1 = 0, c1 = 0, r2 = 4, c2 = 1; dr.Add("Range1", wks, r1, c1, r2, c2);

2 番目に、範囲情報を使ってツリーを構築し、目的のプロパティの値を提供します。

Tree tr; // フォーマットを適用したい範囲をセットアップ tr.Root.RangeStyles.RangeStyle1.Left.nVal = c1 + 1; tr.Root.RangeStyles.RangeStyle1.Top.nVal = r1 + 1; tr.Root.RangeStyles.RangeStyle1.Right.nVal = c2 + 1; tr.Root.RangeStyles.RangeStyle1.Bottom.nVal = r2 + 1; // 色の塗りつぶし tr.Root.RangeStyles.RangeStyle1.Style.Fill.FillColor.nVal = SYSCOLOR_LTCYAN; // セル内にテキストを整列、2 は中央 tr.Root.RangeStyles.RangeStyle1.Style.Alignment.Horizontal.nVal = 2; // テキストのフォントサイズ tr.Root.RangeStyles.RangeStyle1.Style.Font.Size.nVal = 11; // テキストの色 tr.Root.RangeStyles.RangeStyle1.Style.Color.nVal = SYSCOLOR_BLUE;

3 番目にフォーマットをデータ範囲に適用します。

// フォーマットを指定したデータ範囲に適用 if( 0 == dr.UpdateThemeIDs(tr.Root) ) // エラーなしで 0 を返す { bool bRet = dr.ApplyFormat(tr, true, true); }

5.2 列


5.1.6 セルを統合する Origin C コードを使って、指定した範囲で Worksheet セルを統合します。選択した範囲は、デー

タ領域または列ラベル領域にすることができます。ラベルセルを統合したければ、次のコードで bLabels を true に変更します。

Worksheet wks; wks.Create("Origin"); //Grid を定義し、ワークシートに接続 Grid gg; gg.Attach(wks); // 2 列の初の 2 つの行を統合 ORANGE rng; rng.r1 = 0; rng.c1 = 0; rng.r2 = 1; rng.c2 = 1; bool bLabels = false; bool bRet = gg.MergeCells(rng, bLabels); if( bRet ) printf("Successfully merged cells in %s!¥n", wks.GetName()); else printf("Failed to merge cells in %s!¥n", wks.GetName());

5.2 列 Origin C は、ワークシート列を取り扱う Column クラスを提供しています。Column オブジェクトは、

通常、列に含まれるデータセットのスタイル、フォーマット、データ型を制御するのに使用します。

Column クラスを使用する方法を示すサンプルコードが次のセクションで提供されています。

5.2.1 次数

ワークシートに列を追加する // デフォルト名を持つ列を追加 int nColIndex = wks.AddCol(); // 名前を持つ列を追加 string strName; int nColIndex = wks.AddCol("AA", strName); // Returns the index of column // AA という列が既に存在していれば、自動的に数字付となる

5.2 列


out_str(strName); Column col(wks, nColIndex); // 列インデックスで column オブジェクトを構築

ワークシートから列を削除 // インデックスで列を削除 wks.DeleteCol(0);

ワークシートに列を挿入する // 初の列として新しい列を挿入 int nPos = 0; // 挿入位置 string strNewCreated; // 新しい列の実際の名前 // MyCol という名前が存在していれば自動的に名前を付ける if( wks.InsertCol(nPos, "MyCol", strNewCreated) ) { printf("Insert column successfully, name is %s¥n", strNewCreated); }

行と列の数をセットする // 行と列の数をセットし、データを保持 // 一度に行と列を追加するには SetSize を使用 int nNumRows = 100; int nNumCols = 20; wks.SetSize(nNumRows, nNumCols); // 行数を変更し、列数を保持する場合 // -1 を使用例えば wks.SetSize(nNumRows, -1); // 同様に、列数を変更し行数を保持することも可

5.2.2 データ型、フォーマット、サブフォーマット

データ型の取得とセット Worksheet wks = Project.ActiveLayer(); Column col(wks, 0); // 取得する列のデータ型： // 0:Y

5.2 列


// 1:無属性 // 2:Y エラー // 3:X // 4:L // 5:Z // 6:X エラー int nType = col.GetType(); out_int("Type:", nType); // 列の型をセット詳細は、oc_const.h の OKDATAOBJ_DESIGNATION_* を参照 col.SetType(OKDATAOBJ_DESIGNATION_Z);

データフォーマットの取得とセット // データフォーマットの取得とセット // 列のデフォルトのフォーマットは OKCOLTYPE_TEXT_NUMERIC // 列のフォーマットを日付にセット if( OKCOLTYPE_DATE != col.GetFormat() ) { col.SetFormat(OKCOLTYPE_DATE); }

データのサブフォーマットの取得とセット // データのサブフォーマットの取得とセット // サブフォーマットのオプションは上記のフォーマットの // 数値、日付、時刻などによって異なる if( LDF_YYMMDD != col.GetSubFormat() ) { col.SetSubFormat(LDF_YYMMDD); }

5.2.3 データ操作

列から数値データ値を取得およびセット // 初の列に接続し、列のフォーマットが // 文字と数値(デフォルト)または数値にする Column col(wks, 0); // ここで、列のデータ型は double 型 // 他の数値データ型もサポート；例、int, short, complex vector<double>& vec = col.GetDataObject(); // この列の後に 100 を追加 vec.Add(100);

5.2 列


または、Dataset オブジェクトを使って、列の数値データを取得、セット例えば、

Worksheet wks = Project.ActiveLayer(); Dataset ds(wks, 1); for(int ii=0; ii<ds.GetSize(); ii++) out_double("", ds[ii]);

列から文字列データ値を取得およびセット Column col(wks, 0); // 初の列に接続 // 列から文字列配列を取得 vector<string> vs; col.GetStringArray(vs); // 文字列配列を列に戻す vs.Add("test"); col.PutStringArray(vs);

5.2.4 列ラベルワークシート列ラベルは、ロングネーム、単位、コメント、パラメータ、ユーザ定義ラベルをサポートしま

す。Origin C コードを使って、ラベルを表示/非表示するか、指定した列ラベルにテキストを追加しま

す。

Worksheet wks; wks.Create(); Grid gg; gg.Attach(wks); // パラメータラベルが表示されていない場合、表示 bool bShow = gg.IsLabelsShown(RCLT_PARAM); if( !bShow ) gg.ShowLabels(RCLT_PARAM); wks.Columns(0).SetLongName("X Data"); wks.Columns(1).SetLongName("Y Data"); wks.Columns(0).SetComments("This is a test"); wks.Columns(0).SetUnits("AA"); wks.Columns(1).SetUnits("BB"); // テキストを 2 列のパラメータラベルに配置 wks.Columns(0).SetExtendedLabel("Param A", RCLT_PARAM); wks.Columns(1).SetExtendedLabel("Param B", RCLT_PARAM);

5.3 行列シート


RCLT_PARAM は、パラメータ列ラベルの型で、他の型については、

OriginC\system\oc_const.h ファイルの ROWCOLLABELTYPE をご覧くだ

さい。

5.2.5 数式で値をセットする DataObject::SetFormula および DataObject::ExecuteFormula メソッッドは、列/行列値をセット

するのに使われ、値の設定ダイアログで値をセットするのと同じです。次のサンプルは、3 つの列を

持つワークシートを作成し、数式で各列に値をセットします。

Worksheet wks; wks.Create("origin", CREATE_VISIBLE); wks.AddCol(); // 初の列に値をセット Column colA; colA.Attach(wks, 0); colA.SetFormula("5*(i-1)"); colA.ExecuteFormula(); // 次の 2 つの列に対しては Recalculate = Auto をセット Column colB; colB.Attach(wks, 1); colB.SetFormula("sin(4*col(A)*pi/180)", AU_AUTO); colB.ExecuteFormula(); // 実行前の処理スクリプトで宣言された変数を使う Column colC; colC.Attach(wks, 2); string strExpression = "cos(Amp*x*pi/180)"; string strBeforeScript = "double Amp=4.5;" + "¥r¥n" + "range x=col(A);"; string strFormula = strExpression + STR_COL_FORMULAR_SEPARATOR + strBeforeScript; colC.SetFormula(strFormula, AU_AUTO); colC.ExecuteFormula();

5.3 行列シート Origin C は、行列シートを操作する MatrixLayer クラスを提供しています。行列シートは、行列

(matrix)オブジェクトのコレクションです。

5.3.1 行列オブジェクトにアクセスする // 名前を使って 1 つの行列ページに接続

5.4 行列


MatrixPage matPage("MBook3"); // 行列ページから MSheet1 というシートに接続 // インデックスで行列ページからシートを取得することも可 MatrixLayer ml1 = matPage.Layers("MSheet1"); // インデックスでシートから行列オブジェクトを取得 MatrixObject mo = ml1.MatrixObjects(0); // 行列オブジェクトのデータ型は行列ウィンドウで一貫性を維持 if( FSI_SHORT == mo.GetInternalDataType() ) { matrix<short>& mat = mo.GetDataObject(); }

5.3.2 行列オブジェクトの追加と削除 // 行列オブジェクトをシートに追加 MatrixLayer ml = Project.ActiveLayer(); // Get active matrix sheet int nNum = 1; // 追加する行列オブジェクトの数 int nPos = -1; // -1 は、後に追加 int nDataType = -1; // 任意、double 型に対してのデフォルトは-1 int index = ml.Insert(nNum, nPos, nDataType); // 初のインデックスを返す // シートから行列オブジェクトを削除 MatrixLayer ml = Project.ActiveLayer(); // アクティブな行列シートを取得 // 初から 2 つの行列オブジェクトを削除 int nPos = 0; int nNum = 2; ml.Delete(nPos, nNum);

5.3.3 データまたはイメージとして表示を設定 // イメージビューにセット MatrixLayer ml = Project.ActiveLayer(); // アクティブ行列シートを取得 int nImgIndex = 0; MatrixObject mo = ml.MatrixObjects(nImgIndex); if( !mo.IsImageView() ) { BOOL bAllObjs = FALSE; ml.SetViewImage(TRUE, bAllObjs, nImgIndex); }

5.4 行列


5.4 行列 Origin C の MatrixObject クラスは行列を取り扱うことができ、次数、データ型、データフォーマット、

値の設定などを制御できます。それぞれについては下記の関連セクションをご覧ください。

5.4.1 次数

行列の行数と列数 // 行数と列数を取得 MatrixLayer ml = Project.ActiveLayer(); // アクティブ行列シートを取得 MatrixObject mo = ml.MatrixObjects(0); // 初の行列オブジェクトを取得 int nNumRows = mo.GetNumRows(); // 行番号を取得 int nNumCols = mo.GetNumCols(); // 列番号を取得

行列の次数をセットする // 行数と列数をセット MatrixLayer ml = Project.ActiveLayer(); // アクティブ行列シートを取得 MatrixObject mo = ml.MatrixObjects(0); // 初のオブジェクトを取得 int nNumRows = 5, nNumCols = 5; mo.SetSize(nNumRows, nNumCols); // 5x5 で次数をセット

5.4.2 データ型とフォーマット

データ型の取得とセット // データ型の取得とセット MatrixLayer ml = Project.ActiveLayer(); // アクティブ行列シートを取得 MatrixObject mo = ml.MatrixObjects(0); if( mo.GetInternalDataType() != FSI_BYTE ) // データ型を取得 { // OCD_RESTORE はデータをバックアップし // 型を変更した後元に戻す DWORD dwFlags = OCD_RESTORE; mo.SetInternalDataType(FSI_BYTE, dwFlags); // データ型をセット }

5.4 行列


データフォーマットの取得とセット // データフォーマットを取得およびセット MatrixLayer ml = Project.ActiveLayer(); // アクティブ行列シートを取得 MatrixObject mo = ml.MatrixObjects(0); int nFormat = mo.GetFormat(); // OKCOLTYPE_NUMERIC( = 0)のみサポート mo.SetFormat(OKCOLTYPE_NUMERIC);

5.4.3 ラベル行列ラベルには、X, Y, Z に対するロングネーム、単位、コメントを含みます。X および Y のラベルは

行列シート内のすべての行列オブジェクトに対するもので、Z のラベルは各行列オブジェクトに対す

るものです。次のコードは、ラベルを取得し、セットする方法を示します。

XY ラベルをセットする MatrixPage mp("MBook1"); MatrixLayer ml = mp.Layers(0); // 初の行列シート Tree tr; tr.Root.Dimensions.X.LongName.strVal = "X Values"; tr.Root.Dimensions.X.Unit.strVal = "X Units"; tr.Root.Dimensions.X.Comment.strVal = "X Comment"; tr.Root.Dimensions.Y.LongName.strVal = "Y Values"; tr.Root.Dimensions.Y.Unit.strVal = "Y Units"; tr.Root.Dimensions.Y.Comment.strVal = "Y Comment"; // XY ラベルに対する行列シートのフォーマットをセット if( 0 == ml.UpdateThemeIDs(tr.Root) ) ml.ApplyFormat(tr, true, true);

XY ラベルを取得する MatrixPage mp("MBook1"); MatrixLayer ml = mp.Layers(0); // 初の行列シート // 行列オブジェクトではなく、行列シートから XY ラベルを取得 Tree tr; tr = ml.GetFormat(FPB_ALL, FOB_ALL, TRUE, TRUE); TreeNode trX = tr.Root.Dimensions.X; if( !trX.LongName.IsEmpty() ) printf("X Long Name:%s¥n", trX.LongName.strVal); if( !trX.Unit.IsEmpty() ) printf("X Unit:%s¥n", trX.Unit.strVal); if( !trX.Comment.IsEmpty() )

5.4 行列


printf("X Comment:%s¥n¥n", trX.Comment.strVal); TreeNode trY = tr.Root.Dimensions.Y; if( !trY.LongName.IsEmpty() ) printf("Y Long Name:%s¥n", trY.LongName.strVal); if( !trY.Unit.IsEmpty() ) printf("Y Unit:%s¥n", trY.Unit.strVal); if( !trY.Comment.IsEmpty() ) printf("Y Comment:%s¥n", trY.Comment.strVal);

Z ラベルをセットする MatrixPage mp("MBook1"); MatrixLayer ml = mp.Layers(0); // 初の行列シート MatrixObject mo = ml.MatrixObjects(0);// 初の行列オブジェクト // フォーマットツリーを構築し、ツリーノードに文字列値を割り当て Tree tr; tr.Root.LongName.strVal = "Z Long Name"; tr.Root.Unit.strVal = "Z Units"; tr.Root.Comment.strVal = "Z Comment"; // ここで、Z ラベルをセットするのに、行列シートではなく、行列オブジェクトのフォーマットを適用 if( 0 == mo.UpdateThemeIDs(tr.Root) ) // add id for each tree node mo.ApplyFormat(tr, true, true); // 適用

Z ラベルを取得する MatrixPage mp("MBook1"); MatrixLayer ml = mp.Layers(0); // 初の行列シート MatrixObject mo = ml.MatrixObjects(0); Tree tr; tr = mo.GetFormat(FPB_ALL, FOB_ALL, TRUE, TRUE); printf("Z Short Name:%s¥n", tr.Root.ShortName.strVal); if( !tr.Root.LongName.IsEmpty() )// if 空でない printf("Z Long Name is %s¥n", tr.Root.LongName.strVal); if( !tr.Root.Unit.IsEmpty() ) printf("Z Unit is %s¥n", tr.Root.Unit.strVal); if( !tr.Root.Comment.IsEmpty() ) printf("Z Comment is %s¥n", tr.Root.Comment.strVal);

5.4 行列


5.4.4 データ値

行列と定数値の積 MatrixLayer ml = Project.ActiveLayer(); // アクティブ行列シートを取得 MatrixObject mo = ml.MatrixObjects(0); // 初の行列シートを取得 //行列ウィンドウの内部データオブジェクトの参照を取得 //ここで、行列のデータ型は double とする matrix<double>& mat = mo.GetDataObject(); // 行列の各データに 10 を掛ける mat = mat * 10;

2 つの行列の積 // 2 つの行列ページに接続 MatrixPage matPage1("MBook1"); MatrixPage matPage2("MBook2"); if( !matPage1 || !matPage2 ) return; // ページから名前またはインデックスで行列シートを取得 MatrixLayer matLayer1 = matPage1.Layers("MSheet1"); MatrixLayer matLayer2 = matPage2.Layers(1); // get the second sheet if( !matLayer1 || !matLayer2 ) return; // インデックスで行列シートから行列オブジェクトを取得、名前は不可 MatrixObject mo1 = matLayer1.MatrixObjects(0); MatrixObject mo2 = matLayer2.MatrixObjects(0); // 行列ウィンドウの内部データオブジェクトの参照を取得 matrix<double>& mat1 = mo1.GetDataObject(); matrix<double>& mat2 = mo2.GetDataObject(); // 新しい行列ウィンドウを準備 MatrixPage matPageNew; matPageNew.Create("Origin"); MatrixLayer mlNew = matPageNew.Layers(0); MatrixObject moNew = mlNew.MatrixObjects(0); matrix<double>& matNew = moNew.GetDataObject(); // mat1 から新しい行列に値をコピー matNew = mat1; // 2 つの行列の要素を要素毎に乗算し // 結果を新しく作成した行列ウィンドウに配置 matNew.DotMultiply(mat2);

5.5 仮想行列


5.4.5 数式で値をセットする DataObject::SetFormula および DataObject::ExecuteFormula メソッッドは、列/行列値をセット

するのに使われ、値の設定ダイアログで値をセットするのと同じです。下記のサンプルは、数式を使

って行列オブジェクトに値をセットする方法を示しています。

// 新規行列ウィンドウ MatrixPage matPage; matPage.Create("Origin"); MatrixLayer ml = matPage.Layers(); // アクティブ行列シート // 数式をセットし、実行 MatrixObject mo = ml.MatrixObjects(0); // 初の行列オブジェクト mo.SetFormula("sin(i) + cos(j)"); mo.ExecuteFormula();

5.5 仮想行列ワークシートウィンドウから仮想行列を構築することができます。仮想行列の XYZ データに対するワ

ークシートのデータ範囲を別々に取得します。X および Y データを指定しない場合、デフォルトデー

タが自動的に使われます。次のコードはアクティブワークシートウィンドウから仮想行列を構築し、こ

の仮想行列をグラフにプロットする方法を示しています。

// 実行する前に、アクティブワークシートにデータがあることを確認してください。 // 例えば、新しいワークシートウィンドウを作成し、 // Origin の Samples¥Matrix Conversion and Gridding サブフォルダから XYZ Random Gaussian.dat ファイルをインポート Worksheet wks = Project.ActiveLayer(); int r1, r2; int c1 = 0, c2 = 2; wks.GetBounds(r1, c1, r2, c2); // Z データでのみデータ範囲を構築すると // X と Y データは自動的に割り当て DataRange dr; dr.Add("Z", wks, r1, c1, r2, c2); MatrixObject mo; mo.Attach(dr); int nRows = mo.GetNumRows(); int nCols = mo.GetNumCols(); // デフォルトの XY 範囲を取得 double xmin, xmax, ymin, ymax; mo.GetXY(xmin, ymin, xmax, ymax); GraphPage gp;

5.6 データ操作


gp.Create("CONTOUR"); GraphLayer gl = gp.Layers(0); gl.AddPlot(mo, IDM_PLOT_CONTOUR); gl.Rescale(); mo.Detach();

XY データを割り当てたい場合、データは単調増加または現象にする必要があります。次のサンプル

は、XYZ データ範囲を持つ仮想行列を構築する方法を示します。

// アクティブレイヤには 5 列のデータがあるとする Worksheet wks = Project.ActiveLayer(); // 列 0 から 4 に対する小と大の行インデックスを取得 int r1, r2, c1 = 0, c2 = 4; wks.GetBounds(r1, c1, r2, c2); // XYZ データを持つデータ範囲オブジェクトを作成 DataRange dr; dr.Add("X", wks, 0, 1, 0, c2); // 初のセルを除く初の行 dr.Add("Y", wks, 1, 0, r2, 0); // 初のセルを除く初の列 dr.Add("Z", wks, 1, 1, r2, c2); MatrixObject mo; mo.Attach(dr);

5.6 データ操作

5.6.1 ワークシート選択を行う Worksheet::GetSelectedRange は、ワークシートから 1 つまたは複数の選択したデータを取得す

るのに使うことができます。次のコードは、ワークシート選択で 1 つの列からデータを取得する方法を

示しています。この関数は、1 つの列、1 つの行、ワークシート全体など範囲データ型を返します。

Worksheet wks = Project.ActiveLayer(); int r1, c1, r2, c2; int nRet = wks.GetSelectedRange(r1, c1, r2, c2); if( WKS_SEL_ONE_COL & nRet ) // 1 つの列だけを選択 { // 選択でデータ範囲オブジェクトを構築 DataRange dr; dr.Add("X", wks, r1, c1, r2, c2); // 選択した列からデータを取得 vector vData; dr.GetData(&vData, 0);

5.6 データ操作


}

5.6.2 ワークシート内の表示範囲を設定する Worksheet 内の表示範囲を設定する場合、Worksheet::SetBounds を使い、開始行／終了行に

設定と同じです。

次のコードは、現在のワークシートウィンドウにすべての列の開始と終了をセットする方法を示します。

Worksheet wks = Project.ActiveLayer(); // 行の開始と終了 int begin = 9, end = 19; // すべての列の開始と終了をセット int c1 = 0, c2 = -1; // -1 は終了 wks.SetBounds(begin, c1, end, c2);

5.6.3 ワークシートに大きなデータセットを配置するワークシート内で大きなデータセット(例:1000 列)を操作するとき、Origin C 関数を効率よく実行す

るためには、以下のステップを使います。

ワークシートにデータを配置する列と行を準備します。

サイズをセットするには、Worksheet::SetSize を使い、Worksheet::AddCol は使いません。

Origin が新しい列を追加するときに重複した名前を持たないように既存の列のショートネームをチェ

ックする必要があるので、事前に空のワークシートでサイズをセットし、列と行の属性は無しにします。

これにより時間が削減できます。 while( wks.DeleteCol(0) ); を使って、すべての列を削除して、空

のワークシートを作成します。

DataObject::GetInternalDataBuffer を使って、バッファでワークシート列にデータを配置します。

実行スピードを上げるために関数を実行しているとき、コードビルダは閉じておきます。

以下のサンプルコードをご覧下さい。

// ワークシートの準備 Worksheet wks; wks.Create("Origin"); while( wks.DeleteCol(0) ); int rows = 100, cols = 1000; wks.SetSize(rows, cols); // ワークシート列に 1 つずつデータを配置 foreach(Column col in wks.Columns) {

5.6 データ操作


col.SetFormat(OKCOLTYPE_NUMERIC); col.SetInternalData(FSI_SHORT); col.SetUpperBound(rows-1);//index of last row, 0 offset int nElementSize; uint nNum; LPVOID pData = col.GetInternalDataBuffer(&nElementSize, &nNum); short* psBuff = (short*)pData; // OC のループは遅いですが DLL にポインタを渡すと // 操作が高速になる。ここではポインタの動作の表示のみ for(int ii = 0; ii < rows; ii++, psBuff++) { *psBuff = (ii+1) * (col.GetIndex()+1); } col.ReleaseBuffer(); // この呼び出しを記録しない }

5.6.4 ワークシートの埋め込みグラフにアクセスする新しいグラフと新しいワークシートを作成し、1 つのワークシートセルにグラフを埋め込みます。

GraphPage gp; gp.Create("Origin"); Worksheet wks; wks.Create(); int nOptions = EMBEDGRAPH_KEEP_ASPECT_RATIO | EMBEDGRAPH_HIDE_LEGENDS; // ワークシートセル(0, 0)にグラフを配置 wks.EmbedGraph(0, 0, gp, nOptions);

ワークシート内に埋め込んだグラフに名前またはインデックスでアクセスします。

// アクティブワークシートから埋め込みグラフを取得 Worksheet wks = Project.ActiveLayer(); GraphPage gp; gp = wks.EmbeddedPages(0); // 埋め込みグラフページをインデックスで取得 gp = wks.EmbeddedPages("Graph1"); // 埋め込みグラフページを名前で取得

5.6.5 ワークシートデータのソート Sort メソッドを使って列データをソートすることができます。1 つの列をソートし、vectorbase::Sort メソッドを使います。

// 列のソート // 実行前に 2 列を持つアクティブワークシートにデータを入力

5.6 データ操作


// 例えば、¥Samples¥Mathematics¥Sine Curve.dat をワークシートにインポート Worksheet wks = Project.ActiveLayer(); Column colY(wks, 1); // Y 列 // ソートした後、 (x, y)の元の関係は崩れる vectorbase& vec = colY.GetDataObject(); vec.Sort();

ワークシート内のすべての列をソートするには、Worksheet::Sort メソッドを使います。

// ワークシートのソート // 実行前に 2 列を持つアクティブワークシートにデータを入力 // 例えば、¥Samples¥Mathematics¥Sine Curve.dat をワークシートにインポート Worksheet wks = Project.ActiveLayer(); int nCol = 1; // 2 番目の列にすべてのワークシートデータを昇順ソート BOOL bIsAscending = true; BOOL bMissingValuesSmall = TRUE; // 欠損値を小値として取り扱う int r1 = 0, c1 = 0, r2 = -1, c2 = -1; // -1 は r2 と c2 の後 // ソート後、各(x, y)は元の関係を維持 wks.Sort(nCol, bIsAscending, bMissingValuesSmall, r1, c1, r2, c2);

5.6.6 ワークシートデータをマスクする次のコードは、指定した列に対して、0 と等しいか、それより小さいデータ行にマスクをセットする方法

を示します。

int nCol = 1; Worksheet wks = Project.ActiveLayer(); Column col(wks, nCol); vector vData = col.GetDataObject(); // 0 と等しいか、それより小さいすべてのデータを見つけて、インデックスを返す vector<uint> vnRowIndex; vData.Find(MATREPL_TEST_LESSTHAN | MATREPL_TEST_EQUAL, 0, vnRowIndex); // 行と列のインデックスで追加される複数の部分範囲を含む範囲を構築 DataRange dr; for(int nn = 0; nn < vnRowIndex.GetSize(); nn++) { int r1, c1, r2, c2; r1 = r2 = vnRowIndex[nn]; c1 = c2 = nCol; dr.Add("X", wks, r1, c1, r2, c2); } // データ範囲にマスクをセット dr.SetMask();

5.6 データ操作


5.6.7 LT の条件でワークシートからデータを抽出する Worksheet::SelectRows メソッドを使ってワークシートデータを選択します。行は、複数の列をまた

がって選択できます。

// 条件を元にしたワークシートからデータを選択 // 'uint'型の vector に選択した行のインデックスを配置 Worksheet wks = Project.ActiveLayer(); // 条件式に基づくワークシートデータをチェックし、 // 行インデックスを'vnRowIndices'に出力 // LabTalk の範囲オブジェクト 'a' = column 1, 'b' = column 2 を定義 string strLTRunBeforeloop = "range a=1; range b=2"; string strCondition = "abs(a) >= 1 && abs(b) >= 1"; vector<uint> vnRowIndices; // これは出力 int r1 = 0, r2 = -1; // 行範囲, -1 は r2 の後の行 // 任意の大行数, -1 は制限なし int nMax = -1; int num = wks.SelectRows(strCondition, vnRowIndices, r1, r2, nMax, strLTRunBeforeloop);

選択をハイライトする 2 つの方法があります。初の方法は選択したインデックスをハイライトする方

法です。

// 方法 1：vnRowIndices で行をハイライト Grid gg; if( gg.Attach(wks) ) { // uint 型の vector データを int 型の vector に変換 vector<int> vnRows; vnRows = vnRowIndices; gg.SetSelection(vnRows); }

データ選択をハイライトする 2 つ目の方法は、選択した行の塗り色を指定する方法です。

// 方法 2： vnRowIndices で選択した行の色を塗りつぶす DataRange dr; // vnRowIndices で行インデックスでデータ範囲を構築 for(int index=0; index<vnRowIndices.GetSize(); index++) { // すべての列に対して 0( 初の列) および -1( 後の列) // 範囲名の変数に対して""であればデフォルト名を使用 dr.Add("", wks, vnRowIndices[index], 0, vnRowIndices[index], -1); } Tree tr; tr.Root.CommonStyle.Fill.FillColor.nVal = SYSCOLOR_BLUE; // fill color = blue tr.Root.CommonStyle.Color.nVal = SYSCOLOR_WHITE; // フォントの色 = 白

5.6 データ操作


if( 0 == dr.UpdateThemeIDs(tr.Root) ) // エラーなしで 0 を返す { bool bRet = dr.ApplyFormat(tr, true, true); }

5.6.8 2 つのワークシートのデータを比較する 2 つのワークシートの行数または列数を比較したり、データ自体を比較するのに役立ちます。

GetNumRows および GetNumCols メソッドを使って、ワークシートから行や列をカウントします。

if( wks1.GetNumRows() != wks2.GetNumRows() || wks1.GetNumCols() != wks2.GetNumCols() ) { out_str("The two worksheets are not the same size"); return; }

似たような操作を実行する別の方法は、それぞれのワークシートのデータを vector にコピーし、それ

ぞれの vector データを比較します。

// ワークシート 1 の列から 1 つずつすべてのデータを取得 vector vec1; foreach(Column col in wks1.Columns) { vector& vecCol = col.GetDataObject(); vec1.Append(vecCol); } // ワークシート 2 の列から 1 つずつすべてのデータを取得 vector vec2; foreach(col in wks2.Columns) { vector& vecCol = col.GetDataObject(); vec2.Append(vecCol); } if( vec1.GetSize() != vec2.GetSize() ) { out_str("The size of the two data sets is not equal"); return; }

データ要素自体を比較するには、上記サンプルで vector に対して、ocmath_compare_data 関数

を使います。

bool bIsSame = false; double dTolerance = 1e-10; ocmath_compare_data(vec1.GetSize(), vec1, vec2, &bIsSame, dTolerance); if( bIsSame ) { out_str("Data in the two worksheets are the same"); }

5.7 データ変換


5.7 データ変換

5.7.1 ワークシートグリッディングコマンドウィンドウで次のコマンドを実行し、nag_utils.c ファイルをコンパイルし、現在のワークスペ

ースにそれを追加します。

Run.LoadOC(Originlab¥nag_utils.c, 16);

Origin C ファイルにヘッダファイルを含めます。

#include <wks2mat.h>

#include <Nag_utils.h>

アクティブなワークシート XYZ 列から XYZ データを取得します。

// XYZ 列から XYZ データ範囲を構築

XYZRange rng;

rng.Add(wks, 0, "X");

rng.Add(wks, 1, "Y");

rng.Add(wks, 2, "Z");

// データ範囲オブジェクトから XYZ データをベクターに取得

vector vX, vY, vZ;

rng.GetData(vZ, vY, vX);

元のデータ型を調査します。例えば、XY 等間隔配置、疎データ

UINT nVar;

double xmin, xstep, xmax, ymin, ystep, ymax;

int nSize = vX.GetSize();

int nMethod = ocmath_xyz_examine_data(nSize, vX, vY, vZ, 1.0e-8, 1.0e-8,

&nVar, &xmin, &xstep, &xmax, &ymin, &ystep, &ymax);

結果のワークシートウィンドウに対する行と列の数を計算します。

int nRows = 10, nCols = 10;

if( 0 == nMethod || 1 == nMethod ) // XY 等間隔配置または疎データ

{

double dGap = 1.5;

if( !is_equal(ystep, 0) )

nRows = abs(ymax - ymin)/ystep + dGap;

5.7 データ変換


if( !is_equal(xstep, 0) )

nCols = abs(xmax - xmin)/xstep + dGap;

}

結果の行列ウィンドウを準備します。

// グリッディング結果を配置する行列ウィンドウを準備

MatrixPage mp;

mp.Create("origin"); // 行列ウィンドウを作成

MatrixLayer ml = mp.Layers(0); // 初の行列シートを取得

MatrixObject mo(ml, 0); // 初の行列オブジェクトを取得

mo.SetXY(xmin, ymin, xmax, ymax); // X および Y に対してセット

mo.SetSize(nRows, nCols); // 行と列の数をセット

異なるメソッドで XYZ グリッディングを行う

matrix& mat = mo.GetDataObject(); // 行列オブジェクトからデータオブジェクトを取得

int iRet;

switch(nMethod)

{

case 0:// XY 等間隔

iRet = ocmath_convert_regular_xyz_to_matrix(nSize, vX, vY, vZ,

mat, xmin, xstep, nCols, ymin, ystep, nRows);

printf("--- %d: regular conversion ---¥n", iRet);

break;

case 1:// 疎データ

iRet = ocmath_convert_sparse_xyz_to_matrix(nSize, vX, vY, vZ,

mat, xmin, xstep, nCols, ymin, ystep, nRows);

printf("--- %d: sparse conversion ---¥n", iRet);

break;

case 2:// ランダム(Renka Cline)

vector vxGrid(nRows*nCols), vyGrid(nRows*nCols);

iRet = ocmath_mat_to_regular_xyz(NULL, nRows, nCols, xmin,

xmax, ymin, ymax, vxGrid, vyGrid);

if( iRet >= 0 )

{

iRet = xyz_gridding_nag(vX, vY, vZ, vxGrid, vyGrid, mat);

5.7 データ変換


}

printf("--- %d: random conversion ---¥n", iRet);

break;

default:// エラー

printf("--- Error:Other method type ---¥n");

}

91

66 グラフ GraphPage クラスはグラフウィンドウに対して操作するものです。各グラフウィンドウに GraphPageオブジェクトがあります。GraphPage オブジェクトは、複数レイヤを含みます。これらのレイヤは、

GraphLayer オブジェクトです。

既存のグラフにアクセスする既存のグラフにアクセスする方法が複数あります。使用する方法は、ワークブックや行列ブックに対し

て使われるのと同じです。

グラフの名前をクラスコンストラクタに渡してグラフにアクセスできます。

GraphPage grPg("Graph1"); if( grPg ) // "Graph1"というグラフがあれば grPg.SetName("MyGraph1"); // その名前を変更

Project クラスは、プロジェクト内のすべてのグラフのコレクションを含みます。次の例は、グラフコレク

ションをループし、各グラフの名前を出力する方法を示しています。

foreach(GraphPage grPg in Project.GraphPages) out_str(grPg.GetName()); // グラフ名の出力

Collection クラスの Item メソッドにグラフの 0 から始まるインデックスを渡して、グラフにアクセスでき

ます。

GraphPage grPg; grPg = Project.GraphPages.Item(2); if( grPg ) // 3 番目のグラフがあれば out_str(grPg.GetName()); // グラフ名を出力

グラフを削除するすべての Origin C の内部クラスは、OriginObject クラスから派生したものです。このクラスは、オブ

ジェクトを破棄するのに使用する Destroy メソッドがあります。グラフに対してこのメソッドを呼ぶとグ

ラフ、グラフ内のすべてのレイヤ、各レイヤのすべてのグラフオブジェクトを削除します。

GraphPage grPg; grPg = Project.GraphPages.Item(0); // プロジェクト内の初のグラフを取得 if( grPg ) // グラフがあれば grPg.Destroy(); // グラフを削除

6.1 グラフの作成と編集

92 グラフ


6.1.1 グラフウィンドウを作成する Create メソッドを使って新しいグラフを作成します。

GraphPage gp; gp.Create("3D"); //3D テンプレートを使ってグラフを作成

6.1.2 グラフページのフォーマットを取得する GraphPage gp("Graph1"); Tree tr; tr = gp.GetFormat(FPB_ALL, FOB_ALL, true, true); out_tree(tr);

6.1.3 グラフページのフォーマットをセットする次のサンプルコードは、2 色のグラデーションでページの背景色をセットする方法を示しています。

Tree tr; tr.Root.Background.BaseColor.nVal = SYSCOLOR_RED; tr.Root.Background.GradientControl.nVal = 1; tr.Root.Background.GradientColor.nVal = SYSCOLOR_BLUE; GraphPage gp("Graph1"); if(0 == gp.UpdateThemeIDs(tr.Root) ) gp.ApplyFormat(tr, true, true);

6.1.4 グラフレイヤのフォーマットを取得する GraphLayer gl = Project.ActiveLayer(); Tree tr; tr = gl.GetFormat(FPB_ALL, FOB_ALL, true, true); out_tree(tr);

6.1.5 グラフレイヤのフォーマットをセットする以下のサンプルコードは、グラフレイヤオブジェクトの背景を黒線フォーマットにセットする方法を示し

ます。


グラフ 93

GraphLayer gl = Project.ActiveLayer(); Tree tr; tr.Root.Background.Border.Color.nVal = SYSCOLOR_BLACK; tr.Root.Background.Border.Width.nVal = 1; tr.Root.Background.Fill.Color.nVal = SYSCOLOR_WHITE; if( 0 == gl.UpdateThemeIDs(tr.Root) ) gl.ApplyFormat(tr, true, true);

6.1.6 追加の線を表示するこのサンプルは、追加の線、Y=0/X=0 での線、反対の線を表示する方法を示しています。

GraphLayer gl = Project.ActiveLayer(); Axis axesX = gl.XAxis; axesX.Additional.ZeroLine.nVal = 1; // Y = 0 の線を表示 axesX.Additional.OppositeLine.nVal = 1; // X 軸の反対の線を表示

6.1.7 グリッド線を表示するこのサンプルは、グリッド線の表示方法および色付けの方法を示しています。

色の値は、Origin の内部のカラーパレットまたは RGB 値へのインデックスにすることができます。色

の値についての詳細はデータ型と変数の色をご覧ください。

GraphLayer gl = Project.ActiveLayer(); Axis axisY = gl.YAxis; Tree tr; // 主グリッド表示 TreeNode trProperty = tr.Root.Grids.HorizontalMajorGrids.AddNode("Show"); trProperty.nVal = 1; tr.Root.Grids.HorizontalMajorGrids.Color.nVal = RGB2OCOLOR(RGB(100, 100, 220)); tr.Root.Grids.HorizontalMajorGrids.Style.nVal = 1; // 実線 tr.Root.Grids.HorizontalMajorGrids.Width.dVal = 1; // 副グリッド表示 trProperty = tr.Root.Grids.HorizontalMinorGrids.AddNode("Show"); trProperty.nVal = 1; tr.Root.Grids.HorizontalMinorGrids.Color.nVal = SYSCOLOR_GREEN; // 緑 tr.Root.Grids.HorizontalMinorGrids.Style.nVal = 2; // ドット tr.Root.Grids.HorizontalMinorGrids.Width.dVal = 0.3; if(0 == axisY.UpdateThemeIDs(tr.Root) ) { bool bRet = axisY.ApplyFormat(tr, true, true); }


94 グラフ

6.1.8 軸スケールを設定するこのサンプルは、スケールのパラメータ、増分、スケールタイプなどをセットする方法を示しています。

GraphLayer gl = Project.ActiveLayer(); Axis axesX = gl.XAxis; axesX.Scale.From.dVal = 0; axesX.Scale.To.dVal = 1; axesX.Scale.IncrementBy.dVal = 0.2; axesX.Scale.Type.nVal = 0;// 線形 axesX.Scale.Rescale.nVal = 0; // 再スケールタイプ axesX.Scale.RescaleMargin.dVal = 8; // 8 パーセント

6.1.9 軸フォーマットを取得する GraphLayer gl = Project.ActiveLayer(); Axis axisX = gl.XAxis; // すべての軸フォーマット設定をツリーに取得 Tree tr; tr = axisX.GetFormat(FPB_ALL, FOB_ALL, true, true); out_tree(tr);

6.1.10 軸ラベルを設定する軸ラベルは、通常のテキストオブジェクトであり、GraphObject クラスを使って Origin C でアクセス

できます。デフォルトグラフでは、X 軸は XB という名前で、Y 軸は YL という名前になっています。

次のコードは、X および Y 軸ラベルにアクセスする方法を示し、デフォルトグラフがアクティブページ

とします。

GraphLayer gl = Project.ActiveLayer(); // アクティブグラフレイヤ GraphObject grXL = gl.GraphObjects("XB"); // X 軸ラベルを取得 GraphObject grYL = gl.GraphObjects("YL"); // Y 軸ラベルを取得

これで、軸ラベルにアクセスし、値を変更できます。次のコードは、X 軸ラベルを直接セットし、Y 軸ラ

ベルを LabTalk 文字列変数にリンクすることで間接的にセットします。LabTalk 変数へのリンクは、

ラベルのプログラミング制御オプション"変数へリンク"を有効にする必要があります。このオプションは

デフォルトで有効になっています。

grXL.Text = "My New X Asis Label"; LT_set_str("abc$", "My String Variable"); grYL.Text = "%(abc$)";

ラベルが変わったことを確認するには、グラフページをリフレッシュする必要があります。

GraphLayer オブジェクトを使って、次のコードでページをリフレッシュできます。


グラフ 95

gl.GetPage().Refresh();

6.1.11 上 X 軸を表示するこのサンプルは、上 X 軸を表示する方法を示します。

// 軸と刻みを表示 Tree tr; TreeNode trProperty = tr.Root.Ticks.TopTicks.AddNode("Show"); trProperty.nVal = 1; // 軸ラベルを表示 trProperty = tr.Root.Labels.TopLabels.AddNode("Show"); trProperty.nVal = 1; GraphLayer gl = Project.ActiveLayer(); Axis axesX = gl.XAxis; if(0 == axesX.UpdateThemeIDs(tr.Root) ) { bool bRet = axesX.ApplyFormat(tr, true, true); }

6.1.12 軸刻みを編集するこのサンプルは、軸ダイアログ->軸の主要設定(タイトル・形態)でフォーマットをセットする方法を示

しています。

GraphLayer gl = Project.ActiveLayer(); Axis axesX = gl.XAxis; Tree tr; // データプロットの色を従って、刻みの色を自動にセット tr.Root.Ticks.BottomTicks.Color.nVal = INDEX_COLOR_AUTOMATIC; tr.Root.Ticks.BottomTicks.Width.dVal = 3; tr.Root.Ticks.BottomTicks.Major.nVal = 0; // 0:刻みの両側表示 tr.Root.Ticks.BottomTicks.Minor.nVal = 2; // 2:外側 tr.Root.Ticks.BottomTicks.Style.nVal = 0; // 実線 if(0 == axesX.UpdateThemeIDs(tr.Root) ) bool bRet = axesX.ApplyFormat(tr, true, true);

6.1.13 軸目盛ラベルを編集するこのサンプルは、指定した位置で軸ラベルをセットする方法を示します。軸ダイアログの軸目盛のカ

スタム化タブで同じ操作を行うことができます。

GraphLayer gl = Project.ActiveLayer(); Axis axesX = gl.XAxis;

6.2 データプロットを追加する

96 グラフ

Tree tr; // スケール値として軸の開始と終了を表示 tr.Root.Labels.BottomLabels.Custom.Begin.Type.nVal = 2; tr.Root.Labels.BottomLabels.Custom.End.Type.nVal = 2; // 特別な値とテキストを特定のポイントにセット tr.Root.Labels.BottomLabels.Custom.Special.Type.nVal = 3; tr.Root.Labels.BottomLabels.Custom.Special.Label.strVal = "Mid"; tr.Root.Labels.BottomLabels.Custom.Special.Value.dVal = 12; if(0 == axesX.UpdateThemeIDs(tr.Root) ) { bool bRet = axesX.ApplyFormat(tr, true, true); }

6.2 データプロットを追加するプロットまたはデータプロットは、グラフレイヤ内のデータ表示です。各グラフレイヤには 1 つ以上

のプロットが含まれます。

6.2.1 2D プロット (XY, Y エラー, 縦棒/横棒)

XY 散布図をプロットする次のコードは、アクティブワークシートから XYYErr データ範囲を構築する方法を示し、新しく作成し

たグラフでデータ範囲をプロットします。

Worksheet wks = Project.ActiveLayer(); // 範囲名は、X, Y, Z, ED(YErr)にする DataRange dr; dr.Add(wks, 0, "X"); // X データは第 1 列 dr.Add(wks, 1, "Y"); // Y データは第 2 列 dr.Add(wks, 2, "ED"); // 任意で、Y エラーが第 3 列 // グラフウィンドウを作成 GraphPage gp; gp.Create("Origin"); GraphLayer gl = gp.Layers(); // アクティブレイヤを取得 // XY データ範囲を散布図としてプロット // IDM_PLOT_SCATTER はプロットタイプの ID で、他のプロットタイプ ID は oPlotIDs.h ファイル int nPlotIndex = gl.AddPlot(dr, IDM_PLOT_SCATTER); // プロットインデックス(オフセットは 0)を返す、エラーは-1 を返す if( nPlotIndex >= 0 )


グラフ 97

{ gl.Rescale(); // 軸を再スケールしすべてのデータポイントを表示 }

YErr プロットを接続する YErr データを既存の XY データプロットに接続します。

GraphLayer gl = Project.ActiveLayer(); DataPlot dp = gl.DataPlots(-1); // アクティブデータプロットを取得 // Y エラー列を取得 WorksheetPage wksPage("Book1"); Worksheet wks = wksPage.Layers(); Column colErrBar(wks, 2); // アクティブデータプロットに Y エラー列をプロット Curve crv(dp); int nErrPlotIndex = gl.AddErrBar(crv, colErrBar); out_int("nErrPlotIndex = ", nErrPlotIndex);

縦棒/横棒グラフ // 実行する前にアクティブウィンドウがワークシートであることを確認 Worksheet wks = Project.ActiveLayer(); DataRange dr; dr.Add(wks, 1, "Y"); // 1 列を持つデータ範囲を構築 GraphPage gp; gp.Create("BAR"); // 指定したテンプレートでグラフを作成 GraphLayer gl = gp.Layers(-1); // アクティブグラフレイヤを取得 int index = gl.AddPlot(dr, IDM_PLOT_BAR); if( index >= 0 ) { out_str("Plot bar"); gl.Rescale(); }

6.2.2 3D プロット行列からグラフウィンドウに 3D 曲面図をプロットします。

// 行列データを準備する MatrixLayer ml; string strFile = GetAppPath(true) + "Samples¥¥Matrix Conversion and Gridding¥¥ 2D Gaussian.ogm"; ml.Open(strFile); MatrixObject mo = ml.MatrixObjects(0);


98 グラフ

// テンプレートでグラフページを作成 GraphPage gp; gp.Create("CMAP"); GraphLayer gl = gp.Layers(0); // 3D 曲面図をプロット int nPlotIndex = gl.AddPlot(mo, IDM_PLOT_SURFACE_COLORMAP); if(0 == nPlotIndex) { gl.Rescale(); printf("3D Surface plotted successfully¥n"); }

6.2.3 等高線図

XYZ 等高線をプロットする // 実行前に、アクティブワークシートウィンドウに XYZ データが // あることを確認または、¥Samples¥Matrix Conversion and Gridding¥ // XYZ Random Gaussian.dat をワークシートにインポート Worksheet wks = Project.ActiveLayer(); DataRange dr; dr.Add(wks, 0, "X"); dr.Add(wks, 1, "Y"); dr.Add(wks, 2, "Z"); // テンプレートでグラフを作成 GraphPage gp; gp.Create("TriContour"); GraphLayer gl = gp.Layers(); // タイプ ID で XYZ 等高線をプロット int nPlot = gl.AddPlot(dr, IDM_PLOT_TRI_CONTOUR); if( nPlot >= 0 ) { gl.Rescale(); printf("XYZ contour plotted successfully¥n"); }

カラーマップ等高線図をプロットする MatrixLayer ml = Project.ActiveLayer(); MatrixObject mo = ml.MatrixObjects(0); // テンプレートでグラフウィンドウを作成 GraphPage gp; gp.Create("contour"); GraphLayer gl = gp.Layers();


グラフ 99

int nPlot = gl.AddPlot(mo, IDM_PLOT_CONTOUR); if( nPlot >= 0 ) { gl.Rescale(); }

6.2.4 イメージプロット MatrixLayer ml = Project.ActiveLayer(); MatrixObject mo = ml.MatrixObjects(0); // テンプレートでグラフウィンドウを作成 GraphPage gp; gp.Create("image"); GraphLayer gl = gp.Layers(); int nPlot = gl.AddPlot(mo, IDM_PLOT_MATRIX_IMAGE); if( nPlot >= 0 ) { gl.Rescale(); }

6.2.5 複数軸次のサンプルコードは、1 つのグラフレイヤ内の 4 つの軸－左、下、右、上の表示/非表示をセットし、

フォーマットをセットする方法を示します。

#include <..¥Originlab¥graph_utils.h> // AXIS_*で必要 GraphLayer gl = Project.ActiveLayer(); // すべての軸とラベルを表示 0 または 1, 表示は 1 vector<int> vnAxes(4), vnLabels(4), vnTitles(4); vnAxes[AXIS_BOTTOM] = 1; vnAxes[AXIS_LEFT] = 1; vnAxes[AXIS_TOP] = 1; vnAxes[AXIS_RIGHT] = 1; vnLabels = vnAxes; // 左と下の軸の軸タイトルを表示 0 または 1, 表示は 1 vnTitles[AXIS_BOTTOM] = 1; vnTitles[AXIS_LEFT] = 1; vnTitles[AXIS_TOP] = 0; vnTitles[AXIS_RIGHT] = 0; // すべての軸の主刻みと副刻みを内側にセット // 他のオプションについては graph_utils.h の TICK_*項目を参照 vector<int> vnMajorTicks(4), vnMinorTicks(4); vnMajorTicks[AXIS_BOTTOM] = TICK_IN; vnMajorTicks[AXIS_LEFT] = TICK_IN; vnMajorTicks[AXIS_TOP] = TICK_IN;


100 グラフ

vnMajorTicks[AXIS_RIGHT] = TICK_IN; vnMinorTicks = vnMajorTicks; gl_smart_show_object(gl, vnAxes, vnLabels, vnTitles, vnMajorTicks, vnMinorTicks);

6.2.6 複数区分グラフ(X 軸を共有した複数レイヤ) 次のサンプルは、1 つのグラフページに複数のグラフレイヤを構築し、すべてのレイヤの X 軸を共有

し、XY データセットをワークシートデータから各グラフレイヤにプロットする方法を示します。

次のコードをコンパイルする前に、現在のワークスペースに graph_utils.c をビルドする次のコマンド

を実行する必要があります。

run.LoadOC(Originlab¥graph_utils.c, 16);

次の Origin C コードをコンパイルします。実行する前に、1 つの X 列と少なくとも 2 つの Y 列を持

つ Book1 というワークブックがあることを確認します。

#include <..¥Originlab¥graph_utils.h> // page_add_layer 関数に対して必要 // Construct data range from Book1 WorksheetPage wksPage("Book1"); Worksheet wks = wksPage.Layers(0); // Book1 の初のワークシート DataRange dr; dr.Add(wks, 0, "X"); // X データを第 1 列 dr.Add(wks, 1, "Y", -1); // 後のＹデータを第 2 列 // Y の数を取得 DWORD dwRules = DRR_GET_DEPENDENT | DRR_NO_FACTORS; int nNumYs = dr.GetNumData(dwRules); // 右軸を持つレイヤを追加し、初のレイヤにリンク GraphPage gp; gp.Create("Origin"); while ( gp.Layers.Count() < nNumYs ) { page_add_layer(gp, false, false, false, true, ADD_LAYER_INIT_SIZE_POS_MOVE_OFFSET, false, 0, LINK_STRAIGHT); } // 各 XY データからグラフレイヤにプロットを追加 foreach(GraphLayer gl in gp.Layers) { int nLayerIndex = gl.GetIndex(); // dr から部分 XY 範囲を取得 DataRange drOne; dr.GetSubRange(drOne, dwRules, nLayerIndex); // 1 つの XY 範囲をグラフレイヤにプロット int nPlot = gl.AddPlot(drOne, IDM_PLOT_LINE); if( nPlot >= 0 ) {

6.3 データプロットを編集する

グラフ 101

DataPlot dp = gl.DataPlots(nPlot); dp.SetColor(nLayerIndex); // データプロットを異なる色にセット // 右 Y 軸の軸刻みと軸ラベルの色を自動にセット gl.YAxis.AxisObjects(AXISOBJPOS_AXIS_SECOND).RightTicks.Color.nVal = gl.YAxis.AxisObjects(AXISOBJPOS_LABEL_SECOND).RightLabels.Color.nVal = INDEX_COLOR_AUTOMATIC; gl.Rescale(); } }


6.3.1 データマーカーを追加する Origin C は、データマーカを編集するのに次のメソッドをサポートします。

DataPlot::AddDataMarkers は、選択した部分範囲にデータプロットのデータマーカを追

加します。 DataPlot::SetDataMarkers は、現在のデータマーカの位置を変更します。 DataPlot::GetDataMarkers は、すべての既存のデータプロットを取得します。 DataPlot::RemoveDataMarker は、指定したデータマーカを削除します。

次のコードは、アクティブグラフに 2 つのデータマーカを追加する方法を示しています。

GraphLayer gl = Project.ActiveLayer(); DataPlot dp = gl.DataPlots(); // データマーカのインデックス vector<int> vnBegin = {0, 9}; vector<int> vnEnd = {4, 14}; // 2 つのデータマーカを追加 int nRet = dp.AddDataMarkers(vnBegin, vnEnd); if( 0 == nRet ) { out_str("Add data marker successfully."); }

以下のコードは、現在のデータマーカの位置を変更します。

GraphLayer gl = Project.ActiveLayer(); DataPlot dp = gl.DataPlots(); // データマーカのインデックス vector<int> vnBegin = {11, 2};


102 グラフ

vector<int> vnEnd = {19, 5}; vector<int> vnIndices = {1, 0}; // 2 つのデータマーカを追加 int nRet = dp.SetDataMarkers(vnBegin, vnEnd, vnIndices); if( 0 == nRet ) { out_str("Set data marker successfully."); gl.GetPage().Refresh(); }

6.3.2 色をセットする次のサンプルコードは、データプロットの色をセットする方法を示します。

GraphLayer gl = Project.ActiveLayer(); DataPlot dp = gl.DataPlots(0); bool bRepaint = true; dp.SetColor(SYSCOLOR_GREEN, bRepaint);

6.3.3 フォーマットツリーを取得する OriginObject::GetFormat と OriginObject::ApplyFormat は、Origin オブジェクトフォーマット

を取得するのに使われます。次のフォーマットの取得、セット、コピーのメカニズムは、OriginObjectの基底クラスから派生するクラスを持つすべての Origin オブジェクトに対して使うことができます。

(参照：クラスの階層).例えば、Origin オブジェクトは、DataPlot クラス, Worksheet クラス, WorksheetPage クラス, MatrixLayer クラス, MatrixPage クラス, GraphLayer クラス, GraphPage クラスのオブジェクトにすることができます。

DataPlot クラスは、DataObjectBase クラスから派生され、DataObjectBase クラスは、

OriginObject クラスがら派生されるので、DataPlot::GetFormat を呼び出して、フォーマットツリー

構造を取得できます。

次のコードを使って、フォーマットツリー構造を見る 2 つの方法があります。

次のコードで、GetFormat の行にブレークポイントを設定し、1 つのデータをアクティブにし、コード

を実行し、F10 を押し(ステップオーバー)、GetFormat 行を実行し、コードビルダのローカル変数ウ

ィンドウで、tr 変数のフォーマットツリーの詳細を見ます。(Alt+4 を押し、ローカル変数ウィンドウを開

いたり、閉じたりできます。)

後の行 out_tree(tr);, を使って、フォーマットツリーを出力します。

GraphLayer gl = Project.ActiveLayer(); DataPlot dp = gl.DataPlots(-1); // アクティブデータプロットを取得 // 異なるプロットタイプ(例えば、折れ線、ボックスチャート...) は


グラフ 103

// フォーマットツリーの異なる構造を持ちます。 Tree tr; // ツリー構造の詳細を表示するフォーマットツリーを取得 tr = dp.GetFormat(FPB_ALL, FOB_ALL, true, true); out_tree(tr); // フォーマットツリーを取得

6.3.4 折れ線グラフのフォーマットをセットする GraphLayer gl = Project.ActiveLayer(); DataPlot dp = gl.DataPlots(-1); // アクティブデータプロットを取得 // 折れ線プロットのフォーマットをセット // Note:フォーマットツリーの構造を取得するには前のセクションを参照 Tree tr; tr.Root.Line.Connect.nVal = 2; // 2 点のセグメントに対しては 2 tr.Root.Line.Color.nVal = RGB2OCOLOR(RGB(100, 100, 220)); tr.Root.Line.Width.dVal = 1.5; if( 0 == dp.UpdateThemeIDs(tr.Root) ) { bool bRet = dp.ApplyFormat(tr, true, true); }

6.3.5 あるデータプロットから別のプロットにフォーマットをコピーす

る

テーマファイルでフォーマットをコピーするデータプロットからテーマファイルにフォーマットツリーを取得し保存すると、テーマファイルをツリー

にロードし、フォーマットツリーを別のデータプロットに適用できます。

// Graph1 からテーマファイルにプロット設定を保存 GraphPage gpSource("Graph1"); GraphLayer glSource = gpSource.Layers(0); DataPlot dpSource = glSource.DataPlots(0); Tree tr; tr = dpSource.GetFormat(FPB_ALL, FOB_ALL, true, true); string strTheme = GetAppPath(false) + "plotsettings.XML"; tr.Save(strTheme); // テーマファイルからプロット設定をツリーにロードし、 // ツリーからデータプロットオブジェクトにフォーマットを適用 GraphPage gpDest("Graph2"); GraphLayer glDest = gpDest.Layers(0);


104 グラフ

DataPlot dpDest = glDest.DataPlots(0); Tree tr2; tr2.Load(strTheme); dpDest.ApplyFormat(tr2, true, true);

ツリーでフォーマットをコピーするあるデータプロットからのプロット設定をツリーに取得すると、このツリーから別のプロットオブジェクト

に設定を適用できます。

GraphPage gpSource("Graph1"); GraphLayer glSource = gpSource.Layers(0); DataPlot dpSource = glSource.DataPlots(0); GraphPage gpDest("Graph2"); GraphLayer glDest = gpDest.Layers(0); DataPlot dpDest = glDest.DataPlots(0); // 元のデータプロットからフォーマットを取得 Tree tr; tr = dpSource.GetFormat(FPB_ALL, FOB_ALL, true, true); // フォーマットを別のデータプロットに適用 dpDest.ApplyFormat(tr, true, true);

6.3.6 散布図のフォーマットをセットする GraphLayer gl = Project.ActiveLayer(); DataPlot dp = gl.DataPlots(-1); // アクティブデータプロットを取得 // シンボルフォーマットをセット Tree tr; tr.Root.Symbol.Size.nVal = 12; // シンボルのサイズ tr.Root.Symbol.Shape.nVal = 1; // 円 tr.Root.Symbol.Interior.nVal = 1; // 内部 tr.Root.Symbol.EdgeColor.nVal = SYSCOLOR_RED; tr.Root.Symbol.FillColor.nVal = SYSCOLOR_BLUE; // 垂直線の表示 tr.Root.DropLines.Vertical.nVal = 1; tr.Root.DropLines.VerticalColor.nVal = SYSCOLOR_LTGRAY; tr.Root.DropLines.VerticalStyle.nVal = 1; tr.Root.DropLines.VerticalWidth.nVal = 1.5; if( 0 == dp.UpdateThemeIDs(tr.Root) ) { bool bRet = dp.ApplyFormat(tr, true, true); }


グラフ 105

6.3.7 グループ化した線＋シンボルのフォーマットを設定する Origin C を使って、グループ化したプロットに対するフォーマットをセットします。同じ操作を、作図

の詳細ダイアログで、グループタブで行うことができます。フォーマットには線の色、シンボルタイプ、

シンボルの内部、線種が含まれます。

次のサンプルは、線＋シンボルグラフのフォーマットをセットする方法を示しています。このグループ

には 4 つのデータプロットがあるものとします。

GraphLayer gl = Project.ActiveLayer(); GroupPlot gplot = gl.Groups(0); // レイヤ内の初のグループ // Nester はグループ内でネストするオブジェクトタイプの配列 // グループ内で周期的にネストする 4 種類の設定 vector<int> vNester(3); vNester[0] = 0; // グループ内で周期的に線の色を変更 vNester[1] = 3; // グループ内で周期的にシンボルを変更 vNester[2] = 8; // グループ内で周期的にシンボル内部を変更 gplot.Increment.Nester.nVals = vNester; // グループプロットの Nester // フォーマット設定を 4 つのプロットへの vector に配置 vector<int> vLineColor = {SYSCOLOR_BLUE, SYSCOLOR_OLIVE, SYSCOLOR_RED, SYSCOLOR_CYAN}; vector<int> vSymbolShape = {1, 3, 5, 8}; vector<int> vSymbolInterior = {1, 2, 5, 0}; Tree tr; tr.Root.Increment.LineColor.nVals = vLineColor; // 線の色をテーマツリーにセット tr.Root.Increment.Shape.nVals = vSymbolShape; // シンボルの形状をテーマツリーにセット // シンボルの内部をテーマツリーにセット tr.Root.Increment.SymbolInterior.nVals = vSymbolInterior; if(0 == gplot.UpdateThemeIDs(tr.Root) ) { bool bb = gplot.ApplyFormat(tr, true, true); // テーマツリーを適用 }

6.3.8 カラーマップ設定を設定するこのサンプルは、等高線グラフの Z レベルのカラーマップを設定する方法を示します。

GraphLayer gl = Project.ActiveLayer(); DataPlot dp = gl.DataPlots(0); // Z レベルの元のカラーマップを取得 vector vZs; BOOL bLogScale = FALSE; BOOL bRet = dp.GetColormap(vZs, bLogScale); int nLevels = vZs.GetSize();


106 グラフ

// Z レベルの vector を減少させ、DataPlot に戻してセット double min, max; vZs.GetMinMax(min, max); double dChangeVal = fabs(max - min) * 0.2; bool bIncrease = true; if( !bIncrease ) dChangeVal = 0 - dChangeVal; min = min - dChangeVal; max = max - dChangeVal; double inc = (max - min) / nLevels; vZs.Data(min, max, inc); dp.SetColormap(vZs);

次のサンプルは、等高線グラフの塗り色を削除し、線の色、スタイル、幅、テキストラベルをセットする

方法を示します。

GraphLayer gl = Project.ActiveLayer(); DataPlot dp = gl.DataPlots(0); Tree tr; dp.GetColormap(tr); // 塗りつぶしの色を削除 tr.ColorFillControl.nVal = 0; // 線の色をセット vector<int> vnLineColors; vnLineColors = tr.Details.LineColors.nVals; int nLevels = vnLineColors.GetSize(); vnLineColors.Data(1, nLevels, 1); tr.Details.LineColors.nVals = vnLineColors; // すべての線に対して線種を破線に vector<int> vnLineStyles(vnLineColors.GetSize()); vnLineStyles = 1; tr.Details.LineStyles.nVals = vnLineStyles; // すべての線に対して太さをセット vector vdLineWidths(vnLineColors.GetSize()); vdLineWidths = 3; tr.Details.LineWidths.dVals = vdLineWidths; // ラベルを表示/非表示、初の 2 つを除いてすべてを表示 vector<int> vnLabels(vnLineColors.GetSize()); vnLabels = 1; vnLabels[0] = 0; vnLabels[1] = 0; tr.Details.Labels.nVals = vnLabels; // グラフに設定を戻す dp.SetColormap(tr);

6.4 レイヤを管理する

グラフ 107

このサンプルは、等高線グラフのテキストラベルのフォーマット(例：色、サイズ、太字、斜体)をセット

する方法を示します。

GraphLayer gl = Project.ActiveLayer(); DataPlot dp = gl.DataPlots(0); // カラーマッププロットの関連オブジェクトのすべてのプロパティを取得 Tree tr; tr = dp.GetFormat(FPB_ALL, FOB_ALL, true, true); // すべてのラベルを表示 vector<int> vnLabels; vnLabels = tr.Root.ColorMap.Details.Labels.nVals; vnLabels = 1;// 0 to hide, 1 to show tr.Root.ColorMap.Details.Labels.nVals = vnLabels; // ラベルに対して数値フォーマットをセット tr.Root.NumericFormats.Format.nVal = 0; // Decimal tr.Root.NumericFormats.DigitsControl.nVal = 0; tr.Root.NumericFormats.SignificantDigits.nVal = 5;//DecimalPlaces tr.Root.NumericFormats.Prefix.strVal = "_"; tr.Root.NumericFormats.Suffix.strVal = "Label"; tr.Root.NumericFormats.MinArea.nVal = 5; // Labeling Criteria - Min Area(%) // ラベルに対してテキストフォーマットをセット tr.Root.Labels.Color.nVal = SYSCOLOR_BLUE; //FontFaceIndex_to_DWORD は、GUI インデックスから DWORD 実数値に変換するのに使用 tr.Root.Labels.Face.nVal = FontFaceIndex_to_DWORD(2);// GUI 内に 3 番目のフォントを選択 tr.Root.Labels.Size.nVal = 20; tr.Root.Labels.WhiteOut.nVal = 1; tr.Root.Labels.Bold.nVal = 1; tr.Root.Labels.Italic.nVal = 1; tr.Root.Labels.Underline.nVal = 1; if(0 == dp.UpdateThemeIDs(tr.Root) ) dp.ApplyFormat(tr, true, true);


6.4.1 区分グラフを作成する

6 区分グラフを作成する次のサンプルは、2 列 3 行で配置した 6 つのレイヤを持つ新しいグラフを作成します。この関数は、

どのウィンドウがアクティブかに関係なく実行できます。

GraphPage gp;


108 グラフ

gp.Create("Origin"); while(gp.Layers.Count() < 6) { gp.AddLayer(); } graph_arrange_layers(gp, 3, 2);

6 区分グラフを作成しプロットする次のサンプルは、新しいワークブックにいくつかデータをインポートし、6 つのレイヤを持つ新しいグ

ラフウィンドウを作成し、2 列 3 行で配置し、各レイヤ(区分)をループして、インポートしたデータをプ

ロットします。

// データファイルをワークシートにインポート ASCIMP ai; Worksheet wks; string strDataFile = GetOpenBox(FDLOG_ASCII, GetAppPath(true)); if(AscImpReadFileStruct(strDataFile,&ai) == 0) { wks.Create("Origin"); wks.ImportASCII(strDataFile, ai); } // ワークシートからグラフの各レイヤに XY データを追加 GraphPage gp("Graph1"); // グラフは上記で作成した 3x2 区分レイヤを持つ int index = 0; foreach(GraphLayer gl in gp.Layers) { DataRange dr; dr.Add(wks, 0, "X"); dr.Add(wks, index+1, "Y"); if( gl.AddPlot(dr, IDM_PLOT_LINE) >= 0 ) gl.Rescale(); index++; }

6.4.2 グラフウィンドウにレイヤを追加する次のサンプルは、独立した右 Y 軸スケールを追加します。右 Y 軸のみを表示する新しいレイヤを追

加します。これは寸法がリンクされ、レイヤが追加された時に、X 軸が現在のアクティブレイヤにリンク

されます。新しく追加したレイヤがアクティブレイヤになります。

次のコードをコンパイルする前に、現在のワークスペースに graph_utils.c を追加する必要がありま

す。これには、Labtalk コマンド"Run.LoadOC(Originlab¥graph_utils.c)"を使います。

#include <..¥Originlab¥graph_utils.h>// page_add_layer 関数に必要


グラフ 109

GraphLayer gl = Project.ActiveLayer(); GraphPage gp = gl.GetPage(); bool bBottom = false, bLeft = false, bTop = false, bRight = true; int nLinkTo = gl.GetIndex(); // アクティブレイヤにレイヤリンクを新しく追加 bool bActivateNewLayer = true; int nLayerIndex = page_add_layer(gp, bBottom, bLeft, bTop, bRight, ADD_LAYER_INIT_SIZE_POS_SAME_AS_PREVIOUS, bActivateNewLayer, nLinkTo);

6.4.3 レイヤを配置する次のサンプルは、アクティブグラフに既存レイヤを 2 行 3 列で配置します。アクティブグラフに 6 つの

レイヤが無くても、新しいレイヤは追加されません。存在しているレイヤのみが配置されます。

GraphLayer gl = Project.ActiveLayer(); GraphPage gp = gl.GetPage(); int nRows = 3, nCols = 2; graph_arrange_layers(gp, nRows, nCols);

6.4.4 レイヤを移動する次のサンプルは、アクティブグラフウィンドウのすべてのレイヤを左に整列し、ページの左側から 15%の位置にセットします。

GraphLayer gl = Project.ActiveLayer(); GraphPage gp = gl.GetPage(); int nRows = gp.Layers.Count(); int nCols = 1; stLayersGridFormat stFormat; stFormat.nXGap = 0; // レイヤの X 方向の余白 stFormat.nYGap = 5; // レイヤの Y 方向の余白 stFormat.nLeftMg = 15; // 左余白 stFormat.nRightMg = 10; stFormat.nTopMg = 10; stFormat.nBottomMg = 10; page_arrange_layers(gp, nRows, nCols, &stFormat);

6.4.5 レイヤサイズの変更次のサンプルは、現在のレイヤのサイズを変更し、幅と高さを元のサイズの半分にします。


110 グラフ



#include <..¥Originlab¥graph_utils.h> // layer_set_size 関数に必要 GraphLayer gl = Project.ActiveLayer(); // グラフレイヤの元のサイズを取得 double dWidth, dHeight; layer_get_size(gl, dWidth, dHeight); // レイヤサイズの変更 dWidth /= 2; dHeight /= 2; layer_set_size(gl, dWidth, dHeight);

6.4.6 2 つのレイヤを入れ替える次のサンプルは、レイヤ 1 と 2 のページの位置をインデックス番号を使って入れ替えます。



#include <..¥Originlab¥graph_utils.h> // layer_swap_position 関数に必要 GraphPage gp("Graph1"); GraphLayer gl1 = gp.Layers(0); GraphLayer gl2 = gp.Layers(1); layer_swap_position(gl1, gl2);

次のサンプルは、Layer1 および Layer2 という名前のレイヤの位置を名前を入れ替えます。

GraphPage gp("Graph1"); GraphLayer gl1 = gp.Layers("Layer1"); GraphLayer gl2 = gp.Layers("Layer2"); layer_swap_position(gl1, gl2);

6.4.7 レイヤを整列する次のサンプルは、アクティブグラフレイヤのレイヤ 1 とレイヤ 2 を下辺に合わせて整列します。



#include <..¥Originlab¥graph_utils.h> // layer_aligns 関数に必要 // アクティブグラフページを取得 GraphLayer gl = Project.ActiveLayer(); GraphPage gp = gl.GetPage(); GraphLayer gl1 = gp.Layers(0);

6.5 図形オブジェクトの作成とアクセス

グラフ 111

GraphLayer gl2 = gp.Layers(1); // レイヤ 2 をレイヤ 1 に下辺で合わせる layer_aligns(gl1, gl2, POS_BOTTOM);

6.4.8 レイヤをリンクする次のサンプルは、アクティブグラフのすべてのレイヤの X 軸をレイヤ 1 の X 軸にリンクします。単位

は、リンクしたレイヤの%にセットされます。



#include <..¥Originlab¥graph_utils.h> // layer_set_link 関数に必要 GraphLayer gl = Project.ActiveLayer(); GraphPage gp = gl.GetPage(); GraphLayer gl1 = gp.Layers(0); // Layer 1 foreach(GraphLayer glOne in gp.Layers) { int nUnit = M_LINK; // レイヤの単位をリンクしたレイヤの%にセット if( glOne != gl1 ) layer_set_link(glOne, gl1.GetIndex(), LINK_STRAIGHT, LINK_NONE, &nUnit); }

6.4.9 レイヤ単位をセットする int nUnit = M_PIXEL; GraphLayer gl = Project.ActiveLayer(); // 現在の位置を取得 double dPos[TOTAL_POS]; gl.GetPosition(dPos); // 位置を指定した単位に変換 gl.UnitsConvert(nUnit, dPos); // 位置を単位でセット gl.SetPosition(dPos, nUnit);


112 グラフ


6.5.1 図形オブジェクトを作成する例えば、テキスト、矩形、線などの図形オブジェクトを追加します。

次のサンプルは、アクティブグラフに矩形を追加する方法を示しています。他のグラフオブジェクトに

対しては、oc_const.h ファイル内の GROT_* をご覧ください(例えば:GROT_TEXT, GROT_LINE, GROT_POLYGON)

GraphLayer gl = Project.ActiveLayer(); string strName = "MyRect"; GraphObject goRect = gl.CreateGraphObject(GROT_RECT, strName);

現在のグラフウィンドウにテキストラベルを追加します。

GraphLayer gl = Project.ActiveLayer(); GraphObject go = gl.CreateGraphObject(GROT_TEXT, "MyText"); go.Text = "This is a test";

下記の例は、グラフに矢印を追加する方法を示します。矢印のオブジェクトタイプは、線と同じタイプ

で GROT_LINE です。線と矢印の両方とも、必要なデータポイントの数は 2 個です。

GraphPage gp; gp.Create(); GraphLayer gl = gp.Layers(); string strName = "MyArrow"; // グラフオブジェクトの名前 GraphObject go = gl.CreateGraphObject(GROT_LINE, strName); go.Attach = 2; // 接続モードをレイヤとスケールに変更 Tree tr; tr.Root.Dimension.Units.nVal = 5; // 単位をスケールにセット // 位置をスケール値でセット vector vx = {2, 6}; vector vy = {6, 2}; tr.Root.Data.X.dVals = vx; tr.Root.Data.Y.dVals = vy; tr.Root.Arrow.Begin.Style.nVal = 0; tr.Root.Arrow.End.Style.nVal = 1; if( 0 == go.UpdateThemeIDs(tr.Root) ) { go.ApplyFormat(tr, true, true); }

下記の例は、グラフに曲線矢印を追加する方法を示します。曲線矢印では、必要なデータポイントの

数は 4 個です。


グラフ 113

GraphPage gp; gp.Create(); GraphLayer gl = gp.Layers(); string strName = "MyArrow"; // グラフオブジェクトの名前 GraphObject go = gl.CreateGraphObject(GROT_LINE4, strName); go.Attach = 2; // 接続モードをレイヤとスケールに変更 Tree tr; tr.Root.Dimension.Units.nVal = 5; // 単位をスケールにセット // 位置をスケール値でセット vector vx = {2, 4, 6, 5}; vector vy = {7, 6.9, 6.8, 2}; tr.Root.Data.X.dVals = vx; tr.Root.Data.Y.dVals = vy; tr.Root.Arrow.Begin.Style.nVal = 0; tr.Root.Arrow.End.Style.nVal = 1; if( 0 == go.UpdateThemeIDs(tr.Root) ) { go.ApplyFormat(tr, true, true); }

6.5.2 プロパティを設定する例えば、テキストフォント、色、線幅などの図形オブジェクトのプロパティをセットします。

// 図形オブジェクトの色とフォントをセット GraphLayer gl = Project.ActiveLayer(); GraphObject goText = gl.GraphObjects("Text"); goText.Text = "This is a test"; goText.Attach = 2; // レイヤスケールに接続 Tree tr; tr.Root.Color.nVal = SYSCOLOR_RED; // テキストの色 tr.Root.Font.Bold.nVal = 1; tr.Root.Font.Italic.nVal = 1; tr.Root.Font.Underline.nVal = 1; tr.Root.Font.Size.nVal = 30; // テキストのフォントサイズ if( 0 == goText.UpdateThemeIDs(tr.Root) ) { bool bRet = goText.ApplyFormat(tr, true, true); }

6.5.3 位置とサイズを設定する GraphLayer gl = Project.ActiveLayer();


114 グラフ

GraphObject go = gl.GraphObjects("Rect"); go.Attach = 2; // レイヤスケールに接続 // テキストオブジェクトをレイヤの左上に移動 Tree tr; tr.Root.Dimension.Units.nVal = UNITS_SCALE; tr.Root.Dimension.Left.dVal = gl.X.From; // 左 tr.Root.Dimension.Top.dVal = gl.Y.To/2; // 上 tr.Root.Dimension.Width.dVal = (gl.X.To - gl.X.From)/2; // 幅 tr.Root.Dimension.Height.dVal = (gl.Y.To - gl.Y.From)/2; // 高さ if( 0 == go.UpdateThemeIDs(tr.Root) ) { bool bRet = go.ApplyFormat(tr, true, true); }

6.5.4 接続プロパティを更新する接続プロパティにはページ、レイヤ枠、レイヤスケールの 3 つあります。

// グラフオブジェクトを異なるオブジェクトに接続: // 0 はレイヤ、レイヤを移動するとグラフオブジェクトも一緒に移動 // 1 はページ、レイヤを移動しても、グラフオブジェクトに影響しない // 2 はレイヤスケール、スケールを変更すると、グラフオブジェクトの位置 // がそれに従って変更 go.Attach = 2;

6.5.5 表示プロパティを取得およびセットする // 例えば、移動可能や選択可能などの有効無効のプロパティをチェックする Tree tr; tr = go.GetFormat(FPB_OTHER, FOB_ALL, true, true); DWORD dwStats = tr.Root.States.nVal; // 垂直および水平移動をチェック // 他のプロパティビットに対しては、oc_const.h ファイルの GOC_*をご覧ください。 if( (dwStats & GOC_NO_VMOVE) && (dwStats & GOC_NO_HMOVE) ) { out_str("This graph object cannot be move"); }

6.5.6 プログラミング制御 // 1.線を追加 GraphLayer gl = Project.ActiveLayer(); GraphObject go = gl.CreateGraphObject(GROT_LINE); go.Attach = 2; // 接続モードをレイヤスケールに


グラフ 115

go.X = 5; // 初期位置を X = 5 にセット // 2.線のプロパティをセット Tree tr; tr.Root.Direction.nVal = 2; // 水平は 1、垂直は 2 tr.Root.Span.nVal = 1; // レイヤをまたぐ tr.Root.Color.nVal = SYSCOLOR_RED; // 線の色 if( 0 == go.UpdateThemeIDs(tr.Root) ) { go.ApplyFormat(tr, true, true); } // 3.イベントモードと LT スクリプトをセットします。 // 線の移動は線の位置、x スケール値を出力 Tree trEvent; trEvent.Root.Event.nVal = GRCT_MOVE;// その他のビットについては oc_const.h 内の GRCT_*をご覧くだ

さい trEvent.Root.Script.strVal = "type -a $(this.X)"; if( 0 == go.UpdateThemeIDs(trEvent.Root) ) { go.ApplyFormat(trEvent, true, true); }

6.5.7 凡例を更新する凡例はグラフウィンドウ上の"Legend"というオブジェクトです。データプロットを追加/削除したあと、

legend_update 関数を使って、現在のデータプロットに従って、凡例をリフレッシュします。

// ここでは単純な使用法で、単に凡例をリフレッシュ // Origin C のヘルプでこの関数を検索し、他の使用に対して // 別の引数の説明を確認可能 legend_update(gl); // gl is a GraphLayer object

6.5.8 グラフにテーブルオブジェクトを追加する // 1.Create the worksheet with Table template Worksheet wks; wks.Create("Table", CREATE_HIDDEN); WorksheetPage wksPage = wks.GetPage(); // 2.テーブルサイズをセットし、テキストを入力 wks.SetSize(3, 2); wks.SetCell(0, 0, "1"); wks.SetCell(0, 1, "Layer 1"); wks.SetCell(1, 0, "2"); wks.SetCell(1, 1, "Layer 2");


116 グラフ

wks.SetCell(2, 0, "3"); wks.SetCell(2, 1, "Layer 3"); //3.リンクとしてグラフにテーブルを追加 GraphLayer gl = Project.ActiveLayer(); GraphObject grTable = gl.CreateLinkTable(wksPage.GetName(), wks);

117

77 データ操作

7.1 数値データこのセクションでは、Origin C で数値データを操作するサンプルを扱います。数値データは次のデ

ータタイプの変数に保存することができます。

double integer vector matrix

数値データと文字列は、ツリーのノードに保存でき、提供されたノードは上記のデータ型の 1 つです。

7.1.1 欠損値数値データが重要であるのと同様に、欠損値を表すことができることも重要です。Origin C は、値が

欠損値であるかどうかを比較する NANUM マクロを定義します。欠損値は、double 型のデータ型

のみをサポートしています。

double d = NANUM; if( NANUM == d ) out_str("The value is a missing value.");

Origin C は、値が欠損値であるかどうかをチェックする is_missing_value 関数も提供しています。

if( is_missing_value(d) ) out_str("The value is a missing value.");

7.1.2 精度と比較次のサンプルコードでは、prec と round 関数を使って、double 型の数値データの精度を制御しま

す。is_equal 関数を使って、double 型の数値データの 2 つを比較します。

double dVal = PI; // PI は 3.1415926535897932384626 と定義 // double 型の値を有効桁数 6 ケタに変換 int nSignificantDigits = 6; printf("%f¥n", prec(dVal, nSignificantDigits));

7.1 数値データ

118 データ操作

// double 型の値を 2 ケタのみにする uint nDecimalPlaces = 2; double dd = round(dVal, nDecimalPlaces); printf("%f¥n", dd); // 2 つの double 型の値を比較 if( is_equal(dd, 3.14) ) { out_str("equal¥n"); } else { out_str("not equal¥n"); }

7.1.3 数値を文字列に変換する // int 型の数値を文字列に割り当て string str = 10; out_str(str); int nn = 0; str = nn; out_str(str); // double 型の数値を文字列に割り当て double dd = PI; str = ftoa(dd, "*"); // オプションダイアログで Origin のグローバル設定に"*"を使う out_str(str); str = ftoa(dd, "*8"); // 有効桁数 8 ケタに"*8"を使用 out_str(str);

7.1.4 vector // 基本データ型、例えば double, int, string, complex の // 1 次配列 vector vx, vy; int nMax = 10; vx.Data(1, nMax, 1); // 1 から 10 まで増分 1 で値を vx に割り当て vy.SetSize(nMax); // サイズ(10)を vy にセット for(int nn = 0; nn < nMax; nn++) { vy[nn] = rnd(); // 乱数を vy の各項目に割り当て printf("index = %d, x = %g, y = %g¥n", nn+1, vx[nn], vy[nn]); } // ワークシート内のデータにアクセス Worksheet wks = Project.ActiveLayer(); Column col(wks, 0);

7.1 数値データ

データ操作 119

vector& vec = col.GetDataObject(); vec = vec * 0.1; // vec 内の各データに 0.1 を乗算 vec = sin(vec); // vec 内のデータの sin を求める

7.1.5 行列 // 基本データ型、例えば double, int, complex の 2 次配列 // string は含まれない matrix mat(5, 6); for(int ii = 0; ii < 5; ii++) { for(int jj = 0; jj < 6; jj++) { mat[ii][jj] = ii + jj; printf("%g¥t", mat[ii][jj]); } printf("¥n"); // new line } // 行列ウィンドウ内のデータにアクセス MatrixLayer ml = Project.ActiveLayer(); MatrixObject mo = ml.MatrixObjects(0); matrix& mat = mo.GetDataObject(); mat = mat + 0.1; // 行列の各データに 0.1 を加算

7.1.6 TreeNode Origin C の TreeNode クラスは、複数レベルのツリーを構築し、ツリーを横断し、ツリーノードの値/属性にアクセスするいくつかのメソッドを提供します。

Tree tr; // ツリーノードの値にアクセス TreeNode trName = tr.AddNode("Name"); trName.strVal = "Jane"; tr.UserID.nVal = 10; vector<string> vsBooks = {"C++", "MFC"}; tr.Books.strVals = vsBooks; out_tree(tr); // ツリーを出力

7.1 数値データ

120 データ操作

7.1.7 複素数 complex cc(1.5, 2.2); cc.m_re = cc.m_re +1; cc.m_im = cc.m_im * 0.1; out_complex("cc = ", cc); // output cc = 2.500000+0.220000i // 複素数データセットにアクセス Worksheet wks = Project.ActiveLayer(); Column col(wks, 1); if( FSI_COMPLEX == col.GetInternalDataType() ) { vector<complex>& vcc = col.GetDataObject(); vcc[0] = 0.5 + 3.6i; } // 複素数行列にアクセス MatrixLayer ml = Project.ActiveLayer(); MatrixObject mo = ml.MatrixObjects(); if( FSI_COMPLEX == mo.GetInternalDataType() ) { matrix<complex>& mat = mo.GetDataObject(); mat[0][0] = 1 + 2.5i; }

7.1.8 DataRange DataRange クラスは、ワークシート、行列、グラフウィンドウでデータを取得したり、配置する広範なメ

カニズムを提供します。

ワークシート内のデータ範囲ワークシートに対しては、データ範囲は、1 列、1 行、部分範囲、1 つのセル、ワークシート全体として

列と行のインデックスを指定することができます。

// アクティブワークシートの 1 行目から 5 行目までのすべての列と行の // データ範囲を構築 Worksheet wks = Project.ActiveLayer(); int r1 = 0, c1 = 0, r2 = 4, c2 = -1; DataRange dr; // 範囲名は"X", "Y", // "ED"(Y エラー), "Z"のようなわかりやすいものにデータ範囲は、従属または独立のデータ型に属さなければ // デフォルトは "X" dr.Add("X", wks, r1, c1, r2, c2);

データ範囲から vector にデータを取得します。DataRange::GetData は、複数のオーバーロード

したメソッドをサポートします。例えば、

7.1 数値データ

データ操作 121

vector vData; int index = 0; // 範囲インデックス dr.GetData(&vData, index);

行列シート内のデータ範囲行列ウィンドウに対しては、データ範囲は行列オブジェクトインデックスにすることができます。

MatrixLayer ml = Project.ActiveLayer(); DataRange dr; int nMatrixObjectIndex = 0; dr.Add(ml, nMatrixObjectIndex, "X");

データ範囲から matrix にデータを取得します。

matrix mat; dr.GetData(mat);

グラフ内のデータ範囲グラフウィンドウに対して、データ範囲はデータプロットの 1 つまたは 1 つのデータプロットの部分範

囲にすることができます。

GraphLayer gl = Project.ActiveLayer(); DataPlot dp = gl.DataPlots(); // アクティブデータプロットを取得 DataRange dr; int i1 = 0; // 初のデータポイントから int i2 = -1; // 後のデータポイントまで dp.GetDataRange(dr, i1, i2);

データ範囲オブジェクトでデータプロットから XY データを vector に取得します。

vector vx, vy; DWORD dwRules = DRR_GET_DEPENDENT; dr.GetData(dwRules, 0, NULL, NULL, &vy, &vx);

データ範囲を制御する OriginC は、データ範囲を選択するために GetN ダイアログをサポートしています。

#include <GetNBox.h> // ダイアログを開き、1 つのグラフデータプロットから範囲を選択 // この選択でデータ範囲オブジェクトを構築 GETN_TREE(tr) GETN_INTERACTIVE(Range1, "Select Range", "") if( GetNBox(tr) ) // returns true if click OK button {

7.2 文字列データ

122 データ操作

DataRange dr; dr.Add("Range1", tr.Range1.strVal); vector vData; int index = 0; // 範囲インデックス dr.GetData(&vData, index); // vData 内のデータは選択したデータポイント }


7.2.1 文字列(ストリング)変数 string str1; // str1 という文字列変数を宣言 str1 = "New York"; // str1 に文字シーケンスを割り当て string str2 = "Tokyo"; // 文字列変数を宣言し、割り当て // 文字配列を宣言し、文字列シーケンスで初期化 char ch[] = "This is a test!"; // 文字配列を宣言し、サイズを指定して文字列シーケンスで初期化 char chArr[255] = "Big World.";

7.2.2 文字列を数値に変換する string str = PI; // 数値を文字変数に割り当て // 文字列を数値に変換 double dd = atof(str, true); out_double("dd=", dd); // dd=3.14159 // 文字列を複素数に変換 str = "1+2.5i"; complex cc = atoc(str); out_complex("cc = ", cc); // cc = 1.000000+2.500000i // 文字列を整数型に変換 str = "100"; int nn = atoi(str); out_int("nn = ", nn); // nn = 100

7.2.3 数値/文字列を別の文字列に追加する // 数値または文字列を別の文字列に追加 // Origin C では、数値/文字列の定数または変数を加えるのに'+'を使う


データ操作 123

string str = "The area is " + 30.7; // double 型の定数を文字列に追加 str += "¥n"; // 文字列定数を文字列変数に追加 int nLength = 10; str += "The length is " + nLength; // 整数型の変数を文字列に追加 out_str(str);

7.2.4 部分文字列を検索 // 部分文字列を検索し取得 string str = "[Book1]Sheet1!A:C"; int begin = str.Find(']'); // ']'のインデックスを検索し、戻す begin++; // ]の次の文字に移動 int end = str.Find('!', begin); // '!'のインデックスを検索し、戻す end--; // !の次の文字に移動 // 開始インデックスと部分文字列の長さで部分文字列を取得 int nLength = end - begin + 1; string strSheetName = str.Mid(begin, nLength); out_str(strSheetName);// Should output "Sheet1"

7.2.5 部分文字列の置換 // 1 文字を検索し、置換 string str("A+B+C+"); int nCount = str.Replace('+','-'); out_int("", nCount); // nCount will be 3 out_str(str); // "A-B-C-" // 文字列を検索し、置換 str = "I am a student.¥nI am a girl."; nCount = str.Replace("I am", "You are"); out_int("", nCount); // nCount will be 2 out_str(str);

7.2.6 パス文字列の関数

ファイルパスの文字列 // string::IsFile はファイルをチェックするのに使用 string strFile = "D:¥¥TestFolder¥¥abc.txt"; bool bb = strFile.IsFile(); printf("The file %s is %sexist.¥n", strFile, bb ?"" :"NOT ");

7.3 日付と時間データ

124 データ操作

// GetFilePath 関数はフルパスの文字列からパスを抽出するのに使用 string strPath = GetFilePath(strFile); out_str(strPath); // GetFileName 関数はフルパスの文字列からファイル名の部分を // 抽出するのに使用 bool bRemoveExtension = true; string strFileName = GetFileName(strFile, bRemoveExtension); out_str(strFileName); // string::IsPath はパスが存在するかをチェック bb = strPath.IsPath(); out_int("", bb);

Origin システムパス string strSysPath = GetOriginPath(ORIGIN_PATH_SYSTEM); printf("Origin System Path:%s¥n", strSysPath); string strUserPath = GetOriginPath(ORIGIN_PATH_USER); printf("User File Path:%s¥n", strUserPath);

7.3 日付と時間データ Origin C は、日付と時間データをサポートしています。

7.3.1 現在の日時データを取得 // 現在の時間を取得 time_t aclock; time( &aclock ); // 時間の値を変換し、ローカル時間に修正 TM tmLocal; convert_time_to_local(&aclock , &tmLocal); // TM 形式からシステム時間形式に時間の値を変換 SYSTEMTIME sysTime; tm_to_systemtime(&tmLocal, &sysTime); // システム時間から日付文字列を取得 char lpcstrTime[100]; if(systemtime_to_date_str(&sysTime, lpcstrTime, LDF_SHORT_AND_HHMM_SEPARCOLON)) printf("Current Date Time is %s¥n", lpcstrTime);

7.3 日付と時間データ

データ操作 125

7.3.2 ユリウス日を文字列に変換 SYSTEMTIME st; GetSystemTime(&st); // 現在の時間を取得 double dJulianDate; SystemTimeToJulianDate(&dJulianDate, &st); // ユリウス日に変換 // 指定した形式でユリウス日を文字列に変換 string strDate = get_date_str(dJulianDate, LDF_SHORT_AND_HHMM_SEPARCOLON); out_str(strDate);

7.3.3 文字列をユリウス日に変換 string strDate = "090425 17:59:59"; double dt = str_to_date(strDate, LDF_YYMMDD_AND_HHMMSS);

127

88 プロジェクト Origin C の Project クラスは、Origin プロジェクト内に含まれるさまざまな高いレベルのオブジェク

トにアクセスするのに使用されます。これには、ワークブック、行列ブック、グラフ、ノート、フォルダな

どが含まれます。

8.1 プロジェクトを管理する Origin C は、プロジェクトを開く、保存する、追加する Project クラスを提供しており、プロジェクトに

含まれるさまざまなオブジェクトにアクセスできます。Project クラスは、すべてのページタイプと一時

データセットのコレクションを含みます。アクティブな曲線、レイヤ、フォルダなどのアクティブなオブジ

ェクトを取得するメソッドがあります。

8.1.1 プロジェクトを開く/保存する以下のコードは、プロジェクトを保存、新しいプロジェクトを開始、保存したプロジェクトを開くためのサ

ンプルです。

string strPath = "c:¥¥abc.opj"; // プロジェクトのパスと名前 Project.Save(strPath); // 現在のプロジェクトを保存 Project.Open(); // 新しいプロジェクトを開始 Project.Open(strPath); // 保存したプロジェクトを開く

8.1.2 プロジェクトを別のプロジェクトに追加する Project.Open メソッドの 2 番目の任意の引数を使って、プロジェクトを現在のプロジェクトに追加す

ることができます。追加されたプロジェクトのフォルダ構造は、現在のプロジェクトのアクティブフォル

ダに置かれます。

Project.Open("c:¥¥abc.opj", OPJ_OPEN_APPEND);

8.1.3 修正フラグプロジェクトが編集されるとき、Origin によって内部的に IsModified フラグがセットされます。

Origin C は、IsModified フラグをセットしたり、解除することができます。プロジェクトが閉じられると、

8.2 フォルダを管理する

128 プロジェクト

このフラグにチェックが付きます。フラグがセットされると、Origin は変更を保存するかどうかをユーザ

に尋ねます。自分で作成した Origin C コードが保存する必要のない変更をしていたら、ユーザに

尋ねる動作を行わないようにフラグを解除することができます。

if( Project.IsModified() ) { // アクティブプロジェクトを編集されていないようにセット次のことが分かっている場合にこれを行います。 // 変更を保存したくなく、Origin に // 保存されていない変更があることをユーザに通知したくない場合 Project.ClearModified(); // 新しいプロジェクトを開始、アクティブプロジェクトの保存されていない変更について // ユーザに尋ねないことがわかります。 Project.Open(); }

8.2 フォルダを管理する Origin プロジェクト内のページ(ワークブック、行列ブック、グラフ)は、階層型のフォルダ構造で管理

でき、Origin のプロジェクトエクスプローラで表示されます。Origin C の Folder クラスは、フォルダ

を作成、アクティブ化、選択、配置することができます。

8.2.1 フォルダを作成し、そのパスを取得する Folder fldRoot, fldSub; fldRoot = Project.RootFolder; // ルートフォルダにサブフォルダを名前を付けて追加 fldSub = fldRoot.AddSubfolder("MyFolder"); printf("Folder added successfully, path is %s¥n", fldSub.GetPath());

8.2.2 アクティブフォルダを取得する Folder fldActive; fldActive = Project.ActiveFolder(); // サブフォルダを追加 fldSub = fldActive.AddSubfolder("MyFolder"); printf("Folder added successfully, path is %s¥n", fldSub.GetPath());

8.2.3 フォルダをアクティブにする // ルートフォルダをアクティブ

8.3 ページにアクセスする

プロジェクト 129

Folder fldRoot = Project.RootFolder; fldRoot.Activate(); // 指定したサブフォルダをアクティブ Folder fldSub("/MyFolder"); fldSub.Activate();

8.2.4 指定したページのパスを取得 GraphPage gp("Graph1"); if( gp.IsValid() ) { Folder fld = gp.GetFolder(); out_str(fld.GetPath()); }

8.2.5 ページ/フォルダを別の場所に移動する Folder::Move を使って、ウィンドウ(ワークシート、グラフ...)やフォルダを別の場所に移動します。次

のサンプルは、フォルダを移動する方法を示しています。

// 2 つのサブフォルダをルートフォルダに追加 Folder subfld1 = root.AddSubfolder("sub1"); Folder subfld2 = root.AddSubfolder("sub2"); // sub1 フォルダに sub2 フォルダを移動 if( !root.Move(subfld2.GetName(), "/"+subfld1.GetName()+"/", true) ) printf("move folder failed!");

8.3 ページにアクセスする Origin のページはワークブック、行列ブック、グラフで構成され、プロジェクト内の中核的なオブジェ

クトです。Origin C は名前またはインデックスでページにアクセスでき、 foreach ステートメントを使

って現在のプロジェクトの特定のページタイプのすべてのインスタンスにアクセスできます。

8.3.1 名前とインデックスでページにアクセスするすべてのページには名前があり、次のサンプルで示すように、ページにアクセスするために使用する

ことができます。

// ページの名前でページにアクセス GraphPage gp1("Graph1"); // 0 から始まるインデックスでページにアクセス

8.3 ページにアクセスする


GraphPage gp2 = Project.GraphPages(0); // 初のページは 0

8.3.2 アクティブページとレイヤを取得するワークブックページではレイヤはワークシート、グラフページではレイヤは対の軸、行列ページではレ

イヤは行列シートです。

アクティブレイヤのような特定のレイヤに結びついているページにアクセスしたい場合、GetPage() メソッドを使って行うことができます。

// アクティブレイヤを取得 GraphLayer gl = Project.ActiveLayer(); // レイヤからアクティブページを取得 GraphPage gp = gl.GetPage();

8.3.3 foreach を使う foreach ステートメントは、コレクション内のすべての項目に対するループの処理を簡単にします。プ

ロジェクトはさまざまなコレクションのすべてのページを含みます。

// 現在のプロジェクトのすべてのワークブックをループし // 各ページの名前を出力 foreach( WorksheetPage wksPage in Project.WorksheetPages ) { out_str(wksPage.GetName()); } // 現在のプロジェクトのすべての行列ブックをループし //各ページの名前を出力 foreach( MatrixPage matPage in Project.MatrixPages ) { out_str(matPage.GetName()); } // 現在のプロジェクトのすべてのグラフをループし //各ページの名前を出力 foreach( GraphPage gp in Project.GraphPages ) { out_str(gp.GetName()); } // 現在のプロジェクトのすべてのページをループし // 各ページの名前を出力 foreach( Page pg in Project.Pages ) { out_str(pg.GetName()); }

8.4 メタデータにアクセスする


8.4 メタデータにアクセスするメタデータは、他のデータを参照する情報です。サンプルには、データが元々収集された時刻、デ

ータを収集した機器を操作した人、調べた標本の温度が含まれます。メタデータはプロジェクト、ペ

ージ、レイヤ、列に保存することができます。

8.4.1 データ範囲にアクセスする Origin C の Project クラスは、Origin C の DataRange オブジェクトを現在のプロジェクトに追加、

取得、削除するメソッドを提供しています。

Worksheet wks = Project.ActiveLayer(); DataRange dr; // 範囲オブジェクト dr.Add("X", wks, 0, 0, -1, -1); // ワークシート全体を範囲に追加 dr.SetName("Range1"); // 範囲名をセット int UID = dr.GetUID(TRUE); // 範囲オブジェクトの固有 ID を取得 int nn = Project.AddDataRange(dr); // 範囲をプロジェクトに追加

コマンドウィンドウまたはスクリプトウィンドウで、LabTalk コマンド list r を使って、現在のプロジェクト

のすべての DataRange オブジェクトを一覧表示します。

8.4.2 アクセスツリー

プロジェクト内のツリーにアクセスする

ツリーの追加

このコードは、ツリー型の変数を宣言し、いくつかのデータをツリーのノードに割り当て、ツリーを現在

のプロジェクトにツリーを追加します。

Tree tr; tr.FileInfo.name.strVal = "Test.XML"; tr.FileInfo.size.nVal = 255; // ツリー変数をプロジェクトに追加 int nNumTrees = Project.AddTree("Test", tr); out_int("The number of trees in project:", nNumTrees);



ツリーを取得

同様に、似たようなコードは、Test という既存のツリー変数に保存され、trTest という新しいツリー変

数に配置します。

// 名前でプロジェクトからツリーを取得 Tree trTest; if( Project.GetTree("Test", trTest) ) out_tree(trTest);

すべての LabTalk ツリーの名前を取得

Project.GetTreeNames メソッドは、プロジェクト内のすべての LabTalk ツリー変数の名前を取得

します。ここで、名前は string vector に割り当てられ、割り当てられる文字列の数はは int 型で返さ

れます。

vector<string> vsTreeNames; int nNumTrees = Project.GetTreeNames(vsTreeNames);

ワークシート内のツリーにアクセスする OriginObject::PutBinaryStorage が Origin オブジェクト、例えば、WorksheetPage, Worksheet, Column, GraphPage, or MatrixPage などの多くの型にツリーを配置するのに使わ

れます。

ツリーの追加

現在のプロジェクトにワークシートウィンドウを保持し、下記のサンプルコードを実行します。ユーザツ

リーを追加するコードを実行した後、ワークシートウィンドウのタイトルを右クリックし、オーガナイザの

表示を選び、右側のパネルに追加したユーザツリーが表示されます。

Worksheet wks = Project.ActiveLayer(); if( wks ) { Tree tr; tr.name.strVal = "Jacky"; tr.id.nVal = 7856; // wksTree というツリーをワークシートオブジェクトに配置 string strStorageName = "wksTree"; wks.PutBinaryStorage(strStorageName, tr); }



ツリーを取得

OriginObject::GetBinaryStorage メソッドは、名前で Origin オブジェクトからツリーを取得するの

に使われます。

Worksheet wks = Project.ActiveLayer(); if( wks ) { Tree tr; string strStorageName = "wksTree"; // wksTree というツリーが存在していれば True を返す if( wks.GetBinaryStorage(strStorageName, tr) ) out_tree(tr); // ツリーを出力 }

すべてのツリーの名前を取得

OriginObject::GetStorageNames メソッドは Origin オブジェクト内に保存されるすべての名前を

取得します。次の 2 つのストレージタイプがあります。INI とバイナリツリーはバイナリストレージに属

し、以下のサンプルコードはワークシートからバイナリストレージを取得する方法を示します。

Worksheet wks = Project.ActiveLayer(); if( wks ) { // すべてのバイナリタイプのストレージの名前を取得 vector<string> vsNames; wks.GetStorageNames(vsNames, STORAGE_TYPE_BINARY); for(int nn = 0; nn < vsNames.GetSize(); nn++) out_str(vsNames[nn]); }

ワークシート列内のツリーにアクセスするワークシート列でツリーをセットおよび取得するには、上記で説明したようにワークシートでツリーをセ

ットおよび取得するのと同じ方法を使います。

ツリーの追加 Worksheet wks = Project.ActiveLayer(); Column col(wks, 0); Tree tr; tr.test.strVal = "This is a column"; tr.value.dVal = 0.15; col.PutBinaryStorage("colTree", tr);



ツリーを取得 Worksheet wks = Project.ActiveLayer(); Column col(wks, 0); Tree tr; if( col.GetBinaryStorage("colTree", tr) ) out_tree(tr);

すべてのツリーの名前を取得 Worksheet wks = Project.ActiveLayer(); Column col(wks, 0); // すべてのバイナリタイプのストレージの名前を取得 vector<string> vsNames; col.GetStorageNames(vsNames, STORAGE_TYPE_BINARY); for(int nn = 0; nn < vsNames.GetSize(); nn++) out_str(vsNames[nn]);

ファイルインポートのツリーノードにアクセスするワークシートにデータをインポートしたあと、Origin はページレベルで特別なツリーのような構造のメ

タデータを保存します。ファイルについての基本情報は、ツリーから直接取り出したり、配置すること

ができます。

Worksheet wks = Project.ActiveLayer(); WorksheetPage wksPage = wks.GetPage(); storage st; st = wksPage.GetStorage("system"); Tree tr; tr = st; double dDate = tr.Import.FileDate.dVal; printf("File Date:%s¥n", get_date_str(dDate, LDF_SHORT_AND_HHMMSS_SEPARCOLON)); printf("File Name:%s¥n", tr.Import.FileName.strVal); printf("File Path:%s¥n", tr.Import.FilePath.strVal);

レポートシートツリーにアクセスする分析レポートシートは、ツリー構造に基づく特別にフォーマットされたワークシートです。下記のように

レポートシートからレポートツリーを取得できます。

Worksheet wks = Project.ActiveLayer(); Tree trReport;

8.5 操作にアクセスする


uint uid; // レポート範囲の UID を受け取る // エスケープ操作文字列を変換する(ex.?$OP:A=1) // 戻りのツリーに実際のデータセット名 bool bTranslate = true; if( wks.GetReportTree(trReport, &uid, 0, GRT_TYPE_RESULTS, true) ) { out_tree(trReport); }


8.5.1 すべての操作のリスト列の統計ダイアログ、非線形曲線フィットダイアログなどの多くの再計算分析ツールは、Operationクラスに基づいています。操作全体が完了したら、結果シートまたは結果グラフに錠前アイコンが現

れます。すべての操作を Project::Operations を使って、一覧表示することができます。次のコード

は、すべての操作を取得し、操作の名前を印刷するのに使うことができます。

OperationManager opManager; opManager = Project.Operations; int count = opManager.GetCount(); for(int index=0; index < count; index++) { OperationBase& op = opManager.GetOperation(index); string strName = op.GetName(); out_str(strName); }

8.5.2 ワークシートが階層であるかのチェックワークシートが結果テーブルのシートであるかどうかをチェックする場合、次のコードのようにレイヤシ

ステムパラメータを使ってチェックすることができます。

Worksheet wks = Project.ActiveLayer(); bool bHierarchySheet = (wks.GetSystemParam(GLI_PCD_BITS) & WP_SHEET_HIERARCHY); if( bHierarchySheet ) out_str("This is a report table sheet"); else out_str("This is not a report table sheet");



8.5.3 レポートシートにアクセスする次のコードは、レポートシートからレポートツリーを取得し、レポートツリーから得られる結果を文字フ

ォーマットにリンクしたセルに変換し、新しいワークシートに配置する方法を示しています。

これはレポートシートからレポートツリーを取得する方法です。このコードを実行するには、レポートシ

ートをアクティブにする必要があります。

Worksheet wks = Project.ActiveLayer(); Tree trResult; wks.GetReportTree(trResult);

次のコードは、レポートツリーから必要な結果を取得し、それらを文字フォーマットにリンクしたセルに

変換し、新しく作成したワークシートに配置する方法を示しています。

// サマリーテーブルに新しいシートを追加 WorksheetPage wksPage = wks.GetPage(); int index = wksPage.AddLayer(); Worksheet wksSummary = wksPage.Layers(index); string strCellPrefix; strCellPrefix.Format("cell://%s!", wks.GetName()); vector<string> vsLabels, vsValues; // パラメータ vsLabels.Add(strCellPrefix + "Parameters.Intercept.row_label2"); vsValues.Add(strCellPrefix + "Parameters.Intercept.Value"); vsLabels.Add(strCellPrefix + "Parameters.Slope.row_label2"); vsValues.Add(strCellPrefix + "Parameters.Slope.Value"); // 統計 vsLabels.Add(strCellPrefix + "RegStats.DOF.row_label"); vsValues.Add(strCellPrefix + "RegStats.C1.DOF"); vsLabels.Add(strCellPrefix + "RegStats.SSR.row_label"); vsValues.Add(strCellPrefix + "RegStats.C1.SSR"); // 列に配置 Column colLabel(wksSummary, 0); Column colValue(wksSummary, 1); colLabel.PutStringArray(vsLabels); colValue.PutStringArray(vsValues);

137

99 インポート Origin の大きな利点の 1 つは、異なる形式のデータをワークシートや行列シートにインポートできる

ことです。Origin C は、ASCII、バイナリファイル、画像ファイル、データベース内のデータをインポ

ートする機能があります。次のセクションでは、ワークシートまたは行列シートにデータをインポートす

る方法を示しています。

9.1 データをインポートする Worksheet および MatrixLayer クラスは Datasheet クラスから派生されます。Datasheet クラス

には ImportASCII というメソッドがあります。importASCII メソッドは、ASCII データファイルをイン

ポートするのに使われます。Microsoft Excel および SPC データファイルをそれぞれインポートする

には、ImportExcel および ImportSPC というメソッドがあります。

9.1.1 ASCII データファイルをワークシートにインポート初のサンプルは、ASCII データファイルをアクティブワークブックのアクティブワークシートにイン

ポートします。初にファイルフォーマットを検出するために、AscImpReadFileStruct グローバル

関数を呼び出します。フォーマット情報は、ASCIMP 構造に保存されています。そして構造は、実

際にインポートを行う ImportASCII メソッドに渡されます。

string strFile = "D:¥¥data.dat"; // いくつかのデータファイルの名前 ASCIMP ai; if(0 == AscImpReadFileStruct(strFile, &ai) ) { // このサンプルでは、LabTalk のシステム変数@NPO を 0 にして // ASCII インポートのプログレスバーを無効 // これは任意で、ここで可能であることを表示 // LTVarTempChange クラスは // LabTalk 変数を簡単に設定および元に戻す LTVarTempChange についての詳細は // LabTalk にアクセスするセクションをご覧ください LTVarTempChange progressBar("@NPO", 0); // 0 = プログレスバーを無効化 // アクティブワークブックからアクティブワークシートを取得 Worksheet wks = Project.ActiveLayer(); if(0 == wks.ImportASCII(strFile, ai)) out_str("Import data successful."); }

9.1 データをインポートする

138 インポート

次のサンプルは、ASCII データファイルをワークシートにインポートしますが、ファイルから各列の情

報も取得し、ワークシート列をセットアップします。

// ファイルを開くダイアログでユーザにインポートするファイルの選択を促す string strFile = GetOpenBox("*.dat"); if( strFile.IsEmpty() ) return; // User canceled or error ASCIMP ai; if( 0 == AscImpReadFileStruct(strFile, &ai) ) { ai.iAutoSubHeaderLines = 0; // 自動検出サブヘッダを無効に // 1, ロングネーム // 2.単位 // 3.拡張された説明(ユーザ定義) // 4.データ型の指示(ユーザ定義) ai.iSubHeaderLines = 4; // iAutoSubHeaderLines が false(0)のとき、ai.nLongName, ai.nUnits, ai.nFirstUserParams の // 開始インデックスがメインヘッダから取得 ai.nLongNames = ai.iHeaderLines; ai.nUnits = ai.iHeaderLines + 1; // 初のユーザパラメータのインデックスをセット ai.nFirstUserParams = ai.iHeaderLines + 2; ai.nNumUserParams = 2; // ユーザパラメータの数をセット // 列ヘッダをコメントラベルにセット ai.iMaxLabels = 0; // アクティブワークブックからアクティブワークシートを取得 Worksheet wks = Project.ActiveLayer(); if( 0 == wks.ImportASCII(strFile, ai) ) // エラーなしで 0 を返す { // ユーザパラメータラベルの名前 vector<string> vsUserLabels = {"Expanded Description", "Type Indication"}; // ユーザパラメータラベルを指定した名前にセット Grid grid; grid.Attach(wks); grid.SetUserDefinedLabelNames(vsUserLabels); wks.AutoSize(); // 内容に合うように列幅を調整 } }

9.1 データをインポートする

インポート 139

9.1.2 ASCII データファイルを行列シートにインポートデータを行列シートにインポートすることは、ワークシートへのインポートに似ています。この例は、

初のワークシート例に似ています。違いは、Worksheet クラスではなく、 MatrixLayer クラスを使っ

て、アクティブな行列ブックからアクティブな行列シートを取得するという点です。

string strFile = "D:¥¥someData.dat"; ASCIMP ai; if( 0 == AscImpReadFileStruct(strFile, &ai) ) { MatrixLayer ml = Project.ActiveLayer(); if( 0 == ml.ImportASCII(strFile, ai) ) out_str("Data imported successfully."); }

9.1.3 インポートフィルタを使ってデータをインポートするファイルをインポートする関数は、OriginC¥Originlab¥FileImport.h ファイルで宣言されます。こ

れらの関数は、Origin C の言語リファレンスヘルプに説明があります。

ファイルインポート関数を呼ぶ前に、初にプログラム的に FileImport.c をロードし、コンパイルす

る必要があります。これは、コマンドを使ってスクリプトから行うことができます。

run.LoadOC(Originlab¥FileImport.c, 16); // 16 というオプションは、FileImport.c ファイルの corresponding .h で // スキャンすることで、すべての Origin C 依存ファイルがロードされるようにする

次のサンプルは、フィルタファイルでデータをインポートすることを示しています。

#include <..¥Originlab¥FileImport.h> void import_with_filter_file() { Page pg = Project.Pages(); // Active Page // ページブック名を取得 string strPageName = pg.GetName(); // ページのアクティブレイヤインデックスを取得 int nIndexLayer = pg.Layers().GetIndex(); // Origin サンプルフォルダを取得 string strPath = GetAppPath(TRUE) + "Samples¥¥Signal Processing¥¥"; // oif フィルタ名を指定 string strFilterName = "TR Data Files"; import_file(strPageName, nIndexLayer, strPath + "TR2MM.dat", strFilterName); }

データフォーマットに合わせるために、既存のフィルタを修正し、ファイルからフィルタをロードし、設

定する必要があるかもしれません。以下のケースをご覧ください。

9.2 画像のインポート

140 インポート

#include <..¥Originlab¥FileImport.h> void config_filter_tree() { string strFile = GetAppPath(1) + "Samples¥¥Curve Fitting¥¥Step01.dat"; if( !strFile.IsFile() ) return; Worksheet wks; wks.Create("origin"); // ツリーにフィルタをロード Tree trFilter; string strFilterName = "ASCII"; int nLocation = 1; // 組み込みのフィルタフォルダ WorksheetPage wp = wks.GetPage(); string strPageName = wp.GetName(); int nRet = load_import_filter(strFilterName, strFile, strPageName, nLocation, trFilter); if( 0 != nRet ) out_str("Failed to load import filter"); ASCIMP ascimp; ascimp = trFilter.ASCIMP;// フィルタツリーを ASCIMP 構造体に変換 ascimp.iRenameCols = 0; // 0 はデフォルトの列名を保持、1 は列の名前を変更 nRet = wks.ImportASCII(strFile, ascimp); if(0 == nRet) out_str("Import successful"); }

データファイルをインポートするフィルタがない場合があります。このような場合には、Origin のイン

ポートウィザードを使って、インポートフィルタを作成する必要があります。Origin C と impFile X フ

ァンクションを使って、Origin に含まれるインポートフィルタと自分自身のインポートフィルタを使って

データファイルをインポートできます。

Origin C から X ファンクションを呼び出す詳細なサンプルについては、Origin C で X ファンクショ

ンを呼ぶセクションをご覧ください。

9.2 画像のインポート Origin は、行列、ワークシートセル、グラフにイメージをインポートすることができます。次のセクショ

ンは、Origin C アプリケーションでイメージをインポートする方法を示します。


インポート 141

9.2.1 イメージを行列にインポート次のサンプル関数は、イメージファイルを行列にインポートする方法を示しています。関数は、行列

名、ファイル名、グレースケールの深度の 3 つの引数を取ります。このサンプルで呼び出されるキー

となる関数は、oimg_image_info および oimg_load_image です。前者はイメージファイルに含ま

れるイメージについての情報を取得するのに使われます。取得した情報は、目的の行列を準備する

のに使われます。後者の関数は、グレースケールデータ値として目的の行列にイメージファイルに実

際にインポートするのに使われます。

#include <import_image.h> // oimg_ functions で必要 bool import_image_to_matrix_data( LPCSTR lpcszMatrixName, // 行列ブック名 LPCSTR lpcszFileName, // イメージファイル名 int nGrayDepth) // 8 ビットまたは 16 ビットのグレースケール { // 目的の行列オブジェクトを取得 MatrixObject mo(lpcszMatrixName); if( !mo.IsValid() ) return false; // 元のイメージ情報を取得 int nWidth, nHeight, nBPP; if( !oimg_image_info(lpcszFileName, &nWidth, &nHeight, &nBPP) ) return false; // 目的の行列を元の画像を同じ次数にセット if( !mo.SetSize(nHeight, nWidth, 0) ) return false; // 目的の行列のデータサイズ int nDataType = (16 == nGrayDepth ?FSI_USHORT :FSI_BYTE); if( !mo.SetInternalData(nDataType, FALSE, FALSE) ) return false; // イメージを行列にインポート bool bRet; if( FSI_USHORT == nDataType ) { Matrix<WORD>& mm = mo.GetDataObject(); bRet = oimg_load_image(lpcszFileName, &mm, 16, nHeight, nWidth); } else // FSI_BYTE { Matrix<BYTE>& mm = mo.GetDataObject(); bRet = oimg_load_image(lpcszFileName, &mm, 8, nHeight, nWidth); } return bRet; }


142 インポート

9.2.2 イメージをワークシートセルに挿入する次のサンプルは、ファイルから JPEG ファイルをワークシートセルに埋め込みます。これは、

Worksheet クラスの AttachPicture メソッドを使って行います。

int nRow = 0, nCol = 0; string strFile = "D:¥¥Graph1.jpg"; DWORD dwEmbedInfo = EMBEDGRAPH_KEEP_ASPECT_RATIO; Worksheet wks = Project.ActiveLayer(); if( wks.AttachPicture(nRow, nCol, strFile, dwEmbedInfo) ) { wks.Columns(nCol).SetWidth(20); wks.AutoSize(); }

9.2.3 イメージをグラフにインポートする次のサンプルは、ファイルから JPEG ファイルをグラフレイヤに埋め込みます。これは、

image_import_to_active_graph_layer グローバル関数を使って行われます。

#include <image_utils.h> // image_import_to_active_graph_layer 関数を呼び出す前に // image_utils.c をコンパイル LT_execute("run.LoadOC(Originlab¥¥image_utils.c)"); string strFile = "D:¥¥Graph1.jpg"; image_import_to_active_graph_layer(strFile);

143

1100 エクスポート

10.1 ワークシートのエクスポート Worksheet クラスは、ワークシートデータをファイルに保存する ExportASCII メソッドがあります。メ

ソッドは、開始行と開始列、終了行と終了列を指定する引数を持ちます。また、欠損データ値を取り

扱う方法や列ラベルをエクスポートするかどうかを指定することもできます。

以下のサンプルはすべて wks が有効な Worksheet オブジェクトで、strFileName が目的のファイ

ルへのフルパスおよびファイル名を含む string オブジェクトであるものとします。

初のサンプルは、ワークシート内のデータをすべて TAB 区切りとして、欠損値をスペースとしてフ

ァイルに保存するものです。

wks.ExportASCII(strFileName, WKS_EXPORT_ALL|WKS_EXPORT_MISSING_AS_BLANK);

次のサンプルは、ワークシート内のデータをすべてカンマ区切りとして、欠損値をスペースとしてファ

イルに保存するものです。さらに列ラベルも保存されます。

wks.ExportASCII(strFileName, WKS_EXPORT_ALL|WKS_EXPORT_LABELS|WKS_EXPORT_MISSING_AS_BLANK, ',');

後のサンプルは、ワークシート内のデータの初の 2 列をカンマ区切りとして、欠損値をスペース

としてファイルに保存するものです。さらに列ラベルも保存されます。行と列のインデックスは 0 から

始まります。終了行と終了列のインデックスは、それぞれ終行と終列を示すため -1 にすることが

できます。

wks.ExportASCII(strFileName, WKS_EXPORT_ALL|WKS_EXPORT_LABELS|WKS_EXPORT_MISSING_AS_BLANK, '¥t', 0, 0, // 初の行、初の列から開始 -1, 1); // 終行、2 列目で終了

10.2 グラフのエクスポート

144 エクスポート

10.2 グラフのエクスポート Origin は、グラフをさまざまな画像形式にエクスポートすることができます。Origin C は、

export_page 関数および export_page_to_image 関数でこの機能にアクセスできます。

次のサンプルは、プロジェクト内のすべてのグラフを EMF ファイルにエクスポートします。EMF ファ

イルの名前は、グラフの名前と同じで、C ドライブのルートに出力されます。

string strFileName; foreach(GraphPage gp in Project.GraphPages) { strFileName.Format("c:¥¥%s.emf", gp.GetName()); export_page(gp, strFileName, "EMF"); }

次のサンプルは、800x600 の JPEG ファイルにアクティブグラフをエクスポートします。JPEG ファイ

ルの名前は、グラフの名前と同じで、C ドライブのルートに出力されます。

GraphPage gp; gp = Project.ActiveLayer().GetPage(); if( gp ) // アクティブページがグラフの場合 { string strFileName; strFileName.Format("c:¥¥%s.emf", gp.GetName()); export_page_to_image(strFileName, "JPG", gp, 800, 600); }

10.3 行列のエクスポート Origin の Matrix は、ASCII データファイルまたは画像ファイルにエクスポートできます。

10.3.1 行列を ASCII データファイルにエクスポート次のサンプルは、アクティブな行列ウィンドウから*.txt ファイルに ASCII データをエクスポートする

方法を示しています。export_matrix_ascii_data 関数に対する oExtFile.h ファイルを含める必要

があります。

file ff; if ( !ff.Open("C:¥¥ExpMatData.txt", file::modeCreate|file::modeWrite) ) return; //fail to open file for write string strRange; MatrixLayer ml = Project.ActiveLayer(); ml.GetRangeString(strRange); LPCSTR lpcszSep = "¥t"; vector<string> vXLabels, vYLabels; // 空白はラベルなし

10.3 行列のエクスポート

エクスポート 145

DWORD dwCntrl = GDAT_FULL_PRECISION | GDAT_MISSING_AS_DASHDASH; // エラーなしで 0 を返す int nErr = export_matrix_ascii_data(&ff, strRange, ml.GetNumRows(), ml.GetNumCols(), lpcszSep, &vXLabels, &vYLabels, dwCntrl);

10.3.2 行列からイメージを画像ファイルにエクスポート次のサンプルは、行列を画像ファイルにエクスポートする方法を示します。

export_Matrix_to_image 関数に対する image_utils.h ファイルを含める必要があります。

MatrixLayer ml = Project.ActiveLayer(); MatrixObject mo = ml.MatrixObjects(); export_Matrix_to_image("c:¥¥matrixImg.jpg", "jpg", mo);

147

1111 分析とアプリケーション Origin C は、データ分析、数学や科学技術の業務で利用できる価値ある機能をサポートしています。

次のセクションでは、これらの関数について、利用分野に応じたサンプルを提供しています。

11.1 数学

11.1.1 正規化次のサンプルは、データプロット(曲線)内のデータポイントを選択し、レイヤ内のすべての曲線をその

点と同じ値に正規化します。このコードは、複数曲線を持つグラフレイヤがアクティブであり、すべて

の曲線が同じ X 値を共有していることを前提としています。この前提条件は、スペクトル分析ではよく

行われることです。

GraphLayer gl = Project.ActiveLayer(); if( !gl ) return; // ある特定の曲線の 1 つの特定のポイントをクリックして選択 GetGraphPoints mypts; mypts.SetFollowData(true); mypts.GetPoints(1, gl); vector vx, vy; vector<int> vn; if(mypts.GetData(vx, vy, vn) == 1) { // 選択したポイントのインデックスと y 値を保存 int nxpicked = vn[0] - 1; double dypicked = vy[0]; // レイヤ内のすべてのデータポイントをループ foreach( DataPlot dp in gl.DataPlots ) { // データ範囲、現在のプロットの y 列 XYRange xy; Column cy; if(dp.GetDataRange(xy) && xy.GetYColumn(cy)) { // y 列から vector 参照を y 値に取得 vectorbase &vycurrent = cy.GetDataObject(); // vector をスケールし、y 値と選択したポイントを一致

11.1 数学

148 分析とアプリケーション

vycurrent *= dypicked/vycurrent[nxpicked]; } } }

11.1.2 補間/補外 ocmath_interpolate 関数は、線形、スプライン、B スプラインのモードで補間/補外を実行するのに

使われます。

// アクティブワークシートを 4 列にする // 初の 2 列に元の xy データ // 3 列目に入力 x 値、4 列目に y 値 Worksheet wks = Project.ActiveLayer(); wks.SetSize(-1, 4); DataRange drSource; drSource.Add(wks, 0, "X"); // 1 列目 - 元の x データ drSource.Add(wks, 1, "Y"); // 2 列目 - 元の y データ vector vSrcx, vSrcy; drSource.GetData(&vSrcx, 0); drSource.GetData(&vSrcy, 1); DataRange drOut; drOut.Add(wks, 2, "X"); // 3 列目 - 入力 x データ drOut.Add(wks, 3, "Y"); // 4 列目 - 補間した y データ vector vOutx, vOuty; drOut.GetData(&vOutx, 0); int nSrcSize = vSrcx.GetSize(); int nOutSize = vOutx.GetSize(); vOuty.SetSize(nOutSize); int nMode = INTERP_TYPE_BSPLINE; double dSmoothingFactor = 1; int iRet = ocmath_interpolate(vOutx, vOuty, nOutSize, vSrcx, vSrcy, nSrcSize, nMode, dSmoothingFactor); drOut.SetData(&vOuty, &vOutx);

11.1.3 積分 Origin C では、積分を実行するのに NAG の積分ルーチンを使っています。Origin C と NAG を

使って、被積分関数、パラメータを持つ被積分関数、揺れのある被積分関数、不定積分、高次積分

などで積分を実行できます。次のサンプルは、NAG を使った積分を行う方法を示しています。

Origin C コードには、NAG 関数を呼ぶ前に NAG ヘッダファイルをインクルードします。

11.1 数学

分析とアプリケーション 149

#include <OC_nag8.h> // NAG の宣言

簡単な積分関数初のサンプルは、1 つの積分変数を持つ簡単な被積分関数で基本積分を実行する方法を示して

います。

// NAG_CALL は適切な呼び出し表記これを関数ポインタのように扱い // 自分自身の被積分関数を定義 double NAG_CALL func(double x) { return (x*sin(x*30.0)/sqrt(1.0-x*x/(PI*PI*4.0))); } void nag_d01ajc_ex() { double a = 0.0; double b = PI * 2.0; // 積分間隔 double epsabs, abserr, epsrel, result; //精度が十分でない場合、epsabs と epsrel を使って // この量を目的の精度に拡張 epsabs = 0.0; epsrel = 0.0001; // 積分内の関数を評価するのに // 部分間隔の大数が必要// ほとんどの場合、200 から 500 くらいが適切であり、お薦めです。 int max_num_subint = 200; Nag_QuadProgress qp; NagError fail; d01ajc(func, a, b, epsabs, epsrel, max_num_subint, &result, &abserr, &qp, &fail); // 次の 3 つのエラー以外のエラーは // 入力が不正か、割り当ての失敗再び積分ルーチンを呼び出す前に // メモリリークを避け、メモリ割り当てを // 解放する必要がある if (fail.code != NE_INT_ARG_LT && fail.code != NE_BAD_PARAM && fail.code != NE_ALLOC_FAIL) { NAG_FREE(qp.sub_int_beg_pts); NAG_FREE(qp.sub_int_end_pts); NAG_FREE(qp.sub_int_result); NAG_FREE(qp.sub_int_error); } printf("%g¥n", result); }

11.1 数学


パラメータ付きの積分関数次のサンプルは、パラメータ付きの被積分関数で積分を定義し、実行する方法を示しています。ユ

ーザ定義の構造でパラメータが積分子に渡されます。これは、スタティックな変数を被積分関数のパ

ラメータとして使用し、スレッドを安全にします。

このサンプルは、NAG の不定積分子を使用することもできます。例えば、不定積分 d01smc 関数を

呼び出す行を有効にして、サンプルが不定積分を実行するのに使用します。

struct user // 被積分パラメータ { double A; double Xc; double W; }; // ユーザによって供給される関数は、与えられた x で被積分関数の戻り値を返す static double NAG_CALL f_callback(double x, Nag_User *comm) { struct user *param = (struct user *)(comm->p); return param->A * exp(-2 * (x - param->Xc) * (x - param->Xc) / param->W / param->W) / (param->W * sqrt(PI / 2)); }

関数に対するパラメータをセットし、積分を実行する必要のある追加のパラメータを定義します。そし

て、積分は、引数としてパラメータを渡し、1 つの関数呼び出しで実行されます。

void nag_d01sjc_ex() { double a = 0.0; double b = 2.0; // 積分間隔 // 次の変数は積分の精度を // 制御するのに使用 double epsabs = 0.0; // 絶対精度、相対精度を使うには負値をセット double epsrel = 0.0001; // 相対精度、絶対精度を使うには負値をセット int max_num_subint = 200; // 大部分間隔をセット、200-500 がお勧め // 結果は、アルゴリズムで返される近似積分値を保持 // abserr は |I - result| に対する上側境界の見積もり値 // ここで I は積分値 double result, abserr; // Nag_QuadProgress の構造、 // max_num_subint 要素を持つ内部的に割り当てられたポインタを含む Nag_QuadProgress qp; // NAG エラーパラメータ(構造) NagError fail; // パラメータは NAG の通信構造体で被積分関数に渡される struct user param;

11.1 数学


param.A = 1.0; param.Xc = 0.0; param.W = 1.0; Nag_User comm; comm.p = (Pointer)&param; // 積分実行 // NAG の不定積分子で使用可能な 3 種類の不定境界タイプ // integrator Nag_LowerSemiInfinite, Nag_UpperSemiInfinite, Nag_Infinite /* d01smc(f_callback, Nag_LowerSemiInfinite, b, epsabs, epsrel, max_num_subint, &result, &abserr, &qp, &comm, &fail); */ d01sjc(f_callback, a, b, epsabs, epsrel, max_num_subint, &result, &abserr, &qp, &comm, &fail); // エラーメッセージを出力してエラーをチェック if (fail.code != NE_NOERROR) printf("%s¥n", fail.message); // 次の 3 つのエラー以外のエラーは // 入力が不正か、割り当ての失敗 // 再び積分ルーチンを呼び出す前にメモリリークを避け // メモリ割り当てを解放する必要がある if (fail.code != NE_INT_ARG_LT && fail.code != NE_BAD_PARAM && fail.code != NE_ALLOC_FAIL) { NAG_FREE(qp.sub_int_beg_pts); NAG_FREE(qp.sub_int_end_pts); NAG_FREE(qp.sub_int_result); NAG_FREE(qp.sub_int_error); } printf("%g¥n", result); }

高次積分関数 2 次以上の高次積分に対して、NAG 積分子関数 d01wcc を呼び出し、積分を実行します。

ユーザ定義のコールバック関数は、NAG の d01wcc 関数に渡されます。

double NAG_CALL f_callback(int n, double* z, Nag_User *comm) { double tmp_pwr; tmp_pwr = z[1]+1.0+z[3]; return z[0]*4.0*z[2]*z[2]*exp(z[0]*2.0*z[2])/(tmp_pwr*tmp_pwr); }

メイン関数:

void nag_d01wcc_ex() {

11.1 数学


// 入力変数 int ndim = NDIM; // 積分の次元 double a[4], b[4]; for(int ii=0; ii < 4; ++ii) // 積分の間隔 { a[ii] = 0.0; b[ii] = 1.0; } int minpts = 0; int maxpts = MAXPTS; // 関数評価の大数 double eps = 0.0001; // 精度をセット // 出力変数 double finval, acc; Nag_User comm; NagError fail; d01wcc(ndim, f_callback, a, b, &minpts, maxpts, eps, &finval, &acc, &comm, &fail); if (fail.code != NE_NOERROR) printf("%s¥n", fail.message); if (fail.code == NE_NOERROR || fail.code == NE_QUAD_MAX_INTEGRAND_EVAL) { printf("Requested accuracy =%12.2e¥n", eps); printf("Estimated value =%12.4f¥n", finval); printf("Estimated accuracy =%12.2e¥n", acc); } }

11.1.4 微分 ocmath_derivative 関数は、スムージング無しで単純な微分を計算するのに使用します。関数は、

以下に示すように、ocmath.h で宣言されます。

int ocmath_derivative( const double* pXData, double* pYData, uint nSize, DWORD dwCntrl = 0);

関数は、すべての欠損値を無視し、データ点とその隣のデータ点間の 2 つの勾配の平均を取ること

で微分を計算します。dwCntrl 引数が 0 というデフォルト値を使う場合、関数は、データの方向が変

わるときに入力されます。

if( OE_NOERROR == ocmath_derivative(vx, vy, vx.GetSize()) ) out_str("successfully");

dwCntrl が DERV_PEAK_AS_ZERO にセットされると、データの方向が変わった場合に関数に

0 が入力されます。

if( OE_NOERROR == ocmath_derivative(vx, vy, vx.GetSize(), DERV_PEAK_AS_ZERO) ) out_str("successfully");

11.2 統計


11.2 統計ワークシート内で選択したデータ(列や行、ワークシート全体)の統計処理を行いたい場合があります。

データで操作する：数値データ：データ範囲の章には、列/行のインデックスでデータ範囲を構築す

る方法があり、元のデータをベクターデータにします。

11.2.1 列と行の記述統計量 ocmath_basic_summary_stats 関数は、元データの合計数、平均値、標準偏差、歪度などの基

本統計量を計算します。詳細は、Origin C ヘルプを参照してください。次の Origin C コードは、

vData というベクターオブジェクトのデータのポイント数、平均、平均の標準誤差を計算し、出力しま

す。

int N; double Mean, SE; ocmath_basic_summary_stats(vData.GetSize(), vData, &N, &Mean, NULL, &SE); printf("N=%d¥nMean=%g¥nSE=%g¥n", N, Mean, SE);

11.2.2 度数カウント ocmath_frequency_count 関数は、FreqCountOptions 構造体に従って度数カウントを計算する

のに使用します。

// 度数カウントを行うソースデータ vector vData = {0.11, 0.39, 0.43, 0.54, 0.68, 0.71, 0.86}; // ビンサイズ、設定の開始/終了オプションをセット int nBinSize = 5; FreqCountOptions fcoOptions; fcoOptions.FromMin = 0; fcoOptions.ToMax = 1; fcoOptions.StepSize = nBinSize; fcoOptions.IncludeLTMin = 0; fcoOptions.IncludeGEMax = 0; vector vBinCenters(nBinSize); vector vAbsoluteCounts(nBinSize); vector vCumulativeCounts(nBinSize); int nOption = FC_NUMINTERVALS; // 後のビンを拡張 int nRet = ocmath_frequency_count( vData, vData.GetSize(), &fcoOptions, vBinCenters, nBinSize, vAbsoluteCounts, nBinSize,

11.2 統計


vCumulativeCounts, nBinSize, nOption); if( STATS_NO_ERROR == nRet ) out_str("Done");

さらに、離散/カテゴリーデータに対して度数カウントを計算する 2 つの関数があります。1 つはテキス

トデータに対する ocu_discrete_frequencies で、もう 1 つは数値データに対する ocmath_discrete_frequencies です。また、2 次元データに対して度数カウントを計算する 2 つの

関数があります。ocmath_2d_binning_stats と ocmath_2d_binning です。

11.2.3 相関係数 ocmath_corr_coeff 関数は、Pearson rank, Spearman rank, Kendall rank の相関係数を計算

するのに使われます。

matrix mData = {{10,12,13,11}, {13,10,11,12}, {9,12,10,11}}; int nRows = mData.GetNumRows(); int nCols = mData.GetNumCols(); matrix mPeaCorr(nCols, nCols); matrix mPeaSig(nCols, nCols); matrix mSpeCorr(nCols, nCols); matrix mSpeSig(nCols, nCols); matrix mKenCorr(nCols, nCols); matrix mKenSig(nCols, nCols); if(STATS_NO_ERROR == ocmath_corr_coeff(nRows, nCols, mData, mPeaCorr, mPeaSig, mSpeCorr, mSpeSig, mKenCorr, mKenSig)) { out_str("Done"); }

11.2.4 正規性の検定 *ocmath_shapiro_wilk_test 関数を使って、Shapiro-Wilk の正規性の検定を実行します。

*ocmath_lilliefors_test 関数を使って、Lilliefors の正規性の検定を実行します。

*ocmath_kolmogorov_smirnov_test 関数を使って、Kolmogorov-Smirnov の正規性の検定を

実行します。

vector vTestData = {0.11, 0.39, 0.43, 0.54, 0.68, 0.71, 0.86}; NormTestResults SWRes; if( STATS_NO_ERROR == ocmath_shapiro_wilk_test(vTestData.GetSize(), vTestData, &SWRes, 1) ) { printf("DOF=%d, TestStat=%g, Prob=%g¥n", SWRes.DOF, SWRes.TestStat, SWRes.Prob); }

11.3 カーブフィッティング


11.3 カーブフィッティング NLFit は、Origin8 で導入された新しいフィット機構です。この新しいフィット機構は、反復実行中に

データのコピーでフィットプロセスを扱います。新しいフィット機構はワークシートデータを直接繰り返

しアクセスするので、古いフィット機構に比べ、早い操作を実行できます。

2 つのクラスを利用して非線形フィットを実行します。

NLfit これは新しいフィットエンジンから低いレベルの API を持つ Origin C のクラスです。このクラスは、

Origin の知識が無く、バッファ内でデータのコピーを操作します。このクラスを使うには、すべての必

要なバッファ(ポインタ)を準備します。将来、この分離はバックグラウンド処理としてフィットを実行する

組み込みを行う準備を行っています。

NLFitSession これは、より高い Origin C クラスで、ユーザフレンドリーなインターフェースを持ち、Origin オブジェ

クトに NLFit クラスを組み込みます。このクラスは、NLFit ダイアログ内のカーネルです。Origin へ

のインターフェースの処理が複雑で、NLFitSession クラスがこの複雑さの対応をするので、Origin C コード内でこのクラスを使用することをお勧めします。

11.3.1 非線形フィット NLFitSession クラスを使う前に、特別なヘッダファイルをインクルードする必要があります。

#include <..¥originlab¥NLFitSession.h>

また、現在のワークスペースに OriginC\Originlab\nlsf_utils.c ファイルを組み込み、コンパイル

する必要があります。プログラムでファイルを追加するため、コマンドウィンドウまたはスクリプトファイ

ルから下記の LabTalk コマンドを実行します。

Run.LoadOC(Originlab¥nlsf_utils.c, 16)

NLFitSession オブジェクトを定義し、フィット関数をガウスにセットします。

// 関数をセット NLFitSession nlfSession; if ( !nlfSession.SetFunction("Gauss") ) { out_str("Fail to set function!"); return; }



// パラメータ名と数字を取得 vector<string> vsParamNames; int nNumParamsInFunction = nlfSession.GetParamNamesInFunction(vsParamNames);

DATA_MODE_GLOBAL モードで 2 つの XY データセットを設定し、パラメータを共有してグロー

バルフィットを実行します。

int nNumData = 2; // 初のデータセットをセット if ( !nlfSession.SetData(vY1, vX1, NULL, 0, nNumData) ) { out_str("Fail to set data for the first dataset!"); return; } // 2 番目のデータセットをセット if ( !nlfSession.SetData(vY2, vX2, NULL, 1, nNumData, DATA_MODE_GLOBAL) ) { out_str("Fail to set data for the second dataset!"); return; }

パラメータ初期化コードを実行し、パラメータ値を初期化します。

// パラメータ初期化 if ( !nlfSession.ParamsInitValues() ) { out_str("Fail to init parameters values!"); return; }

別の方法としては、直接パラメータ値を 1 つずつセットします。

vector vParams(nNumParamsInFunction*nNumData); // 初のデータセットにパラメータ値をセット vParams[0] = 5.5; // y0 vParams[1] = 26; // A vParams[2] = 8; // xc vParams[3] = 976; // w // 2 番目ののデータセットにパラメータ値をセット vParams[4] = 2.3; // y0 vParams[5] = 26; // A vParams[6] = 10.3; // xc vParams[7] = 102; // w int nRet = nlfSession.SetParamValues(vParams); if(nRet != 0) // 0 はエラー無し return;

2 つのデータセット間で xc パラメータを共有します。

int nSharedParamIndex = 1; // 1, ガウス関数の xc のインデックス nlfSession.SetParamShare(nSharedParamIndex);

フィットを実行し、状況メッセージを出力します。



// フィット実行 int nFitOutcome; nlfSession.Fit(&nFitOutcome); string strOutcome = nlfSession.GetFitOutCome(nFitOutcome); out_str("Outcome of the fitting session :" + strOutcome);

フィット統計の結果を取得します。

int nDataIndex = 0; RegStats fitStats; NLSFFitInfo fitInfo; nlfSession.GetFitResultsStats(&fitStats, &fitInfo, false, nDataIndex); printf("# Iterations=%d, Reduced Chisqr=%g¥n", fitInfo.Iterations, fitStats.ReducedChiSq);

終的なフィットパラメータ値を取得します。

vector vFittedParamValues, vErrors; nlfSession.GetFitResultsParams(vFittedParamValues, vErrors); // パラメータ xc は 2 つの入力データで共有 // xc の値はすべてのデータセットに対して同じで // フィットパラメータ値 - vParamValues に 1 度だけ現れる // vsParamNames はガウス関数のパラメータ名 - y0, xc, w, A を含む // 2 番目のデータセットに xc 以外のパラメータ名を追加 vsParamNames.Add("y0"); vsParamNames.Add("w"); vsParamNames.Add("A"); for( int nParam = 0; nParam < vFittedParamValues.GetSize(); nParam++) { printf("%s = %f¥n", vsParamNames[nParam], vFittedParamValues[nParam]); }

終的なフィットパラメータを使って、フィット曲線の Y 値を計算します。

vector vFitY1(vX1.GetSize()), vFitY2(vX2.GetSize()); // 初のデータセットに対するフィット Y を取得 nlfSession.GetYFromX(vX1, vFitY1, vX1.GetSize(), 0); // ２番目のデータセットに対するフィット Y を取得 nlfSession.GetYFromX(vX2, vFitY2, vX1.GetSize(), 1);

11.3.2 FDF ファイルにアクセスする FDF ファイルに保存されているフィット関数設定はツリー変数にロードすることができます。

OriginC¥system¥FDFTree.h ファイルをインクルードする必要があります。

#include <origin.h>

そして、nlsf_FDF_to_tree 関数を使います。

string strFile = GetOpenBox("*.FDF"); Tree tr;

11.4 信号処理


if(nlsf_FDF_to_tree(strFile, &tr)) { out_tree(tr); }

11.4 信号処理 Origin C は、信号処理、ノイズデータのスムージングからフーリエ変換 (FFT), 短時間 FFT(STFT), コンボリューション、相関, FFT フィルタリング, ウェーブレット分析に対するグローバル関数と NAG関数のコレクションを提供しています。

Origin C 関数は、Origin C ヘルプ -> Origin C Reference -> Global Function -> Signal Processing カテゴリーにあります。

11.4.1 スムージング ocmath_smooth 関数は、メディアンフィルタ、Savitzky-Golay スムージング、隣接平均スムージン

グの 3 つの方法をサポートしています。

vector vSmooth; // 出力 vSmooth.SetSize(vSource.GetSize()); //Savitzky-Golay スムージングを行う, Left=Right=7, quadratic int nLeftpts = nRightpts = 3; int nPolydeg = 2; int nRet = ocmath_smooth(vSource.GetSize(), vSource, vSmooth, nLeftpts, SMOOTH_SG, EDGEPAD_NONE, nRightpts, nPolydeg);

11.4.2 FFT fft_* 関数を使う前に、fft_utils.h をインクルードする必要があります。

#include <origin.h>

FFT fft_real は、離散フーリエ変換(FFT_FORWARD)または逆フーリエ変換(FFT_BACKWARD)を実行します。

fft_real(vSig.GetSize(), vSig, FFT_FORWARD); // return 0 for no error

11.4 信号処理


周波数スペクトル fft_one_side_spectrum は、FFT 結果の片側スペクトルを計算するのに使用します。

fft_one_side_spectrum(vSig.GetSize(), vSig); // エラー無しで 0 を返す

IFFT fft_real(vSig.GetSize(), vSig, FFT_BACKWARD); // エラー無しで 0 を返す

STFT stft_real 関数は、1D の実数信号データに短時間 FFT を実行するのに使用します。stft_complex 関数は、1D の複素数信号データに短時間 FFT を実行するのに使用します。以下は、実数データ

に対するサンプルです。

int nWinSize = 4; vector win(nWinSize); get_window_data(RECTANGLE_WIN, nWinSize, win); matrix stft; double stime, sfreq; vector sig = {0, 0, 0, 1, 1, 0, 0, 0}; stft_real(sig, win, 0.1, 1, 4, stft, stime, sfreq); for (int ii = 0; ii < stft.GetNumRows(); ii++) { for (int jj = 0; jj < stft.GetNumCols(); jj++) printf ("%f¥t", stft[ii][jj]); printf ("¥n"); }

11.4.3 FFT フィルタ Origin C は、FFT フィルタを実行するのに複数のフィルタタイプをサポートしています。：ローパス、

ハイパス、バンドパス、バンドブロック、しきい値、ローパスパラボリック例えば、

double dFc = 6.5; int iRet = fft_lowpass(vecSignal, dFc, &vecTime);

11.4.4 ウェーブレット分析 Origin C で、NAG 関数を呼び、ウェーブレット分析を実行できます。すべてのウェーブレット関数を

見るには、Origin C ヘルプ -> Origin C Reference -> Global Function 数 -> NAG Function -

11.5 ピークと基線


> Accessing NAG Functions Category and Help -> Wavelet のカテゴリ関連のヘッダファイル

をインクルードする必要があります。

#include <..¥OriginLab¥wavelet_utils.h>

次は、実数型の 1D 連続ウェーブレットのサンプルです。

int n = vX.GetSize(); int ns = vScales.GetSize(); matrix mCoefs(ns, n); NagError fail; nag_cwt_real(Nag_Morlet, 5, n, vX, ns, vScales, mCoefs, &fail);


11.5.1 基線を作成する ocmath_create_baseline_by_masking_peaks 関数は、正のピークのみ、負のピークのみ、正負

両方のピークに対して基線を作成します。

次のサンプルは、入力 XY データ(vx, vy)で、正のピークと負のピークに対して基線を作成する方法

を示します。

// 基線の XY ベクトルにメモリを確保 vector vxBaseline(vx.GetSize()), vyBaseline(vx.GetSize()); // 基線の XY データを見つける int nRet = ocmath_create_baseline_by_masking_peaks(vx.GetSize(), vx, vy, vxBaseline.GetSize(), vxBaseline, vyBaseline, BOTH_DIRECTION); // X データで XY データを昇順にソート if( OE_NOERROR == nRet ) { vector<uint> vn; vxBaseline.Sort(SORT_ASCENDING, true, vn); vyBaseline.Reorder(vn); }

11.5.2 基線を削除する基線の X 座標がピークの曲線の X 座標と同じであれば直接減算でき、それ以外の場合、基線を除

去する前に補間を行う必要があります。次のコードは、補間を行う方法を示し、基線を除去します。現

在のワークシートは、ピーク XY データと基線 XY データの 4 列を持っています。

Worksheet wks = Project.ActiveLayer();



Column colPeakX(wks, 0), colPeakY(wks, 1); Column colBaseLineX(wks, 2), colBaseLineY(wks, 3); // ピーク XY データを取得 // 基線を減算したいので参照で Y データを取得 vector vPeakX = colPeakX.GetDataObject(); vector& vPeakY = colPeakY.GetDataObject(); // 基線データの取得 vector vBaselineX = colBaseLineX.GetDataObject(); vector vBaselineY = colBaseLineY.GetDataObject(); if( vPeakX.GetSize() != vPeakY.GetSize() || vPeakX.GetSize() == 0 || vBaselineX.GetSize() == 0 ) return; // 基線データの補間を行い、ピークデータと同じ X 座標を保持 vector vyBaseTemp(vPeakX.GetSize()); if(OE_NOERROR != ocmath_interpolate(vPeakX, vyBaseTemp, vPeakX.GetSize(), vBaselineX, vBaselineY, vBaselineX.GetSize(), INTERP_TYPE_LINEAR)) { return; } // 基線の減算 vPeakY -= vyBaseTemp;

11.5.3 ピークを検索する ocmath_find_peaks_* 関数は、複数の方法でピークを見つけるのに使われます。

次のサンプルは、nLocalPts で選択したローカルスコープの局所大点を見つける方法を示します。

nIndex で印を付けた現在のポイントに対して、スコープは [nIndex-nLocalPts, nIndex+nLocalPts]です。

// 出力ベクターとしてメモリを確保 UINT nDataSize = vxData.GetSize(); vector vxPeaks(nDataSize), vyPeaks(nDataSize); vector<int> vnIndices(nDataSize); // nDataSize は入力データ, vxData, vyData のサイズは // 出力データ, ピークの数を返す int nLocalPts = 10; int nRet = ocmath_find_peaks_by_local_maximum( &nDataSize, vxData, vyData, vxPeaks, vyPeaks, vnIndices, POSITIVE_DIRECTION | NEGATIVE_DIRECTION, nLocalPts); if(OE_NOERROR == nRet) { printf("Peak Num=%d¥n", nDataSize);



vxPeaks.SetSize(nDataSize); vyPeaks.SetSize(nDataSize); }

Origin C は、次の 2 つの関数をサポートしています。ocmath_test_peaks_by_height と ocmath_test_peaks_by_number は、それぞれ指定した高さとピークの数によりピークを確認しま

す。

次は、小ピーク高さでピークを確認する方法を示すサンプルです。

// 元の Y データから小値と大値を取得 double dMin, dMax; vyData.GetMinMax(dMin, dMax); // 高点、低点からより大きな値を取得 // そして、20%を乗算し、ピークの小高さを取得 double dTotalHeight = max(abs(dMax), abs(dMin)); double dPeakMinHeight = dTotalHeight * 20 / 100; // 指定した小高さでピークを確認 nRet = ocmath_test_peaks_by_height(&nDataSize, vxPeaks, vyPeaks, vnIndices, dPeakMinHeight); printf("Peak Num = %d¥n", nDataSize); for(int ii=0; ii<nDataSize; ii++) { printf("Peak %d:(%f,%f)¥n", ii+1, vxPeaks[ii], vyPeaks[ii]); }

11.5.4 ピークの積分とフィット

ピークの積分 ocmath_integrate 関数は、曲線以下の面積を積分するのに使われます。

次のサンプルは、1 つのピークの部分曲線の積分を実行します。

int i1 = 51, i2 = 134; // 1 つのピークの部分範囲を設定する開始と終了のインデックス IntegrationResult IntResult; // 出力, 積分結果 vector vIntegral(i2+1); // 出力, 積分データ // 積分し結果を出力 if( OE_NOERROR == ocmath_integrate(vx, vy, i1, i2, &IntResult, vIntegral, MATHEMATICAL_AREA, NULL, false, SEARCH_FROM_PEAK) ) { printf("Peak 1:Peak Index = %d, Area = %g, FWHM = %g, Center = %g, Height = %g¥n", IntResult.iPeak, IntResult.Area, IntResult.dxPeak, IntResult.xPeak, IntResult.yPeak); }

11.6 NAG 関数を使用する


ピークをフィットする Origin C の NLFitSession クラスは、異なるフィット関数でピークフィットを行うメソッドをサポートし

ています。

このクラスについての詳しい説明およびサンプルは、カーブフィットの章をご覧ください。


11.6.1 ヘッダファイル NAG 関数を呼ぶには、ヘッダーファイルまたは NAG 関数が宣言されているファイルをインクルード

する必要があります。

すべての NAG ヘッダファイルを共通で使用する 1 つのヘッダファイルを下記に示します。通常、こ

のヘッダファイルだけをコードにインクルードします。

#include <OC_nag8.h> // すべてに共通の NAG ヘッダファイル

1 つまたは数個のみの NAG 関数が使われている場合、それぞれ個々の NAG ヘッダファイルをイ

ンクルードすることもできます。例えば、NAG 関数 f02abc がコード内で使われている場合、2 つの

関連ヘッダファイルをインクルードする必要があります。

#include <NAG8¥nag.h> // NAG 構造体と型の定義 #include <NAG8¥nagf02.h> // f02 関数の宣言を含む

11.6.2 エラー構造体すべての NAG 関数は、NagError 構造体へのポインタの 1 つの引数を取ります。この構造体は、

NAG 関数の実行が成功したかどうかをテストするために使われます。

下記のサンプルは、NAG 関数 f02abc がうまく動作するかどうかを示します。

NagError err; // エラー構造体を宣言 f02abc(n, mx, n, r, v, n, &err); // NAG f02abc 関数の呼び出し if( err.code != NE_NOERROR ) // エラーが発生したら printf(err.message); // エラーメッセージを出力

呼び出すが成功したかどうかを知る必要が無ければ、エラー構造体の宣言は必要ありません。そし

て NAGERR_DEFAULT マクロが代わりに渡されます。このマクロは NULL ポインタです。NAG関数の将来のバージョンとの互換性を確実にするため、エラー構造体無しで操作できるなら、このマ

クロを使用した方がよいでしょう。

f02abc(n, mx, n, r, v, n, NAGERR_DEFAULT);



11.6.3 コールバック関数 NAG ライブラリで、ほとんどのルーチンはコールバック関数を含みます。コールバック関数を定義す

る前に、関数が呼ばれるときに NAG が期待している戻り型と引数の型を知る必要があります。

例えば、NAG 関数 d01ajc は次のようになります。ヘッダファイル nagd01.h で、初の引数が NAG_D01AJC_FUN f であることが分かります。この引数はコールバック関数です。そして、

nag_types.h で、NAG_D01AJC_FUN が NAG_D01_FUN の型であることがわかり、以下のよう

に定義されます。

typedef double (NAG_CALL * NAG_D01_FUN)(double);

そして、次のようにコールバック関数を定義できます。

double NAG_CALL myFunc(double x) { double result; // X に対して処理 return result; }

NAG 関数 d01ajc を呼び出すと、myFunc (上記で定義)が初の引数として渡されます。

c05adc を呼び出すサンプルこのサンプルは、NAG 関数 c05adc を呼び出す方法を示し、この 4 番目の引数がコールバック関

数の引数です。NAG_C05ADC_FUN 型のこのコールバック関数は、nag_types.h で定義されま

す。

typedef double (NAG_CALL * NAG_C05ADC_FUN)(double);

定義から、戻り型と引数の型が double であることが分かります。そして、次のようにコールバック関数

を定義できます。

double NAG_CALL myC05ADCfunc(double x) { return exp(-x)-x; }

以下のコードは、コールバック関数 myC05ADCfunc を渡して、関数 c05adc を呼び出す方法を示

しています。

double a = 0.0, b = 1.0, x, ftol = 0.0, xtol = 1e-05; NagError err; c05adc(a, b, &x, myC05ADCfunc, xtol, ftol, &err);



11.6.4 Origin からデータを取得する NAG 関数多くの NAG 関数は、数値データの配列へのポインタを取ります。Origin のワークシートおよび行列

シートは、そのデータのポインタを取得できます。このポインタは NAG 関数に渡すことができます。

Origin C で、データは Dataset または DataRange オブジェクトを使って渡されます。以下のセク

ションでは、Dataset および DataRange を使ってワークシートからデータを渡す方法を示していま

す。DataRange を使うことをお勧めします。

Dataset Dataset が NAG 関数で期待されているデータ型であれば、Dataset オブジェクトを NAG 関数に

渡すことができます。Origin ワークシート列のデータ型は、デフォルトで文字と数値です。すべてで

はありませんが、ほとんどの NAG 関数に対しては、NAG 関数が浮動小数点または整数型のポイン

タを期待しているので、このデータ型を渡すことができません。

Dataset が NAG 関数で期待されているデータ型であることが確実な場合、次のコードは Datasetオブジェクトを NAG 関数に渡すのに使うことができます。

// アクティブワークシートへのアクセス Worksheet wks = Project.ActiveLayer(); // データセットを構築し、wks データにアクセス Dataset dsX, dsY; dsX.Attach(wks, 0); dsY.Attach(wks, 1); // NAG の nag_1d_spline_interpolant(e01bac) 関数を呼び出し NagError err; Nag_Spline spline; e01bac(m, dsX, dsY, &spline, &err);

DataRange DataRange クラスは、仮にワークシート列が文字と数値データ型であったとしても、ワークシートから

のデータを vector に取得する GetData メソッドを提供します。GetData メソッドは、欠損値を持つ

行を簡単に無視でき、これは NAG 関数にデータを渡すときに大変重要です。

DataRange を使って、Origin から NAG 関数にデータを渡すことが安全で、お勧めです。以下の

サンプルは、それを行う方法を示しています。

void call_NAG_example() { int i, numPoints = 5; // 新しいワークシートページを作成 WorksheetPage pg;



pg.Create("origin"); // アクティブワークシートへアクセスし、2 列を追加 Worksheet wks = Project.ActiveLayer(); // X2 列を追加 i = wks.AddCol(); Column col(wks, i); col.SetType(OKDATAOBJ_DESIGNATION_X); // Y2 列を追加 wks.AddCol(); // 初の 2 列でいくつかの開始 XY 値を作成 Dataset dsX, dsY; dsX.Attach(wks, 0); dsY.Attach(wks, 1); for (i = 0; i < numPoints; i++) { int r = rnd(0) * 10; if (r < 1) r = 1; if (i > 0) r += dsX[i - 1]; dsX.Add(r); dsY.Add(rnd(0)); } // データ範囲オブジェクトを作成 DataRange dr; dr.Add(wks, 0, "X"); dr.Add(wks, 1, "Y"); // データ範囲を使って wks からデータを vector にコピー // このコピーは、欠損値を持つ行を無視 vector vX1, vY1; dr.GetData(DRR_GET_DEPENDENT, 0, NULL, NULL, &vY1, &vX1); // NAG を呼び出して係数を計算 NagError err; Nag_Spline spline; e01bac(vX1.GetSize(), vX1, vY1, &spline, &err); // スプライン XY 値を取得 vector vX2, vY2; double fit, xarg; for (i = 0; i < vX1.GetSize(); i++) { vX2.Add(vX1[i]); vY2.Add(vY1[i]); if (i < vX1.GetSize() - 1) { xarg = (vX1[i] + vX1[i + 1]) * 0.5; e02bbc(xarg, &fit, &spline, &err); vX2.Add(xarg); vY2.Add(fit); } }



// NAG で割り当てられたメモリを解放 NAG_FREE(spline.lamda); NAG_FREE(spline.c); // スプライン値をワークシートにコピー dsX.Attach(wks, 2); dsX = vX2; dsY.Attach(wks, 3); dsY = vY2; }

169

1122 出力オブジェクト

12.1 結果ログ結果ログは、出力の各ブロックごとに日時スタンプや結果に関連するウィンドウ名を自動的に出力す

るウィンドウです。ユーザインターフェースは、表示する結果を設定することができ、ウィンドウをフロ

ーティングにしたり、Origin のメインウィンドウにドッキングすることができます。

次のサンプルは、Project クラスの OutStringToResultsLog メソッドを使って Origin C から結果ロ

グに出力するも簡単なサンプルです。これは結果ログに出力するも簡単なサンプルですが、

も制限があると考えることもできます。OutStringToResultsLog メソッドへの各呼び出しは、個別の

ログを考えることができ、現在の日時と関連ウィンドウを出力します。

string str = "Column1¥tColumn2¥tColumn3¥n3.05¥t17.22¥t35.48"; Project.OutStringToResultsLog(str);

12.2 スクリプトウィンドウスクリプトウィンドウは Origin C のデフォルトの出力ウィンドウです。文字列や数値を出力するときは、

常にスクリプトウィンドウに表示されます。LabTalk の Type.Redirection プロパティを使って、出力

されるウィンドウを変更することができます。このプロパティにより、アプリケーションの出力をスクリプト

ウィンドウ、コマンドウィンドウ、結果ログ、ノートウィンドウのにリダイレクトすることができます。詳細は

LabTalk の Type.Redirection プロパティをご覧ください。

以下のサンプルは、現在の Redirection の設定を保存し、スクリプトウィンドウにリダイレクトするよう

に設定し、次にコマンドウィンドウに出力するように変更し、そして保存した設定に戻します。

string strTypeRedir = "type.redirection"; double dCurTypeRedir; LT_get_var(strTypeRedir , &dCurTypeRedir); // 現設定を取得 LT_set_var(strTypeRedir , 5); // スクリプトウィンドウは 5 out_str("Hello Script Window"); LT_set_var(strTypeRedir , 128); // コマンドウィンドウは 128 out_str("Hello Command Window"); LT_set_var(strTypeRedir , dCurTypeRedir); // 保存設定に戻す

次のサンプルは、Type.Redirection および Type.Notes$ を使って、Origin C の出力をノートウィ

ンドウにリダイレクトします。

12.3 ノートウィンドウ

170 出力オブジェクト

Note note; note.Create(); // 目的の Note ウィンドウを作成 LT_set_str("type.notes$", note.GetName()); LT_set_var("type.redirection", 2); // ノートウィンドウは 2 out_str("Hello Notes Window");

12.3 ノートウィンドウ初のサンプルは、Text プロパティを使って Note ウィンドウのテキストで操作する方法を示してい

ます。Text プロパティは、文字列に関するすべての設定を使用する string クラスです。

Note note; note.Create(); // 目的の Note ウィンドウを作成 if( note ) { note.Text = "Hello Note window."; note.Text += "¥nAnother line of text." }

次のサンプルは、Type.Redirection および Type.Notes$を使って、Origin C の出力をノートウィン

ドウにリダイレクトします。

Note note; note.Create(); // 目的の Note ウィンドウを作成 LT_set_str("type.notes$", note.GetName()); LT_set_var("type.redirection", 2); // ノートウィンドウは 2 out_str("Hello Notes Window");

12.4 レポートシート Datasheet クラスには、GetReportTree and SetReportTree メソッドがあり、ワークシートまたは行

列シートにレポートを設定したり、そこから取得できます。

if( wks.SetReportTree(tr.MyReport) < 0 ) out_str("Failed to set report sheet into worksheet."); if( wks.GetReportTree(tr.MyReport) ) out_tree(tr.MyReport); else out_str("Failed to get report tree from worksheet.");

171

1133 データベースへのアクセス

13.1 データベースからのインポート Origin C は、データベースからワークシートにデータをインポートする機能があります。以下のサン

プルは、Origin の Samples サブフォルダにある Access データベースファイルをインポートすること

で、これを行う方法を示しています。ADODB.Reocrdset オブジェクトは MSDN を参照することがで

きます。接続文字列を作成する方法については、DbEdit X ファンクションを参照してください。

Object ocora; try { ocora = CreateObject("ADODB.Recordset"); } catch(int nError) { out_str("Failed to create ADODB.Recordset"); return FALSE; } // Origin のサンプルフォルダから stars.mdb をインポート string strDatabaseFile = GetAppPath(1) + "Samples¥¥Import and Export¥¥stars.mdb"; // データベース接続文字列の準備 string strConn; strConn.Format("Provider=Microsoft.Jet.OLEDB.4.0; Data Source=%s; User ID=admin; Password=;", strDatabaseFile); // SQL 文字列を準備する string strQuery = "Select Stars.Index, Stars.Name, Stars.LightYears, Stars.Magnitude From Stars"; ocora.CursorLocation = adUseClient; try { ocora.open(strQuery, strConn, 1, 3); } catch(int nError) { out_str("Failed to open Oracle database"); return FALSE; } Worksheet wks;

13.2 データベースへのエクスポート


wks.Create(); //ワークシートにデータを配置 BOOL bRet = wks.PutRecordset(ocora); out_int("bRet = ", bRet); return bRet;

13.2 データベースへのエクスポート Origin C は、ワークシートのデータを指定したデータベースのテーブルにエクスポートする機能があ

ります。次のステップは、フィットサマリーデータをデータベースにエクスポートする方法を示していま

す。

MySQL の"Analysis"というデータベースをセットアップし、それは"Lintilla"というコンピュータ上で

動作しているものとします。

9 つのフィールドを持つ"FittingSummary"というテーブルを作成し、初の 2 つのフィールドのデ

ータタイプを varchar(40)としてセットし、残りは double 型としてセットします。

OriginExe\Samples\Curve Fitting\autofit.ogw を開き、"Data"レイヤ上の列にデータを入力

します。

再計算の後、"Summary"レイヤをアクティブにし、次のコードを実行して、結果をデータベースにエ

クスポートします。

//データベースの設定に従ってユーザは接続とクエリ文字列を修正 //Server, Database, UID, PWD などの値がデータベースの設定 #define STR_DB_CONN "Driver={MySQL ODBC 3.51 Driver}; ¥ Server=Lintilla;Port=3306;Option=4;Database=Analysis;UID=test;PWD=test;" #define STR_QUERY "Select * from FittingSummary" bool write_wks_to_db() { Worksheet wks = Project.ActiveLayer(); if ( wks ) return false; //"Lintilla"上のデータベース"Analysis"に接続 string strConn = STR_DB_CONN; string strQuery = STR_QUERY; Object oConn; oConn = CreateObject("ADODB.Connection"); if ( !oConn ) return error_report("Fail to create ADODB.Connection object!"); oConn.Open(strConn); Object oRecordset;

13.3 SQLite データベースへのアクセス

データベースへのアクセス 173

oRecordset = CreateObject("ADODB.Recordset"); if ( !oRecordset ) return error_report("Fail to create ADODB.Recordset object!"); //recordset を開く oRecordset.CursorLocation = 3; //adUseClient, 詳細は MSDN を参照 oRecordset.Open(strQuery, oConn, 1, 3); //adOpenKeyset, adLockOptimistic int iRowBegin = 0, nRows = 8; //8 行 int iColBegin = 0, nCols = 9; //9 列 //LAYWKSETRECORDSET_APPEND は新しい recordset を追加 //LAYWKSETRECORDSET_REPLACE は既存の recordsets を置き換え int nOption = LAYWKSETRECORDSET_APPEND; //追加 int nRet = wks.WriteRecordset(oRecordset, nOption, iRowBegin, nRows, iColBegin, nCols); return (0 == nRet); }

13.3 SQLite データベースへのアクセス SQLite は、内蔵型で、サーバおよび設定不要な SQL データベースエンジンを組み込んだソフトウ

ェアライブラリで、世界でも幅広く使われている SQL データベースになりました。高度な機能があ

るので、SQLite はさまざまな業務分野やシステムで広く使われています。

SQLite3 は、新のバージョンです。Origin は、Origin C から SQLite データベースにアクセスす

る DLL を提供しています。SQLite3 API のプロトタイプを含むヘッダファイルを含める必要がありま

す。:

#include <oc_Sqlite.h>

これらの関数の使い方の簡単なサンプルがヘッダファイルの後にあります。

Origin C は、また SQLite へのアクセスをより簡単にするラッパークラス OSQLite を提供していま

す。この Origin C クラスを使うには、次のように、このクラスを含むヘッダファイルが含まれている必

要があります。

//DataSet1.1.db はデータベースファイルで、これは Originlab という名前のテーブルを含む //テーブルは次のステートメントで作成 //CREATE TABLE OriginLab(ID INTEGER NOT NULL, NUMBER INTEGER NOT NULL, SALARY INTE //GER NOT NULL, Data BLOB NOT NULL); #include <..¥Originlab¥oSQLite.h> //必要なヘッダファイル #define STR_DATABASE_FILE "E:¥¥DataSet1.1.db" #define STR_QUERY_STRING "select * from Originlab limit 80" void test_OSQLite() { OSQLite sqlObj(STR_DATABASE_FILE); LPCSTR lpSQL = STR_QUERY_STRING; sqlObj.Select(lpSQL);

13.3 SQLite データベースへのアクセス


Worksheet wks; wks.Create("Origin"); sqlObj.Import(wks); //データを修正した後、次のコードを使ってデータをエクスポート //sqlObj.Export("OriginLab", wks); }

175

1144 LabTalk へのアクセス Origin C には、LabTalk の数値および文字列値を取得またはセットしたり、LabTalk スクリプトを実

行する機能があります。

14.1 LabTalk の数値を取得およびセットする Origin C のグローバル関数 LT_get_var および LT_set_var は、LabTalk の数値を取得および

セットするのに使うことができます。数値には、変数、システム変数、オブジェクトプロパティが含まれ

ます。

double dOriginVer; LT_get_var("@V", &dOriginVer); printf("Running Origin version %f¥n", dOriginVer);

これは、データ表示ウィンドウで使用する小のフォントサイズをセットする方法です。

LT_set_var("System.DataDisplay.MinFontSize", 12);

LabTalk の変数を一時的にセットし、操作を行い、LabTalk 変数を元の値に戻したい場合がありま

す。これには主に 2 つの方法があります。初の方法は、LT_get_var および LT_set_var を使っ

て行う長いコードです。

double dProgressBar; LT_get_var("@NPO", &dProgressBar); // 開始値の取得 LT_set_var("@NPO", 0); // 新しい値をセット // // 操作 // LT_set_var("@NPO", dProgressBar); // 開始値に戻す

次の方法は、LTVarTempChange クラスを使う単純な方法です。クラスを使うには、単に変数名と

一時的な値を渡すだけです。コンストラクタは開始値をデータメンバーに保存し、変数を一時的な値

にセットします。デストラクタは変数をその開始値に戻します。

{ LTVarTempChange progressBar("@NPO", 0); // // 操作 // }

14.2 LabTalk の文字列値を取得およびセットする

176 LabTalk へのアクセス

14.2 LabTalk の文字列値を取得およびセットする Origin C のグローバル関数 LT_get_str および LT_set_str は、LabTalk の文字列値を取得およ

びセットするのに使うことができます。文字列値には、変数、文字列置換変数、オブジェクトプロパテ

ィが含まれます。

char szCustomDateFmt[200]; LT_get_str("System.Date.CustomFormat1$", szCustomDateFmt, 200); printf("Custom Date Format 1:%s¥n", szCustomDateFmt);

これは、データ表示ウィンドウで使用するフォントをセットする方法です。

LT_set_str("System.DataDisplay.Font$", "Courier");

これはアクティブブックのアクティブシートの名前を変更する方法です。

LT_set_str("wks.name$", "MySheet");

14.3 LabTalk スクリプトを実行する Origin C のグローバル変数 LT_execute は、文字列に保存されている LabTalk スクリプトを実行

することができます。Format 文字列メソッドは、Origin C 変数を LabTalk スクリプトに渡すのに役

立ちます。

string strScript; string strBook = "Book1"; int iColStart = 2, iColEnd = 5; strScript.Format("win -a %s;plotxy %u:%u;", strBook, iColStart, iColEnd); LT_execute(strScript);

次のサンプルは、グローバル関数 LT_execute ではなく、Layer クラスの LT_execute メソッドを呼

びます。グローバル関数 LT_execute を呼ぶと、スクリプトが実行され、スクリプトコードでレイヤが指

定されていなければ、アクティブレイヤに対して操作されます。Layer クラスの LT_execute メソッド

を呼ぶと、スクリプトが実行され、アクティブレイヤではなく、レイヤインスタンスに対して実行されます。

WorksheetPage wksPg("Book1"); Worksheet wks = wksPg.Layers(0); WorksheetPage wksPgActive; wksPgActive.Create("Origin"); // このページがアクティブ LT_execute("wks.colWidth=16"); // アクティブレイヤの列幅をセット wks.LT_execute("wks.colWidth=8"); // Book1 の列幅をセット

14.4 Origin C コードに LabTalk スクリプトを埋め込む

LabTalk へのアクセス 177

14.4 Origin C コードに LabTalk スクリプトを埋め込む LT_execute は、文字列に含まれる LabTalk スクリプトを実行しますが、文字列に配置したくないよ

うな大きなブロックのスクリプトを実行したい場合があります。このようなときには、 _LT_Obj ブロックを

使うことができます。 _LT_Obj ブロックは、大きな LabTalk スクリプトコードブロックを Origin C コ

ードのフローに埋め込みます。

out_str("Choose an image file..."); _LT_Obj // LabTalk の FDlog を使ってファイルダイアログを表示 { FDlog.UseGroup("image"); FDlog.Open("A"); } char szFileName[MAX_PATH]; LT_get_str("%A", szFileName, MAX_PATH); printf("File Name:%s¥n", szFileName);

179

1155 ユーザインターフェースここでは、Origin C 関数がユーザからの入力を受け付ける方法を説明します。

15.1 ウエイトカーソル waitCursor クラスは、マウスポインタを砂時計または処理を表すポインタに変更します。それは、

Origin が処理に時間がかかるコードを実行していることを示すための視覚的な合図で、他の入力を

受け無いようにします。waitCursor オブジェクトのインスタンスが作成されると、マウスポインタは処

理を表すポインタに変わり、インスタンスが破棄されると、矢印のポインタに戻ります。

次のサンプルは、時間がかかる処理を行う関数です。初に、waitCursor インスタンスを宣言し、

作成します。作成されている間、マウスポインタは、処理を表すポインタに変わります。関数を終了す

ると、waitCursor のインスタンスは自動的に破棄され、マウスポインタが矢印のポインタに戻ります。

void myTimeConsumingFunction() { waitCursor wc; // declare and show the wait cursor for( int i = 0; i < 10000; i++ ) { if( 0 == (i % 100) ) printf("i == %d¥n", i); } }

次のサンプルは、上記の例に似ていますが、時間のかかる処理が完了する前に、関数を終了する機

能を追加しました。早めに終了する機能は、ウエイトカーソルの CheckEsc メソッドを呼び出すことで

実行されます。このメソッドは、ユーザが ESC キーを押すと True を返し、それ以外の場合は Falseを返します。

void myEscapableTimeConsumingFunction() { waitCursor wc; // ウエイトカーソルの宣言と表示 for( int i = 0; i < 10000; i++ ) { if( 0 == (i % 100) ) printf("i == %d¥n", i); if( wc.CheckEsc() ) break; // ループを早く抜ける } }

15.2 コモンダイアログボックス

180 ユーザインターフェース


15.2.1 入力ボックス入力ボックスはプログラムのユーザからテキスト形式の情報を求めます。入力ボックスを開くには、グ

ローバル関数 InputBox が使われます。

// 文字列の入力 string strName = InputBox("Please enter your name", ""); printf("Name is %s.¥n", strName); // 数値の入力 double dVal = InputBox(0, "Please enter a value"); printf("Value is %g.¥n", dVal);

15.2.2 メッセージボックスメッセージボックスは、情報を表示したり、ユーザに選択を促すために使われます。表示する情報は、

操作を続ける前にユーザに注意を促すための重要なものにします。

初の例は、OK ボタンだけを持つ単純なメッセージボックスで、ファイルのダウンロードが成功した

ことを通知します。

string strTitle = "File Download"; string strMsg = "Your file downloaded successfully."; MessageBox(GetWindow(), strMsg, strTitle, MB_OK);

次の例は、OK とキャンセルボタンを持つ感嘆符のアイコン付きメッセージボックスで、ユーザに操作

を元に戻すことができないという注意を促します。ユーザは操作を続行するか、キャンセルするかを

選択することができます。

string strTitle = "Delete Data"; string strMsg = "You will not be able to undo this change."; int nMB = MB_OKCANCEL|MB_ICONEXCLAMATION; if( IDOK == MessageBox(GetWindow(), strMsg, strTitle, nMB) ) out_str("Data has been deleted");

次の例は、はい－いいえのボタンを持つ疑問符のアイコン付きのメッセージボックスです。これは、ユ

ーザに操作を続行するかどうかを尋ねるのに使用しています。

string strTitle = "Close Windows"; string strMsg = "Are you sure you want to close all windows?"; int nMB = MB_YESNO|MB_ICONQUESTION; if( IDYES == MessageBox(GetWindow(), strMsg, strTitle, nMB) ) out_str("All windows have been closed.");


ユーザインターフェース 181

15.2.3 プログレスボックスプログレスボックスは、ソフトウェアがデータを処理中であることを示す小さなダイアログボックスです。

このダイアログボックスは、処理の進行状況の割合を表示するプログレスバーを含みます。プログレス

ダイアログは、通常、反復ループに使用します。

int iMax = 10, iMin = 0; progressBox prgbBox("This is a ProgressBox example:"); prgbBox.SetRange(iMin, iMax); for (int ii=iMin; ii<=iMax; ii++) { if(prgbBox.Set(ii)) printf("Hi, it is now at %d.¥n", ii); else { out_str("User abort!"); // Click Cancel button to abort break; } LT_execute("sec -p 0.5"); }

15.2.4 ファイルダイアログ Origin C は、すべてに共通のファイルダイアログの関数を提供しています。これには、1 つのファイ

ルを開く、複数ファイルを開く、ファイルを保存する、フォルダを選択するダイアログが含まれます。次

のセクションは、自分自身のアプリケーションでこれらのダイアログを使用する方法を示します。

ファイルを開くダイアログ StringArray saFiletypes(3); saFiletypes[0]="[Project (*.OPJ)] *.OPJ"; saFiletypes[1]="[Old version (*.ORG)] *.ORG"; saFiletypes[2]="[Worksheets (*.OGW)] *.OGW"; string strPath = GetOpenBox( saFiletypes, GetAppPath(false) ); out_str(strPath);

複数ファイルを開くダイアログ StringArray saFilePaths; StringArray saFileTypes(3); saFileTypes[0]="[Project (*.OPJ)] *.OPJ"; saFileTypes[1]="[Old version (*.ORG)] *.ORG"; saFileTypes[2]="[Worksheets (*.OGW)] *.OGW"; // Ctrl または Shift キーを押して複数ファイルを選択 int iNumSelFiles = GetMultiOpenBox(saFilePaths, saFileTypes, GetAppPath(false));

15.3 GetN ダイアログ


ファイルを保存ダイアログ string strDefaultFilename = "Origin"; FDLogUseGroup nFDLogUseGroup = FDLOG_ASCII; // ASCII ファイルグループ string strPath = GetSaveAsBox(nFDLogUseGroup,GetAppPath(false),strDefaultFilename); out_str( strPath );

パスブラウザダイアログ string strPath = BrowseGetPath(GetAppPath() + "OriginC¥¥", "This is an example"); out_str(strPath);

15.3 GetN ダイアログ Origin C の GetNBox 関数は、完全な機能を持つダイアログボックスを簡単に表示できます。

GetNBox 関数は、以前に GETN マクロを使って作成した Tree を使用します。Tree はノードと多く

のノードを含むブランチを含みます。各ノードはダイアログボックス内で項目を表します。項目は、チ

ェックボックス、編集ボックス、コンボボックス、その他サポートされているコントロールにすることができ

ます。次のセクションは、GetNBox 関数に渡す Tree を作成する方法を説明しています。

15.3.1 GETN マクロ GetNBox 関数は、何のダイアログを作成し、どのように表示するかについての情報を含む Tree を

必要とします。この関数は Tree を必要としていますが、GETN マクロの機能により、呼び出し元は

Tree の内容について設定不要です。Tree 全体は GETN マクロを使って作成されます。

GETN_BOX と GETN_TREE マクロ初のマクロは、作成する Tree が GETN_BOX または GETN_TREE マクロのいずれかの場合

に使用します。GETN_BOX マクロは、基本 GetNBox ツリーを構築し、ダイアログボックスにシンプ

ルダイアログの外観を指定します。GETN_TREE マクロは、基本 GetNBox ツリーを構築し、ダイア

ログボックスにツリーの外観を指定します。両方のマクロは、マクロに渡す名前を持つ新しいツリーイ

ンスタンスを宣言します。宣言後、要求されたスタイルに対するツリーの基本をセットアップします。

GETN_BOX(trMyDlg) GETN_TREE(trMyDlg)



データ項目マクロ宣言し、GETN_BOX または GETN_TREE マクロを使ってツリーをセットアップした後、データ項目

ノードを追加します。文字列または数値編集ボックス、チェックボックス、ドロップダウンリスト、ボタンコ

ントロール、スライダなどに対するマクロがあります。

#include <GetNbox.h> void GETN_ex1() { GETN_TREE(testTree) GETN_STR(name, "Name", "Jacky") // 文字列編集ボックス GETN_NUM(age, "Age", 31) // 数値編集ボックス GETN_LIST(gender, "Gender", 0, "Male|Female") // ドロップダウンリスト GETN_BUTTON(path, "File Path", GetAppPath()) // ボタンコントロール GETN_OPTION_EVENT(button_event) // ボタンコントロールのイベント関数 if(GetNBox(testTree, NULL, NULL, NULL, NULL)) out_tree(testTree); } // ボタンコントロールのイベント関数を定義 bool button_event(TreeNode& myTree, int nRow, int nType, Dialog& theDlg) { if(TRGP_STR_BUTTON == nType && nRow >= 0) { string strPath = BrowseGetPath(myTree.path.strVal); myTree.path.strVal = strPath; return true; } else return false; }

Branch マクロ GetNBox には多くの項目を含めることができます。項目を管理する助けとして、

GETN_BEGIN_BRANCH マクロと GETN_END_BRANCH マクロがあります。

GETN_BEGIN_BRANCH マクロは、子ノードを含む新しいブランチを開始します。

GETN_BEGIN_BRANCH マクロに続くすべてのデータ項目マクロは、そのブランチの子供となり

ます。ブランチは GETN_END_BRANCH マクロが呼ばれると終了します。

#include <GetNbox.h> void GETN_ex2() { GETN_TREE(testTree) GETN_BEGIN_BRANCH(Personal, "Personal Info") GETN_STR(name, "Name", "") // 文字列編集ボックス GETN_NUM(age, "Age", 31) // 数値編集ボックス GETN_LIST(gender, "Gender", 0, "Male|Female") // ドロップダウンリスト GETN_END_BRANCH(Personal)



if(GetNBox(testTree, NULL, NULL, NULL, NULL)) out_tree(testTree); }

オプションコントロール GetN コントロールをフォーマットをセットする GetN マクロがあります。例えば、

GETN_OPTION_BRANCH は、ブランチのデフォルトが開いているか閉じているかを制御します。

GETN_BEGIN_BRANCH(Personal, "Personal Info") GETN_OPTION_BRANCH(GETNBRANCH_OPEN) // ブランチを開く //... GETN_END_BRANCH(Personal)

適用ボタンデフォルトの GetN ダイアログには OK とキャンセルボタンがあります。適用ボタンは任意です。適用

ボタンが表示されているとき、ユーザがこのボタンをクリックし、何かを実行する関連のイベント関数を

呼び出したいかもしれません。

以下は、GetN ダイアログに適用ボタンを表示する方法を示し、適用ボタンをクリックすると、イベント

関数 _apply_event が呼ばれます。

#include <GetNbox.h> // 適用ボタンのイベント関数のインターフェースは // PAPPLY_FUNC typedef に従う bool _apply_event(TreeNode& tr) { int nIndex = tr.LineColor.nVal; UINT cr = color_index_to_rgb(nIndex); printf("Red = %d, Green = %d, Blue = %d¥n", GetRValue(cr), GetGValue(cr), GetBValue(cr)); return true; } void GETN_Apply_ex1() { GETN_TREE(tr) GETN_COLOR(LineColor, "Color", 3) // カスタムパネルを含むカラーリストをセットするオプション GETN_COLOR_CHOICE_OPTIONS(COLORLIST_CUSTOM | COLORLIST_SINGLE) bool bShowApplyButton = true; if(GetNBox(tr, NULL, "Example", NULL, GetWindow(), bShowApplyButton, _apply_event)) { out_str("Click OK"); } }

15.4 グラフからデータポイントを取得


15.3.2 イベントハンドリング上記で、適用ボタンのイベント関数を説明しましたが、GetN ダイアログには、ダイアログの初期化や

コントロール値の変更などの他のイベントに反応するメカニズムをサポートしています。

次は、これらのイベントにアクセスする方法を示しています。

#include <GetNbox.h> int _normal_event(TreeNode& tr, int nRow, int nEvent, DWORD& dwEnables, LPCSTR lpcszNodeName, WndContainer& getNContainer, string& strAux, string& strErrMsg) { if( 0 == lstrcmp(lpcszNodeName, "list") || GETNE_ON_INIT == nEvent ) { tr.name.Enable = (1 == tr.list.nVal); tr.id.Show = (2 == tr.list.nVal); } return 0; } void GETN_Event_Ex() { GETN_TREE(tr) GETN_LIST(list, "Options", 0, "None|Name|ID") GETN_STR(name, "Name", "") GETN_STR(id, "ID", "") if(GetNBox(tr, _normal_event, "Example", NULL, GetWindow())) { out_str("Click OK"); } }

15.4 グラフからデータポイントを取得 Origin C の GetGraphPoints クラスは、グラフウィンドウの曲線からデータポイントを取得するのに

使用されます。これは、仮想的なメソッドを持ち、メソッドをオーバーロードするためにそれから派生さ

れます。

以下のサンプルは、グラフから 2 つのデータポイントを取得するし、GetGraphPoints クラスを使用

する方法を示します。

GetGraphPoints mypts; // true にセットすると、カーソルがデータプロットに沿って移動し、 // 曲線からデータポイントを取得 // false にセットすると、カーソルはデータプロットに沿って移動しません // 画面上からデータポイントを取得 mypts.SetFollowData(true, dp.GetIndex());

15.5 グラフにコントロールを追加する


// GraphLayer オブジェクト(gl)で指定した Graph からデータポイントを取得 int nPts = 2; // 取得するポイント数 mypts.GetPoints(nPts, gl); // 取得したデータから x/y データとそのインデックスを取得 vector vx, vy; vector<int> vnPtsIndices, vnPlotIndices; if( mypts.GetData(vx, vy, vnPtsIndices, vnPlotIndices) == nPts ) { for(int ii = 0; ii < vx.GetSize(); ii++) { printf("point %d: index = %d, x = %g, y = %g, on plot %d¥n", ii+1, vnPtsIndices[ii], vx[ii], vy[ii], vnPlotIndices[ii]+1); } }

15.5 グラフにコントロールを追加するワークブックのオーガナイザや極座標グラフの上部にあるようにダイアログをページに接続する場合、

PageBase クラスの SetSplitters メソッドを使って行うことができます。

ダイアログバーをページに追加するには、lpcszString は、ダイアログクラスの名前とページウィンド

ウの位置(上下左右)を含む必要があります。lpcszString を NULL にセットすると、既存のダイアロ

グバーを削除します。

次のサンプルは、グラフウィンドウにユーザ定義のダイアログを追加および削除する方法を示してい

ます。

ユーザ定義ダイアログのクラス #include <..¥Originlab¥DialogEx.h> // OC_REGISTERED キーワードはこのクラスを見つけるために PageBase::SetSplitters メソッド //を許可する必要がある class OC_REGISTERED MyGraphPolarBar :public Dialog { public: // IDD_POLAR_CONTROL はダイアログのリソース ID // Odlg8 はリソース DLL ファイルの名前で、パスが見つからない場合 //デフォルトのパスは¥OriginC¥Originlab MyGraphPolarBar() :Dialog(IDD_POLAR_CONTROL, "Odlg8") { } BOOL CreateWindow(int nID, HWND hWnd) { int nRet = Dialog::Create(hWnd, DLG_AS_CHILD);

15.5 グラフにコントロールを追加する


HWND hWndThis = GetSafeHwnd(); SetWindowLong(hWndThis, GWL_ID, nID); return nRet; } };

グラフウィンドウのダイアログを追加または削除 void Page_SplittersControl(BOOL bShow = TRUE, int nPos = 2) { Page pg = Project.Pages("Graph1"); if( bShow ) { int nPercent = 30; string strDlgClass = "MyGraphPolarBar"; // 上記ダイアログクラス string strConfig; switch(nPos) { case 0:// 下 strConfig.Format("r{%s}r[%s]", (string)nPercent+"%", strDlgClass); break; case 1:// 右 strConfig.Format("c{%s}c[%s]", (string)nPercent+"%", strDlgClass); break; case 2:// 上 strConfig.Format("r[%s]{%d}r", strDlgClass, nPercent); break; case 3:// 左 strConfig.Format("c[%s]{%d}c", strDlgClass, nPercent); break; } pg.SetSplitters(strConfig); } else pg.SetSplitters(NULL); // ページからダイアログバーを削除 }

189

1166 ダイアログビルダダイアログビルダは、開発者が Microsoft Visual C++ のリソースを使って、Origin 内で使用するフ

ローティングツール、ダイアログボックス、ウィザードを作成するものです。ボタン、チェックボックス、ラ

ジオボタン、スライダ、編集ボックス、コンボボックス、リストボックス、リッチテキストボックス、ワークシー

ト、グラフコントロールなど、すべての要素は、Origin C プログラミング言語を使ってプログラムでアク

セスしたり、制御することができます。リソースの操作は、Origin C で完全にプログラミングできます。

このマニュアルには、Microsoft Visual C++, Origin, Origin C プログラム言語を使って、「Hello World」を含むリソースのみの DLL を構築し、起動するチュートリアルがあります。Microsoft Visual C++を使ってリソースのみの DLL を作成する方法および Origin C を使って Origin でリソ

ースをアクセスする方法についての詳しい説明が追加のセクションにあります。数多くのダイアログビ

ルダのサンプルが OriginPro と一緒に配布されています。このマニュアルに記載のすべてのサンプ

ルは、OriginPro の¥Samples¥DeveloperKit¥Dialog Builder サブフォルダにあります。

デベロッパーキットライセンス

ダイアログビルダを使うには、Origin と一緒にインストールされるデベロッパーキットが必要です。デ

ベロッパーキットは、メンテナンスを契約しているユーザが利用できます。

Note:デベロッパーキットは Origin の一部としてインストールされており、アクティブにするためのライ

センスを取得する必要はありません。デベロッパーキットの有効なライセンスを取得した後、アクティ

ブにするため次のステップを行ってください。

Origin のメニューヘルプ | モジュールライセンスの更新を選択ポップアップウィンドウにライセンスを入力(コピー＆ペーストが可能)。 OK ボタンをクリックします。Origin の再起動が必要だというメッセージが表示 Origin を再起動

デベロッパーキットサンプル

デベロッパーキットサンプルファイルが Origin パッケージファイル (.OPX)として利用できます。サン

プルファイルのインストールについては、以下の操作を行ってください。

ファイルをダウンロードするhttp://www.originlab.com/ftp/Documentation/DeveloperKit/DevKitSamples.opx

16.1 単純な Hello World ダイアログ

190 ダイアログビルダ

Origin を開き、opx ファイルを Origin ウィンドウにドラッグします。OPX がインストールされると、この

マニュアルで説明しているサンプルが ¥Samples¥DeveloperKit サブフォルダにコピーされます。


16.1.1 VC でリソース DLL を作成する

Origin Dialog AppWizard で作成する Visual C++ 6.0 を開始し、ファイル->新規を選択し、新しいダイアログを開きます。プロジェクトタブ

で、Origin Dialog AppWizard を選択し、プロジェクト名を"ODialog"にセットし、場所を選択して、

OK をクリックします。

シンプルダイアログを選び、次へをクリックします。

Origin C を選択したまま、完了をクリックし、OK をクリックします。1 つのシンプルダイアログを持つリ

ソースファイルとそれに関連したソースファイルおよびヘッダファイルが生成されます。

ビルド->アクティブな構成の設定メニューを選択し、デバックまたはリリースを選びます。

ビルド->ODialog.dll のビルドを選択し、DLL を作成します。

上記で指定したファイルの場所に移動します。DLL ファイルを Debug または Release フォルダの

外側にコピーし、DLL ファイルのパスを ODialog.cpp ファイルのパスと同じにします。

Origin C のコードビルダで ODialog.cpp ファイルを開き、コンパイルし、DoMyDialog 関数を実行

して、ダイアログを開きます。

Win32 ダイナミックリンクライブラリで作成するこのセクションは、Visual C++ 6.0 でリソースのみの DLL を作成する方法について説明しています。

Visual C++ 6.0 を開始し、ファイル->新規を選択し、新しいダイアログを開きます。プロジェクトタブ

で、プロジェクトテンプレートとして Win32 ダイナミックリンクライブラリを選択し、プロジェクト名を

ODialog にセットし、場所を選択して、OK をクリックします。現れたダイアログで、シンプル DLL プ

ロジェクトを選び、完了をクリックします。

プロジェクト->設定を選び、プロジェクト設定ダイアログを開きます。リソースタブで、ODialog.res の

ようなリソースファイル名をセットし、ソフトウェア設定に従って言語を選択し、OK をクリックします。


ダイアログビルダ 191

挿入->リソースを選び、プロジェクトにリソースを挿入します。ダイアログとそのコントロールに対して、

ダイアログ ID を IDD_OC_DIALOG にセットします。

ファイル->名前を付けて保存を選び、リソーススクリプトを ODialog.rc として保存します。プロジェクト

->プロジェクトに追加->ファイルを選び、ODialog.rc ファイルを選び、プロジェクトに追加します。

言語が英語でなければ、このステップを行ってください。ワークスペースビューのリソースタブで、リス

トツリーを開き、IDD_OC_DIALOG を右クリックし、プロパティを選び、ダイアログで言語をニュート

ラルを選びます。

デバッグまたはリリースの構成で、プロジェクト全体をビルドします。結果の DLL ファイルが、Debugまたは Release サブフォルダに生成されます。

Visual Studio 2008 でリソースのみの DLL を作成する Visual Studio 2008 でリソースのみの DLL を作成する一般的な処理について説明しています。以

下のステップは、VS2008 で Origin C を使って Origin にアクセスするリソースのみの DLL を作成

する方法を示しています。

Microsoft Visual Studio 2008 を起動します。

ファイル->新規->プロジェクトを選択し、新しいプロジェクトを作成します。

新規ダイアログで、プログラム言語として Visual C++を選び、テンプレートとして Win32 プロジェク

トを選び、プロジェクト名には"Welcome"とし、その場所を下記のように選択して、OK をクリックしま

す。



Win32 アプリケーションウィザードダイアログで、アプリケーションの種類を DLL にして、完了ボタン

をクリックします。

プロジェクトのリソースビューに切り替え、プロジェクト名を右クリックして、リソースを追加し、リソースタ

イプを選択して、新規をクリックします。



インストールしようとしているソフトウェア環境に従って、リソースの言語プロパティをセットすることを忘

れないようにしてください。日本語のソフトウェアであれば日本語(日本) です。

希望のコントロールを追加し、プロジェクトの構成を Debug または Release にし、プロジェクトを保存

します。そして、ビルド>ソリューションのビルドまたはソリューションのリビルドを選び、プロジェクトをビ

ルドします。ソリューションフォルダに DLL を含む"Debug"または"Release"というフォルダが生成さ

れます。このソリューションで生成したファイルは、次のものです。

16.2 ウィザードダイアログ


16.1.2 Origin C でリソース DLL を使用するこのセクションでは、上記で作成したリソースのみの DLL を使用する方法を説明しています。

DLL ファイルを Debug または Release フォルダの外側にコピーし、DLL ファイルのパスを

resource.h ファイルのパスと同じにします。

Origin を起動し、コードビルダを開きます。

DLL ファイルのパスに testODialog.c という新しい Origin C ファイルが作成されます。現在のワー

クスペースに追加し、次のようにテスト用のコードを記述します。OpenDlg 関数を実行し、ダイアログ

ボックスを開きます。

#include <Dialog.h>

#include <..¥Originlab¥Resource.h> //ODialog リソースヘッダ

class MyDialog :public Dialog

{

public:

// ダイアログ ID と DLL 名を持つダイアログを作成

// "ODialog"は DLL ファイル名

// パスを指定しなければ、DLL ファイルがこの Origin C ファイルと

// 同じパスにあるということ

// DLL が別の場所にある場合、DLL の

// フルパスを使用

MyDialog() :Dialog(IDD_OC_DIALOG, "ODialog")

{

}

};

void OpenDlg()

{

MyDialog odlg;

odlg.DoModal();

}

16.2 ウィザードダイアログこのセクションは、Origin C でウィザードダイアログを開く方法を説明しています。このセクションのサ

ンプルは、Origin C のデベロッパーキットと一緒にインストールされる既存のウィザードダイアログの

16.2 ウィザードダイアログ


リソース DLL を使用します。DLL は Samples¥DeveloperKit¥Dialog Builder¥Wizard サブフ

ォルダにあります。

ウィザードダイアログを開くには、初にいくつかユーザ定義のクラスを定義します。Dialog クラスか

ら派生するクラス、WizardSheet クラスから派生する別のクラス、PropertyPage クラスから派生する

各ページのクラスが必要になります。

WizardSheet::AddPathControl メソッドは、ウィザードのステップまたはページを移動する助けとな

るウィザードマップを提供するのに使用します。マップをクリックして、ウィザード内のどのページにで

もジャンプすることもできます。

定義した初のクラスは、PropertyPage クラスから派生されています。この初のクラスはウィザー

ド内のすべてのページで共有されるすべての情報を含みます。

class WizPage :public PropertyPage { protected: WizardSheet* m_Sheet; };

PropertyPage に基づくクラスを定義したので、ウィザードの各ページを取り扱うクラスを定義できま

す。これら次のクラスは上記で定義したページクラスから派生するものです。

class WizPage1 :public WizPage { }; class WizPage2 :public WizPage { }; class WizPage3 :public WizPage { };

定義される次のクラスは、プレースホルダクラスです。このクラスは、WizardSheet クラスから派生さ

れ、順に PropertySheet クラスから派生されます。このクラスは、データメンバーとしてすべてのペ

ージのインスタンスを保持します。

class WizSheet :public Dialog { public: // PropertySheet のデータメンバーは WizPage オブジェクト WizPage1 m_WizPage1; WizPage2 m_WizPage2; WizPage3 m_WizPage3; };

すべてのページとシートのクラスの定義が完了して、ダイアログクラスを定義できます。

class WizPageDialog :public Dialog { public:

16.3 グラフプレビューダイアログ


// メインダイアログのコンストラクタ WizPageDialog(int ID) :Dialog(ID, "Wizard.DLL") { } // メインダイアログのデータメンバーは PropertySheet (プレースホルダ) WizSheet m_Sheet; };

16.3 グラフプレビューダイアログこのセクションは、グラフプレビューを持つカスタムダイアログを作成する方法を示します。

16.3.1 ダイアログリソースを準備する初に、プレビューグラフをネストするスタティックなコントロールを含むダイアログリソースが必要で

す。ここでは、OriginC¥Originlab¥ODlg8.dll にある組み込みのリソース

IDD_SAMPLE_SPLITTER_DLG を使います。

16.3.2 ソースファイルを準備する

コードビルダで、新規ボタンをクリックし、ファイル名を入力し、場所には、上記のダイアログリソー

ス oDlg8.dll－Origin インストールフォルダの OriginC¥Originlab サブフォルダ－と同じパスを指

定します。

16.3.3 必要なヘッダをインクルードする //これらのヘッダは、ダイアログとコントロールの宣言を含む #include <..¥Originlab¥DialogEx.h> #include <..¥Originlab¥GraphPageControl.h>

16.3.4 ユーザ定義プレビュークラスを追加する //プレビューグラフのいくつかの操作を禁止 #define PREVIEW_NOCLICK_BITS (NOCLICK_DATA_PLOT|NOCLICK_LAYER|NOCLICK_LAYERICON) #define PREVIEW_TEMPLATE "Origin" //プレビューテンプレート class MyPreviewCtrl {



public: MyPreviewCtrl(){} ~MyPreviewCtrl() { //ダイアログが閉じたとき一時的なブックを破棄 if ( m_wksPreview.IsValid() ) m_wksPreview.Destroy(); } void Init(int nCtrlID, WndContainer& wndParent) { //プレビューグラフコントロールを作成 Control ctrl = wndParent.GetDlgItem(nCtrlID); GraphControl gCtrl; gCtrl.CreateControl(ctrl.GetSafeHwnd()); gCtrl.Visible = true; GraphPageControl gpCtrl; gpCtrl.Create(gCtrl, PREVIEW_NOCLICK_BITS, PREVIEW_TEMPLATE); GraphPage gpPreview; gpPreview = gpCtrl.GetPage(); gpPreview.Rename("MyPreview"); m_glPreview = gpPreview.Layers(0); //first layer if ( !m_wksPreview ) { //プレビューデータを保持する一時ワークシート m_wksPreview.Create("Origin", CREATE_TEMP); m_wksPreview.SetSize(-1, 2); //two columns //ロングネームをタイトルとして表示 Column colX(m_wksPreview, 0); colX.SetLongName("Preview X"); Column colY(m_wksPreview, 1); colY.SetLongName("Preview Y"); //データ範囲の準備 DataRange drPrev; drPrev.Add(m_wksPreview, 0, "X"); drPrev.Add(m_wksPreview, 1, "Y"); //データポイントは存在しないがプレビュー曲線をプロット int nPlot = m_glPreview.AddPlot(drPrev, IDM_PLOT_LINE); DataPlot dp = m_glPreview.DataPlots(nPlot); if ( dp ) //set preview curve color dp.SetColor(SYSCOLOR_RED); } } //外部データでプレビュー曲線を更新 void Update(const vector& vX, const vector& vY) { if ( m_wksPreview.IsValid() ) { Dataset dsX(m_wksPreview, 0); Dataset dsY(m_wksPreview, 1);



if ( !dsX.IsValid() || !dsY.IsValid() ) return; //プレビューの列なし //ソースデータを更新すると、プレビューグラフも更新 dsX = vX; dsY = vY; //再スケールして表示を整える m_glPreview.Rescale(); } } private: //ダイアログのグラフをプレビュー GraphLayer m_glPreview; //プレビューデータを配置する一時ワークシート Worksheet m_wksPreview; };

16.3.5 ダイアログクラスを追加する class MyGraphPreviewDlg :public Dialog { public: //ダイアログリソース ID とそれを含む DLL MyGraphPreviewDlg() :MultiPaneDlg(IDD_SAMPLE_SPLITTER_DLG, GetAppPath(TRUE) + "OriginC¥¥Originlab¥¥ODlg8") { } ~MyGraphPreviewDlg() { } int DoModalEx(HWND hParent = NULL) { InitMsgMap(); //ユーザが閉じるまでダイアログを表示 return DoModal(hParent, DLG_NO_DEFAULT_REPOSITION); } //ダイアログイベントのメッセージハンドラ BOOL OnInitDialog(); BOOL OnDraw(Control ctrl); protected: DECLARE_MESSAGE_MAP private: //プレビューコントロールを表すメンバー MyPreviewCtrl m_Preview; };

16.4 スプリッターダイアログ


16.3.6 ダイアログを開く void open_preview_dlg() { MyGraphPreviewDlg dlg; dlg.DoModalEx(GetWindow()); return; }

上記の関数を実行し、Draw ボタンをクリックします。プレビューが更新されたことが分かります。

16.4 スプリッターダイアログこのサンプルは、ツリービューまたはグリッドビューを提供するスプリッタダイアログを作成する方法を

示します。

16.4.1 ダイアログリソースを準備するこのダイアログを作成するには、初にラベルと 2 つのボタンコントロールを持つダイアログリソース

を準備する必要があります。ここで、このサンプルを簡単にするため組込の

OriginC¥Originlab¥ODlg8.dll ファイルにある既存のリソース

IDD_SAMPLE_SPLITTER_DLG を使います。



16.4.2 ソースファイルを準備する

コードビルダで、新規ボタンをクリックし、ファイル名を入力し、場所には、上記のダイアログリソー

ス oDlg8.dll－Origin インストールフォルダの OriginC¥Originlab サブフォルダ－と同じパスを指

定します。

16.4.3 ヘッダファイルをインクルードする次のヘッダファイルがサンプルで使われます。上記で作成したソースファイルに次をコピーします。

#include <..¥Originlab¥DialogEx.h> #include <..¥Originlab¥SplitterControl.h> #include <..¥Originlab¥DynaSplitter.h>

16.4.4 ユーザ定義 Splitter クラスを追加する TreeDynaSplitter からクラスを派生することができます。ほとんどのダイアログの初期化と他のイベ

ント関数のコードは、基底クラスにあり、splitter クラスを軽くします。

class MySplitter :public TreeDynaSplitter { public: MySplitter(){} ~MySplitter(){} //splitter コントロールを初期化 int Init(int nCtrlID, WndContainer& wndParent, LPCSTR lpcszDlgName = NULL) { TreeDynaSplitter::Init(nCtrlID, wndParent, 0, lpcszDlgName); return 0; } //現在の設定を出力 void Output() { out_tree(m_trSettings); } protected: // メッセージマップテーブルとメッセージハンドラを宣言 DECLARE_MESSAGE_MAP BOOL OnInitSplitter(); BOOL InitSettings(); void OnRowChange(Control ctrl); private: BOOL constructSettings(); BOOL initSystemInfo(TreeNode& trSys);//システム情報を表示 BOOL initUserInfo(TreeNode& trUser);//ユーザ設定を収集



private: GridTreeControl m_List; //左パネルのグリッド表示 Tree m_trSettings;//右パネルのグリッド表示 bool m_bIsInit;//初期化イベントからかどうかを指示 }; //コントロールメッセージとイベントをマッピング BEGIN_MESSAGE_MAP_DERIV(MySplitter, TreeDynaSplitter) ON_INIT(OnInitSplitter) //初期化 splitter 設定 //破棄時に splitter のサイズと位置を保存 //これは基底クラスで行われる ON_DESTROY(OnDestroy) ON_SIZE(OnCtrlResize) //コントロールが準備できたら、splitter と位置をリサイズ ON_USER_MSG(WM_USER_RESIZE_CONTROLS, OnInitPaneSizs) //ユーザは左パネルの異なる行を選択 ON_GRID_ROW_COL_CHANGE(GetMainPaneID(), OnRowChange) END_MESSAGE_MAP_DERIV BOOL MySplitter::OnInitSplitter() { TreeDynaSplitter::OnInitSplitter(&m_List); constructSettings(); //ツリー設定を構築 InitSettings(); //ツリー設定を splitter GUI に SetReady(); return TRUE; } //ユーザが異なる行を選択するとき、右パネルを更新 void MySplitter::OnRowChange(Control ctrl) { if ( !m_bReady ) return; //現在のブランチのサブノードを表示 TreeNode trCurrent = ShowListContent(-1, true, m_bIsInit); if ( trCurrent ) { //レジストリから設定をロード string strTag = trCurrent.tagName; LoadBranchSetting(GetDlgName(), strTag); } m_bIsInit = false; return; } //splitter 設定を初期化 BOOL MySplitter::InitSettings() { m_bIsInit = true; ///GUI の問題を避けるため、準備状態がセットしない m_bReady = false;



//表示のための splitter tree をセット ShowList(m_trSettings, ATRN_STOP_LEVEL); m_bReady = true; //準備状態をリセット SelectRow(0); // 初の行を選択 return TRUE; } BOOL MySplitter::constructSettings() { TreeNode trSys = m_trSettings.AddNode("System"); trSys.SetAttribute(STR_LABEL_ATTRIB, "System Information"); initSystemInfo(trSys); TreeNode trUser = m_trSettings.AddNode("User"); trUser.SetAttribute(STR_LABEL_ATTRIB, "User Settings"); initUserInfo(trUser); return TRUE; } //Origin の基本情報を表示 //ここで OS 関連の情報を表示 BOOL MySplitter::initSystemInfo(TreeNode& trSys) { if ( !trSys ) return FALSE; char szUser[LIC_USERINFO_NAME_COMPANY_MAXLEN]; char szCompany[LIC_USERINFO_NAME_COMPANY_MAXLEN]; char szSerial[LIC_OTHER_INFO_MAXLEN]; char szRegCode[LIC_OTHER_INFO_MAXLEN]; DWORD dwProd = GetLicenseInfo(szUser, szCompany, szSerial, szRegCode); string strProduct; switch( dwProd & 0x000000FF ) { case ORGPRODUCTTYPE_EVALUATION: strProduct = "Evaluation"; break; case ORGPRODUCTTYPE_STUDENT: strProduct = "Student"; break; case ORGPRODUCTTYPE_REGULAR: strProduct = "Regular"; break; case ORGPRODUCTTYPE_PRO: strProduct = "Professional"; break; default: strProduct = "Unknown"; break; } GETN_USE(trSys) GETN_STR(UserName, "User Name", szUser) GETN_READ_ONLY_EX(2) GETN_STR(Company, "Company Name", szCompany) GETN_READ_ONLY_EX(2)



GETN_STR(SeriNum, "Serial Number", szSerial) GETN_READ_ONLY_EX(2) GETN_STR(RegCode, "Register Code", szRegCode) GETN_READ_ONLY_EX(2) GETN_STR(Product, "Product Version", strProduct) GETN_READ_ONLY_EX(2) return TRUE; } //ユーザ情報と設定を収集するコントロール BOOL MySplitter::initUserInfo(TreeNode& trUser) { if ( !trUser ) return FALSE; GETN_USE(trUser) GETN_STRLIST(Language, "Language", "English", "|English|German") GETN_STR(UserID, "User ID", "") GETN_PASSWORD(Password, "Password", "") GETN_STR(Email, "Email", "[email protected]") return TRUE; }

16.4.5 ユーザ定義 Splitter ダイアログクラスを追加する splitter ダイアログは、splitter コントロールオブジェクトを含み、ダイアログは splitter コントロール

を初期化し、適切なイベントにメッセージを渡します。

//ダイアログ名は、レジストリに設定を保存するのに使用 #define STR_DLG_NAME "My Splitter Dialog" class MySplitterDlg :public MultiPaneDlg { public: //リソース ID とその DLL はダイアログリソースを含む MySplitterDlg() :MultiPaneDlg(IDD_SAMPLE_SPLITTER_DLG, "ODlg8") { } ~MySplitterDlg() { } //ユーザが閉じるまでダイアログを開く int DoModalEx(HWND hParent = NULL) { //メッセージマップをセット InitMsgMap(); return DoModal(hParent, DLG_NO_DEFAULT_REPOSITION); } //ダイアログを開く前にコントロールと他の設定を初期化 BOOL OnInitDialog(); //ダイアログ初期化が完了したとき BOOL OnReady();



//ユーザが'Output'ボタンをクリックしたとき BOOL OnOutput(Control ctrl); protected: DECLARE_MESSAGE_MAP private: MySplitter m_Splitter; }; //マップダイアログメッセージ BEGIN_MESSAGE_MAP(MySplitterDlg) ON_INIT(OnInitDialog) ON_READY(OnReady) ON_BN_CLICKED(IDC_LOAD, OnOutput) END_MESSAGE_MAP BOOL MySplitterDlg::OnInitDialog() { //ボタンのタイトルを意味のあるテキストに変更 GetDlgItem(IDC_LOAD).Text = "Output"; GetDlgItem(IDCANCEL).Text = "Close"; m_Splitter.Init(IDC_FB_BOX, *this, STR_DLG_NAME); return TRUE; } BOOL MySplitterDlg::OnReady() { //ダイアログを更新 UpdateDlgShow(); SetInitReady(); //準備状態を位置とサイズを初期化にセット m_Splitter.OnReady(); return TRUE; } BOOL MySplitterDlg::OnOutput(Control ctrl) { //現在のユーザ設定をダンプ m_Splitter.Output(); return TRUE; }

16.4.6 ダイアログを開く上記のステップの後、すべてのコードを保存し、ビルドし、次の関数を実行して、スプリッターダイアロ

グを実行します。

void test_MySplitterDlg() { MySplitterDlg dlg; dlg.DoModalEx(GetWindow()); }

207

1177 X ファンクション X ファンクションのテクノロジーは、Origin ツールを構築するフレームワークを提供します。実際、

Origin のほとんどのデータ分析やデータ処理の機能は、この新しい技術を使って、再作成されたり、

機能拡張されてています。

17.1 X ファンクションを作成する 2 つのステップで X ファンクションを作成します。：初に、X ファンクションとそのパラメータを X ファ

ンクションビルダで定義します。次に X ファンクションの Origin C コードを書き、コードビルダでコン

パイルします。

17.1.1 単純な X ファンクションの作成 X ファンクションは、X ファンクションビルダで作成します。ツールメニューの X ファンクションビルダを

選ぶか、F10 を押し、X ファンクションビルダを開くことができます。

X ファンクションビルダダイアログは下図のようなものです。

17.1 X ファンクションを作成する

208 X ファンクション

X ファンクションを作成する下記のステップは、ある列から別の列にデータをコピーする X ファンクションを作成する手順です。

F10 を押し、X ファンクションビルダを開き X ファンクションを作成し始めます。

X ファンクションに"CopyCol"と名前を付け、変数リストを右クリックして、変数の追加を選び、2 番目

の変数を追加します。下のダイアログの設定に合うように変数名、ラベル、別の値を変更します。

必要な変更を変数にしたあと、OXF ファイルを保存するボタンをクリックして X ファンクションを

保存します。名前を付けて保存ダイアログが現れたら、保存ボタンをクリックします。

X ファンクションツリービューボタンをクリックしツリービューを切り替えます。Labtalk チェックボ

ックスにチェックが付いていて、自動 GetN ダイアログが下図のように単純な GetNBox にセットされ

ていることを確認します。Labtalk チェックボックスを選択し、X ファンクションがコマンドウィンドウで

使用できるようにします。自動 GetN ダイアログは、複数の異なる種類として、ダイアログ無しまたは

ダイアログ有りで X ファンクションを使うように選択できます。


X ファンクション 209

X ファンクションを操作する Origin C コードを記述する必要があります。「コードビルダ」ボタンをクリックします。これは、Origin C コードを記述するコードビルダ内で X ファンクションを開きます。

メイン関数で、次の Origin C コードを追加します。

ocol = icol;

コンパイルボタンをクリックし、ダイアログに戻るボタンをクリックして X ファンクションビルダに戻ります。

「OXF ファイルを保存する」ボタンをクリックします。

X ファンクションを使う X ファンクションが問題なく作成できましたので、テストすることができます。

2 つの列を持つ新しいワークシートを作成します。列 A に行番号を入力し、列のヘッダをクリックして

列全体を選択します。

スクリプトまたはコマンドウィンドウで、「CopyCol -d」と入力し、Enter キーを押します。

ダイアログが開き、デフォルト値のまま OK ボタンをクリックします。

X ファンクションが実行した後、ワークシートに列 A のデータをコピーした 3 番目の列が含まれます。



17.1.2 X ファンクションビルダツールメニューの X ファンクションビルダを選ぶか、F10 を押し、X ファンクションビルダを開きます。

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

X ファンクションの名前に既存の LabTalk マクロ、OGS ファイル、LabTalk コマ

ンド、Origin C 関数を呼ぶことができる LabTalk の名前は付けないでください。

これらの 2 つ以上が同じ名前の場合、呼びだされる順番は LabTalk マクロ > LabTalk OGS > X ファンクション > Origin C を呼ぶことができる LabTalk > LabTalk コマンド

X ファンクションの変数

名前変数の名前を指定します。X ファンクションがスクリプトで実行されるとき、その名

前を使って、変数に値を割り当てる必要があります。そのため、異なる文字で始

まる短い名前にすることをお勧めします。

ラベル変数のラベルを指定します。特殊記号やスペースを使うことができます。制御ラ

ベルとして X ファンクションダイアログ上に表示します。指定されていない場合、

変数名が使われます。

入力/出力

変数が、入力、出力、入出力のどのタイプで使用されるかを指定します。

データ

タ型

変数のデータ型を指定します。

詳細は変数のデータ型とデフォルト値セクション内の下で参照できます。

データ変数のデフォルト値を指定します。詳細は変数のデータ型とデフォルト値セク



ション内の下で参照できます。

コントロ

ール

ダイアログボックス内の変数のコントロール(コンボボックス、スライダなど)を指定

します。

詳細はコントロールタイプセクション内の下で参照できます。

オプシ

ョン文

字列

変数に対するオプションの文字列を指定します。グループのいくつかの変数を

一緒にしたり、再計算を有効にするなど、オプション文字列で詳細設定を適用

できます。詳細は、ｌオプション文字列セクションの下を参照してください。

テーマ

ID

変数のテーマ ID を指定します。割り当てがない場合、変数のテーマ ID は変

数のインデックスを参照します。テーマ ID は X ファンクションダイアログに対し

てテーマファイルで使われます。

詳細は、テーマ ID セクション内の下で参照できます。

変数のデータ型とデフォルト値 X ファンクションは、下記のようにいくつかのデータ型を提供します。

基本データ型

データ型は double, string, int にすることができます。

デフォルト値は、数値に対しては 0 で、文字列に対しては空白です。

Origin のコンポジットデータ型

データ型は vector, vector<string>, vector<complex>, matrix です。

例えば、vector はワークシート列を入力または出力に接続できます。

デフォルト値は <active>, <new>, <unassigned>にできます。

詳細は、Origin C ヘルプの Composite Data Types をご覧ください。



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 をご覧ください。

TreeNode タイプ

タイプは、TreeNode, ReportData, ReportTree です。TreeNode は入力、ReportData とReportTree は出力です。

Origin の図形オブジェクトコントロール

タイプは ButtonInfo, LineInfo, TextInfo などです。

使用法を見るには、例えば、X ファンクションビルダで組み込み X ファンクション OriginEXE\X-Functions\Data Manipulation\curve translate.OXF を開きます。

レポートタイプ

タイプは、ReportData, ReportTree です。

X ファンクションのサンプルの章の X ファンクション ReportTree のサンプルをご覧ください。

コントロールタイプ X ファンクションビルダでコントロール列の変数グリッドで異なる制御文字列を指定したら、X ファンク

ションダイアログでユーザインターフェースコントロールの異なるタイプを簡単に作成できます。

使用

法データ型制御文字列

数値

編集

ボック

double



グラフ

ブラウ

ザ string

...Graph －1 つのグラフ

...Graphs －複数グラフ

Origin は制御文字列 GraphBrowserFilter を使って、Origin C 関数でグラフブラウザのインターフェース設定をサポートしま

す。詳細は、X ファンクショングラフブラウザダイアログのサンプ

ルをご覧ください。

ファイ

ルの

参照

ボタン

を持

つテキ

スト編

集ボッ

クス

string ...File －1 つのファイル

...Files －複数のファイル

パスの

参照

ボタン

を持

つテキ

スト編

集ボッ

クス

string ...Path

名前

を付け

て保

存ボタ

ンを持

つテキ

スト編

集ボッ

string ...Save



クス

オプション文字列オプション文字列で特殊文字をセットし、変数の操作を指定できます。例えば、再計算をデフォルト

モードでセットしたり、数値の桁数をセットしたり、出力オブジェクトのデフォルト名をセットできます。

詳細は、リファレンス：X ファンクションのオプション文字列をご覧ください。

テーマ ID テーマ ID は、X ファンクションダイアログテーマファイルで使われ、デフォルト値は 0 です。すべて

の変数のテーマ ID を 0(デフォルト)にする場合、テーマファイル内のテーマ ID は 1 から始まる変

数のインデックスに従って変換されます。

既存のテーマファイルと互換性を持たせるために、変数を既存の X ファンクションに挿入したいとき、

以下のようにする必要があります。(変数を後に追加する場合は必要ありません)

変数を挿入する前に、テーマ ID を 0 から変数のインデックスに変更します。

変数を挿入します。

繰り返しを避けるため挿入した変数のテーマ ID を大値にします。

ツリービュー

ツリービューボタンをクリックし、ツリービューに切り替えます。ツリービュー内の設定は、主に Xファンクションダイアログを作成したり、X ファンクションを Origin メニューに追加したり、ドキュメントを



追加するのに使われます。詳細は次の章、X ファンクションを編集するをご覧ください。

17.1.3 コードビルダでプログラミングする

コードビルダボタンをクリックして、コードビルダで X ファンクションを開き、そこで Origin C コー

ドを記述できます。

編集ウィンドウ

編集ウィンドウ上部付近に、コンパイルボタンおよびダイアログに戻るボタン

の 2 つのボタンがあります。コンパイルボタンは、X ファンクションの Origin C コ



ードをコンパイルするのに使用できます。ダイアログに戻るボタンは、編集ウィンドウを閉じ、X ファン

クションビルダダイアログに戻ります。

編集ウィンドウでは、いくつかの Origin C コードの背景が灰色になっています。これらのコードは読

み取り専用で、変更できません。X ファンクションフレームワークは、この部分のコードを生成し、必要

なシンタックスになっています。

ヘッダファイルをインクルードする X ファンクションの Origin C コードに追加のヘッダファイルをインクルードできます。特に理由がなけ

れば、追加のヘッダファイルは、ファイルの上部の次の行の下にインクルードすることをお勧めします。

//put additional include files here

これにより、ファイルを整理し、他の X ファンクションと一貫性を持つことになります。

検索パス

< と > のブラケットを使ってファイルをインクルードすると、それらのファイルは、Origin をインストー

ルしたフォルダの Origin C¥System フォルダからインクルードされます。相対パスを使って、

System フォルダの上位のフォルダに移動することもできます。これらのブラケットは、 .c および .cpp ファイルをコンパイルするときに同じ動作をします。

// "OriginC¥System"フォルダにある fft_utils.h をインクルード #include <fft_utils.h> // "OriginC¥OriginLab"フォルダにある abffiles.h をインクルード #include <..¥OriginLab¥abffiles.h> // 相対パス

ダブルクォートを使ってファイルをインクルードすると、それらのファイルは、ユーザファイルフォルダ

の Origin C¥X-Functions フォルダからインクルードされます。この動作は、Origin C で .c また

は .cpp ファイルをコンパイルするときとは異なります。この動作の違いは、X ファンクションが Originによって維持される場所にインストールされるために必要です。

// ユーザファイルフォルダの "OriginC¥X-Functions"フォルダに // ある myOtherHeader.h ファイル #include "myOtherHeader.h"

絶対パスをダブルクォートで囲んで指定すると、そのファイルはファイルの場所を無視してインクルー

ドされます。



自動コンパイル依存ファイル

X ファンクションビルダのツリービューで、自動コンパイル依存ファイルというオプションがあります。こ

のオプションをオンにすると、コンパイラはインクルードされた.h ファイルと同じ名前を持つ.c また

は .cpp ファイルをチェックします。 .c または .cpp ファイルが見つかったら、ロードされ、コンパイルさ

れます。

// "OriginC¥Originlab"フォルダにある graph_utils.h をインクルード // 自動コンパイル依存ファイルがオンの場合 // 同じフォルダにある graph_utils.c ファイルをロードし、コンパイル #include <..¥Originlab¥graph_utils.h>

内部関数を定義するより明確にし、可読性を上げ、作成したコードを将来に理解しやすく、メンテナンスしやすくするため

に、長い関数を機能的に独立させて分割し、短い構造にすることをお勧めします。これは、他のプロ

グラミング言語に対しても同様です。X ファンクションでは、これらの短い関数を次の行の後にキーワ

ード static を持つ内部関数のように追加することができます。

//put your own support static functions here

例えば、GUI から多くの反応を持つ多くの X ファンクションでは、多くのコードは xfname_event1( )で必要とされ、Origin の interp1 X ファンクションに似たスタティック関数を追加できます。

static void _update_method_show(TreeNode& trGetN)

見て分かるように、アンダスコアを使って関数名のコンポーネントを分割した表記にすることをお勧め

します。

メイン関数メイン関数は、X ファンクションの主要な操作を実行するすべてのコードを配置します。

X ファンクションのメイン関数は、X ファンクションビルダで X ファンクションに与えた同じ名前を持ち

ます。例えば、X ファンクションに myXFunc という名前を付けると、メイン関数も myXFunc という名

前になります。

メイン関数に渡される引数は、X ファンクションビルダダイアログにリストされた変数です。Input とし

てセットされるすべての変数は、定数の参照で渡され、Output または Input/Output としてセットさ

れる変数は書き換え可能な参照として渡されます。



イベントハンドリング関数 X ファンクションのソースコードは、さまざまなイベントを取り扱うために使用する関数を含みます。各

イベントハンドラー関数の名前は、X ファンクションの名前がプレフィックスとなり、その後アンダスコア

に続けてイベント名となります。例えば、X ファンクションの名前が myXFunc の場合、

before_execute イベントハンドラー関数は myXFunc_before_execute という名前になります。

以下は、イベントの一覧です。

before_execute event1 event1_ex make_tree

デフォルトで、すべてのイベントハンドラー関数は空です。デフォルトの動作を変更したり、イベントに

追加の処理を行うには、イベントハンドラー関数にコードを追加する必要があります。

次のセクションは、各イベントハンドラーの目的、渡される関数、戻り型など詳細について説明してい

ます。

before_execute 関数

この関数は、メイン関数の実行前で、2 回または 3 回呼ばれます。

プロトタイプ

void xfname_before_execute(TreeNode& trGetN, int nGetNDialog, int& nRet, int dwCntrl)

パラメータ

trGetN

X ファンクションに渡される変数を含むツリーノード

nGetNDialog

関数が呼ばれるときに示される整数値

0 より大きい値は、関数のダイアログを表示する前に呼ばれることを示しています。これは、メニュー

からダイアログを開くを選んだり、プログラムで -d オプションを付けて X ファンクションを呼んだり、手

動再計算を行うためにパラメータの変更を選ぶときに発生します。

値ダイアログを開く前...



1 単純 GetNBox

2 プレビュー付き GetNGraphBox

3 GetNImageBox

-1 という値は、ユーザが OK ボタンを押すことによって、ダイアログが閉じたことを示しています。

0 という値は、メイン関数が呼ばれようとしていることを示しています。

nRet

このオプションは、X ファンクションの実行状態を制御できます。

XFEVT_PROCEED = 0 // 通常の実行を続ける XFEVT_ABORT = 1 // 実行中止 XFEVT_PROCEED_NO_DLG = 2 // ダイアログを開かずに実行

dwCntrl

このオプションは、この X ファンクションがどのようにアクセスされるかを決めるのに使用できます。可

能な値は、次のようになります。

LTXF_FROM_GUI_MENU // メニューからアクセス LTXF_FROM_GUI_PROMPT // コマンドウィンドウからアクセス LTXF_FROM_AUTO_UPDATE // 自動更新でアクセス LTXF_FROM_FUNCTION // Origin C 関数からアクセス LTXF_THEME_USED // テーマを使用 LTXF_CHANGE_PARAM // パラメータ変更でアクセス

次のサンプルは、X ファンクションがコマンドウィンドウからアクセスし、テーマを使用する方法を示し

ています。(コマンドウィンドウで xfname -t themename と入力)

if(!(dwCntrl & LTXF_FROM_GUI_PROMPT) && (dwCntrl & LTXF_THEME_USED)) { // このケースを取り扱い }

make_tree 関数

この関数は、X ファンクションに渡される各ツリーノード変数に対して 1 回呼ばれます。呼び出しは、

before_execute 関数が呼ばれる前に起こります。

プロトタイプ



int xfname_make_tree(TreeNode& tr, LPCSTR lpcszVarName)

戻り値

ダイアログを更新するには 0、ダイアログを更新しない場合は-1 を返します。デフォルトの動作では-1を返します。

パラメータ

tr

作成されるツリーノード。これは X ファンクションの入力 TreeNode 型で定義する必要があります。

lpcszVarName

TreeNode 変数の名前

event1 関数および event1_ex 関数

これらは、主要なイベントハンドリング関数です。これらは、ダイアログの初期化、ダイアログ内の設定

の変更、ボタンクリックなど、どんなイベントでも呼ばれます。これらの関数は、単純 GetN ダイアログ

を持つ X ファンクションでのみ使われます。グラフプレビュー付き、イメージプレビュー付きの X ファ

ンクションは、後のセクションで説明する異なるイベントハンドラー関数を使用しています。

プロトタイプ

int xfname_event1(TreeNode& trGetN, int nRow, int nEventID, DWORD& dwEnables, LPCSTR lpcszNodeName, WndContainer& DynaCntrlContainer, string& strAux, string& strErrMsg)

戻り値

True が返されると、ダイアログが更新されます。

パラメータ

trGetN

これは、X ファンクションで定義する変数のツリーノードです。

nRow

ツリーノード trGetN で値変更コントロールの行のインデックスコントロール値が変更しないというイベ

ントのとき、値は-1 です。

nEventID

イベントタイプの ID 例えば、GETNE_ON_INIT, GETNE_ON_THEME

dwEnables



このパラメータは、OK ボタン、適用ボタン、その他カスタムボタンを有効または無効にするのに使い

ます。これはデフォルトで True で、ユーザの設定が無効の時 False にセットされ、OK ボタンと適用

ボタンが無効になります。

lpcszNodeName

イベントがダイアログのコントロールの変更によって生成されると、このコントロールの変数名になりま

す。それ以外の場合、空の文字列になります。

DynaCntrlContainer

X ファンクションダイアログウィンドウコンテナ

strAux

このパラメータは、補助的な文字列で、高度な利用を行うためのものです。以下の定義のように、詳

細はヘッダファイル<Origin のインストールフォルダ>¥OriginC¥System¥GetNBox.h をご覧くだ

さい。

#define DLG_NEED_CHANGE_GRID "GETN_CHANGE_GRID" #define GETN_CHANGE_GRID set_aux_value(strAux, DLG_NEED_CHANGE_GRID);

strErrMsg

これは、ダイアログの下に表示される文字列のメッセージです。これは通常、変数値の入力中に発生

するエラーをユーザに通知するのに使います。

GetNGraphPreview イベントハンドラー関数

event1 および event1_ex イベントハンドラー関数は、グラフプレビュー付きの X ファンクションで使

われません。代わりに、GetNGraphPreview 関数を使用します。

GetNGraphPreview_OnInitGrid

このイベント関数は、ダイアログのコントロールを初期化するのに使用します。

GetNGraphPreview_OnInitGraph

イベント関数は、プレビューグラフを初期化するのに使われます。

GetNGraphPreview_OnUpdateGraph

イベント関数は、別のイベント、例えば GUI が変わったことでプロビューグラフを更新するのに使い

ます。

GetNGraphPreview_OnChange

変更は、このイベント関数のトリガーになり、この関数はプレビューグラフを更新するか、この変更によ

りダイアログを更新するかどうかを決定します。



GetNGraphPreview_OnDialogSetup

GetNGraphPreview_OnDestroy

GetNGraphPreview_OnCustomButton

グラフプレビューダイアログを持つ X ファンクションを作成する方法のサンプルは、グラフプレビュー

の GetN ダイアログを作成するセクションをご覧ください。

GetNImageBox イベントハンドラー関数

event1 および event1_ex イベントハンドラー関数は、イメージプレビュー付きの X ファンクションで

使われません。代わりに、GetNImageBox 関数を使用します。

GetNImageBox_OnInit

イメージ GetN ダイアログが開いたとき、イベント関数が呼ばれます。関数は、ダイアログを更新した

り、OK ボタンを有効または無効にするか、呼び出した後、ダイアログの下部にエラーメッセージを表

示するかどうかを決定します。

GetNImageBox_OnChange

ユーザがダイアログのコントロールを変更するときにはいつでもイベント関数が呼ばれます。この関数

は、ダイアログを更新したり、イメージプレビューを更新したり、OK ボタンを有効または無効にしたり、

呼び出した後ダイアログの下部にエラーメッセージを表示するかどうかを決めます。

イメージプレビューダイアログを持つ X ファンクションを作成する方法のサンプルは、イメージ GetNダイアログを作成するセクションをご覧ください。

エラーハンドリング

ダイアログ内にエラーメッセージを表示する

ユーザが悪い値を -d オプションと一緒に X ファンクションに渡したり、X ファンクションダイアログに

悪い値を入力すると、イベントハンドラー関数に渡される strErrMsg 引数をセットして、ダイアログに

エラーメッセージを表示します。

どのイベントハンドラー関数が呼ばれるかは X ファンクションが使用している GetN ダイアログに依

存します。

使用される GetN ダイアログイベントハンドラー関数



単純 GetNBox xfname_event1

プレビュー付き GetNGraphBox GetNGraphPreview_OnChange

GetNImageBox GetNImageBox_OnChange

x1 という整数型の線数を受け付ける X ファンクションがあるとします。次のコードを適切なイベントハ

ンドラー関数に挿入すると、変数 x1 の値が 0 以下か 100 以上かをチェックします。そして、ダイアロ

グで表示するために strErrMsg を適切なメッセージにセットすると、OK ボタンを無効にします。値

が受け入れられる範囲内にある場合、OK ボタンが有効になります。

if( trGetN.x1.nVal < 0 || 100 < trGetN.x1.nVal ) { strErrMsg = "x1 is out of range.Must be from zero to 100."; bOKEnable = false; } else bOKEnable = true;

エラーメッセージを出力する

X ファンクションがプログラムで呼ばれると、そのダイアログボックスは表示されないので、エラーが発

生したことをユーザに通知するため別の方法が必要になります。Origin C は、エラーメッセージを結果ログ、コマンドウィンドウ、スクリプトウィンドウに出力するマクロを定義しています。out_str または

printf ではなく、これらのマクロを使用することを強くお勧めします。

XF_WARN マクロは警告メッセージを出力し、実行を停止しません。これら 3 つのマクロは、初

の引数として警告メッセージを含む文字列を受け付けます。他の引数を受け付ける 2 つのマクロは、

警告メッセージが 1 つまたは 2 つの値のフォーマット文字列であるものとします。

XF_WARN(msg)

XF_WARN_EX(msg, arg1)

XF_WARN_EX2(msg, arg1, arg2)

// Assume the following: // #define MIN_DATA_POINTS 5 // int nNumPts = 3; // string strWksName = "Book1"; XF_WARN("Too few data points."); XF_WARN_EX("Number of data points less than %d.", MIN_DATA_POINTS); XF_WARN_EX("Worksheet named %s was not found.", strWksName); XF_WARN_EX2("Only %d data points, need at least %d.", nNumPts, MIN_DATA_POINTS);



XF_TRACE マクロは、実行停止しないという点で XF_WARN マクロに似ています。初の引数に

対するメッセージを取ることもできますが、追加の引数も取ることができます。

XF_TRACE(msg, ...)

// Assume the following: // #define MIN_DATA_POINTS 5 // int nNumPts = 3; // string strWksName = "Book1"; XF_TRACE("Only %d data points found in %s, need at least %d.", nNumPts, strWksName, MIN_DATA_POINTS);

XF_THROW マクロは実行を停止しますが、それ以外は XF_WARN マクロと同じです。これら 3つのマクロは、初の引数として警告メッセージを含む文字列を受け付けます。他の引数を受け付

ける 2 つのマクロは、警告メッセージが 1 つまたは 2 つの値のフォーマット文字列であるものとします。

XF_THROW(msg)

XF_THROW_EX(msg, arg1)

XF_THROW_EX2(msg, arg1, arg2)

// Assume the following: // #define MIN_DATA_POINTS 5 // int nNumPts = 3; // string strWksName = "Book1"; XF_THROW("Too few data points."); XF_THROW_EX("Number of data points less than %d.", MIN_DATA_POINTS); XF_THROW_EX("Worksheet named %s was not found.", strWksName); XF_THROW_EX2("Only %d data points, need at least %d.", nNumPts, MIN_DATA_POINTS);

17.1.4 グラフプレビュー付きの GetN ダイアログボックスを作成す

るこのセクションでは、プレビューグラフを初期化する方法、GUI 変更でプレビューグラフを更新する

方法、グラフ上の矩形の移動により GUI を更新する方法を含む X ファンクションのグラフプレビュー

GetN ダイアログを作成する方法を示しています。



空の GetN グラフプレビューダイアログを作成する F10 キーを押し、X ファンクションビルダを開きます。

X ファンクション編集ボックスに X ファンクション名として"PrevBox"を入力します。

変数リストを右クリックして、変数の追加を選び、2 番目の変数を追加します。下のダイアログの設定

に合うように変数名、ラベル、別の値を変更します。



X ファンクションビルダのツリービューボタンをクリックし、コンテキストの使用->メニューを開き、

自動 GetN ダイアログをプレビュー付き GetNGraphBox にセットし、保存ボタンをクリックして、この

X ファンクションを保存します。

X ファンクションビルダを閉じ、コマンドウィンドウで"PrevBox -d"を実行します。GetN グラフプレビ

ューダイアログが表示されます。

コードビルダで X ファンクションをコーディングする Origin のコードビルダを開き、ファイル：開くを選び、開くダイアログで、上記で保存した X ファンクシ

ョンを選択して、ワークスペースに追加チェックボックスにチェックが付いていることを確認し、OK をク

リックします。PrevBox.XFC が、Origin C ワークスペースのユーザフォルダに追加され、編集ウィン

ドウに関数本体を表示します。

//put additional include files here の次の行に、追加のヘッダファイルを追加します。例えば、


#include <..¥Originlab¥grobj_utils.h>

プレビューグラフを初期化する GetNGraphPreview_OnInitGraph 関数は、プレビューグラフを初期化するのに使われます。次

のコードをコピーし、関数に貼り付け、コンパイルボタンをクリックします。プレビューダイアログが開く

と、矩形がプレビューグラフ上に表示されます。コンパイルをクリックし、コマンドウィンドウで

"PrevBox -d"を実行します。

// PageBase クラスオブジェクトから GraphPage オブジェクトに pgTemp をキャスト GraphPage gp(pgTemp); // このテンプレートをグラフにロードし、 // グラフにズームイン/ズームアウトを含めるこれが必要なければ // この行を削除 page_load(gp, "CurvePreview"); // グラフページのアクティブグラフレイヤを取得 GraphLayer gl = gp.Layers(); // 矩形を追加し、x 位置の参照を xfrom と xto 変数 // にセット GraphObject go; add_rect(gl, go, trGetN.xfrom.dVal, 0, trGetN.xto.dVal, -1, SYSCOLOR_BLUE, 2, LN_VERTICAL, true, false);



GUI 変更でプレビューグラフを更新するプレビューグラフを更新するには、GetNGraphPreview_OnChange 関数の dwUpdateGraph 変

数内の UPDATE_GRAPH_CHANGED ビットを含める必要があります。例えば、

// GetNGraphPreview_OnUpdateGraph を呼び出すビットを含め

// グラフを更新

if( !(dwUpdateGraph & UPDATE_GRAPH_CHANGED) )

dwUpdateGraph |= UPDATE_GRAPH_CHANGED;

以下のコードを GetNGraphPreview_OnUpdateGraph 関数に追加し、グラフを更新します。コン

パイルボタンをクリックし、コマンドウィンドウで"PrevBox -d"を実行します。

// PageBase クラスオブジェクト GraphPage オブジェクトに

// pgTemp をキャスト

GraphPage gp(pgTemp);

GraphLayer gl = gp.Layers(); // アクティブグラフレイヤを取得

GraphObject go = gl.GraphObjects("Rect");

double x0 = trGetN.xfrom.dVal;

double x1 = trGetN.xto.dVal;

// GUI 上の矩形の x 位置を更新

vector vv(4);

vv[0] = x0; vv[1] = x1; vv[2] = x1; vv[3] = x0;

Tree tr;

tr.Root.Data.X.dVals = vv;

go.UpdateThemeIDs(tr.Root);

go.ApplyFormat(tr, true, true);

// グラフウィンドウをリフレッシュ

gp.Refresh(TRUE);

グラフオブジェクトイベントで GUI を更新するプレビューグラフで矩形を移動またはサイズ変更した際に GUI を更新したい場合、以下のことを行

います。

add_rect 関数の後の GetNGraphPreview_OnInitGraph 関数に以下を追加します。



// 矩形が移動またはサイズ変更した際にイベントスクリプトを

// プレビューダイアログに通知するようセット他のイベントタイプに対して、oc_const.h ファイルの

// GRCT_*をご覧ください

set_LT_script(go, "run -oc notify_dlg_on_move_obj;",

GRCT_SIZEMOVE);

次のコードを GetNGraphPreview_OnChange に追加し、矩形の新しい位置を GUI に更新しま

す。コンパイルボタンをクリックし、コマンドウィンドウで"PrevBox -d"を実行します。

if( bChangedByGraph )

{

// 矩形の x 開始/終了を取得し、GUI を更新

GraphPage gp(pgTemp);

GraphLayer gl = gp.Layers();

GraphObject goRect = gl.GraphObjects("Rect");

Tree tr;

tr = goRect.GetFormat(FPB_DATA, FOB_ALL, TRUE, TRUE);

vector vv;

vv = tr.Root.Data.X.dVals;

trGetN.xfrom.dVal = vv[0];

trGetN.xto.dVal = vv[1];

// GUI を更新する UPDATE_GRID_*ビットを更新

if( !(dwUpdateGrid & UPDATE_GRID_SIMPLE) )

dwUpdateGrid |= UPDATE_GRID_SIMPLE;

}

プレビューボタンを追加するプレビューボタンと自動プレビューチェックボックスを追加するには次をご覧ください。 X ファンクショ

ン:X ファンクションをカスタマイズする：ダイアログにカスタムボタンを追加するグラフプレビューGetNダイアログのプレビューボタンを表示する

17.1.5 イメージ GetN ダイアログを作成するこのセクションでは、次のダイアログのように行列イメージのデータプレビューを持つ X ファンクション

GetN ダイアログの作成方法を示します。イメージプレビューとダイアログの初期化の方法やユーザ



がダイアログ内のコントロールを変更することで、イメージプレビューとダイアログの更新する方法が

含まれます。

空の GetN イメージプレビューダイアログを作成する F10 キーを押し、X ファンクションビルダを開きます。

X ファンクション編集ボックスに X ファンクション名として"ImageBox"を入力します。

変数リストを右クリックして、変数の追加を選び、変数を追加します。下のダイアログの設定に合うよう

に変数名、ラベル、別の値を変更します。



X ファンクションビルダのツリービューボタンをクリックし、コンテキストの使用->メニューを開き、

自動 GetN ダイアログを GetNImageBox にセットし、保存ボタンをクリックして、この X ファンクショ

ンを保存します。

X ファンクションビルダを閉じ、新しい行列ウィンドウを開き、ファイル -> インポート -> イメージを選び、

イメージファイルを選択し、開くをクリックしてイメージを行列ウィンドウにインポートします。

行列ウィンドウをアクティブにしたまま、コマンドウィンドウで"ImageBox -d"を実行します。イメージプ

レビューGetN ダイアログが現れます。

コードビルダで X ファンクションをコーディングする Origin のコードビルダを開き、ファイル：開くを選び、開くダイアログで、上記で保存した X ファンクシ

ョンを選択して、ワークスペースに追加チェックボックスにチェックが付いていることを確認し、OK をク

リックします。ImageBox.XFC が、Origin C ワークスペースのユーザフォルダに追加され、編集ウィ

ンドウに関数本体を表示します。

//put additional include files here の次の行に、下のように追加のヘッダファイルを追加します。


#include <image_utils.h>

#include <..¥Originlab¥matdata_utils.h>

次のように、//put your own support static functions here の行の後にスタティック関数を追加し

ます。




static bool _adjust_image_brightness_ex(BITMAPHANDLE* pPreviewBitmap, TreeNode&

trGetN, bool& bOKEnable, string& strErrMsg)

{

int nRet = adjust_image_brightness(pPreviewBitmap, trGetN.level.nVal);

if( SUCCESS != nRet)

{

bOKEnable = false; // disable OK button if adjust image failed

strErrMsg = "Fail to adjust image brightness"; // error message string

return false;

}

return true;

}

GetNImageBox_OnInit イベント関数イメージプレビューGetN ダイアログが開いたとき、イベント関数が呼ばれます。イメージプレビューを

初期化したり、ダイアログコントロールを初期化したり、OK ボタンを有効または無効にするのに使うこ

とができます。このサンプルでは、次のコードを GetNImageBox_OnInit 関数に追加し、レベルコ

ントロールの値に従ってイメージの明るさを調整します。

// イメージプレビューコントロールからビットマップハンドルポインタを取得 pBITMAPHANDLE pPreviewBitmap = pimgCntrl->GetBitmapHandlePtr(); // 内部関数を呼びイメージを調整 _adjust_image_brightness_ex(pPreviewBitmap, trGetN, bOKEnable, strErrMsg);

GetNImageBox_OnChange イベント関数ユーザがグリッド内のコントロールを変更するときにはいつでもイベント関数が呼ばれます。ダイアロ

グコントロールの変更でイメージプレビューを更新したり、別のコントロールの変更でダイアログコント

ロールを更新したり、OK ボタンの有効または無効の状態を更新するのに使用します。次のコードを

GetNImageBox_OnChange 関数に追加します。

// イメージを調整するのに内部関数を呼び、イメージプレビューを更新するため True を返す bUpdatePreview = _adjust_image_brightness_ex(pPreviewBitmap, trGetN, bOKEnable, strErrMsg);



メイン関数メイン関数は、それに対応する X ファンクションと同じ名前を持ちます。以下のコードをメイン関数に

追加し、コンパイルボタンをクリックします。

// 入力イメージから出力イメージにビットマップハンドルポインタをコピー bool bCopy = true; oimg.SetLBmp(iimg.GetLBmp(), bCopy); // 出力イメージからビットマップハンドルポインタを取得 pBITMAPHANDLE phBmp = oimg.GetLBmp(); // 調整 adjust_image_brightness(phBmp, level);

X ファンクションを使うコマンドウィンドウで ImageBox -d; を実行し、X ファンクションダイアログを開きます。レベルコントロ

ールの値を変更し、イメージプレビューの明るさが変わります。

ボタンをクリックし、テーマコンテキストメニューを開き、名前を付けて保存を選び、テーマ名ボック

スに"mylevel"と入力し、OK をクリックしてテーマファイルを保存します。キャンセルをクリックして、

X ファンクションダイアログを閉じます。

コマンドウィンドウで、"ImageBox -d -t mylevel"を実行し、指定したテーマで X ファンクションダイ

アログを開きます。

17.1.6 カスタムダイアログを作成する X ファンクションは、インターフェースとしてダイアログビルダで差ｋすえいしたカスタムダイアログをサ

ポートします。ユーザがカスタマイズしたダイアログを使用したい、そしてダイアログの自動更新をサ

ポートしたい、または Origin メニューからダイアログを開きたい場合、X ファンクションのカスタムダイ

アログを使うことができます。

以下に、X ファンクションダイアログを作成する方法を示します。このサンプルで使用されるダイアロ

グは、Origin の組込みのリソースです。ユーザは、ダイアログビルダの章の説明に従って、カスタム

ダイアログを生成することができます。

X ファンクションを作成する F10 キーを押し、X ファンクションビルダを開きます。

X ファンクション名として"CustomDlg"と入力し、X ファンクションの変数を下記のようにセットします。



ツリービューボタンをクリックして、ツリービューに切り替え、コンテキトの使用 -> メニュー -> 自動 GetN ダイアログでカスタムを選びます。カスタムダイアログ関数編集ボックスに、カスタムダイアロ

グ関数名を、例えば、"OpenCustomDlg"のように入力します。保存ボタンをクリックし、この Xファンクションを保存し、X ファンクションビルダを閉じます。

CustomDlg.h という新しいヘッダファイルを作成し、OriginExeFolder¥OriginC¥Originlab フォ

ルダに保存します。次のコードをこのファイルに入力します。関数を作成する CustomDialog のコー

ドは、X ファンクションからダイアログに X ファンクションの設定を取得する方法および Origin C の

TreeNode 変数を使ってダイアログから X ファンクションに設定を戻す方法を示すのに使われます。

#include <xfutils.h> // okxf_resolve_string_get_origin_object 関数で必要

#include <..¥Originlab¥DialogEx.h>

class CustomDialog :public Dialog

{

public:

// IDD_SAMPLE_SPLITTER_DLG はダイアログリソース ID

// ODlg8 は、ダイアログリソース DLL ファイルの名前

// Origin の組込みファイルで

// OriginExeFolder¥OriginC¥Originlab フォルダにある

// 以下のようにファイルパス無しで DLL ファイルを指定すると

// DLL ファイルが、このファイル - CustomDlg.h と同じ場所にある

CustomDialog(TreeNode& trXFSettings) :

ResizeDialog( IDD_SAMPLE_SPLITTER_DLG, "ODlg8" )

{



// X ファンクション設定ツリーから入力列オブジェクトを取得

// 次の列を検索し、次の列を

//X ファンクション設定ツリーに割り当て

Column col;

okxf_resolve_string_get_origin_object(trXFSettings.in.strVal, &col);

if( col )

{

Worksheet wks;

col.GetParent(wks);

Column colNext(wks, col.GetIndex()+1);

if( colNext )

{

string strColRange;

colNext.GetRangeString(strColRange);

trXFSettings.in.strVal = strColRange;

}

}

}

};

ファイル->開くを選び、Origin のコードビルダを開き、X ファンクションを選択して、ワークスペースに

追加チェックボックスが開くダイアログでチェックが付いていることを確認し、OK をクリックします。

CustomDlg.XFC は、Origin C ワークスペースのユーザフォルダに追加され、編集ウィンドウに関

数本体を表示します。

//put additional include files here の次の行に、下のように追加のヘッダファイルを追加します。


#include <..¥Originlab¥CustomDlg.h>

//put your own support static functions here の行の後にカスタムダイアログを開

く関数を追加します。関数名は、ツリービューのカスタムダイアログ編集ボックスに入力されます。関

数のインターフェース、戻りの型、引数リストは、以下のように同じままにします。


bool OpenCustomDlg(TreeNode& tr, PEVENT_FUNC pfn, LPCSTR lpcszTitle, LPCSTR

lpcszDescription, HWND hWndParent)

{

CustomDialog dlg(tr);

if( dlg.DoModal(GetWindow()) )

{

tr.AutoUpdate.nVal = AU_AUTO; // デフォルトは 2(手動)



return true;

}

else // ダイアログのキャンセルボタンをクリック

{

return false; // メイン関数を呼ばない

}

}

次のコードを X ファンクションのメイン関数にコピーします。

out = in;

コンパイルボタンをクリックします。

X ファンクションを使う 2 列を持つ新しいワークシートを作成し、それぞれに異なるデータを入力します。

列 A を選択し、コマンドウィンドウで"CustomDlg -d"を実行します。

キャンセルボタンをクリックし、ダイアログを閉じます(サンプルダイアログリソースには OK ボタンはあ

りませんので、ここでキャンセルをクリック)。

自動更新の錠前と列 B のデータを持つ新しい列が作成されます。列選択は、カスタムダイアログの

関数で次の列に変更されます。

列 B のデータを変更すると、自動更新をトリガーとして出力列を更新します。

17.1.7 ウィザードダイアログを作成する X ファンクションはウィザードダイアログをサポートしています。ウィザードダアイログを作成するには、

n+1 個の X ファンクションが必要です。n はウィザードページの数です。1 つは、メインの X ファンク

ションです。メインの X ファンクションは、ウィザードページを作成するのに使われ、スクリプトモードが

オフであれば、ウィザードダイアログを開くか、スクリプトモードがオンの場合ダイアログ無しで実行し

ます。

ウィザードを作成する以下に、2 ページのウィザードを作成する方法を示します。1 ページ目は、XY 範囲を選択し、選択し

たデータ範囲の部分 x 範囲を指定するのに使われます。2 ページ目は、元のグラフで指定した塗り



色で矩形を追加するのに使われます。この矩形の左 x および右 x は、1 ページ目の x の値と同じで

す。

ヘッダファイル wizDlg.h を UFF¥OriginC フォルダに追加します。次のコードをこのヘッダファイ

ルに配置し、Origin C 組み込み X ファンクションのウィザードクラスからサブクラスを派生します。Xファンクションの基本ウィザードクラスは次のようなものです。

XFCore、これは各ページで値を保存し、渡すのに使われます。

XFWizTheme、これは各ウィザードページのテーマ設定を並べるのに使われます。

XFWizInputOutputRange、これは各ページの入出力範囲を並べるのに使われます。

XFWizManager、これはとても重要で、それから派生されるユーザ定義のサブクラスを持たなけれ

ばなりません。ウィザード内のステップを決定するのに使用します。

#ifndef __WIZ_DLG_H__

#define __WIZ_DLG_H__

#include <..¥OriginLab¥XFWiz.h>

#include <..¥OriginLab¥XFCore.h>

#include <..¥OriginLab¥WizOperation.h>

#include <..¥OriginLab¥XFWizNavigation.h>

#include <..¥OriginLab¥XFWizManager.h>

#include <..¥OriginLab¥XFWizScript.h>

#include <..¥OriginLab¥XFWizDlg.h>

#include <..¥OriginLab¥XFWizard_utils.h>

///////////////////////////////////////////////////////////////////////////

class WizDlgCore :public Dialog

{

public:

WizDlgCore()

{

}

void SetXRange(double from, double to)

{

m_dFrom = from;

m_dTo = to;

}



void GetXRange(double& from, double& to)

{

from = m_dFrom;

to = m_dTo;

}

private:

double m_dFrom;

double m_dTo;

};

///////////////////////////////////////////////////////////////////////////

class WizDlgTheme :public XFWizTheme

{

};

///////////////////////////////////////////////////////////////////////////

class WizDlgInputOutputRange :public XFWizInputOutputRange

{

};

///////////////////////////////////////////////////////////////////////////

class WizDlgManager :public Dialog

{

public:

WizDlgManager(LPCSTR lpcszThemeName = NULL,

const XFWizTheme *pXFWizTheme = NULL,

const XFWizInputOutputRange *pXFWizIO = NULL, DWORD dwUIDOp = 0);

protected:

virtual XFCore* CreateXFCore() { return new WizDlgCore; }

virtual XFWizTheme* CreateXFWizTheme() { return new WizDlgTheme; }

virtual XFWizInputOutputRange* CreateXFWizInputOutputRange()

{

return new WizDlgInputOutputRange;

}

virtual string GetClassName() { return "WizDlgExample"; }

};

#define STR_XFNAME_PAGE_1 "wizPage1"

#define STR_XFNAME_PAGE_2 "wizPage2"



#define STR_LABEL_XFNAME_PAGE_1 "Page 1"

#define STR_LABEL_XFNAME_PAGE_2 "Page 2"

WizDlgManager::WizDlgManager(LPCSTR lpcszThemeName,

const XFWizTheme *pXFWizTheme, const XFWizInputOutputRange *pXFWizIO,

DWORD dwUIDOp) // = NULL, NULL, NULL, 0

:XFWizManager(lpcszThemeName, pXFWizTheme, pXFWizIO, dwUIDOp)

{

StringArray saMapXFNames = {STR_XFNAME_PAGE_1, STR_XFNAME_PAGE_2};

StringArray saMapXFLabels = {STR_LABEL_XFNAME_PAGE_1,

STR_LABEL_XFNAME_PAGE_2};

m_saMapXFNames = saMapXFNames;

m_saMapXFLabels = saMapXFLabels;

ASSERT( m_saMapXFNames.GetSize() == m_saMapXFLabels.GetSize() );

m_saDefaultXFNames = saMapXFNames;

}

///////////////////////////////////////////////////////////////////////////

int run_wiz_nodlg(LPCSTR lpcszThemeName = NULL,


const XFWizInputOutputRange *pXFWizIO = NULL, DWORD dwOPUID = 0)

{

TEMPLATE_run_wiz_nodlg(WizDlgManager, lpcszThemeName, pXFWizTheme,

pXFWizIO, dwOPUID)

}

int open_wiz_dlg(LPCSTR lpcszThemeName = NULL,


const XFWizInputOutputRange *pXFWizIO = NULL, DWORD dwOPUID = 0)

{

TEMPLATE_open_wiz_dlg(WizDlgManager, lpcszThemeName, pXFWizTheme,

pXFWizIO, dwOPUID)

}

#endif //__WIZ_DLG_H__

F10 を押して X ファンクションビルダを開き、メインの X ファンクションを下記のように作成します。



ボタンをクリックして、この X ファンクションを保存します。X ファンクションビルダを閉じます。

コードビルダを開き、wizDlg.OXF ファイルを開き、現在のワークスペースにそれを追加します。

//put additional include files here の後ろに次のヘッダファイルを追加します。

#include <..¥OriginLab¥XFWiz.h>

#include <event_utils.h>

#include <..¥OriginLab¥WksOperation.h>

#include <..¥OriginLab¥WizOperation.h>

#include <..¥OriginLab¥XFCore.h>

#include <..¥OriginLab¥XFWizNavigation.h>

#include <..¥OriginLab¥XFWizManager.h>

#include <..¥OriginLab¥XFWizScript.h>

#include <..¥OriginLab¥XFWizDlg.h>

#include <..¥OriginLab¥XFWizard_utils.h>

#include <..¥Originlab¥wizDlg.h> // この例では、ユーザ追加のヘッダファイル

次のコードをメインの関数 wizDlg に追加します。

WizDlgInputOutputRange objXFWizIO;

if(!xfwiz_construct_input_range(&objXFWizIO, STR_XFNAME_PAGE_1, iy))

{

XF_THROW(XFERR_FAIL_TO_UPDATE_GETN_TREE);



}

if( script )

{

run_wiz_nodlg(theme, NULL, &objXFWizIO);

}

else

{

open_wiz_dlg(theme, NULL, &objXFWizIO);

}

F10 を押し、X ファンクションビルダを開き、下記のウィザードページ 1 に対して X ファンクションの

wizPage1 を作成します。

//put additional include files here の後ろに次のユーザ定義のヘッダファイルを追加します。

#include <..¥Originlab¥wizDlg.h> // この例に対してユーザが追加したヘッダファイル

次のコードをページ 1 のメイン関数 wizPage1 に配置します。

WizDlgCore* pWizCore =

(WizDlgCore*)get_xf_core_handler(NODE_NAME_XF_WIZ_CORE_POINTER);

ASSERT(pWizCore);

// WizCore クラスオブジェクトに X をセット

pWizCore->SetXRange(xfrom, xto);



次のコードを X ファンクション wizPage1 の_event1 関数 wizPage1_before_execute に追加し、

入力データ範囲に従って、xfrom および xto コントロールを初期化します。

if( PDS_AUTO == okutil_cvt_str_to_predefined_type(trGetN.xfrom.strVal)

|| PDS_AUTO == okutil_cvt_str_to_predefined_type(trGetN.xto.strVal) )

{

DataRange dr;

TreeNode trRange = trGetN.iy;

okxf_resolve_tree_construct_range(&trRange, &dr);

vector vx;

dr.GetData(DRR_GET_DEPENDENT, 0, NULL, NULL, NULL, &vx);

double from, to;

vx.GetMinMax(from, to);

trGetN.xfrom.dVal = from;

trGetN.xto.dVal = to;

}

X ファンクションビルダを開き、2 ページ目に対して X ファンクション wizPage2 を作成します。X ファ

ンクション名と変数を下記のようにセットアップし、保存ボタンをクリックして保存します。

コードビルダで、wizPage2.OXF ファイルを開き、下記のように現在のワークスペースにそれを追加

してヘッダファイルをインクルードします。


#include <..¥Originlab¥wizDlg.h>




メイン関数 wizPage2 を探し、次のコードを追加します。コードは、1 ページ目で割り当てられる

xfrom と xto に従って矩形を追加するのに使われます。

WizDlgCore* pWizCore =

(WizDlgCore*)get_xf_core_handler(NODE_NAME_XF_WIZ_CORE_POINTER);

ASSERT(pWizCore);

// 1 ページ目で指定した値から x を取得

double xfrom, xto;

pWizCore->GetXRange(xfrom, xto);

// 入力範囲を取得

XFWizNavigation* pXFWizNavg =

(XFWizNavigation*)(pWizCore->GetXFWizNavigation());

WizDlgInputOutputRange* pwizInputOutputRange =

(WizDlgInputOutputRange*)(pXFWizNavg->GetXFWizInputOutputRange());

// 1 ページ目から入力範囲を取得

Array<DataRange&> arrdr;

if( pwizInputOutputRange->Get(&arrdr, STR_XFNAME_PAGE_1, true) )

{

DataRange& dr = arrdr.GetAt(0);

vector<uint> vUIDs;

DataPlot dp;

if( dr.GetPlots(vUIDs) > 0 )

{

// 入力範囲から元のグラフレイヤを取得

dp = (DataPlot)Project.GetObject(vUIDs[0]);

GraphLayer gl;

dp.GetParent(gl);

// 矩形をグラフに追加

GraphObject go;

add_rect(gl, go, xfrom, 0, xto, 0, color, 2, LN_VERTICAL,

true, false);

}

}



X ファンクションを使うサンプルのウィザードを実行する前に、新しいワークシートを作成し、2 列にデータを入力し、その 2列で折れ線グラフを作成します。

ウィザードダイアログで実行する

グラフウィンドウをアクティブのままにします。コマンドウィンドウに wizDlg と入力します。

現れたダイアログで、xfrom と xto コントロールの値を変更します。「進む」ボタンをクリックします。

次のページで、色塗りのコントロールを青に変更します。

テーマボタンをクリックし、名前を付けて保存を選び、名前に theme1 と入力し、OK をクリックし

ます。

「完了」ボタンをクリックします。ウィザードダイアログが閉じ、青い矩形が元のグラフに追加されます。

ダイアログ無しでスクリプトモードで実行する

グラフウィンドウをアクティブのままにします。コマンドウィンドウで、"wizDlg s:=1 t:=theme1"を実行

します。ダイアログが開かずに、指定したテーマファイルの設定に従って矩形がアクティブグラフに追

加されます。

17.1.8 X ファンクションでガジェットを作成する Origin はグラフ上の操作を行うガジェットツールをいくつか提供しています。これらは、グラフウィンド

ウがアクティブなときに、ガジェットメニューにあります。

ガジェットツールの 1 つを選択すると、Origin はグラフに四角形のオブジェクトを追加し、それを使

ってデータ分析したい領域を選択します。関心のある領域を選択したら、ボタンをクリックして、コ

ンテキストメニューを開き、設定ダイアログまたはテーマを使って、分析方法をセットアップし、結果を

希望の場所に出力します。



Origin は、X ファンクションを使ってユーザ定義のガジェットツールを追加し、このツールを Originのガジェットメニューに追加することができます。

主な処理ガジェットツールを作成するには、下記の 3 つの処理を行う必要があります。

X ファンクションを作成する X ファンクションは、ダイアログテーマを含め、Origin メニューに機能を

追加するのに使用します。

GraphObjCurveTool から派生したユーザ定義クラスを追加する GraphObjCurveTool は、Origin C のクラスで、

OriginExeFolder\OriginC\Originlab\GraphObjTools.h ファイルで宣言されています。このク

ラスは、ROI オブジェクトを作成し、ROI の移動や ROI コンテキストメニューからのイベントを用意し

ています。



イベント関数を追加するグローバルイベント関数の名前が xfname_events の形式で必要です。xfname は X ファンクション

の名前です。関数の引数は、次のように記述する必要があります。

void xfname_events(string strGrName, int nEvent, int nMsg = 0);

次のセクションでは、この処理のそれぞれを詳細に説明しています。

X ファンクションを作成する F10 キーを押し、X ファンクションビルダを開きます。以下のように、X ファンクション名と変数をセット

アップします。

ボタンをクリックして、X ファンクションを保存します。

ボタンをクリックして、X ファンクション関数をコードビルダウィンドウで開きます。

//put additional include files here の下に次のヘッダファイルを追加して、インクルードします。


// グラフオブジェクトのグローバル関数をインクルード


#include <..¥Originlab¥GraphObjTools.h> // GraphObjCurveTool クラスをインクルード

quick_curve_stats_make_tree という名前の関数を探し、以下の例のように関数本体に GUI ツリ

ーを作成するためのコードを追加します。



if( 0 == strcmp(lpcszVarName, "trGUI") )

{

GETN_USE(tr)

GETN_OPTION_BRANCH(GETNBRANCH_OPEN) // ブランチを開くデフォルト

int nUserID = GET_USER_DATAID(0);

int nBranchID = 1;

GETN_STR(toolname, STR_TOOLNAME, "Quick Curve Stats")GETN_ID(nUserID++)

// 編集ボックスでチェックボックスを追加するオプション

GETN_CONTROL_OPTION_BOX(1)

GETN_COLOR(rectColor, "Rectangle Fill Color", SYSCOLOR_LTYELLOW) GETN_ID(nUserID++)

GETN_COLOR_CHOICE_OPTIONS(COLORLIST_CUSTOM | COLORLIST_SINGLE)

// 出力結果のオプションに対して、計算する量のブランチ

GETN_BEGIN_BRANCH(quantities, "Quantities") GETN_ID(nBranchID++)

GETN_OPTION_BRANCH(GETNBRANCH_OPEN|GETNBRANCH_CHECK_CONTROL)

GETN_CHECK(dataname, "Dataset Name", true) GETN_ID(nUserID++)

GETN_CHECK(n, "Total Number", true) GETN_ID(nUserID++)

GETN_CHECK(sum, "Sum", true) GETN_ID(nUserID++)

GETN_CHECK(mean, "Mean", true) GETN_ID(nUserID++)

GETN_CHECK(sd, "Standard Deviation", false) GETN_ID(nUserID++)

GETN_CHECK(se, "SE of Mean", false) GETN_ID(nUserID++)

GETN_END_BRANCH(quantities) // the end of quantities branch

// 出力ブランチ、出力先のオプション

GETN_BEGIN_BRANCH(output, "Output To") GETN_ID(nBranchID++)

GETN_CHECK(script, "Script Window", true) GETN_ID(nUserID++)

GETN_CHECK(reslog, "Results Log", false) GETN_ID(nUserID++)

GETN_CHECK(outputwks, "Output to Worksheet", false) GETN_ID(nUserID++)

GETN_END_BRANCH(output) // 出力ブランチの後

}

return 0;

ボタンをクリックして、コードをコンパイルします。コンパイルが終わったら、

ボタンをクリックし、X ファンクションビルダに戻ります。

ボタンをクリックし、X ファンクションを再度保存し、X ファンクションビルダを閉じます。



コマンドウィンドウで"quick_curve_stats -d"を実行します。次のダイアログが開きます。

GraphObjCurveTool から派生したクラスを追加するコードビルダのメニューからファイル->新規を選び、新規ファイルダイアログを開き、

QuickCurveStatsTool というヘッダファイルを追加します。場所は、デフォルトのパス

UFF¥OriginC として保持し、OK ボタンをクリックします。

QuickCurveStatsTool.h ファイルで、以下のようにコードを追加し、必要なヘッダファイルをインク

ルードし、マクロを定義し、Origin の GraphObjCurveTool クラスから派生したユーザ定義クラス

QuickCurveStatsTool を追加します。

#include <..¥originlab¥grobj_utils.h>

#include <..¥Originlab¥GraphObjTools.h>



#define XF_NAME "quick_curve_stats"

#define TOOL_PREFERENCES_TITLE _L("Statistics")

class QuickCurveStatsTool :public GraphObjCurveTool

{

protected:

string GetXFName() { return XF_NAME; }

string GetSignature() { return "xf_addtool_quick_curve_stats"; }

string GetPreferenceTitle(){ return TOOL_PREFERENCES_TITLE; }

// この関数を下のイベント関数を追加するセクションで書き換え

bool DoOutput(bool bUpdateLastOutput)

{

out_str("DoOutput");

return true;

}

};

コードビルダで quick_curve_stats.XFC を開き、下のように QuickCurveStatsTool.h ファイルを

インクルードします。


// グラフオブジェクトのグローバル関数をインクルード


#include <..¥Originlab¥GraphObjTools.h>

#include "QuickCurveStatsTool.h"

X ファンクションのメイン関数に行き、上記で定義したクラスを使って、グラフ上で ROI を作成します。

QuickCurveStatsTool curveTool();

int nErr = curveTool.Create(XF_NAME, LN_VERTICAL, trGUI);

if(nErr)

error_report("quick_curve_stats failed to Init!");

曲線を持つグラフウィンドウをアクティブにし、コマンドウィンドウで "quick_curve_stats -d" を実行し

ます。上部にテキスト、タイトル、2 つの小さなボタンを持つ矩形がグラフに追加されます。



イベント関数を追加する

基本グローバルイベント関数

コードビルダで quick_curve_stats.XFC を開き、下記のように //put your own support static functions here の行の後にイベント関数を追加します。


void quick_curve_stats_events(string strGrName, int nEvent, int nMsg = 0)

{

QuickCurveStatsTool sTool;

graphobjtool_events(sTool, strGrName, nEvent, nMsg);

}

コマンドウィンドウで、この X ファンクション"quick_curve_stats -d"を再び実行し、OK ボタンをクリッ

クしてダイアログを閉じます。ROI に接続しているボタンをクリックし、コンテキストメニューを開き

ます。新しい出力をクリックすると、DoOutput はスクリプトウィンドウに出力します。設定を選択し、Xファンクションの GUI 設定を持つダイアログが現れます。矩形の色塗り制御で色を変更し、開いてい

るダイアログボックスのツール名の表示制御でテキストを更新し、OK をクリックします。矩形の塗り色

とテキストのタイトルが変わります。

仮想イベント関数をオーバーロードする

コマンドウィンドウで、この X ファンクション"quick_curve_stats -d"を実行し、ROI を追加します。グ

ラフ上で ROI を移動すると、左側にある Origin のステータスバーは、現在の開始 x 値/終了 x 値と

ROI の幅を表示します。次の 3 つのステップは、OnMove 仮想メソッドをオーバーロードして、ROI移動に伴い、曲線の統計結果で ROI 上部のテキストを更新する方法を示しています。

次の 2 つのメソッドは QuickCurveStatsTool.h ファイルで宣言されます。

protected:

BOOL OnMove();

private:

string getResult(TreeNode& trResult = NULL);

新しい QuickCurveStatsTool.cpp ファイルを UFF¥OriginC フォルダに作成します。OnMove と

getResult メソッドを下記のようにこのファイルに実装します。

///////////////////////////////////////////////////////////////////////////

// Include your own header files here.



#include <GetNbox.h>

#include "QuickCurveStatsTool.h"

///////////////////////////////////////////////////////////////////////////

// Start your functions here.

BOOL QuickCurveStatsTool::OnMove()

{

string strTopText = getResult();

UpdateTopLabel(strTopText, true);

return true;

}

string QuickCurveStatsTool::getResult(TreeNode& trResult)

{

// 選択した ROI でデータを取得

vector vx, vy;

GetData(vx, vy);

// データの統計を計算

int npts;

double sum, mean, sd, se;

vy.Sum(sum);

if( 0 != ocmath_basic_summary_stats(vy.GetSize(), vy, &npts,

&mean, &sd, &se) )

{

return "Error in calculation!";

}

// GUI から出力オプションを取得

Tree trGUI;

GetGUITree(trGUI);

bool bDatasetName = trGUI.quantities.dataname.nVal,

bPoints = trGUI.quantities.n.nVal,

bSum = trGUI.quantities.sum.nVal,

bMean = trGUI.quantities.mean.nVal,

bSD = trGUI.quantities.sd.nVal,

bSE = trGUI.quantities.se.nVal;

string strDatasetName;

if( bDatasetName )

{

m_dp.GetRangeString(strDatasetName);



}

// 結果を文字列に配置

string strText;

string strNumDec = "*", strNextLine = "¥r¥n";

if( bDatasetName )

strText += "Dataset Name:" + strDatasetName + strNextLine;

if( bPoints )

strText += "N = " + npts + strNextLine;

if( bSum )

strText += "Sum = " + ftoa(sum, strNumDec) + strNextLine;

if( bMean )

strText += "Mean = " + ftoa(mean, strNumDec) + strNextLine;

if( bSD )

strText += "SD = " + ftoa(sd, strNumDec) + strNextLine;

if( bSE )

strText += "SE = " + ftoa(se, strNumDec) + strNextLine;

strText.TrimRight(strNextLine);

// 結果をツリーに配置

if( trResult && trResult.IsValid() )

{

GETN_USE(trResult)

if( bDatasetName )

{

GETN_STR(DatasetName, "Dataset Name", strDatasetName)

GETN_CURRENT_SUBNODE.SetAttribute(STR_TYPE_ATTRIB,

TNVAL_TYPE_CSTRING);

}

if( bPoints )

{

GETN_NUM(N, "Number of Points", npts)

}

if( bSum )

{

GETN_NUM(Sum, "Sum", sum)

}

if( bMean )

{

GETN_NUM(Mean, "Mean", mean)

}

if( bSD )



{

GETN_NUM(SD, "SD", sd)

}

if( bSE )

{

GETN_NUM(SE, "SE", se)

}

}

return strText;

}

X ファンクションを実行して ROI をグラフに追加します。ROI を移動すると、上部のテキストが、選択

した Y データの現在の統計結果で更新されます。

以下は、コンテキストメニュー "新しい出力" と "レポートワークシートに移動" を動作させる方法を示

しています。矩形のバイナリストレージにレポートワークシートの名前をセットおよび取得するには、派

生クラス QuickCurveStatsTool 内の DoOutput と GetReportWorksheet 仮想関数をオーバー

ロードし、プライベート関数 acessBinaryInfo を追加必要があります。矩形からレポートワークシート

名の取得に失敗したり、レポートワークシート名が無効なワークシート名を表している場合、"レポート

ワークシートに移動"コンテキストメニューがグレーアウトします。次のメソッドは QuickCurveStatsTool.h ファイルで宣言されます。

protected:

bool DoOutput(bool bUpdateLastOutput);

BOOL GetReportWorksheet(Worksheet& wksReport);

private:

bool acessBinaryInfo(bool bGet, string& strInfo);

QuickCurveStatsTool.cpp ファイルに上記の 3 つのメソッドを実装します。

bool QuickCurveStatsTool::DoOutput(bool bUpdateLastOutput)

{

Tree trGUI;

GetGUITree(trGUI);

// 出力結果を文字列とツリーノードに取得

Tree tr;

TreeNode trResult;

if( trGUI.output.outputwks.nVal )

trResult = tr.AddNode("Result");

string strResult = getResult(trResult);



// Output to Script window, optional

if( trGUI.output.script.nVal )

{

LT_execute("type -a"); // 閉じていたらスクリプトウィンドウを開く

out_str(strResult);

}

// 任意で結果ログに出力

if( trGUI.output.reslog.nVal )

{

Project.OutStringToResultsLog(strResult);

}

// 任意でワークシートに出力

if( trGUI.output.outputwks.nVal )

{

// 出力ワークシートが存在するかをチェック

Worksheet wks;

string strOutputWks;

bool bCreateNew = true;

if( acessBinaryInfo(true, strOutputWks) )

{

wks.Attach(strOutputWks);

bCreateNew = !wks.IsValid();

}

// 存在しなければ、新しく作成

// ワークシート名を矩形のバイナリストレージに配置

if( bCreateNew )

{

wks.Create(NULL, CREATE_HIDDEN);

wks.SetSize(-1, 0);

wks.GetRangeString(strOutputWks);

acessBinaryInfo(false, strOutputWks);

}

out_tree_to_wks(trResult, wks);

}

return true;

}

BOOL QuickCurveStatsTool::GetReportWorksheet(Worksheet& wksReport)



{

string strWks;

if( acessBinaryInfo(true, strWks) )

{

wksReport.Attach(strWks);

return wksReport.IsValid();

}

return false;

}

bool QuickCurveStatsTool::acessBinaryInfo(bool bGet, string& strInfo)

{

string strStorageName = "Info";

Tree tr;

if( bGet )

{

// 矩形のバイナリストレージから出力ワークシート名を取得

if( m_go.GetBinaryStorage(strStorageName, tr)

&& tr.OutputWks

&& !tr.OutputWks.IsEmpty() )

{

strInfo = tr.OutputWks.strVal;

return true;

}

return false;

}

else

{

// 矩形のバイナリストレージから出力ワークシート名を保存

tr.OutputWks.strVal = strInfo;

return m_go.PutBinaryStorage(strStorageName, tr);

}

}

データプロットを持つグラフをアクティブとして準備し、コマンドウィンドウで "quick_curve_stats -d"を実行し、ROI を追加します。ROI をグラフ上の関心のある場所に移動し、コンテキストメニューを開

き、設定を選び、ダイアログを開きます。計算する量と出力先のブランチにあるすべてのチェックボッ

クスを選択し、OK をクリックしてダイアログを閉じます。コンテキストメニューを再度開き、レポートワー

クシートに移動メニューがグレーアウトしていることに注意してください。新しい出力メニューをクリック

し、結果の文字列がスクリプトウィンドウと結果ログに出力され、非表示のワークシートが作成されます。

17.2 X ファンクションをカスタマイズする


レポートワークシートに移動メニューを選び、レポートワークシートを表示します。ワークシート内の列

が結果を保持します。


17.2.1 製品メニューに X ファンクションを入れる X ファンクションを Origin メニューに入れるには、次の 2 つのステップを行います。

X ファンクションビルダツリービューで基本設定を修正 X ファンクションを指定したメインメニューおよびサブメニューに配置

そして、メニューで、フォーマット：メニュー：フルメニューを選ぶか、Origin を再起動し、すべての Xファンクションの変更を自動スキャンして、新しく追加した X ファンクションをメニューに追加します。

詳細は X ファンクションビルダのドキュメントを参照してください。

ツリービューでのセットアップ X ファンクションをメニュー内で適切に表示するには、X ファンクションビルダ内の次の設定が必要で

す。

X ファンクションビルダで X ファンクションを開くコンテキストの使用ブランチでツリービューモードに切り替えます。メニューでメインメニューを選びます。 Windows チェックボックスをチェックします。ワークシート, グラフ, 行列から 1 つまたはいくつかのウィンドウタイプをチェックします。

メニューをアクセス可能にする X ファンクションがツリービューでセットアップされると、X ファンクションを指定したメニューに配置す

ることができます。Origin は、ユーザの X ファンクションをデフォルトメニューとユーザ定義メニューの 2 種類のメニューからアクセス可能にします。

(デフォルトメニューのメカニズムには制限があります。X ファンクションを指定したファイルフォルダに

置く必要があり、X ファンクション名は指定したプレフィックスを持つ必要があります。また、メニュー内

の位置を制御するのは簡単ではありません。次のメカニズム、ユーザ定義メニューはこれらの問題を

解決します。)



デフォルトメニュー

X ファンクションがユーザファイルフォルダ内の X-Functions フォルダのサブフォルダに適切に保存

されていれば、X ファンクションは指定したデフォルトメニューからアクセスできます。

サブフォルダ内のすべての X ファンクションはメニューに表示されます。

フォルダメニュー

Signal Processing\ 解析：信号処理

Spectroscopy\ 解析：スペクトル分析

Mathematics\ 解析：数学

Statistics\ 統計

サブフォルダ内にあるプレフィックス付きのすべての X ファンクションはメニューに表示されます。

フォルダプレフィックスメニュー

Import and Export\

imp* ファイル：インポート

exp* ファイル：エクスポート

Data Manipulation\

w* ワークシート

col* 列

Database Access\ db* ファイル：データベースアクセス



Miscellaneous, Data Exploration, Utilities フォルダにある X ファンクションは、次のセクションで

説明する処理で、ユーザが直接 XML ファイルを修正しなければ、メニューに表示されません。

ユーザ定義メニュー

X ファンクションをデフォルトメニューに追加することに加え、Origin のインストールフォルダの

Themes¥Menus フォルダにある XML ファイルを編集することで、ユーザは X ファンクションをユー

ザ定義メニューに配置することができます。このフォルダには 2 つの XML ファイルがあります。

ConfMenus.xml は Origin メインメニューを制御するのに使われ、ContextMenus.xml はコンテ

キストメニューを制御するのに使われます。

例

以下は、X-Functions¥OC Guide¥ フォルダにあるすべての X ファンクションを Origin の解析メニ

ュー内の新しいサブメニュー OC Guide Tools に追加する方法を示すサンプルです。ユーザ定義メ

ニューは、解析：フィットと解析：信号処理の間にあります。

X ファンクションビルダで X-Functions¥OC Guide フォルダにある X ファンクションを開きます。ツリ

ービューに切り替え、コンテキストの使用ブランチ内でメニューをメインメニューにセットし、ウィンドウ

チェックボックスにチェックを付け、ウィンドウブランチ内のワークシートにチェックを付けます。

説明編集ボックスに、例えば、"&Custom Dialog"のようにテキストを入力します。&は、キーボード

からのショートカットキーを指定するために使います。保存をクリックして、X ファンクションに変更を保

存し、X ファンクションビルダを閉じます。

XML Marker のような XML エディタで ConfMenus.xml を開きます。

左パネルで wks -> wksAnalysis -> wfit を選択します。

以下をコピーして、<wfit...></wfit>の後の右側パネルに貼り付け、保存をクリックします。

<testmenu1 Label = "OC Guide Tools" popup = "1">

<efg Label = "">

<name>*</name>

<auxopts>2162688.</auxopts>

<catsubcat DataID = "74">OC Guide</catsubcat>

</efg>

</testmenu1>

Origin を閉じ、再起動します。ワークシートをアクティブにし、メニューで解析を選びます。カスタムダ

イアログメニューが表示されます。



17.2.2 X ファンクションにドキュメントを追加するドキュメントは、X ファンクションを完成させるために必要です。ドキュメントでは、X ファンクションの作

成者はユーザに対して、X ファンクションの使い方や組み込み方などの情報を通知することができま

す。

現在、4 つの言語でドキュメントを記述することができます。英語、日本語、ドイツ語、中国語を X ファ

ンクションの中に組み込むことができます。次の 2 つの X ファンクションを使って、このような処理を

行うことができます。xf2doc および doc2xf.これらの 2 つの X ファンクションはメニューには存在せ

ず、スクリプトからのみアクセスできます。X ファンクション xf2doc は、oxf ファイルからヘルプ情報を

取り出し、指定したパスに Microsoft Word® 文書を作成します (ダイアログまたはスクリプト xf2doc chm:=1 で、オプション chm にチェックに付けると、chm ヘルプと同じ構造を持つドキュメントが生成

されます。これは、ヘルプをプレビューする必要がある場合に役立ちます。)。そして、ドキュメントは

Microsoft Word で編集できます®。ドキュメントが完成したら、ドキュメントを保存し、X ファンクション

doc2xf を使って、ドキュメントを oxf ファイルに組み込みます。

仕様に合った X ファンクションに対するドキュメントが完成し、互換性、スムーズさ、堅牢さを持って実

行できるようになると、X ファンクションの完成となります。これで、oxf ファイルを使って簡単に他の人

と X ファンクションを共有できます。

17.2.3 ダイアログにカスタムボタンを追加する

ダイアログにカスタムボタンを追加する次のサンプルは、2 つのカスタムボタン、リセットボタンと適用ボタンを X ファンクションダイアログに追

加し、どのボタンがクリックされたかを識別する event1 関数を追加する方法を示しています。

F10 キーを押し、X ファンクションビルダを開きます。X ファンクション編集ボックスに X ファンクション

名として"CustomButton"を入力します。



ボタンをクリックし、ツリービューパネルに切り替え、GetN ダイアログカスタムボタン編集ボックス

に "Reset|Apply"と入力します。保存をクリックして、この X ファンクションを実行します。

X ファンクションコードビルダを開き、CustomButton_event1 関数に次のコードを入力し、

ボタンをクリックします。

if( nEventID == GETNE_ON_CUSTOM_BUTTON1 )

{

out_str("Reset click");

}

if( nEventID == GETNE_ON_APPLY )

{

out_str("Apply click");

}

if( nEventID == GETNE_ON_OK )

{

out_str("OK click");

}

コマンドウィンドウに CustomButton -d と入力し、この X ファンクションイアログボックスを開きます。

4 つのボタンがあります。リセット, 適用, OK, キャンセル

リセットボタンをクリックすると、"Reset click"がコマンドウィンドウに出力されます。適用ボタンをクリッ

クすると、"Apply click"が出力され、キャンセルボタンが閉じるボタンに変わります。OK をクリックす

ると、"OK click"が出力され、ダイアログが閉じます。

グラフプレビューGetN ダイアログのプレビューボタンを表示する X ファンクションフレームワークは、グラフプレビューGetN ダイアログボックスでプレビュー表示ボタ

ンおよび自動プレビューチェックボックスをサポートしています。これらの 2 つのコントロールは、プレ

ビューを自動(自動プレビューチェックボックスにチェック)または手動(プレビューボタンをクリック)で更新するのに使われます。次のステップは、2 つのコントロールを追加する方法を説明しています。

次の 5 つのステップは、プレビューボタンコントロールを追加する処理を説明するものです。

F10 キーを押し、X ファンクションビルダを開きます。X ファンクション編集ボックスに X ファンクション

名として"PreviewButtons"を入力します。

変数テーブルに、以下のように変数をセットアップし、保存ボタンをクリックしてこの X ファンクションを

保存します。



名前: gp

ラベル:Graph

入力/出力:Input

データタイプ: string

コントロール:...Graph

コマンド PreviewButtons -d を実行し、この X ファンクションダイアログを開きます。OK とキャンセ

ルの 2 つのボタンがあります。キャンセルをクリックして、ダイアログを閉じます。

X ファンクションビルダで、ボタンをクリックして、ツリービューパネルに切り替え、コンテキストの

使用 -> メニュー -> 自動 GetN ダイアログをプレビュー付きの GetNGraphBox にし、プレビューボ

タンを表示チェックボックスにチェックします。この X ファンクションを保存します。

コマンド PreviewButtons -d を実行し、ダイアログを再び開きます。ダイアログに、さらに自動プレビ

ューチェックボックスとプレビューボタンの 2 つのコントロールが加わりました。

下記のステップは、 gp 変数の選択に従って、ダイアログのプレビューグラフを自動更新する方法を

示します。グラフプレビュー付きの GetN ダイアログについての詳細は、X ファンクション：X ファンク

ションを作成する：グラフプレビュー付きの GetN ダイアログボックスを作成するを参照してください。

コードビルダで X ファンクションを開き、次のコードをコピーして、それを

GetNGraphPreview_OnChange 関数に貼り付けます。

//グラフを更新する GetNGraphPreview_OnUpdateGraph を呼ぶビットを含む

if( !(dwUpdateGraph & UPDATE_GRAPH_CHANGED) )

dwUpdateGraph |= UPDATE_GRAPH_CHANGED;

下記コードを GetNGraphPreview_OnUpdateGraph 関数にコピーします。

string strGraph = trGetN.gp.strVal;

GraphPage gpSource(strGraph);

GraphPage gpDest(pgTemp);

page_clone(gpSource, gpDest);

ボタンをクリックします。コマンドウィンドウで PreviewButtons -d を実行し、ダイ

アログボックスを開きます。

ダイアログで、グラフページ名をグラフコントロールに入力するかボタンをクリックして、グラフブラ

ウザダイアログ経由で 1 つのグラフを選択します。自動プレビューチェックボックスまたはプレビュー

ボタンをクリックし、指定したグラフがプレビューパネルに表示されます。次の図をご覧下さい。

17.3 X ファンクションを使う



17.3.1 スクリプトから X ファンクションを呼び出す X ファンクションは、デフォルトで LabTalk から呼び出すことができます。これは、デフォルトで、コマ

ンドウィンドウ、スクリプトウィンドウなど LabTalk スクリプトを実行できる場所ならどこでも X ファンクシ

ョンを呼び出すことができるということです。これは OGS ファイル、ツールバーボタンなどが含まれま

す。

X ファンクションに対して LabTalk の設定を変更するには、以下のように変更することができます。

X ファンクションビルダで X ファンクションを開きます。

ツールメニューからツリビューの表示を選ぶか、ツリービュー表示のツールバーボタンをクリックして、

ツリービューをアクティブにします。

使用のコンテキストを開き、LabTalk 設定を開きます。

チェックボックスにチェックを付けると、LabTalk から X ファンクションを使うことができます。

X ファンクションを呼びその変数ダイアログを表示する

X ファンクションに -dialog または -d オプションを渡し、X ファンクションの変数ダイアログを開きます。

このダイアログは、ダイアログのインターフェースを使って変数をセットすることができます。

次は、デフォルト値で X ファンクション smooth の変数ダイアログを開きます。

smooth -d;



コマンドラインでいくつかの変数をセットでき、変数ダイアログを開いたままになります。コマンドライン

でセットされない変数はデフォルト値が使われます。

smooth (1,2) method:=2 -d;

X ファンクションを呼びその変数ダイアログを表示しない

変数ダイアログは変数をセットする必要はありません。すべての変数はコマンドラインでセットすること

ができます。コマンドラインでセットされない変数はデフォルト値が使われます。

以下は、X ファンクション smooth を呼び出し、5 点のウィンドウと境界条件を反射にして、Savitzky-Golay 法で列 1 と列 2 のデータをスムージングします。

smooth (2) npts:=5 method:=SG b:=1

変数の割り当ては、複数の方法で行うことができます。

変数インデックスによる方法変数名無しで値を割り当てます。例えば、(1,2) はアクティブなワークシ

ートの列 1 と列 2 のデータを iy 変数に割り当てます。iy は初の変数です。

デフォルト値を使用します。デフォルト値を使用するには割り当ては不要です。ここで、weight 変数

に値を割り当てない場合、デフォルト値は 0 です。

変数の完全な名前による方法例えば、npts:=5 は、npts 変数に数値 5 を割り当て、method:=SGは、method 変数に増加する値を割り当てます。

変数の初の文字による例えば、b:=1.この使用方法はとても簡単で、長い変数名を覚えておく必要

がありません。しかし、変数の初の文字が固有になるようにする必要があります。

X ファンクションを呼びテーマで変数をセットする

X ファンクションへの変数の設定はテーマに保存することができます。X ファンクションを呼び、-theme または -t オプションを使って保存したテーマを使うことができます。

smooth (1,2) -t mytheme; // smooth を呼び、 'mytheme' テーマを使用 smooth -t mytheme -d; // ダイアログを開き、'mytheme' テーマをロード

詳細については、Origin ヘルプの X ファンクション:スクリプトから X ファンクションにアクセスするの

章をご覧ください。

17.3.2 Origin C で X ファンクションを呼び出す Origin はさまざまな操作を実行する数多くの X ファンクションを提供しています。X ファンクションは、

LabTalk と Origin の両方から呼び出すことができます。このセクションでは、Origin C の XFBase



クラスを使って、Origin C から X ファンクションを呼び出す方法を示しています。このメカニズムは、

またある X ファンクションから別の X ファンクションを呼び出すのに使うことができます。

XFBase クラスは、Origin C の System フォルダにある XFBase.h ヘッダファイルで宣言されます。

XFBase.h ヘッダファイルは、Origin.h ヘッダファイルには含まれておらず、XFBase クラスを使用

する Origin C ファイル内で別に含める必要があります。

#include <origin.h>

Origin C から X ファンクション impFile を呼び出す次の Origin C コードは、Origin にファイルをインポートする一般的な関数を定義します。関数は 2つの引数、データファイル名とインポートフィルタファイル名、を取ります。初に関数は、XFBase ク

ラスのインスタンスを作成し、呼び出される X ファンクションの名前で構築されます。この場合、X ファ

ンクションの名前は impFile です。そして、SetArg メソッドを使って、X ファンクションの引数をセット

し、後に Evaluate メソッドを使って X ファンクションを呼び出します。

bool call_impFile_XF(LPCSTR lpcszDataFile, LPCSTR lpcszFilterFile) { string strDataFile = lpcszDataFile; string strFilterFile = lpcszFilterFile; // X ファンクションの名前を使って XFBase のインスタンスを作成 XFBase xf("impFile"); if (!xf) return false; // 'fname'引数をセット if (!xf.SetArg("fname", strDataFile)) return false; // 'filtername'引数をセット if (!xf.SetArg("filtername", strFilterFile)) return false; // X ファンクションを実行する XFBase の Evaluate メソッドを呼び出す if (!xf.Evaluate()) return false; return true; }

次の Origin C コードは、上記で定義した call_impFile_XF 関数を呼び出す方法を示します。イメ

ージファイルをインポートするのにそれを呼び出します。

// Origin のサンプルフォルダにある Car ビットマップをインポート string strImageFile = GetAppPath(TRUE) + "Samples¥¥Image Processing and Analysis¥¥Car.bmp"; // Image インポートフィルタを使ってビットマップをインポート string strFilterFile = GetAppPath(TRUE) + "Filters¥¥Image.oif";

17.4 X ファンクションのサンプル


// X ファンクション impFile を呼ぶ一般的な関数を呼び出す call_impFile_XF(strImageFile, strFilterFile);


17.4.1 X ファンクション GUI のコントロールを構築する

サマリーこのサンプルは、TreeNode 変数で X ファンクション GetN ダイアログ内にコントロールを作成する

方法を示しています。このメカニズムは、複数の変数によってコントロールが追加されるのを避けるの

に使われます。これは、サンプルの X ファンクションダイアログです。



学習する項目

make_tree で異なるコントロールを作成する方法指定したコントロールイベントで GUI を更新する方法有効な入力をチェックし、尋ねる方法

ステップツール：X ファンクションビルダを選び、X ファンクションダイアログを開き、ファイル：新しい X ファン

クションウィザードを選択して、TreeNode 型の GUI という名前の入力変数のみを持つ X ファンクシ

ョンを作成し、gui_controls.oxf として保存します。

コードビルダで X ファンクションを開き、次のコードを gui_controls_make_tree 関数に追加します。

if ( strcmp("GUI", lpcszVarName) == 0 ) // 名前で変数をチェック

{

// ID は固有

int nBranchID = 0x0001;

int nUserID = GET_USER_DATAID(0); //テーマのサポートを有効にする NodeID

GETN_USE(tr) //このノードを現在のノードとして使用

//ブランチの開始

GETN_BEGIN_BRANCH(UserInfo, "User Information") GETN_ID(nBranchID++)

// 文字列編集ボックス

GETN_STR(UserName, "Name", "Unknown") GETN_ID(nUserID++)

// パスワード編集ボックス

GETN_PASSWORD(Password, "Password", "") GETN_ID(nUserID++)

GETN_END_BRANCH(UserInfo) //end of sub branch

//サブブランチの開始

GETN_BEGIN_BRANCH(Detail, "Details") GETN_ID(nBranchID++)

// 編集可能なドロップダウンリスト

GETN_STRLIST(Language, "Language", "English", "|English|German")

GETN_ID(nUserID++)

// ラジオボタン

GETN_BEGIN_BRANCH(lGender, "Gender") GETN_ID(nBranchID++)

GETN_RADIO_INDEX(Gender, 0, "Male|Female")



GETN_ID(nUserID++)

// ラジオボタンのフォーマット

GETN_OPTION_DISPLAY_FORMAT(DISPLAY_EDITOR_LEFT)

GETN_END_BRANCH(lGender)

//数値編集ボックス、年は整数で、"%d"フォーマットを使用

GETN_NUM(Age, "Age", 18) GETN_OPTION_NUM_FORMAT("%d")

GETN_ID(nUserID++)

//イベントハンドリングを持つチェックボックス

GETN_CHECK(iEmail, "Have Email", 0) GETN_ID(nUserID++)//チェックボック

ス

GETN_OPTION_EVENT(_show_email) //Email チェックボックスのイベント

// 文字列編集ボックス

GETN_STR(Email, "Email", "") GETN_ID(nUserID++)

GETN_END_BRANCH(Detail) //サブブランチの終了

}

//put your own support static functions here と書かれた行の下に次のイベントハンドリング関数

を追加します。

static bool _show_email(TreeNode& tr, int nRow, int nType, Dialog& Dlg)

{

TreeNode trDetail = tr.GUI.Detail;

if ( !trDetail )

return false;

int nShow = trDetail.iEmail.nVal;

//チェックで表示、それ以外は非表示

trDetail.Email.Show = (nShow == 1);

return true;

}

static bool _check_email(LPCSTR lpcszEmail)

{

string strEmail(lpcszEmail);

if ( strEmail.Count('@') != 1 )

return false; // '@'と 1 だけを含む

int nSep = strEmail.Find('@');

string strLeft = strEmail.Left(nSep);

string strRight = strEmail.Right(strEmail.GetLength() - nSep - 1);

if ( strLeft.GetLength() == 0 )



return false;

if ( strRight.GetLength() == 0 )

return false;

LPCSTR lpcszInvalid = "~!#$%^&*()+ -=|¥¥/><,`";

if ( strEmail.FindOneOf(lpcszInvalid) >= 0 )

return false;

return true;

}

エラーチェックのコードを gui_controls_event1 関数に追加します。

if ( strcmp(lpcszNodeName, "Email") == 0 )

{

string strVal = trGetN.GUI.Detail.Email.strVal;

if ( !_check_email(strVal) )

{

strErrMsg = "Invalid Email Address!Please correct it";

//OK ボタンを無効にして、エラー時には続行しない

bOKEnable = false;

}

}

戻り値を return false (デフォルト) から return true に変更し、強制的に GUI を変更します。

X ファンクションの本体で、ツリー形式でユーザ設定を出力します。コンパイルボタン

をクリックし、コンパイルして変更を保存します。

out_tree(GUI);

X ファンクションを実行するスクリプトウィンドウで gui_controls -d コマンドを実行します。

ダイアログの Have Email チェックボックスをクリックし、email 編集ボックスを表示します。

例えば abc のような無効な email アドレスを email 編集ボックスに入力すると、エラーメッセージが

ダイアログボックスの下部に表示され、OK ボタンが無効になります。

OK をクリックします。設定ツリーはスクリプトウィンドウに出力されます。



17.4.2 Ｘファンクションでグラフブラウザダイアログを開く

サマリーこのサンプルは、X ファンクションの GetN ダイアログでグラフを指定するグラフブラウザダイアログ

を開くボタンを追加し、フィルタ関数でグラフブラウザダイアログをカスタマイズする方法を示していま

す。

学習する項目 X ファンクションダイアログでグラフブラウザを開くボタンを追加する方法

フィルタ関数でグラフブラウザダイアログをカスタマイズする方法

ステップ次の 3 つのステップは、X ファンクションダイアログで、フィルタ関数を使用しないグラフブラウザダイ

アログを開くボタンを追加する方法を示しています。これは、も簡単な処理で、グラフブラウザのす

べての設定がデフォルトにセットされます。

メニューからツール：X ファンクションビルダ-を選択します。以下のように、X ファンクション GraphFilterTest を作成します。

制御文字列は ...Graph GraphBrowserFilter です。



X ファンクションの編集をするためコードビルダツールバーボタンをクリックし、メイン関数 GraphFilterTest に out_str(pages); を入力します。コンパイルボタンをクリックし、ダイアログに戻

るをクリックします。

OXF ファイルを保存するツールバーボタンをクリックします。コマンドウィンドウで GraphFilterTest -d を実行し、ダイアログが現れたら、参照ボタンをクリックし、グラフを選択し、OK をクリックしてダイ

アログを閉じます。選択したグラフウィンドウの名前は、コマンドウィンドウに出力されます。

グラフブラウザダイアログをカスタマイズしたくない場合、以下を続ける必要はありません。以下のステ

ップは、例えばデフォルトビューモードをツリービューにセットするなど、すべてグラフブラウザダイア

ログをカスタマイズする方法です。GraphFilter.c ファイルを作成し、<Origin インストールフォルダ>¥OriginC¥OriginLab に保存します。ソースファイルは以下のコードを含みます。

#include <..¥Originlab¥GraphFilter.h> // これは Origin の組み込みファイル

int GraphBrowserFilter(int nMsg, Page& pg = NULL)

{

switch(nMsg)

{

case GBFM_IS_USE_PAGE:// True に対して 1 を返す

if(!pg)

return -1;

// 複数レイヤを含むフィルタページ

return pg.Layers.Count() > 1?0 :1;

case GBFM_SHOW_EMBED_PAGE_CHKBOX:

// GraphFilter.h の別のオプションを参照

return EMBED_CHECKBOX_ENABLE;

case GBFM_SHOW_SWITCH_MODE:

// GraphFilter.h の別のオプションを参照

return VIEW_MODE_BOTH_WITH_TREE_DEFAULT;

case GBFM_SORT_PAGES:

return 1; // 0 または 1 を返す

}

return -1; // エラー

}

MyGraphFilter.h というヘッダーファイルを作成し、それを<Origin インストールフォルダ>¥OriginC¥OriginLab に保存します。

X ファンクションビルダでこの X ファンクションを開き、コードビルダボタンで X ファンクションを編集ボタンをクリックし、上記から新しく作成したヘッダファイルを含めます。MyGraphFilter.c および



MyGraphFilter.h は、別のフォルダに配置できますが、それぞれが同じフォルダ内に存在する必

要があります。それらが別のフォルダにある場合、次のようにヘッダファイルをインクルードするのに

絶対パスを使用する必要があります。

//Case 1. ヘッダファイルが OriginC¥Originlab¥ フォルダにある場合

//追加のインクルードファイルをここに記述

#include <..¥Originlab¥MyGraphFilter.h>

//Case 2. ヘッダファイルが OriginC¥Originlab¥ フォルダにない場合

//追加のインクルードファイルをここに記述

#include "D:¥MyFolder¥MyGraphFilter.h"

コマンドウィンドウで、GraphFilterTest -d を実行し、GraphFilterTest ダイアログで参照ボタンを

クリックします。埋め込みグラフを表示するチェックボックスが有効で、これが選択されているので、埋

め込みグラフがツリービューに一覧表示されます。

コードビルダで、<Origin インストールフォルダ>¥OriginC¥Originlab¥ から GraphFilter.c を開

きます。GBFM_SHOW_EMBED_PAGE_CHKBOX に対して、戻り値を

EMBED_CHECKBOX_ENABLE から

EMBED_CHECKBOX_DISABLE_EMBEDDING_PAGE_NEVER_ENABLE に変更します。

コンパイルボタンをクリックし、GraphFilter.c を保存します。そして、再び、コマンドウィンドウで GraphFilterTest -d を実行します。今度は埋め込みグラフを表示するチェックボックスが無効で、

選択されておらず、埋め込みグラフがツリービューに一覧表示されていません。



MyGraphFilter.c の他の場合に対しても、戻り値として <Origin インストールフォルダ>¥OriginC¥Originlab¥GraphFilter.h の他の値を使うことができます。それぞれを変更したら、

忘れずに MyGraphFilter.c をコンパイルしてください。

グラフブラウザを含む組込みの X ファンクション(インポートとエクスポートの X ファンクション expGraph) も同じ方法でカスタマイズすることができます。

17.4.3 X ファンクション ReportTree サンプル

サマリーこのサンプルでは、ワークシート内の選択したデータに統計処理を行う方法を示し、新しい階層シー

トにレポートを生成します。選択したデータは、ワークシート内の 1 列、複数列、選択範囲にすること

ができます。

出力のデータ型は ReportTree なので、ダイアログには再計算リストボックスがあり、これはレポート

シートの再計算モードを「手動」、「自動」、「なし」に設定できます。

学習する項目

選択したデータ範囲からデータを取得する方法 event1, before_execute, メイン関数でのエラー処理の方法再計算の錠前アイコンを持つ階層シートのレポートテーブルを生成する方法



ステップ F10 キーを押し、X ファンクションビルダを開き、下図のように X ファンクション名と変数を入力し、保

存ボタンをクリックします。

コードビルダでこの X ファンクションを開き、ソースコードを編集します。初に必要なヘッダファイル

を下記のようにインクルードします。

#include <ReportTree.h> // ReportTable クラスで必要

StatsReport_event1 にエラーチェックコードを追加し、入力データ範囲を次のようにチェックします。

DataRange drInput;

drInput.Create(trGetN.iy.strVal);

// 入力が無効なら、ダイアログの下部に

// エラーメッセージを表示し

// OK ボタンを無効にする

if ( !drInput.IsValid() || drInput.GetNumRanges() < 1 )

{

strErrMsg = "Please select valid data for input";

bOKEnable = false;

}

StatsReport_before_execute にエラーチェックコードを追加します。

DataRange drInput;



drInput.Create(trGetN.iy.strVal);

// 入力が無効なら、エラーメッセージを出力し

// X ファンクションの実行を中止

if ( !drInput.IsValid() || drInput.GetNumRanges() < 1 )

{

out_str("Invalid Input Data");

nRet = XFEVT_ABORT;

}

スタティック関数を追加し、 //put your own support static functions here の行の後で入力範囲

をチェックします。

static bool _check_input(const Range& iy)

{

int nRanges;

if ( !iy.IsValid() )

return false;

nRanges = iy.GetNumData(DRR_COLUMN_INDEX |

DRR_NO_FACTORS);

if ( nRanges <= 0 )

return false;

return true;

}

スタティック関数の下に必要なマクロを追加します。マクロは、X ファンクションのメイン関数で使われ

ます。

// ID はどの値にでもすることができますが、固有の値にします。

#define TABLE_ID_BEGIN 0x1000

#define ROW_ID_BEGIN 0x0001

X ファンクションのメイン関数, StatsReport, に次のコードを追加して、指定したデータ範囲からデー

タを取得し、統計処理を実行し、レポートシートを生成します。

if ( !_check_input(iy) )

{

// 入力が無効な場合

// エラーメッセージを表示し



// X ファンクションの実行を中止

XF_THROW("Invalid input data");

return;

}

//統計サマリーを表示するテーブルを作成

ReportTable rt = report.CreateTable("Summary",_L("Summary"),

TABLE_ID_BEGIN);

//レポートテーブルの列ヘッダ

const vector<string> vsColLabels = {

"N",

"Number of Missing",

"Mean",

"SD",

"SEM",

"Sum",

"Variance"

};

int nRowID = ROW_ID_BEGIN;

int nRanges = iy.GetNumData(DRR_COLUMN_INDEX |

DRR_NO_FACTORS);

for ( int nRange = 0; nRange < nRanges; nRange++ )

{

// 部分範囲- 一列を取得

DataRange drOne;

iy.GetSubRange(drOne, DRR_COLUMN_INDEX |

DRR_NO_FACTORS, nRange);

// [Book1]Sheet1!A のような範囲文字列を取得

string strDataLabel;

drOne.GetRangeString(strDataLabel);

vector vInput;

drOne.GetData(&vInput, 0);

if ( vInput.GetSize() == 0 )

{

// 列が空のときに警告メッセージを出力し

// 次の列に移動

warning_msg_box(

strDataLabel + ", empty column found.",



false, 'W');

continue;

}

int N, Missing;

double dMean, dSum, dVariance, dSD, dSE;

int nRet = ocmath_basic_summary_stats(vInput.GetSize(),

vInput,

&N, &dMean, &dSD, &dSE, &dVariance, &dSum,

NULL, NULL, NULL, NULL, NULL, NULL, &Missing);

if ( STATS_NO_ERROR != nRet )

{

// 統計関数が失敗したら

// 警告メッセージを出力

warning_msg_box(

strDataLabel + ", statistics fails.",

false, 'W');

continue;

}

vector vResults(vsColLabels.GetSize());

vResults[0] = N;

vResults[1] = Missing;

vResults[2] = dMean;

vResults[3] = dSD;

vResults[4] = dSE;

vResults[5] = dSum;

vResults[6] = dVariance;

//新しい行をレポートテーブルに追加

string strName = "Data" + nRange;

rt.AddRow(strName, vResults, strDataLabel,

vsColLabels, NULL, nRowID++);

}



X ファンクションを実行するいくつかのデータを持つワークシートをアクティブにしたまま、2 列を選択し、スクリプトウィンドウに StatsReport -d と入力し、X ファンクションダイアログを開きます。

OK をクリックすると、新しい結果シートが生成されます。

17.4.4 X ファンクション ReportData サンプル

サマリーこのサンプルは、複数の XY データセットを取得し、各 XY に対して線形フィットを行い、フィットデー

タを新しい結果シートに配置します。



出力のデータ型は ReportTree なので、ダイアログには再計算リストボックスがあり、これはレポート

シートの再計算モードを「手動」、「自動」、「なし」に設定できます。

学習する項目複数 XY データセットを操作する方法

再計算を保護して新しい結果シートにデータを出力する方法

ステップ F10 キーを押し、X ファンクションビルダを開き、下図のように X ファンクション名と変数を入力し、保

存ボタンをクリックします。

コードビルダでこの X ファンクションを開き、ソースコードを編集します。初に必要なヘッダファイル

を下記のようにインクルードします。

#include <ReportTree.h> // ReportTable クラスで必要

//put your own support static functions here と書かれた行の下に必要なマクロ

を追加します。マクロは、X ファンクションのメイン関数で使われます。

// ID はどの値にでもすることができますが、固有の値にします。

#define TABLE_ID 1

#define SUBNODE_ID_BEGIN 1000

X ファンクションのメイン関数, FitLinearReport, に次のコードを追加して、指定したデータ範囲か

ら XY データを取得し、各 XY に線形フィットを実行し、レポートシートを生成します。



// レポートテーブルの作成

ReportTable rt;

rt = rd.CreateTable("ReportData", "Fitted Data", TABLE_ID);

int nSubID = SUBNODE_ID_BEGIN;

DWORD dwRules = DRR_GET_DEPENDENT | DRR_NO_FACTORS;

int nNumData = iy.GetNumData(dwRules);

for(int nRange = 0; nRange < nNumData; nRange++)

{

DataRange drOne;

iy.GetSubRange(drOne, dwRules, nRange);

vector vx, vy;

drOne.GetData(dwRules, 0, NULL, NULL, &vy, &vx);

// 線形フィットに 2 つのパラメータ

FitParameter sFitParameter[2];

if( STATS_NO_ERROR == ocmath_linear_fit(vx, vy,

vy.GetSize(), sFitParameter) )

{

// フィットした X データをレポートテーブルに追加

string strName = "X" + (nRange+1);

string strLongName = "X";

rt.AddColumn(vx, strName, nSubID++, strLongName,

OKDATAOBJ_DESIGNATION_X);

// フィットした Y データを計算

double dIntercept = sFitParameter[0].Value;

double dSlope = sFitParameter[1].Value;

vector vFitY;

vFitY = vx * dSlope + dIntercept;

// フィットした Y データをレポートテーブルに追加

strName = "Y" + (nRange+1);

string strRange;

strRange = drOne.GetDescription(GETLC_COL_LN_ONLY);

strLongName = "Fitted data on " + strRange;

rt.AddColumn(vFitY, strName, nSubID++, strLongName,

OKDATAOBJ_DESIGNATION_Y);

}

}



X ファンクションを実行する Origin インストールパス¥Samples¥Curve Fitting から Linear Fit.dat ファイルをワークシートに

インポートします。

すべての列を選択し、スクリプトウィンドウで FitLinearReport -d を実行すると、下図のようなダイア

ログが現れます。

設定はデフォルトのままにして、OK ボタンをクリックします。レポートシートは 3 グループの XY デー

タセットで生成されます。

283

1188 外部リソースへのアクセス Origin C は外部 DLL にアクセスすることができ、さらにオートメーション(COM)サーバの機能を使

って、Origin 以外のアプリケーションにアクセスすることもできます。

18.1 外部 DLL にアクセスする Origin C 関数は、C、C++、Fortran コンパイラで作成した外部 DLL の関数を呼び出すことができ

ます。これを行うには、ヘッダファイルの関数のプロトタイプを提供し、DLL ファイルに関数本体が含

まれていることを Origin C に通知する必要があります。関数は、myFunc.h というヘッダファイルで

宣言されているものとします。次のようにこれらの関数を呼び出したい場所で Origin C ファイルにこ

のファイルをインクルードします。

#include <myFunc.h> //¥OriginC¥System フォルダ内 #include "myFunc.h" //Origin C コードと同じフォルダ内 #include "C:¥myFile.h" //特定のパス

それから、Origin C に関数本体をリンクする場所を通知し、ヘッダーファイル myFunc.h 内の外部

DLL を呼び出す直前に次の Origin C pragma ディレクティブを含めます。DLL ファイルは

UserFunc.dll とします。

#pragma dll(UserFunc) //Origin C コードと同じフォルダ内 #pragma dll(C:¥UserFunc) //特定のパス #pragma dll(UserFunc, header) //h ファイルと同じフォルダ内 #pragma dll(UserFunc, system) //Windows システムフォルダ内

Origin C コンパイラは次の 3 つの呼び出し方法をサポートしています。__cdecl(デフォルト), __stdcall , __fastcall.これらの呼び出し方法は、引数がスタックに渡される順番を決定するだけで

なく、呼び出している関数または呼び出された外部関数がスタックから引数を除去します。

Note: ファイル名に dll という拡張子を含める必要はありません。pragma ディレクティブの後のすべ

ての関数宣言は、外部または特定の DLL からであると考えられます。この前提は、2 番目の

#pragma dll(filename) ディレクティブが現れるか、ファイルの後まで続きます。

外部 DLL にアクセスする方法のサンプルは、Accessing SQLite Database です。Origin C で C DLL または Fortran DLL からの関数の呼び出し方法を示すサンプルプロジェクトがあります。これ

らは Origin のサブフォルダ ¥Samples¥Origin C Examples¥Programming Guide¥Calling Fortran および ¥Samples¥Origin C Examples¥Programming Guide¥Calling C DLL にあ

ります。

18.2 外部アプリケーションにアクセスする

284 外部リソースへのアクセス

18.2 外部アプリケーションにアクセスする COM(Microsoft Component Object Model)は、アプリケーションがバイナリソフトウェアコンポーネ

ントから構築されるソフトウェアアーキテクチャで、ソフトウェアの開発がより簡単で効率よく行うことが

できます。

Origin は、COM クライアントプログラミングの機能を提供しており、OriginPro でのみサポートされ

ています。このメカニズムは、すべての COM(オートメーションサーバ)オブジェクトを表すオブジェク

トタイプを使用します。すべての COM オブジェクトは 2 つの方法で初期化することができます。

//CreateObject メソッドによる Object oExcel; oExcel = CreateObject("Excel.Application"); //既存の COM オブジェクトからの初期化による Object oWorkBooks; oWorkBooks = oExcel.Workbooks;

Origin C は、また Matlab にアクセスするクラスも提供しており、これを使って Origin と Matlab 間

の通信を可能にします。

#include <Origin.h> #include <externApps.h> //MATLAB クラスに必要なヘッダ void test_Matlab() { Matlab matlabObj(true); if(!matlabObj) { out_str("No MATLAB found"); return; } //ma という 3x5 の行列を定義 string strRet; strRet = matlabObj.Execute("ma=[1 2 3 4 5; 4 5 6 7 8;10.3 4.5 -4.7 -23.2 -6.7]"); out_str(strRet);//MATLAB から str を表示 // 行列を Origin 行列に配置 MatrixLayer matLayer; matLayer.Create(); Matrix mao(matLayer); //MATLAB の行列(ma)を Origin の mao 行列に変換 BOOL bRet = matlabObj.GetMatrix("ma", &mao); }

Origin C での COM クライアントプログラミングは、MS Office アプリケーションとデータのやりとりを

行うのに使うことができます。Excel ワークシートからデータを読み、Origin でグラフを作成し、それ

を Word 文書に配置するサンプルコードがあります。このサンプルは、Origin の¥Samples¥COM Client¥MS Office サブフォルダにあります。

18.2 外部アプリケーションにアクセスする

外部リソースへのアクセス 285

(Origin C の COM プログラミングは、ADO(ActiveX Data Object)にアクセスしてデータベースと

接続するのに使用することができ、SQL と ACCESS データベースをワークシートにインポートし、デ

ータの修正を行った後データベースに戻すサンプルファイルがあります。詳細は、Origin の

Samples\COM Clients\ADO サブフォルダの ADOSample.c ファイルをご覧ください。

287

1199 リファレンス

19.1 クラスの階層次の図は、組込みの Origin C クラスの階層を示しています。

19.1 クラスの階層


19.1 クラスの階層

リファレンス 289

19.2 コレクション


19.2 コレクション Collection クラスは、同じ型の複数のオブジェクトを保持するテンプレートを提供します。Origin Cでは、Collection のインスタンスは読み取り専用です。コレクションに項目を追加したり、削除するこ

とはできません。

コレクションのインスタンスであるデータメンバを含む Origin C クラスは数多くあります。例えば、

Project クラスは WorksheetPages という名前のデータメンバを含みます。WorksheetPages デー

タメンバは、プロジェクト内の既存の WorksheetPage オブジェクトすべてのコレクションです。

下表は、コレクションとコレクション内の項目タイプを含むクラスに沿って Origin C のコレクションの

すべてを一覧表示しています。

クラスデータメンバーコレクション

Folder Pages PageBase

Folder SubFolders Folder

GraphLayer DataPlots DataPlot

GraphLayer StyleHolders StyleHolder

GraphPage Layers GraphLayer

Layer GraphObjects GraphObject

MatrixLayer MatrixObjects MatrixObject

Page Layers Layer

19.2 コレクション


Project DatasetNames string (loose and displayed datasets)

Project GraphPages GraphPage

Project LayoutPages LayoutPage

Project LooseDatasetNames string (loose datasets)

Project MatrixPages MatrixPage

Project Notes Note

Project Pages PageBase

Project WorksheetPages WorksheetPage

Selection Objects OriginObject

TreeNode Children TreeNode

Worksheet Columns Column

Worksheet EmbeddedPages Page

サンプル

現在のプロジェクト内のすべてのグラフページを一覧表示する

foreach(GraphPage gp in Project.GraphPages) {

19.3 X ファンクションのオプション文字列


out_str(gp.GetName()); }

現在のプロジェクト内のすべてのワークシートページを一覧表示する

foreach(WorksheetPage wksPage in Project.WorksheetPages) { out_str(wksPage.GetName()); }

現在のプロジェクト内のすべての行列ページを一覧表示する

foreach(MatrixPage matPage in Project.MatrixPages) { out_str(matPage.GetName()); }

すべてのデータプロットを一覧表示する

GraphLayer gl = Project.ActiveLayer(); foreach(DataPlot dp in gl.DataPlots) { string strRange; dp.GetRangeString(strRange, NTYPE_BOOKSHEET_XY_RANGE); printf("%d, %s", dp.GetIndex()+1, strRange); }


19.3.1 A - 再計算モード再計算オプションは、X ファンクションの再計算モードを制御します。デフォルトで、X ファンクション

は、XYRange, XYZRange, vector, Column, matrix, MatrixObject の Origin オブジェクトタイ

プの 1 つが入力または出力変数として含まれるとき、再計算モードとして、手動, 自動, なしを使うこ

とができます(デフォルトモードは手動)。変数が、入力と出力の両方で使われると、再計算モードは

禁止され、再計算コンボボックスは非表示になります。

A:0x00 X ファンクションダイアログから再計算コンボボックスを批評にします。

例



次の図で示されるように、名前と変数を持つ新しい X ファンクションを作成します。そして、保存ボタ

ンをクリックし、<ユーザファイルフォルダ>¥X-Functions¥OC Guide¥ に X ファンクションを保

存します(フォルダが存在しない場合、作成します。)

コマンドウィンドウで、コマンド OptionStringA -d; でこの X ファンクションを実行します。開いたダイ

アログで、再計算コンボボックスは表示されません。

A:0x01 デフォルトの再計算モードをなしにセットします。このモードは、入力変数と出力変数の両方に対して

利用できます。

例






コマンドウィンドウで、コマンド OptionStringA1 -d; でこの X ファンクションを実行します。開いたダ

イアログボックスで、再計算コンボボックスはなしが選択されています。

A:0x02 再計算モードで出力列に対してソートします。出力変数のみに対して動作します。

例






1 列を持つ新しいワークシートを作成し、この列に行番号を入力します。列を選択し、コマンドウィンド

ウで X ファンクション OptionStringA2 -d; を実行します。OK ボタンをクリックしたら、錠前アイコン

付きの空の 2 列が下記のように表示されます。



列 B のヘッダをクリックして選択し、右クリックメニューからソート(ワークシート)を選択します。出力列

をソートするためにサブコンテキストメニューが利用できます。

A:0x04 再計算モードが利用できますが、再計算コンボボックスは X ファンクションダイアログで非表示になっ

ています。

19.3.2 B - ブラウザダイアログオプションブラウザダイアログオプションは、X ファンクションダイアログのボタンで開くことができるページ/グラフ

ブラウザダイアログ内の設定を制御できます。これらは、開いているダイアログをフィルタリングするの

に使用することができます。X ファンクショングラフブラウザダアイログについてのサンプルをご覧くだ

さい。

B:0x0001 ダイアログが開いたら、ページ/グラフブラウザですべてのページをソートします。

B:0x0002 グラフブラウザから 3D グラフを除外します。

19.3.3 C - その他のオプション

C:0x0001 列の XY 属性の割り当てから混合範囲を無効にします。例えば、XY 範囲型を持つ出力変数をを取

ります。オプション文字列が変数に対して指定されていない場合、それぞれ X 属性と Y 属性を持つ

2 つの出力列になります。それ以外の場合、2 つの列は両方ともデフォルトの Y 属性を持ちます。



C:0x0002 非表示の状態を持つ新しいページを作成します。

C:0x0004 X ファンクションを undo できないようにします。

C:0x0010 デフォルトで、double 型の変数が欠損値の場合、この変数は何も表示しません(空のセル)。このオ

プション文字列は、このような空の変数を"--"で表示します。

C:0x0100 このオプション文字列は、Range 型の出力変数に対してのみ利用できます。出力変数が<new>に

セットされている場合、有効な Origin C の Range オブジェクトが作成されますが、新しい列はありま

せん。このオプション文字列は、X ファンクションの本体で出力範囲オブジェクトの行と列を準備する

助けとなります。

C:0x0200 このオプション文字列は、Range 型の出力変数に対してのみ利用できます。出力変数が<new>に

セットされている場合、入力範囲を同じ行数と列数で複製します。

19.3.4 E - 実行制御 E:V

変数の実数値を維持する X ファンクションウィザードと X ファンクションバーで使われます。初の

適用ボタンで作成した目的は、後に続く適用ボタンで使われます。

19.3.5 F - ダイアログ数値表示フォーマット F:*6*

double 型で数値を表示するフォーマット文字列を提供します。 *(Origin のグローバル数値フォー

マット設定), .2(2 桁)などの標準の LabTalk 数値フォーマット表記を使うことができます。



19.3.6 FT - データプロット選択フィルタ FT:str1|str2

グラフからデータ選択の操作フィルタのタグを指定します。データオブジェクトに、str1 または str2 のタグが含まれる場合、メニュー項目現ページ/レイヤにすべてのプロットを追加を捕まえるデータを

選択するとき無視されます。

例

このサンプルは、グラフからすべてのプロットを選択するとき、TestCurves という名前のタグを持つ

データプロットを実行する FT オプション文字列を使用する方法を示しています。




コードビルダでこの X ファンクションを開き、次のコードをコピーして、メイン関数 OptionStringFT

の本体に貼り付け、コンパイルボタンをクリックします。

// データを配置して XYRange を出力

vector vx, vy;

vx.Data(1, 10, 1);

vy = vx;

oy.SetData(&vy, &vx);

// 指定した名前は iy のオプション文字列"FT"と同じ

tag_columns_in_data_range(oy, "TestCurves");



// 元の範囲のグラフを取得し、このグラフ上で結果をプロット

vector<uint> vnIDs;

if( iy.GetPlots(vnIDs) > 0 )

{

DataPlot dp;

dp = (DataPlot)Project.GetObject(vnIDs[0]);

GraphLayer gl;

dp.GetParent(gl);

gl.AddPlot(oy);

}

ファイル<Origin インストールフォルダ>Samples\Curve Fitting\Multiple Gaussians.dat を新

しいワークシートにインポートします。すべての列を選択し、折れ線グラフを作成します。新しく作成し

たグラフをアクティブにし、コマンドウィンドウで OptionStringFT -d; を実行し、OK ボタンをクリックし

て、元のワークシートの出力 XY 列を生成し、そのプロットを元のグラフに追加します。

グラフをアクティブにし、 OptionStringFT -d; を再び実行して、X ファンクションダイアログを開きま

す。入力 XY ブランチで、上記から新しく出力されたデータプロットは、このデータプロットのタグ名

TestCurves のため、そこにはありません。

19.3.7 FV - 出力変数のソースを指定する FV:varname は、各出力変数の入力変数の名前を指定します。そして、この変数のブック/シート/オブジェクトの情報は、出力変数が<input>/<same>でセットされるとき、出力変数で追跡し、共有され

ます。例えば、X ファンクションに 3 つの XYRange 変数が含まれているとします。初の 2 つは入

力変数で、残りの 1 つは出力変数。1 つの入力変数の名前が、このオプション文字列によって出力

変数にセットされると、出力が <input> または <same>のようにセットされ、出力列は指定した入力

列と同じになります。それ以外の場合、出力列は初の入力列と同じになります。

19.3.8 G - GUI 上のコントロールをグループ化する X ファンクションダイアログでグループに関連した変数に使われます。グループの開始に対して、変

数のオプション文字列 G:Group Name を追加し、グループの終了に対しては、別の変数のオプシ

ョン文字列内に G を追加します。

G:Group

グループの開始デフォルトで、グループのブランチは閉じます。初にブランチを開くようにセットす

るため、ダイアログを開き、G:-Group Name のように Group Name の前にハイフンを追加します。

すると、ダイアログは次回開いたときにブランチの状態を覚えておきます。



G

グループの終了

例

F10 キーを押し、X ファンクションビルダを開きます。X ファンクションを次の図のように作成し、保存

ボタンをクリックして、<Origin ユーザファイルフォルダ>¥X-Functions¥OC Guide¥ に保存し

ます(このフォルダが存在しない場合作成します。)

コマンドウィンドウで OptionStringG -d; を実行します。開いたダイアログは下記のようになります。



19.3.9 H - 結果テーブルのスタイルをセットする次の図で示されるように、名前と変数を持つ新しい X ファンクションを作成します。そして、保存ボタ



コードビルダでこの X ファンクションを開き、//put additional include files here の

行の後に必要なヘッダファイルを追加します。

#include <origin.h>

次のコードをメイン関数 OptionStringH にコピーし、選択したデータの基本統計分析を行うのに使

い、結果用のレポートシートを準備します。

// データ範囲オブジェクトからデータを取得

matrix mData;

if( rng.GetData(mData) <= 0 )

{

XF_THROW("No data is selected");

}

// 各列の基本統計を計算

vector vPoints, vSum, vSD;

for(int index = 0; index < mData.GetNumCols(); index++)

{

vector vData;

mData.GetColumn(vData, index);



int nPoints;

double dSum, dSD;

ocmath_basic_summary_stats(vData.GetSize(), vData, &nPoints,

&dSum, &dSD);

vPoints.Add(nPoints);

vSum.Add(dSum);

vSD.Add(dSD);

}

// データテーブルを作成

int nID = 0; // ID は固有

ReportTable rTable = rt.CreateTable("Report", "Report Table", ++nID, 0, 1);

rTable.AddColumn(vPoints, "N", ++nID, "Points", OKDATAOBJ_DESIGNATION_Y);

rTable.AddColumn(vSum, "Sum", ++nID, "Sum", OKDATAOBJ_DESIGNATION_Y);

rTable.AddColumn(vSD, "SD", ++nID, "SD", OKDATAOBJ_DESIGNATION_Y);

// この属性を 0 にセットすると、どのフォーマットも指定しない

// テーブル表示フォーマットをセットする oc_const.h で定義される多くのビット GETNBRANCH_*

rTable.SetAttribute(TREE_Table, GETNBRANCH_TRANSPOSE);

5 列を持つ新しいワークシートを作成し、すべての列に一様乱数を入力します。 (列を選択して、右ク

リックメニューから列の一律設定:一様乱数)コマンドウィンドウで OptionStringH -d; を実行し、ダイ

アログボックスを開きます。ダイアログで、入力データに対してすべての列が選択されていて、レポー

トに対して<new>が選択されていることを確認します。OK ボタンをクリックして、レポートシートは通

常のフォーマット (H:0)で表示されます。



X ファンクションビルダで X ファンクションを再び開き、 H:0 を H:1 に変更します。そして、それを保

存します。コマンドウィンドウで OptionStringH -d; を再び実行します。今回、レポートシートは、階

層テーブルフォーマット(H:1)で表示されます。

19.3.10 I - 入力範囲コントロールの動作を制限する入力データ範囲を制限し、対話式のコントロールの動作を編集します。このオプション文字列は、次

の入力データタイプに対してのみ動作します。Range, XYRange, XYRangeComplex, XYZRange, vector, vector<string>, vector<complex>



I:0x0001 初の部分範囲で複数のデータ選択を許可

I:0x0002 2 番目の部分範囲で複数のデータ選択を許可

I:0x0004 3 番目の部分範囲で複数のデータ選択を許可

I:0x0008 すべての部分範囲で複数のデータ選択を許可

I:0x0010 (古い) 1 つのデータセットに制限これはデフォルトの動作で、セットする必要はありません。

I:0x0020 Y エラー, XYRange のみサポート

I:0x0040 Range 内のラベル領域をサポートこのオプション文字列を使うことで、出力範囲は実行前にデータ

を消去しません。I:0x00040000 に似ています。

I:0x0080 <input> オプションが出力変数のポップアップから非表示になります。

I:0x0100 <new> オプションが出力変数のポップアップメニューから非表示になります。



I:0x0200 (<input>,<new>) オプションが出力変数、XYRange、のポップアップメニューから非表示になりま

す。

I:0x0400 ポップアップメニューのボタンを取り除きます。

I:0x0800 対話式のボタンを取り除きます。

I:0x1000 vector と Column 型のみを持つ入力変数に対して有効です。データ選択に対して文字列が取得さ

れると、列が、ショートネームではなくインデックスで認識されます。

I:0x2000 このオプション文字列は、初期化中に Y 列のみを使用する vector 変数を作成します。

I:0x4000 列ブラウザボタンを表示します。

I:0x8000 変数を読み取り専用にセットします。I:0x0400 と I:0x0800 の両方を一緒に使うこともできます。

I:0x00010000 初期化中に行の選択を取り除き、Column 変数のみにします。



I:0x00020000 列の表記を持つシート全体の範囲文字列を置き換えます。例えば、Sheet1 という Book1 内のワー

クシートガ 2 列を含んでいると、範囲文字列 [Book1]Sheet1 が [Book1]Sheet1!1:2 で置き換わり

ます。

I:0x00040000 このオプション文字列は、実行を完了する前にデータを消去しないで出力範囲を作成します。オプ

ション文字列なしで、入力データ範囲に重なりが無ければ、出力範囲の列は新しいデータを使う前

に消去されます。

例




コードビルダでこの X ファンクションを開き、次のコードをコピーして、メイン関数 OptionStringI の

本体に貼り付け、コンパイルボタンをクリックします。

orng = irng;

列 A と列 B の 2 列を持つ新しいワークシートを作成します。列 A の初の 10 行を選択し、右クリッ

クして列値の一律設定:行番号を選び、行番号に 10 行入力します。コマンドウィンドウで OptionStringI -d; を実行し、列 A を入力、列 B を出力として選び、OK ボタンをクリックします。結

果は、列 B に行番号が入力されます。



列 A の初の 5 行を選択し、右クリックして、コンテキストメニューを開き、削除を選択して、これら 5行を削除します。列 B のヘッダにある錠前アイコンの色が緑から黄色に変わります。錠前アイコンを

クリックし、ポップアップメニューから再計算を選択します。結果は、下図のように列 B の後の 5 行

の元のデータがそこに残ります。

I:0x00080000 すべての列は対話型のポップアップメニューに表示されます。

I:0x00100000 アクティブグラフレイヤに選択がなく、範囲変数が <active>を使うようにセットされている場合、範囲

変数はアクティブレイヤ内のすべてのプロットにセットされます。

I:0x00200000 出力 X としてサンプリング間隔を使用します。



I:0x00400000 I:0x00800000 既存の列またはプロットは対話型のポップアップメニューに表示されます。

I:0x02000000 出力 XYRange が<auto>を使ってセットされると、このオプションは新しい X 列を作成します。

I:0x04000000 行範囲は無視され、1 つのブロック範囲のみ有効になります。選択が無かったり、1 つのセルの選択

しかない場合、選択はワークシート全体と考えられます。

I:0x08000000 インデックスではなく、初と後の X 値を使って範囲文字列を作成します。シンタックスは

[BookName]SheetName!ColName[xFirstValue:LastValue]です。単調なデータに対して役立

ちます。

I:0x10000000 範囲変数は、ファクターや重み付けがありません。

19.3.11 M - 複数行文字列のサポート M:m-n

文字列変数は複数行のテキストをサポートしています。文字列変数が非表示の場合、 m 行のテキス

トがサポートされ、拡張すると n 行がサポートされます。

19.3.12 N - 出力オブジェクトのデフォルト名出力オブジェクトのデフォルト名を指定します。

レポートツリーとレポートデータ

N:"Name" Book:="Book Name" Sheet:="Sheet Name"



MatrixObject

N:"Name" Book:="Book Name" Sheet:="Sheet Name" X:="Object Name"

MatrixLayer, Image, vector, Column

N:"Name"

XYRange

N:X:="X Name" Y:="Y Name"

XYZRange

N:X:="X Name" Y:="Y Name" Z:="Z Name"

Worksheet

N:Book:="Book Name" Sheet:="Sheet Name"

19.3.13 O - X ファンクションを実行した後出力オブジェクトの操作を

設定する実行後に出力変数の操作を指定します。

O:A オブジェクトが非表示であったり、異なるフォルダにあったとしても、対応する Origin オブジェクトを

アクティブにします。

O:C ワークブックがアクティブウィンドウのときのみ、対応する Origin オブジェクトをアクティブにします。

O:N 対応する Origin オブジェクトをアクティブにしません。

19.3.14 P - GUI の編集可能なコントロールをセットする変数が X ファンクションダイアログで編集可能かどうか指定します。



P:0 or P:1 P:1 は、デフォルトのオプション文字列です。このオプション文字列を使うと、列やワークシートなどの

Origin のオブジェクト型である出力変数は、パラメータの変更で X ファンクションのダイアログを開く

とき、編集不可になります。他の型を持つ変数は、そうするために P:0 などのオプション文字列を指

定する必要があります。

P:2 ラベルのみを表示し、編集可能なフィールドは不可視となります。

P:4 X ファンクションダイアログで、セパレータとして変数を表示します。文字列型に対してのみ有効です。

例

F10 を押し、X ファンクションビルダを開き、次の図で示されるように、名前と変数を持つ新しい X フ

ァンクションを作成します。そして、保存ボタンをクリックし、<ユーザファイルフォルダ>¥X-Functions¥OC Guide¥ に X ファンクションを保存します(フォルダが存在しない場合、作成しま

す。)



コードビルダで X ファンクションを編集するボタンをクリックし、コードビルダでこの X ファンクショ

ンを開きます。コード out = in + var; をメイン関数, OptionStringP の本体にコピーし、コンパイ

ルボタンをクリックします。

新しいワークシートを作成し、列 A にいくつかデータを入力します。コマンドウィンドウで OptionStringP -d; を実行します。開いたダイアログで、列 A を入力列、列 B を出力列として列を

選択します。OK ボタンをクリックし、結果が生成され、列 B に保存されます。

列 B のヘッダの錠前アイコンをクリックし、コンテキストメニューからパラメータの変更を選択します。

パラメータの変更で開いたダイアログと OptionStringP -d; で開いたダイアログの違いは、下図に示

しています。

19.3.15 R - ダイアログのコンボボックスの動作を制限する LabTalk スクリプトで X ファンクションを呼び出すとき、X ファンクションのコンボボックスの値を制御

するのに使われます。ダイアログには影響しません。



R:0 制限ありません。コンボボックスのリストで定義されることに加え、LabTalk スクリプトを使ってコンボボ

ックスの変数に他の値を割り当てることができます。

R:1 デフォルトのオプション文字列です。コンボボックスのリストで定義される値だけが LabTalk スクリプト

を使ってコンボボックスの変数に割り当てることができます。

例

int 型の変数(x1 という名前)を持つ新しい X ファンクション (OptionStringR という名前)を作成しま

す。コントロール列に、この変数に対して AA|BB|CC をセットします。

コマンドウィンドウで、OptionStringR x1:=5; を実行し、エラーを取得します。#Command Error!.

X ファンクションビルダで再びこの X ファンクションを開き、オプション文字列の列に int 型の変数と

して R:0 をセットし、この X ファンクションを保存します。

コマンドウィンドウで、OptionStringR x1:=5; を再び実行し、エラーなしにします。

19.3.16 S - 入力変数のデフォルトのデータ選択を定義する入力変数に対するデフォルトのデータオブジェクトを定義します。このオプション文字列は、Range型の変数に対してのみ利用できます。

S:0 アクティブワークシートのすべての列はデータ範囲として選択されます。

S:0x01 アクティブ行列シートの初の行列オブジェクト、またはアクティブワークシートの初の列はデータ

範囲として選択されます。

S:0x10 <active> オプションは行列オブジェクト以外を選択できないようにします。出力変数に対して、

<active> オプションは<new>で置き換えられ、行列ページを作成します。



19.3.17 SV - X ファンクションダイアログコンボボックスの文字列項

目をサポートするコンボボックス内の項目の値を指定した値で置き換えます。例えば、int 型の変数がコントロール列の Begin|Mid|End 文字列でコンボボックスとしてセットされると、コンボボックスの項目のデフォル

トの項目の値は、それぞれ、0, 1, 2 となります。オプション文字列で SV:1|5|-1 は、この変数に対し

て使われ、コンボボックスの項目の戻り値は、それぞれ 1, 5, -1 となります。

19.3.18 T - テーマから変数をスキップする変数が X ファンクションダイアログのテーマファイルに記録するかどうか制御します。このオプション

文字列は、ツリービューでテーマ選択中のみ有効で、これはデフォルトの設定です。

T:0 指定したテーマが選択されていると、テーマの値は変数の値として使われます。

T:1 テーマが選択されていても、テーマの値を変数値として使用しません。

T:4 指定したテーマが選択されていると、テーマの値と属性は変数で使われます。このオプションは主に

XYRange, Image などの Origin 内部オブジェクトで使われます。

19.3.19 U - オプションとして出力を指定する出力変数が必要かどうかを指定します。このオプション文字列は、複数の出力変数を持つ X ファンク

ションに対してのみ利用できます。

U:1 出力変数に対して選択したチェックボックスを追加します。これはデフォルトオプションです。



U:0 出力変数に対して未選択のチェックボックスを追加します。

U:n 出力変数に対してチェックボックスを追加しません。

例





ンを開きます。次のコードをメイン関数 OptionStringU に配置します。

vector vv;

vv.Data(1,10,1);

if( xx ) // 出力 xx 変数かどうかチェック

{

xx = vv;

}

if( yy ) // 出力 yy 変数かどうかチェック

{



yy = vv;

}

zz = vv;

次のコードを OptionStringU_event1 関数に配置します。これは出力変数のチェックボックスの状

態を取得します。そして、コンパイルボタンをクリックします。

foreach(TreeNode subnode in trGetN.Children)

{

string strVarName = subnode.tagName;

int nUStatus, nOutput;

// 出力変数かどうかチェック

if((subnode.GetAttribute(STR_XF_VAR_IO_ATTRIB, nOutput)

&& IO_OUTPUT == nOutput))

{

// 出力チェックボックスの状態をチェック

if(subnode.GetAttribute(STR_ATTRIB_DYNACONTROL_USE_CHECK, nUStatus))

{

switch(nUStatus)

{

case 1:

printf("%s variable has Output checked check box.¥n"

, strVarName);

break;

case 0:

printf("%s variable has Output unchecked check box.¥n"

, strVarName);

break;

}

}

else

{

printf("%s variable NOT Output check box.¥n", strVarName);

}

}

}



コマンドウィンドウで OptionStringU -d; を実行し、ダイアログのデフォルト設定を維持し、OK ボタン

をクリックします。これは、2 列を持つ新しいワークシートを作成し、各出力変数のチェックボックスの

状態をコマンドウィンドウに出力します。

19.3.20 V - 不可視のコントロールを指定する変数が X ファンクションダイアログで可視かどうか指定します。

V:0 変数はダイアログボックスで不可視です。

V:1 変数はダイアログボックスで可視です。

V:2 変数は LabTalk スクリプトをつかうとき不可視です。

19.3.21 Z - 変数コントロールの編集可否をセットするチェックボック

スを追加する入力変数の近くにチェックボックスを追加し、それが編集可能か編集不可かを指定します。シンタック

スは Z:State|Label|Behavior となります。

State:0 または 1, チェックボックスの状態を指定します。

Label: チェックボックスのラベルです。Label と Behavior の両方が指定されない場合、デフォルト

でラベルは自動になります。

Behavior:

0, チェックボックスがチェックされているかどうかに関係なく、変数は常に編集可能です。

1, チェックされていると、入力変数が不可となります。

2, チェックされていないと、入力変数が不可となります。

例







ンを開きます。次のコードを OptionStringZ_event1 関数にコピーします。これは int 型の変数の

チェックボックスの状態を取得します。そして、コンパイルボタンをクリックします。

TreeNode trInt = trGetN.nn;

int nAutoType = octree_get_auto_support(&trInt);

switch(nAutoType)

{

case -1:

out_str("Auto check box of int Type control is unchecked");

break;

case 0:

out_str("No auto check box for int Type control");

break;

case 1:

out_str("Auto check box of int Type control is checked");

break;

}

コマンドウィンドウで OptionString -d; を実行し、下図のようなイメージのダイアログが開きます。

TestOK チェックボックスの状態を変更し、このチェックボックスの状態についてのメッセージがコマ

ンドウィンドウに出力されます。

319

2200 索引

＠

@OCSB システム変数 47 @OCSE システム変数 47 @OCS システム変数 47

１

1 次元配列 5

２

2D プロット 96 2 次元配列 5

３

3D プロット 97

Ａ

ANSI C/C++プログラミング言語 5 ANSI C データ型 5 Array クラス 43 ASCII データファイル 137 ASSERT マクロ 54 AxisObject クラス 25 Axis クラス 25

Ｂ

before_execute 関数 219 BitmapRadioButton クラス 39 BitsHex クラス 43 Branch マクロ 183 break ステートメント 14 Button クラス 39 byte 型 5

Ｃ

case 13 catch ステートメント 18 CategoricalData 22 CategoricalMap 型 22 char 型 5 CmdTarget クラス 39 CodeEdit クラス 39 CollectionEmbeddedPages クラス 26 Collection クラス 26, 290 ColorText クラス 39 Column クラス 26, 70 ComboBox クラス 39 complex 型 5, 22 complex クラス 6 continue ステートメント 14 Control クラス 40 cpp ファイル 46 curvebase 型 23 Curve 型 22 c ファイル 46

索引

320 索引

Ｄ

DataObjectBase クラス 27 DataObject クラス 27 DataPlot クラス 27 DataRange 120 DataRangeEx クラス 28 DataRange クラス 27, 165 DatasetObject クラス 28 Dataset オブジェクト 165 Dataset 型 23 Datasheet クラス 28 DeveloperKit 38 DeviceContext クラス 40 DialogBar クラス 40 Dialog クラス 40 double 型 5 do-while ステートメント 14 DWORD 値 6 DynaControl クラス 40

Ｅ

Edit クラス 40 event1_ex 関数 221 event1 関数 221

Ｆ

FDF ファイル 157 FFT 158 FFT フィルタ 159 file クラス 38 float 型 5 Folder クラス 28 foreach ステートメント 15, 129 for ステートメント 13 fpoint3d クラス 28 fpoint クラス 28

Ｇ

GET_CRF_FROM_RGBOCOLOR マクロ 8 GetGraphPoints クラス 29 GETN_BEGIN_BRANCH マクロ 183 GETN_BOX マクロ 182 GETN_END_BRANCH マクロ 183 GETN_TREE マクロ 182 GetN ダイアログ 182 GETN マクロ 182 goto ステートメント 15 GraphControl クラス 40 GraphLayer クラス 29 GraphObjCurveTool クラス 40 GraphObject クラス 29 GraphObjTool クラス 40 GraphPageBase クラス 30 GraphPage クラス 29 Grid クラス 30 GroupPlot クラス 30 GUI 上のコントロールをグループ化する 299 GUI の編集可能なコントロール 309

Ｈ

Hello World ダイアログ 190 Hello World チュートリアル 1 h ファイル 46

Ｉ

if-else ステートメント 12 IFFT 159 if ステートメント 12 INIFile クラス 38 int 型 5

索引

索引 321

Ｌ

LabTalk 57, 175 LabTalk コンソールウィンドウ 4 LabTalk の数値 175 LabTalk の文字列値 176 Layer クラス 30 LayoutPage クラス 31 Layout クラス 31 ListBox クラス 41 list コマンド 57

Ｍ

make_tree 関数 220 MATLAB 22 matrixbase 型 24 MatrixLayer クラス 31 MatrixObject クラス 32 MatrixPage クラス 32 matrix 型 24 Matrix 型 23 matrix クラス 5 Menu クラス 41

Ｎ

NAG 関数 163 NLFit 21 NLFitSession クラス 21, 155 NLfit クラス 155 Note クラス 33

Ｏ

ocb ファイル 46 OCOLOR_IS_RGB マクロ 8 ocw ファイル 47 OPX ファイル 62

op ファイル 46 OR 11 Origin C で X ファンクション 263 Origin Dialog AppWizard 190 Origin.ini ファイル 52 OriginControls クラス 41 OriginObject クラス 33 Origin システムパス 124 Origin 定義クラス 17

Ｐ

PageBase クラス 34 Page クラス 33 PictureControl クラス 41 point クラス 34 pragma ステートメント 57 Profiler クラス 43 progressBox クラス 41 Project クラス 34 Project フォルダ 48, 51 PropertyNode 型 24 PropertyPage クラス 41 PropertySheet クラス 41

Ｒ

Registry クラス 38 ReportTree 272 RGB2OCOLOR マクロ 8 RGB 値 6, 7 RGB マクロ 8 RichEdit クラス 42 ROIObject クラス 35 Run.LoadOC 52

Ｓ

Savitzky-Golay スムージング 158 Scale クラス 35

索引

322 索引

short 型 5 Slider クラス 42 SpinButton クラス 42 SQLite データベース 173 stdioFile クラス 38 STFT 159 storage クラス 35 string 型 24 string クラス 5 StyleHolder クラス 35 switch ステートメント 13 SYSCOLOR_ 6 System フォルダ 48 System フォルダ 51

Ｔ

TabControl クラス 42 Temporary フォルダ 48 throw ステートメント 18 TreeNode 119 TreeNodeCollection 型 24 TreeNode 型 24 Tree 型 24 try ステートメント 18 Type.Redirection プロパティ 169

Ｕ

uint 型 5 UndoBlock クラス 36 User フォルダ 49

Ｖ

vector 118 vectorbase 型 25 vector 型 25 vector クラス 5 void 型 5

Ｗ

waitCursor クラス 42 while ステートメント 14 Win32 ダイナミックリンクライブラリ 190 Windows レジストリ 38 Window クラス 42 WizardControl クラス 42 WizardSheet クラス 42 WndContainer クラス 43 word 型 5 WorksheetControl クラス 43 WorksheetPage クラス 36 Worksheet クラス 36

Ｘ

XF_THROW マクロ 225 XF_TRACE マクロ 225 XOR 11 XYRangeComplex クラス 37 XYRange クラス 37 XYZRange クラス 37 XYZ 等高線 98 XY ラベル 77 X ファンクション 207, 227, 231, 244, 256 X ファンクションダイアログ 262 X ファンクションのオプション 292 X ファンクションビルダ 210

Ｚ

Z ラベル 78

あ

アクセスツリー 131 アサーション失敗 54 値で渡す 59

索引

索引 323

値の設定ダイアログ 60, 80 アプリケーションコミュニケーションクラス 21 アプリケーションを配布 61

い

位置 113 イベント関数 250 イベントハンドリング 185 イベントハンドリング関数 219 イメージ GetN ダイアログ 229 イメージのインポート 141 イメージプロット 99 色 6, 102 インポートフィルタ 139

う

ウィザードダイアログ 41, 195, 236 上 X 軸の表示 95 ウエイトカーソル 179 ウエイトカーソル 42 ウェーブレット分析 159

え

エクスポート 143 エディタウィンドウ 49 エラー 53 エラー構造体 163 エラーと例外処理 18 エラーハンドリング 223 エラーメッセージを出力 224 演算子 8

お

オートメーションサーバ 284 オーバーロード 250

オブジェクトファイル 46 折れ線グラフ 103

か

カーブフィッティング 155 外部 DLL にアクセス 283 外部アプリケーションにアクセス 284 ガジェットツール 244 カスタムダイアログ 233 カスタムボタンを追加 259 仮想行列 80 画像のインポート 140 カラーインデックス 7 カラーパレット 6 カラーマップ設定 105 カラーマップ等高線図 98 関数 15 関数の使用 56 関数の優先規則 60

き

記述統計量 153 基線 160 起動時にビルド 52 起動時のビルド 51 基本グローバルイベント関数 250 逆フーリエ変換 159 キャレット 9 行列 76, 119 行列オブジェクト 31, 74 行列シート 74 行列データ 23 行列のエクスポート 144

く

矩形 112

索引

324 索引

クラス 17 クラスの階層 287 グラフ 91 グラフオブジェクト 29 グラフのエクスポート 144 グラフプレビューGetN ダイアログ 225 グラフプレビューダイアログ 197 グラフレイヤ 29 グリッド線 93 グローバル関数 15

け

結果テーブルのスタイルをセットする 301 結果ログ 169 欠損値 117 検索パス 217

こ

コードビルダ 1, 49, 216, 227, 231, 248 コールバック関数 164 コマンドウィンドウ 49 コモンダイアログボックス 180 コレクション 290 コンストラクタ 18 コンパイル 50 コンポジットデータ型 5, 211 コンポジットデータ型のクラス 22

さ

再計算モード 292 サイズ 113 算術演算子 8 散布図 96, 104

し

軸 25 軸刻み 95 軸スケール 94 軸フォーマット 94 軸目盛ラベル 95 指数演算子 9 システムクラス 38 システム変数 47 事前定義のクラス 17, 21 自動カラー 7 ジャンプステートメント 14 修正フラグ 127 周波数スペクトル 159 出力ウィンドウ 2, 49, 53 出力オブジェクト 169 出力変数のソースを指定する 299 条件分岐 12 剰余演算子 9 初期化ファイル 38 信号処理 158

す

数学 147 数式で値をセット 74 数値データ 117 数値データの精度 117 数値を文字列に変換 118 スクリプトウィンドウ 3, 169 スクリプトから X ファンクション 262 スクリプト実行 176 スクリプトでビルド 52 図形オブジェクト 112 スケールオブジェクト 35 スタイルホルダオブジェクト 35 スプリッターダイアログ 200 すべてをビルド 51

索引

索引 325

スムージング 158 スライダ 42

せ

正規化 147 正規性の検定 154 積分 148 接続プロパティ 114 セルを統合する 70 線 112

そ

相関係数 154 操作にアクセス 135 ソースコードを配布 61 ソースファイル 46, 50, 61 ソート 83

た

ダイアログ数値表示フォーマット 297 ダイアログビルダ 189 縦棒グラフ 97 短時間フーリエ変換 159

つ

ツールバーのカスタム化ダイアログ 62 ツリーにアクセス 131 ツリービュー 215

て

データインポート 137 データ型 5, 71, 76, 211 データシート 30 データ操作 72, 81

データの抽出 85 データの比較 86 データ範囲 27, 37, 120 データ範囲にアクセス 131 データプロット選択フィルタ 298 データプロットの追加 96 データベースからのインポート 171 データベースへのエクスポート 172 データ変換 87 データマーカー 101 テーブルオブジェクト 115 テーマ 263 テーマ ID 215 テーマファイル 103 テキストラベル 112 適用ボタン 184 デコンストラクタ 18 デバッグ 54 デベロッパーキット 189, 195

と

統計 153 統合開発環境 45 等高線図 98 ドキュメントを追加 259 度数カウント 153

な

内部 Origin オブジェクトクラス 25

に

入力範囲コントロールの動作 303 入力ボックス 180

索引

326 索引

の

ノートウィンドウ 170 ノートページ 33

は

バーチャルメソッド 18 排他論理和 11 排他論理和演算子 9 パッケージファイル 61 凡例 115

ひ

ピークの検出 161 ピークの積分 162 ピークフィット 163 比較演算子 9 引数を渡す 58 非線形フィット 155 左にシフト 11 日付と時間データ 124 ビット演算子 11 微分 152 表示プロパティ 114 ビルド 2, 49, 51

ふ

ファイルダイアログ 181 ファイルパス 123 フィット関数 21 フーリエ変換 158 フォーマット 71, 76, 92 フォーマットツリー 102 フォーマットのコピー 103 フォルダを管理 128 不可視のコントロール 316

複数区分グラフ 100 複数軸 99 複素数 120 複素数型 22 部分文字列 123 ブラウザダイアログオプション 296 プリプロセスファイル 46, 50, 61 ブレークポイント 54 フロー制御ステートメント 12 プログレスダイアログボックス 41 プログレスボックス 181 プロジェクト 127 プロジェクトエクスプローラ 28 プロパティを設定 113 分析 147 分析クラス 21

へ

ページにアクセス 129 ヘッダファイル 217 編集ウィンドウ 216

ほ

補間 148 補数 11 ボタンコントロール 39

ま

マスク 84 マルチドキュメントインターフェース 2

み

右にシフト 11

索引

索引 327

め

メタデータにアクセス 131 メッセージボックス 180 メッセージマップ 39 メディアンフィルタ 158 メニュー 41, 256

も

文字列データ 122 文字列を数値に変換 122

や

矢印 112

ゆ

ユーザインターフェース 179 ユーザインターフェースのコントロールクラス 38 ユーザ定義関数 16 ユーザ定義クラス 17 ユーティリティクラス 43 ユリウス日 125

よ

横棒グラフ 97

ら

ラベル 77

り

リソース DLL 190 リファレンスで渡す 59 リンク 50 隣接平均スムージング 158

れ

レイアウト 31 レイヤ管理 107 レイヤの追加 108 列 26, 70 列のコレクション 36 列ラベル 73 レポートシート 170 レポートシートにアクセス 136

ろ

論理演算子 10 論理和 11

わ

ワークシート 26, 81 ワークシートグリッディング 87 ワークシートにアクセスする 67 ワークシートのエクスポート 143 ワークシートの追加と削除 66 ワークシートページオブジェクト 36 ワークシートをコピーする 68 ワークシートを並べ替える 68 ワークシートをフォーマットする 69 ワークスペースファイル 47

索引

328 索引

origin c プログラミングガイド...iii 目次 1 origin c のイントロダクション........

Documents