VBMan Controls for Btrieve
Programming manual
Version 3.30
目次
目次 .............................................................................................................2
製品概要........................................................................................................8
はじめに .......................................................................................................8
システムの構造について ...............................................................................9
MICROSOFT .NET対応について ..................................................................9
対応言語について.......................................................................................10
VBMANツール・ボックス .............................................................................10
VBMAN DDFビルダー ..............................................................................11
BTRIEVEデータ型について..........................................................................11
データ・アクセス・メソッド/関数 .....................................................................12
使用権........................................................................................................12
ユーザー・サポート......................................................................................13
保証規定 ....................................................................................................15
販売元........................................................................................................16
開発元、ユーザーサポート ..........................................................................16
インストール .................................................................................................18
システム条件 ..............................................................................................18
コピープロテクト・ハードウェアのインストール ...............................................18
センチネル・ハードウェアのインストール ...................................................19
USBセンチネルの設置................................................................................... 19
パラレルポート接続センチネルの設置 ............................................................. 19
センチネル・ドライバーのインストール ......................................................20
センチネル・ドライバーの更新について ............................................................ 21
VBMAN CONTROLS FOR BTRIEVEのインストール .....................................21
インストールされるファイルについて ............................................................22
添付のBTRIEVE 6.15 ワークステーションエンジンについて .........................24
システム設定ファイル..................................................................................25
VBMAN.INIファイル..............................................................................25
Btrieveエンジンの設定 .................................................................................. 26
Pervasive.SQL対応について......................................................................... 26
チュートリアル ..............................................................................................28
BTRIEVEデータベースの定義......................................................................28
概要........................................................................................................28
VBMan DDFビルダーによるレコード定義..............................................28
Visual C# .NETでデータ参照フォームを作成 .......................................31
Visual Basicでデータ入力フォームを作成..............................................35
サンプルプログラムについて .........................................................................42
2
.NET用サンプルについて...........................................................................42
VISUAL BASIC 6.0 用サンプルプログラムについて .....................................43
ASP用サンプルプログラムについて ............................................................44
コンパチビリティ............................................................................................45
VISUAL BASIC.NETへの移行 ....................................................................46
VBMAN ACTIVEX CONTROL FOR BTRIEVE バージョン 3.Xからの移行....46
VBMAN FOR BTRIEVE/OCX32 バージョン 2.0 からの移行........................46
変換ツール..............................................................................................47
手動によるフォーム変換 ..........................................................................47
VBMAN FOR BTRIEVE/VBX バージョン 1.Xからの移行.............................49
フォームの変換 .......................................................................................49
データアクセス関数の移行 ......................................................................50
VBMan DDFビルダーの機能................................................................52
カスタム・コントロール・リファレンス ................................................................53
データベース・コントロール ......................................................................53
ボタン・コントロール ................................................................................55
エディット・コントロール............................................................................57
スクロール・コントロール .........................................................................58
チェック・ボックス・コントロール ................................................................59
オプション・ボタン・コントロール ...............................................................60
リスト・ボックス・コントロール ...................................................................61
コンボ・ボックス・コントロール ..................................................................63
ピクチャー・コントロール ..........................................................................65
拡張リスト・ボックス・コントロール ............................................................67
拡張コンボ・ボックス・コントロール ...........................................................70
グリッド・コントロール ..............................................................................73
カスタム・プロパティ・リファレンス ...................................................................76
Abort ............................................................................................................ 76
AlignFixedCells ........................................................................................... 76
AllOpen ........................................................................................................ 77
AllowDelete.................................................................................................. 77
AllowUpdate ................................................................................................ 78
AllowUserResizing ...................................................................................... 78
AutoFirst...................................................................................................... 78
BlobPath ...................................................................................................... 79
CacheDDF.................................................................................................... 80
CellMaxLength ............................................................................................ 80
ClearControlData ........................................................................................ 80
ConfirmMsg ................................................................................................. 81
DbCompareCase .......................................................................................... 81
DbConditions ............................................................................................... 82
3
DbDelimitChar ............................................................................................ 83
DbExOperation............................................................................................ 84
DbField ........................................................................................................ 84
DbIndex........................................................................................................ 85
DbLeaveResults........................................................................................... 85
DbListFields ................................................................................................ 86
DbListIndex ................................................................................................. 86
DbListSource ............................................................................................... 87
DbListTable ................................................................................................. 87
DbLocks ....................................................................................................... 88
DbMaxRecords............................................................................................. 88
DbOperation ................................................................................................ 89
DbPhysicalPosition...................................................................................... 90
DbResultID .................................................................................................. 90
DbSavePosition............................................................................................ 91
DbSkipRecords ............................................................................................ 91
DbSource...................................................................................................... 92
DbTable........................................................................................................ 92
DbTabStops ................................................................................................. 92
DbUpdateOption ......................................................................................... 93
DbValueFalse .............................................................................................. 93
DbValueIndetraminate ............................................................................... 94
DbValueTrue ............................................................................................... 94
DDFDir ........................................................................................................ 95
DistName ..................................................................................................... 95
Format ......................................................................................................... 95
FormatOption .............................................................................................. 96
FormatString ............................................................................................... 97
NumericMask .............................................................................................. 97
OpenMode .................................................................................................... 98
OwnerName................................................................................................. 98
ReadOnly ..................................................................................................... 99
SetColNames ............................................................................................... 99
SetColWidth................................................................................................. 99
SetRecordNumber ....................................................................................... 99
TextAlign ................................................................................................... 100
UpperCase ................................................................................................. 101
カスタム・イベント・リファレンス ....................................................................102
AfterColUpdate.......................................................................................... 102
AfterDelete................................................................................................. 102
AfterUpdate ............................................................................................... 102
BeforeColUpdate ....................................................................................... 103
BeforeDelete .............................................................................................. 103
BeforeUpdate............................................................................................. 104
BtrieveError .............................................................................................. 104
Format ....................................................................................................... 105
SetData ...................................................................................................... 106
カスタム・メソッド・リファレンス......................................................................108
DbAbortTransaction.................................................................................. 108
4
DbAccess .................................................................................................... 108
DbAccessByID ........................................................................................... 109
DbBeginConCurTransaction..................................................................... 111
DbBeginTransaction ................................................................................. 111
DbClearControlData ................................................................................. 111
DbClearFieldBuffer ................................................................................... 112
DbClose ...................................................................................................... 112
DbCloseAll ................................................................................................. 113
DbCreate.................................................................................................... 113
DbEndTransaction .................................................................................... 114
DbExAccess................................................................................................ 114
DbExFree ................................................................................................... 118
DbExGetFieldData .................................................................................... 118
DbExGetPosition ....................................................................................... 119
DbExSetMode ............................................................................................ 119
DbFindPercentage..................................................................................... 120
DbGetByPercentage .................................................................................. 121
DbGetDataSize .......................................................................................... 122
DbGetDataType......................................................................................... 122
DbGetDirect............................................................................................... 123
DbGetFieldData ........................................................................................ 124
DbGetFieldDataByID................................................................................ 125
DbGetFieldName....................................................................................... 125
DbGetIndexName...................................................................................... 126
DbGetModulePath..................................................................................... 126
DbGetNumOfField .................................................................................... 127
DbGetNumOfIndex ................................................................................... 128
DbGetNumOfRecords................................................................................ 128
DbGetNumOfTable ................................................................................... 129
DbGetPosBlock .......................................................................................... 129
DbGetPosition............................................................................................ 130
DbGetRecord.............................................................................................. 130
DbGetRecordImage ................................................................................... 131
DbGetRecordLength.................................................................................. 132
DbGetTableName ...................................................................................... 133
DbIsNull .................................................................................................... 133
DbIsOpen ................................................................................................... 134
DbLoadDDF............................................................................................... 134
DbLogIn ..................................................................................................... 135
DbLogOut .................................................................................................. 135
DbOpen ...................................................................................................... 135
DbOpenAll ................................................................................................. 136
DbReset...................................................................................................... 137
DbSetFieldData ......................................................................................... 137
DbSetFieldDataByID ................................................................................ 138
DbSetFileName ......................................................................................... 139
DbSetLockBias .......................................................................................... 139
DbSetRecord .............................................................................................. 141
DbSetRecordImage.................................................................................... 142
DbTransferFromControl ........................................................................... 143
DbTransferToControl ................................................................................ 143
5
DbUnlock ................................................................................................... 144
バージョン 1.Xデータ・アクセス関数.............................................................145
DbAbortTransaction.................................................................................. 147
DbAccess .................................................................................................... 148
DbAttachControl ....................................................................................... 150
DbBeginTransaction ................................................................................. 151
DbClearControlData ................................................................................. 152
DbClearFieldBuffer ................................................................................... 153
DbEndTransaction .................................................................................... 154
DbExAccess................................................................................................ 155
DbExFree ................................................................................................... 159
DbExGetFieldData .................................................................................... 160
DbExGetPosition ....................................................................................... 161
DbExSetFormattedString ......................................................................... 162
DbFindPercentage..................................................................................... 163
DbGetByPercentage .................................................................................. 164
DbGetDataSize .......................................................................................... 165
DbGetDataType......................................................................................... 166
DbGetDirect............................................................................................... 167
DbGetFieldData ........................................................................................ 168
DbGetFieldName....................................................................................... 169
DbGetPosition............................................................................................ 170
DbGetVersion ............................................................................................ 171
DbSetFieldData ......................................................................................... 172
DbSetFormattedString.............................................................................. 173
DbTransferFromControl ........................................................................... 174
DbTransferToControl ................................................................................ 175
DbUnlock ................................................................................................... 176
作成したアプリケーションの配布..................................................................177
DDFビルダー・リファレンス .........................................................................180
DDFビルダーの起動 ................................................................................180
新規DDFの作成 ......................................................................................180
フィールドの定義.......................................................................................182
インデックスの定義 ...................................................................................183
既存DDFの編集 ......................................................................................185
データ変換モードの動作について ..............................................................185
テーブルの搬入・搬出 ...............................................................................186
DBMAGICデータ辞書を搬入 ......................................................................186
VISUAL BASIC用フォームの生成 ..............................................................187
フィールドIDリストの生成 ..........................................................................187
システム・オプションについて.....................................................................188
APPENDIX ..............................................................................................193
A. MICROSOFT VISUAL STUDIO.NET 制約事項.....................................193
6
B. ACTIVE SERVER PAGESからの利用 ....................................................193
概要・制約事項 .....................................................................................193
ASPスクリプトの作成手順 .....................................................................194
C. FAQ – よくあるご質問 ........................................................................196
エラー・メッセージ .......................................................................................205
VBMANエラー・コード................................................................................214
DDFビルダー・メッセージ............................................................................217
BTRIEVEステータス・コード.......................................................................227
VBMAN CONTROLS FOR BTRIEVE 調査依頼フォーム ....................231
7
製品概要
はじめに
VBMan Controls for Btrieve ver 3.30をお買い上げくださりまことにありがとう
ございます。当製品はPervasive Software社のBtrieveデータ・ベース・エンジン
をアプリケーションから容易にハイ・パフォーマンスで利用できるように設計され
たCOMコンポーネントです。（以下、VBMan Controls for BtrieveをVBManと記
述する場合があります）VBManは13個のカスタム・コントロールと日本語DDFビ
ルダー、バージョン1.xコンパチブル・データ・アクセス関数で構成されます。当カ
スタムコンポーネントはVisual Basicや.NET Windows Formsの標準のコントロ
ールにBtrieveデータベース・アクセス機能を追加したコントロールです。VBMan
におけるアプリケーションの開発ではのDDF定義が終了後、フォームにVBMan
カスタム・コントロールを配置し、必要なプロパティを選択するだけで、実行可能
なBtrieveアプリケーションが完成します。簡単なアプリケーションであれば、１行
もコードせずにプログラムを完成することも可能です。
以下はVBMan Controls for Btrieve ver 3.30で追加された機能です。
①
②
③
④
Microsoft Visual Studio .NET 2005に対応。
Pervasive.SQL V8 セキュアデータベース対応。
Pervasive.SQL V8.6 SP3対応。
ATL version 7.1を採用。
以下はVBMan Controls for Btrieve ver 3.20で追加された機能です。
①
②
③
④
⑤
Microsoft .NET framework のWindows Forms対応
Microsoft Visual Studio .NET 開発環境に対応。
BIT型,8byte Integer型データに対応。
ATL version 7.0を採用。
USB Sentinelのサポート。
以下は従来からのVBMan Controls for Btrieve の特徴です。
①
②
③
ATLで作成された軽量コントロールです。MFC等サイズが大きいランタイム
への依存はありません。イントラネットでの配布が簡単になりました。
アパートメント・スレッド形式をサポート。サーバー・コンポーネントとして利
用可能。
Pervasive.SQL 2000i (SP3)対応。
8
④
⑤
⑥
⑦
DDFに準拠したBtrieve呼び出しが簡単に記述できます。DDFに準拠したア
プリケーションは他のアプリケーションとDDFを介してデータ交換が可能で
す。
DDFキャッシングを実現。複数コントロールが同じDDFを参照している場合
はDDFをロードしないのでパフォーマンスが向上します。
豊富なコントロール・プロパティにより、アプリケーションの開発工程を短縮
できます。
dbMagicのデータ辞書からのDDF定義移行機能。
システムの構造について
VBManは マイクロソフト社のCOM/ActiveX Control仕様に沿って作成されてい
ます。カスタム・コントロールとしては、グリッド・コントロール以外はWindowsの標
準コントロールをサブ・クラスした形で実現しています。ランタイム関数、クラス・
ライブラリはマイクロソフトVisual C++ .NET ATL version 7.1を使っています。
以下はシステム構造の概略図です。
COM コ ン ト ロ ー ル サ ポ ー ト 言 語
( V B .N E T C # な ど )
V B M a n C o n tr o ls f o r B tr ie v e
3 2 b it B t r ie v e エ ン ジ ン
Microsoft .NET 対応について
当 version 3.30 から Microsoft Visual Studio.NET2005 での Windows Forms
による開発環境のサポートいたします。 Microsoft Visual Studio.NET/ .NET f
ramework では従来の Visual Basic による ActiveX Control 利用では動作可能
であったメソッドやプロパティで動作しなくなったものがあります。詳細は Append
ix-E に記載しましたのでご参照ください。
Microsoft .NET framework ではウェブアプリケーションの開発を ASP.NET で行
えます。ASP.NET での開発は当製品のような COM コンポーネントを利用する
のではなく、.NET framework 形式のマネージドライブラリを使って開発する方
法をお勧めしています。弊社製品で Pervasive.SQL/Btrieve にアクセスすること
の出来る製品としては Btrieve Classes for .NET がございますので、こちらを
9
利用した開発お勧めいたします。
対応言語について
2005 年 11 月現在、COM/ActiveX Control をサポートする言語製品は多数市
場に出回っていますが、各言語で COM/ActiveX Control のサポートは同一で
はなく、動作の違いが確認されています。弊社コントロールでできるだけ多くの
言語に対応するように努力はしておりますが、言語製品は他社から供給される
ものであり、弊社一社の力では対応できない場合ございますのであらかじめご
了承ください。
動作を確認できたホスト言語、制約事項などは弊社 web サーバーにて情報を
公開いたします。また、販社システム・ラボでも情報を提供いたします。
VBMan ツール・ボックス
VBMan をインストールすると、以下のカスタム・コントロールが言語アプリケーシ
ョンのツール・ボックスに追加されます。これらのコントロールをフォーム、ダイア
ログ等に配置することにより、簡単に Btrieve にアクセス可能なアプリケーション
を作成可能です。
データベース
編集テキスト
コマンド・ボタン
水平スクロール
垂直スクロール
チェック・ボックス
オプション・ボタン
リストボックス
このコントロールをフォームに置くことにより、Btriev
eデータベース・アクセスが可能となります。最初に
フォームに設定します。
Btrieveのフィールドと文字データの交換をします。
日付、時間、金額は自動フォーマット入力が可能で
す。
Btrieveのオペレーション（追加、削除など）を実行し
ます。
Btrieveデータベースのレコードの移動に使用しま
す。
Btrieveデータベースのレコードの移動に使用しま
す。
論理型データを設定するチェック・ボックスです。
論理型、整数型のデータを設定します。
Btrieveデータベースの指定フィールドのリストを表
示、選択します。
10
コンボ・ボックス
ピクチャー
拡張リストボックス
拡張コンボボックス
グリッド
Btrieveデータベースの指定フィールドのリストを表
示、選択します。
Btrieveデータベースの情報により、ビットマップ、メ
タファイル、アイコンを表示します。
BtrieveのExtendedオペレーションに対応したリスト
ボックスです。
BtrieveのExtendedオペレーションに対応したコンボ
ボックスです。
BtrieveのExtendedオペレーションでグリッドにデー
タを表示します。
VBMan DDF ビルダー
VBMan Controls for BtrieveにはBtrieve 6.15等、DDF編集環境をお持ちでな
いお客様のために、VBMan DDF ビルダーを添付しています。VBMan DDFビ
ルダーはBtrieve 6.15当時のBtrieveデータ型のみサポートする仕様になります
ので、Pervasive.SQLをお使いのお客様はDDFの編集、データベース入力にはP
ervasive Control Centerをお使いください。
Btrieve データ型について
VBMan Controls for Btrieve は Btrieve の拡張データ・タイプとして定義される
以下のデータ・タイプをサポートします。データ型の内部形式は Pervasive SDK
マニュアルや Btrieve プログラマーズ・マニュアルを参照してください。
データ型
String
特記事項
Integer
Float
Date
Time
Decimal
Money
サイズは1,2,4,8バイトをサポート
サイズは4,8バイトをサポート
yyyy/mm/ddまたはyy/mm/ddフォーマット
Hh:mm:ssフォーマット
Logical
Numeric
Numericsa
内部表現はDECIMALと同じ。VBManEditにFormat文字
列を指定しない場合に金額表示形式の自動フォーマッ
ト
１バイト型をサポート
11
Numericsts
Bfloat
Lstring
Zstring
Unsigned Binary
指定するサイズは先頭１バイトの長さを含む
指定するサイズは終端のヌル文字を含む
Auto Increment
Note
LVar
Bit
Currency
Blob
3.3000バイトまで。デリミタはヌルをサポート
3.3000バイトまで
Long varcharに対応。
データ・アクセス・メソッド/関数
アプリケーション作成において、たとえば集計処理などを記述する際には、VBM
an for Btrieve/VBX ver 1.xではDDFにしたがって、容易にBtrieveにアクセス
可能とする、データ・アクセス関数が用意されていました。VBMan Controls for
Btrieveでは、これらの関数はデータ・ベース・コントロールのメソッドとして提供さ
れます。またバージョン1.5までは関数のパラメータはすべて整数のIDでしたが、
32Bit環境で文字列領域に余裕があると判断し、これらのパラメータはすべて文
字列で指定可能となりました。以下はVBMan Controls for BtrieveをVisual Ba
sicから利用する際のコード例です。
Dim Code$, rc As Integer
Code$ = Text1.Text
With VBMBtr1
Call .DbSetFieldData(“商品”,”コード”, Code$)
rc = .DbAccess( BTR_GET_EQUAL, “商品”, “コード”)
If rc <> 0 Then
MsgBox “Btrieveエラー “ & CStr(rc)
Stop
End If
End With
使用権
12
使用権とは、お客様が１台のパーソナル・コンピュータ・システムでVBMan Cont
rols for Btrieveの開発環境を利用することが出来る権利です。
VBMan Controls for Btrieveの使用権はいかなる方法によっても第三者
に譲渡および貸与することは出来ません。
使用権はVBMan Controls for Btrieveのディスケット・パッケージを開梱し
たときに発効します。一度開梱した商品の返品には応じることはできませ
ん。
ランタイム・モジュールのライセンス料は無料です。お客様のアプリケーシ
ョンと一緒に配布可能なファイルは当マニュアルの「インストール」にあるモ
ジュール一覧をご覧ください。
当製品の利用によるお客様の損失等に関してましては弊社および、販社
システム・ラボは一切責任を負いませんのでご了承ください。
使用権は以下のいずれかの事由が起こった場合に消滅します。
1.
2.
3.
4.
5.
当ソフトウェアの不正な使用により弊社に著しい損害を与える場合。
購入者が使用規定に違反した場合。
プログラム・ディスク、印刷物などを使用権の範囲外の目的で複製し
た場合。
購入者がVBMan Controls for Btrieveに同封されているユーザー登
録書を返送しない場合。
当製品をリバース・エンジニアリングの対象として利用した場合。
ユーザー・サポート
ユーザー登録
当製品には、ユーザー登録用紙を添付しています。お買い上げのあと、で
きるだけ早い機会に、必要事項をご記入の上、販売会社システムラボまで
ファックスにてご返送Iいただくか、システムラボのWebSiteにてご登録をお
願いいたします。(http://www.systemlab.co.jp/vbman/productvb7.htm)ユ
ーザー登録が行われていないと、ユーザーサポートが受けられない場合
がございます。
質問のご担当について
基本的にユーザー登録された方以外のユーザー・サポートへのお問い合
わせにはご返答することは出来ません。管理者の方のお名前でユーザー
登録されている場合には開発者の方１名様のみサポートの対象になりま
す。１ユーザー版をご利用のお客様で複数のお名前の連名でのご質問を
される場合がありますが、そのような場合は不正コピー使用とみなし、サポ
ートを打ち切らせていただく場合もございますので、あらかじめご了承くだ
さい。
13
お問い合わせの方法
当製品につきましては、製品の性格上複雑なやりとりになることが多く、記
録を残すためにも、電話によるユーザーサポートはいたしておりません。フ
ァックスまたは電子メールでのお問い合わせのみ承りますのであらかじめ
ご了承をお願いいたします。
ファックスでのお問いあわせの場合は巻末にあります「調査依頼書」に必
要事項をご記入の上、テクナレッジまでファックスで送信してください。電子
メールでのお問い合わせにつきましては、同様に巻末の「調査依頼書」に
あります項目を記入の上、メール・アドレスは[email protected]
宛てお送りください。
サポート期間について
無償サポートはユーザー登録終了後、最初のサポートを開始した日から9
0日間、３インシデントを上限といたします。ただし、キャンペーン期間にお
買い求めになったパッケージは追加パッケージをお買い求めになった場合
はサポート期間が別途設定される場合もあります。無償サポート終了後に
は有償サポート・サービスもご用意しております。詳細はお手数ですが販
社システム・ラボまでおたずねください。
サポート内容について
VBManのサポートでは弊社製品に関するお問い合わせに限定させていた
だきます。Pervasvei.SQL/Btrieveの使い方に関するお問い合わせは該当
サポートを提供している会社宛てお願いいたします。また、お客様が作成
されるアプリケーションの仕様に関する事や、一般的なプログラム･ロジック
等をご質問されてもユーザー・サポートではお答えすることはできません。
製品サポート情報の公開
テクナレッジでは当製品の最新サポート情報を弊社webサーバーにて公開
しています。(http://www.techknowledge.co.jp)また、最新バージョンのモジ
ュールがダウンロード可能になっております。サポートにお問い合わせに
なる前にぜひご参照ください。
サポートのパフォーマンスについて
簡単なお問い合わせであれば、１労働日以内を目標にサポートをしていま
す。調査を必要とするお問い合わせには、回答に時間がかかる場合があ
りますので、あらかじめご了承をお願いいたします。サポートには優先順位
はありませんが弊社内に到着順、情報の蓄積があるものから処理してい
きます。サポート用紙に「納期が近いので」とか「回答を早く」などの記述を
された場合でも受付順が変更されることはありませんのでご了承ください。
また回答スケジュール、調査スケジュール、返答期限等の具体的な日程
は当サポートでは提示出来ませんのでご了承ください。
依存するサポートが発生した場合について
マイクロソフトのMSDNやWeb Siteからの情報でご質問の回答が出来る場
合は無償サポートやご契約いただいた有償サポートの範囲で処理できる
のですが、マイクロソフト等の有償サポートを受けないとお客様に十分な情
報を提供できない場合があります。そのような場合はお客様に有償サポー
14
ト料金について、別途ご請求のご連絡をさせていただき、了承、入金後に
該当サポートを実施させいただきます。もちろん、別途料金のご請求を拒
否されて、サポートを中断する選択もお客様におきましては可能でござい
ます。
登録内容の変更について
転居などによるご住所や電話番号など登録内容に変更が生じた場合には、
郵送、ファックス、または電子メールにて、販売会社システム・ラボまでご連
絡をいだだきますようお願いいたします。なお、電話による口頭での連絡
変更は受けかねますので、よろしくお願いいたします。
併用される他社製品について
当社製品と併用される、他社製品の使用方等についてのご質問をお受け
することがあります。しかし、他社製品に関しましては、お答えできない場
合があります。他社製品につきましては、概当開発、販売会社または製品
サポート会社にご連絡ください。
保証規定
当製品、および付随する著作物に対して商品性及び特定の目的への適合性など
についての保証を含むいかなる保証もそれを明記するしないに関わらず提供され
ることはありません。
当製品の著作者及び、製造、配布に関わるいかなる者も、当ソフトウェアの不具
合によって発生する損害に対する責任は、それが直接的であるか間接的である
か、必然的であるか偶発的であるかに関わらず、負わないものとします。それは、
その損害の可能性について、開発会社に事前に知らされていた場合でも同様で
す。
15
販売元
（株）システムラボ
東京都杉並区上荻１丁目５番８号 直長ビル７Ｆ
電話：
03-5397-7511
FAX：
03-5397-7521
E-Mail：
[email protected]
Web：
www.systemlab.co.jp
開発元、ユーザーサポート
（株）テクナレッジ
東京都世田谷区駒沢２丁目１６番１号 サンドービル ９Ｆ
電話:
03-3421-7621
FAX:
03-3421-6691
E-Mail:
[email protected]
Web:
www.techknowledge.co.jp
商標登録
本マニュアルに記載される商標、登録商標は該当会社の商標または登録商標
です。
16
17
インストール
VBMan Controls for Btrieve のインストールについて説明します。
システム条件
VBMan Controls for Btrieve を動作させるには、以下の前提となるソフトウェア
環境が必要となります。
①
②
③
Microsoft Windows95/98/ME または Windows NT 4.0 SP3 以降また
は Windows2000/XP/Windows 2003 Server
COM/ActiveX Control をサポートする 32Bit 言語製品
Btrieve バージョン 6.15 または Btrieve 7.0 または Pervasive.SQL 2000
i(SP3), Pervasive.SQL V8.6 SP3 まで。
32Bit Btrieve 環境に関しては VBMan には Btrieve for Windows 95/NT versi
on 6.15 のワークステーション・エンジンが添付されています。このエンジンは P
ervasive Software 社が２次配布を禁止しているため、VBMan をインストールし
たパソコンでは利用することは可能ですが、お客様の開発したアプリケーション
に添付して配布することは禁止されております。十分ご注意ください。お客様の
アプリケーションを配布する際 Btrieve を同梱したい場合は、Btrieve エンジンを
別途お買い求めになり配布件を取得する必要があります。
また、アプリケーション開発においては Btrieve についての詳しいプログラミング
情報が必要になる場合が想定されます。そのよう場合は Pervaisve.SQL 開発
キットのマニュアルやサンプル・プログラムをご参照ください。弊社ユーザー・サ
ポートに Btrieve 自体の使用法、プログラミングの詳細、マニュアルの内容等を
ご質問されても、返答いたしかねます。Btrieve や Pervasive.SQL に関してはエ
ージーテックのサポートをご利用ください。
コピープロテクト・ハードウェアのインストール
VBMan Controls for Btrieve を開発環境でご利用になるためにはセンチネルと
いう不正コピー防止用のハード・ウェアをインストールすることが必要になります。
大変お手数ですが以下の手順に従ってセンチネル本体とドライバー・ソフトウェ
アの設定をお願いいたします。尚、実行時にはセンチネル環境は不要となって
おります。
18
センチネル・ハードウェアのインストール
VBMan Controls for Btrieve を開発環境でご利用いただくためには、製品パッ
ケージに添付されるセンチネルを USB ポートまたはプリンタ・ケーブルの先に設
置することが必要になります。USB センチネル、または、パラレルポート接続セ
ンチネルのいずれかが、お客様の購入時のご選択に従ってパッケージに同梱さ
れておりますので、ご選択されたセンチネル設定方法に従って設置をお願いい
たします。
USB センチネルの設置
USB センチネルをパソコンの USB ポートに差し込んでください。別途ケーブル
類は必須ではありませんが、複数 USB ポートをお使いになる場合、パソコン側
の USB ポートに空きが無い場合はお手数ですが、USB ハブをご用意のうえ、U
SB センチネルの接続をお願いいたします。
当製品で利用できる USB センチネルは番号 SGS01266 0247-UM と印刷され
たシールが張ってあるものです。外観は以下のようになります。USB ポートに接
続すると緑の LED が点灯します。
パラレルポート接続センチネルの設置
以下の図を参照して、センチネルを接続してください。センチネルはパソコンとプ
リンター・ケーブルで接続されることは必須となりますが、プリンターとの接続は
必須ではありませんのでプリンターを接続しない場合にはセンチネルのオス側
は開放されたままでご利用ください。
当製品に添付されるセンチネルは番号 J4QJJCE-B36 が印刷されたシールが
張ってあるものです。外観は以下のようになります。
19
以下はパラレルポート接続センチネルの設置図（例）です。
プリンタ・ケーブルが別途必要になりますことをあらかじめご了承願います。
また、複数のセンチネルをお使いになるような場合、センチネルを入れ子にして
利用することが可能となっております。
センチネル・ドライバーのインストール
センチネルをオペレーティング・システムを経由して認識させるためにはデバイ
ス・ドライバーのインストールが必要になります。以下はインストールの手順です。
センチネルドライバーは USB センチネル、パラレルポートセンチネルで共通で
すので同じ手順でドライバーをインストールしていただくことになります。
①
②
③
④
VBMan インストール CD をドライブに挿入します。
Sentinel フォルダーに移動します。
RainbowSSD5.39.2.EXE をコマンド・プロンプトまたはエクスプローラーを起
動して実行します。
インストラクションに従ってインストーラーを作動させます。
20
USB センチネルの場合は一旦 USB センチネルの接続を解除するように求
められる場合がありますのでご注意ください。
センチネル・ドライバーの更新について
センチネルを認識しないパソコンにつきましては最初にセンチネル・ドライバー
のアップデートを試されることをお勧めいたします。弊社製品に添付されるセン
チネルのドライバーは最新バージョンを技研商事のウェブサイトから入手するこ
とが可能です。以下は技研商事の URL です。
http://www.giken.co.jp
VBMan Controls for Btrieve のインストール
VBMan Controls for Btrieve のインストールについて説明します。以下はイン
ストールの手順です。当バージョンから Btrieve 6.15 ワークステーションエンジ
ンは自動的にインストールされないように変更されましたのでご注意ください。B
trieve 6.15 ワークステーション・エンジンを使うには「添付の Btrieve 6.15 ワー
クステーションエンジンについて」をご参照ください。
①
②
③
④
⑤
すでに VBMan for Btrieve/VBX や VBMan for Btrieve/OCX32 がインス
トールされているパソコンに当製品をインストールする場合は、ウィンドウ
ズ・ディレクトリに VBMAN.INI ファイルが存在する場合があります。このファ
イルはお客様の既存の環境設定が保持されていますので、念の為に別デ
ィレクトリに退避してください。
VBMan ActiveX Control for Btrieve 3.X がすでにインストール済みの環
境にはインストールすることができませんので以前のバージョンをコントロ
ール・パネルのプログラムの追加と削除からアンインストールしてください。
Pervasive.SQL/Btrieveが利用可能な環境が準備できていない場合には、
インストールCDのルートにあるW32BTRV.DLLをパスの通っているフォルダ
ーにコピーします。 1
VBMan インストール CD ドライブに挿入します。
ルートにある setup.exe を起動します。
1
このステップを実行しない場合、インストールの最後に VBMBT330.OCX を登録
出来ないというエラーが発生します。W32BTRV.DLL は Btrieve API エントリが定
義してある DLL です。パスの通っているフォルダーで確実なのはシステムディレク
トリですが、後から Pervasive.SQL をインストールする場合には事前に削除してく
ださい。
21
⑥
⑦
⑧
setup.exe の質問に答えて OK ボタンをクリックすると自動的に導入が終了
します。すでに Btrieve の開発キット等をインストールされているパソコンの
場合は、カスタム・インストールを選択して、VBMan に添付される 32Bit の
ワークステーション・エンジンのインストールをしない方法も選択可能です。
インストールが正常に終了するとスタートメニューに VBMan のフォルダー
が作成されます。Windows NT の場合はプログラム・マネージャーに VBMa
n のプログラム・グループ作成されます。
readme.html ファイルにはマニュアルには記述されていない最新情報が記
述されています。インストールに関する最新情報が記述される場合もあり
ますので、必ずご一読ください。
Pervasive.SQL/Btrieve 環境が整っていない場合、インストールの最後に VBMB
T330.OCX コントロールのレジストリ登録が失敗することがあります。そのような
場合はパソコンが Btrieve API インターフェースがロードできないような設定に
なっていることが考えられます。
たとえば Pervasive.SQL をインストール済みの環境では c:\PVSW\BIN のような
モジュールへの PATH に設定されていない場合が考えられます。Pervasive.SQ
L/Btrieve のツール類は動作するが VBMan のインストールは失敗するような場
合は PATH のご確認をお願いします。
インストールされるファイルについて
Windows のディレクトリを<win>, Windows のシステム・ディレクトリを<sys>、VBM
an の導入ディレクトリを<instdir>とした場合に導入されるファイルの一覧を以下
に示します。デフォルトインストールでは<instdir>は c:\program files\TechKno
wledge\VBMan Controls for Btrieve となります。Windows NT/2000/XP の場
合、システム・ディレクトリは system32 ディレクトリとなりますのでご注意ください。
お客様の作成したアプリケーションに添付して配布するモジュールには「再配
布」のカラムに「可」と記述されるものに限定されます。それ以外のモジュールを
配布した場合、著作権法違反となりますので十分ご注意ください。
デフォルト・パスとファイル名
<sys>\vbmbt330.ocx
<sys>\ddfio330.dll
内訳
VBMan ActieX Control
s for Btrieve version
3.30 実行ファイル
DDFサポート32bit DLL
再配布
可
可
22
<sys>\dibapi32.dll
<sys>\msflxgrd.ocx
<instdir>\man\readme.txt
<instdir>\bin\vbmddf.exe
<instdir>\bin\vbmconv.exe
<instdir>\man\vbmbt330.hlp
<instdir>\man\vbmddf32.hlp
<indtdir>\samles\vb\vbmanv1.bas
<instdir>\samples\vbmddf32.exe
<instdir>\samples\regsvr32.exe
<instdir>\samples\vb\*.*
<instdir>\samples\asp\*.*
<instdir>\btr615\w32mkde.exe
<instdir>\btr615\w32mkrc.dll
<instdir>\btr615\wbtrv32.dll
<instdir>\btr615\wbtrcall.dll
<instdir>\btr615\wbtrvres.dll
<instdir>\btr615\wbtrv32.dll
<instdir>\btr615\w32mkset.hlp
マイクロソフト提供のグ
ラフィック関連DLL
マイクロソフトのグリッド・
コントロール。DDFビル
ダーが使用。
VBMan最新情報などの
記述
DDFビルダー
バージョンコンバーター
VBManヘルプファイル
VBMan DDF ビルダー
ヘルプファイル
VBManバージョン1.0コン
パチブル関数定義Visual
Basicソース
VBMan DDF ビルダー
実行ファイル
マイクロソフトのOLEカス
タム・コントロール登録プ
ログラム。 2
VB用サンプル・プログラ
ム
ASP用サンプル・プログ
ラム
Btrieveワークステーショ
ン・エンジン。
上記ファイルのリソース
DLL
BtrieveエンジンDLL
Btrieve 16bit実行モジュ
ール
上記ファイルのリソース
DLL。
Btrieve API 32bitインタ
ーフェース
Btrieve設定プログラム・
ヘルプ
可
可
不可
不可
不可
不可
不可
不可
不可
可
不可
不可
不可
不可
不可
不可
不可
不可
不可
2
\windows の system ディレクトリにある vbmbt3.30.ocx, msflxgrd.ocx をこのプロ
グラムでレジストリに登録します。また、ActiveX Control をアンインストールする
には/U オプションを使います。
23
<instdir>\btr615\w32mkset.exe
<instdir>\btr615\w32mkset.dll
<instdir>\btr615\wdbuui32.dll
<instdir>\btr615\wdbuei32.dll
<instdir>\btr615\wdbumk32.dll
<instdir>\btr615\wbtrthnk.dll
<instdir>\btr615\nwlocale.dll
<instdir>\btr615\w32bticm.dll
<instdir>\btr615\w32nr.dll
Btrieve設定プログラム
Btrieve設定プログラムD
LL
Btrieve DLL
Btrieve DLL
Btrieve DLL
BtrieveサンキングDLL
Btrieve DLL
Btrieve通信 DLL
Btrieve通信 DLL
不可
不可
不可
不可
不可
不可
不可
不可
不可
添付の Btrieve 6.15 ワークステーションエンジンについて
添付される Btrieve 6.15 ワークステーションエンジンはインストールディレクトリ
下の btr615 フォルダーにコピーされます。このエンジンを使いたい場合は、該
当フォルダーを PATH 変数に加えてください。デフォルトインストールではパス
が非常に深いので、c:\btr615 のようなルートから近いフォルダにコピーしてパス
設定するのが簡単でよいと思います。
この Btrieve 6.15 ワークステーションエンジンの利用を止めたい場合は、PATH
変数からの削除を確実に実行してから、Pervasive.SQL 等､上位バージョンのエ
ンジン等をインストールしてください。
24
システム設定ファイル
VBMAN.INIファイル
VBMAN.INI ファイルは通常 Windows ディレクトリに配置され、VBMan のシステ
ム設定に関する情報が書きこまれます。インストール直後にはこのファイルは存
在しませんが、VBMan DDF ビルダーの設定を書きこむた際に生成されます。
VBMan for Btrieve/VBX Version 1.x では network や dbpath の設定が必須で
したが、データベース・コントロールのプロパティに設定または自動判定するよう
に変更になりましたのでご注意ください。またセクション名は[vbman330]に変更
になりました。以下は設定項目とその説明です。
設定項目
詳細
float_size
Float, Bfloat型のフィールドを文字列に展開する際の浮動小
数点の桁数。この値の設定が小さい場合、4バイトのFloat型
では桁落ちが発生する場合がありますので適当なサイズを
設定してください。デフォルトは10桁です。最大は20桁です。
変換の精度はマイクロソフトのコンパイラのランタイム・ライ
ブラリに依存しています。
sShortDate
Date型のフィールドを文字列に展開する際または文字列か
らDate型に変換する際の形式を設定します。yyyy/mm/ddま
たはyy/mm/ddが設定可能です。デフォルトはyyyy/mm/dd
形式です。
grid_max_col
VBManグリッドが扱えるカラムの最大値を設定します。デフ
ォルトは64カラムです。初期化時に割り振るメモリの量は
grid_max_col*4
+
grid_max_row*4
+
grid_max_col*grid_max_row*4 バ イ ト で す 。 32bit 環 境 の た め
C/C++のランタイム・メモリの容量が上限になります。
grid_max_row
VBManグリッドが扱えるローの最大値を設定します。デフォ
ルトは1024ローです。
sign_nibble
DECIMAL型、MONEY型の正数値を表すニブル値を設定しま
す。設定可能な値は12または15です。デフォルト値は15とな
ります。
Year_2000
日付け型をYY/MM/DDの形式で扱う場合、この値に１をセッ
トすると年の値に2000を加算します。デフォルト値は0でこの
25
場合は従来バージョンと同じく1900を加算します。このフラグ
はデータの登録時に参照されます。Btrieveデータ自体は
2000 年 以 上 の 値 を 保 持 す る こ と が 可 能 で 、 VBMan で は
YY/MM/DD表示形式の場合は2000年は00と表示されます。
上記以外にもVBMAN.INIファイルには弊社VBMan製品の設定 3が書き込まれま
す。
以下は VBMAN.INI ファイルのサンプルです。
[vbman330]
float_size = 15
sShortDate = yyyy/mm/dd
grid_max_col = 30
grid_max_col = 400
Btrieve エンジンの設定
VBMan に添付される Btrieve for Windows95/NT バージョン 6.15 のワークステ
ーション・エンジンの設定は Windows ディレクトリにある w32mkde.exe で行いま
す。この製品はすでに Pervasive software からは入手できない状況ですから使
用方法等の情報が必要な場合は当エンジンを使わないで Pervaisve.SQLV8.6
等の現行製品をインストールしてご使用になることをお勧めします。
Pervasive.SQL 対応について
Pervasive.SQL では Btrieve の拡張データタイプ以外のカラムを定義することが
できますが VBMan ではそのようなデータ型のカラムはサポートされません。(lon
gvarbinary 等)
また当バージョンから「真のヌル値」(true nullable)をサポートするテーブルを扱
えるようになりました。フィールドの値のヌルチェックには DbIsNull メソッドを利用
します。
Pervasive.SQL の service pack レベルにより仕様詳細が変わりますのでリリー
スノート(readme.html)や開発会社のウェッブ・サイトなどで随時情報を提供しま
3
VBMan for ODBC、VBMan DDF ビルダー等。
26
すので、ご参照ください。
27
チュートリアル
ここでは、VBMan Controls for Btrieve を使ったフォームの作成方法について
説明します。
Btrieveデータベースの定義
概要
ここでは VBMan DDF ビルダーを使用したデータベースのフィールドの定義方
法について説明します。フォームのデザインに入る前にデータベースフィールド
の定義と Btrieve データを生成します。
VBMan DDFビルダーによるレコード定義
VBMan for ActiveX Control のメニューには VBMan DDF ビルダーが登録され
ます。DDF ビルダーを実行するにはこのメニューを選択します。以下は新規に
Btrieve レコードを定義する手順です。
①
②
③
VBMan DDF ビルダーを実行します。
初期メニューの「ファイル」から「DDF の作成」を選択します。
以下のダイアログが表示されます。DDF を保存するディレクトリを指定しま
す。
④
DDF ディレクトリを指定するとテーブル情報の入力ダイアログが表示され
ます。この例ではテーブル名も Btrieve ファイル名も test1 と設定します。
28
⑤
空のテーブル定義画面が表示されます。
⑥
「フィールド」メニューから「フィールドの追加」を選択します。以下のようなフ
ィールド定義画面が表示されます。
フィールド名を入力し、データ・タイプをコンボ・ボックスから選択し、必要に
応じて、データ長を入力します。文字列などの場合はデータ入力が必要で
29
すが、たとえば、時間、日付けなどは内部的なデータのサイズは規定され
ているので設定の必要はありません。この場合、データ・サイズの入力カラ
ムにはフォーカスが移動しません。小数点以下桁数についても、MONEY,D
ECIMAL,NUMERIC 以外ではフォーカスが移動しません。
⑦
⑧
上の操作を繰り返して、フィールドをすべて登録します。
インデックスを設定します。VBMan でコントロールを使ってデータを入力す
る再には１個以上のインデックスの定義が必須になります。「インデックス」
メニューから「インデックスの追加」を選択すると以下のようなダイアログが
表示されます。
⑨
インデックスを設定するフィールドを選択してソート・オーダーを選択します。
今回はチュートリアルなので、上記のダイアログのようにキー・タイプを設
定します。
「ファイル」メニューから「保存」を選択していままのフィールド定義を保存し
ます。
「オプション」メニューから「Btrieve ファイル生成」を選択します。Test1.btr
というファイルをリスト・ボックスから選択して「OK」ボタンを押すと Btrieve
ファイル test1.btr が生成されます。
以上で DDF の定義と Btrieve ファイルの生成は終了です。DDF ビルダー
を終了させます。「ファイル」メニューから「終了」を選択します。
⑩
⑪
⑫
30
複数のテーブルが必要な場合はファイル・メニューから新規テーブルを選択して、
同様の操作を繰り返します。
VBMan DDF ビルダーの操作の詳細についてはオンライン・ヘルプをご参照くだ
さい。
Visual C# .NETでデータ参照フォームを作成
ここでは Microsoft Visual C# .NET で VBMan Controls for Btrieve を使った
データ表示フォームの作成方法を説明します。この例では Pervasive.SQL 2000
I のサンプルデータ demodata を使っています。
1) Visual Studio.NET を起動します。
2) 新規プロジェクトから Visual C#プロジェクトを選択し Windows アプリ
ケーションを選択してプロジェクトを開始します。
3) ツール・ボックスをマウス右クリックし、「ツールボックスのカスタマイ
ズ」を選択します。
4) COM コンポーネントのタブで「参照」ボタンを押します。
5) システム・ディレクトリにある vbmbt330.ocx ファイルを指定します。する
と COM コンポーネントのタブは以下のようになります。
31
6) ツールボックスに VBMan コントロールが以下のように表示されます。
32
7) データベース・コントロール(VBMBtr)を Windows Form にドラッグしま
す。
8) プロパティページをマウス右クリックで開き、DDF ディレクトリに DEMO
DATA ディレクトリを指定します。以下の画面の例は Pervasive.SQL 2
000I デフォルトインストール時での設定です。
9) Widnows form に VBMan グリッドをドラッグします。
33
10) VBMan グリッドをマウスの右クリックでプロパティダイアログを開き、以
下のように Person データベースから First_name,Last_name カラムを選
択します。インデックスには PersonID を指定します。
11) 実行します。グリッドにデータが表示されることを確認します。
34
12) この例では Visual C#でプロジェクトを新規開始しましたが、Visual Ba
sic.NET でもプロジェクト選択以外は全く同一の手順となります。
Visual Basicでデータ入力フォームを作成
この章では Visual Basic 6.0 で VBMan Controls for Btrieve を使ったデータ入
力フォームの作成方法を説明します。
１)
Visual Basic 6.0を実行します。
２) 「プロジェクト」メニューの下のカスタム・コントロールを選択します。以下の
ようなダイアログが表示されますので、リストから「VBMan Controls for
Btrieve」を選択します。 4チェック・ボックスが選択されている状態であるこ
4
リストボックスに「VBMan Controls for Btrieve」が表示されない場合は、インス
トールが正しく行われていない可能性があります。Windows のシステム・ディレクト
リに VBMBT3.30.OCX が存在することを確認してください。ファイルが存在するの
であれば、レジストリへの登録が失敗しているとおもわれます。今一度 REGSVR3
2.EXE を実行して VBMBT3.30.OCX を登録してください。DOS プロンプトからのコ
マンド・ラインは REGSVR32 c:\winnt\system32\vbmbt3.30.ocx のようになります。
35
とを確認してOKボタンを押します。
３) Visual Basicのツール・パレットにVBMan Controls for Btrieveのカスタム・
コントロールのアイコンが以下のように表示されます。
４) VBManデータアクセスコントロール（ディスクが１個だけのアイコン）をフォ
ームにおきます。必ずこのコントロールを他のすべてのVBManコントロー
ルより先にフォームに設定してください。このコントロールは実行時には表
示されないので、フォームのデザイン時に邪魔にならない適当な位置に配
置します。
36
５) データベース・コントロールのDDFDirプロパティを設定します。このプロパテ
ィ は ド ラ イ ブ ま で 含 め た DDF フ ァ イ ル が 存 在 す る パ ス を 指 定 し ま す 。
FILE.DDF,FIELD.DDF,INDEX.DDFの３つのファイルが存在するパスであるこ
とが必須となります。このプロパティが正しく設定されると、テーブル、フィー
ルド、インデックスに関する情報をDDFからコントロールに読み込みます。
これらの情報により、フォームのデザイン時にデータ・ベースに関連する情
報を正確に効率よく設定することが可能になります。
６) データの入力フィールドをフォームにおき、プロパティを設定します。この例
ではエディット・コントロールをフォームに設定します。プロパティ
37
DbSource,DbTable,DbFieldの設定は必須となります。これ以降の例では
DbSourceプロパティはフォームに唯一設定しているVBManデータベース・
コントロールのオブジェクト名の値を設定します。
７) 以下はエディット・コントロールのプロパティ設定ダイアログです。エディッ
ト・コントロールをマウスの右ボタンでクリックして一番下のメニュー「プロパ
ティ(P)」を選択すると表示されます。このダイアログでプロパティを設定す
る場合は、データソース、テーブル、フィールドの順にコンボ・ボックスから
選択します。OKボタンを押すと初回のみフィールド名がエディット・コントロ
ールのTextプロパティ値に設定されます。
38
８) エディット・コントロールのDbSource,DbTable,DbFieldプロパティを設定した
直後のフォームは以下のようになります。
９) 該当テーブルの入力項目をフォームに設定したら、Btrieveデータベースの
操作をするVBManボタンコントロールをフォームにおきます。
39
１０) VBManボタン・コントロールでは、DbSource,DbTable,DbIndexプロパティ
と DbOperation の 設 定 が 必 須 で す 。 プ ロ パ テ ィ 設 定 の ダ イ ア ロ グ で は
BtrieveのBtrieveオペレーションをDbOperationプロパティに設定することも
可能です。以下の例では先頭レコードに移動するGetFirstオペレーション
を選択しています。
１１) 以下はボタンのキャプションを「先頭」と設定し、次レコードに移動するた
めにGetNextボタンを追加したフォームを実行している様子です。
40
１２) 以上のように、VBManエディット、VBManボタンを複数配置することによ
り、簡単なフォームであれば、すぐにデータを登録したり、検索する実行可
能なフォームができあがります。この時点で設定必須なプロパティが指定
されていれば、実行可能です。また、いままで説明したフォームはVBMan
DDFビルダーの自動フォーム生成機能で作成することもできます。
41
サンプルプログラムについて
.NET 用サンプルについて
.NET 用のサンプルは VB.NET および C#言語用が用意されています。それぞれメ
ニューからプロジェクトソリューションファイルへのショートカットが張られています
ので、Visual Stuiod.NET IDE がインストールされている環境をあらかじめご用意
いただけば、メニューからサンプルプログラムをごらんいただくことができます。
プロジェクトを開く前に、Visual Studio.NET のツールボックスに VBMan Controls
for Btrieve のコンポーネントを登録しておく必要があります。（登録していない場
合は、コンポーネントが参照できない、というエラーになります） ツールボックスへ
のコンポーネントの登録方法は、前章の「Visual C# .NET でデータ参照フォーム
を作成」をご参照ください。
また、サンプルプログラムは Visual Studio.NET 2002 形式のプロジェクトファイル
なので、Visual Studio.NET 2003 や Visaul Studio.NET 2005 から参照する場合
には、プロジェクト変換ウィザードにより、プロジェクト形式の変更が自動的に行わ
れます。変換した後のサンプルプロジェクトの動作は確認済みです。
サンプルプログラムビルド時の注意点ですが参照しているラッパーコンポーネント
(AxVBMBtrLib.DLL)の「ローカルコピー」プロパティに False が設定される場合に
は True に設定していただくとエラーなく、簡単にサンプルプログラムをコンパイル
して実行していただくことができるということです。
以下は設定項目のプロパティのスクリーンショットになります。
42
Visual Basic 6.0 用サンプルプログラムについて
Visual Basic 6.0 用のサンプルはインストールディレクトリ（デフォルトでは\Progra
m Files\TechKnowledge\VBMan Controls for Btrieve 3.30）以下の samples\vb
フォルダーにあります。6 種類のサンプルプロジェクトが収録されています。(拡張
子 VBP ファイル) 各サンプルは DDF ディレクトリとしてデフォルトインストールの
場合のフォルダーに固定されていますので、デフォルトディレクトリ以外のインスト
43
ールでは、DDF ディレクトリを該当ディレクトリに変更してください。
ASP 用サンプルプログラムについて
当製品のサンプルには以下のようなファイルが添付されています。以下はサンプ
ルの簡単な説明です。
SAMPLE1.AS BTRIEVE データを<TABLE>タグで表示するサンプルです。
P
ブラウザーからは SAMPLE1.ASP ファイルを直接指定しま
す。お客様の環境で動作させるには DDFDIR プロパティの
設定変更が必要です。
Sample2.htm
Btrieve データを新規登録するサンプルです。ブラウザーか
Sample2.asp
らは sample2.htm ファイルを指定します。データが入力され
て「登録」ボタンをクリックすると sample2.asp がデータを Btri
eve データ・ベースに登録します。Sample2.asp の DDFDir プ
ロパティはお客様の環境に合わせて設定変更が必要です。
サンプルを動作させるためには Btrieve が利用可能な IIS がインストールされてい
る Windows サーバーが必要となります。
VBMan Controls for Btrieve の ASP サンプルディレクトリにある以下のファイル
をサーバーのディレクトリにコピーして、そのパスを sample1.asp と sample2.asp フ
ァイルの DDFDir プロパティ設定の行に設定する必要があります。以下のファイル
は VBMan のインストール・ディレクトリ以下の samples\asp ディレクトリにインスト
ールされます。
File.ddf
Field.ddf
Index.ddf
Shiire.btr
Item.btr
たとえば、上記ファイルをサーバー名 \\jacksonの\ddfディレクトリにコピーした場
合はsample1.asp/sample2.aspファイルのDDFDirプロパティ設定行は以下のような
記述になります。
<% VBMan.DDFDir="\\jackson\ddf" %>
44
コンパチビリティ
この章では VBMan Controls for Btrieve の以前のバージョンからの Visual Basi
c アプリケーションの移行方法を示します。以下に各バージョンの説明をいたしま
す。
VBMan for Btrieve/VBX
スタンダード版
1994 年 5 月に発売されました。Windows 3.1+
VB2 で動作する VBX です。最終バージョンは
1.15 となっています。
VBMan for Btrieve/VBX
1994 年 11 月に発売されました。Windows 3.1
プロフェッショナル版
+VB2 で動作する VBX です。スタンダード版
に対して Btireve 拡張オペレーションなどが使
えるような仕様に拡張されています。最終版
は VB4 16bit 版でも動作するように修正され
たバージョン 1.58 となります。
VBMan for Btrieve/OCX32
1996 年 3 月に発売されました。32bit OCX と
なり、VB4 32bit 版で動作するものが開発さ
れました。対応する Btrieve のバージョンも 32
bit 版の 6.15 となりました。その後 VB5 にも
対応し、最終版は 98 年 7 月現在 2.00I となっ
ています。VBX ではデータ・アクセス関数でア
プリケーションを作成することが多かったので
コンパチブル関数として VBX 版のソースをそ
のまま使える関数が用意されています。
VBMan ActiveX Control for B 1998 年に発売されました。ATL というクラスラ
trieve ver 3.0X
イブラルを採用したために、製品のソースは
大幅に書き換えが必要でした。ATL を採用し
たのでいわゆる DLL HELL 問題を解決でき
ました。マイナーバージョン・アップで Windows
2000 に対応しました。Pervaisve.SQL 2000 の
Service Pack1 から Btrieve API の仕様変更
がありこれにもマイナーバージョン・アップで
対応しました。初期バージョンは ATL ver 2.0
/2.1 を使ってリリースしましたが、後半のバー
ジョンは ATL 3.0 でリリースしています。
VBMan ActiveX Controls for 2002 年 3 月に Pervasive.SQL 2000i SP3 に
Btrieve ver 3.10
対応して発売されました。また、このバージョ
ンから Windows XP での動作保証をしまし
た。新たに NUMERICSA,NUMERICSTS,CURR
ENCY, Longvarchar データ型に対応し、true
nullable カラムにも対応しました。
45
VBMan Controls for Btrieve v
er 3.20
VBMan Controls for Btrieve V
3.30
2002 年 10 月に発売しました。.NET 環境に最
小のワークロードで既存の VB アプリを移行し
たいというお客様のご要望が多かったので、
Windows Forms で動作する COM コンポーネ
ント形式のコントロールも必要と思い、リリー
スいたしました。名前は依然として VBMan で
すがこのバージョンから Visual C#でも動作す
るようになりました。VB6 のフォームと Window
s Form では動作の違いが多数ありましたの
で、内部的にはかなりの変更が必要でした。
2005 年 11 月に発売しました。 Pervasive.SQ
L V8.6 SP3 に対応しました。 Pervasive.SQL
のセキュアーデータベースに対応するため、
新たに DbLogIn/DbLogOut メソッドを追加しま
した。DDF のパスとして URI を指定できるよう
になりました。
Visual Basic.NET への移行
当 version 3.30 を使って作成された Visual Basic 6 用アプリケーションは Visual
Basic.NET のアップグレードウィザードを使って Visual Basic.NET アプリケーション
に移行可能なことを確認済みです。アップグレードウィザードを使って移行した Wi
ndows Form ではレイアウトが多少変わってしまうことも確認していますので、アッ
プグレード・ウィザードをご利用後に、フォームのレイアウトや外観を Visual Studio.
NET で確認されることをお勧めします。ただしお客様のアプリケーションで他にも
コンポーネントをお使いの場合は変換の前に該当コンポーネントが Visual Basic.
NET をサポートするものであることを事前にご確認されることをお勧めいたします。
VBMan ActiveX Control for Btrieve バージョン 3.X からの移行
コントロールの GUID 等は ver 3.30 では変更されていません。OCX ファイル名の
み変更になっていますので新しいバージョンをレジストリ登録していただけば既存
のプロジェクトの変換は必要ありません。
VBMan for Btrieve/OCX32 バージョン 2.0 からの移行
ここでは VBMan for Btrieve/OCX32 を使って作られた Visual Basic アプリケー
ションを VBMan Control for Btrieve version 3.30 を使った Visual Basic アプリ
46
ケーションに移行する方法を説明します。この移行説明では Visual Basic 言語が
前提であり、VBMan の旧バージョンから最新バージョンへコントロールの入れ替
え方法を示すものです。Visual Basic から Visual Basic.NET への変換は Visual
Studio.NET で提供されるアップグレードウィザードを使ってください。VBMan の旧
バージョンを使った Visual Basic アプリを最新版の VBMan + Visual Basic.NET
アプリへ直接移行することはできません。
変換作業は基本的には GUID の変更、ライブラリ名の変更、コントロール・クラス
名の変更になります。当製品には Visual Basic のプロジェクト・ファイル名を指定
すると各フォームを変換するツール vbmconv.exe が添付されていますので最初に
変換ツールの説明をいたします。
変換ツール
変換ツールの使用方法は以下のようになります。
①
②
③
④
⑤
⑥
VBMan Controls for Btrieve メニューから ver2to3 コンバーターを選択して
変換ツールを実行します。
表示されるウィンドウの「変換元プロジェクト・パス」に変換したい Visual Basi
c プロジェクトファイル（拡張子.vbp）のフル・パスを指定します。
「変換先プロジェクト・パス」に変換後のファイルを保存するディレクトリを指定
します。「変換後のプロジェクト・パス」には変換元と同じ値を設定することは
できませんのでご注意ください。
「変換開始」ボタンを押します。
変換が終了するとウィンドウが終了します。
変換されたプロジェクトを Visual Basic で読み込み動作を確認します。
手動によるフォーム変換
47
VBMan for Btrieve/OCX32 version 2.00 で作成された Visual Basic のフォーム
を VBMan Control for Btrieve version 3.30 で利用可能なように変更する方法を
説明します。フォームの変更には Notepad.exe 等のテキスト・エディターを使って、
コントロールのライブラリ名や GUID を変換することになります。以下は変換手順
の概要です。
①
②
エディターで Visual Basic のプロジェクト・ファイル(拡張子 .vbp)を開きます。
GUID を変換します。
変換前の行:
Object={1601CD73-F987-11CE-9262-0080AD156341}#1.0#0; VBMBTR32.OCX
変換後の行:
Object={3235CFE2-D891-11D1-BD2B-004026182472}#1.1#0; VBMBT3.30.OCX
③
④
⑤
Visual Basic のプロジェクト・ファイルを保存します。
プロジェクトに含まれるフォーム・ファイル(拡張子 .frm)をエディターで開きま
す。
ライブラリ名を変更します。ライブラリ名は Begin で始まる行の VBMBtrLib.と
いう文字列を VBMBTRLibCtl.に変更します。
変更前の行:
Begin VBMBTRLib.VBManBtn VBManBtn6
変更後の行:
Begin VBMBTRLibCtl.VBMBtn VBMBtn6
⑥
⑦
コントロール名を変更します。コントロール名は上記⑤の行にあるライブラリ
名の後にドットで表記される文字列です。VBMan には 13 個のコントロール
がありますので、後述の変換表を参考に文字列を置換します。
フォーム・ファイルを保存します。
VER 2.00 コントロール名
VBMDB
VBManBtn
VBManEdit
VBManGrid
VBManListBox
VBManComboBox
VBManExListBox
VBManExComboBox
VBManPic
VBManCheck
VER 3.30 コントロール名
VBManDb
VBMBtn
VBMEdit
VBMGrid
VBMListBox
VBMComboBox
VBMExListBox
VBMExComboBox
VBMPic
VBMCheck
48
VBManOptBtn
VBManHScroll
VBManVScroll
VBMOptBtn
VBMHScroll
VBMVScroll
コンバージョンツール、手動による変換でもプロパティ設定やご利用の Visual Bas
ic バージョンなどによりコントロールがロードできない場合があるようですが、その
ような場合は Visual Basic の開発環境で再度コントロールを張っていただくことに
なります。あらかじめご了承ください。
VBMan for Btrieve/VBX バージョン 1.x からの移行
ここでは VBMan for Btrieve/VBX 版で作成したアプリケーションを VBMan Contr
ols for Btrieve 環境へ移行する際の手順、注意点等を記述します。
フォームの変換
Visual Basic 2.0J で作成された VBMan を使ったフォームはそのままでは Visu
al Basic 6.0/5.0/4.0J では読み込めません。以下の手順でフォームを移行する
ことになりますが、マイクロソフトによって変更された VBX と OCX の仕様の変更
が原因で完全に移行できる訳ではないことに注意してください。
①
②
フォームをテキスト形式で保存
Visual Basic 2.0J の「テキスト形式で保存」の機能を使って、移行した
いフォームをテキスト形式で保存します。
フォームの編集
フォームをエディターで開いて VBMan のコントロールに「VBMBTRLibCt
l.」というモジュールクラスを示すプリフィックスをつけます。以下は VBM
an データベース・コントロールにおけるサンプルです。
変更前
Begin VBManDB VBMan1
Height
= 480
Left
= 10
Top
= 480
End
変更後
Begin VBMBTRLibCtl.VBManDb VBMan1
Height
= 480
49
Left
Top
End
③
④
⑤
= 10
= 480
Visual Basic の起動とコントロールの追加
Visual Basic を起動します。メニューから ActiveX Control を選択して、
VBMan Controls for Btrieve をプロジェクトに追加します。
プロジェクトへフォーム・ファイルの読み込み
②で編集したフォーム・ファイルを Visual Basic のプロジェクトに追加し
ます。ファイル・メニューの下からファイルの追加を選択し、ファイルの指
定ダイアログで②で編集したフォームのファイル名を指定します。
フォームの変換エラーの確認
フォーム変換ではプロパティの違いなどから、エラーが発生する場合が
あります。フォームのファイル名と同じ名前で、拡張子が.log のファイル
にエラー詳細がレポートされますので、このファイルを参照して、変換で
きなかったプロパティ等を Visual Basic のデザイン・モードで修正してく
ださい。
データアクセス関数の移行
バージョン 1.0 コンパチブル関数
VBMan バージョン 1.5 までは VBX のモジュールにデータベースアクセス関数と
して DDF に準拠した Btrieve アクセスを可能とするエントリ・ポイントがエクスポ
ートされていました。これらの関数は VBMan Controls for Btrieve ではバージ
ョン 1.0 コンパチブル関数として同様に関数がエクスポートされています。以前
のバージョンでは Btrieve.bas というファイルに Btrieve のオペレーション・コード
と一緒に Visual Basic 用に関数の宣言がしてありました。このファイルは VBMa
n Controls for Btrieve では VBMANV1.BAS として、インストールディレクトリの
samples ディレクトリに存在しますので、このファイルを Visual Basic のプロジェ
クトに追加してご使用ください。
VBMan Controls for Btrieve ではフォームに複数のデータベース・コントロール
が設定できるように機能を拡張した結果、このバージョン 1.0 コンパチブル関数
を使う場合は、どのデータベース・コントロールのポジション・ブロックを使うのか
を事前に指定する必要があります。コントロールを指定する関数は DbAttachCo
ntrol で、パラメータはコントロールの名前とそのコントロールが置かれているフ
ォーム名を指定します。以下はサンプル・コードです。
Dim Rc As Integer
Rc = DbAttachControl(“VBMan1”,”Form1”)
If Rc <> 0 Then
50
MsgBox “コンパチブル関数を使うことができません。”
Stop
End If
Rc = DbAccess(BTR_GET_FIRST, CUST_TABLE, CUST_KEY_PATH )
If Rc <> 0 Then
MsgBox “Btrieve Error ” & CStr(rc)
Stop
End If
DbAttachControl 関数からの戻り値が０でない場合はフォーム名またはコントロ
ール名が正しくないと思われます。今一度ご確認ください。
データ・ベース・コントロール・メソッド
Visual Basic 2.0J における VBX の仕様ではカスタム・コントロールに独自のメ
ソッドを追加することはできませんでした。この仕様は ActiveX Control(OCX)で
拡張され、カスタム・コントロールのデザイナーは独自のメソッドをユーザーに提
供することが出来るようになりました。
VBMan Controls for Btrieve でも、このデザイン上の利点を生かすべく、いまま
でデータ・ベース・アクセス関数として提供されていた関数をデータ・ベース・コン
トロールのメソッドとして提供するようになりました。単にメソッドとするだけでは、
先に紹介したバージョン 1.0 コンパチブル関数と差別化できないと考え、従来フ
ィールド、テーブル、キーなどは整数の ID で指定する仕様だったのを改め、す
べてを文字列で DDF 定義時と同じ値を指定可能としました。従来の整数の ID
での方法には、Visual Basic 2.0J の文字列領域の不足、16bit 環境でのパフォ
ーマンス不足、などを考慮したうえでの仕様であり、またループの記述が簡単な
どの利点もありました。32Bit 環境でこれらの制約はある程度緩和されていると
考え、パラメータのデザインを変更した訳ですが、お客さまの環境によってはパ
フォーマンスが不足することなども考えられますので、その場合にはバージョン
1.0 コンパチブル関数をお使いになられるようにお願いいたします。
以下は VBMan Controls for Btrieve のデータベース・アクセス・メソッドの呼び
出しコード例です。DbAccess,DbExAccess メソッドの第一パラメータ定義は Btri
eve.Bas ファイルにありますのでご利用ください。
Dim rc As Integer
rc = VBMan1.DbAccess( BTR_GET_FIRST, “顧客”, “コード”)
If rc <> 0 Then
MsgBox “Btrieve ステータス” & CStr(rc)
Stop
End If
51
VBMan DDFビルダーの機能
VBMan DDF ビルダーは 32Bit アプリケーションになりました。従来版は 16bit
アプリケーションで GRID.VBX を利用してフィールドなどを表示していましたが、
32bit になり、MSFLXGRD.OCX を利用してフィールドなどを表示しています。VB
Man DDF ビルダーを実行する場合には、MSFLXGRD.OCX が Windows の Syst
em ディレクトリに存在し、REGSVR32.EXE でレジストリに登録されていることが
必要になります。
また、VBMan DDF ビルダーには Btrieve データ移行モードが追加されました。
システム・オプションで「Btrieve データ移行」が設定されている場合かつ、DDF
で指定されるディレクトリに Btrieve ファイルが存在する場合には、データ移行モ
ードになります。データ移行モードでは、フィールドの挿入、インデックスの挿入
ができない等、編集機能に制限があります。既存のデータが不要な場合はこの
オプションをやめるか、DDF ビルダーを起動する前に不要な Btrieve ファイルを
削除または別ディレクトリに待避をしてください。
VBMan Controls for Btrieve ではインデックスの指定にインデックス名を使え
るようになりました。これに対応して同じ先頭フィールド名でセグメント・キーを作
成する場合、インデックスを識別するために、インデックス名が設定可能になっ
ています。「インデックス」メニューに「インデックス名の追加」、「インデックス名
の削除」が追加されています。
フォームの生成に関しては以前の VBMan for Btrieve/VBX を VB2 で利用でき
るフォームと VBMan Controls for Btrieve バージョン 3.30 を Visual Basic 6.0J
で利用できるフォーム生成が可能です。Visual Basic .NET で使うフォームは生
成できませんが、Visual Basic 6 用のフォームは Visaul Studo.NET のアップグ
レードウィザードで Visual Basic.NET 用に変換できます。
52
カスタム・コントロール・リファレンス
ここでは、VBMan Controls for Btrieve で利用可能な 13 個のカスタム・コントロ
ールについて説明します。最初にフォームに設定するコントロールは次に説明
するデータベース・コントロールです。この章の説明では各コントロールの概要、
使用上の注意などを記述します。カスタム・プロパティ、カスタム・イベント、カス
タム・メソッドの詳細はそれぞれのリファレンスを参照してください。
データベース・コントロール
概要
VBMan データベース・コントロールは VBMan を使用するアプリケーションにお
いて、フォーム等を作成する場合に最初に設定するコントロールです。このコン
トロールの DDFDir プロパティで設定したディレクトリ情報から DDF を読み込み
ます。
このコントロールがフォームに設定されていない場合は、他の VBMan コントロ
ールがフォームに存在しても、DbSource,DbTable プロパティ等が指定可能とな
りませんのでご注意ください。
VBMan データベース・コントロールはデザイン時にはアイコン表示されますが、
実行時には不可視になります。デザイン時にはフォームの設計で邪魔にならな
い適当な場所に設定します。
VBMan データベース・コントロールが読み込む DDF 定義に存在するテーブルに
ついて、テーブルに関連する Btrieve ファイルをオープンした時には、このコント
ロール単位で Btrieve のポジション・ブロックとレコード・イメージを保持するバッ
ファを管理します。たとえば、同じファイルを別々のポジション・ブロックで管理し
たい場合は同じフォームに複数の VBMan データベース・コントロールを設定す
ることで可能になります。
VBMan データベース・コントロールを Visual Basic で使う場合、コントロール配
列にして使うことはできません。他の VBMan コントロールは DbSource,DbListS
ource プロパティに VBMan データベース・コントロールの Name プロパティの値
を参照する仕様の為、コントロール配列にすると Name プロパティで識別できな
くなります。
以下は VBMan データ・ベース・コントロールに特有なプロパティ、イベント、メソッ
ドの一覧です。
53
カスタム・プロパティ
CacheDDF
DDFDir
DistName
OpenMode
OwnerName
カスタム・イベント
BtrieveError
カスタム・メソッド
DbAbortTransaction
DbAccessByID
DbAccess
DbBeginConcurTransaction
DbBeginTransaction
DbClearControlData
DbClearFieldBuffer
DbCloseAll
DbEndTransaction
DbExFree
DbExGetPosition
DbFindPercentage
DbGetDataSize
DbGetDirect
DbGetFieldDataByID
DbGetIndexName
DbGetNumOfField
DbGetNumOfRecords
DbGetPosBlock
DbGetRecord
DbGetRecordLength
DbLoadDDF
DbOpenAll
DbSetFieldData
DbSetFileName
DbSetRecord
DbTransferFromControl
DbUnlock
DbClose
DbCreate
DbExAccess
DbExGetFieldData
DbExSetMode
DbGetByPercentage
DbGetDataType
DbGetFieldData
DbGetFieldName
DbGetModulePath
DbGetNumOfIndex
DbGetNumOfTable
DbGetPosition
DbGetRecordImage
DbIsOpen
DbOpen
DbReset
DbSetFieldDataByID
DbSetLockBias
DbSetRecordImage
DbTransferToControl
54
ボタン・コントロール
概要
VBMan ボタン・コントロールはユーザーのマウス・クリックによるボタンの押下時
に DbOperation プロパティに設定した Btrieve オペレーションを実行します。
登録系のオペレーション 5を設定した場合には、同じフォームにある、このコント
ロールを指定するようにDbSource,DbTableプロパティに値が設定してあるVBMa
nコントロールからデータを収集して、DDFにしたがってレコード・イメージを作成
し、Btrieveのオペレーションを発行します。
参照系 6のオペレーションがDbOperationプロパティに設定されている場合は、
同じフォームにある、このコントロールを指定するようにDbSource,DbTableプロ
パティが指定されたコントロールにレコード・イメージのバッファからBtrieveから
読み込んだデータを設定します。
DbOperation プロパティとして設定できるのは以下の項目です。これらは Btriev
e の機能をそのまま実現しています。
First
Last
Insert
Delete
Update
Next
Previous
GetEqual
GetGreater
GetGreaterOrEqual
GetLessThan
5
6
最少の値をもつキーに該当するレコードを得
る。
最大の値をもつキーに該当するレコードを得
る。
新規のレコードを追加。
現在のレコードを削除。
現在のレコードを更新。
次の値をもつキーに該当するレコードを得る。
前の値をもつキーに該当するレコードを得る。
一致するキーに該当するレコードを得る。
指定したキーより大きな値をもつキーに該当す
るレコードを得る。
指定したキーと同じまたは、より大きな値で一番
近いをもつキーに該当するレコードを得る。
指定したキーより小さな値をもつキーに該当す
るレコードを得る。
Insert,Update オペレーション。
GetEqual,GetNext オペレーションなど。
55
GetLessThanOrEqual
StepFirst
StepLast
StepPrevious
StepNext
InsertNCC 7
UpdateNCC
指定したキーより同じ、または、より小さな値で
一番近い値をもつキーに該当するレコードを得
る。
物理先頭レコードを得る。
物理最終レコードを得る。
前の値をもつレコードを得る。
次の値をもつレコードを得る。
新規レコードを追加。論理カレンシー情報は設
定しない。
レコードを更新。論理カレンシー情報は設定し
ない。
以下の表はVBManボタンに特有 8のプロパティ、イベント、メソッドをあらわしま
す。
カスタム・プロパティ
Abort
DbLocks
ClearControlData
DbOperation
ConfirmMsg
DbTable
DbIndex
DbSource
カスタム・イベント
BtrieveError
SetData
カスタム・メソッド
なし
7
NCC = NO CURRENCY CHANGE
対応する Visual Basic または Windows のコントロールと比べた場合に特有の
プロパティを指します。
8
56
エディット・コントロール
概要
VBMan テキストコントロールは DbSource,DbTable,DbField プロパティによって指
定される Btrieve データベースのフィールドのデータを表示、登録します。Btriev
e とのデータの交換は VBMan ボタン･コントロールをクリックした場合や、VBMa
n スクロールを使った場合、DbTransferToControl, DbTransferFromControl メソ
ッド/関数を使った場合におこなわれます。
入力マスクについて
VBMan エディット・コントロールは関係するフィールドのデータタイプが Date 型
または Time 型の場合で、Format プロパティが指定されていない場合はキー入
力をマスクして入力します。Date 型の場合は VBMAN.INI ファイルの設定によっ
て、yyyy/mm/dd,yy/mm/dd の形式を選択可能です。Time 型については hh:m
m:ss 形式固定です。これらのマスクはコントロールからフォーカスがなくなる時
におこなわれます。これらのデフォルト入力マスク以外のマスクをしたい場合は
Format プロパティと FormatOption プロパティを組み合わせて設定することにな
ります。Format,FormatOption プロパティの詳細についてはカスタム･プロパテ
ィ・リファレンスを参照してください。
以下の表は VBMan エディットに特有のプロパティ、イベント、メソッドです。
カスタム･プロパティ
DbField
FormatOption
DbSource
NumericMask
DbTable
ReadOnly
Format
UpperCase
カスタム・イベント
なし
カスタム・メソッド
なし
57
スクロール・コントロール
VBMan水平・垂直スクロール・コントロールにより、レコードの移動ができます。
レコードの移動はDbIndexで指定されるキー順となります。キーなしのBtrieveフ
ァイル、Btrieve 5.x形式のBtrieveファイルではこのコントロールは使えません。 9
また、このコントロールは VBMan ボタンにカレント･レコードを変えるオペレーシ
ョンを設定した場合はこれらのコントロールに連動してキャレット・ポジションを変
更します。
レコード件数が変わるようなオペレーションを発行した場合、Refresh メソッドを
呼び出すことで、スクロール･コントロールのキャレット位置を正しい位置に設定
することができます。
以下の表は VBMan スクロール・コントロールに特有のプロパティ、イベント、メソ
ッドです。
カスタム・プロパティ
AutoFirst
DbIndex
DbSource
DbTable
カスタム・イベント
BtrieveError
カスタム･メソッド
なし
9
Btrieve のパーセンテージ・オペレーションを使っているため。
58
チェック・ボックス・コントロール
概要
VBMan チェック・ボックス・コントロールは DbSource, DbTable, DbField プロパ
ティで指定されるデータベースのフィールドの値が DbValueTrue プロパティで指
定される値と同一になった場合にチェックされます。
このデータ･ベースのフィールドの値とは、VBMan ボタン・コントロールや、スクロ
ール･コントロールでカレント・レコードとしてポジショニングされたレコードにおけ
るフィールドの値です。データ･ベース・アクセス・メソッドまたはバージョン 1.x コ
ンパチブル･関数でカレント･レコードをポジショニングした場合は、DbTransferTo
Control メソッドなどでデータをカスタム･コントロールに転送した時にフィールド
の値が検査され、値が同一であれば、チェックされます。
以下の表は VBMan チェック･ボックス・コントロールに特有のプロパティ、イベン
ト、メソッドです。
カスタム･プロパティ
DbField
DbValueIndeterminate
DbSource
DbValueTrue
DbTable
DbValueFalse
カスタム･イベント
なし
カスタム・メソッド
なし
59
オプション・ボタン・コントロール
概要
VBMan オプション・ボタンコントロールは DbSource, DbTable, DbField プロパテ
ィで指定されるデータベースのフィールドの値が DbValueTrue プロパティで指定
される値と同一になった場合にチェックされます。
このデータ･ベースのフィールドの値とは、VBMan ボタン・コントロールや、スクロ
ール･コントロールでカレント・レコードとしてポジショニングされたレコードにおけ
るフィールドの値です。データ･ベース・アクセス・メソッドまたはバージョン 1.x コ
ンパチブル･関数でカレント･レコードを位置ずけした場合は、DbTransferToCont
rol メソッドなどでデータをカスタム･コントロールに転送した時にフィールドの値
が検査され、値が同一であれば、チェックされます。
以下の表は VBMan オプション･ボタン・コントロールに特有のプロパティ、イベン
ト、メソッドです。
カスタム･プロパティ
DbField
DbValueTrue
DbSource
DbTable
DbValueFalse
カスタム･イベント
なし
カスタム・メソッド
なし
60
リスト・ボックス・コントロール
概要
VBMan データベース・リストボックス・コントロールはプロパティ DbListField,DbLi
stSource,DbListTable の値で指定されたカラムのデータすべてをデータベース
から取得し表示します。データ更新のタイミングは DbUpdateOption プロパティ
の設定により、なし、初期化時、フォーカス時を選択できます。
また、DbField,DbSource,DbTable プロパティで指定されるフィールドのデータとし
て、このリスト･ボックスの選択値を設定、参照ができます。データを設定、参照
するのは VBMan ボタンの登録系のオペレーションまたは、DbTransferToContr
ol,DbTransferToControl メソッドです。
VBMan リスト･ボックスは DbListIndex プロパティで指定されるキー・パスで、Btri
eve の GET FIRST オペレーションを発行し、ファイルの最後まで GET NEXT オ
ペレーションを発行して、リスト･ボックスにデータを挿入します。Sort プロパティ
を True に設定している場合は VBMan リスト･ボックスがメモリでソートしてデー
タを表示し、DbListIndex プロパティで指定されるキー順にはならないこともある
ので注意してください。
VBMan リスト･ボックスは、レコードをリストに表示する直前に Format イベントが
発生します。このイベントのパラメータはこれから表示しようとするフィールドの
値です。このイベント内ではこの表示するデータを含むレコードがカレント･レコ
ードになっています。したがって、DbGetFieldData メソッドでフィールドの値を取
得可能です。
Format イベントでは他のフィールドの値を検査、計算した結果、別の文字列を
表示したければ、Format イベントのパラメータで渡る文字列に表示を更新する
文字列を設定することで可能です。Format イベント内でイベントのパラメータに
ヌル文字列を設定した場合、そのレコードはリスト･ボックスに表示されません。
以下は Visual Basic でのサンプル・コードです。
‘マイナスのデータは表示しない例
Sub VBManListBox1_Format( LineData As String )
If Left$(LineData,1) = “-“ Then
LineData = “”
‘ ヌル文字を設定
End If
End Sub
また、現在のレコードまででリストを止めたい場合は Abort プロパティに True 値
を設定します。
Visual Basicをコントロール･コンテナにした場合は、DbUpdateOptionプロパティ
を初期化時に設定すると、Formatイベントが発生しません。これは初期化時に
61
はVisual Basicがイベントの発生を禁止していることが原因です。Formatイベン
トを正常に発行させるにはフォームのActivateイベントでこのコントロールのRefr
eshメソッドをよびだすことで回避できます。 10
VBMan リスト･ボックスの内容を再度 Btrieve データベースから読み込みたい場
合は、Refresh メソッドを使います。
VBMan リスト･ボックスに保持できる最大行数は 32767 件です。この値は 32bit
のリスト･ボックスの仕様に依存する行数です。
第 2 パラメータは文字列を挿入する位置ですが、-1 を指定するとリストの最後
に追加します。
以下の表は VBMan リスト・ボックスに特有のプロパティ、メソッド、イベントです。
カスタム･プロパティ
Abort
DbListSource
DbUpdateOption
DbField
DbListTable
DbListField
DbSource
DbListIndex
DbTable
カスタム･イベント
Format
カスタム・メソッド
なし
10
サンプル･コードは巻末のプログラミングのヒントにあります。
62
コンボ・ボックス・コントロール
概要
VBMan データベース・コンボ・ボックス・コントロールはプロパティ DbListField,Db
ListSource,DbListTable の値で指定されたカラムのデータすべてをデータベー
スから取得し表示します。データ更新のタイミングは UbUpdateOption プロパテ
ィの設定により、なし、初期化時、フォーカス時を選択できます。
また、DbField,DbSource,DbTable プロパティで指定されるフィールドのデータとし
て、このコンボ･ボックスの選択値を設定、参照ができます。データを設定、参照
するのは VBMan ボタンの登録系のオペレーションまたは、DbTransferToContr
ol,DbTransferToControl メソッドです。
VBMan コンボ･ボックスは DbListIndex プロパティで指定されるキー・パスで、Bt
rieve の GET FIRST オペレーションを発行し、ファイルの最後まで GET NEXT
オペレーションを発行して、コンボ･ボックスにデータを挿入します。Sort プロパ
ティを True に設定している場合は VBMan コンボ･ボックスがメモリでソートして
データを表示し、DbListIndex プロパティで指定されるキー順にはならないことも
あるので注意してください。
VBMan コンボ･ボックスは、レコードをリストに表示する直前に Format イベント
が発生します。このイベントのパラメータはこれから表示しようとするフィールド
の値です。このイベント内ではこの表示しようとするデータを含むレコードがカレ
ント･レコードになっています。したがって、DbGetFieldData メソッドでフィールド
の値を取得可能です。
Format イベントでは他のフィールドの値を検査、計算した結果、別の文字列を
表示したければ、Format イベントのパラメータで渡る文字列に表示を更新する
文字列を設定することで可能です。 Format イベント内でイベントのパラメータに
ヌル文字列を設定した場合、そのレコードはコンボ･ボックスに表示されません。
また、現在のレコードまででリストを止めたい場合は Abort プロパティに True 値
を設定します。
Visual Basicをコントロール･コンテナにした場合は、DbUpdateOptionプロパティ
を初期化時に設定すると、Formatイベントが発生しません。これは初期化時に
はVisual Basicがイベントの発生を禁止していることが原因です。Formatイベン
トを正常に発行させるにはフォームのActivateイベントでこのコントロールのRefr
eshメソッドをよびだすことで回避することができます。 11
VBMan コンボ･ボックスの内容を再度 Btrieve データベースから読み込みたい
場合は、Reload メソッドを使います。
11
サンプル･コードは巻末のプログラミングのヒントにあります。
63
VBMan コンボ･ボックスに保持できる最大行数は 32767 件です。この値は 32bit
のコンボ･ボックスの仕様に依存する行数です。
以下の表は VBMan コンボ・ボックスに特有のプロパティ、メソッド、イベントです。
カスタム･プロパティ
Abort
DbListSource
DbUpdateOption
DbField
DbListTable
DbListField
DbSource
DbListIndex
DbTable
カスタム･イベント
Format
カスタム・メソッド
Reload
64
ピクチャー・コントロール
概要
VBMan ピクチャー・コントロールはグラフィック・イメージ・データを表示するコント
ロールです。Visula Basic に標準のイメージ・コントロールと同等の機能にデー
タベースからのデータを表示する機能を追加しました。
表示可能なイメージ・データは以下の形式のファイルです。
ビットマップ (.bmp)
アイコン (.ico)
ウィンドウズ・メタファイル (.wmf)
VBMan ピクチャー・コントロールでは DbSource,DbTalbe,DbField プロパティで指
定される文字列型データベース・フィールドの値をファイル名としてディスクから
イメージ･データを読み込み表示します。
指定されたファイルのイメージ・データタイプの判別にはファイル名の拡張子を
使用します。拡張子が指定されない場合はビットマップ(.bmp)と仮定します。
BlobPath プロパティにはイメージ･データが存在するディスク上のパスを指定す
ることが可能です。この場合、データベース･フィールドの値はファイル名だけが
指定されていることが必要です。BlobPath プロパティに指定がなく、データベー
ス･フィールドにファイル名だけが指定されるような場合はカレント・ドライブのカ
レント・ディレクトリにファイルが存在する扱いになります。
VBMan ピクチャー・コントロールに再度データを読み込む場合は Refresh メソッ
ドを呼び出します。
以下の表は VBMan ピクチャー・コントロールに特有のプロパティ、メソッド、イベ
ントです。
カスタム・プロパティ
BlobPath
DbField
DbSource
DbTable
カスタム・イベント
なし
カスタム・メソッド
65
なし
66
拡張リスト・ボックス・コントロール
概要
VBMan 拡張リスト・ボックス・コントロールは Btrieve の Extended オペレーション
に対応したリスト・ボックス・コントロールです。Btrieve の Extended オペレーショ
ンの特徴は以下です。
複合検索が可能
複数レコードを一度に転送するためパフォーマンスが高い
フィールドの選択によりネットワークの負荷を軽減
通常の Btrieve 呼び出しではパラメータの構成が非常に複雑ですが、VBMan で
はプロパティを指定するだけで簡単に Extended オペレーションが使用可能です。
プロパティの設定
Extended 系オペレーションを実行するためのプロパティ設定の手順を説明しま
す。
①
②
③
④
⑤
⑥
⑦
DbListSource プロパティの指定
DbListTable プロパティの指定
検索対象とするテーブル名を指定します。
DbExOperation プロパティの指定
GET PREVISOU EXTENDED, GET NEXT EXTENDED, STEP PREVI
OUS EXTENDED, STEP NEXT EXTENDED の中から選択します。
DbSkipRecords プロパティの指定
検索条件を満たさない場合にスキップするレコード数を設定します。０を
指定するとシステム定義の最大値を Btrieve が選択して使用します。Bt
rieve 6.15 では 4,095 です。
DbMaxRecords プロパティの指定
検索結果の最大レコード件数を設定します。Btrieve では結果はリニア
なメモリに返されるため、65,536 バイト以上を越えることができません。
65,536 を DbFields プロパティで指定する抽出するフィールドの合計サイ
ズで割った値以上は設定できません。
DbListFields プロパティの指定
抽出するフィールド名をカンマで区切った文字列を指定します。フィール
ド ID でも指定可能です。フィールド ID は DDF ﾋﾞﾙﾀﾞｰの表示値を 0 オフ
セットにした値です。(例：1,2,4)
DbConditions プロパティの指定
検索条件を指定します。指定の詳細はカスタム・プロパティ・リファレン
スを参照してください。
67
⑧
⑨
DbTabStops プロパティの指定
VBMan リスト・ボックスでは Format イベントに渡されるデータは１つの
フィールドの値でしたが、VBMan 拡張リスト・ボックスの場合は複数の
項目が渡されます。DbTabStops プロパティを設定した場合は Format
イベントには DbFields で指定された複数のデータの区切りはタブ(&H0
9)文字になります。DbTabStops プロパティに何も指定しない場合はス
ペース文字(&H20)が区切り文字になります。DbTabStops プロパティは
半角の文字数をカンマで区切って指定します。（例："10,20,30,40")DbTa
bStops プロパティは実行時のコントロールを作成する時に一度だけ参
照されます。実行時にダイナミックに変更することはできません。
DbLeaveResults プロパティの指定
このプロパティの設定は必須ではありません。検索の結果をメモリに保
持しておき、DbExGetFieldData 関数などを使って取り出す場合にこのプ
ロパティを True に設定します。DbExGetFieldData 関数に渡す結果 ID
は DbResultID プロパティに保持されます。（ランタイムのみのプロパティ
のため、プロパティ・リスト・ボックスには表示されないことに注意してく
ださい）DbUpdateOption をフォーカス時に設定した場合は DbExFree で
メモリを解放するコードを記述することが困難と思われるのでお勧めし
ません。
検索開始レコード
VBMan 拡張リスト・ボックスではすべてのレコードを検索対象とするため、Exten
ded オペレーションの前にカレント・レコードのポジショニングを実行します。各オ
ペレーションとポジショニングの関係を以下に示します。
EXTENDED オペレーション
GET PREVIOUS EXTENDED
GET NEXT EXTENDED
STEP PREVIOUS EXTENDED
STEP NEXT EXTENDED
POSITIONINGオペレーション
GET LAST
GET FIRST
STEP LAST
STEP FIRST
注意事項
Refresh メソッドを使うと Btrieve データベースから最新のデータを取得し、リス
ト・ボックスの内容を更新することができます。
以下の表は VBMan に特有のプロパティ、イベント、メソッドです。
カスタム・プロパティ
Abort
DbCompareCase
DbConditions
DbExOperation
68
DbFields
DbListSource
DbIndex
DbTabStops
DbLeaveResults
DbListTable
DbResultID
DbUpdateOption
DbListFields
DbListIndex
DbLocks
DbMaxRecords
DbSkipRecords DbTable
SavePosition
カスタム・イベント
BtrieveError
Format
カスタム・メソッド
Reload
69
拡張コンボ・ボックス・コントロール
概要
VBMan 拡張コンボ・ボックス・コントロールは Btrieve の Extended オペレーショ
ンに対応したコンボ・ボックス・コントロールです。Btrieve の Extended オペレー
ションの特徴は以下です。
複合検索が可能
複数レコードを一度に転送するためパフォーマンスが高い
フィールドの選択によりネットワークの負荷を軽減
通常の Btrieve 呼び出しではパラメータの構成が非常に複雑ですが、VBMan で
はプロパティを指定するだけで簡単に Extended オペレーションが使用可能です。
プロパティの設定
Extended オペレーションを実行させるためのプロパティ設定の手順を説明しま
す。
①
②
③
④
⑤
⑥
⑦
DbListSource プロパティの指定
DbListTable プロパティの指定
検索対象とするテーブル名を指定します。
DbExOperation プロパティの指定
GET PREVISOU EXTENDED, GET NEXT EXTENDED, STEP PREVI
OUS EXTENDED, STEP NEXT EXTENDED の中から選択します。
DbSkipRecords プロパティの指定
検索条件を満たさない場合にスキップするレコード数を設定します。０を
指定するとシステム定義の最大値を Btrieve が選択して使用します。Bt
rieve 6.15 では 4,095 です。
DbMaxRecords プロパティの指定
検索結果の最大レコード件数を設定します。Btrieve では結果はリニア
なメモリに返されるため、65,536 バイト以上を越えることができません。
65,536 を DbFields プロパティで指定する抽出するフィールドの合計サイ
ズで割った値以上は設定できません。
DbListFields プロパティの指定
抽出するフィールド名をカンマで区切った文字列を指定します。フィール
ド ID でも指定可能です。フィールド ID は DDF ﾋﾞﾙﾀﾞｰの表示値を 0 オフ
セットにした値です。(例：1,2,4)
DbConditions プロパティの指定
検索条件を指定します。指定の詳細はカスタム・プロパティ・リファレン
70
⑧
⑨
スを参照してください。
DbDelimitChar プロパティの指定
VBMan 拡張コンボ・ボックスでは項目間の区切り文字を DbDelimtChar
プロパティで指定します。このプロパティに何も指定しない場合はスペー
スが項目間の区切り文字になります。
DbLeaveResults プロパティの指定
このプロパティの設定は必須ではありません。検索の結果をメモリに保
持しておき、DbExGetFieldData 関数などを使って取り出す場合にこのプ
ロパティを True に設定します。DbExGetFieldData 関数に渡す結果 ID
は DbResultID プロパティに保持されます。（ランタイムのみのプロパティ
のため、プロパティ・リスト・ボックスには表示されないことに注意してく
ださい）DbUpdateOption をフォーカス時に設定した場合は DbExFree で
メモリを解放するコードを記述することが困難と思われるのでお勧めし
ません。
検索開始レコード
VBMan 拡張コンボ・ボックスではすべてのレコードを検索対象とするため、Exte
nded オペレーションの前にカレント・レコードのポジショニングを実行します。各
オペレーションとポジショニングの関係を以下に示します。
EXTENDED オペレーション
GET PREVIOUS EXTENDED
GET NEXT EXTENDED
STEP PREVIOUS EXTENDED
STEP NEXT EXTENDED
POSITIONINGオペレーション
GET LAST
GET FIRST
STEP LAST
STEP FIRST
注意事項
Refresh メソッドを使うと Btrieve データベースから最新のデータを取得し、コン
ボ・ボックスの内容を更新することができます。
以下の表は VBMan 拡張コンボ・ボックスに特有のプロパティ、メソッド、イベント
です。
カスタム・プロパティ
Abort
DbExOperation
DbListIndex
DbMaxRecords
DbTable
DbCompareCase
DbFields
DbListSource
DbIndex
DbUpdateOption
DbConditions
DbLeaveResults
DbListTable
DbResultID
SavePosition
DbDelimitChar
DbListFields
DbLocks
DbSkipRecords
71
カスタム・イベント
BtrieveError
Format
カスタム・メソッド
Reload
72
グリッド・コントロール
概要
VBMan グリッド・コントロールは Btrieve の Extended オペレーションを使ってグ
リッドにデータを表示します。
プロパティの設定
Extended オペレーションを実行させるためのプロパティ設定の手順を説明しま
す。
①
②
③
④
⑤
⑥
⑦
⑧
DbListSource プロパティの指定
DbListTable プロパティの指定
検索対象とするテーブル名を指定します。
DbExOperation プロパティの指定
GET PREVISOU EXTENDED, GET NEXT EXTENDED, STEP PREVI
OUS EXTENDED, STEP NEXT EXTENDED の中から選択します。
DbSkipRecords プロパティの指定
検索条件を満たさない場合にスキップするレコード数を設定します。０を
指定するとシステム定義の最大値を Btrieve が選択して使用します。Bt
rieve 6.15 では 4,095 です。
DbMaxRecords プロパティの指定
検索結果の最大レコード件数を設定します。Btrieve では結果はリニア
なメモリに返されるため、65,536 バイト以上を越えることができません。
65,536 を DbFields プロパティで指定する抽出するフィールドの合計サイ
ズで割った値以上は設定できません。
DbListFields プロパティの指定
抽出するフィールド名をカンマで区切った文字列を指定します。フィール
ド ID でも指定可能です。フィールド ID は DDF ﾋﾞﾙﾀﾞｰの表示値を 0 オフ
セットにした値です。(例：1,2,4)
DbConditions プロパティの指定
検索条件を指定します。指定の詳細はカスタム・プロパティ・リファレン
スを参照してください。
DbLeaveResults プロパティの指定
このプロパティの設定は必須ではありません。検索の結果をメモリに保
持しておき、DbExGetFieldData 関数などを使って取り出す場合にこのプ
ロパティを True に設定します。DbExGetFieldData 関数に渡す結果 ID
は DbResultID プロパティに保持されます。（ランタイムのみのプロパティ
のため、プロパティ・リスト・ボックスには表示されないことに注意してく
73
ださい）DbUpdateOption をフォーカス時に設定した場合は DbExFree で
メモリを解放するコードを記述することが困難と思われるのでお勧めし
ません。
検索開始レコード
VBMan グリッドではすべてのレコードを検索対象とするため、Extended オペレ
ーションの前にカレント・レコードのポジショニングを実行します。各オペレーショ
ンとポジショニングの関係を以下に示します。
EXTENDED オペレーション
GET PREVIOUS EXTENDED
GET NEXT EXTENDED
STEP PREVIOUS EXTENDED
STEP NEXT EXTENDED
POSITIONINGオペレーション
GET LAST
GET FIRST
STEP LAST
STEP FIRST
注意事項
Btrieve ファイル・バージョン
Btrieve のファイル・フォーマットはバージョン 6.x 以上であることが必要です。
表示内容の更新
Refresh メソッドを使うと Btrieve データベースから最新のデータを取得し、グリッ
ドを更新することができます。
トランザクション・コントロール
AllowDelete,AllowUpdate プロパティを True に設定した場合、表示データを削除、
修正することが可能です。グリッドの DbListSource で指定したデータ・ベース・コ
ントロールの DbBeginTransaction/DbAbortTransaction/DbEndTransaction メソ
ッドを適宜発行することで、表示データの修正をトランザクションとしてコントロー
ルすることが出来ます。
以下の表は VBMan グリッドに特有のプロパティ、メソッド、イベントです。
カスタム・プロパティ
Abort
AllowUserResizing
DbExOperation
AlignFixedCells
CellMaxLength
DbLeaveResults
AllowDelete
AllowUpdate
DbCompareCase DbConditions
DbListFields
DbListIndex
74
DbListSource
DbResultID
SetColWidth
DbListTable
DbLocks
DbMaxRecords
DbSkipRecords
DbUpdateOption SetColNames
SetRecordNumbers
カスタム・イベント
AfterColUpdate
BeforeDelete
AfterDelete
BeforeUpdate
AfterUpdate
BtrieveError
BeforeColUpdate
Format
カスタム・メソッド
Reload
75
カスタム・プロパティ・リファレンス
VBMan Controls for Btrieve のカスタム・プロパティについての解説です。
Abort
概要
Abort プロパティは VBMan ボタンの SetData イベントの中でデータベースに登
録するデータを検査して不都合を発見した場合、値を True にセットすることで、
データベースへの操作を中止できます。
また、リスト・ボックス等の Format イベント中で True に設定された場合には、リ
ストへのデータの読み込みは中断されます。
プロパティ・データ・タイプ
文字列型
対象コントロール
ボタン、リスト、コンボ、拡張リスト、拡張コンボ、グリッド
AlignFixedCells
概要
グリッドの固定セル上のテキストの右アライメントの有効/無効を設定します。設
定値は以下となります。
プロパティ値
False
True
意味
固定セルのテキストの右アライメントを無効とする。固定セ
ルのテキストは常に左アライメントとなる。
固定セルのアライメントは TextAlign プロパティの設定が有
効となる。
プロパティ・データ・タイプ
論理型
対象コントロール
グリッド
76
AllOpen
概要
VBMan データベース・コントロールが実行モードでロードされたときにこのプロ
パティに値１が設定されていると、DDFDir プロパティで指定される DDF 定義に
あるテーブルに関連する Btrieve ファイルをすべてオープンします。このプロパ
ティに値 0 が指定されている場合は、各 VBMan コントロールが Btrieve ファイ
ルにアクセスすることが必要となるイベントが発生した時に Btrieve ファイルをオ
ープンします。
プロパティ・データ・タイプ
整数型
対象コントロール
データベース
AllowDelete
概要
グリッドに表示されているデータの削除を許可します。設定値は以下のようにな
ります。
プロパティ値
False
True
意味
削除は実行されません。
削除は実行されます。
プロパティ・データ・タイプ
論理型
対象コントロール
グリッド
注意
グリッドからデータを削除する場合は FixedRows プロパティに１以上を設定して
マウスで削除する行を指定できるようにする必要があります。削除の操作手順
は以下のようになります。
①
②
削除したい行の左固定セルをマウス左クリックで選択します。
削除キーを押します。
77
AllowUpdate
概要
グリッドに表示されているデータの更新を許可します。設定値は以下のようにな
ります。
プロパティ値
False
True
意味
更新は実行されません。
更新は実行されます。
プロパティ・データ・タイプ
論理型
対象コントロール
グリッド
AllowUserResizing
概要
グリッド・セルのリサイズを指定します。設定値は以下のようになります。
プロパティ値
0
1
2
3
意味
リサイズしない
カラム方向にリサイズ
ロー方向にリサイズ
両方向にリサイズ
プロパティ・データ・タイプ
正数型
対象コントロール
グリッド
AutoFirst
概要
このプロパティに True を設定すると、スクロール･バー・コントロールがロードさ
78
れた時に Btrieve の GET FIRST オペレーションを実行します。GET FIRST オ
ペレーションの結果は VBMan エディット・コントロールなどに表示されます。VB
Man リスト･ボックス、コンボ･ボックスを併用する場合は、フォームにコントロー
ルを配置する順に依存してリスト・ボックスにデータが表示されるタイミングとス
クロール・バーが GET FIRST オペレーションを実行するタイミングが前後するこ
とがありますのでご注意ください。スクロールとデータ登録関連のプロパティをセ
ットしたリスト･ボックス、コンボ･ボックスを併用する場合は、Visual Basic でした
ら、Form の Activate イベントでリスト、スクロールの順で明示的に Refresh メソ
ッドを呼び出すコードを記述してください。以下はサンプル・コードです。Static に
用意されているフラグは Activate イベントを初期化時の１回目だけに Refresh
を実行するための識別に使っています。
Sub Form1_Activate
Static bFirstFlag As Integer
If bFirstFlag = False Then
VBManListBox1.Refresh
VBManVScroll1.Refresh
bFirstFlag = True
End If
プロパティ・データ・タイプ
論理型
対象コントロール
水平スクロール・バー、垂直スクロール･バー
BlobPath
概要
VBMan ピクチャー・コントロールでイメージ･データの存在するディスク上のパス
を指定します。このプロパティを指定しない場合は VBMan ピクチャー・コントロ
ールはカレント・ドライブのカレント・ディレクトリに存在するイメージ･ファイルを表
示します。
プロパティ・データ・タイプ
文字列型
対象コントロール
ピクチャー・コントロール
79
CacheDDF
概要
このプロパティの値を True に設定した場合、同一プロセス内に同じ DDFDir プ
ロパティを定義したデータ・ベース・コントロールが存在し、すでに DDF 情報を読
みこんでいる場合に限り、実際の DDF を再度読みこむのではなく、メモリ間のコ
ピーによって DDF 情報を複製してパフォーマンスの向上を実現します。プロパ
ティの値を False と設定した場合にはメモリでの
DDF 複製は行われず、DDFDir プロパティで指定される DDF を読みこんで DDF
情報を設定します。
プロパティ・データ・タイプ
論理型
対象コントロール
データ・ベース
CellMaxLength
概要
AllowUpate プロパティを True に設定してデータの更新を可能としたグリッドでカ
ラム単位で編集ウィンドウに入力できる最大バイト数を設定します。カラムはプ
ロパティのインデックスとして指定します。
プロパティ・データ・タイプ
論理型
対象コントロール
グリッド
注意
設定する値は文字の最大バイト数で、文字数では無いことに注意してください。
漢字は 2 バイトとしてカウントされます。
サンプル・コード
VBMGrid1.CellMaxLength(2) = 32
‘ 32 バイトまで文字を入力可能
ClearControlData
80
概要
このプロパティの値を True に設定すると、DbOperation プロパティに Insert,Dele
te,Update オペレーションを設定した場合に、ボタンのクリックにより Btrieve の
呼び出しが正常終了した後、VBMan エディットなどデータが表示されていたフィ
ールドのデータを空白にします。データを空白にするコントロールは DbSource,D
bTable プロパティが一致しているコントロールに限定されます。
プロパティ・データ・タイプ
文字列型
対象コントロール
ボタン
ConfirmMsg
概要
ConfirmMsg プロパティを設定すると、VBMan ボタンに設定されたオペレーション
を Btrieve データベースに対して実行する前に確認メッセージが表示されます。
確認メッセージに No と答えた場合はデータベースに対するオペレーションは実
行されません。このプロパティは例えば、削除のオペレーションなどをボタンに
設定し、削除する前にユーザーに確認を促したい場合などに使います。
プロパティ・データ・タイプ
文字列型
対象コントロール
ボタン
DbCompareCase
概要
Btrieve の Extended 系を使用する VBMan コントロールでこのプロパティ値を Tr
ue に設定すると、DbConditions プロパティで指定される検索条件を比較すると
き英数字のケース・センスを指定できます。このプロパティの設定はそのまま Bt
rieve の Extended 呼び出しのパラメータ・ブロックに設定されます。
プロパティ値
0
1
動作
大文字・小文字を区別
大文字・小文字を区別しない
81
プロパティ・データ・タイプ
整数型
対象コントロール
拡張リスト、拡張コンボ、グリッド
DbConditions
概要
Btrieve の Extended 系を使用する VBMan コントロールにおいて、検索条件を指
定します。検索条件の指定は以下のような書式です。
フィールドの指定
フィールドは＠をプリフィックスとして指定します。たとえば@1 はフィールド ID の
１を意味します。VBMan for Btrieve/VBX プロフェッショナル版ではフィールド I
D しか指定できませんでしたが、VBMan Controls for Btrieve ではフィールド名
をそのまま指定できます。
比較演算子
比較演算子は以下の値を指定可能です。
=
>
<
<>
>=
<=
等しい
より大きい
より小さい
等しくない
より大きいか等しい
より小さいか等しい
複合検索
複合検索をする場合は検索条件を & (AND) | (OR)で結合します。
比較対象
比較対象で即値を指定する場合、スペースがディリミッタになります。スペース
が含まれる即値の場合はシングル・クゥォート、ダブル・クゥォート、スラッシュが
使えます。
例1
フィールド ID が 0 の項目が 100 から 1000 までの範囲
@0 >= 100 & @0 <= 1000
82
例2
フィールド名’会社名’が”TechKnowledge”または”System lab”
@会社名 = "TechKnowledge" | @会社名 = "System lab"
例3
フィールド ID の 0 と 1 が同じ値または 1000 以上
@0 = @1 | @0 >= 1000
例4
フィールド ID が 2 の項目が”NetScape”,”Microsoft”以外
@2 <> 'Microsoft' & @2 <> 'NetScape'
注意
このプロパティの各トークンの間はシングル・バイトのスペースで区切ってくださ
い。
複合検索においては、このプロパティの左から右への優先順位で評価されます。
括弧を使った優先順位づけなどはサポートされません。理由は、このプロパティ
の指定どうりに Btrieve の検索パラメータ・ブロックを作成して Btrieve の Extend
ed オペレーションをしているだけなので、Btrieve の Extended オペレーションに
おいてもパラメータ・ブロックの検索条件に優先順位がない為です。
文字列を検索フィールドに指定する場合英数字に関して DbCompareCase プロ
パティを「大文字・小文字の区別なし」に設定することで大文字、小文字を無視し
た比較が可能です。２バイト文字の英数字にはこのオプションは無効です。
プロパティ・データ・タイプ
文字列型
対象コントロール
拡張リスト、拡張コンボ、グリッド
DbDelimitChar
概要
拡張コンボ・ボックスで DbListFields プロパティに複数のフィールドを指定する場
合、フィールドの間を連結する文字を DbDelimitChar プロパティで指定します。
拡張コンボ・ボックスの Format イベントのパラメータとなる表示文字列もこのプ
ロパティで指定する文字で連結されて渡されます。Format イベントでフィールド
の文字を整形してコンボに表示する場合は、このプロパティにフィールドのデー
タとして存在しない値を設定して、Format イベントでフィールドの値を区別します。
この文字にはバイナリ・ゼロを指定することはできません。プロパティに何も指
定しない場合は、デフォルトとしてスペース文字(0x20,Chr$(20))をフィールド間の
83
区切り文字として使用します。
Visual Basic のプロパティ・ウィンドウでは文字列データとして存在しない Tab
のような文字を指定することはできませんから、以下のようにコードで指定する
ことになります。
VBManExComboBox1.DbDelitChar = Chr$(9)
VBManExComboBox1.Refresh
プロパティ・データ・タイプ
文字列型
対象コントロール
拡張コンボ
DbExOperation
概要
Btrieve の Extended オペレーションに対応した VBMan コントロールで、Extende
d オペレーションの種類を指定します。リスト・ボックスやコンボ・ボックスで Sort
プロパティを True に設定した場合は DbListIndex プロパティで設定されるキー
に沿って Get Previous/Next Extended オペレーションしても、リストに挿入され
る時にソートされてしまうので、注意してください。
プロパティ値
0
1
2
3
EXTENDED オペレーション
Get Previous Extended
Get Next Extended
Step Previous Extended
Step Next Extended
プロパティ・データ・タイプ
整数型
対象コントロール
拡張リスト、拡張コンボ、グリッド
DbField
概要
VBMan コントロールがデータを交換する、テーブルのフィールド名を指定します。
84
プロパティ設定ダイアログでは、DbSource,DbTable プロパティを選択した後でな
ければ、選択肢は表示されません。
プロパティ・データ・タイプ
文字列型
対象コントロール
ボタン、チェック・ボックス、コンボ、拡張コンボ、拡張リスト、エディット、グリッド、
オプション・ボタン、リスト、ピクチャー、スクロール
DbIndex
概要
Btrieve のオペレーションで GET PREVIOUS,GET NEXT などのインデックス・パ
スを必要とするオペレーションを VBMan ボタンで実行する場合に指定します。V
BMan スクロールでは、マウスのクリックなどで GET PREVIOUS,GET NEXT な
どの Btieve オペレーション を発行しますが、このプロパティの指定によって、イ
ンデックスのパスを指定します。このプロパティを指定しないと、インデックスの
パスは DDF 定義の最初のインデックスとしてこれらのオペレーションを実行しま
す。
インデックスの指定はVBMan for Btrieveバージョン 1.xではshort型の整数値で
したが、このバージョンではインデックスの名前を指定します。同じフィールド名
で異なるインデックスや、セグメント・キーの先頭のフィールド名が別のインデッ
クスでも存在し、複数のフィールド名が選択肢になる場合、DDFビルダーの「イ
ンデックス名の追加」で識別可能なインデックス名 12を設定してください。
プロパティ・データ・タイプ
文字列型
対象コントロール
ボタン、スクロール
DbLeaveResults
概要
Btrieve の Extended オペレーションでデータを取得する VBMan コントロールに
おいて、検索の結果をメモリに保持したい場合にこのプロパティを True に設定
12
Scalable SQL のマニュアルでは Named Index と記述されます。Create Index
という SQL 文で指定されるインデックスの名前です。
85
します。検索の結果は DbResultID プロパティに結果 ID が返され、この値を元に
DbExGetFieldData メソッド/関数でデータを参照することができます。検索結果
が不要になったら、DbExFree メソッド/関数で結果を開放してください。結果を開
放しないで、プログラムを終了した場合は動作を保証できません。
プロパティ・データ・タイプ
論理型
対象コントロール
拡張リスト、拡張コンボ、グリッド
DbListFields
概要
拡張リスト等複数のフィールドをリストするコントロールにおいて表示するフィー
ルドを指定します。フィールドはカンマ区切りで複数を指定できます。このプロパ
ティがプロパティ・ダイアログで指定可能になるためには、DbListSource,DbListT
able プロパティをこのプロパティより先に指定していることが必要です。
バージョン 1.x ではカンマ区切りで整数値のフィールド ID を指定していましたが、
このバージョンでは、カンマ区切りでフィールドの名前を指定します。
カンマはシングル・バイトのカンマを指定することに注意してください。
以下は Visual Basic におけるサンプル・コードです。
Sub Command1_Click()
VBManExListBox1.DbListFields = “コード,商品名,仕入先コード”
VBManExListBox1.Refresh
End Sub
プロパティ・データ・タイプ
文字列型
対象コントロール
拡張リスト、拡張コンボ、グリッド
DbListIndex
概要
Btrieve データをリストする VBMan コントロールでは、GET FIRST, GET NEXT
の順または、GET FIRST, GET NEXT EXTENDED などの順で Btrieve オペレ
ーションを発行します。これらのオペレーションはこの DbListIndex プロパティで
86
指定されたインデックス順にデータを読み込みます。
DbListIndex プロパティであるインデックス順にデータを読み込んだ場合、対象と
なるコントロールの Sort プロパティを True に設定すると、コントロールにデータ
が挿入される時点でソートされてしまい、このインデックス指定順にならない場
合がありますのでご注意ください。
プロパティは文字型で、コントロールのプロパティ・ダイアログで指定する場合は、
DbListSource,DbListTable プロパティが設定されていないと、選択肢がリストさ
れないのでプロパティの設定順にご注意ください。
プロパティ・データ・タイプ
文字列型
対象コントロール
ボタン、スクロール
DbListSource
概要
リスト系の VBMan コントロールが参照する VBMan データベース・コントロール
の Name プロパティの値を指定します。このプロパティを設定する対象となる VB
Man コントロールより先にフォームに VBMan データベース・コントロールが置か
れていない場合には、プロパティ設定ダイアログで選択肢が表示されません。
実行時にはこのプロパティで指定される VBMan コントロールの DDFDir プロパ
ティで指定されるテーブル、フィールド情報にしたがって、Btrieve データをリスト
します。
プロパティ・データ・タイプ
文字列型
対象コントロール
リスト、コンボ、拡張コンボ、拡張リスト、グリッド
DbListTable
概要
リスト系の VBMan コントロールがデータをリストするテーブル名を指定します。
プロパティ設定ダイアログでは、DbListSource が先に設定されていないと、選択
肢が表示されません。
プロパティ・データ・タイプ
87
文字列型
対象コントロール
リスト、コンボ、拡張コンボ、拡張リスト、グリッド
DbLocks
概要
DbLocksプロパティはBtrieveデータベースに対するオペレーション実行時にか
けるロックのタイプを指定します。シングル、マルチ、Wait,NoWaitを選択します。
13
プロパティ値
0
1
2
3
4
意味
ロックしない
シングル・ウェイト
シングル・ノーウェイト
マルチ・ウェイト
マルチ・ノーウェイト
ロックを解除する場合はDbUnlockメソッドまたは関数を使用することでも可能で
す。 14
プロパティ・データ・タイプ
整数型
対象コントロール
ボタン、拡張コンボ、拡張リスト、グリッド
DbMaxRecords
概要
Btrieve の Extended 系オペレーションでデータを取得する VBMan コントロール
で、検索結果の最大レコード件数を設定します。Btrieve では結果はリニアなメ
モリに返されるため、65,536 バイト以上を越えることができません。65,536 を Db
ListFields プロパティで指定する抽出するフィールドの合計サイズで割った値以
13
DbAccess メソッド・関数でロックをかける場合は第一パラメータの値にロック・
バイアス値を加算します。
14 Single ロックなどの場合は別のレコードにロックするとそれ以前のロックは解除
されます。
88
上は設定できません。
プロパティ・データ・タイプ
整数型
対象コントロール
拡張コンボ、拡張リスト、グリッド
DbOperation
概要
VBMan ボタンがクリックされたときに発行する Btrieve オペレーションを指定しま
す。以下の値が指定可能です。
プロパティ値
0
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
BTRIEVE オペレーション
Insert
Update
Delete
GetEqual
GetFirst
GetLast
GetNext
GetPrevious
GetGreater
GetLessThan
GetGreaterOrEqual
GetLessThanOrEqual
StepFirst
StepLast
StepNext
StepPrevious
プロパティ・データ・タイプ
整数型
対象コントロール
ボタン
89
DbPhysicalPosition
概要
AllowDelete/AllowUpdate を True に設定したグリッドコントロールに表示されて
いるレコードの Btrieve ファイル上の物理位置を保持します。物理位置を取得す
る場合にはゼロ・オフセットのインデックスを指定して４バイトの物理位置を得る
ことができます。Fixed セルにはデータは表示されませんから、グリッドに表示さ
れている先頭のレコードの物理位置を得る場合には値０をプロパティ・インデッ
クスとして指定します。取得した物理位置は DbGetDirect メソッドに指定してレコ
ード全体を取得する等の利用が可能です。
プロパティ・データ・タイプ
長整数型
対象コントロール
グリッド
サンプル・コード
Dim lPos As Long
Dim rc As Integer
lPos = VBManGrid1.DbPhysicalPositon(3)
rc = VBManDb1.DbGetDirect(“TEST_TABLE”,lPos,”INDEX-1”)
DbResultID
概要
Btrieve の Extended 系オペレーションでデータをリストする VBMan コントロール
の DbLeaveResults プロパティを True に設定した場合には、このプロパティに結
果 ID が返されます。この ID を基に DbExGetFieldData メソッド/関数で検索結
果を得ることができます。検索結果が不要になったら、この ID を DbExFree メソ
ッド/関数で開放してください。プログラムの終了時に開放されていない場合の
動作については保証できません。
プロパティ・データ・タイプ
文字列型
対象コントロール
拡張コンボ、拡張リスト、グリッド
90
DbSavePosition
概要
このプロパティを True に設定すると、検索結果の Btrieve レコード物理位置を It
emData プロパティに保持します。この物理位置からレコード全体を取得するに
は DbGetDirect メソッドまたはバージョン 1.x コンパチブル・関数を使います。以
下はコード例です。
Dim Position As Long
Dim rc As Integer
‘ リストの先頭にあるレコードをカレント･レコードにする。
Position = VBManComboBox1.ItemData(0)
rc = VBMan1.DbGetDirect(“CUSTOMER”,Position,”INDEX1”)
If rc <> 0 Then
MsgBox “Btrieve error “ & CStr(rc)
Stop
End If
プロパティ・データ・タイプ
論理型
対象コントロール
拡張リスト･ボックス、拡張コンボ･ボックス
DbSkipRecords
概要
BtrieveのExtended系オペレーションでデータを取得するVBManコントロールで、
DbConditionsプロパティで指定される検索条件に合致しないレコード件数を指定
します。このプロパティの値だけ検索結果に合致しないレコードを読み込んだ場
合、Btrieveはステータス 64 15を返します。このステータスを得た場合はこの値を
大きくしてください。0 を指定した場合はシステムで定義された最大値となります。
Btrieve 6.15 ではこの値は 4,095 です。
プロパティ・データ・タイプ
15
Filter Limit Reached
91
整数型
対象コントロール
拡張コンボ、拡張リスト、グリッド
DbSource
概要
VBMan コントロールがデータを交換する VBMan データベース・コントロールの
Name プロパティの値を指定します。このプロパティを設定する対象となる VBMa
n コントロールより先にフォームに VBMan データベース・コントロールが置かれ
ていない場合には、プロパティ設定ダイアログで選択肢が表示されません。
プロパティ・データ・タイプ
文字列型
対象コントロール
ボタン、チェック・ボックス、コンボ、拡張コンボ、拡張リスト、エディット、グリッド、
オプション・ボタン、リスト、ピクチャー、スクロール
DbTable
概要
コントロールがデータを交換するテーブル名を指定します。プロパティの設定ダ
イアログでは DbSource プロパティを選択した後でなければ、選択肢は表示され
ません。
プロパティ・データ・タイプ
文字列型
対象コントロール
ボタン、チェック・ボックス、コンボ、拡張コンボ、拡張リスト、エディット、グリッド、
オプション・ボタン、リスト、ピクチャー、スクロール
DbTabStops
概要
拡張リスト・ボックスにおいて複数のフィールドを表示するように DbListFieds プ
ロパティで指定した時、それぞれのフィールドの表示開始カラム位置をこのプロ
パティで設定します。タブ位置はカンマで区切り、表示するフィールドの数だけ指
92
定します。
プロパティ・データ・タイプ
文字列型
対象コントロール
拡張リスト
Visual Basic サンプル
VBManExListBox1.DbTabStops = “1,20,30”
VBManExListBox1.Refresh
DbUpdateOption
概要
リスト・ボックスやコンボ・ボックスにデータを読み込むタイミングを設定します。
設定値は以下です。
プロパティ値
0
1
2
動作
データはリストされません。Refresh メソッドを発行してデータ
をリストしてください。
初期化時。コントロールがロードされた時、またはこのコント
ロールが参照しているデータベース・コントロールがロードさ
れた時にデータをリストします。
フォーカス時にデータをリストします。大量のデータをリスト
する場合、フォーカス時に設定すると、フィールドを移動する
ときにパフォーマンスに問題がでる場合が考えられます。デ
ータ量をよく見積もってからこの値を設定してください。
プロパティ・データ・タイプ
整数型
対象コントロール
コンボ、リスト、拡張リスト、拡張コンボ
DbValueFalse
93
概要
Btrieve データ・ベースのフィールドの値がこのプロパティで指定される値と同一
になった場合に、チェック・ボックスの場合は非チェック状態に、オプション・ボタ
ンの場合は非選択状態になります。VBMan バージョン 1.x では論理値しか設定
できませんでしたが、VBMan Controls for Btrieve からは、フィールドの値を表
示形式にした値とこのプロパティに設定した値を比較するように変更されました。
プロパティ・データ・タイプ
文字列型
対象コントロール
チェック・ボックス、オプション・ボタン
DbValueIndetraminate
概要
Btrieveデータ・ベースのフィールドの値がこのプロパティで指定される値と同一
になった場合に、チェック・ボックスはグレー状態 16になります。
プロパティ・データ・タイプ
文字列型
対象コントロール
チェック・ボックス
DbValueTrue
概要
Btrieveデータ・ベースのフィールドの値がこのプロパティで指定される値と同一
になった場合に、チェック・ボックスの場合はチェック状態に、オプション・ボタン
の場合は選択状態になります。VBManバージョン 1.xでは論理値しか設定でき
ませんでしたが、VBMan Controls for Btrieveからは、フィールドの値を表示形
式 17にした値とこのプロパティに設定した値を比較するように変更されました。
プロパティ・データ・タイプ
16
Win32 API リファレンスの BM_SETCHECK メッセージの説明を参照してくださ
い。WPARAM の値が 2 の場合にこの状態になります。
17 たとえば、バイナリの整数型をプリントできる文字(printable character)に変換
すること。
94
文字列型
対象コントロール
チェック・ボックス、オプション・ボタン
DDFDir
概要
VBMan データベース・コントロールのプロパティで DDF ファイルが存在するディ
レクトリを指定します。指定するディレクトリには以下の３ファイルが存在してい
ることが必要です。
FILE.DDF
FIELD.DDF
INDEX.DDF
プロパティ・データ・タイプ
文字列型
対象コントロール
データベース・コントロール
DistName
概要
このプロパティは DDFDir プロパティをアプリケーション配布時に置き換える VB
MAN.INI ファイルのセクション名を指定します。詳細は VBMan Controls for Btr
ieve で作成したアプリケーションの配布の章を参照してください。
プロパティ・データ・タイプ
文字列型
対象コントロール
データベース・コントロール
Format
概要
Format プロパティは Visual Basic を開発言語としている場合のみ、設定可能な
95
プロパティです。このプロパティの書式は Visual Basic の Format$関数の整形
文字列が指定可能です。たとえば、数値型であれば、このプロパティには “###,
###,###”のような文字列を指定すると、数値入力された場合に、以下で説明す
る FormatOption 設定のタイミングで”123,456”のように文字列が整形され、VBM
an エディットに設定・表示されます。
VBMan エディットは関連するフィールドのデータ型が Date 型、Time 型の場合、
この Format プロパティに何も指定されていなければ、それぞれ”YYYY/MM/D
D”,”HH:MM:SS”の形式でデータを整形します。
プロパティ・データ・タイプ
文字列型
対象コントロール
エディット
注意
リスト･ボックス、コンボ･ボックス、拡張リスト･ボックス、拡張コンボ･ボックス、グ
リッドには Format イベントが存在し、エディットには Format プロパティが存在し
ます。
FormatOption
概要
Format プロパティを設定したときに、VBMan エディットの動作オプションを設定
します。以下の値がプロパティに設定可能です。
プロパティ値
0
1
2
3
オプション動作
オプションを設定しません。
文字単位でフォーマット。キーボードからの文字入力が発
生する度に Format プロパティの指定があれば、これにし
たがって整形した文字列を VBMan エディットに設定しま
す。
右揃え。Format 文字列で整形した文字列を MaxLength プ
ロパティにしたがって、右揃えで表示します。また、VBMan
エディットがフォーカスを受け取った場合、文字列の右にカ
ーソルを設定します。かならず MaxLength プロパティに適
当な値を設定することが必要なことに注意してください。
右そろえ＋文字単位フォーマット。このプロパティの値１と２
の動作をあわせておこないます。
プロパティ・データ・タイプ
96
整数型
対象コントロール
エディット
FormatString
概要
グリッドのカラム単位に整形文字列を指定します。整形文字列の形式は Visual
Basic の Format 関数とコンパチブルです。ホスト言語が Visual Basic の場合の
みこのプロパティの動作が保証されます。カラムの指定はプロパティのインデッ
クスで０ベースになります。
プロパティ・データ・タイプ
文字列型配列
対象コントロール
グリッド
サンプル・コード
With VBMGrid1
.FormatString(0) = “@@@@@@@@@@”
.FormatString(1) = “###,###,###”
.Refresh
End With
NumericMask
概要
VBManエディットコントロールに入力される文字を数値と特定の文字に限定しま
す。マスクを通過する文字は数値 18と,.+-です。Formatプロパティに###,###,###
のような数値を整形する文字列を設定する場合、このプロパティをTrueに設定
すると、ユーザーが誤って、英文字を入力したりすることを防止できます。
プロパティ・データ・タイプ
論理型
対象コントロール
18
シングル・バイトのみ。
97
エディット
OpenMode
概要
VBManデータベース・コントロールに関連するBtrieveファイルのオープン・モード
19を指定します。オープン・モードとして指定可能なプロパティ値は以下です。
プロパティ値
0
1
2
3
4
5
6
オープン・モード
ノーマル
アクセルレーテッド
リード・オンリー
ベリファイ
エクスクルーシブ
シングル・エンジン・ファイル・シェア
マルチ・エンジン・ファイル・シェア
プロパティ・データ・タイプ
整数型
対象コントロール
データベース・コントロール
OwnerName
概要
VBMan データベース・コントロールに関連する Btrieve ファイルの オーナー名
を指定します。
プロパティ・データ・タイプ
文字列型
対象コントロール
データベース・コントロール
19
Btrieve ファイルのオープン・モードの詳細は Btrieve プログラマーズ・マニュア
ルの Open オペレーションにあります。
98
ReadOnly
概要
このプロパティを True に設定すると、VBMan エディット・コントロールを読み取り
専用に設定します。キーボードによる、文字は受け付けなくなります。
プロパティ・データ・タイプ
論理型
対象コントロール
エディット
SetColNames
概要
このプロパティの値を True に設定するとグリッドにデータを表示するときに、最
初の Fixed カラムに DbListFields プロパティで指定されたフィールド名を設定、
表示します。グリッドの FixedCols プロパティの値は１に設定してください。
プロパティ・データ・タイプ
論理型
対象コントロール
グリッド
SetColWidth
概要
SetColNames プロパティとこのプロパティに値 True を設定した場合はグリッドに
データ・ベースから読み、カラム名を Fixed セルに設定する時にセルの幅を自動
的に調整します。設定されるセルの幅はフィールド名の文字列がすべて表示さ
れる幅となります。
プロパティ・データ・タイプ
論理型
対象コントロール
グリッド
SetRecordNumber
99
概要
このプロパティの値を True に設定するとグリッドにデータを表示するときに、最
初の Fixed ローにレコード番号を設定、表示します。グリッドの FixedRows プロ
パティの値は１に設定してください。
プロパティ・データ・タイプ
論理型
対象コントロール
グリッド
TextAlign
概要
グリッドのセルに表示される文字列のアライメントを指定します。セルの指定は
列単位での指定が可能です。列の指定はプロパティの配列で指定します。固定
セルに関しては AlignFixedCells プロパティを False に設定すると右つめの指定
は無効となります。
指定可能なプロパティ値は以下です。
プロパティ値
0
1
アライメント
左つめ
右つめ
プロパティ・データ・タイプ
整数型
対象コントロール
グリッド
サンプル・コード
Private Sub Form_Load
With VBManGrid1
.TextAlign(1) = 1
‘右つめ
.ColWidth(1) = 1000
‘セル幅を設定
.ImeMode(1) = 1
‘IME モードを設定
.CellMaxLength(1) = 10
‘入力の最大長を設定
.Col = 1
100
.Row = 0
.Text = “売上高”
.Refresh
End With
End Sub
‘ データを読み込む
UpperCase
概要
このプロパティを True に設定すると、VBMan エディット・コントロールに英数文
字を入力された場合にはアッパーケースに変換します。
プロパティ・データ・タイプ
論理型
対象コントロール
エディット
101
カスタム・イベント・リファレンス
VBMan Controls for Btrieve のカスタム・イベントについて解説します。
AfterColUpdate
書式
Object_AfterColUpdate()
パラメータ
なし
概要
グリッドコントロールでは AllowUpdate プロパティを True に設定した場合にセル
が編集可能になります。編集可能となったセルからフォーカスが右矢印キーま
たは Enter キーにて次のセルに移動するときに編集内容が Text プロパティとし
て保持された後に当イベントが発生します。
対象コントロール
グリッド
AfterDelete
書式
Object_AfterDelete()
パラメータ
なし
概要
AllowDelete プロパティを True に設定したグリッドでレコード削除が実行された
後に発生するカスタム・イベントです。
対象コントロール
グリッド
AfterUpdate
102
書式
Object_AfterUpdate()
パラメータ
なし
概要
AllowUpdate プロパティを True に設定したグリッド・コントロールでレコードの Up
date 終了後に発生するイベントです。
対象コントロール
グリッド
BeforeColUpdate
書式
Object_BeforeColUpdate( Cancel As Integer, ColValue As String )
パラメータ
Cancel
ColValue
0 以外の値をイベント無いで設定した場合にはカラムの変更を
キャンセルします。
編集されたテキストの値です。編集前のテキストは Text プロパ
ティに設定されています。
概要
AllowUpdate プロパティを True に設定したグリッド・コントロールではカラムの編
集が可能になります。当イベントはカラムが編集されて変更がグリッドの Text プ
ロパティとして設定される前に発生します。アプリケーションはカラムの値を検査
して不正と判断した場合には Cancel パラメータに 0 以外の値をセットすることで
編集以前の値に戻すことが出来ます。
対象コントロール
グリッド
BeforeDelete
書式
Object_BeforeDelete( Cancel As Integer )
103
パラメータ
Cancel
0 以外の値をイベント無いで設定した場合にはレコードの Delet
e をキャンセルします。
概要
対象コントロール
グリッド
BeforeUpdate
書式
Object_BeforeUpdate( Cancel As Integer )
パラメータ
Cancel
0 以外の値をイベント無いで設定した場合にはレコードの Upda
te をキャンセルします。
概要
AllowUpdate プロパティを True に設定したグリッド・コントロールでレコードの Up
date を実行する直前に発生するイベントです。アプリケーションはイベント内で
は変更されるデータの妥当性を検証して、データに不正が発見された場合はエ
ラー・メッセージを表示して Calcel パラメータに 0 以外の値を設定することでレコ
ードの Update 処理を無効にできます。
対象コントロール
グリッド
BtrieveError
書式
Object_BtrieveError( TableName As String,
Status As Integer )
パラメータ
TableName
Status
Btrieve 呼び出しの対象となったテーブル名。
Btrieve からのステータス。
104
概要
VBMan カスタム・コントロールが Btrieve を呼び出した結果、ステータスが 0 以
外の値が Btrieve から返された場合にこのイベントが発生します。
VBMan ボタンなどのオペレーション時に Btrieve からエラーが返されると、この
イベントが発生した後にはデフォルトでメッセージ・ボックスが表示されます。こ
のメッセージ・ボックスを表示したくない場合は、第 2 パラメータの値に 0 をセッ
トします。以下は Visual Basic でのコード例です。
Sub BtrieveError( TableName As String, Status As Integer )
MsgBox “Btrieve エラーです “ & CStr(Status)
Status = 0
End Sub
対象コントロール
VBMan カスタム・コントロール
Format
書式
Object_Format( LineData As String )
パラメータ
LineData
リスト･ボックス/コンボ・ボックスに表示する文字列
概要
リスト･ボックス等にデータを挿入する直前にこのイベントが発生します。
リスト･ボックス、コンボ･ボックスではこのイベントが発生した時にはパラメータと
して渡されたフィールドを含むデータのカレント･レコードが存在します。したがっ
て DbGetFieldData メソッドまたは関数を呼び出すことで、イベント・パラメータ Li
neData 以外のフィールドの値を得ることができます。
拡張リスト、拡張コンボ、グリッドでは Format イベントが発生したときには、Btrie
ve の Extended 系のオペレーションが終了しているので、カレント･レコードは最
後に取得したレコードになります。したがって、Format イベントで DbGetFieldDat
a メソッドを使っても常に同じレコードのフィールドの値が返されるので、このメソ
ッドを使う意味はありません。これらのコントロールでは DbListFields プロパティ
に複数のフィールドが指定可能でそれらの値が LineData プロパティで渡される
ので、他のフィールドを参照するのではなく、DbListFields プロパティに参照した
いフィールドを記述することになります。これは同じテーブルに関することで、他
のテーブルを参照する場合は、LineData に他のテーブルのキーとなる値が存
105
在すれば、DbAccess メソッドを使って他のテーブルの値を GET EQUAL オペレ
ーション等で参照することは可能です。
拡張リストではTabStopsプロパティを指定した場合、フィールドの間はタブ文字
20で連結されてFormatイベントに渡されます。
拡張コンボでは DbDelimitChar プロパティの値で指定した文字がフィールドの間
を連結して Format イベントに渡されます。
対象コントロール
コンボ、リスト、拡張リスト、拡張コンボ、グリッド
SetData
書式
Object_SetData()
パラメータ
無し
概要
VBMan ボタンコントロールにおいて DbOperation プロパティにデータを登録する
オペレーションがセットされている場合、ユーザーがボタンを押したときにこのイ
ベントが発生します。このイベントでは DbSetFieldData メソッド/関数を使って、
フォームのコントロールにないテーブルのフィールドにデータをセットしたり、フォ
ームのコントロールへの入力の正当性をチェックして不正であれば、メッセージ
を表示して、Abort プロパティを True にセットすれば、ボタンを押したオペレーシ
ョンを中断することもできます。イベントのタイミングはフォームにある関連するコ
ントロールのデータを VBMan データ・ベース・コントロールのレコード・イメージ
のバッファに転送した後で、Btrieve を呼び出す直前です。以下は Visual Basic
によるサンプル・コードです。
‘ ボタンの Name プロパティは InsertData となっている例です。
‘ このボタンの DbSource プロパティは VBMan1 となっています。
Sub InsertData_SetData()
If Val( ItemPrice.Text ) <= 0 Then
MsgBox “商品の値段が入力されていません”
InsertData.Abort = True
Exit Sub
End If
‘ 在庫個数を 0 にセット
20
アスキー・コード 9
106
VBMan1.DbSetFieldData(“商品”,”在庫”,”0”)
End Sub
VBMan ボタンのイベントとデータベースへのアクセスに関する順序を以下に示
します。
マウスによるボタン・クリック
確認メッセージ
データベース・コントロールの
データをファイル・バッファへ転送
Abort=True
SetDataイベント発生
Btrieveオペレーション
異常終了？
BtrieveErrorイベント発生
Clickイベント発生
対象コントロール
ボタン
107
カスタム・メソッド・リファレンス
コンパチビリティの章でも説明しましたが、VBMan Controls for Btrieve では、
従来のバージョン 1.x コンパチブル関数に加えて、VBMan データベース・コント
ロールのメソッドとして、バージョン 1.x 関数相当のメソッドがデータ・ベース・コン
トロールに追加されました。
Visual Basic 32bit 版では関数からメソッドへの変更に伴って、関数宣言は必要
なくなりましたが、メソッドのパラメータでの定数は Btrieve.bas ファイルに定義さ
れていますのでこのファイルをプロジェクトに追加してメソッドをご利用ください。
DbAbortTransaction
Object.DbAbortTransaction() As Integer
概要
トランザクションの中止を宣言します。
パラメータ
なし。
戻り値
正常ならば 0 が返されます。負の値は VBMan エラー・コード一覧を参照してく
ださい。それ以外の正の値 Btrieve のステータス・コードが返されます。
DbAccess
Object.DbAccess(BtrieveOpCode As Integer,
TableName As String,
KeyName As String) As Integer
概要
BtrieveOpCode で指定される Btrieve の機能を呼び出します。
パラメータ
BtrieveOpCode
Btrieve の機能番号を指定します。VBMan に添付される BTRIEVE.BAS ファイル
に定義されています。このメソッドで使用できる Btrieve オペレーション・コードは
108
このファイルに定義されているものに限定されます。
TableName
Btrieve オペレーションを発行するテーブルの名前を指定します。
KeyName
Btrieve オペレーションに関連するキーの名前を指定します。テーブル定義上、
同じキーの名前が存在する場合は VBMan DDF ビルダーでキーに別名を設定
してください。
戻り値
正常終了ならば 0 が返ります。負の値は VBMan エラー・コード一覧を参照して
ください。それ以外の正の値 Btrieve のステータス・コードです。
Visual Basicサンプル
Dim rc%
With VBManDb1.
rc% = .DbSetFieldData(“従業員”,”社員番号”,"066217")
rc% = .DbAccess(BTR_GET_EQUAL,”従業員”,”社員キー”)
If rc% <> 0 Then
MsgBox "Btrieveの呼び出しに失敗しました" + Str$(rc%)
Exit Sub
End If
‘読み込んだ結果をフォーム上のコントロールに転送
rc% = .DbTransferToControl(“従業員”)
End With
DbAccessByID
Object.DbAccessByID(BtrieveOpCode As Integer,
TableID As Integer,
KeyID
As Integer) As Integer
概要
BtrieveOpCode で指定される Btrieve の機能を呼び出します。テーブルとキー
は整数値の ID を指定します。ID によるテーブル、フィールドの指定は VBMan
バージョン 1.x での仕様と同様になりますので既存のバージョン 1.x コードを移
植する際に有効です。
109
パラメータ
BtrieveOpCode
Btrieve の機能番号を指定します。VBMan に添付される BTRIEVE.BAS ファイル
に定義されています。このメソッドで使用できる Btrieve オペレーション・コードは
このファイルに定義されているものに限定されます。
TableID
Btrieve オペレーションを発行するテーブル ID を指定します。
KeyID
Btrieve オペレーションに関連するキーID を指定します。キーID は DDF ビルダ
ーで定義されたキーを識別する整数値です。ゼロ・オフセットで指定します。
戻り値
正常終了ならば 0 が返ります。負の値は VBMan エラー・コード一覧を参照して
ください。それ以外の正の値 Btrieve のステータス・コードです。
サンプル・コード
Const TID_EMP = 10
Const FID_EMP_NO = 1
Const KID_EMP_NO = 0
Dim rc%
With VBManDb1.
rc% = .DbSetFieldDataByID(TID_EMP,FID_EMP_NO,"066217")
rc% = .DbAccessByID(BTR_GET_EQUAL,TID_EMP_NO,KID_EMP_NO)
If rc% <> 0 Then
MsgBox "Btrieveの呼び出しに失敗しました" + Str$(rc%)
Exit Sub
End If
End With
110
DbBeginConCurTransaction
Object.DbBeginConCurTransaction(LockBias As Integer) As Integer
概要
コンカレント・トランザクションの開始を宣言します。
パラメータ
LockBias
トランザクション・ロックを指定。値は 100,200,300,400,500 を指定可能。詳細は
Btrieve プロクラマーズ・マニュアルを参照してください。
戻り値
正常ならば 0 が返されます。負の値は VBMan エラー・コード一覧を参照してく
ださい。それ以外は Btrieve のステータス・コードが返されます。
DbBeginTransaction
Object.DbBeginTransaction(LockBias As Integer) As Integer
概要
トランザクションの開始を宣言します。
パラメータ
LockBias
トランザクション・ロックを指定。値は 100,200,300,400 を指定可能。詳細は Btrie
ve プロクラマーズ・マニュアルを参照してください。
戻り値
正常ならば 0 が返されます。負の値は VBMan エラー・コード一覧を参照してく
ださい。それ以外は Btrieve のステータス・コードが返されます。
DbClearControlData
Object.DbClearControlData(TableName As String) As Integer
概要
111
アクティブなフォームにあるコントロールのデータ 21を初期化します。Btrieveの
データ入出力に使われるメモリ・バッファは初期化されません。こちらを初期化し
たい場合は、DbClearFieldBufferメソッドを使ってください。
パラメータ
TableName
データを初期化したいコントロールが関連しているテーブル名
戻り値
正常ならば 0 が返されます。負の値は VBMan エラー・コード一覧を参照してく
ださい。それ以外は Btrieve のステータス・コードが返されます。
DbClearFieldBuffer
Object.DbClearFieldBuffer( TableName As String ) As Integer
概要
指定したテーブルのデータ・バッファを初期化します。データ・バッファは Btrieve
とのデータを交換するメモリ・エリアです。
パラメータ
TableName
テーブルの名前を指定します。
戻り値
正常ならば 0 が返されます。負の値は VBMan エラー・コード一覧を参照してく
ださい。それ以外は Btrieve のステータス・コードが返されます。
DbClose
Object.DbClose( TableName As String ) As Integer
概要
指定されるテーブルに関連する Btrieve ファイルをクローズします。このメソッド
を呼び出す以前に Btrieve ファイルはオープンされている必要があります。
21
VBMan エディットのテキスト・プロパティを空にします。
112
パラメータ
TableName
テーブルの名前を指定します。
戻り値
正常ならば 0 が返されます。負の値は VBMan エラー・コード一覧を参照してく
ださい。それ以外は Btrieve のステータス・コードが返されます。
DbCloseAll
Object.DbCloseAll() As Integer
概要
DDF に定義された Btrieve ファイルをすべてクローズします。
パラメータ
なし
戻り値
正常ならば 0 が返されます。負の値は VBMan エラー・コード一覧を参照してく
ださい。それ以外は Btrieve のステータス・コードが返されます。
DbCreate
Object.DbCreate( TableName As String ) As Integer
概要
TableName で指定されるテーブルに関連する Btrieve ファイルを生成(Create)し
ます。レコード長、インデックスの構成などは DDF の定義を参照します。このメ
ソッドを呼び出す時には関連する Btrieve ファイルはクローズされていることが
必要です。サーバーにある Btrieve ファイルをマルチ・ユーザーで使用する場合
は一つのクライアントから DbClose しても、他でオープンしていれば、このメソッ
ドは成功しません。すでに Btrieve ファイルが存在するような場合は上書きされ
ますので注意してください。生成される Btrieve ファイルのページ・サイズは 4,09
6 となります。
パラメータ
TableName
113
テーブルの名前を指定します。
戻り値
正常ならば 0 が返されます。負の値は VBMan エラー・コード一覧を参照してく
ださい。それ以外は Btrieve のステータス・コードが返されます。
Visual Basic サンプル
Dim rc As Integer
rc = VBMan1.DbClose(“月次ファイル”)
Kill “c:\data\月次.btr”
rc = VBMan1.DbCreate(“月次ファイル”)
If rc <> 0 Then
MsgBox “Btrieve create ステータス “ & CStr(rc)
Stop
End If
rc = VBMan1.DbOpen(“月次ファイル”)
If rc <> 0 Then
MsgBox “Btrieve open ステータス “ & CStr(rc)
Stop
End If
DbEndTransaction
Object.DbEndTransaction() As Integer
概要
トランザクションの終了を宣言します。
パラメータ
なし。
戻り値
正常ならば 0 が返されます。負の値は VBMan エラー・コード一覧を参照してく
ださい。それ以外は Btrieve のステータス・コードが返されます。
DbExAccess
Object.DbExAccess( OpCode As Integer,
TableName As String,
SearchCondition As String,
Fields As String,
114
IndexName As String,
SkipRecords As Integer,
MaxRecords As Integer,
IgnoreCase As Integer,
ResultID As Integer,
NumberOfResults As Integer ) As Integer
概要
Btrieve の Extended 関数を実行します。
パラメータ
TableName
テーブル名を指定します。
OpCode
Extended オペレーション・コードを指定します。指定できる値は BTRIEVE.BAS
に宣言してある以下の値です。
BTR_GET_PREVIOUS_EXTENDE 37
D
BTR_GET_NEXT_EXTENDED
36
BTR_STEP_PREVIOUS_EXTENDE 39
D
BTR_STEP_NEXT_EXTENDED
38
SearchCond
検索条件文字列を指定します。拡張リスト・ボックス、拡張コンボ・ボックスの検
索条件文字列と同じ形式で指定します。
フィールドは＠をプリフィックスとして比較式の左辺に指定します。@プリフィック
スの後にはフィールド名を記述します。バージョン 1.x とのコンパチビリティのた
めに、フィールド ID も指定できます。（例；フィールド ID の１０は＠１０と指定す
る）比較演算子は以下を指定します。
=
>
<
<>
>=
<=
等しい
より大きい
より小さい
等しくない
より大きいか等しい
より小さいか等しい
複合検索をする場合は検索条件を＆（AND)または｜(OR)で結合します。比較
115
対象を即値で指定する場合はスペースがディリミッタになります。スペースが含
まれる即値を指定する場合はシングル・クゥオート、ダブル・クゥォート、スラッシ
ュで文字列を囲みます。以下に検索文字列の例を示します。
@0 >= 100 & @1 <= 1000
@製品 = “VBMan” | @製品 = “Visual Basic”
@2 <> /Microsoft/ & @2 <> /Borland/
Fields
検索結果として抽出するフィールドを指定します。フィールド名またはフィールド I
D をカンマで区切ったものを指定します。フィールドは ID をカンマで区切った文
字列を指定します。フィールド ID は DDF ビルダーの表示値を 0 オフセットにし
た値です。（例：10,22,34)
IndexName
GET NEXT/PREVIOUS EXTENDED オペレーションを実行する際のインデック
スのパスを指定します。DbAccess 関数の第三パラメータと同じ形式で指定しま
す。カレント・レコードが確立されていない場合、GET NEXT/PREVIOUS EXTEN
DED オペレーションはエラーを返します。
SkipRecords
検索条件を満たさない場合にスキップするレコード数を指定します。
MaxRecords
検索結果の最大レコード件数を指定します。Btrieve では結果が 65,536 バイト
をこえることができません。65,535 を Fields で指定した抽出するフィールドのデ
ータ長の合計値で割った数以上は設定できません。
IgnoreCase
文字列フィールドを比較する場合、0 以外の値を指定すると英数字に関して大
文字、小文字の区別無く比較を実行します。2 バイト文字にはこのオプションは
サポートされません。
ResultID
結果 ID が整数値で返されます。結果を取得するにはこの ID を指定して DbExG
etFieldData,DbExGetPosition 関数を使用します。結果が不要になったらこの ID
で DbExFree 関数を呼び出し資源を解放します。
NumberOfResults
検索結果件数が返されます。
戻り値
116
正常ならば０が返されます。正の整数値が返された場合は Btrieve からのエラ
ー・コードです。負の整数値は VBMan エラー・コード一覧を参照してください。
また、エラー9,22,60,64,65 等が返った場合でも結果が存在する場合もあることに
注意してください。
以下にこのオペレーションで Btrieve から返されるエラー・コードを抜粋します。
03
06
07
08
09
22
60
61
62
64
65
82
FILE NOT OPEN
Invalid Key Number
Different Key Number
Invalid Position
End Of File
Data Buffer Length
Reject Count Reached
Work Space Too Small
Incorrect Descriptor
Filter Limit Reached
Incorrect Field Offset
Lost Position
注意
カレント・レコードを検索の対象から除外したい場合は DbExSetMode メソッドで
指定します。
Visual Basic サンプル
Dim rc As Integer
Dim ResultID As Integer
Dim NumOfRecords As Integer
Dim Fields As String
Dim SearchCond As String
Dim a$,I As Integer
SearchCond = “@売値 > 100 & @売値 < 200”
Fields = “コード,売値,仕切値,仕入先”
rc = DbExAccess( BTR_GET_NEXT_EXTENDED, 0, SearchCond, Fields, 0,12
7,100,0,ResultID,NumOfRecords )
If rc <> 9 & rc <> 0 & rc <> 60 Then
MsgBox “Btrieve Extended Opeartion Error “ & Str$(rc)
Stop
End If
‘ 結果をリスト・ボックスに追加
117
For I = 0 To NumOfRecords -1
a$ = DbExGetFieldData(ResultID,0,I)
a$ = a$ & “ “ & DbExGetFieldData(ResultID,1,I)
ResultListBox.AddItem a$
Next I
‘ 結果を保持するメモリを解放
rc = DbExFree(ResultID)
DbExFree
Object.DbExFree( ResultID As Integer )
概要
DbExAccess 関数によって返される結果に付随する資源を解放します。
パラメータ
ResultID
DbExAccess 関数の結果として返される結果 ID を指定します。
戻り値
なし。
注意
DbExAccess 関数の結果は検索結果件数と抽出するフィールドのサイズと件数
に比例してメモリを消費します。不要になった結果はこの関数を呼び出して解放
してください。
DbExGetFieldData
Object.DbExGetFieldData( ResultID As Integer,
FieldID As String,
Location As Integer) As String
概要
DbExAccess メソッドの結果をフィールド単位で取得します。
パラメータ
ResultID
DbExAccess メソッドの結果として返される結果 ID を指定します。
118
FieldID
フィールド名を文字列で指定します。
Location
DbExAccess は検索結果として複数のレコード・イメージを返します。Location
パラメータは所得する結果の位置を指定します。0 オフセットで結果位置を整数
で指定します。DbExAccess では検索結果件数を返しますがその値以上を指定
することはできません。
戻り値
パラメータ不正、メモリが不足して Visual Basic 文字列が作成できない場合にヌ
ル文字列を返します。正常の場合はフィールドの値を文字列で返します。
DbExGetPosition
Object.DbExGetPosition( ResultID As Integer,
Location As Integer ) As Long
概要
DbExAccess 関数の結果を物理レコード位置単位で所得します。
パラメータ
ResultID
DbExAccess 関数の結果として返される結果 ID を指定します。
Location
DbExAccess は検索結果として複数のレコード・イメージを返します。Location
パラメータは所得する結果の位置を指定します。0 オフセットで結果位置を整数
で指定します。DbExAccess では検索結果件数を返しますがその値以上を指定
することはできません。
戻り値
Btrieve の物理位置が返されます。
注意
レコードの物理位置は Btrieve で管理される値で整数のシリアルな値ではあり
ません。
DbExSetMode
Object.DbExSetMode( NewMode As String ) As Integer
119
概要
DbExAccess メソッド/関数にてカレント・レコードを検索対象とするか除外するか
を設定します。
パラメータ
NewMode
検索対象にする場合はも列”UC”をパラメータとして設定します。カレント・レコー
ドを検索対象としない場合は文字列”EG”をパラメータとして設定します。”UC”
または “EG”以外の文字列を設定した場合は、DbExAccess メソッド/関数でエラ
ーが発生します。
パラメータ値
UC
EG
動作
カレント・レコードを検索対象に含める。
カレント・レコードを検索対象から除外する。
戻り値
正常ならば 0 が返されます。負の値は VBMan エラー・コード一覧を参照してく
ださい。
DbFindPercentage
Object.DbFindPercentage(TableName As String,
KeyName As String,
PhysicalPosition As Long,
Percentage As Integer) As Integer
概要
レコード位置をパーセントで取得します。
パラメータ
TableName
テーブル名を指定します。
KeyName
インデックス名を指定します。ヌルを指定した場合は物理位置で取得します。
PhysicalPosition
パーセンテージを得る物理位置を指定します。このパラメータを有効にするため
には、KeyName にヌル文字列を設定します。
Percentage
取得する位置。たとえば、80 パーセントの位置の場合、整数値で 8000 が返りま
120
す。
戻り値
正常ならば 0 が返されます。負の値は VBMan エラー・コード一覧を参照してく
ださい。それ以外は Btrieve のステータス・コードが返されます。
03
06
07
08
09
22
41
43
82
FILE NOT OPEN
Invalid key number
Different key number
Invalid positioning
End of file
Data buffer length
Operation not allowed
Invalid data record address
Lost position
注意
Btrieve ファイルはバージョン 6.X 以降の形式でなければ使用できません。
DbGetByPercentage
Object.DbGetByPercentage(TableName As String,
KeyName As String,
Percentage As Integer) As Integer
概要
パーセント指定でレコードを取得します。
パラメータ
TableID
テーブル名を指定します。
KeyName
インデックス名を指定します。ヌル文字列を指定した場合は物理位置でレコード
を取得します。
Percentage
取得する位置をパーセントで指定します。たとえば、80 パーセントの位置の場
合、8000 を指定します。
121
戻り値
正常ならば 0 が返されます。負の値は VBMan エラー・コード一覧を参照してく
ださい。それ以外は Btrieve のステータス・コードが返されます。
03
06
07
08
09
22
41
82
FILE NOT OPEN
Invalid key number
Different key number
Invalid positioning
End of file
Data buffer length
Operation not allowed
Lost position
注意
Btrieve ファイル形はバージョン 6.x 以降であることが必要です。
DbGetDataSize
Object.DbGetDataSize(TableName As String,
FieldName As String) As Integer
概要
指定したフィールドのデータ・サイズ（バイト）を返します。
パラメータ
TableName
テーブル名を指定します。
FieldName
フィールド名を指定します。
戻り値
正常ならばフィールドのデータ・サイズが返されます。負の値は VBMan エラー・
コード一覧を参照してください。
DbGetDataType
Object.DbGetDataType( TableName As String,
FieldName As String ) As Integer
122
概要
指定したフィールドの Btrieve データ型を返します。
パラメータ
TableName
テーブル名を指定します。
FieldName
フィールド名を指定します。
戻り値
正常ならばフィールドのデータ型が返されます。負の値は VBMan エラー・コード
一覧を参照してください。
データ型
String
Integer
Float
Date
Time
Decimal
Money
Logical
Numeric
Bfloat
Lstring
Zstring
Note
Lvar
Unsinged Binary
Auto increment
Named Index
リターン値
0
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
255
DbGetDirect
Object.DbGetDirect(TableName As String,
Pos As Long,
NewIndexName As String) As Integer
123
概要
指定された物理レコード位置から、Btrive データを読み込みます。
パラメータ
TableName
テーブル名を指定します。
Pos
物理レコード位置を設定します。DbGetPosition 関数で取得する、4 バイトの整
数です。
NewIndexName
この関数によって得られたレコードの新アクセス・パスをインデックス名で指定し
ます。
戻り値
正常ならば 0 が返されます。負の値は VBMan エラー・コード一覧を参照してく
ださい。それ以外は Btrieve のステータス・コードが返されます。
DbGetFieldData
Object.DbGetFieldData(TableName As String,
FieldName As String) As String
概要
データベースのフィールドの値を指定されたテーブルのデータ・バッファから文
字列データとして返します。
パラメータ
TableName
テーブル名を指定します。
FieldName
フィールド名を指定します。
戻り値
フィールドの値が文字列で返されます。データベースのフィールドから文字列デ
ータ型への変換はこの関数内部でおこなわれます。たとえば時間型は、"hh:m
m:ss"の形で返されます。エラーが発生した場合は、ヌル文字列が返されます。
ヌル文字が返されるのは、テーブル名、フィールド名がこのメソッドの関連する D
DF 定義に存在しない場合です。
124
DbGetFieldDataByID
Object.DbGetFieldDataByID(TableID As Integer,
FieldID As Integer) As String
概要
テーブル ID,フィールド ID で指定したデータベースのフィールドの値を文字列デ
ータとして返します。
パラメータ
TableID
テーブル ID を指定します。
FieldID
フィールド ID を指定します。
戻り値
フィールドの値が文字列で返されます。データベースのフィールドから文字列デ
ータ型への変換はこの関数内部でおこなわれます。たとえば、時間型は、"hh:m
m:ss"の形で返されます。エラーが発生した場合は、ヌル文字列が返されます。
ヌル文字が返されるのは、テーブル ID、フィールド ID がこのメソッドの関連する
DDF 定義に存在しない場合です。
注意
VBMan for Btrieve/VBX バージョン 1.x でのテーブル指定、フィールド指定に
用いた整数値 ID を利用できますので、バージョン 1.x のコードを移植する際に
便利です。
また、Visual Basic 等の 32bit 言語では文字列型は UNICODE を使っており、当
メソッドのパラメータを文字列で指定する DbGetFieldData メソッドに比べて、内
部的に消費するメモリ量が少なくて済みます。内部ロジックでデータが保持され
ている領域を検索する際にも整数値での指定をする当メソッドのほうが比較す
るバイト数が少なくなりますのでパフォーマンスの向上が期待できます。
DbGetFieldName
Object.DbGetFieldName(TableName As String,
FieldID As Integer,
FieldName As String) As Integer
概要
テーブル名,フィールド ID で指定したフィールド名を返します。
125
パラメータ
TableName
テーブル名を指定します。
FieldID
フィールド ID を指定します。0 ベースで指定します。
FieldName
フィールド名が返されます
戻り値
正常ならば 0 が返されます。負の値は VBMan エラー・コード一覧を参照してく
ださい。
DbGetIndexName
Object.DbGetIndexName(TableName As String,
IndexID As Integer,
IndexName As String) As Integer
概要
インデックス ID で指定したインデックスが設定されているフィールド名を返しま
す。
パラメータ
TableName
テーブル名を指定します。
IndexID
インデックス ID を指定します。0 ベースで指定します。
IndexName
インデックスが設定されているフィールド名が返されます
戻り値
正常ならば 0 が返されます。負の値は VBMan エラー・コード一覧を参照してく
ださい。
注意
インデックス名（NamedIndex）はこのメソッドでは得ることができません。
DbGetModulePath
126
Object.DbGetModulePath( BtrieveModulePath As String ) As Integer
概要
VBMan が利用している Btrieve API モジュールへのパスを取得します。複数の
バージョンの Btrieve が同じパソコンにインストールされている場合、どのモジュ
ールを利用しているかを判別するために使います。
パラメータ
BtrieveModulePath
VBMan が利用しているモジュールへのパスとモジュール名が返されます。(例:
c:\windows\system\wbtrv32.dll）
戻り値
正常ならば 0 が返されます。VBM_ERR_GENERIC(-1)が返される場合は Btrieve
のモジュールを Win32 API でロードできない場合です。
注意
Btrieve 開発キット、Btrieve サーバーに添付されるクライアント・モジュール、VB
Man に添付される Btrieve Workstation Engine 等複数の Btrieve エンジンがイ
ンストールされていてそれぞれバージョンが異なる場合、サーバー上のファイル
でもワーク・ステーション・エンジンでオープンされるなどの現象が発生します。
そのような場合、Btrieve サーバーのバージョンとクライアント・モジュールのバ
ージョンを合致させる必要があります。当メソッドはそのような状況でのトラブ
ル・シュートのために用意されました。
DbGetNumOfField
Object.DbGetNumOfField( TableName As Stirng,
NumOfField As Integer ) As Integer
概要
指定されたテーブル定義されているフィールド数を返します。
パラメータ
TableName
テーブル名を指定します。
NumOfField
定義されているフィールドの数が返されます。
戻り値
127
正常ならば 0 が返されます。負の値は VBMan エラー・コード一覧を参照してく
ださい。
DbGetNumOfIndex
Object.DbGetNumOfIndex ( TableName As Stirng,
NumOfIndex As Integer ) As Integer
概要
指定されたテーブル定義されているインデックス数を返します。
パラメータ
TableName
テーブル名を指定します。
NumOfIndex
定義されているインデックスの数が返されます。セグメント・キーが含まれる場合
はその構成メンバーの数も加算された値が返されます。
戻り値
正常ならば 0 が返されます。負の値は VBMan エラー・コード一覧を参照してく
ださい。
DbGetNumOfRecords
Object.DbGetNumOfRecords( TableName As Stirng,
NumOfRec As Long ) As Integer
概要
指定されたテーブルに存在するレコード数を返します。
パラメータ
TableName
テーブル名を指定します。
NumOfRec
レコード数が返されます。
戻り値
正常ならば 0 が返されます。負の値は VBMan エラー・コード一覧を参照してく
128
ださい。それ以外は Btrieve のステータス・コードが返されます。この関数内部で
は Btrieve の stat オペレーションを発行します。
DbGetNumOfTable
Object.DbGetNumOfTable(NumOfTable As Integer) As Integer
概要
現在読みこんでいる DDF に存在するテーブル数を返します。
パラメータ
NumOfTable
テーブル数が返ります。
戻り値
正常ならば 0 が返されます。負の値は VBMan エラー・コード一覧を参照してく
ださい。
DbGetPosBlock
Object.DbGetPosBlock( TableName As String,
PosBlock(0 To 127) As Byte) As Integer
概要
指定されたテーブルに関連する Btrieve のポジション・ブロックを返します。
パラメータ
TableName
テーブル名を指定します。
PosBlock
Btrieve の PosBlock を保持する Byte 型の配列を指定します。配列のサイズは
Btrieve の仕様により 128 バイトを割振る必要があります。
戻り値
正常ならば 0 が返されます。負の値は VBMan エラー・コード一覧を参照してく
ださい。
注意
ポジション・ブロックは Btrieve ファイルがオープンされている時にのみ有効とな
りますのでこのメソッドを呼び出す際には Btrieve ファイルがオープンされている
129
ことが必須となります。ポジション・ブロックは Btrieve が管理する領域なので通
常のアプリケーションではデータはセットできません。このメソッドで得られるポ
ジション・ブロックを利用して Btrieve API を発行し、DDF に合致しないようなデ
ータを登録した場合は他のコントロールやメソッドでのオペレーションに障害が
出る可能性があり、弊社では動作を保証できませんので、Btrieve のデータ型、
オペレーション、プログラミングを十分理解した上でのご利用をお願いします。
DbGetPosition
Object.DbGetPosition(TableName As String) As Long
概要
指定されたテーブルの現在のレコードの物理位置を返します。
パラメータ
TableName
テーブル名を指定します。
戻り値
正常ならば物理レコード位置(4 バイト）が返されます。テーブル ID の誤り、デー
タベースがオープンされていない場合は-1 が返されます。
注意
戻り値はシリアルな値ではなく、Btrieve で管理されるユニークな値です。整数
値でレコードを識別したい場合は、AutoIncrement 型のフィールドを利用します。
DbGetRecord
Object.DbGetRecord( TableName As String, _
ArrayOfData() As String ) As Integer
概要
配列に現在のレコードの内容を取得します。大量の複数のフィールドを DbGetFi
eldData メソッドの呼び出し得る方法に比較して実行のパフォーマンス向上が期
待できます。
パラメータ
TableName
テーブル名を指定します。
130
ArrayOfData
String 型の配列を指定します。配列のインデックスはフィールド ID になります。
戻り値
正常終了の場合は０が返されます。負の値に関しては VBMan エラー・コード一
覧をご参照ください。
注意
配列のインデックスが DDF で定義されるフィールド数以内で定義してください。
フィールド ID はベースが０なのでデータを受け取る String 型の配列のベースも
０にすると最初のフィールドから順にデータを得ることができます。
サンプル・コード
Private Sub GetFirstRecord()
Dim rc As Integer, I As Integer
Dim f(0 To 20) As String
rc = Db1.DbAccess(BTR_GET_FIRST, “TEST1”, “PRIM_KEY”)
If rc <> 0 Then
MsgBox “エラー “ & CStr(rc)
Exit Sub
End If
rc = Db1.DbGetRecord( “TEST1”, f )
If rc <> 0 Then
MsgBox “エラー “ & CStr(rc)
Exit Sub
End If
For I = Lbound(f) To Ubound(f)
Debug.Print f(I), “ “;
Next I
Debug.Print ‘ 改行
End Sub
DbGetRecordImage
Object.DbGetRecordImage( TableName As String,
ByteArray() As Byte ) As Integer
131
概要
指定されたテーブルのレコード・イメージをバイト型の配列に取得します。レコー
ド・イメージとは Btrieve の GET 系のオペレーションで取得できるメモリの領域で
す。
パラメータ
TableName
テーブル名を指定します。
ByteArray
レコード・イメージを取得する Byte 型の配列を指定します。配列のローワー・バ
ウンド値に関係なく、レコード・イメージはゼロ・オフセットから設定されます。配
列のサイズを決定する際にレコード長が必要になる場合は DbGetRecordLengt
h メソッドで取得することが可能です。Delphi をホスト言語としてご利用の場合は
OleVariant 型で varByte の配列を指定してください。
戻り値
正常ならば 0 が返されます。負の値は VBMan エラー・コード一覧を参照してく
ださい。
サンプル・コード
Dim rc As Integer
Dim b(0 To 32) As Byte
Rc = VBManDb1.DbGetRecordImage(“TEST1”,b)
If rc <> 0 Then
MsgBox “エラー “ & CStr(rc)
Stop
End If
Debug.Print b(0),b(1),b(2)
DbGetRecordLength
Object.DbGetRecordLength( TableName As String,
RecLen As Integer ) As Integer
概要
指定されたテーブルに関連する Btrieve ファイルのレコード長をバイト単位で返
します。
パラメータ
132
TableName
テーブル名を指定します。
RecLen
レコード長が返される 2 バイト長の整数を指定します。
戻り値
正常ならば 0 が返されます。負の値は VBMan エラー・コード一覧を参照してく
ださい。
注意
当メソッドが呼び出される時点で DDF が読みこまれている必要があります。
DbGetTableName
Object.DbGetTableName( TableID As Integer,
TableName As String )As Integer
概要
テーブル ID を指定してテーブル名を取得します。
パラメータ
TableID
テーブル ID を指定します。０ベースの値を指定します。
TableName
テーブル名が返されます。
戻り値
正常ならば 0 が返されます。負の値は VBMan エラー・コード一覧を参照してく
ださい。
注意
当メソッドが呼び出される時点で DDF が読みこまれている必要があります。
DbIsNull
Object.DbIsNull(TableName As String,
FieldName As String ) As Boolean
概要
指定されたフィールドのヌル状態を返します。True 時にはフィールドはヌルです。
133
パラメータ
TableName
テーブル名を指定します。
FieldName
フィールド名を指定します。
戻り値
フィールドのヌル状態を返します。指定したフィールドが”not null”制約がある場
合には False を返します。
DbIsOpen
Object.DbIsOpen( TableName As String ) As Integer
概要
指定されたテーブルに関連する Btrieve ファイルのオープン状態を返します。
パラメータ
TableName
テーブル名を指定します。
戻り値
オープンしているなら値 1 が返されます。オープンしていない場合は 0 を返しま
す。負の値は VBMan エラー・コード一覧を参照してください。
DbLoadDDF
Object.DbLoadDDF() As Integer
概要
Pervasive.SQL ver 8 のセキュアーデーターベースにログインします。
パラメータ
なし
戻り値
正常ならば 0 が返されます。負の値は VBMan エラー・コード一覧を参照してく
ださい。それ以外は Btrieve のステータス・コードが返されます。
134
注意
DbLogIn
Object.DbLogIn(URI As String) As Integer
概要
Pervasive.SQL ver 8 のセキュアーデーターベースからログアウトします。
パラメータ
データベース URI を文字列で指定します。詳細は Pervasive.SQL V8 マニュア
ルをご参照ください。”btrv://localhost/mydb?pwd=hello&dbfile=test1.mkd”のよ
うな形式になります。
戻り値
正常ならば 0 が返されます。負の値は VBMan エラー・コード一覧を参照してく
ださい。それ以外は Btrieve のステータス・コードが返されます。
DbLogOut
Object.DbLogOut() As Integer
概要
Pervasive.SQL ver 8 のセキュアーデーターベースからログアウトします。
パラメータ
なし
戻り値
正常ならば 0 が返されます。負の値は VBMan エラー・コード一覧を参照してく
ださい。それ以外は Btrieve のステータス・コードが返されます。
注意
このメソッドを呼び出す前に DbLogIn メソッドでログインする必要があります。
DbOpen
135
Object.DbOpen( TableName As String ) As Integer
概要
指定されたテーブルに関連する Btrieve ファイルをオープンします。
パラメータ
TableName
テーブル名を指定します。
戻り値
正常ならば 0 が返されます。負の値は VBMan エラー・コード一覧を参照してく
ださい。それ以外は Btrieve のステータス・コードが返されます。
注意
このメソッドを呼び出す時は Btrieve ファイルはクローズしている必要があります。
オープン・モードはこのメソッドが関連している VBMan データベース・コントロー
ルの OpenMode プロパティによって指定されます。OwnerName についても同様
です。
DbOpenAll
Object.DbOpenAll() As Integer
概要
DDF に定義された Btrieve ファイルをすべてオープン状態にします。
パラメータ
なし。
戻り値
正常ならば 0 が返されます。負の値は VBMan エラー・コード一覧を参照してく
ださい。それ以外は Btrieve のステータス・コードが返されます。
注意
オープン・モードはこのメソッドが関連している VBMan データベース・コントロー
ルの OpenMode プロパティによって指定されます。OwnerName についても同様
です。DDF に定義されているファイルにすでにオープン中のものについては Op
en オペレーションは実行されません。また、メソッドはオープン中のエラーを返
すこともありません。
136
DbReset
Object.DbReset() As Integer
概要
Btrieve リセット・オペレーションを発行します。
パラメータ
なし。
注意
リセット・オペレーションはオープン中のファイルをすべてクローズするのですで
にアプリケーションでオープンしているファイルが存在する場合には注意が必要
です。リセット・オペレーションの詳細については Btrieve のマニュアルをご参照
ください。
DbSetFieldData
Object.DbSetFieldData(TableName As String,
FieldName As String,
Data As String) As Integer
概要
Btrieve データベースへ登録するフィールドのデータを指定されたテーブルのデ
ータ・バッファに設定します。
パラメータ
TableName
テーブル名を指定します。
FieldName
フィールド名を指定します。
Data
フィールドの値を文字列で指定します。文字列型データからデータベースのフィ
ールドのデータ型への変換はこの関数内部でおこなわれます。Integer 型など
のバイナリ型も文字列で指定します。Date 型は、"YY/MM/DD"または”YYYY/
MM/DD”の形で指定します。Time 型は”HH:MM:SS”の形で指定します。
戻り値
137
正常ならば 0 が返されます。負の値は VBMan エラー・コード一覧を参照してく
ださい。
サンプル
Dim rc%
rc% = DbSetFieldData(“給与”,”欠勤”,"10")
If rc%<> 0 then
' エラー処理
End If
DbSetFieldDataByID
Object.DbGetFieldDataByID(TableID As Integer, _
FieldID As Integer, _
Data As String) As Integer
概要
テーブル ID,フィールド ID で指定したデータベースのフィールドの値を文字列デ
ータとして返します。
パラメータ
TableID
テーブル ID を指定します。
FieldID
フィールド ID を指定します。
Data
フィールドの値を文字列で指定します。文字列型データからデータベースのフィ
ールドのデータ型への変換はこの関数内部でおこなわれます。Integer 型など
のバイナリ型も文字列で指定します。Date 型は、"YY/MM/DD"または”YYYY/
MM/DD”の形で指定します。Time 型は”HH:MM:SS”の形で指定します。
戻り値
正常ならば 0 が返されます。負の値は VBMan エラー・コード一覧を参照してく
ださい。
注意
VBMan for Btrieve/VBX バージョン 1.x でのテーブル指定、フィールド指定に
用いた整数値 ID を利用できますので、バージョン 1.x のコードを移植する際に
便利です。
また、Visual Basic 等の 32bit 言語では文字列型は UNICODE を使っており、当
メソッドのパラメータを文字列で指定する DbSetFieldData メソッドに比べて、内
138
部的に消費するメモリ量が少なくて済みます。内部ロジックでデータが保持され
ている領域を検索する際にも整数値での指定をする当メソッドのほうが比較す
るバイト数が少なくなりますのでパフォーマンスの向上が期待できます。
サンプル・コード
Const TID_EMPLOY = 10
Const FID_EMPLOY_AGE = 2
Dim rc%
rc% = DbSetFieldDataByID(TID_EMPLOY,FID_EMPLOY ,"34")
If rc%<> 0 then
' エラー処理
End If
DbSetFileName
Object.DbSetFileName( TableName As Stirng,
NewFileName As Stirng ) As Integer
概要
テーブルに関連する Btrieve ファイル名を指定します。DDF ビルダーによる定義
を実行時に変更します。ファイルがオープンされている状態では変更はできま
せん。
パラメータ
TableName
テーブル名を指定します。
NewFileName
Btrieve ファイル名を指定します。ドライブ、パスまで含めることができます。ドラ
イブ、パスを省略した場合は DDF が存在するディレクトリにある Btrieve ファイ
ルを扱います。
戻り値
正常ならば 0 が返されます。負の値は VBMan エラー・コード一覧を参照してく
ださい。
DbSetLockBias
Object.DbSetLockBias( BiasValue As Integer ) As Integer
139
概要
ロック・バイアス値を指定します。当メソッドで指定したロック・バイアス値はこの
メソッド呼び出し移行の DbAccess/DbGetDirect メソッドに反映されます。DbAcc
ess メソッドの第一パラメータにロック・バイアス値を毎回加算するコードを記述
する必要がなくなります。
パラメータ
BiasValue
ロック・バイアス値を指定します。以下の値が指定可能です。ロック動作の詳細
は Btrieve のマニュアル記載をご参照ください。
0
100
200
300
400
通常の状態
シングルウェイトロック
シングルノーウェイトロック
マルチウェイトロック
マルチノーウェイトロック
戻り値
正常終了の場合は０が返されます。負の値に関しては VBMan エラー・コード一
覧をご参照ください。
サンプル・コード
Dim rc As Integer
Const TableName = “商品”
Const IndexName = “商品コード”
With VBMan
rc = .DbSetLockBias(400) ‘ multi no wait lock
If rc <> 0 Then Stop
‘全レコードをロックする。
rc = .DbAccess(BTR_GET_FIRST,”商品”,”商品コード”)
Do
If rc <> 0 Then Exit Do
Rc = .DbAccess(BTR_GET_NEXT,”商品”,”商品コード”)
Loop
rc = .DbSetLockBias(0)
Debug.Print rc
‘ バイアス解除
140
rc = .DbUnlock(“商品”,-2)
Debug.Print rc
End With
‘ロック解除
DbSetRecord
Object.DbSetRecord( TableName As String, _
ArrayOfData() As String) As Integer
概要
配列設定したデータを現在レコードのバッファに設定します。大量の複数のフィ
ールドを DbSetFieldData メソッドの呼び出し得る方法に比較して実行のパフォ
ーマンス向上、コードの簡略化が期待できます。
パラメータ
TableName
テーブル名を指定します。
ArrayOfData
String 型の配列を指定します。配列のインデックスはフィールド ID になります。
戻り値
正常終了の場合は０が返されます。負の値に関しては VBMan エラー・コード一
覧をご参照ください。
注意
配列のインデックスが DDF で定義されるフィールド数以内で定義してください。
フィールド ID はベースが０なので先頭フィールドからデータをセットしたい場合
は配列のベースも０に設定します。
サンプル・コード
Private Sub InsertRecord()
Dim rc As Integer, I As Integer
Dim f(0 To 20) As String
For I = Lbound(f) To Ubound(f)
f(I) = Text(I).Text ‘ Text はコントロール配列
Next I
rc = Db1.DbSetRecord(“TEST1”,f)
141
If rc <> 0 Then
MsgBox “エラー “ & CStr(rc)
Exit Sub
End If
rc = Db1.DbAccess(BTR_INSERT, “TEST1”, “PRIM_KEY”)
If rc <> 0 Then
MsgBox “エラー “ & CStr(rc)
Exit Sub
End If
End Sub
DbSetRecordImage
Object.DbSetRecordImage(TableName As String, _
ByteArray() As Byte) As Integer
概要
Btrieve のレコード・イメージを Byte 型の配列で設定します。
パラメータ
TableName
レコード・イメージを設定する対象となるテーブル名を文字列で指定します。
ByteArray
設定するレコード・イメージ・データを保持する Byte 型の配列を指定します。配
列は 0 ベースでなくても配列のローワー・バウンドからゼロ・オフセットでレコー
ド・イメージの内部データ・バッファに設定されます。Delphi の場合は OleVariant
型で varByte 型の配列を指定します。
戻り値
正常ならば 0 が返されます。負の値は VBMan エラー・コード一覧を参照してく
ださい。
注意
レコード・イメージは DDF で定義された Btrieve データ型に従って１バイトアライ
メントで保持されています。Btrieve データ型については Btrieve のマニュアル等
を参照してください。レコード・イメージ・データを保持する配列の上限を設定す
るにはレコード長が必要になる場合がありますが、レコード長は DbGetRecordL
ength メソッドにて取得することが可能です。
142
サンプル・コード
Dim rc As Integer
Dim length As Integer
Dim b(0 To 30) As Byte
b(0) = 33
b(1) = 34
b(2) = 35
rc = VBManDb1.DbSetRecordImage("TEST1", b)
Debug.Print rc, b(0), b(1), b(2)
DbTransferFromControl
Object.DbTransferFromControl(TableName As String) As Integer
概要
現在のフォームにあるデータベース・コントロールのデータを Btrieve とのデータ
入出力バッファに転送します。
パラメータ
TableName
テーブル名を指定します。
戻り値
正常ならば 0 が返されます。負の値は VBMan エラー・コード一覧を参照してく
ださい。それ以外は Btrieve のステータス・コードが返されます。
注意
データ転送の対象となるコントロールは、エディット、コンボボックス、リスト、オプ
ション・ボタン、チェック・ボックスです。
DbTransferToControl
Object.DbTransferToControl(TableName As String) As Integer
概要
現在のレコードをフォームにある VBMan コントロール の該当フィールドに転送
します。
パラメータ
143
TableName
テーブルの ID を整数値で指定します。
戻り値
正常ならば 0 が返されます。負の値は VBMan エラー・コード一覧を参照してく
ださい。それ以外は Btrieve のステータス・コードが返されます。
注意
データ転送の対象となるコントロールは、エディット、コンボボックス、リスト、オプ
ション・ボタン、チェック・ボックスです。
DbUnlock
Object.DbUnlock(TableName As String,
UnlockType As Integer) As Integer
概要
指定されたテーブルのレコード・ロックを解除します。
パラメータ
TabldName
テーブル名を指定します。
UnlockType
以下の値が有効です。
アンロックタイプ
0
-1
-2
詳細
シングル・レコード・ロックを解除する
マルチ・レコード・ロックされている現在のレコードのみ
ロックを解除する。
マルチ・レコード・ロックのすべてを解除
戻り値
正常ならば 0 が返されます。テーブル ID の誤り、データベースがオープンされ
ていない場合は-1 が返されます。
144
バージョン 1.X データ・アクセス関数
この章は、VBMan for Btrieve/VBX バージョン 1.x アプリケーションを VBMan
Controls for Btrieve への移行を容易にするために提供されるバージョン 1.x デ
ータ・アクセス関数についてのリファレンスです。
これらの関数の宣言はインストールディレクトリの下の samples ディレクトリにあ
るファイル VBManV1.BAS に用意されています。Btrieve の仕様に依存している
部分が多いため、詳細は Btrieve プログラマーズ・マニュアルを参照してくださ
い。
関数名
DbAbortTransaction
DbAccess
DbAttachControl
DbBeginTransaction
DbClearControlData
DbClearFieldBuffer
DbEndTransaction
DbFindPercentage
DbGetByPercentage
DbGetDataSize
DbGetDataType
DbGetDirect
DbGetFieldData
DbGetFieldName
DbGetPosition
DbGetVersion
DbSetFieldData
DbSetFormattedString
DbTransferFromControl
DbTransferToControl
概要
トランザクションの中止
Btrieve機能の呼び出し
バージョン1.xコンパチブル関数が参照するVBMa
nデータベース・コントロールを設定します。バージ
ョン1.xコンパチブル関数の中で一番最初に実行
すべき関数です。
トランザクションを開始
データベース・フィールド・コントロールのデーター
を空にする。
データベースのバッファを初期化
トランザクションを終了
現在のレコード位置をパーセントで得る。
パーセント指定でレコードを取得する。
データ・サイズを得る
データ型を得る
物理位置を指定して、レコードを得る。
フィールドのデータをデータベースのバッファから
得る
フィールド名を得る。
現在レコードの物理位置を得る。
現在使用中のBtrieveのバージョンを得る。
フィールドのデータをデータベースのバッファにセ
ット
リスト・ボックス、コンボ・ボックスにフォーマットさ
れた文字列を設定
データベース・フィールドの入力値をBtrieveのレコ
ードに転送する。
Btrieveのデータ・バッファの内容をデータベース・
フィールド・コントロールに転送する。
145
DbUnlock
レコード・ロックの解除
以下は Btrieve の Extended オペレーションに対応したデータベース・アクセス
関数です。
関数名
概要
DbExAccess
ExtendedBtrieve オペレーションの実行
DbExGetFieldData
DbExAccess 関数による検索結果をフィールド単
位で取得する。
DbExGetPosition
DbExAccess 関数による検索結果の物理レコー
ド位置を取得する。
DbExFree
DbExAccess 関数の結果を解放する。
DbExSetFormattedString
拡 張 リ ス ト・ ボ ッ クス 、 拡 張 コンボ・ボックスの
Format イベント内で整形された文字列を設定す
る。
146
DbAbortTransaction
DbAbortTransaction() As Integer
概要
トランザクションの中止を宣言します。
パラメータ
なし。
戻り値
正常ならば 0 が返されます。負の値は VBMan エラー・コード一覧を参照してく
ださい。それ以外は Btrieve のエラー・コードが返されます。
147
DbAccess
DbAccess(BtrieveOpCode As Integer,
TableID As Integer,
KeyID As Integer) As Integer
概要
BtrieveOpCode で指定される Btrieve の機能を呼び出します。
パラメータ
BtrieveOpCode
Btrieve のオペレーション・コードを指定します。詳細は Btrieve プログラマーズ・
マニュアルを参照。VBMan に添付される BTRIEVE.BAS ファイルにも定義されて
います。
TableID
テーブルの ID を整数値で指定します。データベース・コントロールの DbTableID
プロパティに設定する値を指定します。
KeyID
Btrieve オペレーションに関連するキーの ID を指定します。ID は VBMan 日本
語 DDF ビルダーで指定した値から１を引いたものを指定します。Btrieve ではセ
グメント・キーがある場合はキーの ID がシリアルではなくなりますが、VBMan で
は日本語 DDF ビルダーで決定されるシリアルな値を指定します。
戻り値
正常終了ならば 0 が返ります。負の値は VBMan エラー・コード一覧を参照して
ください。それ以外は Btrieve のステータス・コードです。
サンプル
Dim rc%
Const EMP_TABLE = 10
Const EMP_ID = 0
Const EMP_PRIMARY = 0
rc% = DbSetFieldData(EMP_TABLE,EMP_ID,"066217")
rc% = DbAccess(BTR_GET_EQUAL,EMP_TABLE,EMP_PRIMARY)
If rc% <> 0 Then
MsgBox "Btrieveの呼び出しに失敗しました" + Str$(rc%)
Exit Sub
End If
‘読み込んだ結果をフォーム上のコントロールに転送
148
rc% = DbTransferToControl(EMP_TABLE)
149
DbAttachControl
DbAttachControl( ControlName As String,
FormName As String ) As Integer
概要
バージョン 1.x コンパチブル関数を使用可能な状態にします。
パラメータ
ControlName
この関数呼び出しが成功した以降に呼び出すバージョン 1.x コンパチブル関数
が参照する DDF ディレクトリが設定されている VBMan データベース・コントロー
ルの Name プロパティの値を設定します。
FormName
上で説明した VBMan データベース・コントロールがおいてあるフォームの名前
を指定します。
戻り値
正常終了の場合０を返します。負の値は VBMan エラー・コード一覧を参照してく
ださい。
注意
当関数の呼び出し正常終了後、VBMan データベース・コントロールがおいてあ
るフォームをアンロードした場合、それ以降のバージョン 1.x コンパチブル関数
の呼び出しは動作が保証できません。この関数で指定した VBMan データベー
ス・コントロールがアンロードされた以降にバージョン 1.x コンパチブル関数を使
う場合は、再度この関数を呼び出して別の現在参照可能な VBMan データベー
ス・コントロールを指定してください。
150
DbBeginTransaction
DbBeginTransaction(LockBias As Integer) As Integer
概要
トランザクションの開始を宣言します。
パラメータ
LockBias
トランザクション・ロックを指定。値は 100,200,300,400 を指定可能。詳細は Btrie
ve プロクラマーズ・マニュアルを参照してください。
戻り値
正常ならば 0 が返されます。負の値は VBMan エラー・コード一覧を参照してく
ださい。それ以外は Btrieve のエラー・コードが返されます。
注意
トランザクションを開始したら Btrieve ファイルをクローズする前にトランザクショ
ンの終了または中断を実行してください。
151
DbClearControlData
DbClearControlData(TableID As Integer) As Integer
概要
アクティブなフォームにあるコントロールのデータ 22を初期化します。Btrieveデ
ータ入出力に使われるバッファは初期化されません。
パラメータ
TableID
データを初期化したいコントロールが関連しているテーブルの ID
戻り値
正常ならば 0 が返されます。負の値は VBMan エラー・コード一覧を参照してく
ださい。
コンパチビリティ
バージョン 1.x からはパラメータとして TableID の指定が追加されました。
22
VBMan エディットのテキスト・プロパティを空にします。
152
DbClearFieldBuffer
DbClearFieldBuffer( TableID As Integer ) As Integer
概要
指定したテーブルのデータ・バッファを初期化します。
パラメータ
TableID
テーブルの ID を整数値で指定します。データベース・コントロールの DbTable プ
ロパティに設定する値を指定します。
戻り値
正常ならば 0 が返されます。負の値は VBMan エラー・コード一覧を参照してく
ださい。
153
DbEndTransaction
DbEndTransaction() As Integer
概要
トランザクションの終了を宣言します。
パラメータ
なし。
戻り値
正常ならば 0 が返されます。負の値は VBMan エラー・コード一覧を参照してく
ださい。それ以外は Btrieve のエラー・コードが返されます。
154
DbExAccess
DbExAccess( OpCode As Integer,
TableID As Integer,
SearchCondtion As String,
Fields As String,
IndexID As Integer,
SkipRecords As Integer,
MaxRecords As Integer,
IgnoreCase As Integer,
ResultID As Integer,
NumberOfResults As Integer ) As Integer
概要
Btrieve の Extended 関数を実行します。
パラメータ
TableID
テーブルの ID を整数値で指定します。
OpCode
Extended オペレーション・コードを指定します。指定できる値は BTRIEVE.BAS
または VBManV1.BAS に宣言してある以下の値です。
BTR_GET_PREVIOUS_EXTENDE 37
D
BTR_GET_NEXT_EXTENDED
36
BTR_STEP_PREVIOUS_EXTENDE 39
D
BTR_STEP_NEXT_EXTENDED
38
SearchCond
検索条件文字列を指定します。拡張リスト・ボックス、拡張コンボ・ボックスの検
索条件文字列と同じ形式で指定します。
フィールドは@をプリフィックスと比較式の左辺に指定します。（例；フィールド ID
の 10 は@10 と指定する）比較演算子は以下を指定します。
=
>
<
等しい
より大きい
より小さい
155
<>
>=
<=
等しくない
より大きいか等しい
より小さいか等しい
複合検索をする場合は検索条件を＆（AND)または｜(OR)で結合します。比較
対象を即値で指定する場合はスペースがディリミッタになります。スペースが含
まれる即値を指定する場合はシングル・クゥオート、ダブル・クゥォート、スラッシ
ュで文字列を囲みます。以下に検索文字列の例を示します。
@0 >= 100 & @1 <= 1000
@1 = “VBMan” | @1 = “Visual Basic”
@2 <> /Microsoft/ & @2 <> /Borland/
Fields
検索結果として抽出するフィールドを指定します。フィールドは ID をカンマで区
切った文字列を指定します。フィールド ID は DDF ビルダーの表示値を 0 オフセ
ットにした値です。（例：10,22,34)
IndexID
GET NEXT/PREVIOUS EXTENDED オペレーションを実行する際のインデック
スのパスを指定します。DbAccess 関数の第三パラメータと同じ形式で指定しま
す。カレント・レコードが確立されていない場合、GET NEXT/PREVIOUS EXTEN
DED オペレーションはエラーを返します。
SkipRecords
検索条件を満たさない場合にスキップするレコード数を指定します。
MaxRecords
検索結果の最大レコード件数を指定します。Btrieve では結果が 65,536 バイト
をこえることができません。65,535 を Fields で指定した抽出するフィールドのデ
ータ長の合計値で割った数以上は設定できません。
IgnoreCase
文字列フィールドを比較する場合、0 以外の値を指定すると英数字に関して大
文字、小文字の区別無く比較を実行します。2 バイト文字にはこのオプションは
サポートされません。
ResultID
結果 ID が整数値で返されます。結果を取得するにはこの ID を指定して DbExG
etFieldData,DbExGetPosition 関数を使用します。結果が不要になったらこの ID
で DbExFree 関数を呼び出し資源を解放します。
156
NumberOfResults
検索結果件数が返されます。
戻り値
正常ならば０が返されます。負の値は VBMan エラー・コード一覧を参照してくだ
さい。これらのプログラミング・レベルのエラーは関数内部からメッセージ・ボック
スで詳細が表示されます。整数値が返された場合は Btrieve からのエラー・コー
ドです。また、エラー9,22,60,64,65 等が返った場合でも結果が存在する場合もあ
ることに注意してください。
以下にこのオペレーションで Btrieve から返されるエラー・コードを抜粋します。
03
06
07
08
09
22
60
61
62
64
65
82
FILE NOT OPEN
Invalid Key Number
Different Key Number
Invalid Position
End Of File
Data Buffer Length
Reject Count Reached
Work Space Too Small
Incorrect Descriptor
Filter Limit Reached
Incorrect Field Offset
Lost Position
注意
Btrieve ファイル形式は 6.x/7.x を使用してください。
サンプル
Dim rc As Integer
Dim ResultID As Integer
Dim NumOfRecords As Integer
Dim Fields As String
Dim SearchCond As String
Dim a$,I As Integer
SearchCond = “@1 > 100 & @1 < 200”
Fields = “0,1,2,3”
rc = DbExAccess( BTR_GET_NEXT_EXTENDED, _
0, _
SearchCond, _
157
Fields, _
0, _
127, _
100, _
0, _
ResultID, _
NumOfRecords )
If rc <> 9 & rc <> 0 & rc <> 60 Then
MsgBox “Btrieve Extended Opeartion Error “ & Str$(rc)
Stop
End If
‘ 結果をリスト・ボックスに表示
For I = 0 To NumOfRecords -1
a$ = DbExGetFieldData(ResultID,0,I)
a$ = a$ & “ “ & DbExGetFieldData(ResultID,1,I)
ResultListBox.AddItem a$
Next I
‘ 結果を保持するメモリを解放
rc = DbExFree(ResultID)
158
DbExFree
DbExFree( ResultID As Integer ) As Integer
概要
DbExAccess 関数によって返される結果に付随する資源を解放します。
パラメータ
ResultID
DbExAccess 関数の結果として返される結果 ID を指定します。
戻り値
ResultID が不正の場合に-1 が返されます。正常に資源を解放できた場合は 0
を返します。
注意
DbExAccess 関数の結果は検索結果件数と抽出するフィールドのサイズと件数
に比例してメモリを消費します。不要になった結果はこの関数を呼び出してかな
らず解放してください。
159
DbExGetFieldData
DbExGetFieldData( ResultID As Integer,
FieldID As Integer,
Location As Integer) As String
概要
DbExAccess 関数の結果をフィールド単位で取得します。
パラメータ
ResultID
DbExAccess 関数の結果として返される結果 ID を指定します。
FieldID
フィールドの値を整数値で指定します。データベース・コントロールの DbFieldID
プロパティに設定する値を指定します。VBMan DDF ビルダーで表示されるのフ
ィールド ID を 0 オフセットした値です。
Location
DbExAccess は検索結果として複数のレコード・イメージを返します。Location
パラメータは所得する結果の位置を指定します。0 オフセットで結果位置を整数
で指定します。DbExAccess では検索結果件数を返しますがその値以上を指定
することはできません。
戻り値
パラメータ不正、メモリが不足して Visual Basic 文字列が作成できない場合にヌ
ル文字列を返します。正常の場合はフィールドの値を文字列で返します。
160
DbExGetPosition
DbExGetPosition( ResultID As Integer,
Location As Integer ) As Long
概要
DbExAccess 関数の結果を物理レコード位置単位で所得します。
パラメータ
ResultID
DbExAccess 関数の結果として返される結果 ID を指定します。
Location
DbExAccess は検索結果として複数のレコード・イメージを返します。Location
パラメータは所得する結果の位置を指定します。0 オフセットで結果位置を整数
で指定します。DbExAccess では検索結果件数を返しますがその値以上を指定
することはできません。
戻り値
Btrieve の物理位置が返されます。
注意
レコードの物理位置は Btrieve で管理される値で整数のシリアルな値ではあり
ません。
161
DbExSetFormattedString
DbExSetFormattedString( FldData As String ) As Integer
概要
拡張リスト・ボックス・コントロール、拡張コンボ・ボックス・コントロールの Format
イベント内で整形された文字列を設定します。
パラメータ
FldData
拡張リスト・ボックス・コントロール、拡張コンボ・ボックス・コントロールに挿入す
る文字列を指定します。最大長 2,048 バイトまでの文字列を指定できます。
戻り値
正常ならば 0 が返ります。設定する文字列の長さが 2,048 バイト以上の場合
は-1 が返されます。
サンプル
以下はリスト・ボックスの Format イベントのサンプルです。Format イベントには
DbTabStops プロパティを設定した場合、複数の項目データがタブ文字で区切ら
れて渡されてきます。以下の例ではその先頭の項目だけをリスト・ボックスに表
示する例です。
Sub VBManExListBox1_Format( FldData As String )
Dim rc As Integer, Formatted$ As String
Dim Pos As Integer
Pos = Instr( FldData, chr$(9) )
If Pos > 0 Then
Formatted$ = Left$(FldData,Pos - 1 )
rc = DbSetFormattedString( Formatted$ )
End If
End Sub
162
DbFindPercentage
DbFindPercentage(TableID As Integer,
KeyNo As Integer,
PhysicalPosition As Long,
Percentage As Integer) As Integer
概要
レコード位置をパーセント指定で取得します。
パラメータ
TableID
テーブルの ID を整数値で指定します。
KeyNo
キー番号を指定します。-1 を指定した場合は物理位置で取得します。
PhysicalPosition
パーセンテージを得る物理位置を指定します。このパラメータを有効にするため
には、KeyNo を-1 に設定します。
Percentage
取得する位置。たとえば、80 パーセントの位置の場合、整数値で 8000 が返りま
す。
戻り値
正常ならば 0 が返されます。負の値は VBMan エラー・コード一覧を参照してく
ださい。エラーの場合は Btrieve のステータス・コードがそのまま返されます。
03
06
07
08
09
22
41
43
82
FILE NOT OPEN
Invalid key number
Different key number
Invalid positioning
End of file
Data buffer length
Operation not allowed
Invalid data record address
Lost position
注意
Btrieve ファイルはバージョン 6.X 以降の形式でなければ使用できません。
163
DbGetByPercentage
DbGetByPercentage( TableID As Integer,
KeyNo As Integer,
Percentage As Integer) As Integer
概要
パーセント指定でレコードを取得します。
パラメータ
TableID
テーブルの ID を整数値で指定します。
KeyNo
キー番号を指定します。-1 を指定した場合は物理位置でレコードを取得します。
Percentage
取得する位置をパーセントで指定します。たとえば、80 パーセントの位置の場
合、8000 を指定します。
戻り値
正常ならば 0 が返されます。負の値は VBMan エラー・コード一覧を参照してく
ださい。それ以外の値は Btrieve のステータス・コードがそのまま返されます。
03
06
07
08
09
22
41
82
FILE NOT OPEN
Invalid key number
Different key number
Invalid positioning
End of file
Data buffer length
Operation not allowed
Lost position
注意
Btrieve ファイルの形式はバージョン 6.x 以降であることが必要です。詳細は Btr
ieve Programmer's Manual を参照してください。
164
DbGetDataSize
DbGetDataSize(TableID As Integer,
FieldID As Integer) As Integer
概要
指定したフィールドのデータ・サイズ（バイト）を返します。
パラメータ
TableID
テーブルの ID を整数値で指定します。
FieldID
フィールドの ID を整数値で指定します。
戻り値
正常ならば指定されたフィールドのデータ・サイズが返されます。負の値は VBM
an エラー・コード一覧を参照してください。
注意
なし。
165
DbGetDataType
DbGetDataType(TableID As Integer,
FieldID As Integer) As Integer
概要
指定したフィールドのデータ型を返します。
パラメータ
TableID
テーブルの ID を整数値で指定します。
FieldID
フィールドの ID を整数値で指定します。
戻り値
正常ならば DDF で定義されるデータ型の ID が返されます。負の値は VBMan
エラー・コード一覧を参照してください。
データ型
String
Integer
Float
Date
Time
Decimal
Money
Logical
Numeric
BFloat
LString
ZString
Note
LVar
Unsigned Binary
Auto increment
Named Index
データ型 ID
0
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
255
注意
なし。
166
DbGetDirect
DbGetDirect(TableID As Integer,
Pos As Long,
NewIndex As Integer) As Integer
概要
指定された物理レコード位置から、レコードを読み込みます。コントロールに入
力されたデータを Btrieve のレコードに転送します。
パラメータ
TableID
テーブルの ID を整数値で指定します。
Pos
物理レコード位置を設定します。DbGetPosition 関数で取得する、4 バイトの整
数です。
NewIndex
この関数によって得られたレコードの新アクセス・パスをインデックス番号で指
定します。
戻り値
正常ならば 0 が返されます。負の値は VBMan エラー・コード一覧を参照してく
ださい。それ以外は Btrieve のエラー・コードが返されます。
167
DbGetFieldData
DbGetFieldData(TableID As Integer,
FieldID As Integer) As String
概要
データベースのフィールドの値を指定されたテーブルのデータ・バッファから文
字列データとして取得します。すべての Btrieve データ型は文字列型として返さ
れます。バイナリ・データとして取得する場合は DbGetImage メソッドを使います。
パラメータ
TableID
テーブルの ID を整数値で指定します。データベース・コントロールの DbTableID
プロパティに設定する値を指定します。
FieldID
フィールドの ID を整数値で指定します。データベース・コントロールの DbFieldID
プロパティに設定する値を指定します。
戻り値
フィールドの値が文字列で返されます。データベースのフィールドから文字列デ
ータ型への変換はこの関数内部でおこなわれます。したがって、時間型などは、
"hh:mm:ss"の形で返されます。エラーが発生した場合は、ヌル文字列が返され
ます。
テーブル ID,フィールド ID の範囲が正しくない場合はこの関数内部からメッセー
ジ・ボックスで通知されます。
サンプル
Dim rc%,EmpNo$
Const EMP_TABLE = 10
Const EMP_ID = 0
EmpNo$ = DbGetFieldData(EMP_TABLE,EMP_ID)
168
DbGetFieldName
DbGetFieldName(TableID As Integer,
FieldID As Integer) As String
概要
指定したフィールド ID に対応する DDF 定義のフィールド名を返します。
パラメータ
TableID
テーブルの ID を整数値で指定します。
FieldID
フィールドの ID を整数値で指定します。
戻り値
正常ならばフィールド名が返されます。テーブル ID,フィールド ID が不正の場合
はヌル文字列が返ります。
169
DbGetPosition
DbGetPosition(TableID As Integer) As Long
概要
指定されたテーブルの現在のレコードの物理位置を返します。
パラメータ
TableID
テーブルの ID を整数値で指定します。
戻り値
正常ならば物理レコード位置が返されます。テーブル ID の誤り、データベース
がオープンされていない場合は-1 が返されます。
注意
戻り値はシリアルな値ではなく、Btrieve が管理するユニークな 4 バイトの整数
値です。
170
DbGetVersion
DbGetVersion(Version As BtrieveVersion) As Integer
概要
現在使用中の Btrieve のバージョン情報を取得します。
パラメータ
Version
Btrieve バージョンの構造体。VBMANV1.BAS に宣言があります。
Type BtrieveVersion
MajorVersion As Integer
MinorVersion As Integer
BtrieveType As String * 1
End Type
たとえば、Btrieve for Windows バージョン 5.10a の WBTRCALL.DLL では Majo
rVersion=5, MinorVersion=1, BtrieveType="W" となります。詳細は Btrieve プ
ログラマーズ・マニュアルの GET VERSION オペレーションを参照してください。
戻り値
正常ならば 0 が返されます。負の値は VBMan エラー・コード一覧を参照してく
ださい。それ以外の値は Btrieve のステータス・コードがそのまま返されます。
注意
返される値は VBMan のバージョンではないことに注意してください。
171
DbSetFieldData
DbSetFieldData(TableID As Integer,
FieldID As Integer,
Data As String) As Integer
概要
データベースへ登録するフィールドのデータを指定されたテーブルのデータ・バ
ッファに設定します。
パラメータ
TableID
テーブルの ID を整数値で指定します。データベース・コントロールの DbTableID
プロパティに設定する値を指定します。
FieldID
フィールドの ID を整数値で指定します。データベース・コントロールの DbFieldID
プロパティに設定する値を指定します。
Data
フィールドの値を文字列で指定します。文字列からデータベースのフィールドの
データ型への変換はこの関数内部でおこなわれます。したがって、日付け型な
どは、"YYYY/MM/DD"などの形で指定します。
戻り値
正常ならば 0 が返ります。負の値は VBMan エラー・コード一覧を参照してくださ
い。
サンプル
Dim rc%
Const EMP_TABLE = 10
Const EMP_ID = 0
rc% = DbSetFieldData(EMP_TABLE,EMP_ID,"100")
If rc%<> 0 then Stop ' error process
172
DbSetFormattedString
DbSetFormattedString(Formatted As String) As Integer
概要
リスト・ボックス、コンボ・ボックスのフォーマット・イベント・プロシージャで使用し
ます。フォーマット・イベント発生時にはリスト・ボックスに挿入されるレコード・セ
ットが DbGetFieldData 関数を通じて使用可能となります。プロパティで指定した
カラムのデータだけでは不十分な場合、それらの形式を整えた文字列をこの関
数で指定します。
パラメータ
Formatted
フォーマットした文字列。
戻り値
正常ならば 0 が返されます。負の値は VBMan エラー・コード一覧を参照してく
ださい。
注意
フォーマット・イベント・プロシージャの中でのみ使用してください。それ以外の使
用は結果を保証できません。ヌル文字列が指定された場合にはリスト・ボックス
またはコンボ・ボックスへの挿入をおこないません。
サンプル
Sub VBManListBox1_Format( FieldData As String )
Dim fmt$,rc As Integer
If Val(FieldData) < 100 Then
fmt$ = FieldData & “ “ & DbGetFieldData(0,1)
rc = DbSetFormattedString(fmt$)
Else
VBManListBox1.Abort = True
End If
End Sub
173
DbTransferFromControl
DbTransferFromControl(TableID As Integer) As Integer
概要
現在のフォームにあるデータベース・コントロールのデータを Btrieve の入出力
バッファに転送します。
パラメータ
TableID
テーブルの ID を整数値で指定します。
戻り値
正常ならば 0 が返されます。負の値は VBMan エラー・コード一覧を参照してく
ださい。
注意
データ転送の対象となるコントロールは、エディット、コンボボックス、リスト、オプ
ション・ボタン、チェック・ボックスです。
174
DbTransferToControl
DbTransferToControl(TableID As Integer) As Integer
概要
現在のレコードをフォームにあるデータベース・コントロールのデータとして転送
します。
パラメータ
TableID
テーブルの ID を整数値で指定します。
戻り値
正常ならば 0 が返されます。テーブル ID の誤り、データベースがオープンされ
ていない場合は-1 が返されます。フォームがアクティブでない場合は-2 を返し
ます。
注意
データ転送の対象となるコントロールは、エディット、コンボボックス、リスト、オプ
ション・ボタン、チェック・ボックスです。
175
DbUnlock
DbUnlock(TableID As Integer,UnlockType As Integer) As Integer
概要
指定されたテーブルのレコード・ロックを解除します。
パラメータ
TabldID
テーブルの ID を整数値で指定します。
UnlockType
以下の値を指定してください。
UNLOCKTYP 詳細
E
0
シングル・レコード・ロックを解除する
-1
マルチ・レコード・ロックされているBtrieveファイルの現在のレコ
ードのみロックを解除する。
-2
マルチ・レコード・ロックのすべてを解除
戻り値
正常ならば 0 が返されます。負の値は VBMan エラー・コード一覧を参照してく
ださい。
注意
なし。
176
作成したアプリケーションの配布
VBMan Controls for Btrieve では、DDF ディレクトリがカスタム・コントロールの
DDFDir プロパティに設定されます。このプロパティには通常ドライブとパス名が
記述されることが多く、作成したアプリケーションを配布する場合は動作環境に
おいて DDF が置かれるパスを DDFDir プロパティで指定される値以外に変更す
る必要が生じると思われます。この章では、DDFDir プロパティを実行時に、VB
MAN.INI ファイルから指定する方法を解説します。
DistName プロパティと VBMan.INI ファイル
VBMan データベース・コントロールには DistName プロパティがあります。このプ
ロパティには VBMan.INI ファイルの中に DDF へのパスが記述してあるセクショ
ン名を指定できます。アプリケーションの名前や EXE ファイルの名前などシステ
ムでユニークに識別できる値を設定します。VBMAN.INI ファイルの DistName プ
ロパティで指定されるセクションの中には VBMan データベース・コントロールの
Name プロパティの値に置換する DDF ディレクトリを記述します。以下は VBMA
N.INI ファイルのサンプルです。
[StockControlApp]
ItemDb = c:\StockSys\DDF
Tranaction = c:\StockSys\DDF
[SalesReport]
SalesTrn = z:\Sales\DDF
SalesPerson = z:\Sales\DDF
SalesTmp = z:\Sales\Tmp
上の例では、StockControlApp には２つの VBMan データベース・コントロール
があり Name プロパティはそれぞれ ItemDb,Transaction が設定されています。
配布時には c:\StockSys\DDF というディレクトリを DDF ディレクトリとして参照し
ます。
[SalesReport]には３つの VBMan データベース・コントロールがあり、Name プロ
パティはそれぞれ SalesTrn,SalesPerson,SalesTmp です。参照する DDF ディレ
クトリは最初の２つが z:\Sales\DDF で SalesTmp という名前のコントロールは z:
\Sales\Tmp ディレクトリから DDF を読み込みます。
以上からわかるように、複数の環境でDDFの存在するドライブ、パスが変更され
る可能性のあるアプリケーションを作成する場合は、DistNameプロパティを設定
することが必須で参照するDDFのディレクトリが異なる場合はVBManデータベー
ス・コントロールのNameプロパティの値をシステムでユニークにすることが必要
177
です。この場合のシステムとはVisual Basicでは１つのプロジェクトになります。
23
プロファイルへの書き込み
VBMan.INI ファイルへの書き込み方法としては、単にテキスト・エディターで編集
する方法もありますが、インストーラーを作成する場合は WritePrivateProfileStri
ng という Windows API を使うのが一般的です。Visual Basic 4.0 では SaveSett
ins ステートメントが用意されていますが、32bit 環境ではレジストリに登録される
ため Windows API を直接呼び出すことが必要です。以下は Visual Basic 4.0 3
2bit でのプロファイルへの書き込みの例です。
‘ モジュール・ファイルで宣言してください。
Declare Function WritePrivateProfileString Lib "kernel32" _
Alias "WritePrivateProfileStringA" _
(ByVal lpApplicationName As String, _
ByVal lpKeyName As Any, _
ByVal lpString As Any, _
ByVal lpFileName As String) As Long
‘以下は書き込みサンプル
Dim rc As Long
Dim DDFDir As String
DDFDir = “C:\StockSys\DDF”
rc = WritePrivateProfileString( “StockControlApp”, _
“ItemDB”, _
DDFDir, _
“vbman.ini” )
この結果 VBMAN.INI ファイルは以下になります。
[StockControlApp]
ItemDB = c:\StockSys\DDF
注意
VBMan データベース・コントロールは DistName プロパティが設定されかつ、実
行時であれば、DDFDir プロパティに入れ替えのために VBMan.INI ファイルを参
照します。VBMan.INI ファイルに VBMan データベース・コントロールの Name プ
ロパティと同じエントリがあれば、必ず DDFDir プロパティの値は置換されてしま
います。デバッグ中などこの DistName プロパティを指定している場合はどちら
23
EXE ファイル単位。
178
の DDF が参照されているか、注意してデバッグしてください。
179
DDF ビルダー・リファレンス
Btrieve 6.15 等 DDF 編集環境をお持ちでないお客様用に当製品には VBMan D
DF ビルダーが添付されています。Pervasive.SQL 2000i をお使いのお客様は Per
vasive Control Center でデータベースの定義、データの入力と共に DDF の編集
が可能になっておりますので、Control Center をお使いください。VBMan DDF ビ
ルダーは Btrieve 6.1X 当時に定義されていた Btrieve データ型のみサポートとな
ります。
DDF ビルダーの起動
VBMan メニューから DDF ビルダーを選択します。以下のような初期画面が表示さ
れます。メニューは初期状態になります。
新規 DDF の作成
DDF ビルダー起動後の「ファイル」メニューの下の「新規 DDF の作成」メニューを
180
選択します。以下のウィンドウが表示されますから、新規に DDF を作成するディレ
クトリを指定し「開く」ボタンを押します。以下のテーブル情報入力ダイアログが表
示されます。テーブル名と Btrieve ファイル名を指定して OK ボタンを押します。Bt
rieve ファイル名にはドライブ名やサーバー名にパスを含めて記述することも可能
です。単にファイル名を設定した場合には DDF と同じディレクトリに Btrieve ファイ
ルが存在することになります。
テーブル情報を入力するとメニューが切り替わり、テーブルを定義できる DDF 編
集モードのメニューになります。以下は初期画面の様子です。
181
フィールドの定義
DDF 編集モードのメニューで「フィールド」メニューから「追加」を選択するとフィー
ルド追加のダイアログが以下のように表示されます。
フィールド名を入力してデータ型、データ・サイズを入力します。上の例では String
型のフィールドを定義しているので、小数点以下桁数の入力はディセーブルにな
って入力できない状態になっています。入力項目が正しいことを確認したら「登録
ボタン」を押します。
フィールド設定の入力がフィールド・グリッドに表示されます。以下は例です。
182
インデックスの定義
DDF 編集モードのメニュー「インデックス」から追加を選択します。以下のような画
面でインデックスの定義をします。
183
フィールドを選択して、ソート・オーダー、キータイプを選択して OK ボタンを押しま
す。「データ変換モード」でセグメントがチェックされている場合にはセグメント・メン
バーのリストにメンバーとして表示されるだけで、このダイアログは閉じません。セ
グメントのチェックが無いフィールドが定義されて OK ボタンを押すと、すべてのセ
グメント・メンバーが定義された状態になり、このダイアログはクローズします。
キーの定義はテーブル・ウィンドウのインデックス・グリッドに表示されます。
セグメント・キーを定義する場合にはキー・タイプ、ソート・オーダーがすべてのセ
グメント・キーのメンバーについて同じでないと Btrieve ファイルの生成時にエラー
が発生しますのでご注意ください。
184
セグメント・キーはセグメントのフラグがオフになった項目までが１セグメントとなり
ます。上の例では ID と ITEMNAME で１つのセグメント・キーが定義されています。
既存 DDF の編集
既存 DDF を編集する場合は、DDF ビルダー起動画面の「ファイル」メニューから
「既存 DDF のオープン」を選択します。ファイルを選択するダイアログが表示され
ますので、FILE.DDF, FIELD.DDF, INDEX.DDF の存在するディレクトリを指定しま
す。DDF ビルダーの設定を「データ移行モード」とした場合には DDF で指定される
ディレクトリにデータ移行する Btrieve データ・ファイルが必要です。この時点で Bt
rieve データと DDF の定義が合致しない場合には DDF ビルダーは正常にデータ
変換できなくなるのでご注意ください。
データ変換モードの動作について
システム・オプション・メニューから「Btrieve データ変換モード」を選択すると、既存
の Btrieve ファイルに対して追加、削除されたフィールド、インデックスについては
DDF の形式の変更と共に実際の Btrieve データにもフィールドやが追加・削除さ
れ、DDF との整合性が保たれるように動作します。データ変換モードで動作してい
る場合にはフィールドの修正、およびインデックスの修正メニューはディセーブル
185
状態となり利用できない仕様です。既存のデータ・ファイルのフィールドやインデッ
クスを修正したい場合は、一旦削除してからフィールドやインデックスを追加する
ことになります。
また、重複を許さないインデックスを追加する際には既存のデータに重複が存在
するとエラーになってインデックスが生成できなくなりますのでご注意ください。
テーブルの搬入・搬出
DDF 編集モードでは「ファイル」メニューから「テーブルの搬入」、「テーブルの搬
出」が実行できます。テーブル定義を別の DDF にコピーする場合や一部定義が
異なるが大半の項目が同じテーブルを定義する場合に便利です。搬出したテーブ
ルを同じ DDF に搬入する場合は DDF に存在しないテーブル名を設定する必要
があります。搬出されたファイルのテーブル名を変更する場合は搬出したファイル
を notepad 等のエディターで[TableName]の次の行を編集します。（２行目）Btriev
e ファイル名は[TableLocation]の次の行にあります。（４行目）編集したファイルは
再度、搬入して編集します。
dbMagic データ辞書を搬入
VBMan DDFビルダーのオプションメニューから「dbMagicテーブルの搬入」を選択
することで、dbMagic バージョン 4.26,4.30,7.00のデータ辞書情報をDDFに搬入す
ることが可能です。dbMagicのデータ辞書をDDFに搬入する手順は以下のとうりで
す。
①
dbMagicでデータ辞書出力を実行します。このとき、dbMagicの出力オプション
の「モード」で、「I」を選択します。このモード以外で出力された場合の動作は
保証されませんので、ご注意ください。
②
VBMan DDFビルダーを起動して、DDF編集の状態にします。新規の場合は
最初に適当なテーブル名、Btrieveファイル名を入力して空のテーブルが１つ
だけの状態に、オプション・メニューから「dbMagicテーブル搬入」を選択し、搬
入が完了したら、最初のテーブルをファイル・メニューの下からテーブルの削
除を選択し、テーブルを削除します。既存のDDFをオープンした場合にはこ
のDDFにdbMagicデータ辞書の定義を追加することになります。
③
メニューから「dbMagicファイル搬入」を選択すると、ファイル指定ダイアログ
が表示されます。先程１で出力したデータ辞書の定義ファイルを指定します。
186
④
搬入が完了すると、dbMagicのBtrieveファイル毎にDDFの編集ウィンドウが
表示されます。複数定義を搬入する場合、途中でエラーとなる定義が存在し
た場合、それ以降の定義の搬入はされませんので、注意してください。
注意事項
①
dbMagicのデータ辞書でメモ型(M)のフィールドはDDFのString型に変換しま
す。VBManでは可変長のレコードはDDFの最後に１フィールドのみサポートと
なりますから、複数のメモ型の存在するdbMagicのデータ辞書定義、メモ型の
フィールドが最後にないもの等は扱うことができません。
②
dbMagicのデータ辞書で日付け型(D)のフィールドはDDFのInteger型4バイト
に変換します。これは、dbMagicがBtrieveのDate型を使っていないことが原
因です。dbMagicでは西暦１年１月１日を１として起算した数値を日付け型と
して使っていますので、お客様のアプリケーションでデータを変換するなどの
作業が必要になります。
③
dbMagicのデータ辞書定義でBtrieveファイル名が指定されないものはVBMan
DDFビルダーでは、取り込めません。（出力ファイルのFILEがある行にNAM
E=の記述がないもの）データ辞書定義でdbMagicの論理パスを指定して作成
されたBtrieveファイルはVBMan DDFビルダーのオプション・メニューから「Bt
rieveファイル情報」で論理パス情報を修正することが可能です。
Visual Basic 用フォームの生成
DDF編集モードのメニューで「オプション」からフォーム生成を選択することでVisual
Basic用のフォームを生成することが可能です。Visual Basicで簡単なマスター登
録ができるフォームを生成することが可能です。画面の解像度は無視されるので
フィールドが多い場合はアプリケーションが動作するパソコンの解像度にあわせて
フォームを編集してください。生成されたフォームはVisual Basicでプロジェクトに
追加して利用します。
フィールド ID リストの生成
Visual Basic でアプリケーションを作成する場合、VBMan のメソッドのパラメータを
Const で指定したい場合はこの機能を利用してフィールド ID のリストを生成してそ
れを Visual Basic のプロジェクトに追加します。
187
メソッドのパラメータとしてテーブル名やフィールド名を文字列で指定する場合に
はフィールドが追加になってもコードの変更は必要無いですが、VBMan バージョ
ン 1.x 関数や ID 指定のメソッド(DbGetFieldDataByID 等)を使っている場合、ID を
直接指定しているとフィールドの挿入によって ID が変わるとコードの変更も必要
になる場合があります。関数やメソッドのパラメータをシンボルで指定しておけば、
フィールドの挿入で ID が変わっても、Const 定義部分だけを変更するだけで関数
やメソッドの呼び出しコードを変更する必要はなくなります。
以下は ID リストの例です。
'ﾃｰﾌﾞﾙ ID for
Global Const
'ﾌｨｰﾙﾄﾞ ID
Global Const
Global Const
Global Const
'ｲﾝﾃﾞｯｸｽ ID
Global Const
Global Const
TEST1.DAT
TID_TEST1 = 0
FID_ID = 0
FID_ITEMNAME = 1
FID_PRICE = 2
KID_ID = 0
KID_ITEMNAME = 1
以下は上の ID リストでの Visual Basic コード例です。
Dim rc As Integer
With VBManDb1
Call .DbSetFieldDataByID(TID_TEST1,FID_ID,”101”)
Call .DbSetFieldDataByID(TID_TEST1,FID_ID,”商品名”)
Call .DbSetFieldDataByID(TID_TEST1,FID_PRICE,”1200”)
rc = .DbAccessByID(BTR_INSERT,TID_TEST1,KID_ID)
If rc <> 0 Then
MsgBox CStr(rc)
End If
End With
システム・オプションについて
以下はシステム・オプションの設定の最初のページです。
188
設定項目についての説明は以下になります。
項目
フィールド名入力時の IME オン
フィールド名英数字の Upper 変換
ゼロ・オフセット表示
DDF 読込時に ID のリナンバー
概要
フィールド情報設定ダイアログでフォール
ド名の入力時に IME がローマ時かな入
力に設定されます。
DDF では英数字はケースは無視される
仕様です。このオプションを設定すると入
力時にすべて大文字に変換します。
フィールドやインデックスのグリッド表示
で左に表示される ID をゼロ・オフセットで
表示します。バージョン 1.x コンパチ関数
等のパラメータでフィールドやインデック
スは 0 オフセット表示なので、同関数を
使う場合には 0 オフセット表示にしたほう
が便利です。
Pervasive Software がノベルだった時代
に作成された DDF 作成用の DLL で作成
189
DDF 読込時にウィンドウを開く
最大化する
Btrieve データ変換モード
された DDF は内部 ID がシリアルに設定
されない場合があります。このオプション
では DDF 読み込み時にそのような ID を
シリアルな値で保持します。
このチェックをはずすと既存の DDF をオ
ープンした時には一旦テーブル・リストが
作成されて、編集用のウィンドウは表示
されません。テーブル数の多い DDF をオ
ープンする場合には画面のリソースの消
費を押さえることと表示のパフォーマンス
が改善されます。
チェックした場合には DDF ビルダー起動
時にウィンドウを最大化します。
チェックした場合には既存の Btrieve デ
ータの形式を DDF 定義の変更に合わせ
て変更します。
以下はシステム・オプション・ダイアログの出力タブです。
190
設定項目についての説明は以下です。
項目
１ページに印字するフォールド数
フォーム生成
文字列型シンボル
概要
テーブルの印字で１ページに印字される
フィールドの数を指定します。
フォーム生成で生成されるフォームの形
式を指定します。VB5 用、VB4 用は当 A
ctiveX Control で利用できるフォームで
す。VB2 を選択した場合には 16bit の V
BMan for Btrieve/VBX 用のフォームが
出力されます。
VBMan バージョン 1.x 関数でフィールド
指定パラメータに利用できるシンボルを
生成する場合はこの項目のチェックをは
ずします。VBMan バージョン 2.x からメソ
ッドでの文字列型でテーブルやフィールド
を設定する場合にはこの項目をチェック
191
してフィールド ID リストを出力します。
192
Appendix
A. Microsoft Visual Studio.NET 制約事項
Refresh メソッドについて
Refresh メソッドは.NET framework のラップ・クラスによってオーバーライドされ
ていると思われ、VBMan の Refresh メソッドが呼び出されません。回避方法とし
ては予約名になっていない Reload メソッドを追加しました。
ImeMode について
.NET framework では ImeMode をデフォルトで全てのコントロールに追加します。
VBMan でも IMEMode を定義しているため、プロパティウィンドウには ImeMode/
IMEMode と二つプロパティが並んで表示されます。VBMan のプロパティは頭か
ら３文字が大文字の IMEMode プロパティが該当します。.NET framework が付
加する ImeMode プロパティについては設定しても動作に関係しないことを確認
しました。
VBMEdit コントロールの FormatString について
Microsoft Visual Studio .NET のでは IVBFormat インターフェースが実装され
ていないと思われるため、Edit コントロールの FormatString プロパティは動作い
たしません。アプリケーションコードで文字列フォーマットが必要になります。
B. Active Server Pages からの利用
概要・制約事項
マイクロソフト社の Windows NT Option Pack には IIS(Internet Information Se
rver)が含まれます。IIS では VBScript から ActiveX Object を利用することが出
来る仕様になっており、VBMan のデータ・ベース・コントロールを呼び出して Btri
eve データを操作することが可能です。
VBScript は ActiveX Object を呼び出せますが、ウィンドウを持つ ActiveX Con
trol は利用できない仕様ですからユーザー・インターフェースを持たない VBMan
のデータ・ベース・コントロールのみ利用できます。
また、言語の仕様が Visual Basic より簡略化されていることが原因でデータ・ベ
ース・コントロールを使う上では制約があります。以下に制約事項をまとめまし
193
た。
①
②
③
④
プロパティはすべてコードで設定する必要がある。
DbLoadDDF メソッドで DDF のロードをする必要がある。
AutoOpen プロパティは利用できないので、DbOpen/DbOpenAll で Btrieve
ファイルのオープンが必要になる。
文字列型の配列をパラメータとして指定する DbGetRecord メソッド等は動
作しない。（VB とパラメータの処理形式が異なるためと思われます）
ASPスクリプトの作成手順
ASP スクリプトから VBMan を参照可能とするためには、OBJECT タグで VBMa
n を指定する必要があります。このタグは各.asp ファイルの先頭で宣言します。
また、global.asa ファイルに指定することも可能です。以下は OBJECT タグで VB
Man を指定する例です。
<object RUNAT=Server id="VBMan" name="VBMan"
classid="clsid:3235CFF0-D891-11D1-BD2B-004026182472" border="0"
width="32" height="32">
</object>
次に Btrieve のオペレーション・コードを定義したファイルを.asp ファイルにインク
ルードして BTR_INSERT のようなコンスタントを利用可能とします。VBMan のサ
ンプルに添付される Btrieve.inc ファイルを以下のようにインクルード指定します。
<!-- #INCLUDE FILE=”btrieve.inc” -- >
DDF をロードするコードを記述します。DDF のロードは DbLoadDDF メソッドで実
行可能です。このメソッドは DDFDir プロパティに指定されたディレクトリを参照し
ますので、メソッドを呼び出す前に DDFDir プロパティを指定します。以下はサン
プル・コードです。
<%
<%
<%
<%
<%
LANGUAGE="VBSCRIPT" %>
Dim rc %>
VBMan.DDFDir="\\OurServer\ddf" %>
VBMan.AllOpen=FALSE %>
rc = VBMan.DbLoadDDF %>
194
<% if rc <> 0 Then %>
<p> DDF エラー <%= rc %>
<% End If%>
DDF をロードしたら Btrieve ファイルをオープンします。DDF に定義されている
すべてのテーブルを一度にオープンしたい場合は DbOpenAll メソッドが便利で
す。以下はサンプル・コードです。
<% rc = VBMan.DbOpenAll %>
<% If rc <> 0 Then %>
<p> オープン・エラー <%= rc %>
<% End If %>
Btrieve ファイルがオープンできたら、データ・ベース・コントロールのメソッド呼び
出しコードが記述できますので、お客様のアプリケーション・コードを記述してく
ださい。
処理の終了時には必ず DbCloseAll メソッドで Btrieve ファイルをすべてクロース
することを忘れないでください。以下はサンプル・コードです。
<% rc = VBMan.DbCloseAll %>
195
C. FAQ – よくあるご質問
この章では、VBMan を使った Btrieve アプリケーション・プログラミングやシステ
ム・セットアップに共通の問題、疑問などの解説をします。
Netware に添付されていた Btrieve 6.10x エンジンについて
以前 Netware に添付されていた Btrieve 6.10x エンジンは 32bit アプリケーショ
ンから利用するためのクライアント通信モジュールが提供されませんので Vbma
n からも利用することができません。このエンジンが添付されていたころにはま
だマイクロソフトの 32bit OS が発売される以前のバージョンですから、32bit の
通信モジュールは提供されていないのは仕方の無い事です。動作させるために
は Btrieve 6.15 以降の Btrieve サーバー・エンジンが必要になります。
Pervasive.SQL で作成したカラムのサイズについて
SQL で作成したカラムは”not null”制約をつけない場合はデータの先頭にヌル
状態を保持するフラグ領域が 1 バイト確保されますのでレコード長等の計算時
や Btrieve アプリで構造体の計算をする場合には注意が必要です。VBMan で
はバージョン 3 からこのようなフィールドをサポートします。
VBMan Controls for Btrieve の動作に必要なファイルは何か？
以下のファイルをアプリケーションと一緒に配布してください。下記のファイル以
外にはBtrieveの実行モジュールが必要になります。Btrieve関連のモジュール
は構成によって変わりますので、詳細はBtrieveマニュアルをご覧ください。VBM
anのレジストリ登録に失敗しないようにするのであれば、最低限wbtrv32.dllの配
布は必要になります。
VBMBT330.OCX
DIBAPI32.DLL
DDFIO330.DLL
VBMBT330.OCX を手動でレジストリ登録する
Regsvr32.exe を使って COM コンポーネント l を手動で登録することが可能です。
MS DOS プロンプトで以下のコマンドを実行してください。Regsvr32.exe がウィン
ドウズのシステムに存在しない場合は VBMan のインストール・ディレクトリにあ
るものをご利用ください。
Regsvr32.exe c:\windows\system32\vbmbt330.ocx
Regsvr32.exe で 0x485 のエラーとなる
196
Regsvr32.exeはモジュールのロードに失敗した場合、上記のようにC言語の16
進形式でエラーを表示します。この値はWIN32 APIのGetLastErrorからの値で
す。 0x485という値はモジュールが見つからない、ロードできないと言う意味で
必要なDLLが存在しない場合のエラーです。VBMBT330.OCXの登録でエラーに
なる場合はDIBAPI32.DLL,DDFIO330.DLLが\windows\system32に存在すること、
Btrieveが正常にインストールされていることをご確認ください。特にBtrieve開発
キットのみインストールしているような状況ですとc:\BTI\BINのようにBtrieveの
モジュールへのパスがautoexec.batファイルで指定してないとvbmbt3.30.ocxが
登録できない状況になりますのでご注意ください。BtrieveのモジュールではWB
TRV32.DLLがロードできないとVBMBT330.OCXは登録できません。
VBMBT330.OCX が依存するファイル
Visual C++に添付されるdumpbin.exeで以下のようなコマンドで依存するファイル
を知ることが出来ます。
dumpbin /IMPORTS c:\windows\system32\vbmbt330.ocx
VB６セット・アップ・ウィザード
Vb6のセット・アップ・ウィザードにはVBMan Control for Btrieveのモジュール依
存状況をvb6dep.iniに以下のように追加します。
[VBMBT330.OCX]
Register=$(DLLSelfRegister)
Dest=$(WINSYSPATH)
Uses1=DIBAPI32.DLL
Uses2=DDFIO330.DLL
[DIBAPI32.DLL]
Dest=$(WinSysPath)
[DDFIO330.DLL]
Dest$=(WinSysPath)
チェック・ボックスをクリックしても解除されない
VBManCheckBox コントロールの DbValueTrue プロパティと DbValueFalse プロ
パティに同一の値が設定されています。異なる値をセットしてください。
セグメント・キーの作成方法
197
複数項目で一つのキーとすることを、Btrieve ではセグメント・キーといいます。V
BMan でセグメント・キーを作成する方法は以下の手順でおこないます。
１) プルダウンからインデックス、追加を選択。インデックス指定ダイアログでセ
グメントのチェック・ボックスをチェック
２) 複合キーにするフィールドを上記の手順を繰り返す。最後のフィールドを指
定する時セグメントをチェックしない。セグメントがなしとする項目までで、ひとつ
の複合キーとなることに注意。
Btrieve ではセグメント・キー全体でキー番号を一つだけ設定しますが、VBMan
においては管理方法が異なり、それぞれのフィールドに ID が割り振られること
にご注意ください。データベース・アクセス関数 DbAccess に指定するキー番号
はセグメント・キーを構成する最初のフィールド ID から１引いた値を設定します。
以下は３つの項目でセグメント・キーを作成した場合のインデックス・グリッドの
例です。
以下はセグメント・キーで GET_EQUAL する Visual Basic でバージョン 1.x コン
パチブル関数を使ったサンプルです。フィールド ITEM_CDOE1, ITEM_CODE2 が
セグメントで、Const 文で設定している値はＤＤＦ定義の ID から１を引いたもの
を設定します。
Const ITEM_TABLE = 10
Const ITEM_CODE1 = 0
Const ITEM_CODE2 = 1
Const ITEM_KEY1 = 0
Dim rc As Integer, Code1$, Code2$
Code1$ = "100"
Code2$ = "ABC"
rc = DbSetFieldData( ITEM_TABLE, ITEM_CODE1, Code1$ )
rc = DbSetFieldData( ITEM_TABLE, ITEM_CODE2, Code2$ )
rc = DbAccess( BTR_GET_EQUAL, ITEM_TABLE, ITEM_KEY1 )
If rc <> 0 Then
MsgBox "Btrieve Err" & Str$(rc)
198
End If
DbListIndex 指定に同じ名前のキーが表示される
同じフィールドで複数のセグメント・キーの先頭項目になっている場合、プロパテ
ィ・ダイアログで同じフィールド名が DbListIndex プロパティに選択肢に表示され
ます。これらを識別するためには、インデックス名(Named Index)を VBMan DDF
ビルダーで設定してください。設定の方法は名前をつけたいインデックスを選択
して、（セグメント・キーの場合は先頭の項目）「インデックス」メニューから「イン
デックス名を追加」を選択してください。インデックス名を入力するダイアログが
表示されますから、他のインデックスと識別可能な名前を設定してください。イン
デックス名はインデックス・グリッドに括弧で表示されます。
DDF ファイルのディレクトリの移動
VBMan DDF ビルダーでデータベース定義し、フォームを定義した後、それらの
ファイルをまったく別のディレクトリに移動した場合、VBMan データベース･コント
ロールの DDFDir プロパティを移動したディレクトリに変更してください。変更せ
ずに実行した場合の動作は保証できません。
DDF ディレクトリと別のディレクトリに Btrieve ファイルをおきたい
VBMan DDF ビルダーでテーブル名と Btrieve ファイル名を設定するダイアログ
において、Btrieve ファイル名としてドライブとパスを指定することで可能です。た
だし、ドライブ名を含めた場合は別環境で実行する場合（ドライブ名が異なる場
合）にシステムやシステムの変更作業量が大きいと思われる為、お勧めしませ
ん。
AutoIncrement がカウントしない
キーが設定されていない場合は整数型のフィールドと同じ扱いとなります。また、
設定するキーは昇順のキーでなければなりません。
VBMan データベースアクセス関数で集計処理の仕方
バージョン 1.x コンパチブル関数を使った場合の集計処理のサンプル・コードを
示します。
Const
Const
Const
Const
SALES_CODE 0
SALES_AMOUNT 3
SALES_CODE 0
SALES_AMOUNT 3
199
Const SALES_ITEM_KEY 0
Dim rc As Integer
Dim Total As Ingeter, Key$, Sales$
Total = 0
' 検索開始キーの値をバッファに設定
rc = DbSetFieldData( SALES_TABLE, SALES_ITEM, "AAA")
' BTRIEVE を呼び、最初に合致するレコードを得る
rc = DbAccess(BTR_GET_GREATER_OR_EQUAL, SALES_TABLE, SALES_I
TEM_KEY )
Do While rc = 0
Key$ = DbGetFieldData( SALES_TABLE, SALES_ITEM )
If Key$ > "BBB" Then ' 集計範囲の検査
Exit Do
End If
' 集計処理
Sales$ = DbGetFieldData( SALES_TABLE, SALES_AMOUNT )
Total = Total + Val( Sales$ )
' BTRIEVE を呼び次のレコードを得る
rc = DbAccess(BTR_GET_NEXT,SALES_TABLE,SALES_ITEM_KEY)
Loop
If rc <> 9 And rc <> 0 Then
MsgBox "Btrieve Err" & Str$(rc)
End If
リクエスタ環境で DDFOpen エラー(20)が起こる
Btrieve サーバーに接続できない状況が多いと思われます。クライアント・アプリ
ケーションが Btrieve のリクエスター・モジュールにアクセスできない場合や、サ
ーバーで Btrieve が実行されていない場合、サーバーと通信ができない場合な
どに発生します。
Btrieve ステータス 2003 について
ワークステーション・エンジンの設定が無いためにローカル･ディスクにある Btrie
ve ファイルにアクセスできない状況です。DDF ファイル自体も Btrieve ファイル
なので、DDF ビルダーでローカル・ディスクにある DDF をオープンする場合にも
このステータスが表示されることがあります。
金額フィールドについて
VBMan バージョン 1.x では Money 型のフィールドについては自動的に金額フォ
200
ーマットしましたが、VBMan Controls for Btrieve では Format プロパティと For
matOption プロパティの指定が必要です。前のバージョンと同じフォーマットをす
るにはプロパティの設定を以下のようにしてください。Format プロパティ、MaxLe
ngth プロパティはフィールドのサイズによって変える必要があります。
VBManEdit1.Format = “###,###,###”
VBManEdit1.FormatOption = 3
VBManEdit1.NumericMask = True
VBManEdit1.MaxLength = 11
VBMan ボタンの押下をコードで実現したい
以下のコードで動作を確認しました。直接 Click イベントをよびだしても、Btrieve
のオペレーションは実行されませんのでご注意ください。この方法は Visible プ
ロパティが True のボタンに対して有効です。ボタンをフォームの見えない位置
に設定した場合でも動作します。
VBManBtn1.SetFocus
SendKeys "{Enter}"
削除ボタンでカレント・レコードが無条件に消される
VBManBtn の DbOperation に削除を指定した場合、ボタンがクリックされた時点
でのカレント・レコードが削除されてしまいます。フォームの入力とカレント・レコ
ードが一致するかを検査するコードを VBManBtn の SetData イベントに追加す
ることで問題を解決できます。以下はサンプル・コードで、現在入力されている
主キーで GET_EQUAL してレコードの再ポジショニングをしています。
Sub VBManBtn1.SetData()
Dim rc as Integer
rc = DbTransferFromControl( TABLE_ID )
rc = DbAccess(BTR_GET_EQUAL,TABLE_ID,PRIM_KEY)
If rc = 4 Or rc = 9 Then
MsgBox "削除するデータが存在しません"
VBManBtn1.Abort = True
Exit Sub
End If
If rc <> 0 Then
MsgBox "Btrieve error " & str$(rc)
VBManBtn1.Abort = True
Exit Sub
End If
201
End Sub
WaitLock の指定について
Btrieve for Windows では WaitLock はサポートされていませんでしたが、Btriev
e for Windows95/NT ではマルチ・タスク環境に対応して WaitLock が可能にな
りました。
Format イベントのコード例
リスト･ボックス、コンボ･ボックス、拡張コンボ･ボックス、拡張リスト･ボックスの F
ormat イベントのコードはバージョン 1.x では DbSetFormattedString,DbExSetFo
rmattedString 関数を使って設定していました。VBMan Controls for Btrieve で
はこれらの関数は使う必要がなく、パラメータとして渡される文字列を直接書き
換えることでリストされる文字列を指定可能となりました。以前のバージョンとの
コンパチビリティの為にこれらの関数も使用可能です。以下は Visual Basic に
おける Format イベントのコード例です。
Sub VBManListBox1_Format( LineData As String )
Dim rc As Integer
Dim ItemName As String
‘ VBMan リスト・ボックスではこの時点でカレント･レコードの
‘ フィールドからデータを得ることができる。
ItemName = VBManDB1.DbGetFieldData(“商品”,”商品名”)
‘ LineData には商品のコードが入っているとする。
LineData = LineData & “ - “ & ItemName
End Sub
DDF ビルダーの VE1070 メッセージ
データ変換モードの DDF ビルダーで、Btrieve データの形式を移行する場合、V
E1070 エラー･メッセージが表示されることがあります。このメッセージの括弧内
はオペレーティング･システムからのエラー値です。(Win32 API GetLastError
からの戻り値)エラー値５が表示される場合は Btrieve ファイルが他のプロセス
により使用中のステータスです。Btrieve ファイルを使っているプロセスを終了し
てください。
DDF ビルダーのデータ変換モードでの編集機能
Btrieve の Create supplimental Index が既存のキーID がある場合はキー値を
設定できない等の制約により、このモードで DDF ビルダーを稼動させている場
合は、インデックスの挿入メニューは使用可能になりません。（ディスエーブルさ
202
れます）
Visual C++を使いたい
Visual C++では動作を確認できておりません。デザイン・モードでの ActiveX Co
ntrol サポート機能が不足していること、プロパティを表示する再に漢字表示が
正しく行えないなどが理由です。
モジュールがロードされる順序
Windows95/98/ME/2000/XP と Windows 3.1 ではモジュールがロードされるデ
ィレクトリの検索順序が異なりますのでご注意ください。特に Btrieve は同じファ
イル名で別のバージョンが存在しますので、注意が必要です。MS Developer N
etWork-CD の Q129943 からの情報です。
16 bit
1.
2.
3.
4.
5.
6.
Windows の DLL サーチ・パス
カレント･ディレクトリ
Windows ディレクトリ
Windows の System ディレクトリ
EXE ファイルの存在するディレクトリ
PATH 環境変数で指定されるディレクトリ
ネットワーク上のマップされたディレクトリ
32 bit
1.
2.
3.
4.
5.
6.
Windows の DLL サーチ・パス
アプリケーションがロードされたディレクトリ
カレント･ディレクトリ
32bit の Windows System ディレクトリ
16bit の Windows System ディレクトリ
Windows ディレクトリ
PATH 環境変数で指定されるディレクトリ
203
204
エラー・メッセージ
この章では、VBMan のエラー・メッセージを解説します。エラーメッセージは製品
の改良のために予告なく追加、変更される場合があります。ご了承ください。
VE001 DDF読み込みエラ－
VE002 Btriveを初期化できません
VE003 メモリ－が足りません
VE004 DDFDirが指定されていません
VE005 DbTableが指定されていません
VE006 DDF読み込みエラ－
VE007 Btrieveファイルの生成に失敗
VE008 Btrieveファイルのオ－プンに失敗
(%d)
DDFビルダーで生成したデータ
ベース定義ファイルが読み込め
ません。
VBManがBtrieveの初期化を実
行しましたが、エラーがBtrieve
から戻されました。Btrieveの設
定ファイル、インストールが完
全か再度検査してください。
実行時のメモリが足りません。
VBManDBコントロールのDDFir
プロパティが設定されていない
ため、オペレーションが可能で
はない状態です。
VBManコントロールのDbTable
プロパティが設定されていない
ため、DbFieldプロパティを設定
できない状態です。
データベース定義ファイルの読
み込み中にファイルの終わりと
なりました。データベース定義フ
ァイルが破壊されているか、VB
Manのバージョンが異なりま
す。
データファイルが存在しなかっ
たのでBtrieveデータファイルを
生成しようとしましたが、エラー
がBtrieveから返されました。rc
=xxとBtrieveのエラー・コードが
表示されるので、Btrieveエラー
を調べて対処してください。
Btrieveデータファイルが破壊さ
れています。Btrieveのユーティ
リティで復旧してください。
205
VE009 DDFファイルの形式が異なります
VE010 レコ－ド数取得失敗(rc=%d)
VE011 デ－タ型の不正
VE013 ｲﾒｰｼﾞ・ｺﾝﾄﾛｰﾙに適合しないﾃﾞｰﾀ
型です。
VE014 このﾊﾞｰｼﾞｮﾝのVisual Basicでは動
作しません。
VE015 ｲﾒｰｼﾞ･ｺﾝﾄﾛｰﾙにﾋﾞｯﾄﾏｯﾌﾟを読み込
めません。
VE018 VBManPixはﾌｫｰﾑに最大個(10)存
在します。
VE019 メタファイルが読めません。
VE020 アイコンファイルをオープン出来ま
せん。
VE021 アイコンファイルのフォーマットが不
正です。
VE023 アルダス形式のメタファイルを読め
ません。
VE024 テーブルIDの指定が範囲外です。
VE025 フィールドIDの指定が範囲外です。
VBManのバージョンが異なりま
す。または、データベース定義
ファイルが破壊されています。
レコード件数を取得できませ
ん。データベースが破壊されて
います。Btrieveのユーティリテ
ィで復旧が必要です。
データ型がサポートされていま
せん。使用しているデータ型が
現在のVBManバージョンで使
用可能かどうか確認してくださ
い。VBMan.DDFファイルが破壊
されている可能性もあります。
VBManの現在のバージョンで
は.bmp,.ico,.wmf以外のファイル
拡張子はイメージ・コントロール
に表示ができません。
VBMan Controls for Btrieve
はVisual Basic 4.0J 32bit版で
動作します。
.BMPファイルの形式が正しくあ
りません。
VBManPixはフォームに10個以
上設定できません。
データベースで指定されたメタ
ファイルが存在しません。
データベースで指定されたアイ
コンファイルが存在しません。
指定されたアイコンファイルの
形式が正しくありません。
指定されたメタファイルはアル
ダス形式と判断されましたが、
その形式が正しくありません。
データベース・アクセス関数に
指定したテーブルのIDが範囲
外です。
データベース・アクセス関数に
指定したフィールドのIDが範囲
外です。
206
VE026 テンポラリ文字領域が確保できま
せん。
VE027 インデックスIDの指定が範囲外で
す。
VE028 DDFオープン・エラー(nn)
VE029-031 DDF読み込みエラー
VE035 キーID の指定が範囲外です。
VE036 セグメント・キーの指定が不正で
す。
VE037 FindPercentage に失敗(%d)
VE038 GetByPercentage に失敗
(%d)
DbGetFieldDataで戻るテンポラ
リの文字領域がありません。文
字領域で使用しないものがあ
れば、開放してください。
データベース・アクセス関数に
指定したインデックスIDが範囲
外です。
DDFファイルをオープンできま
せん。括弧内はBtrieveのステ
ータス・コードです。この値をBtr
ieveマニュアル等を参考にして
問題を解決してください。
DDFファイルの形式が正しくあ
りません。
DDF で定義されていないキー
の ID を指定しました。正しいキ
ーID を指定してください。
セグメント・キーの場合、セグメ
ントの先頭のキーの ID を指定
してください。
Btrieve 6.X の Find Percentag
e オペレーションに失敗しまし
た。括弧内は Btrieve からのス
テータス・コードです。Btrieve
のファイル形式が 5.x の場合に
このメッセージが表示される場
合が多いです。ファイル形式を
6.x に変換してください。
Btrieve 6.X の Get By Percen
tage オペレーションに失敗しま
した。括弧内は Btrieve からの
ステータス・コードです。Btrieve
のファイル形式がバージョン 5.x
の場合にこのメッセージが表示
されることが多いです。ファイル
形式を 6.x に変換してください。
207
VE039 Extended Opeartion エラー(%d)
VE040 抽出するフィールド・リストが指定さ
れていません。
VE041 検索条件のフィールド指定には@が
必要です。
VE042 比較演算子は(=,<,>,<>,<=,>=)のい
ずれかを指定してください。
VE043 Extended 系オペレーションに可変
長データは指定できません。
VE044 このオペレーション・コード(nn)は使
用可能ではありません。
VE045 DbMaxRecords が指定されていま
せん。
VE046 データの指定がなく、& | オペレー
タが指定されています。不正な検索条件文
字列は(string)です。
Extended 系 Btrieve オペレー
ションが括弧内に表示されるエ
ラー・コードを返しました。詳細
は Btrieve プログラマーズ・マニ
ュアル等を参照してプログラム
を修正してください。
Extended 系 Btrieve オペレー
ションにおいて、抽出するフィー
ルドが指定されていません。
Extended 系オペレーションの
検索条件の指定でフィールド ID
が＠プリフィックスになっていま
せん。
Extended 系オペレーションの
検索条件の指定で比較演算子
の指定が不正です。正しい比
較演算子を指定してください。
Extended 系オペレーションの
抽出フィールドまたは検索条件
に Note 型、Lvar 型のいずれか
が指定されています。可変長型
データを Extended 系オペレー
ションに指定することはできま
せん。
DbExAcccess 関数の第一パラ
メータに不正な値が設定されて
います。
拡張リスト・ボックスまたは拡張
コンボ・ボックスの DbMaxRecor
ds プロパティに値 0 が指定され
ています。抽出するレコード件
数を設定してください。
Extended 系コントロールまた
は、メソッド/関数で DbConditio
ns プロパティまたはパラメータ
において検索条件式の右辺が
ありませんでした。正しい検索
条件式を設定してください。
208
VE050 テーブル ID(nn)のレコード長が DDF
定義と一致していません。Btrieve=xx,DDF=
yy
VE053 センチネルエラーです。ステータス
＝(nn,nn)です。
VE801 オープン・モードの指定不正です。
VE802 DbSource または DbTable プロパテ
ィが不正です。
VE803 Btrieve ファイル(name)のオープン
に失敗(nn)
Btrieve ファイルをオープンし
て、レコードを入出力するメモリ
を割り振ろうとしましたが、Btrie
ve のレコード・サイズと DDF で
定義されるレコードサイズが合
致しませんでした。Btrieve ファ
イルを生成しなおすか、既存の
Btrieve ファイルに合致するよう
に DDF を定義しなおしてくださ
い。Btrieve と DDF の定義が合
致してることを確認するには既
存の Btrieve ファイルと DDF を
定義して生成された Btrieve フ
ァイルの両方に BUTIL ユーティ
リティ等で Stat オペレーション
を実行して、インデックスの定
義、レコード長が同一であるこ
とを確認してください。DDF と B
trieve の定義が合致していない
場合の VBMan の動作は一切
保証できません。
センチネルを認識できませんで
した。当マニュアルのセンチネ
ルインストール手順に従って、
ハードウェアの接続、ドライバ
ーのインストール状況等をご確
認ください。どうしても接続出来
ない場合はカッコ内のステータ
スをサポートまでご連絡くださ
い。
VBMan データベース・コントロ
ールの OpenMode プロパティの
設定が正しくありません。
これらのプロパティを正しい値
を指定してください。
Btrieve ファイル name を Btriev
e ステータス nn の理由でオー
プンすることができませんでし
た。ステータスの詳細を Btrieve
プログラマーズ・マニュアル等
で調査して問題を解決してくだ
さい。
209
VE804 インデックスの指定が不正です。
VE805 データ・ファイル name をオープンで
きません(nn)
VE806 Btrieve ファイルと DDF ファイルの
定義が合致していません。(Btrieve=mm,DD
F=nn)
VE807 ボタンによる Btrieve オペレーション
に失敗しました。(nn)
DbIndex または DbIndexName
プロパティの指定が DDF 定義
に存在しません。これらのプロ
パティの値を正しく設定してくだ
さい。
Btrieve データ・ファイル name
を Btrieve ステータス nn が原
因でオープンすることができま
せんでした。ステータスの詳細
を Btrieve プログラマーズ・マニ
ュアル等で調査して問題を解決
してください。
Btrieve ファイルをオープンし
て、レコードを入出力するメモリ
を割り振ろうとしましたが、Btrie
ve のレコード・サイズと DDF で
定義されるレコードサイズが合
致しませんでした。Btrieve ファ
イルを生成しなおすか、既存の
Btrieve ファイルに合致するよう
に DDF を定義しなおしてくださ
い。Btrieve と DDF の定義が合
致してることを確認するには既
存の Btrieve ファイルと DDF を
定義して生成された Btrieve フ
ァイルの両方に BUTIL ユーティ
リティ等で Stat オペレーション
を実行して、インデックスの定
義、レコード長が同一であるこ
とを確認してください。DDF と B
trieve の定義が合致していない
場合の VBMan の動作は一切
保証できません。
VBMan ボタン・コントロールをク
リックされたので、Btrieve オペ
レーションを発行しましたが、Bt
rieve ステータス nn が返されま
した。Btrieve ステータスを Btri
eve プログラマーズ・マニュアル
等で調査してエラーを取り除い
てください。
210
VE808 Parent の DispatchID を取得できま
せん。
VE809 Parent ディスパッチ・インターフェー
スを取得できません。
VE810 Parent の Name DispatchID を取得
できません。
VE811 Parent の Name ディスパッチ・イン
ターフェースを取得できません。
VE812 DDF ファイルクローズ・エラー(nn)
VE813 Btrieve ファイル name のクローズ・
エラー(nn)
VBMan コントロールが置かれ
ているフォーム等の OLE Dispa
tch ID が取得できません。この
コントロール・コンテナは VBMa
n を使用するには機能が不足し
ています。
VBMan コントロールが置かれ
ているフォーム等の OLE ディス
パッチ・インターフェースが取得
できません。このコントロール・
コンテナは VBMan を使用する
には機能が不足しています。
VBMan コントロールが置かれ
ているフォーム等の Name プロ
パティの OLE Dispatch ID が
取得できません。このコントロー
ル・コンテナは VBMan を使用
するには機能が不足していま
す。
VBMan コントロールが置かれ
ているフォーム等の Name プロ
パティの OLE ディスパッチ・イ
ンターフェースが取得できませ
ん。このコントロール・コンテナ
は VBMan を使用するには機能
が不足しています。
DDF ファイルをクローズすると
きに Btrieve がステータス nn を
返しました。このステータスを B
trieve プログラマーズ・マニュア
ル等で調査してエラーを取り除
いてください。
Btrieve ファイル名が name で
ある Btrieve ファイルをクローズ
するとき、Btrieve が nn のステ
ータスを返しました。このステー
タスを Btrieve プログラマーズ・
マニュアル等で調査してエラー
を取り除いてください。
211
VE814 コンテナから Name, FormName を
取得できません。
VE815 プロパティの値が不正です。
VE816 パーセンテージ・オペレーションに失
敗(nn)
VE817 ゲット・パーセンテージ・オペレーショ
ンに失敗(nn)
VE818 Extended オペレーションで指定さ
れたフィールド(field_name)が存在しませ
ん。
VE819 イメージ・ファイル(name)が存在しま
せん。
コンテナ・アプリケーションの機
能が不足しているので、VBMan
カスタム・コントロールを使うこ
とができません。
特定のコントロールのプロパテ
ィ値が不正です。
スクロールバーの操作をするた
めに Btrieve のパーセンテー
ジ・オペレーションを発行しまし
たが、Btrieve がステータスの n
n を返しました。このステータス
を Btrieve プログラマーズ・マニ
ュアル等で調査してエラーを取
り除いてください。
スクロールバーの操作をするた
めに Btrieve のゲット・パーセン
テージ・オペレーションを発行し
ましたが、Btrieve がステータス
の nn を返しました。このステー
タスを Btrieve プログラマーズ・
マニュアル等で調査してエラー
を取り除いてください。
Extended 系のオペレーションを
実行する際に DbConditions ま
たは DbListFields プロパティに
指定されたフィールド field_nam
e が見つかりませんでした。
VBMan ピクチャー・コントロー
ルがイメージ・ファイル name を
オープンできませんでした。
212
213
VBMan エラー・コード
VBMan Controls for Btrieve では、メソッドや関数の戻り値にマイナスの値を
返す場合があります。以下はこれらの VBMan エラー・コードについての説明で
す。値(-16)以降は version 3.30 で新たに追加になったエラー・コードです。
エラー・シンボル
VBM_ERR_GENERIC
値
-1
VBM_ERR_ALREADY_OPEN
-2
VBM_ERR_NOT_OPEN
-3
VBM_ERR_INVALID_TABLE_NAME
-4
VBM_ERR_INVALID_FIELD_NAME
VBM_ERR_INVALID_KEY
VBM_ERR_INVALID_OPCODE
-5
-6
-7
VBM_ERR_INVALID_EXCOND
-8
VBM_ERR_INVALID_EXTRACTOR
-9
VBM_ERR_LOCK_BIAS
-10
VBM_ERR_CONTROL_NOT_FOUN -11
D
VBM_ERR_NOT_ATTACHED
-12
詳細
一般的なエラー。これ以外のエ
ラーに含めることができないも
の。
Btrieve ファイルがオープンして
いない時に実行されるべきメソッ
ド/関数がオープン中のファイル
に対して実行された。
Btrive ファイルがオープンされて
いる時に実行されるべきメソッド/
関数がオープンされていないファ
イルに対して実行された。
テーブル名が DDFDir プロパティ
で指定される DDF に存在しな
い。
フィールド名が存在しない。
インデックス名が存在しない。
Btrieve のオペレーション・コード
として指定できない値を設定し
た。
Extended 系の Btrieve オペレー
ションを発行するメソッド/関数で
検索条件の指定が不正である。
Extended 系の Btrieve オペレー
ションを発行するメソッド/関数で
抽出するフィールドの指定が不
正である。
トランザクション関連のメソッド/
関数などで、ロック値として不正
な値を設定した。
DbAttachControl 関数で最初の
パラメータがただしくない。
DbAttachControl 関数が呼び出
214
VBM_ERR_INVALID_FIELD_ID
VBM_ERR_INVALID_KEY_ID
VBM_ERR_INVALID_TABLE_ID
VBM_ERR_EXPAND_FILE_NAME
-13
-14
-15
-16
VBM_ERR_DATA_TYPE
-17
VBM_ERR_ARRAY_DIMS
-18
VBM_ERR_OUT_OF_RANGE
-19
VBM_ERR_DDF_LOAD
-20
VBM_ERR_INVALID_DDF_DIR
-21
VBM_ERR_ARRAY_ACCESS
-22
VBM_ERR_INVALID_ARRAY_TYPE
-23
されていない状態でバージョン 1.
x コンパチブル関数が呼び出さ
れた。
フィールド ID が正しくない。
インデックス ID が正しくない。
テーブル ID が正しくない。
DDFDir を短いファイル名に変換
する際にエラーが発生しました。
ファイル・システムの破損が考え
られます。ScanDisk 等でエラー
が発生するファイル・システムを
修復してください。
配列で変数を指定する仕様のメ
ソッドにおいてパラメータのデー
タ型が不正です。
１次元配列が指定されたメソッド
のパラメータにそれ以外の次元
の配列が指定されました。
データを受取る配列のサイズが
不充分です。またはデータを配
列で設定するメソッドの場合、配
列のインデックス範囲がフィール
ド ID の範囲を越えています。
DDF がロードされていない状態
で DDF 情報が必要とされるメソ
ッド、コントロールが利用されて
います。アプリケーションは DbLo
adDDF メソッドで事前に DDF を
読みこませる必要があります。
DbLoadDDF メソッドが呼び出さ
れましたが、DDFDir プロパティ
に正しい値が設定されていませ
んでした。
指定された配列をアドレスに変
換する Win32 API がエラーを返
しました。Visual Basic 等の言語
では通常起こり得ないシステム・
エラーです。言語やシステムの
再インストールをお勧めします。
配列で変数を指定する仕様のメ
ソッドにおいてパラメータのデー
215
VBM_ERR_INVALID_ARRAY_DIM
-24
VBM_ERR_SENT_MODULE_LOAD
-25
VBM_ERR_SENT_MODULE_ENTRY
-26
VBM_ERR_SENT_QUERY
-28
VBM_ERR_SENT_MISSING
-29
VBM_ERR_SENT_OPEN
-30
VBM_ERR_SENT_INIT
-31
VBM_ERR_SENT_FIND_UNIT
-33
タ型が不正です。
１次元配列が指定されたメソッド
のパラメータにそれ以外の次元
の配列が指定されました。
サポート用センチネル診断値で
す。センチネル用ドライバーが正
常にインストールされていませ
ん。
サポート用センチネル診断値で
す。Sx32w.dll または sp32w.dll
が破損している可能性がありま
す。
サポート用センチネル診断値で
す。パラレルポート用センチネル
が接続されていないと思われま
す。
サポート用センチネル診断値で
す。パラレルポート用センチネル
が接続されていないと思われま
す。
サポート用センチネル診断値で
す。センチネルの初期化に失敗
しています。
サポート用センチネル診断値で
す。センチネルの初期化に失敗
しています。
サポート用センチネル診断値で
す。USB センチネルのユニット
が接続されていません。
216
DDF ビルダー・メッセージ
DDF ビルダーが表示するメッセージについて解説します。
メッセージ
意味
VE1000 DDF ディレクトリを指定してく 新規 DDF の作成で DDF ディレクトリが
ださい
指定されていません。DDF ディレクトリ
を正しく指定してください。
VE1001 DDF 情報を正しく指定してくだ 新規 DDF の作成で Btrieve ファイル名
さい
が入力されていません。正しい Btrieve
ファイル名を指定してください。
VE1002 フィールド名を指定してくださ フィールドの追加、修正でフィールド名
い
が入力されていません。
VE1003 データサイズまたは小数点以 フィールドの追加、修正で設定したデー
下桁数が不正です
タ型のサイズまたは小数点以下の設定
が正しくありません。正確な値を設定し
てください。データ型の詳細を Btrieve
マニュアルで参照されることをお勧めし
ます。
VE1004 フィールドはこれ以上追加でき 現在の DDF ビルダーで設定可能なフィ
ません
ールド数の上限に達しました。これ以上
フィールドは追加することができませ
ん。
VE1006 すでに同名のフィールドが定 フィールドの追加ですでにテーブルに
義されています
存在するフィールド名を指定しました。
フィールド名は他と識別するためにユニ
ークな名前を設定することが必要です。
VE1007 すでに同名のテーブルが定義 新規テーブルの定義で指定したテーブ
されています
ル名はすでに DDF に存在します。テー
ブル名は他と識別するためにユニーク
な名前を設定することが必要です。
VE1008 フィールドが選択されていませ メニューからフィールド処理を選択しま
ん
したが、処理対象となるフィールドが選
択されていません。マウスの左クリック
で処理対象となるフィールドを選択して
からメニューの選択を実行してくださ
い。
VE1009 テーブルが選択されていませ メニューからテーブルに関する処理が
ん
選択されましたが、処理対象となるテー
ブルが選択されていません。処理する
217
VE1010 フィールド [%s] を削除します
か？
VE1011 フィールドが定義されていませ
ん
VE1012 インデックスはこれ以上設定
できません
VE1013 フィールドが選択されていませ
ん
VE1014 修正するインデックスが選択さ
れていません
VE1015 インデックス[%s]を削除します
か？ﾃﾞｰﾀ変換ﾓｰﾄﾞの場合で、ｾｸﾞﾒﾝﾄ･
ｷｰの場合はｾｸﾞﾒﾝﾄ・ｷｰを一括削除し
ます。
VE1016 削除するインデックスが選択さ
れていません
VE1017 DDFOpen API エラー(%d)
テーブルのウィンドウのタイトルをクリッ
クしてアクティブな状態にしてからメニュ
ーを選択してください。
フィールド削除の確認です。削除しても
良い場合は OK ボタンをクリックしてくだ
さい。
インデックスの追加をメニューから選択
しましたが、まだフィールドがひとつも定
義されていません。先にフィールドを定
義してください。
インデックス定義の上限値に達しまし
た。Btrieve の仕様により定義できるイ
ンデックス数には上限があります。
インデックスの追加・修正でフィールド
が選択されていません。フィールドを選
択してください。
インデックスの修正をメニューから選択
しましたが、修正対象となるインデック
スが選択されていません。先にインデッ
クスのグリッドから修正対象となるイン
デックスをマウスの左クリックで選択し
てください。
インデックス削除の確認メッセージで
す。かぎ括弧で表示されたインデックス
を削除してよければ、OK ボタンをクリッ
クしてください。データ変換モードではセ
グメント・キーの途中を残すことは意味
が無いのでセグメント・キー全体を削除
します。
インデックスの削除をメニューから選択
しましたが、削除対象となるインデック
スが選択されていません。先にインデッ
クスのグリッドから削除対象となるイン
デックスをマウスの左クリックで選択し
てください。
既存の DDF ファイルを修正するために
DDF をオープンしましたが、Btrieve か
ら括弧内のステータスが返されました。
括弧内の値を Btrieve のマニュアルな
どで調査してください。多くの場合は Bt
rieve エンジンやサーバー環境の設定
に問題があると思われます。
218
VE1018 DDFWriteFile API エラー(%d)
VE1019 DDFWriteField API エラー[%s]
(%d)
VE1020 DDFWriteIndex API エラー(%d)
VE1021 テーブルが定義されていませ
ん
VE1022 インデックスの最後の項目は
セグメントをオフにしてください
VE1023 データ型が選択されていませ
ん
VE1024 フィールドにはインデックスが
作成されています。先にインデックスを
削除してください
VE1025 DDF ﾌｧｲﾙが存在しません
VE1026 FILE.DDF 読みエラー(%d)
FILE.DDF を書きこむ際に Btrieve が括
弧内のステータスを返しました。括弧内
の値を Btrieve のマニュアルなどで調
査してください。多くの場合、Btrieve エ
ンジンやサーバー環境の設定、ディス
ク容量などの問題思われます。
FIELD.DDF を書きこむ際に Btrieve が
括弧内のステータスを返しました。括弧
内の値を Btrieve のマニュアルなどで
調査してください。多くの場合、Btrieve
エンジンやサーバー環境の設定、ディ
スク容量などの問題思われます。
INDEX.DDF を書きこむ際に Btrieve が
括弧内のステータスを返しました。括弧
内の値を Btrieve のマニュアルなどで
調査してください。多くの場合、Btrieve
エンジンやサーバー環境の設定、ディ
スク容量などの問題思われます。
DDF の保存を指定されましたが、テー
ブルがひとつも定義されていないので
保存できません。
DDF の保存時にインデックスの最後の
項目がセグメントがオンになったまま
で、セグメント・キーの終わりが設定さ
れていません。インデックス定義の見直
しが必要と思われます。
フィールドの設定でデータ型が定義され
ていませんでした。データ型の選択は
必須です。
フィールドの削除が指定されましたが、
対象となるフィールドにはインデックス
が設定されています。フィールドを削除
する前に関連するインデックスをすべて
削除してからフィールドを削除してくださ
い。
既存の DDF ファイルのオープンが指定
されましたが、FILE.DLL,FIELD.DDF,IND
EX.DDF の３ファイルが同じディレクトリ
に存在しませんでした。DDF の存在す
るディレクトリを正しく指定してください。
既存の DDF ファイルのオープンが指定
されましたが、FILE.DDF の読み込み時
219
VE1027 FIELD.DDF 読みエラー(%d)
VE1028 INDEX.DDF 読みエラー(%d)
VE1031 vbman.ini への書き込みに失
敗しました
VE1032 搬出ﾌｧｲﾙを書き込みモードで
ｵｰﾌﾟﾝできません
VE1033 テーブル[%s]の搬出が終了し
ました
VE1034 搬入ﾌｧｲﾙを読み込みモードで
ｵｰﾌﾟﾝできません
に Btrieve が括弧内のステータスを返
しました。括弧内の値を Btrieve マニュ
アルなどで調査してください。多くの場
合、Btrieve エンジンの設定に問題があ
るか破損した DDF ファイルを指定して
いるか、形式の正しくない DDF ファイル
を指定していると思われます。
既存の DDF ファイルのオープンが指定
されましたが、FIELD.DDF の読み込み
時に Btrieve が括弧内のステータスを
返しました。括弧内の値を Btrieve マニ
ュアルなどで調査してください。多くの
場合、Btrieve エンジンの設定に問題が
あるか破損した DDF ファイルを指定し
ているか、形式の正しくない DDF ファイ
ルを指定していると思われます。
既存の DDF ファイルのオープンが指定
されましたが、INDEX.DDF の読み込み
時に Btrieve が括弧内のステータスを
返しました。括弧内の値を Btrieve マニ
ュアルなどで調査してください。多くの
場合、Btrieve エンジンの設定に問題が
あるか破損した DDF ファイルを指定し
ているか、形式の正しくない DDF ファイ
ルを指定していると思われます。
ウィンドウズがインストールしていある
ディスクが満杯か破損している状況と
思われます。ディスクの容量を確認でき
たら、ScanDisk 等を実行して破損を回
復してください。
搬出を指定したディスクの容量が不足
しているかディスクが破損していると思
われます。ディスクの容量を確認できた
ら、ScanDisk 等を実行して破損を回復
してください。
搬出が正常に終了した場合の通知メッ
セージです。
搬入を指定したファイルかディスクが破
損しているか、ファイルが存在しないと
思われます。ファイルの存在が確認で
きたら、ScanDisk 等を実行して破損を
回復してください。
220
VE1035 テーブル[%s]の搬入が終了し
ました
VE 1 0 37 テーブル[%s]を削除します
か？
VE1039 メモリが確保できません。
VE1040 BTRIEVE CREATE に失敗(%
d)
VE1041 BTRIEVE ﾌｧｲﾙ %s が存在し
ます。上書きしますか？
VE1042 ファイル %s はすでに存在し
ます。上書きしますか？
VE1043 ファイルが書き込みモードでｵ
ｰﾌﾟﾝできません。
VE1044 ﾌｨｰﾙﾄﾞ ID ﾌｧｲﾙの出力が終了
しました
VE1045 DDF ファイルを保存しますか
VE1046 書き込むﾌｫｰﾑ %s のｵｰﾌﾟﾝに
搬入が正常に終了した場合の通知メッ
セージです。
テーブルを削除する際の確認メッセー
ジです。かぎ括弧で表示されるテーブ
ルを削除する場合は OK ボタンをクリッ
クします。
DDF ビルダーが動作するのに十分なメ
モリが確保できませんでした。同時に起
動しているアプリケーションがあれば終
了させてください。DDF ビルダー単独で
起動しても同メッセージが表示される場
合は、パソコンの実装メモリを増やす
か、スワップを大きくしてください。
Btrieve ファイルの生成に失敗しまし
た。失敗した理由は括弧内の Btrieve
ステータスで表示されていますので、Bt
rieve マニュアルなどで原因をお調べく
ださい。
Btrieve ファイルの生成を指定しました
が、生成の対象となるファイルはすでに
存在しています。既存のファイルが不
要であれば、このメッセージに OK をク
リックして新しい Btrieve ファイルを上書
きして生成します。
フィールド ID ファイルの出力で指定さ
れたファイルはすでに存在しています。
既存のファイルが不要であれば、このメ
ッセージに OK をクリックして既存のファ
イルを上書きしてください。
フィールド ID ファイルの出力で指定さ
れたファイルを出力するモードでオープ
ンすることが出来ませんでした。ディス
クの容量が満杯になっているか、ディス
クの破損が原因と思われます。ディスク
の容量に問題が無ければ、ScanDisk
などでディスクの障害をとりのぞいてく
ださい。
フィールド ID の出力が正常に終了した
ことを通知するメッセージです。
DDF ファイルの保存確認メッセージで
す。
フォームの生成で指定されたファイルを
221
失敗しました
VE1047 新規または修正されたﾃｰﾌﾞﾙ%
s に対して整合性のないとおもわれる B
TRIEVE ﾌｧｲﾙ %s が存在します。OK を
ｸﾘｯｸした場合は BTRIEVE ﾌｧｲﾙを削除
します
VE1048 BTRIEVE ﾌｧｲﾙの削除ができ
ません。他のプログラムが使用中です
VE1049 ﾃｰﾌﾞﾙにﾌｨｰﾙﾄﾞが定義されて
いません
VE1050 クリップボードの内容が不正で
す
VE1051 １ﾍﾟｰｼﾞに印字するﾌｨｰﾙﾄﾞ数が
不正です
VE1052 可変長フィールドを挿入するこ
とはできません。テーブルの最後に１フ
ィールドのみの追加は可能です
VE1053 すでに可変長の項目が存在し
ます
書きこみのモードでオープンすることが
できませんでした。ディスクの容量が満
杯になっているか、ディスクの破損が原
因と思われます。ディスクの容量に問
題が無ければ、ScanDisk などでディス
クの障害をとりのぞいてください。
フィールド定義で合算されるレコード長
と異なる既存の Btrieve ファイル存在し
ます。Control ではフィールド定義と合
致しない Btrieve ファイルを扱うことが
できないので、このメッセージに OK を
クリックした場合は該当 Btrieve ファイ
ルを削除します。
VE1047 メッセージで削除を指定された
Btrieve ファイルは他のアプリケーション
などでオープンされているため削除す
ることが出来ませんでした。該当 Btriev
e ファイルを削除したい場合はアプリケ
ーションを終了させてから削除してくだ
さい。
フォームの生成が指定されましたが、
指定されたテーブルにはフィールドがひ
とつも定義されていませんでした。フィ
ールド定義、インデックス定義が完了し
たテーブルについてフォームの生成を
実行してください。
クリップ・ボードには VBMan DDF ビル
ダーで設定した以外のデータが保持さ
れているので、クリップ・ボードからのペ
ーストが実行できませんでした。クリッ
プ・ボードへのコピーからやり直してくだ
さい。
システム・オプションの指定で１ページ
に印字するフィールド数の指定が０か
空白になっています。０以外の値を指
定してください。
フィールドの挿入を指定しましたが、設
定したフィールドは可変長のデータ型で
す。可変長のフィールドはテーブルの最
後に追加することだけが可能です。
テーブルには可変長のデータ型を持つ
フィールドを複数定義することはできま
222
VE1054 テーブルの最後の項目以外は
可変長データ型に変更できません
VE1055 Named Index は変更できませ
ん
VE1057 テーブル[%s]にインデックスが
ありません。VBMan からの DDF 利用
にはすくなくとも一つインデックスを作成
してください
VE1059 dbMagic 情報ファイルの搬入
に失敗しました
VE1060 dbMagic の数値形フィールドに
不正なデータ長があります
VE1061 dbMagic 情報ファイルの FILE
行に DESC=が存在しません
VE1062 dbMagic 情報ファイルの FILE
行に NAME=(btrieve ファイル名)の定義
が存在しません
VE1063 ｲﾝﾃﾞｯｸｽ名[%s]を削除しますか
VE1064 ｲﾝﾃﾞｯｸｽ名を設定するときは
セグメント・キーの場合はセグメントの
先頭にセットしてください
VE1070 ファイルのコピーまたは移動に
失敗しました。オペレーティングシステ
ムからのエラー･コードは %d です。
せん。
フィールドの変更を指定しましたが、テ
ーブルの最後の項目では無いため、可
変長データ型のフィールドに変更するこ
とは出来ません。
インデックス名は追加と削除のみ可能
な仕様です。
DDF の保存を指定しましたが、インデッ
クスがひとつも定義されていません。V
BMan のコントロールを使う際にはイン
デックスが１個は必要なので、インデッ
クスを定義してから DDF の保存をして
ください。
DbMagic データ辞書ファイルの搬入に
失敗したことを通知するメッセージで
す。
DbMagic のデータ辞書の形式が不正で
す。今一度 dbMagic でデータ辞書搬出
をした結果をご確認ください。
DbMagic のデータ辞書の形式が不正で
す。今一度 dbMagic でデータ辞書搬出
をした結果をご確認ください。
DbMagic のデータ辞書の形式が不正で
す。今一度 dbMagic でデータ辞書搬出
をした結果をご確認ください。
インデックス名の削除確認メッセージで
す。かぎ括弧でかこまれたインデックス
名を削除してもよければ、OK ボタンを
クリックしてください。
インデックス名の追加を指定する場合
はセグメント・キーの先頭の項目に設定
してください。セグメント・キーの先頭以
外のメンバーを選択した状態でインデッ
クス名の指定をメニューから選択してい
ます。
データ移行モードでフォーマット変換の
対象となる Btrieve データ・ファイルを移
動する際にオペレーティング・システム
がエラーを返しました。エラー・コードは
Win32 API の GetLastError からの値で
す。Windows SDK 等マイクロソフトの資
料にエラー・コードの詳細が記載されて
223
VE1071 Btrieve ファイルのフォーマット
変換中にエラー(%d)
VE1072 ファイル変換につかったとおも
われるファイル %s が存在します。削
除して処理をすすめますか？
VE1073 Btrieve ファイルがオープンで
きません。Btrieve のステータスは(%d)
です。
います。
データ移行中に Btrieve が括弧内のエ
ラーを返しました。括弧内の値を Btriev
e マニュアルなどで調査してください。
既存のデータにインデックスを追加する
際に重複が発生する際には括弧内に
ステータス５が表示されます。
データ移行を開始する際に前回に変換
に失敗したと思われる一時ファイルが
残っていました。前回の変換で途中ま
での変換が残っていてそこからデータ
を復元できる場合もあります。一時ファ
イルが不要であれば OK クリックして作
業を進めてください。
データ移行の際に該当 Btrieve ファイ
ルをオープンしたら Btrieve から括弧内
のステータスが返されました。括弧内の
値を Btrieve マニュアル等で調査してく
ださい。
データ変換モードでのフィールド変更に
関する注意メッセージです。
VE1074 Btrieve ﾃﾞｰﾀ変換ﾓｰﾄﾞではﾌｨ
ｰﾙﾄﾞ、ｲﾝﾃﾞｯｸｽの修正はできません。
変更したいﾌｨｰﾙﾄﾞ、ｲﾝﾃﾞｯｸｽはいった
ん削除してから、追加してください。ﾃﾞｰ
ﾀを変換する必要がなければ、ｼｽﾃﾑ･ｵ
ﾌﾟｼｮﾝからﾃﾞｰﾀ変換ﾓｰﾄﾞを解除してくだ
さい。
VE1075 Btrieve の DropIndex オペレー データ変換モードでインデックスの削除
ションに失敗しました。Btrieve からのス を指定されました。それに従って Btriev
e のキー削除を実行しましたが、Btriev
テータスは(%d)です
e が括弧内のステータスを返してきまし
た。括弧内の値を Btrieve マニュアル
等で調査してください。
VE1076 Btrieve の CreateIndex オペレ データ変換モードでインデックスの追加
ーションに失敗しました。Btrieve からの を指定されました。それに従って Btriev
e のキー追加を実行しましたが、Btriev
ステータスは(%d)です
e が括弧内のステータスを返してきまし
た。括弧内の値を Btrieve マニュアル
等で調査してください。
VE1078 フィールド数が多いのでフォー DDF のテーブルに定義されたフィール
ムを作成しても VB で利用できません。 ド数が 254 個を越えているので、フォー
(VB5/4 では最大 254 コントロール/For ムを生成しても Visual Basic で入力画
面として利用することが出来ません。フ
m)
224
VE1079 dbMagic 情報ファイルに FILE=
の行が存在しません。
ィールド数の少ないテーブルを指定して
ください。
DbMagic データ辞書ファイルの軽視 k
いが不正です。データ辞書ファイルの
搬出結果を確認してください。
225
226
Btrieve ステータス・コード
以下に Btrieve のステータス・コードと概要を記述します。この VBMan Controls
for Btrieve のマニュアルが記述された時点の情報であることに注意してくださ
い。将来のコンパチビリティについては当社では保証できません。詳細は Btriev
e の開発キットのマニュアルまたは、ノベルの NetWare の「Btrieve インストー
ル・オペレーション」マニュアルなどに記載があります。
2 I/O ERROR
3 File not opened
4 Key Value not found
5 Duplicate key value
6 Invalid key number
7 Different key number
8 Invalid Positioning
9 End of file
10 Modifiable Key value error
11 invalid file name
12 file not found
13 Extended file error
14 Pre-Image open error
15 Pre-Image I/O error
16 Expansion error
17 Close error
18 Disk Full
19 Unrecoverable error
20 Record Manager Inactive
21 Key Buffer Error
22 Key Buffer Error
23 Position Block Error
24 Page Size Error
25 Create I/O Error
227
26 Number of Keys
27 Key Position
28 Record Length
29 Key Length
30 Btrieve file name
31 Extended Error
32 Extended I/O error
34 Extend Name
35 Directory Error
37 Begin Transaction error
38 Transaction Control File
39 End/Abort Error
40 Transaction Max Files
41 Operation not allowed
42 Incomplete accelerated access
43 Invalid data record address
44 Null key path
45 Inconsistent Key flags
46 Access denied
47 Maximum open files
48 Invalid Alternate sequence definition
49 Key type error
50 Owner already set
51 Invalid Owner
52 Error Writing cache
53 Invalid Interface
54 Variable Page Unreadable
55 Autoincrement error
56 Incomplete index
57 Expanded Memory Error
58 Compression buffer too short
59 File Already Exists
228
60 Reject Count Reached
61 Work space too small
62 Incorrect descriptor
63 Invalid extended insert buffer
64 Filter limit reached
65 Incorrect field offset
74 Automatic transaction abort
75 Server Routing list too small
76 File server list too small
77 Wait lock error
78 Deadlock detected
80 Conflict
81 Lock error
82 Lost position
83 Read Outside Transaction
84 Record in use
85 File in use
86 File full
87 Handle full
88 Mode Error
90 Redirected Device table full
91 Server Error
92 Transaction table full
93 Incomplete lock type
94 Permission error
95 Session no longer valid
96 Communication environment error
97 Data message too small
98 Internal transaction error
1001 Invalid lock parameter
1002 Invalid memory parameter
1003 Insufficent memory for parameters specified
229
1004 Invalid page size parameter
1005 Invalid pre-image device parameter
1006 Invalid pre-image memory parameter
1007 Invalid file parameter
1008 Incorrect parameter
1009 Invalid transaction parameter
1010 Unable to access btrieve file for transaction recovery
1011 Invalid compression parameter
1012 Number of files in transaction should be between 1 to 18
1013 Task list is full
1014 File is open or transaction is active
1016 Already initialized
2001 Insufficent Memory
2002 Parameter Invalid or Out of Range
2003 No Local Access Allowed
2004 SPX is Not installed
2005 Wrong version of SPX Installed
2006 No Available SPX Connection
2007 Invalid Parameter
230
VBMan Controls for Btrieve 調査依頼フォーム
日付
会社名
登録ユーザー名
製品シリアル番号
VBMan Controls for Btireve
バージョン
電話番号
ファックス番号
インターネット・メール・アドレス
使用パソコン機種
OSバージョン
Btrieve/Pervasive.SQLバージョン
Visual Basic/Visual Studio.NETバージョン
お問合わせ内容、問題記述など、具体的に再現可能なようにご記入ください。
添付資料
231
VBMan Controls for Btrieve
Version 3.30
第１版
2005年11月1日第1刷発行
版権・著作 株式会社テクナレッジ
Printed In Japan
232

2014年ポリオ撲滅活動アンケート報告

会報379号 - 神戸東ロータリークラブ

RI 第 2820 地区 ロータリー財団 News

グローバル補助金：奨学金について

ブルーオーシャン戦略 - 東芝OAコンサルタント

954回例会 - 茨木西 RC - is

財団室NEWS 8月号 - 国際ロータリー第2550地区

電気回路Ⅲ - 八戸高専