ActiveX Controls Guide (v11)

Btrv (ActiveX メソッド)

適用対象

VAccess

説明

VAccess コントロールに関連付けられているファイルに対して Pervasive PSQL オペレーションを実行し、そのオペレーションのステータスを返します。

構文

object.Btrv opcode 

Btrv メソッドの構文は次のような要素で構成されます。

要素
説明
object
必須。object プレースホルダーは、[適用対象]のオブジェクトを評価するオブジェクト式を表します。
opcode
必須。実行する Pervasive PSQL オペレーションを指定します。

備考

VAccess コントロールで実行可能な Pervasive PSQL 関数はどれでも、Btrv メソッドを用いて使用することができます。このメソッドは単一パラメーター、opcode を使用します。opcode 定数宣言は、GLOBAL.BAS ファイル(Visual Basic の場合)、GLOBAL.PAS ファイル(Delphi の場合)および GLOBAL.H ファイル(Visual C++ の場合)に含まれています。アプリケーションで opcode 定数を使用するには、これらのファイルのうち 1 つ、開発環境に適したファイルをプロジェクトに含めます。

次のような opcode 設定が可能です。

コード
グローバル定数
説明
0
BTO_Open
VAccess コントロールの TableName として指定された Pervasive PSQL ファイル テーブルを開きます。
1
BTO_Close
Pervasive PSQL テーブルを閉じます。
2
BTO_Insert
Pervasive PSQL テーブルにメモリ内の現在のレコードを挿入します。
3
BTO_Update
Pervasive PSQL テーブル内の現在のレコードをメモリ内の現在のレコードに含まれるデータで更新します。
4
BTO_Delete
現在のレコードをファイルから削除します。
5
BTO_GetEqual
指定された FieldValue に等しいインデックス値を持つ最初のレコードを取得します。
6
BTO_GetNext
現在のインデックス パスで次のレコードを取得します。
7
BTO_GetPrevious
現在のインデックス パスで前のレコードを取得します。
8
BTO_GetGreater
指定された FieldValue のインデックス値より大きいインデックス値を持つレコードを取得します。
9
BTO_GetGreaterOrEqual
指定された FieldValue のインデックス値より大きいか、等しいインデックス値を持つレコードを取得します。
10
BTO_GetLess
指定された FieldValue のインデックス値より小さいインデックス値を持つレコードを取得します。
11
BTO_GetLessOrEqual
指定された FieldValue のインデックス値より小さいか、等しいインデックス値を持つレコードを取得します。
12
BTO_GetFirst
現在のインデックス パスで最初のレコードを取得します。
13
BTO_GetLast
現在のインデックス パスで最後のレコードを取得します。
22
BTO_GetPosition
Pervasive PSQL ファイル内の現在のレコードの物理位置を、VAccess コントロールの Position プロパティにセットします。
23
BTO_GetDirect
VAccess コントロールの Position プロパティで指定されているレコードを取得します。
24
BTO_StepNext
VAccess から、現在のレコードの物理的に次にあたる位置からレコードを取得します。
30
BTO_ClearOwner
ファイルの現在のオーナー ネーム セキュリティをクリアします。メモ:ファイルは既存のオーナー ネームを使用して先に開いておく必要があります。
33
BTO_StepFirst
ファイルの先頭の物理位置にあるレコードを取得します。
34
BTO_StepLast
ファイルの末尾の物理位置にあるレコードを取得します。
35
BTO_StepPrevious
VAccess から、現在のレコードの物理的に前にあたる位置からレコードを取得します。

オペレーション コードにロック バイアスを加算することによって、Pervasive PSQL のレコードをロックできます。Btrv では Get または Step オペレーションにロックを指定することができます。ロックを解除する場合は、Unlock メソッドを使用します。ロック バイアスは次のとおりです。

ロック バイアス
グローバル定数
説明
200
BTO_SingleNoWait
単一レコード ノーウェイト ロックです。レコードが既にロックされている場合、Pervasive PSQL はアプリケーションにステータス コード 84(レコードが使用中)のエラーを返します。
400
BTO_MultiNoWait
複数レコード ノーウェイト ロックです。レコードが既にロックされている場合、Pervasive PSQL はアプリケーションにステータス コード 84(レコードが使用中)のエラーを返します。

If Check1.Value = 1 Then 
    stat = VAccess1.Btrv(5) 'GetEqual 
Else 
    stat = VAccess1.Btrv(9) 'GetGreaterOrEqual 
End If 

AddItem (ActiveX メソッド)

Clear (ActiveX メソッド)