Grid(グリッド)コントロールは、フォーマットされた表にデータを表示するための簡単な手段です。表は横の行と縦の列から構成されています。行と列が交差する部分をセルと呼びます。Samplesに含まれているサンプルプロジェクトのGrid.prjをご覧になって、このコントロールがどのように動作するか確認されるとよいでしょう。以下の説明の中に太字の文字がありますが、これらはグリッドコントロールのプロパティやメソッドです。これらを使うには、コントロールの参照名とピリオドをプロパティやメソッドの前に付けます。
プロジェクトのフォーム上にグリッドを配置するには、グリッドオブジェクトを選択し、Palm Screen上の配置したい場所をクリックします。Cols(列数)とVisible Rows(見えてる行数)をセットします。Visible Rowsの数を変更すると、グリッドのHeight(高さ)が増え、行のサイズは変わりません。Heightを変更すると、各行の高さが変わります。グリッド作成時には全ての列は同じ幅に分けられ、実行時に幅を変更することができます。フォームがロードされる時に自動的にグリッドを隠すことはできません。
Has Scrollbarオプションを選ぶ時、オブジェクトの右にくるスクロールバーのスペースを残してWidthを設定してください。約10ピクセル必要です。
Form After Code内で実行時に行うグリッドの初期化を済ますことができます。最初にHideを行うと良いでしょう。これによって表のアップデートの度に画面が更新されるのを避けることができます。次に、列の幅、タイプ、初期値を設定し、最後にShowを行ないます。
列の幅の設定は ColWidth(colNo)=p を使います。colNoは列の番号で、p はその列の幅をピクセル値で指定します。列はテキスト、数値、またはチェックボックスに設定できます。
列のタイプを設定するには ColType colNo, type, formatString を使います。typeは"text"、"numeric"、
"checkbox"のどれかになります。
typeが”text”の場合、その列には文字列値を入れることができます。formatStringで指定する文字列は、Addによって新しい行ができた時に、その列のセルに入る初期値になります。通常は空白(“”)文字列です。”text”は列のデフォルトタイプです。テキストタイプの列に入るデータは左揃えになります。
typeが”numeric”の場合、formatStringで数値がどのように表示されるかを指定します。これはFORMATステートメントで使うフォーマット文字列と同じです。例えば、formatStringが”nnn”の場合、3桁の右揃えの数字が表示されます。デフォルトフォーマットは 0 です。
typeが”checkbox”の場合、formatStringにはオプションとして、チェックボックスの右に現れる文字列を指定することができます。デフォルト値は空白文字列です。右にテキストを持たないチェックボックスの幅は、
colWidthで12を指定すると良いでしょう。チェックボックスタイプのセルには数値または文字列を代入することができます。0 または “0” が代入されると、チェックボックスのチェックが外れ、それ以外の値が代入されるとボックスはチェックされます。チェックボックス列のデフォルトは、チェックが外されている状態です。
'set up a grid with 3 columns: text, numeric and checkbox grid1.hide grid1.colwidth(1)=121 grid1.ColType 1,"text","" grid1.colwidth(2)=14 grid1.ColType 2,"numeric","nnn" grid1.colWidth(3)=12 grid1.ColType 3,"checkbox","" displayGrid 'call another function to set initial values grid1.show
一旦グリッドがセットされたら、Text、Value、TextMatrix、ValueMatrix関数を使って、データをセルに入れていくことができます。TextおよびValueはそれぞれテキストと数値をカレントセルに入れます。カレントセルはRow(行)とCol(列)で定義されます。カレントセルを変更するには、RowとColプロパティに新しい値を代入します。
これを早く行うにはTextMatrixとValueMatrixを使います。これらの関数は行と列の値を引数として受けますので、RowとColプロパティを別にセットする必要がありません。Redrawメソッドは、全てのセルが更新された後に使うことができます。
行を追加するにはAddメソッドを使います。RowDataプロパティは各行毎に、表示されない特有の値を保管することができます。グリッド内の全ての行を消去するにはClearメソッドを使います。Clearを行うとRowsの値は0になります。また、Rowsの値を変更することによって、行を足したり削除したりできます。Removeを使うと、1つの行を指定して削除できます。
MyGrid.Clear For r=1 to 10< MyGrid.add Grid.TextMatrix(r,1)="some data" Grid.ValueMatic(r,2)=2 Grid.ValueMatix(r,3)=1 Next
データベースからの情報を使ってグリッドを埋めることもできます。これを行うには、ちょっとした準備が必要です。最初に、DIMを使ってデータベース変数を定義し、どのデータベースを読込むかを指定します。 DIM WITH RECORDステートメントを使います。例えば:
Dim blueKey as Integer Type dbBluesLayout Name as String age as Integer active as Integer End Type Dim dbBlues1 as Database "Blues", DbBluesRec, dbBluesLayout, BlueKey
ここではPalmに入ってる“Blues”と呼ばれるデータベースのデータを読み込みたいわけです。データベース変数(これを使ってデータベースを参照します)はdbBlues1です。データベース内の各レコードは、
dbBluesLayout内のフィールドを持っています。1つのレコードを読込むとdbBluesRec変数に納められます。データベースのキーはblueKeyで整数型です。dbBluesRecは自動的に(グローバルではなく)通常の変数として設定されますので、このステートメントはBindToDatabaseコールと同じルーチンで行われなければなりません。
データベースの定義は済みましたので、BindToDatabaseコール使って直接グリッドに情報をコピーします。
Grid1.bindToDatabase(dbBlues1, dbBluesRec.name, dbBluesRec.Age, _ dbBluesRec.active) Where dbBluesRec.age>=70
このステートメントは、dbBlues1で参照するデータベースからグリッド(Grid1)へデータをコピーします。次に続く3つの引数は、データベースレコードのフィールドのリストで、それぞれ別の列に入ります。列はレコードのレイアウト(dbBluesLayout)のフィールドと同じ順番である必要はなく、また全てのフィールドを使う必要もありません。オプションのWHEREは、どのレコードをグリッドにコピーするか選ぶことができます。IFステートメントで使われる式であれば、どんな式でもWHEREの後に入れることができます。
Visible Rowsよりレコード数が多く、Has ScrollBarがセットされている場合、スクロールバーが現れ全てのレコードを見ることでできます。レコード数がかなり多い場合、スクロールの矢印は細かく正確に動作しませんので注意してください。レコードは表示される時のみグリッドにコピーされますので、大きなデータベースでも時間の遅れはありません。
レコードが各行に読込まれる時、データベースのレコード番号が各行のrowDataにセットされます。これは指定する行のデータベースレコードを確認したい時に便利です:
Dim recNo as integer Dim err as integer recNo=Grid1.rowData(Grid1.Row) '指定行のrowDataを得る err=dbPosition(dbBlues, recNo) err=dbRead(dbBlues, dbBluesLayout)
ユーザがグリッドをタップすると、グリッドオブジェクト用のコードが実行されます。データは直接セルにタイプすることはできません。そのルーチンの中で、いくつかの変数を確認して何を行うか判断できます。RowとColプロパティはカレント行と列を持っています。Rowを使ってRowData値を得て、元のデータベースのレコードにアクセス(データベースをバインドしたグリッドの場合)したり、他のデータにアクセスすることができます。
Text、Value、TextMatrix、RowMatrixを使って値を変更することができますが、データベースをバインドしたグリッドの場合、自動的にデータベースは更新されません。データベースを更新するには、rowDataプロパティでデータベースレコードを特定し、読み込み、変更、書き込みを行うコードを書かなくてはなりません。
TopRowはスクロールするグリッドを処理する時に便利な値です。これはその時表示されている一番上の行番号を与えてくれます。また、TopRowの値を変えることによって、強制的にその行が最初にくるようにグリッドをスクロールします。
DIM varname AS type
DIM varArray(nnn) AS type
DIM varname AS type*length [,decimalPlaces]
DIM varArray(nnn) AS type*length[,decimalPlaces]
DIM varName AS DATABASE dbName, dbRec, dbLayout [, key]
説明
ファンクションやサブルーチン内で使用される変数を定義します。変数が配列の場合、nnnが予約される要素の数を指定します。
|
Type |
|
|
Byte |
一つの文字。データベースへの入力/出力は、一つの文字が書込まれる。(末尾のnull文字は含まない) |
|
Database |
データベースコマンドで使用されるデータベースリファレンスの定義に使用。データベースがGridコントロールにバインドされる場合、余分に引数が必要になる。 |
|
Date |
日付の値の保管に使用。これはPalmの内部フォーマットではない。データベースへの入力/出力は、64-bit浮動小数点数が使用される。日付は内部的には |
|
Double |
Floatと全て同様。 |
|
Float |
整数および小数の両方の保管に使用。データベースへの入力/出力は、64‑bit(8‑byte)の倍精度浮動小数点フォーマットが使用される。 |
|
Integer |
整数の保管に使用(小数点から右へのポジションは無し)。データベースへの入力/出力は、32‑bit(4‑byte)のinteger(整数)フォーマットが使用される。 |
|
Short |
Integerに似ているが、データベースへの入力/出力は、16‑bit(2‑byte)フォーマットが使用される。 |
|
Single |
データベースへの入力/出力が、32‑bit(4‑byte)の単精度浮動小数点フォーマットが使用されるのを除き、Floatと同様。 |
|
String |
最大サイズが32767文字の文字列 |
|
Time |
時間の値の保管に使用。これはPalmの内部フォーマットではない。データベースへの入力/出力は、64-bit浮動小数点数が使用される。時間は内部的には hour*10000+minute*100+seconds として保管される。 |
|
UserType |
TYPE および END TYPE ステートメントを参照。 |
|
Variant |
SysTrapFunc および SysTrapSub ファンクションを参照。 |
lengthは何桁表示されるか指定します。DecimalPlacesは小数点より右側何桁かを指定します。これは最大でもlengthより2桁少なくてはなりません。
Gridで使用されるデータベースを定義する場合、varNameは変数名になります。DbNameはPalm OSデバイス上にあるデータベースの名前です。dbRecはグローバル変数で、データベースのカレントレコードの内容を参照するための名前です。dbLayoutはレコードの構成で、TYPEステートメントによって予め定義されている必要があります。keyは任意の変数で、dbNameデータベースに使われるキーです。このフォームは BindToDataBaseメソッドの最初の引数Varnameを定義するためだけに使用されます。
例
Dim income as float*12,2 Dim count as integer Dim yesterday as date Dim appt as time Dim rates(12) as float Dim Orders as database Type dbBluesLayout Name as String age as Integer active as Integer End Type Dim blueKey as Integer Dim dbBlues1 as Database "Blues" Creator "Grid" Keyed With Record BlueKey, dbBluesRec as dbBluesLayout
Gridオブジェクトは、データベースから自動的に読込まれるデータ、またはプログラム内で提供されるデータの表を表示します。グリッドの基本的な見た目はデザイン時に定義し、実行時にデータと一緒になります。
グリッドのセルがタップされると、グリッドのrow(行)とcol(列)プロパティがセットされ、プログラム内で使用することができます。ユーザは直接フィールドを編集することはできませんが、TextMatrixと ValueMatrixを使うことによって値の変更が可能です。 TextとValueはカレントセルに対して使えます。
このオブジェクトに関する詳細は、このハンドブックのセクション13をご覧下さい。
このオブジェクト特有のプロパティとメソッド
|
.BINDTODATABASE dbName, dbFieldNameList [Where condition] |
|
| データベースのデータを自動的にグリッドへ読込みます。DbNameはデータベース変数で、DIM WITH RECORDステートメントで予めセットします。DbFIeldNameListはデータベースのフィールド名のリストか、データベースのType構造名です。Conditionはオプションで、表示するレコードを選びます。フォーマットはIFステートメントと同じです。 | |
| .COL | カレント列を得るか設定します。範囲は1からCOLS。 |
| .COLS | 列数を得ます。 |
| .COLTYPE colNo, type, formatString | |
| 列のタイプとフォーマットを設定します。デフォルトはテキストタイプで値はnullです。違うタイプの列が必要な場合、実行時にこのメソッドを使って設定します。colNoはグリッド内の列の番号です。タイプは"text"(テキスト)、"numeric"(数値)、"checkbox"(チェックボックス)のどれかになります。formatStringには文字列を入れますが、typeの値によってことなります。typeが"text"の場合、セルに最初に表示される文字列をformatStringに入れます。"numeric"の場合、FORMATステートメントで使われるフォーマット文字列を入れます。"checkbox" の場合、チェックボックスの右にくる文字列を入れます。 | |
| .COLWIDTH(colNo) | colNo(列番号)の列の幅を得るか設定します。 |
| .ROW | カレント行を得るか設定します。範囲は1からROWS。 |
| .ROWDATA | 行のrowdata値を得るか設定します。ユーザが定義する値。 |
| .ROWS | 行数を得るか設定します。 |
| .TEXT | テキストタイプのカレントセルの値を得るか設定します。 |
| .TEXTMATRIX(rowNo, ColNo) | rowNo(行番号)とColNo(列番号)のセルのテキスト値を得るか設定します。 |
| .VALUE | 数値タイプのカレントセルの値を得るか設定します。 |
| .VALUEMATRIX(rowNo, ColNo) | rowNo(行番号)とColNo(列番号)のセルの数値を得るか設定します。 |
サポートされてるプロパティ(デザイン時にセット)
Cols, Has Scrollbar, Height, Left, Top, Visible Rows, Width
他のサポートされてるメソッド("Methods"参照)
Add, Clear, Hide, Redraw, Remove, Show