Wks.Col
wks.colオブジェクトは、ワークシート内の列、または行列シート内の行列オブジェクトを参照します。これらのオブジェクトには、名前、単位、型などの列属性を読み書きするプロパティと、フィルタ、式などを設定するメソッドが含まれています。
このオブジェクトを参照するための構文は2つあります。
- wks.col --現在の作業列(例: wks.col=2は第2列をアクティブな列に設定します)。wks.col.lname$="Data"は2列目のロングネームを設定します。
- wks.colN -- N番目の列(例: wks.col2.lname$="Data"は2番目の列のロングネームを設定します)。
プロパティ
| プロパティ | タイプ | アクセス | 説明 |
|---|---|---|---|
| wks.col.comment$ | 文字列 | 読み/書き | 列コメント行ヘッダー文字列値。 |
| wks.col.categorical.sort | 数値 | 読み/書き | 列nのソート方法を読み込んだり設定したりします。 0=ソートなし、1=昇順、2=降順、3=カスタム(任意)。 |
| wks.col.categorical.type | 数値 | 読み/書き | 列nの型の読み取りまたは設定。 |
| wks.col.cmap.palette$ | 文字列 | 読み/書き | 行列オブジェクトのカラーパレットの読み取りまたは設定。 |
| wks.col.digitMode | 数値 | 読み/書き | 数字表示モードを設定します。0=すべて表示、1=小数点以下を設定、2=有効桁数を設定。 |
| wks.col.digits | 数値 | 読み/書き | wks.col.digitMode = 1 のとき小数点以下の桁数、wks.col.digitmode = 2 のとき有効桁数:0 =すべて表示、n =nを表示。
|
| wks.col.edit | 数値 | 読み/書き | 列の各セルに、チェックボックス、リストボックス、コンボボックスのいずれかの機能を追加。 |
| wks.col.evenx | 数値 | 読み/書き | 列nを読み取るか、サンプル間隔を使用するように設定します。0= サンプル間隔を使用しない、1=サンプル間隔を使用し、内部 X の初期値は 0、増分値=1。 |
| wks.col.filter wks.col.filter$ |
数値/文字列 | 読み/書き | フィルタを追加または削除します。 フィルタクエリ文字列を設定または取得します。フィルタタイプをadvanceに設定する必要があります。 |
| wks.col.filterenabled | 数値 | 読み/書き | フィルタを有効化または無効化します。1=フィルタ有効、0=フィルタ無効。 |
| wks.col.filterprescript$ | 文字列 | 読み/書き | クエリスクリプトの前に設定または取得します。 |
| wks.col.filterx$ | 文字列 | 読み/書き | 列を表すために使用される変数を設定して取得します。 |
| wks.col.format | 数値 | 読み/書き | 列のフォーマット:1=数値、2=テキスト、3=時間、4=日付、5=月、6=曜日、7=文字と数値、8=色、9=バイナリ(ワークシートの列のプロパティダイアログボックス内の「フォーマット」ドロップダウンリストに表示される通り) |
| wks.col.formula$ | 文字列 | 読み/書き | (列)値の設定またはF(x)=ラベル行( 列ラベル行文字列を参照)のような列式。 |
| wks.col.formularange$ | 文字列 | 読み取り | (列)値の設定の列数式の範囲。 |
| wks.col.image | 数値 | 読み取り | 行列オブジェクト情報を取得します:
0 =画像なし
|
| wks.col.index | 数値 | 読み/書き | 列インデックスを左から右にカウントします。このプロパティを使用してワークシート列を並べ替えます。 |
| wks.col.iscat | 数値 | 読み/書き | 列がカテゴリであるかどうかを読み取りまたは設定します。0=列タイプがカテゴリでない、1=列タイプがカテゴリである。 |
| wks.col.label$ | 文字列 | 読み/書き | 8.0より前のバージョンの列ラベルアクセス。単一の呼び出しでロングネーム、単位、コメントを制御することができます。 |
| wks.col.link$ | 文字列 | 読み/書き | 現在のミラー列が参照しているソース列を設定および取得します。例:
//アクティブシートの2列目を[book1]1!col(B)にリンク wks.col2.link$=[book1]1!col(B) |
| wks.col.lname$ | 文字列 | 読み/書き | 列または行列オブジェクトのロングネームの文字列値。 |
| wks.col.missing | 数値 | 読み/書き | カスタム欠損値。このプロパティは、数値形式がdoubleでない列が欠損値をサポートできるように、カスタムの欠損値を設定できます。 |
| wks.col.name$ | 文字列 | 読み/書き | 列ショートネーム |
| wks.col.nCols | 数値 | 読み/書き | 行列オブジェクトの列数。ワークシートの列の場合は常に1となります。 |
| wks.col.nRows | 数値 | 読み/書き | 行数 |
| wks.col.numerictype | 数値 | 読み/書き | 列の数値型 |
| wks.col.py$ | 文字列 | 読み/書き | (列)値の設定のPython関数タブの内容 |
| wks.col.script$ | 文字列 | 読み/書き | (列)値の設定の「実行前の処理スクリプト」タブの内容 |
| wks.col.subformat | 数値 | 読み/書き | ワークシートの列フォーマットダイアログボックスの表示ドロップダウンリストにリストされているサブフォーマットオプション(メインメニューのフォーマット:列フォーマットを選択してこのダイアログを開きます))。 |
| wks.col.svrm | 数値 | 読み/書き | (任意の)列の数式の再計算モードを設定します。0=なし、1=自動、2=手動。 |
| wks.col.tWidth | 数値 | 読み/書き | テキスト列に入力できる文字数。 |
| wks.col.type | 数値 | 読み/書き | 列の属性:1 = Y、2 = 無属性、3 = Yエラー、4 = X、5 = ラベル、6 = Z、7 = Xエラー。 |
| wks.col.unit$ | 文字列 | 読み/書き | 単位の行ヘッダ |
| wks.col.width | 数値 | 読み/書き | 単一のワークシート列(例:"col1")の幅(文字単位)。 |
| wks.col.x1 | 数値 | 読み/書き | 行列オブジェクトの1列目のマッピング座標を取得/設定 |
| wks.col.x2 | 数値 | 読み/書き | 行列オブジェクトの最後の列のマッピング座標を取得/設定 |
| wks.col.xinit | 数値 | 読み/書き | 列の内部Xの初期値。XINIT、XINC、およびXUNITSは、表示されている場合、サンプリング間隔の行ヘッダに表示されます。 |
| wks.col.xinc | 数値 | 読み/書き | 列の内部X増分値。 |
| wks.col.xuints$ | 文字列 | 読み/書き | 列の内部X単位文字列。 |
| wks.col.xname$ | 文字列 | 読み/書き | 列の内部X名文字列。XNAMEとXUNITSは、この列のプロット上のX軸タイトルとして表示されます。 |
| wks.col.y1 | 数値 | 読み/書き | 行列オブジェクトの1行目のマッピング座標を取得/設定 |
| wks.col.y2 | 数値 | 読み/書き | 行列オブジェクトの最終行のマッピング座標を取得/設定 |
メソッド
| メソッド | 説明 |
|---|---|
| wks.col.filter | フィルタダイアログを開く |
| wks.col.setbinary | バイナリ自動変換を設定 |
| wks.col.setformat | setformatメソッドはformatメソッドとsubformatメソッドの機能を組み合わせ、さらにカスタムフォーマットを指定できるようにします。 |
| wks.col.setformula | 列の式を設定 |
| wks.col.findX | 対応するX列のインデックスを返す |
サンプル
列の属性を編集
アクティブな列 wks.col を設定し、その属性を編集します。
// アクティブな列を2に設定 wks.col = 1; // アクティブな列(col2)のロングネームをTimeに設定 wks.col.LNAME$= "Time";
または、wks.colの後にインデックスを追加して、列属性を変更します。
//列1のロングネームをTimeに設定 wks.col1.LNAME$ = Time; // 別のワークブックの参照も可能だが、ターゲットシートはアクティブである必要がある // Book5内のアクティブなシートの列5をX列に設定 Book5!wks.col5.type = 4; // col0は最後の列を参照 //最後の列の式を設定 wks.col0.formula$="A";
カスタム日付形式の設定
このスクリプトは、アクティブなワークシートの列2の書式をカスタム日付書式に設定します。
// 指定子の日付以外の文字を一重引用符で囲む: wks.col2.SetFormat(4, 22, yyyy'.'MM'.'dd);
列をループして列属性を設定する
このスクリプトは2から10までの列をループし、各列のロングネームを設定します。
// 列数を10に設定します。 wks.ncols=10; for (i=2; i<=wks.ncols; i++) { wks.col=i; //アクティブ列を設定 wks.col.lname$="Data$(i-1)"; //アクティブな列のロングネームを設定 //wks.col$(i).lname$="Data$(i-1) も同様に動作 }