ワークシート列の操作を行うには、 Column クラスかWorksheet クラスを使用します。
ワークシートの最後に新しい列を追加する場合、Worksheet クラスのAddColメソッドを使用し、指定した位置の直前に列を挿入するときはInsertColを使用します。
// デフォルト名で列を追加 int nColIndex = wks.AddCol(); // strNameという名前の列を追加; int nColIndex = wks.AddCol("AA", strName); // 列のインデックスを返す // AAという名前の列が既にある場合、自動で名付け out_str(strName); Column col(wks, nColIndex); // 列インデックスで列オブジェクトを構築 // 新しい列を1列目として挿入 int nPos = 0; // 挿入する位置 string strNewCreated; // 新しい列の名前 // MyColという列名が既にある場合は、自動で名付け if( wks.InsertCol(nPos, "MyCol", strNewCreated) ) { printf("Insert column successfully, name is %s\n", strNewCreated); }
Worksheet::DeleteColメソッドはワークシートから列を削除する事ができます。
// インデックスで列を削除 wks.DeleteCol(0);
列の名前(ショートネーム)を変更するには、SetNameメソッドを使用します。
Column col = wks.Columns(0); //ワークシート内の1列目を取得 BOOL bRet = col.SetName("MyNewName"); // 列の名前を変更
ワークシート列ラベルには、ロングネーム、単位、コメント、パラメータ、ユーザ定義ラベル等がサポートされています。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);
![]() | RCLT_PARAM は、パラメータ列ラベルタイプです。他のタイプについては、OriginC\system\oc_const.h の ROWCOLLABELTYPE enumを確認してください。 |
列を表示/非表示にするには、Workhseet::ShowCol メソッドを使用します。
wks.ShowCol(1, 1, false); // 列1を非表示にする
列を移動したり交換する場合、Worksheetクラス、DatasheetクラスがMoveColumnsメソッドと[[OriginC:Datasheet-SwapColumns|SwapColumns]を提供しています
// 3列移動 - 列5を最初の列へ // このサンプルでは最低限7列あるワークシートが必要 Worksheet wks = Project.ActiveLayer(); if(wks) wks.MoveColumns(4, 3, MOVE_COL_TO_FIRST); // アクティブワークシートの列の順番を逆に for(int ii = 1; ii <= wks.GetNumCols() / 2 ; ii++) wks.SwapColumns(ii - 1, wks.GetNumCols() - ii);
列にスパークラインを追加するために、Origin CではRCLT_SPARKLINEラベルタイプのwks_set_show_labels が提供されています。
// サンプリング間隔とスパークラインを表示するためにアクティブワークシートを構成 // 現在のラベルに追加 Worksheet wks = Project.ActiveLayer(); vector<int> vn = {RCLT_SAMPLE_RATE, RCLT_SPARKLINE}; wks_add_show_labels(wks, vn, false);
Worksheet wks = Project.ActiveLayer(); Column col(wks, 0); // 列タイプを取得 // 0: Y // 1: 無属性 // 2: Yエラー // 3: X // 4: L // 5: Z // 6: Xエラー int nType = col.GetType(); out_int("Type: ", nType);
// 列属性を設定。 OKDATAOBJ_DESIGNATION_* in oc_const.h 参照 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); }