PSQL ActiveX Guide...免責事項 Pervasive Software Inc. は、本ソフトウェアおよびドキュメントの使用を、利用者またはその会社に対して「現状のまま」で、かつ同梱の使用許諾契約書に記載の契約条件

Pervasive PSQL v11

ActiveX Controls GuideDeveloping Applications Using Pervasive PSQL ActiveX Controls

免責事項 Pervasive Software Inc. は、本ソフトウェアおよびドキュメントの使用を、利用者また

はその会社に対して「現状のまま」で、かつ同梱の使用許諾契約書に記載の契約条件によってのみ許諾するものです。 Pervasive Software Inc. は、いかなる場合にも本ソフ

トウェアおよび本マニュアルに記載された内容に関するその他の一切の保証を、明示的にも黙示的にも行いません。 Pervasive Software Inc. は、市場性、権利、特定の目的

に対する適合性、あるいは一連の取引業務や職業的な使用に関する問題などに対し、一切の保証を行わないことを明示するとともに、利用者およびその会社がこれに同意したものとします。

商標 Btrieve、 Client/Server in a Box、 Pervasive、 Pervasive Software および Pervasive Softwareのロゴは、 Pervasive Software Inc. の登録商標です。

Built on Pervasive Software、 DataExchange、 MicroKernel Database Engine、 MicroKernel DatabaseArchitecture、 Pervasive.SQL、 Pervasive PSQL、 Solution Network、 Ultralight、 ZDBA は PervasiveSoftware Inc. の商標です。

Microsoft、 MS-DOS、 Windows、 Windows 95、 Windows 98、 Windows NT、 Windows Me、 Windows2000、Windows 2003、Windows 2008、Windows 7、Windows 8、Windows Server 2003、Windows Server2008、 Windows Server 2012、 Windows XP、 Win32、 Win32s、および Visual Basic は、 MicrosoftCorporation の登録商標です。

NetWare および Novell は Novell, Inc. の登録商標です。

NetWare Loadable Module、 NLM、 Novell DOS、 Transaction Tracking System、 TTS は、 Novell, Inc.の商標です。

Sun、 Sun Microsystems、 Java、および Sun、 Solaris、 Java を含むすべての商標やロゴは、 SunMicrosystems の商標または登録商標です。

すべての会社名および製品名は各社の商標または登録商標です。

© Copyright 2013 Pervasive Software Inc. All rights reserved. このマニュアルの全文、一部に関わり

なく複製、複写、配布をすることは、前もって発行者の書面による同意がない限り禁止します。

本製品には、 Powerdog Industries により開発されたソフトウェアが含まれています。

© Copyright 1994 Powerdog Industries.All rights reserved. 本製品には、 KeyWorks Software により開発されたソフトウェアが含まれています。

© Copyright 2002 KeyWorks Software.All rights reserved. 本製品には、 DUNDAS SOFTWARE により開発されたソフトウェアが含まれています。

© Copyright 1997-2000 DUNDAS SOFTWARE LTD. All rights reserved. 本製品には、 Apache Software Foundation Foundation （http://www.apache.org/）により開発されたソ

フトウェアが含まれています。

本製品ではフリーソフトウェアの unixODBC Driver Manager を使用しています。これは PeterHarvey （[email protected]）によって作成され、 Nick Gorham （[email protected]）によ

り変更および拡張されたものに Pervasive Software が一部修正を加えたものです。 PervasiveSoftware は、 unixODBC Driver Manager プロジェクトの LGPL 使用許諾契約書に従って、このプ

ロジェクトの現在の保守管理者にそのコード変更を提供します。 unixODBC Driver Manager のWeb ページは www.unixodbc.org にあります。このプロジェクトに関する詳細については、現在

の保守管理者である Nick Gorham （[email protected]）にお問い合せください。

GNU Lesser General Public License （LGPL）は本製品の配布メディアに含まれています。 LGPL はwww.fsf.org/licensing/licenses/lgpl.html でも見ることができます。

ActiveX Controls Guide2014 年 5 月

目次

このマニュアルについて . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxiiiこのマニュアルの読者 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxivこのマニュアルの構成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxv表記上の規則 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxvi

1 ActiveX の概要 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1ActiveX アクセス方法の概要 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

開発環境 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2サードパーティデータバウンドコントロール . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2ActiveX コントロールオブジェクト . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

ActiveX アクセス方法の選択 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4ActiveX アクセス方法を利用するとき . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

ActiveX アクセス方法の主要な機能 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5VB 内のデータアウェアコントロールのデータソース . . . . . . . . . . . . . . . . . . . . . . . 5フィールドレベルアクセス . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5プロパティおよびメソッドインターフェイス . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5Extended オペレーション . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5DDF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5ActiveX DDF アクセスメソッド . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5リモートデータアクセス . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5結合テーブル . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

ActiveX アクセス方法では使用できない Pervasive PSQL 機能 . . . . . . . . . . . . . . . . . . . . . . . 7SQL 構文 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7チャンクオペレーション、非常に大きなレコード . . . . . . . . . . . . . . . . . . . . . . . . . . 7複数の ACS を使用するファイルの作成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7データ型 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7URI 構文 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

ActiveX コントロールを使用する初の手順 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8Pervasive PSQL Control Center を使用してデータベースを作成する . . . . . . . . . . . . . . . . . 8Visual Basic と Delphi への ActiveX アクセス方法のインポート . . . . . . . . . . . . . . . . . . . 8

2 ActiveX クイックスタート . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11ActiveX で使用されるファイルとディレクトリ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

ActiveX アクセス方法を使用したアプリケーションの作成 . . . . . . . . . . . . . . . . . . . . . . . . . 13プロジェクトへの ActiveX アクセス方法の追加 . . . . . . . . . . . . . . . . . . . . . . . . . . . 13VAccess コントロールの使用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13プロパティへのアクセス . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14プロパティの設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15Pervasive PSQL ファイルへの接続 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16インデックスの選択 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17自動と手動のファイルオープンの設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18例 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18データソースへのバウンドコントロールのリンク . . . . . . . . . . . . . . . . . . . . . . . . . 19レコードの取得 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

iii

目次

例 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19特定のレコードの検索 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20例 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20レコードの追加、更新および削除 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21例 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21レコードのロック . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21例 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22ファイルの結合 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22Extended オペレーションの有効化 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

Pervasive PSQL ActiveX ファイルの配布と登録 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

ActiveX アクセス方法に関する追加情報 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

3 ActiveX でのデータ辞書メソッドの使用 . . . . . . . . . . . . . . . . . . . . . . 29ActiveX データソースコントロールによる DDF の処理 . . . . . . . . . . . . . . . . . . . . . . . . . . 30

ファイルの内容とメモリイメージ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

辞書ファイルの読み取り . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

辞書ファイルの変更 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

テーブル定義の作成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

辞書の作成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

データファイルの変更 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

その他の DDF 操作 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40オーナーネームによる DDF の保護 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40既存のフィールドとインデックス情報の削除 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40永続的な DDF メモリイメージによるコメントの強制設定 . . . . . . . . . . . . . . . . . . . . . 40広範囲に影響が及ぶ ActiveX メソッド . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

4 ActiveX コントロールリファレンス . . . . . . . . . . . . . . . . . . . . . . . . 41VAccess データソース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42カスタムプロパティ、メソッドおよびイベント . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

VACheck . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44カスタムプロパティとメソッド . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

VACombo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45


VACommand . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46カスタムプロパティ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

VAHScroll と VAVScroll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

iv

目次

カスタムプロパティ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

VAList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48


VAOption . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49


VAText . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50


5 カテゴリ別プロパティ、メソッド、およびイベント . . . . . . . . . . . . . . . . 51ActiveX のプロパティ、メソッド、およびイベントの概要 . . . . . . . . . . . . . . . . . . . . . . . . . 52

レコードセットの取得 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53プロパティとメソッド . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53イベント . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

ファイルの処理 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55プロパティとメソッド . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

データ辞書メソッド . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56プロパティとメソッド . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

レコード内のフィールドへのアクセス . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58プロパティとメソッド . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

レコードの挿入、更新、および削除 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59プロパティとメソッド . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59イベント . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

個別レコードの取得 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60プロパティとメソッド . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60イベント . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61

適化とデバッグ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62プロパティとメソッド . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

6 ActiveX プロパティリファレンス . . . . . . . . . . . . . . . . . . . . . . . . . 63AutoDialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64関連項目 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

AutoLogon . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65関連項目 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65

AutoMode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

v

目次

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66関連項目 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

AutoOpen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67関連項目 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67

Buffer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68構文 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68例 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68関連項目 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

CacheRejectMax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70関連項目 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70

CacheRows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71関連項目 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71

CancelDialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72関連項目 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72

Column . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73関連項目 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

ColumnName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74関連項目 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74

Columns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75例 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75関連項目 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

ColumnWidth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76

vi

目次

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76関連項目 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76

CompressData . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77関連項目 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

DatabaseName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78関連項目 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78

DataLength . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79関連項目 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79

DdfKeyUseIndexDDFOnly . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80関連項目 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80

DdfPath . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81マップされたドライブ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81URL （Uniform Resource Locator） . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81UNC （Universal Naming Convention） . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81例 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82関連項目 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82

DdfTransactionMode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83関連項目 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83

ExtendedOps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84関連項目 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84

FieldList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85例 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86

vii

目次

関連項目 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86

Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87関連項目 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87

FieldValue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88


FileVersion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90

FireEvents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91

FocusSelText . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92

HostAddress . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93関連項目 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93

HostConnect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94関連項目 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94

IncludeCurrent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95関連項目 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95

IndexList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96例 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96関連項目 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97

IndexNumber . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98

viii

目次

説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98関連項目 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98

IntegralHeight . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99

Join . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100


KeyNumber . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102関連項目 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102

List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103構文 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103例 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103

Location . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104例 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104関連項目 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104

Locked . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105構文 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105

MaxBufferSize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106関連項目 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106

MaxLength . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107

OemString . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108

ix

目次

備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108

OpenMode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109関連項目 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109

OwnerName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110例 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110関連項目 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110

PageSize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111関連項目 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111

Percentage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112


Port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113

Position . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114例 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114関連項目 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114

RefreshLocations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115例 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115関連項目 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115

Row . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116例 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116関連項目 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116

RowPosition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117

x

目次

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117関連項目 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117

Rows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118例 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118関連項目 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118

SelectedFields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119例 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119関連項目 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119

SelectedRecords . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120構文 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120関連項目 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120

SessionID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121関連項目 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121

Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122関連項目 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122

TableName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123例 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123関連項目 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123

TimeOutVal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124

TotalRecords . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125例 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125関連項目 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125

Uppercase . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126

xi

目次

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126

VAccessName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127

VAAutoScroll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128

VADataType . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129

VADebugMode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130

VADecimal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131

VAErrorDialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132

VAFieldName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133

VAFormat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134例 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135

VALockBias . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136

VAOffset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137

VAOperation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138

xii

目次

説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138

VARecordList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139

VASearch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140

VASize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141

VAValueFalse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142

VAValueTrue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143

7 ActiveX メソッドリファレンス . . . . . . . . . . . . . . . . . . . . . . . . . . 145AboutBox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146

AddItem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147構文 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147例 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147

Btrv . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148構文 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148例 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149

Clear . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150構文 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150例 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150

Close . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151

xiii

目次

構文 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151例 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151

DdfAddIndex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152構文 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152戻り値 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152関連項目 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152

DdfAddTable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153構文 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153戻り値 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153例 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153関連項目 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153

DdfAddTableName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154


DdfClearFields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155


DdfClearIndexes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156


DdfCreateDictionary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157


xiv

目次

DdfCreateTable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158


DdfDropIndex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159


DdfDropIndexMaintain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161


DdfDropTable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162


DdfGetFieldComments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163


DdfModifyLocation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164


DdfModifyTableName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165

xv

目次


DdfSetOwner . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166構文 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166例 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166

DdfTestOwnerName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168


Delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169構文 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169例 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169

FormatFieldValue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170


GetDirect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171構文 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171

GetEqual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172構文 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172例 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172

GetFirst . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173構文 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173

xvi

目次

備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173例 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173

GetGreater . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174構文 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174例 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174

GetGreaterOrEqual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176構文 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176例 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176

GetLast . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177構文 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177例 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177

GetLess . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178構文 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178

GetLessOrEqual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179構文 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179

GetNext . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180構文 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180例 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180

GetNextExtended . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181構文 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181例 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181

GetPrevious . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183構文 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183

xvii

目次

GetPreviousExtended . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184構文 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184

GetTableList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185


GetTotalSegments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186構文 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186例 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186

Init . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187構文 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187例 #1 - Automode = True . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187例 #2 - Automode = False . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187

Insert . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188構文 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188例 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188

Open . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189構文 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189例 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189

Refresh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190構文 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190例 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190

RemoveItem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191構文 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191

xviii

目次

RowColumnValue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192構文 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192例 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192

SetFileFlag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193構文 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193例 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193

SetOwner . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194構文 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194関連項目 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194

ShowSelectedFieldsDlg . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195構文 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195例 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195

ShowSelectedRecordsDlg . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196構文 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196例 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196

Stat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197構文 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197戻り値 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197

StatusDialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198構文 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198例 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198

StepFirst . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199構文 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199

StepLast . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200

xix

目次

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200構文 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200

StepNext . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201構文 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201

StepNextExtended . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202構文 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202

StepPrevious . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203構文 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203

StepPreviousExtended . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204構文 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204

Transaction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205構文 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205例 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206

Unlock . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207構文 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207

Update . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208構文 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208例 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208

8 ActiveX イベントリファレンス . . . . . . . . . . . . . . . . . . . . . . . . . . 209CommError . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210構文 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210

xx

目次

備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210

Logon . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211構文 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211

OnRemote . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212構文 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212関連項目 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212

Reposition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213構文 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213

Validate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214

適用対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214構文 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214備考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214

xxi

目次

xxii

このマニュアルについて

このマニュアルでは、 Pervasive PSQL 用 ActiveX コントロールを使用した Pervasive PSQL アプリケーション開発

について説明します。

xxiii

このマニュアルの読者

このマニュアルは、Pervasive PSQL に精通し、Pervasive PSQL 用 ActiveX コントロールを使用して Pervasive PSQLアプリケーションを開発するユーザーを対象としています。

xxiv

このマニュアルの構成

『ActiveX Control's Guide』は、以下のセクションに分かれています。

第 1 章「ActiveX の概要」

この章では、 Pervasive PSQL 用の ActiveX コントロールの概要を示し、新しい ActiveX バージョンの主な拡

張機能について説明します。

第 2 章「ActiveX クイックスタート」

この章には、 Pervasive PSQL SDK と共にインストールされる ActiveX ファイルとその場所を示す表、および

Pervasive PSQL 用 ActiveX コントロールを使用する基本的な作業についての説明が含まれています。 ActiveXコントロールについてのほかの情報源の一覧も含まれています。

第 3 章「ActiveX でのデータ辞書メソッドの使用」

この章では、 DDF ファイルの作成、読み取りおよび変更で使用するメソッドについて説明します。

第 4 章「ActiveX コントロールリファレンス」

この章では、 ActiveX をサポートするアプリケーションが Pervasive PSQL のデータにアクセスできるように

するカスタムコントロールについて説明します。

第 5 章「カテゴリ別プロパティ、メソッド、およびイベント」

この章では、 Pervasive PSQL 用 ActiveX コントロールに固有のプロパティ、メソッド、およびイベントすべ

てを一覧にしてあります。

第 6 章「ActiveX プロパティリファレンス」

この章では、カスタムコントロールのプロパティについて説明します。

第 7 章「ActiveX メソッドリファレンス」

この章では、カスタムコントロールに適用されるメソッドの説明と構文について説明します。

第 8 章「ActiveX イベントリファレンス」

この章では、カスタムコントロールに適用されるイベントについて説明します。

xxv

表記上の規則

特段の記述がない限り、コマンド構文、コード、およびコード例では、以下の表記が使用されます。

大文字小文字の

区別

通常、コマンドと予約語は、大文字で表記されます。 Linuxを使用しているか本書で別途記述がない限り、これらの項目

は大文字、小文字、あるいはその両方を使って入力できま

す。たとえば、 MYPROG、 myprog、または MYprog と入力

することができます。

太字太字で表示される単語には次のようなものがあります。メ

ニュー名、ダイアログボックス名、コマンド、オプション、

ボタン、ステートメントなど。

固定幅フォント固定幅フォントは、コマンド構文など、ユーザーが入力する

テキストに使われます。

[ ] 省略可能な情報には、［log_name］のように、角かっこが使

用されます。角かっこで囲まれていない情報は必ず指定する

必要があります。

| 縦棒は、［file name ｜ @file name］のように、入力する情報

の選択肢を表します。

< > ＜＞は、 /D=<5|6|7> のように、必須項目に対する選択肢

を表します。

変数 file name のように斜体で表されている語は、適切な値に置き

換える必要のある変数です。

. . . ［parameter. . .］のように、情報の後に省略記号が続く場合は、

その情報を繰り返し使用できます。

::= 記号 ::= は、ある項目が別の項目用語で定義されていること

を意味します。たとえば、 a::=b は、項目 a が b で定義され

ていることを意味します。

xxvi

1
ActiveX の概要
この章では、 Pervasive の ActiveX アクセス方法について説明します。以下の項目が含まれます。

「ActiveX アクセス方法の概要」

「ActiveX アクセス方法の選択」

「ActiveX アクセス方法の主要な機能」

「ActiveX アクセス方法では使用できない Pervasive PSQL 機能」

「ActiveX コントロールを使用する初の手順」

1

ActiveX の概要

ActiveX アクセス方法の概要

Pervasive ActiveX のアクセス方法は、 ActiveX をサポートする開発環境で Btrieve データに簡単にアクセスできる

ようにする 9 個のカスタムコントロールから構成されています。このインターフェイスには、 1 個のデータソー

スコントロールと 8 個のバウンドデータコントロールが組み込まれています。

Pervasive PSQL データソースコントロールは、アプリケーションと Btrieve データファイル間の接続点を提供し

ます。このデータコントロールはほかのデータアウェアコントロールのデータソースの役割を果たすほか、ファ

イルのオープン、クローズおよび作成や、レコードの検索、更新および削除など、アプリケーション内のコード

からデータにアクセスする際に使用できるプロパティ、メソッド、イベントを公開します。

Pervasive PSQL バウンドコントロールはデータソースコントロールに接続する必要があるもので、これらには

データアウェアテキストボックス、リストボックス、コンボボックス、チェックボックス、オプションボタ

ンの各コントロールが含まれています。リストボックスコントロールとコンボボックスコントロールは、フィー

ルドバウンドコントロールまたは複数列レコードリストコントロールとして動作します。コマンドボタンと水

平および垂直スクロールバーコントロールで、インデックスレコードのスクロール操作を行います。

Microsoft Visual Basic では、 Pervasive PSQL データソースコントロールは、データアウェア Visual Basic コント

ロール用およびサードパーティデータアウェア ActiveX コントロール用のレコードソースの役割も果たすこと

ができます。

ここでは、以下の項目について説明します。

「開発環境」

「サードパーティデータバウンドコントロール」

「ActiveX コントロールオブジェクト」

開発環境

ActiveX のアクセス方法は以下の環境をサポートします。

Visual Basic 5.0 以降

Delphi 3.0 以降

Visual C++ 5.0 以降

Embarcadero C++ Builder 3.0 以降

メモほかの開発環境やアプリケーションの中には、ActiveX コントロールの拡張機能もサポートするものが

あります。ただし、 Pervasive Software では、上に示したプログラミング環境、言語またはアプリケーション

以外での ActiveX アクセス方法のテストは行っておりません。

サードパーティデータバウンドコントロール

Pervasive の ActiveX アクセス方法は、 Sheridan、 APEX、 GreenTree および Microsoft のコントロールからデータを

バインドできます。 Pervasive Software では、 Pervasive の ActiveX アクセス方法に書式設定機能やプレゼンテー

ション機能がないときだけこれらのサードパーティ製品を使用するようにお勧めしています。

Pervasive Software ではサードパーティソフトウェアの開発を制御することはできません。したがって、これらの

コントロールの機能をすべてサポートするわけではありません。同じ理由から、これらの製品のテクニカルサポートを行っておりません。

メモサードパーティデータアウェアコントロールへのデータバインドは、 Microsoft Visual Basic 以外の環

境ではサポートされません。

2

ActiveX アクセス方法の概要

ActiveX コントロールオブジェクト

以下の表に、 ActiveX アクセス方法に組み込まれている ActiveX コントロールオブジェクトを示します。

表 1 組み込まれている ActiveX コントロールオブジェクト

アイコンコントロール説明

VAccess データソースコントロールはアプリケーションのソースコードを提供して、 PervasivePSQL バウンドコントロールがデータファイルにアクセスできるようにします。

VACheckBox チェックボックスをブール（True/False）型のフィールドにバインドできます。

VAComboBox データバウンドコンボボックスをレコード内の 1 つのフィールドにバインドすると、そ

のフィールドの値を所定の値の中から選択できます。このコンボボックスは、レコード

リストコントロールや使用可能なインデックスフィールドのリストとしても機能しま

す。

VACommandButton データバウンドコマンドボタンでは、レコードの取得、更新、または削除の操作を行え

ます。

VAHScrollBar

VAVScrollBar

データバウンドスクロールバーを使用すると、インデックスパスに沿ってレコード内

をスキャンできます。

VAListBox リストボックスコントロールを使用すると、所定の値セットの中からフィールドの値を

選択できます。このコントロールは、複数列のレコードリストコントロールとしても機

能します。

VAOptionButton オプションボタンをブール（True/False）型のフィールドにバインドできます。

VATextBox データアウェアテキストボックスでは、あらゆるフィールドの変更を受け入れ、自動的

に表示できます。また、このボックスを検索モードで使用すると、テキストが入力され

るにつれて、ファイルから一致するレコードを捜し出すことができます。

3

ActiveX の概要

ActiveX アクセス方法の選択

ActiveX は Microsoft の商標用語で、 Windows OLE （オブジェクトのリンクと埋め込み）カスタムコントロールを

示します。ActiveX は当初 Microsoft Visual Basic 言語の拡張機能として開発されたもので、その後すぐに、Microsoftのほかの言語製品や、インターネットエクスプローラーなどのほかのアプリケーションへ導入されました。

ActiveX コントロールをサポートする言語またはプログラミング環境で Windows アプリケーションを作成する場

合は、以下のような一般的には難しい、エラーを起こしやすいデータアクセスの作業の多くを Pervasive ActiveXアクセス方法で処理できます。

ファイルの作成（Create）および Extended オペレーションにおけるバッファーの設定と使用

データ変換およびフィールドレベルのアクセスの提供

ファイル間のインデックス付き結合の保守

Microsoft Visual Basic では、これらのコントロールは Visual Basic のテキストボックスコントロールとリストボッ

クスコントロール、 APEX および Sheridan のグリッドコントロール、その他のデータアウェアオブジェクトの

データに対するシームレスなアクセスも実現します。

Visual Basic のほか、 Microsoft Visual C/C++、 Embarcadero Delphi、 C++ Builder などの多数のプログラミング環境

も、 ActiveX コントロールをサポートします。ただし、 Microsoft Visual Basic データバインドは Visual Basic 以外

ではサポートされません。これらの言語で ActiveX アクセス方法を使用する予定であり、アプリケーションがテ

キストボックス、リストボックス、グリッドなどのユーザーインターフェイスオブジェクトを必要とする場合

は、 Pervasive PSQL SDK ActiveX アクセス方法に用意されている Pervasive データバウンドコンロールを使用す

るか、アプリケーションコード内でこれらへのデータバインドを実装する必要があります。

ActiveX アクセス方法を利用するとき

Pervasive ActiveX アクセス方法は、 SQL アクセスやデータベース抽象化よりデータベースのパフォーマンスが重

要であるアプリケーションで、 ODBC インターフェイスの代替として使用できます。このインターフェイスは同

じ基本的なデータサービスの多くを提供しますが、リレーショナル（SQL）でなくトランザクショナル（Btrieve）データモデルを使用します。

4

ActiveX アクセス方法の主要な機能

ActiveX アクセス方法の主要な機能

Pervasive ActiveX アクセス方法には、 Pervasive PSQL でのアプリケーション開発を容易にする主要な機能が数多

くあります。

VB 内のデータアウェアコントロールのデータソース

Apex TrueGrid グリッドコントロールや Sheridan Data Widgets のようなサードパーティコントロールなど、VisualBasic 内のほかのデータアウェアコントロールで、 Pervasive ActiveX アクセス方法をデータソースとして使用で

きます。 Pervasive バウンドコントロールは、 Visual Basic 環境やその他の開発環境で使用できます。

フィールドレベルアクセス

ActiveX アクセス方法では、データ辞書ファイル（DDF）を使用して Pervasive PSQL データにフィールドレベル

でアクセスします。フィールドは、名前または序数で参照できます。 LVAR 以外の Pervasive PSQL フィールド

データ型はすべてサポートされます。

プロパティおよびメソッドインターフェイス

ActiveX アクセス方法は、コントロールオブジェクトのほかに、プログラミングの利便性と柔軟性を高めるため

の多数のプロパティとメソッドを提供します。これらのプロパティとメソッドを使用すると、大量のコードを記

述せずに多数の Pervasive PSQL オペレーションを設定および実行できます。また、 Pervasive PSQL バウンドコン

トロール、プログラミング環境またはその他のサードパーティコントロールとの対話処理を通じ、コードによっ

てデータを処理できます。

Extended オペレーション

Pervasive の ActiveX アクセス方法は、クライアント / サーバーレコードセットのキャッシュ、フィールドの選

択、レコードのフィルター処理などの機能を提供する Pervasive PSQL Extended オペレーションの使用を簡単にし

ます。

Extended オペレーションには、集中管理されているデータベースに対して分散アプリケーションを実行する際の

ネットワークトラフィックを小限にしてパフォーマンスを向上させ、グリッドコントロールやレコードリス

トなどの複数行オブジェクトの実装を容易にする機能があります。

DDFActiveX アクセス方法は ODBC インターフェイスと同様に、DDF を必要とします。DDF ファイルとデータベース

にアクセスするには、 Pervasive PSQL Control Center を使用します。

Pervasive PSQL Control Center の詳細については、『Pervasive PSQL User's Guide』または Pervasive PSQL ControlCenter のオンラインヘルプを参照してください。

ActiveX DDF アクセスメソッド

データソースには、アプリケーションコード内から DDF 情報にアクセスする手段があります。

リモートデータアクセス

ActiveX アクセス方法を使用すると、ワークステーションやクライアント / サーバーオプション以外にも、 URIを使って Pervasive PSQL データにアクセスできます。

5

ActiveX の概要

結合テーブル

VAccess コントロールの Join プロパティを使用すると、 2 つのファイルをキー値でリンクし、第 1 のファイルの

レコード位置の変更が、第 2 のファイルから検索されたレコードにも反映されるように指定することができます。

Join プロパティは、リレーショナルデータベースを参照するための簡単な機能を提供します。

6

ActiveX アクセス方法では使用できない Pervasive PSQL 機能

ActiveX アクセス方法では使用できない Pervasive PSQL 機能

以下の機能は Pervasive PSQL の一部ですが、 ActiveX アクセス方法ではサポートされません。

SQL 構文

ActiveX アクセス方法は、Pervasive PSQL データベースにトランザクショナルインターフェイスを公開します。こ

のインターフェイスはリレーショナルモデルインターフェイスを公開せず、 SQL クエリ処理機能がありません。

チャンクオペレーション、非常に大きなレコード

Pervasive ActiveX アクセス方法は、 Pervasive PSQL Chunk オペレーションプリミティブをサポートしません。

ActiveX アクセス方法でサポートされる大レコードサイズは、データ辞書の限界により決まります。固定レコー

ド長の限界は 4 KB であり、固定長と可変長を組み合わせた大長は 32 KB です。

複数の ACS を使用するファイルの作成

ActiveX アクセス方法は、複数のオルタネートコレーティングシーケンス（ACS）を持つ新規テーブルを作成す

るインターフェイスを公開しません。ただし、 ActiveX アクセス方法はこれらのインデックスを使用するテーブ

ルでインデックスを正しく照合します。

データ型

次の Pervasive PSQL データ型は ActiveX アクセス方法ではサポートされません。

LONGVARCHAR

LONGVARBINARY

URI 構文

Pervasive ActiveX では HostAddress プロパティおよび DatabaseName プロパティを使って、リモートマシン

に接続するための URI を作成します。ただし、コードからすべての URI 構文パラメーターを指定することはでき

ません。データベースがセキュリティで保護されている場合は、ActiveX コントロールは prompt=yes パラメーター

を使用することにより、ユーザーに資格情報を要求するよう、トランザクショナルインターフェイスに指示しま

す。

7

ActiveX の概要

ActiveX コントロールを使用する最初の手順

ここでは、 Pervasive PSQL で処理をすばやく開始する方法を示します。このセクションの作業を実行すれば、

Pervasive PSQL アプリケーションの開発を順調に進めることができるでしょう。

Pervasive PSQL Control Center を使用してデータベースを作成する

Pervasive の Active X インターフェイスを開発ツールにインポートする（Visual Basic と Delphi の説明）

Pervasive PSQL Control Center を使用してデータベースを作成する

Pervasive PSQL データベースを作成するも簡単な方法は、 Pervasive PSQL Control Center を使用することです。

これは Windows の［スタート］メニューから開くことができます。既存の Btrieve ファイルにリレーショナル機

能を追加するか、新しいデータベースを作成できます。このデータベースは、ほかのアプリケーションで Btrieveデータにアクセスできるように標準データ辞書ファイル（DDF）を作成します。

『Pervasive PSQL User's Guide』にはデータベースの作成方法のチュートリアルが含まれており、『AdvancedOperations Guide』には既存の Btrieve ファイルに DDF を作成する方法のチュートリアルが含まれています。

『Pervasive PSQL User's Guide』には、リレーショナル機能（FILE.DDF、 INDEX.DDF および FIELD.DDF）による

新しいデータベースの作成を順を追ってすばやく行えるようにするための説明が記載されています。

Visual Basic と Delphi への ActiveX アクセス方法のインポート

以下の手順では ActiveX コントロールを IDE にインポートする方法を示します。

Visual Basic

Visual Basic プロジェクトに ActiveX コントロールをインポートするには

1 メニューバーから［プロジェクト］を選択します。

2 ［プロジェクト］ドロップダウンメニューから［コンポーネント］を選択します。

3 ［コンポーネント］ダイアログボックスから［コントロール］タブを選択します。

4 ［Pervasive ActiveX Data Source］および［Pervasive Bound Controls］オプションを選択します。

5 ［OK］をクリックします。

8

ActiveX コントロールを使用する最初の手順

Delphi

ActiveX コントロールを Delphi へインポートするには

1 ［コンポーネント］メニューから［ActiveX コントロールの取り込み］を選択します。［ActiveX の取り込み］

ダイアログボックスが表示されます。

図 1 ActiveX の取り込みダイアログボックス（Delphi）

2 ［Pervasive ActiveX Data Source］を選択した後、［インストール］をクリックします。

3 次に、バウンドコントロールをインポートする必要があります。［ActiveX の取り込み］ダイアログボック

スで［Pervasive Bound Controls］を選択し、［インストール］をクリックします。

これで青い ActiveX コントロールアイコンが Delphi コンポーネントパレット［ActiveX］ページに表示され

ます。

9

ActiveX の概要

10

2
ActiveX クイックスタート
この章では、 Pervasive の ActiveX アクセス方法に付属するファイルの Pervasive PSQL ディレクトリ構造を示すほ

か、コントロールを使用するアプリケーションの開発に関わる基本的作業手順について説明します。この章では、

以下の項目について説明します。

「ActiveX で使用されるファイルとディレクトリ」

「ActiveX アクセス方法を使用したアプリケーションの作成」

主な作業のリストについては、上記のセクションを参照してください。

「Pervasive PSQL ActiveX ファイルの配布と登録」

「ActiveX アクセス方法に関する追加情報」

11


ActiveX で使用されるファイルとディレクトリ

Pervasive の ActiveX アクセス方法のファイルとディレクトリを表 2 に示します。この表では、 Pervasive PSQL がデフォルトの場所にインストールされていることを前提としています。 Pervasive PSQL ファイルのデフォルトの

保存場所については、『Getting Started with Pervasive PSQL』の「Pervasive PSQL ファイルはどこにインストールさ

れますか？」を参照してください。

アプリケーションの実装に必要なファイルについては、「Pervasive PSQL ActiveX ファイルの配布と登録」を参照

してください。

表 2 ActiveX アクセス方法ファイル

ファイル場所説明

ACBTR732.OCX file_path\PSQL\bin\ Pervasive PSQL データソースコントロール

ACCTR732.OCX file_path\PSQL\bin\ Pervasive PSQL バウンドコントロール

*.DDF、 *.MKD C:\Documents and Settings\All Users\Application Data\Pervasive Software\PSQL\Demodata

または

C:\ProgramData\Pervasive Software\PSQL\Demodata

データ辞書ファイル（.DDF）と MicroKernelエンジンのテーブル（.MKD ファイル）

readme_activex.htm file_path\PSQL\Docs リリースノート情報

PSQL.JAR file_path\PSQL\bin\ Pervasive Java アクセスライブラリ用 JARファイル

12

ActiveX アクセス方法を使用したアプリケーションの作成


ここでは、 ActiveX アクセス方法を使用したアプリケーションの作成に関連する主な作業を行う方法について説

明します。作業項目は以下のとおりです。

「プロジェクトへの ActiveX アクセス方法の追加」

「VAccess コントロールの使用」

「プロパティへのアクセス」

「プロパティの設定」

「Pervasive PSQL ファイルへの接続」

「インデックスの選択」

「自動と手動のファイルオープンの設定」

「データソースへのバウンドコントロールのリンク」

「レコードの取得」

「特定のレコードの検索」

「レコードの追加、更新および削除」

「レコードのロック」

「ファイルの結合」

「Extended オペレーションの有効化」

プロジェクトへの ActiveX アクセス方法の追加

Pervasive の ActiveX アクセス方法のデータソースとバウンドコントロールを Visual Basic プロジェクトに

追加するには

1 ［プロジェクト］メニューから［コンポーネント］を選択します（または、ツールボックスを右クリックし、

［コンポーネント］を選択します）。

2 コントロールリスト内をスクロールし、［Pervasive ActiveX Data Source］と［Pervasive Bound Controls］チェッ

クボックスを選択します。

3 ［OK］をクリックします。

ツールボックスに青色の Pervasive ActiveX アイコンが表示されます。

VAccess コントロールの使用

VAccess コントロールはデータをポイントするもので、ほかすべての Pervasive PSQL コントロールがバインドす

るマスターコントロールです。このコントロールは、 Pervasive PSQL とのすべての通信を処理します。

13


Visual Basic フォームにデータソースコントロールを追加するには

1 Pervasive PSQL ActiveX コントロールを含んでいる Visual Basic のツールボックスをクリックします。

2 VAccess コントロールアイコンをクリックします。

3 フォームにカーソルを置いてドラッグし、コントロールを保持するための四角形を作成します。マウスを離

すと、四角形の中に ActiveX アクセス方法が表示されます。このコントロールは、設計時にはアイコンとし

て表示されますが、実行時には表示されません。

また、 Pervasive PSQL の起動画面には、 Pervasive PSQL ワークステーションエンジンが起動されたことが表

示されます。

4 デフォルトでは、フォームに配置する初の VAccess コントロールには VAccess1 という名前が付きます。必

要であれば、 Name プロパティに新しい名前を入力してこの名前を変更できます。

次に、この VAccess コントロールのプロパティを設定する必要があります。「プロパティへのアクセス」、「プロ

パティの設定」、および「Pervasive PSQL ファイルへの接続」をお読みください。

プロパティへのアクセス

コントロールのプロパティは次の 3 つの場所で設定できます。

プロパティページダイアログボックス

Visual Basic のプロパティウィンドウ

Visual Basic コードエディター

プロパティページ

コントロールを右クリックし、ショートカットメニューから［プロパティ］を選択すると、プロパティページが

表示されます。これは、コントロールの Pervasive PSQL ActiveX プロパティを設定できるタブ付きのダイアログ

ボックスです。詳細については、図 2 を参照してください。

図 2 プロパティページダイアログボックス

14


Visual Basic のプロパティウィンドウ

Visual Basic のプロパティウィンドウには、 Visual Basic に固有のプロパティなど、選択したオブジェクトのすべ

てのプロパティセットが表示されます。図 3 を参照してください。

図 3 VAccess プロパティを表示するプロパティウィンドウ

Visual Basic コードエディター

フォームまたはコントロールをダブルクリックすると、 Visual Basic のコードエディターが開きます。コードエディターの使用方法については、Visual Basic のマニュアルを参照してください。各プロパティの構文などの詳細

については、本マニュアルを参照してください。

プロパティの設定

コントロールのプロパティを設定するには

1 プロパティを設定するコントロールを選択します。

15


2 プロパティページ、 Visual Basic プロパティウィンドウまたはコードエディターで変更するプロパティを検

索します。プロパティへのアクセスについては、「プロパティへのアクセス」を参照してください。

3 追加または変更する各プロパティの値を設定するには、テキストボックスにその値を入力するか、フィール

ドをクリックしたときに表示されるドロップダウンリストから値を選択するか、あるいは、値の設定が行え

るダイアログボックスを呼び出す省略記号をクリックします。

メモプロパティには、設計時または実行時に設定できるものと、設計時または実行時にしか設定できない

ものがあります。

Pervasive PSQL ファイルへの接続

VAccess コントロールには、このコントロールを Pervasive PSQL データファイルへ接続するための重要なプロパ

ティとして、 DdfPath、 TableName および Location という 3 つのプロパティがあります。これらのプロパティに

アクセスするも簡単な方法は、コントロールを右クリックしてショートカットメニューから［プロパティ］を

選択したときに表示されるプロパティページからアクセスする方法です。プロパティウィンドウからも、これら

のプロパティにアクセスできます。

図 4 データに接続するためのプロパティの設定

データに接続するための 3 つの重要なプロパティを以下に示します。

DdfPath －このプロパティは、 VAccess コントロールで使用する DDF （データ辞書ファイル）の位置を決定

します。プロパティには、 DDF が置かれている有効なドライブとパスが含まれていなければなりません。

TableName －このプロパティは、DDF のどのテーブル（データファイル）が VAccess コントロールで使用さ

れるかを決定します。DdfPath で指定された DDF に含まれている有効なテーブル名に設定する必要がありま

す。ドロップダウンメニューからテーブル名を選択できます。

Location －このプロパティは、どの Pervasive PSQL テーブルが VAccess コントロールで使用されるかを決定

します。FILE.DDF に含まれている Table Location に対応します。このプロパティのデフォルトは TableNameプロパティで指定されたテーブルの Table Location ですが、必要に応じてテーブルに代替パスを与えること

ができます。

データを指定するプロパティを設定するには

1 データに接続する VAccess コントロールを選択します。

2 VAccess コントロールの DdfPath を設定します。

16


3 TableName プロパティのドロップダウンメニューからテーブル名を選択します。このメニューには、手順 2で指定した DDF で使用できるテーブル名が含まれています。

この VAccess コントロールにバインドするバウンドコントロールはすべて、このテーブルを参照します。

4 手順 3 でテーブル名を選択すると、 Location プロパティはそのテーブルを含んでいる .MKD ファイルに変更

されます。

データへの接続を完了するには、 IndexNumber プロパティをアクセスしたいインデックスに設定します。

メモ実行時にコードからこれらのプロパティを設定しても、同じ順序が適用されます。

インデックスの選択

VAccess コントロールの IndexNumber プロパティは、レコード取得メソッドを呼び出すときに VAccess コント

ロールで使用されるインデックスを決定します。このインデックスは、設計時に VAccess コントロールのプロパ

ティウィンドウで設定するか、あるいは、実行時にコードで設定できます。

設計時にインデックス番号を設定するには

プロパティウィンドウでは、 IndexNumber プロパティのドロップダウンリストから値を選択してプロパティを

設定できます。

次のように、プロパティページから IndexNumber を設定することもできます。

1 インデックス番号を設定する特定の VAccess コントロールを選択します。

2 右クリックしてプロパティページダイアログボックスを開きます。

3 VAccess1 プロパティページダイアログボックスの［Settings］タブをクリックし、 IndexNumber フィール

ドをクリックします。選択したテーブルに定義されているインデックスのリストが表示されます。

4 インデックス 0 － ID を選択し、［OK］をクリックします。図 5 に設定を示します。

図 5 IndexNumber プロパティの設定

実行時にインデックス番号を設定する方法として、コードによる方法と VAComboBox コントロールによる方法

があります。

17


実行時にコードによりインデックス番号を設定するには

1 インデックスを設定する VAccess コントロールをダブルクリックします。コードエディターが呼び出されま

す。

2 以下の例に倣って、コードを入力します。

VAccess1.IndexNumber = 0 ' 初のインデックスを選択

実行時にコンボボックスでインデックス番号を設定するには

1 フォームに VAComboBox を配置して選択します。

2 VAccessName プロパティを VAccess コントロールの名前に設定し、VAFieldName プロパティを［Index List］に設定します。 VAComboBox にはファイルからインデックスのリストが自動的に設定され、このリストから

の選択によって、 VAccess コントロールで使用されるインデックスが設定されます。

自動と手動のファイルオープンの設定

VAccess コントロールは AutoOpen プロパティの設定状態に基づいて、 2 つの方法のいずれかで Pervasive PSQLデータファイルを開きます（AutoOpen は設計時のみのプロパティです）。

AutoOpen が True に設定されている場合、 VAccess コントロールは DdfPath、 TableName、および Locationプロパティの設定に基づいて、実行時にファイルがロードされるとき、そのファイルを自動的に開きます。

コントロールは、ファイルがアンロードされるときに自動的にファイルを閉じます。

AutoOpen が False に設定されている場合、コントロールは Open メソッドが呼び出されるまでファイルを

開きません。 DdfPath、 TableName および Location プロパティはプロパティウィンドウで設定するほか、

Open の前にコードで設定できます。したがって、同じ VAccess コントロールで異なる時間に異なるファイ

ルを開いたり、ファイルを選択するためにユーザー入力を受け入れることができます。 Close メソッドは、

開いているデータファイルを閉じます。

「例」も参照してください。

AutoOpen プロパティを設定するには

プロパティウィンドウで AutoOpen プロパティを設定するには、ドロップダウンリストから True または Falseを選択します。

次のように、プロパティページから AutoOpen を設定することもできます。

1 コントロールを右クリックしてプロパティページを呼び出します。

2 ［Settings］タブをクリックします。

3 AutoOpen チェックボックスを選択または選択解除します。チェックボックスを選択すると、 AutoOpen がTrue に設定されます。チェックボックスを選択解除すると、 AutoOpen が False に設定されます。

例

この例は、 AutoOpen が False に設定されている場合に、ファイルを閉じ、別のファイルを開く方法を示したも

のです。

' 現在開いているファイルを閉じる VAccess1.Close' データ辞書情報を設定する VAccess1.DdfPath = "file_path\PSQL\Demodata\" VAccess1.TableName = "Student"' ファイルを開く VAccess1.Open

18


データソースへのバウンドコントロールのリンク

VAccess コントロールをフォームに追加してプロパティを設定した後、必要なバウンドコントロールを追加し、

この VAccess コントロールにバインドすることができます。これにより、それらのバウンドコントロールは

VAccess コントロールが指定するデータにリンクされます。特定のバウンドコントロールについては、「ActiveXコントロールリファレンス」を参照してください。

8 個ある Pervasive バウンドコントロールのどれかをデータにリンクするには

1 バウンドコントロールの VAccessName プロパティを、既にデータをポイントしている VAccess データソー

スコントロールの名前に設定します。

2 VATextBox や VAOptionButton などのフィールドバウンドコントロールの場合は、 VAFieldName プロパティ

をデータソースコントロール内のフィールドのうちの 1 つの名前に設定する必要もあります。

レコードの取得

以下の 3 つの方法でレコードを取得できます。

VAHScrollBar または VAVScrollBar による方法

VACommandButton による方法

コードによる方法

スクロールバーでレコードを取得するには

1 VAHScrollBar または VAVScrollBar をフォームに追加して選択します。

2 VAccessName プロパティを使用する VAccess コントロールに設定します。

コマンドボタンでレコードを取得するには

1 フォームに VACommandButton を追加して選択します。

2 VAccessName プロパティを使用する VAccess コントロールの名前に設定し、 VAOperation プロパティを希

望の取得オペレーションに設定します。

使用可能な Pervasive PSQL オペレーションのリストについては、「VAOperation」を参照してください。

コードでレコードを取得するには

表 3 のメソッドのうちの 1 つを使用します。Get メソッドは、IndexNumber プロパティで指定されたインデッ

クスを使用します。 Step メソッドはインデックスを使用しません。

例

' 人の名前を表示' データ辞書情報を設定 'VAccess1.DdfPath = "file_path\PSQL\Demodata\" 'VAccess1.TableName = "Person"

表 3 個々のレコードを取得するためのメソッド

GetDirect GetLast StepFirst

GetEqual GetLess StepLast

GetFirst GetLessOrEqual StepNext

GetGreater GetNext StepPrevious

GetGreaterOrEqual GetPrevious

19


'VAccess1.IndexNumber = 1 (Last_Name + 'First_Name)Stat = VAccess1.GetFirstWhile Stat = 0 List1.AddItem VAccess1.FieldValue("Last_Name") _ & " " & VAccess1.FieldValue("First_Name") Stat = VAccess1.GetNextWend

特定のレコードの検索

以下の 2 つの方法で特定のレコードを検索できます。

バウンドコントロールによる方法


テキストボックスで特定のレコードを検索するには

1 フォームに VATextBox を配置します。

2 VATextBox の VASearch プロパティを True に設定します。これにより、テキストボックスにテキストが入

力されると、一致するレコードを取得するために VAccess コントロールで GetGreaterOrEqual メソッドが実

行されるようになります。

コードで特定のレコードを取得するには

1 VAccess コントロールをダブルクリックします。

2 IndexNumber プロパティを設定して適切なインデックスを選択します。

3 FieldValue メソッドを使用して、検索する値をインデックスフィールドに設定します。複数のフィールドを

使用するインデックスの場合は、必ず各フィールドに値を代入してください。

4 次に、表 4 のメソッドのうちの 1 つを実行して目的のレコードを取得します。

5 IndexNumber プロパティが、検索が行われるフィールドに対応するインデックスに設定されていることを確

認してください。

例

' キーフィールドに検索値を入力

VAccess1.FieldValue("last_name") = "Reich"VAccess1.FieldValue("first_name") = "Steve"' 正しいインデックス番号を設定してレコードを取得VAccess1.IndexNumber = 1stat = VAccess1.GetEqualIf stat = 0 Then

MsgBox " レコードが見つかりました。 "Else

表 4 特定のレコードを取得するためのメソッド

GetEqual キーと一致する初のレコードを返します。

GetGreater キーより後の次のレコードを返します。

GetGreaterOrEqual キーレコード、またはキーより後のレコードを返します。

GetLess キーより前のレコードを返します。

GetLessOrEqual キーレコード、またはキーより前のレコードを返します。

20


MsgBox " ファイルには該当するレコードがありません。 "End If

レコードの追加、更新および削除レコードを追加、更新または削除する方法として、以下の 2 つの方法があります。

VACommandButton による方法


コマンドボタンでレコードを追加、更新または削除するには

1 フォームに VACommandButton を配置します。

2 VAccessName プロパティを対応する VAccess コントロールの名前に設定します。

3 VAOperation プロパティを希望のオペレーションに設定します。可能なオペレーションのリストについては、

本書の「プロパティリファレンス」の VAOperation プロパティを参照してください。

コードでレコードを追加、更新または削除するには

以下の VAccess コントロール用カスタムメソッドの 1 つを使用し、コードからデータベースへの書き込みを行い

ます。

例

' 指定された学生の専攻科目を変更VAccess1.TableName = "Student"VAccess1.IndexNumber = 1VAccess1.FieldValue (ID) = 2001100stat = GetEqualIf stat = 0

VAccess1.FieldValue ("Major") = "Music"VAccess1.Update

End If

レコードのロック

Pervasive PSQL には、 Pervasive の ActiveX アクセス方法でサポートされる次の 2 種類のロックがあります。単一

レコードノーウェイトロックと複数レコードノーウェイトロックです。

Pervasive の ActiveX アクセス方法でこれらのロックを適用するには、以下のアプローチのうちの 1 つを使用しま

す。

VACommandButton を使用してレコードの取得とロックを行う場合は、VALockBias プロパティを設定します。

Get または Step メソッドを呼び出すときは、オプションパラメーターとして対応するロックバイアス（単一

レコードの場合は 200、複数レコードの場合は 400）を含めます。

レコードをロック解除するには、 Unlock メソッドを使用します。

表 5 レコードを追加、更新および削除するためのカスタムメソッド

Delete 現在のレコードを削除します。

Insert メモリ内のレコードを新しいレコードとして挿入します。

Update 現在のレコードをメモリ内のレコードで更新します。

21


レコードロックと並行制御の詳細説明は、『Pervasive PSQL Programmer's Guide』で「データの整合性」を参照し

てください。

例

' レコードをロックし、学生の名前を変更して、レコードを更新するConst SINGLE_NOWAIT_LOCK = 200Const MULTIPLE_NOWAIT_LOCK = 400VAccess1.FieldValue("ID") = "<valid #>"' ロックバイアス付きのロックをかけてレコードを取得stat = VAccess1.GetEqual SINGLE_NOWAIT_LOCK' 学生の名前を変更してレコードを更新' レコードの更新によりロックが解除されるIf stat = 0

VAccess1.FieldValue("Major") = "Astronomy"VAccess1.Update

End If

ファイルの結合

VAccess コントロールの Join プロパティを使用すると、 2 つのファイルをキー値でリンクし、第 1 ファイルのレ

コード位置におけるあらゆる変更が、第 2 ファイルから取得されるレコードにも反映されるようにすることがで

きます。 Join プロパティは、リレーショナルデータベースを参照するための簡単なメカニズムを提供します。

スレーブコントロール内の結合フィールドはインデックスフィールドである必要があり、また、マスターコン

トロール内の対応するフィールドと同じ未加工データが含まれていなければなりません。マスターコントロール

内のフィールドは、インデックスである必要はありません。スレーブコントロールの IndexNumber プロパティ

は、結合に関係するインデックスに設定されたままにしておく必要があります。そうしないと、結合が断たれます。

1 対 1、多対 1、 1 対多、多対多の結合はすべてサポートされます。 VAListBox の VAccessName プロパティをス

レーブコントロールの名前に設定し、 VAFieldName プロパティを表示されるフィールドに設定することによっ

て、データをレコードリストモードで表示できます。

2 つの VAccess コントロールを結合するには

1 スレーブコントロールとする VAccess コントロールを選択します。

2 プロパティウィンドウで、［Join］ボタンをクリックして［Join Controls］ダイアログボックスを開きます。

ダイアログボックスの左側には、結合元のスレーブコントロールのテーブルとそのテーブルの選択したイン

デックスが表示されます。右側には、結合先のマスターコントロールとそのコントロールで使用できる

フィールドが表示されます。

3 マスターコントロールをスレーブコントロールのテーブルに結合するには、マスターコントロールの

フィールドをクリックします。そうすると、 Equals 列の下にフィールドが表示され、そのフィールドが結合

されていることを示します。

Extended オペレーションの有効化

Extended オペレーションを使用すると、複数のレコードに対するリクエストの処理を Pervasive PSQL トランザク

ショナルインターフェイスにさせることが可能になります。ネットワークサーバーベースの Pervasive PSQL システムでは、 Extended オペレーションによってネットワークトラフィックを大幅に削減し、データ取得を高速化

することができます。

Extended オペレーションは、複数のレコードを一度に読み取る際にも有効です。たとえば、統計データを収集

して表に記入するためにファイルをスキャンしたり、表、レポートまたはグリッドを作成するために多数のレコー

ドを一度に要求したり、必要なレコードを照合するための適切なインデックスを持たないデータベースに対する

一度限りの検索を実行するのに適しています。

Extended オペレーションは個々のレコードにアクセスするためのインデックス付きレコード取得に代わるもので

はなく、データセットを高速に取得するための強力なツールになります。

22


Extended オペレーションを使用可能にするには

1 Extended オペレーションで使用する VAccess コントロールを選択します。

2 プロパティウィンドウを使用している場合は、 ExtendedOps プロパティを True に設定します。プロパティ

ページを使用している場合は、［Extended Operations］タブをクリックし、［ExtendedOps］チェックボック

スをオンにして、［OK］をクリックします。

Pervasive の ActiveX アクセス方法は、以下の Extended Fetch メソッドをサポートします。

Get Next Extended は、現在のキーの論理位置より後続のレコードのうち、指定されたフィルター条件を満た

すレコードを取得します。

Get Previous Extended は、現在のキーの論理位置より前にあるレコードのうち、指定されたフィルター条件を

満たすレコードを取得します。

Step Next Extended は、ファイル内における物理位置より後続のレコードのうち、指定されたフィルター条件

を満たすレコードを取得します。

Step Previous Extended は、ファイル内における物理位置より前にあるレコードのうち、指定されたフィルター

条件を満たすレコードを取得します。

Init メソッドの使用

Init メソッドは、 SelectedFields または SelectedRecords プロパティを変更した後、あるいは、単一レコードの

フェッチメソッドを使ってファイル内の現在のカーソル位置を再設定してから Extended Fetch メソッドを呼び出

すまでの間に使用します。

AutoMode プロパティによるデータ「スナップショット」の構築

AutoMode を有効にすると、 VAccess データソースは選択基準を満たす行が取得されるときにそれらをすべてメ

モリにキャッシュして、データの「スナップショット」を構築できるようにします。 Row プロパティを使用して

返されたレコードセットを走査したり、 RowColumnValue メソッドを使用してレコードセット内の任意の行と

列における値を取得することができます。

AutoMode を使用するには

1 VAccess コントロールの ExtendedOps と AutoMode プロパティを True に設定して、 Extended オペレーショ

ンを使用可能にし、コントロールをオートモードに切り替えます。

2 取得するレコードセットを指定するために、コントロールの SelectedFields と SelectedRecords プロパティ

を設定します。

3 取得オペレーションごとに取得する大レコード数を CacheRows プロパティに設定します。

4 ユーザーがスキャンを終了する前にスキャンを取り消せるようにする場合は、 CancelDialog プロパティを

True に設定します。

AutoMode は環境によっては Extended オペレーションを使いやすくしますが、使用可能メモリの制限を受けます。

AutoMode を無効（デフォルト）にして、明示的な Extended Fetch メソッドの GetNextExtended、GetPreviousExtended、 StepNextExtended、または StepPreviousExtended を使用すれば、考慮したブロックで

データセットを返すことができます。

Extended Fetch メソッドの使用

Extended Fetch メソッドの GetNextExtended、 GetPreviousExtended、 StepNextExtended および

StepPreviousExtended はファイル内の現在のカーソルの位置から始まり、指定された選択基準を満たす一連の行

（レコード）と列（フィールド）を返します。 Get メソッドは、現在のインデックスを使用してインデックス順に

レコードを返します。 Step メソッドは、物理位置の順序で並べられたレコードを返します。 Step メソッドは一般

にほかのメソッドより高速なので、返されるレコードの順序が重要でない場合に使用してください。

23


特定の Extended Fetch オペレーションから返される大レコード数の設定には、いくつかのプロパティが関与し

ます。

単一の Extended Fetch オペレーションから返されるデータの総量は、 MaxBufferSize プロパティで指定する

データ通信バッファーのサイズによって制限されます。このバッファーは大 64 KB ですが、Pervasive PSQLMicroKernel データベースエンジンの設定によってはこれより小さくなります。このプロパティに大きすぎ

る値を指定すると、ステータスコード 97、「データバッファーが小さすぎます」が返されます。

SelectedFields プロパティは個々のデータ行のサイズを決定しますが、このサイズは選択されたフィールド

の記憶域の長さの合計に 6 バイトを加えた長さです。

CacheRows パラメーターは、一度に取得する大行数を指定します。Extended Fetch メソッドは、CacheRowsの値か、行のサイズと MaxBufferSize に基づいた計算値のいずれか小さい値を使用します。 CacheRows がゼロであれば、計算値が使用されます。

SelectedRecords プロパティを使用すると、ある基準を満たすレコードだけを取得できます。このプロパティ

は CacheRejectMax プロパティと結び付いて機能し、検索条件に合わないレコードをスキップします。

CacheRejectMax プロパティに値を指定しないと、Pervasive PSQL はシステムで定義された値を使用します。

次の 2 つの条件のうちの 1 つが満たされると、レコードセットが返されます。つまり、選択基準を満たす行

数が CacheRows プロパティの値に等しくなるか、あるいは、後の一致を検出して以降にスキャンされた

レコード数が CacheRejectMax プロパティの値を超えるという条件です。 Status プロパティは、いずれの条

件が満たされたかを示します。

Rows プロパティは、 Extended Fetch オペレーションから返された行数を示します。 Extended Fetch の後には

必ず、このプロパティの値をチェックしてください。オペレーションがゼロ以外のステータス（ファイルの

終わりなど）を返しても、有効なデータを返す可能性があるからです。

Columns プロパティは、 SelectedFields プロパティで指定されたフィールド数に対応するか、レコード選択

基準を指定しなかった場合は、ファイルに定義されているフィールド数に対応します。

RowColumnValue メソッドは、 Extended Fetch レコードセット内の指定された行および列の位置にある

フィールド値を取得します。

Extended Fetch オペレーション後の現在のカーソル位置は、オペレーションでスキャンされた後のレコードに対

応します。このカーソル位置は、レコード選択基準が指定されているアプリケーションでは不確定です。なぜな

ら、この位置は実際に取得された後の行を超えている可能性があるからです。

IncludeCurrent プロパティの設定によって、次の Extended Fetch オペレーションが現在のカーソル位置のレコー

ドをスキャンするか、後続のレコードから開始するかが決まります。ほとんどの場合、このプロパティを設定す

る必要はありません。このプロパティは自動的に、 Init メソッドで True に設定され、 Extended Fetch の後に Falseに設定されます。それ以降の Extended Fetch オペレーションで現在のカーソル位置のレコードを取り込むには、オ

ペレーションの直前にこのプロパティに True を設定します。

結合ファイルに対する ExtendedOps の使用

ExtendedOps プロパティは、典型的な「品目を注文するための注文ヘッダーレコード」などに見られるような、

1 対多関係の VAccess データコントロールの結合を高速化かつ単純化することができます。結合されたデータ

ソース（この例では Orderlines コントロール）に対して Extended オペレーションを有効にすると、適応するクエ

リが自動作成され、コントロールは Extended オペレーションを使って結合（Join）を実行し、結合基準に合致す

る結合ファイルから、すべてのレコードを Extended Fetch のレコードセットとして返します。

Extended Fetch の最適化

Extended Fetch オペレーションをも効率よく使用するには、まず、検索条件に合う初のレコードのできるだけ

近くにカーソルを置きます。多くの場合、まず GetEqual または GetGreaterOrEqual メソッドをインデックスと

併用して、Pervasive PSQL が必要なレコードを返すためにスキャンしなければならないレコードの範囲を制限し、

初期位置を確立してから、次に GetNextExtended を使用して後続のレコードを取得できます。

24


CacheRejectMax プロパティは、 SelectedRecords の基準で現在のインデックス上のレコードが制限される場合

に有効です。たとえば、 CacheRejectMax プロパティの値を 1 に設定すると、 Pervasive PSQL サーバープロセス

に対し、基準に合わない初のレコードを見つけたら停止するよう指示することができます。

ファイル全体をスキャンする必要があってもレコードの順序が重要でない場合は、StepFirst メソッドでファイル

の先頭にカーソルを置き、 StepNextExtended メソッドでファイルをスキャンすることによって、時間をある程

度節約できます。 Step メソッドの方が一般に高速なのは、インデックスパスに沿ってレコードを照合する必要が

ないからです。

SelectedFields プロパティに入手したいフィールドのみを指定することによっても、時間とリソースを節約でき

ます。 Extended Fetch オペレーションの制限要因はデータバッファーのサイズなので、各行に必要なメモリが少

ないほど、一度に返せる行が多くなります。

ここで、 Extended オペレーションは別のタスク、一般には Pervasive PSQL サーバープロセスで実行されるため、

アプリケーションは拡張クエリを実行するとすぐにプロセスの制御を放棄し、クエリ条件が満たされるまでもう

1 つのプロセスが制御を引き受けるということに留意してください。したがって、拡張クエリを計画し適化す

れば、アプリケーションのパフォーマンスに大きな差が出てくる可能性があります。

例

' 奨学金を受けているすべての学生の ID を出力Q = Chr$(34)' Student ID はインデックスなので、レコードの並べ替えに使用できます。' しかし、選択条件にはインデックスがありません。したがって、データベース全体を ' スキャンする必要があります。効率を上げるため、 Extended オペレーションを使用します。VAccess1.ExtendedOps = True' レコード選択条件を指定することにより、 Pervasive PSQL がサーバーで' レコードにフィルターをかけるようにできます。VAccess1.SelectedRecords = "Scholarship_Amount > " & Q & "0" & Q' 必要なのは金額と Student ID だけなので、' この情報を返すだけで、一度により多くのレコードを取得することができます。VAccess1.SelectedFields = "ID,Scholarship_Amount"' データの並べ替えは不要なので、 Step オペレーションを使用します。' Step オペレーションは物理位置に基づいているので、' データベースをも速く読むことができます。VAccess1.StepFirstVAccess1.InitDo

Stat = VAccess1.StepNextExtended' 注意： Extended フェッチは、ファイルの終わり（9）のようなステータス値を' 返しても有効なデータを返すことがあります。

For R = 1 to VAccess1.Rows List1.AddItem VAccess1.RowColumnValue(R, 1) & Chr$(9) & _ Format(VAccess1.RowColumnValue(R, 2), "Currency") Next RLoop While Stat = 0

25


Pervasive PSQL ActiveX ファイルの配布と登録

Pervasive PSQL アプリケーションの配布については、『Pervasive PSQL Programmer's Guide』の「Pervasive PSQL アプリケーションの配布」を参照してください。

次の表に、 Pervasive の ActiveX アクセス方法を使って構築されたアプリケーションの実行に必要なファイルを示

します。

Pervasive PSQL ファイルのデフォルトの保存場所については、『Getting Started with Pervasive PSQL』の「PervasivePSQL ファイルはどこにインストールされますか？」を参照してください。

Pervasive PSQL ActiveX ファイルと必要な DLL を配布した場合、 ActiveX ファイルが正しく機能するように

ActiveX ファイルを登録する必要があります。これらのファイルを登録するには次の 2 種類の方法があります。

InstallShield などの現行のインストール用ユーティリティの多くは、インストール処理中に ActiveX コント

ロールを自動的に登録するよう変更することができます（詳細については、お使いになる特定のインストー

ル用ユーティリティのマニュアルを参照してください）。

ActiveX コントロールを登録するもう 1 つの方法は、再配布可能なファイル REGSVR32.EXE をインストール

し、インストール中またはインストール後に実行する方法です。これは単純な ActiveX 登録用ユーティリティ

で、登録する ActiveX の名前をコマンドラインパラメーターとして受け取ります（たとえば、REGSVR32 C:\MyInstall\ACBTR732.OCX）。

表 6 再配布可能なファイル

ファイル場所説明

ACBTR732.OCX file_path\PSQL\bin\ Pervasive PSQL データソースコント

ロール

ACCTR732.OCX file_path\PSQL\bin\ Pervasive PSQL バウンドコントロール

PEDTCONV.DLL file_path\PSQL\bin\ データ変換用 DLL

PBTRVD32.DLL file_path\PSQL\bin\ メタデータ処理用 DLL

26

ActiveX アクセス方法に関する追加情報

ActiveX アクセス方法に関する追加情報

このマニュアルのほかにも、 ActiveX アプリケーションの開発に役立つリソースがあります。これらの項目は以

下のとおりです。

『Status Codes and Messages』－このマニュアルでは、 Pervasive PSQL のコンポーネントを使用しているときに

発生する可能性のある各ステータスコードとメッセージについて説明しています。

27


28

3
ActiveX でのデータ辞書メソッドの使用
この章では、以下の項目について説明します。

「ActiveX データソースコントロールによる DDF の処理」

「ファイルの内容とメモリイメージ」

「辞書ファイルの読み取り」

「辞書ファイルの変更」

「テーブル定義の作成」

「辞書の作成」

「データファイルの変更」

「その他の DDF 操作」

29


ActiveX データソースコントロールによる DDF の処理

データ辞書ファイル（DDF）は、 Pervasive PSQL データに対する列レベルのアクセスを行うために、 PervasivePSQL アプリケーションや多数のサードパーティアプリケーションで使用されます。 ActiveX アクセス方法は、

Pervasive PSQL 開発者が DDF の作成、読み取りおよび変更を容易に行えるようにする多数のメソッドを提供しま

す。

辞書ファイル処理のほとんどで、コントロールへの新しいメソッドの追加が必要です。ただし、旧バージョンの

ActiveX データソースコントロールはデータ辞書を認識したため、既存のプロパティとメソッドの動作にいくつ

かの変更が加えられました。旧バージョンとの互換性は保たれていますが、 RefreshLocations などのように拡張

されたプロパティがある一方、FieldInde や FieldName などのように使用が推奨されなくなったものもあります。

30

ファイルの内容とメモリイメージ

ファイルの内容とメモリイメージ ActiveX データソースコントロールは DDF から情報を読み取り、必要に応じて内容をキャッシュに格納します。

つまり、辞書には、 DDF 自体の内容と、 DDF ファイルに関する ActiveX アクセス方法コントロールのメモリイメージの内容という 2 つのバージョンが常に存在します。ActiveX コントロールのバージョン 3 では、コントロー

ルが DDF 情報を DDF 自体から読み取るか、または、保持しているメモリイメージから読み取り、アプリケー

ションの起動時間を節約するかを RefreshLocations プロパティが決定していました。

この機能は維持されていますが、 RefreshLocations の意味は、オペレーションを実行するために DDF 自体を使

用するか、あるいは辞書情報に関する ActiveX コントロールのメモリイメージを使用するかを示すように拡張さ

れました。

言い換えると、オペレーションがコントロールのメモリイメージまたは DDF を参照できる場合は、

RefreshLocations を False に設定すれば、コントロールはメモリイメージのみを使ってオペレーションを処理す

るように制限されます。 RefreshLocations が True である場合、オペレーションはメモリイメージとファイル自

体に作用します。したがって、RefreshLocations は ActiveX コントロールの DDF 処理用メソッドとプロパティの

多くに作用する優先プロパティです。

メモ RefreshLocations を True に設定して DDF を編集するときは、 DDF を上書きしないように注意してくだ

さい。

31


辞書ファイルの読み取り以前のバージョンの ActiveX アクセス方法は、 DDF に含まれる情報の大部分を公開していましたが、特定の情報

を取り出すのが非常に困難であったり、ときには不可能なことがありました。また、項目ごとに複数のプロパティ

設定が必要だったので、情報の複数の項目を検索することは面倒でした。本バージョンの ActiveX アクセス方法

では、これらの問題の解決にバリアント配列を使用しました。バリアントとは、複数のデータ型を表すことがで

き、かつどのデータ型を現在表しているかがわかる変数の一種です。 ActiveX アクセス方法コンテナーはバリア

ントをサポートします。

バリアント配列はバリアントの一種で、実質的にはバリアントのリストへの参照であり、リストの各項目に異な

る型の情報を保持できるものです。この配列は、コード環境によって異なる方法で表されます。 Visual Basic では、バリアント配列は myArray （1, 1）のような単なる通常の配列として表示されます。しかし、 Visual C++ では、バリアント配列は VT_ARRAY|VT_VARIANT 型のバリアントにすぎず、 "SafeArray" システム API を使用し

て配列の内容を処理する必要があります。

既に述べたように、 ActiveX アクセス方法はバリアント配列を使用してコア DDF 情報を公開します。 ActiveX インターフェイスが使用する配列は、1 次元として列、2 次元として行を持つ 2 次元配列です。この配列では、VisualBasic ユーザーは ReDim Preserve 関数を使用して行数を変更することができます。列は要求された情報のさまざ

まな面を表すのに対して、行は項目の集合を表します。たとえば、 GetTableList は 2 次元配列を返します。 1 次元は 3 つの情報、つまり、 TableID、 TableName、および TableLocation から構成されているのに対して、 2 次元

は辞書内のテーブルごとに 1 行を含んでいます。したがって、Visual Basic におけるテーブル名のリストの取得は

以下のように行われます。

リストボックスに現在の辞書内のテーブル名を設定するには

Dim tableList as VariantDim tableCount as integer

'すべての情報をファイル自体から読み込むことを確認するVAccess1.RefreshLocations = True

'DdfPath を設定 - これにより辞書を開くVAccess1.DdfPath = "c:\mydata"

'バリアント配列を取得tableList = VAccess1.GetTableList' リストボックスに名前を入力 - 配列の上限に達するまでループFor tableCount = 0 to UBound(tableList, 2) ' リストボックスに配列の正しいメンバーを追加 List1.AddItem tableList(1, tableCount) Next tableCount

FieldList と IndexList は、ほとんど同じ機能を果たします。ただし、これらはプロパティであるため、配列のエン

トリを変更したり、エントリを追加することができます。各配列の 1 次元の構造については、「FieldList」と「IndexList」を参照してください。言うまでもなく、各配列の 2 次元はフィールド数またはインデックス数を表し

ます。

32

辞書ファイルの変更

辞書ファイルの変更 ActiveX メモリイメージでのファイルの変更は、 DDF の新しい定義を追加または変更してコミットする初の段

階として、また、間違った DDF の情報を修正する場合において有用です。必要とされる変更のほとんどは、

FieldList プロパティおよび IndexList プロパティを使用して行うことができます。

DDF を変更する場合は、すべての変更がコミットできる状態になるまで ActiveX メモリイメージに変更情報を保

管しておき、その後 DdfAddTable を使用してファイルに変更情報をコミットする方が効率的です。したがって、

FieldList または IndexList を設定するときは RefreshLocations を False に設定することをお勧めします。 VisualBasic では、 ReDim 関数で Preserve オプションを使用すれば、既存の定義にフィールドを追加することができま

す。また、 DdfModifyTableName と DdfModifyLocation を使用して、現在のメモリイメージまたは DDF ファイル

自体に含まれるテーブルを変更することもできます。たとえば、次のようにします。

既存のテーブル定義にフィールドを追加するには

Option Base 0Dim fields as Variant

'DDF から直接現在の情報を取得VAccess1.RefreshLocations = True

'VAccess を正しい DDF とテーブルに設定VAccess1.DdfPath = "c:\mydata"VAccess1.TableName = "TableShortAField"

' フィールドリストを取得fields = VAccess1.FieldList

'配列の次元の変更およびフィールドの追加ReDim Preserve fields(7, UBound(fields, 2) + 1)

' これで、前と同じ配列の後に空のフィールドが追加されました'空のフィールドを定義fields(1, UBound(fields, 2)) = "NewComment"fields(2, UBound(fields, 2)) = 0 '文字列fields(3, UBound(fields, 2)) = VAccess1.DataLength fields(4, UBound(fields, 2)) = 20 '20 バイトの文字列fields(7, UBound(fields, 2)) = "This is a new comment"

' この変更をまだファイルに書き込まないVAccess1.RefreshLocations = False'空のフィールドを ActiveX メモリイメージに保存VAccess1.FieldList = fields

....< そのほかの DDF 処理 >....' さて、テーブルは希望どおりに設定されました' テーブルの名前を変更しましょうDdfModifyTableName "TableWithAllFields"

'次の操作を DDF に直接作用させるため、 RefreshLocations を設定してもかまいませんが、'DdfAddTable はメモリイメージではなく DDF にのみ作用するため、'RefreshLocations は無視されます（リファレンスの DdfAddTable を参照）

' テーブルをファイルに保存 - 既存の定義を上書きDdfAddTable True

33


メモ上記の例で示した変更は DDF のみに作用します。この追加フィールドの領域がテーブル自体になけれ

ば、フィールドはファイル自体に存在しません。データファイルの構造の変更については、以下のセクショ

ンを参照してください。

34

テーブル定義の作成

テーブル定義の作成 ActiveX アクセス方法のメモリイメージ（および DDF）でテーブルを作成することは、データファイルに関連付

けられた DDF エントリがない場合や、新しいテーブルを作成する場合に有用です。このプロセスには、以下の 3つの基本的な手順があります。

1 ActiveX アクセス方法のメモリイメージで空のテーブルを作成します。

2 ActiveX アクセス方法のメモリイメージに適切なテーブル情報、フィールド情報、およびインデックス情報

を設定します。

3 新しいテーブルを DDF に保存します。

新しいテーブルを作成する場合は、この後に第 4 の手順、つまり、データファイルの作成を行います。

メモ同じディレクトリに、ファイル名が同一で拡張子のみが異なるようなファイルを置かないでください。

たとえば、同じディレクトリ内のデータファイルの 1 つに Invoice.btr、もう 1 つに Invoice.mkd という名前を

付けてはいけません。このような制限が設けられているのは、データベースエンジンがさまざまな機能で

ファイル名のみを使用し、ファイルの拡張子を無視するためです。ファイルの識別にはファイル名のみが使

用されるため、ファイルの拡張子だけが異なるファイルは、データベースエンジンでは同一のものであると

認識されます。

空のテーブルを作成するとき、 ActiveX アクセス方法は現在のメモリイメージに作業テーブルがなく、すべての

フィールドおよびインデックス情報が消去されていることを認識できる必要があります。 DdfAddTableName がこの機能を果たします。現在のテーブルメモリイメージを DDF に追加する DdfAddTable や、現在のテーブル名

を変更しても他のすべての情報を保つ DdfModifyTableName と違い、 DdfAddTableName は現在のテーブルリス

トに追加スロットを作成し、空のテーブルに関連するすべてのフィールドおよびインデックス情報を消去します。

この作業を行うときは、 DDF に空のテーブルを作らないよう、 RefreshLocations を False に設定することをお勧

めします。

DdfModifyLocation、 FieldList および IndexList オペレーションを使用して、新しい空のメモリイメージを作成す

ることができます。次に、 DdfAddTable を使用して DDF にそのイメージを書き出すことができます。

辞書に新しいテーブルを追加するには

Option Base 0

'DDF から直接現在の情報を取得VAccess1.RefreshLocations = True

'VAccess を正しい DDF に設定VAccess1.DdfPath = "c:\mydata"

' テーブル設定中はメモリイメージでのみ作業するVAccess1.RefreshLocations = False

'現在のメモリイメージに新しいテーブルスロットを作成VAccess1.DdfAddTableName "NewTable"

'場所を設定VAccess1.DdfModifyLocation "newTable.mkd"

....< フィールドとインデックス情報を設定 >....

35


' テーブルをファイルに保存 - 既存の定義を上書きしない' この定義はまだ存在しないはずであるためDdfAddTable False

メモ DdfDropTable への 1 回の呼び出しで、テーブル定義全体を削除することができます。当然のことなが

ら、このオペレーションは決定的な事態を引き起こすため、注意して使用する必要があります。

36

辞書の作成

辞書の作成アプリケーションで辞書自体を作成しなければならない場合があります。たとえば、アプリケーションが初めて

実行されたときに必要な DDF を作成するようにアプリケーションを書いて、ベンダーがアプリケーションと一緒

に DDF を出荷および更新しなくて済むようにすることができます。このタスクを行うメソッドとして、

DdfCreateDictionary があります。このメソッドは、 DdfPath ディレクトリに空の辞書ファイル（COMMENT.DDFと FIELDEXT.DDF も含む）を作成します。

メモ overwrite パラメーターを True に設定すると、 DdfCreateDictionary は現在のディレクトリ内の DDF を破壊して回復不能にしてしまうので、注意して使用してください。

37


データファイルの変更これまで説明してきた変更はすべて、 DDF または DDF の ActiveX メモリイメージにだけ当てはまるものです。

ただし、DDF を変更しても、データファイル内の実際のレコードの長さや構造は変更されません。この変更を行

うには、データファイルに直接影響を与える関数を使用する必要があります。

データファイルの長さの変更は、1 つの操作で済む問題ではありません。基本的には、データファイルを破壊し、

新しい長さで再構築する必要があります。既存のファイルに対してこの変更を行う場合は、 2 つの VAccess コン

トロールとテンポラリファイルを使用してレコードをコピーする必要があります。たとえば、次のようにします。

テーブルとデータファイルにフィールドを追加するには

Dim totalRecs as IntegerDim currRec as Integer

'DDF を読めるようにするVAccess1.RefreshLocations = TrueVAccess2.RefreshLocations = True

'DDFPath を設定VAccess1.DdfPath = "c:\mydata"VAccess2.DdfPath = "c:\myData"

' テーブルを設定VAccess1.TableName = "MyTable"VAccess2.TableName = "MyTable"

' メモリイメージのみを使用VAccess1.RefreshLocations = FalseVAccess2.RefreshLocations = False

'上記ルーチンを使用して VAccess2 メモリイメージに新規フィールドを追加AddNewField

'実際のデータファイルを作成し DDF を更新'VAccess1 のメモリイメージは更新されないVAccess2.RefreshLocations = TrueVAccess2.DdfCreateTable True

' テーブルを一時的に別の場所に割り当てるVAccess2.RefreshLocations = FalseVAccess2.DdfModifyLocation "tempdata.mkd"

' ファイルを開き初のレコードを取得VAccess1.OpenVAccess2.OpenVAccess1.GetFirst

' レコードを一方から他方へコピーtotalRecords = VAccess1.TotalRecordscurrRec = 0

While currRec < totalRecords VAccess2.Buffer(0) = VAccess1.Buffer(0) VAccess2.Insert ' ここにエラー処理を追加 VAccess1.GetNext currRec = currRec + 1Wend

38

データファイルの変更

VAccess1.CloseVAccess2.Close

' 2 つのデータファイルができた（古いデータと新しいデータ）' 言語 API を使用して古いデータファイルを削除し、' 新しいデータファイル名を古い名前に変更するRenameTempDataFile' 正しい場所に置き直す - DDF は既に設定されているので変更しないVAccess2.DdfModifyLocation VAccess1.Location

その他にも、データファイルのインデックス構造に対して直接行える変更があります。これらの操作は「ActiveXメソッドリファレンス」に示されており、 DdfAddIndex、 DdfDropIndex、および DdfDropIndexMaintain などが

あります。

39


その他の DDF 操作ここで説明するメソッドを使用して、さまざまな目的で DDF を処理することができます。

オーナーネームによる DDF の保護

オーナーネームで DDF をセキュリティ保護することができます。この機能を果たすために、以下の 2 つの方法

が用意されています。

DdfSetOwner。このメソッドは、 VAccess メモリイメージに現行の有効な DDF オーナーネームを設定しま

す。つまり、すべての DDF ファイル操作はこのオーナーネームを使用します。 RefreshLocations が True である場合、この呼び出しを行う際のアクセスについては前の DDF オーナーネームを使用し、このオーナー

ネームが DDF 自体に適用されます。このメソッドは、データファイルとの関連でのみ使用される

OwnerName プロパティには影響を与えません。

DdfTestOwnerName。このメソッドでは、有効な DDF オーナーネームを設定し、その名前で許される権限

を決定することができます。

これらの 2 つの方法の詳細については、「ActiveX メソッドリファレンス」を参照してください。

既存のフィールドとインデックス情報の削除

DdfClearFields と DdfClearIndexes は、現在のテーブルの既存のフィールド情報およびインデックス情報をすば

やく消去できる便利な方法を提供します。

メモ RefreshLocations が True である場合、これらの変更内容は DDF に書き込まれるので、注意して使用

してください。

永続的な DDF メモリイメージによるコメントの強制設定

DdfGetComments。このメソッドの用途は非常に限定的です。 RefreshLocations が False である場合、 DDF 以外

のテーブルを開いているときは永続的なメモリイメージが読み取られます。ただし、永続的なメモリイメージに

はコメント情報が含まれていません。DdfGetComments は RefreshLocations を無視するため、このメソッドを使

用してコメント情報を永続的な DDF の情報と同調させるように ActiveX を強制設定することができます。

広範囲に影響が及ぶ ActiveX メソッド

後に、次の 2 つのメソッドは DDF を扱うオペレーションに対して広範囲の影響を与えます。

DdfTransactionMode。このメソッドが True である場合、 DDF に直接書き込みを行うように要求されるすべ

ての DDF 処理関数はトランザクションの適用範囲内で書き込みを行います。つまり、ある部分の書き込みが

行えないと、すべての書き込みが行えなくなるため、たとえば、 FIELD.DDF と INDEX.DDF の間の関係は破

壊されません。

DdfKeyUseIndexDDFOnly。このメソッドは、 True に設定されている場合のみ、コントロールに INDEX.DDFを使用させます。 ActiveX は通常、ステータスバッファーで指定されたファイル自体に格納されているイン

デックス情報によって DDF 情報を増補します。これは、正しくない INDEX.DDF エントリを処理する場合の

コントロールの信頼性を高めます。しかし、この動作は同時に、コントロールを使って正しくない

INDEX.DDF エントリを修復することを困難にします。それは、ファイルを開くときに実際の DDF 情報の一

部が上書きされるからです。

DdfKeyUseIndexDDFOnly を True に設定すると、コントロールはインデックス情報をステータスバッファー

内のインデックス情報で上書きしません。つまり、正しくない INDEX.DDF エントリがあると、コントロー

ルはファイル内をナビゲートできませんが、 DDF の現在の状態を反映します。このため、正しくないエント

リの診断と修復が容易になります。

40

4
ActiveX コントロールリファレンス
この章では、 Pervasive PSQL 用の ActiveX コントロールについて説明し、コントロールの種類ごとにプロパティ、

メソッド、イベントを一覧に示しています。以下の項目が含まれます。

「VAccess データソース」

「VACheck」

「VACombo」

「VACommand」

「VAHScroll と VAVScroll」

「VAList」

「VAOption」

「VAText」

41


VAccess データソース

説明

VAccess コントロールはデータソースコントロールです。これはアプリケーションのソースコードとのデータ

ベース通信、およびほかの 8 個のバウンドコントロールとサードパーティのコントロールへのデータ転送を提供

します。

備考

VAccess コントロールは、設計時にはアイコンとして表示されますが、実行時には表示されません。

VAccess コントロールはそれぞれ、一度にデータベースの 1 つのテーブルを参照します。コントロールは次の 2つのいずれかの方法でデータベースに接続されます。

このコントロールの DdfPath プロパティを、データベースを定義するデータ辞書ファイル（FILE.DDF、FIELD.DDF および INDEX.DDF）の場所に設定します。 VAccess コントロールには設計時にデータベース定

義用の DDF ファイルが必要です。コントロールのレコードソースは、 TableName プロパティをデータ辞書

内のテーブル名の 1 つに設定することによって指定されます。データベースファイルへの物理的なオペレー

ティングシステムパスは、 Location プロパティによって指定されます。この場所は、 TableName が選択さ

れている場合、 DDF に定義されているテーブルの場所のデフォルトとなります。

このコントロールの HostAddress プロパティをマシン名に設定し、DatabaseName プロパティをそのマシン

上にあるデータベース名に設定します。テーブルは TableName プロパティを使って選択します。

テーブルを開くためにオーナーネームが必要な場合は、OwnerName プロパティによってオーナーネームを指定

できます。

レコードナビゲーションプロパティとメソッド、およびフィールドアクセスプロパティはレコードデータを

コードで提供します。データソースは提供されている別のコントロールや Visual Basic でバウンドコントロール

として動作するサードパーティデータコントロールにバインドすることもできます。

カスタムプロパティ、メソッドおよびイベント

次の表に、このコントロールのカスタムプロパティ、メソッドおよびイベントの一覧をアルファベット順に示し

ます。カスタムプロパティ、メソッド、およびイベントのカテゴリ別一覧は、「カテゴリ別プロパティ、メソッ

ド、およびイベント」を参照してください。

プロパティの一覧には、（About）、（Custom）、（Name）、 Index、 Left、 Tag、 Top などのストックプロパティは

含まれていません。

表 7 VAccess カスタムプロパティ

AutoDialog DataLength IndexNumber RowPosition

AutoLogon DdfKeyUseIndexDDFOnly Join Rows

AutoMode DdfPath Location Selected Fields

AutoOpen DdfTransactionMode MaxBufferSize SelectedRecords

Buffer ExtendedOps OemString SessionID

CacheRejectMax FieldList OpenMode Status

CacheRows Fields OwnerName TableName

42

VAccess データソース

CancelDialog FieldValue PageSize TimeOutVal

Column FileVersion Percentage TotalRecords

ColumnName FireEvents Port VADebugMode

Columns HostAddress Position

CompressData HostConnect RefreshLocations

DatabaseName IncludeCurrent Row

表 8 VAccess カスタムメソッド

AboutBox DdfGetFieldComments GetLessOrEqual ShowSelectedFieldsDlg

Btrv DdfModifyLocation GetNext ShowSelectedRecordsDlg

Clear DdfModifyTableName GetNextExtended Stat

Close DdfSetOwner GetPrevious StatusDialog

Create DdfTestOwnerName GetPreviousExtended StepFirst

DdfAddIndex Delete GetTableList StepLast

DdfAddTable FormatFieldValue GetTotalSegments StepNext

DdfAddTableName GetDirect Init StepNextExtended

DdfClearFields GetEqual Insert StepPrevious

DdfClearIndexes GetFileFlag OpCode StepPreviousExtended

DdfCreateDictionary GetFirst Open Transaction

DdfCreateTable GetGreater Refresh Unlock

DdfDropIndex GetGreaterOrEqual RowColumnValue Update

DdfDropIndexMaintain GetLast SetFileFlag

DdfDropTable GetLess SetOwner

表 9 VAccess カスタムイベント

CommError Logon Reposition

GotData OnRemote Validate

表 7 VAccess カスタムプロパティ

43


VACheck

説明

VACheck コントロールはブール型（True または False）のフィールド値の状態を表示します。

備考

VACheck コントロールのデータソースは VAccessName プロパティの設定によって決まります。

フィールドソースは、VAFieldName プロパティをデータソースのブール型（論理あるいはビットタイプ）フィー

ルドの名前に設定することによってバインドされます。

フィールドの True ストレージ値と False ストレージ値の、それぞれ 1 と 0 以外の値は、コントロールの

VAValueTrue プロパティと VAValueFalse プロパティを使用して定義できます。

カスタムプロパティとメソッド

次の表に、このコントロールのカスタムプロパティとメソッドの一覧を示します。

表 10 VACheck カスタムプロパティ

VAccessName VAFieldName

VADataType VAOffset

VADebugMode VASize

VADecimal

表 11 VACheck カスタムメソッド

AboutBox

44

VACombo

VACombo

説明

VACombo はテキストボックスとリストボックスの要素を結合します。ユーザーは値を入力することも、オプ

ション一覧から選択することもできます。

備考

VACombo は 3 つの異なるモードであるフィールドバウンド、レコードリストおよびインデックスリストで操作

できます。

このコントロールをフィールドバウンドデータコントロールとして使用するには、 VAFieldName プロパティに

VAccessName プロパティで指定されているファイルのフィールドの 1 つの名前を割り当てます。AddItem メソッ

ドを使用して、フィールドバウンドコンボボックスにこのフィールドの有効な選択肢一覧を追加することができ

ます。

レコードリストモードでこのコントロールを使用するには、VARecordList プロパティを True として設定します。

メモ VACombo の VARecordList 機能を使用する（VARecordList = True）場合、 1 つのフィールド名のみを

SelectedFields プロパティで指定することができます。そのフィールドはアクティブキーでインデックス付

けされたフィールド（またはセグメントキーでインデックス付けされたフィールドの 1 つ）でなければなり

ません。

SelectedFields でフィールド名の複数指定はサポートされません。複数指定した場合、初に指定したフィー

ルドのみが VACombo コントロールに表示されます。

インデックスが付いていないフィールドの指定はサポートされません。インデックスが付いていないフィー

ルドを指定すると、 VACombo コントロールにはデータが表示されません。

関連ファイルに定義されているインデックスをリストに設定し、ユーザーが実行時に現在のインデックスを選択

できるようにするには、 VAFieldName プロパティを "Index List" に設定します。



表 12 VACombo カスタムプロパティ

IntegralHeight VAccessName VADecimal VAOffset

List VADataType VAFieldName VARecordList

VADebugMode VAFormat VASize

表 13 VACombo カスタムメソッド

AboutBox Clear RemoveItem

AddItem Refresh

45


VACommand

説明

VACommand を使用すると、実行時にボタンがクリックされた時点で、データソースファイルに対する一般的な

操作を実行できます。

備考

VACommand は VAccessName プロパティを設計時あるいは実行時に設定することによって、データソースにバ

インドされます。

VAOperation プロパティは、実行時、ボタンがクリックされたときに実行される操作を判別します。

VAOperation プロパティにレコード取得操作を指定した場合は VALockBias プロパティを使用して、レコードが

取得されている間そのレコードをロックすることができます。 VALockBias プロパティは Open、 Close、 Insert、Update のオペレーションには影響しません。

VAErrorDialog プロパティは、コントロールによって実行されたオペレーションがエラーを返した場合の、ユー

ザーへのテキストメッセージの表示機能を有効にまたは無効にします。

メモ Click イベントは、 VAOperation プロパティに指定された Pervasive PSQL オペレーションの前に

VACommand_Click サブルーチンのコードを実行します。

カスタムプロパティ

次の表に、このコントロールのカスタムプロパティの一覧を示します。

表 14 VACommand カスタムプロパティ

VAccessName VALockBias

VADebugMode VAOperation

VAErrorDialog

46

VAHScroll と VAVScroll

VAHScroll と VAVScroll

説明

VAHScroll コントロールと VAVScroll コントロールは現在選択されているインデックスパスでデータソースを

ナビゲートします。

備考

VAHScroll と VAVScroll は VAccessName プロパティを経由して VAccess コントロールにバインドされます。

スクロールバーのつまみの位置は、 Pervasive PSQL FindPercentage オペレーションよって決定される、現在のイ

ンデックスパスにおける現在のレコードの相対位置を反映しています。つまみをドラッグした位置に該当するレ

コードは、 Pervasive PSQL GetByPercentage オペレーションによって取得されます。

カスタムプロパティ

次の表に、このコントロールのカスタムプロパティの一覧を示します。

表 15 VAHScroll と VAVScroll のカスタムプロパティ

VAccessName VADebugMode Value

47


VAList

説明

VAList コントロールを使用すると、ユーザーはリストから項目を選択できます。

備考

VAList コントロールのデータソースは VAccessName プロパティの設定によって決まります。

リストボックスコントロールは、 VARecordList プロパティの設定によって決定される、 2 つの異なるモードで

動作できます。

VARecordList プロパティが False の場合は、リストボックスはフィールドバウンドデータコントロールとして

動作します。 VAFieldName プロパティをデータソース内のフィールド名の 1 つに設定することによって、リス

トボックスのフィールドデータソースを割り当てます。 AddItem メソッドを使用して、フィールドバウンドリストボックスにこのフィールドの有効な引数一覧を追加することができます。

VARecordList プロパティが True の場合は、リストボックスは関連データソースの複数列のレコードリストと

して動作します。VAFieldName プロパティの値をセミコロンで区切って、リスト内に表示されるフィールド一覧

を設定します（フィールドを空白のままにしておくと、すべてのフィールドが設定されます）。書式文字列の一覧

をセミコロンで区切って VAFormat プロパティに指定することによって、各フィールドの書式を設定することも

できます。 ColumnWidth プロパティを設定すると、リストボックス内の列の横方向のスペースを制御できます。

列幅はピクセル単位で測定されます。



表 16 VAList カスタムプロパティ

ColumnWidth VAccessName VADecimal VAOffset

List VADataType VAFieldName VARecordList

VAAutoScroll VADebugMode VAFormat VASize

表 17 VAList カスタムメソッド

AboutBox Clear RemoveItem

AddItem Refresh

48

VAOption

VAOption

説明

VAOption コントロールはブール型（True または False）のフィールド値の状態を表示します。

備考

VAOption コントロールのデータソースは VAccessName プロパティの設定によって決まります。

フィールドソースは、VAFieldName プロパティをデータソースのブール型（論理あるいはビットタイプ）フィー

ルドの名前に設定することによってバインドされます。

フィールドの True ストレージ値と False ストレージ値は、それぞれコントロールの VAValueTrue プロパティと

VAValueFalse プロパティを使用して定義できます。

指定の親ウィンドウ（フォーム上、あるいはグループボックス内）で一度に 1 つのオプションボタンしか選択、

つまり True にできません。



表 18 VAOption カスタムプロパティ

VAccessName VADebugMode VASize

VADataType VAFieldName VAValueFalse

VADecimal VAOffset VAValueTrue

表 19 VAOption カスタムメソッド

AboutBox

49


VAText

説明

VAText コントロールはフィールドの値を表示し、ユーザーにその値の編集を許可します。

備考

VAText コントロールのデータソースは VAccessName プロパティの設定によって決まります。

フィールドのソースは、 VAFieldName プロパティをデータソースのフィールドの名前に設定することによって

バインドされます。

ほかのバウンドコントロールと同様、テキストボックスでの変更はメモリのデータバッファーに反映されます

が、現在のレコードに対する更新または挿入操作が実行されるまでファイルには書き込まれません。

テキストボックスの VASearch プロパティが True の場合、テキストボックス内の変更を行うと、テキストボッ

クスのテキストの値を現在のインデックスの初のセグメントとして使用して現在のレコードの位置を変更しま

す。レコードリストモードの VAList と検索モードのテキストボックスを一緒に使用して、レコードブラウザー

あるいはルックアップテーブルを実装することができます。



表 20 VAText カスタムプロパティ

AutoScroll VAccessName VAFieldName VASize

FocusSelText VADataType VAFormat WantReturn

LockedMaxLength VADebugMode VAOffset

Uppercase VADecimal VASearch

表 21 VAText カスタムメソッド

AboutBox

50

5
カテゴリ別プロパティ、メソッド、およびイベント
この章は、 Pervasive PSQL 用に設計されたプロパティ、メソッド、およびイベントすべてを一覧にまとめ、次の

セクションで機能別に説明します。

「ActiveX のプロパティ、メソッド、およびイベントの概要」

「レコードセットの取得」

「ファイルの処理」

「データ辞書メソッド」

「レコード内のフィールドへのアクセス」

「レコードの挿入、更新、および削除」

「個別レコードの取得」

「適化とデバッグ」

51


ActiveX のプロパティ、メソッド、およびイベントの概要

プロパティ、メソッド、およびイベントは、 ActiveX コントロールに適用できる 3 種類の機能です。

プロパティとメソッドの違いは必ずしも明らかではありませんが、次のような文で明確にすることができます。

Let variable = method は一般に文法的に正しい構文です。Let method = variable は、誤った構文です。

Let property = variable および Let variable = property は、両方とも文法的に正しい構文です。

イベントは、 ActiveX コントロールによってトリガーされるアプリケーション内の関数で、ユーザーはこれに応

答できます。

メモこの章に記載されているプロパティ、メソッド、およびイベントは、 Pervasive の ActiveX アクセス方

法用に設計されたものです。また、開発ツール（Visual Basic など）で提供されるコントロールに関連付けら

れたほかのプロパティ、メソッド、およびイベントについても説明されています。特定の開発ツールの情報

についてはそのツールのマニュアルを参照してください。

52

レコードセットの取得

レコードセットの取得ここでは、レコードセットを取得する際に使用できるプロパティ、メソッド、およびイベントの一覧を示します。

プロパティとメソッド

表 22 Extended オペレーション用プロパティおよびメソッド

プロパティ / メソッド説明

AutoMode Extended Fetch データセットの自動キャッシュ処理を有効または無効にします。

CacheRejectMax SelectedRecords 条件を使用した単一 Extended Fetch オペレーションの処理でスキップ可能な

大レコード数を決定します。

CacheRows 単一 Extended Fetch オペレーションによって返される大行数を決定します。

CancelDialog ユーザーが一連の単一 Extended Fetch オペレーションをキャンセルすることのできるダイアロ

グボックスを有効または無効にします。

Column Extended Fetch 結果セットの現在の列を決定します。

ColumnName Extended Fetch 結果セットの現在の列の名前を指定します。デフォルトは列に割り当てられた

フィールド名です。

Columns Extended Fetch 結果セットの合計列数を返します。

ExtendedOps データソースに対して Extended Fetch プロパティおよびメソッドを有効または無効にします。

FocusSelText テキストボックスがフォーカスを取得したときの VAText ボックス内のテキストを選択しま

す。

GetNextExtended 現在のカーソル位置から始まり、現在のインデックスパスに沿って進行する Extended Fetch を実行します。

GetPreviousExtended 現在のカーソル位置から始まり、現在のインデックスパスを遡る Extended Fetch を実行しま

す。

IncludeCurrent 次に実行される Extended Fetch オペレーションのレコードセットの結果に現在のレコードを

含めるか、あるいは後続のレコードから始めるかどうかを決定します。

Init SelectedFields または SelectedRecords 条件を変更した後、あるいは新たに現在位置をファイ

ル内で設定した後で Extended Fetch メソッドを呼び出す前に、 Extended Fetch パラメーターを

割り当てます。

MaxBufferSize Extended Fetch オペレーションで使用するデータバッファーのサイズを指定します。

Row Extended Fetch の結果セットの現在の行を設定あるいは返します。Extended Fetch メソッドから

の結果セットへアクセスする場合に、あるいは検索条件を満たす行間を移動する場合に使用し

ます。

RowColumnValue Extended Fetch 結果セット内の指定された行と列からフィールド値を返します。

RowPosition Extended Fetch 結果セット内の現在の行にあるレコードの物理位置を返します。

Rows Extended Fetch 結果セット内のデータの有効行数を返します。

SelectedFields Extended Fetch 結果セットの列として使用するフィールドを指定します。デフォルトは空のリ

ストで、これはすべてのフィールドが含まれることを示します。

53


イベント

SelectedRecords Extended Fetch 結果セットに返されるレコードのレコード選択条件を指定します。デフォルト

は空のリストで、これはすべてのレコードが含まれることを示します。

ShowSelectedFieldsDlg SelectedFields プロパティの［プロパティの設定］ダイアログボックスを表示します。

ShowSelectedRecordsDlg SelectedRecords プロパティの［プロパティの設定］ダイアログボックスを表示します。

StepNextExtended 現在の位置から始まり、物理レコード順を前方へ進む Extended Fetch を実行します。

StepPreviousExtended 現在の位置から始まり、物理レコード順を後方へ進む（遡る） Extended Fetch を実行します。

表 23 Extended オペレーション用イベント

イベント説明

Logon Extended Fetch 操作の完了に伴ない発生します。返されたデータバッファーに含まれるデータ

の行数および列数を返します。

表 22 Extended オペレーション用プロパティおよびメソッド


54

ファイルの処理

ファイルの処理ここでは、ファイル処理を実行する際に使用できるプロパティとメソッドの一覧を示します。


表 24 ファイルの処理用プロパティおよびメソッド


AutoOpen Extended Fetch データセットの自動キャッシュ処理を有効または無効にします。

Close コントロールに関連付けられたファイルを閉じます。

DataLength ファイルに対する単一レコードオペレーションで使用されるレコードデータバッファーのバイ

ト長を取得または設定します。

DdfPath 特定のデータ定義ファイルセットに VAccess コントロールを接続します。

FileVersion Pervasive PSQL ファイルのバージョンを返します。

Insert 現在のデータバッファーを新たなレコードとして挿入を試みます。

Location 選択された VAccess コントロールに関連付けられたテーブルのドライブ、パス、ファイル名を設定

するか、あるいは返します。

Open コントロールに関連付けられたファイルを開きます。

OpenMode コントロールに関連付けられているファイルのオープンモードを取得または設定します。

OwnerName VAccess コントロールに関連付けられたファイルを開くときに使用される Pervasive PSQL オー

ナーネームを指定します。

PageSize Pervasive PSQL データファイルのページサイズを取得または設定します。

SetOwner ファイルのオーナーネームを設定します。

Stat コントロールに関連付けられたファイルから現在のファイルのステータス情報を取得します。

TableName コントロールに関連付けられているテーブルを示します。

TotalRecords VAccess コントロールに関連付けられた Pervasive PSQL ファイルに含まれているレコード数を返

します。

55


データ辞書メソッドここでは、データ辞書メソッドに使用できるプロパティとメソッドの一覧を示します。


表 25 データ辞書処理用プロパティおよびメソッド


DdfAddIndex DDF ファイルおよび対応する Pervasive PSQL ファイルにインデックスを追加します。

DdfAddTable 現在のテーブルを現在のデータ辞書に追加します。

DdfAddTableName 現在の VAccess コントロールメモリイメージに新たなテーブルを追加します。

DdfClearFields 現在のテーブルの VAccess メモリイメージのフィールド情報を消去します。

DdfClearIndexes 現在のテーブルの VAccess メモリイメージのインデックス情報を消去します。

DdfCreateDictionary 現在の位置に新たに空の DDF ファイルセットを作成します。

DdfCreateTable 辞書にテーブル定義を追加し、空のデータファイルを作成します。

DdfDropIndex 現在の Pervasive PSQL データファイルと現在のテーブルのデータ辞書定義からインデック

スを削除します。

DdfDropIndexMaintain 既存インデックスの順序はそのまま維持して、現在の Pervasive PSQL データファイルと現在

のテーブルのデータ辞書定義からインデックスを削除します。

DdfDropTable 現在のテーブルをデータ辞書から削除します。

DdfGetFieldComments COMMENT.DDF ファイルからフィールドコメントを VAccess メモリイメージに読み取りま

す。

DdfKeyUseIndexDDFOnly VAccess がファイルの実際のインデックスを使用するか、あるいは DDF に指定されたイン

デックスを使用するかを指定します。

DdfModifyLocation 現在のテーブルの場所を変更し、オプションとして DDF に新しい場所を書き込みます。

DdfModifyTableName 現在のテーブルの名前を変更し、オプションとして DDF に新たな名前を書き込みます。

DdfPath このコントロールに関連付けられた DDF ファイルが常駐するドライブとパスを設定します。

DdfSetOwner 辞書ファイルの Btrieve オーナーネームをデフォルトのオーナーネーム（..SC...）セキュリ

ティレベル（読み取り専用アクセス）以外に設定します。

DdfTestOwnerName 辞書を開く際に使用するオーナーネームを設定し、このオーナーネームを使用して辞書が正

常に開き、更新できるかどうかを判定します。

DdfTransactionMode データ辞書テーブルへの更新がトランザクション内で実行されるかどうかを判定します。

ブール値を受け付けます。またはブール値を返します。

FieldList 現在のテーブルのフィールドに関する情報を含むバリアント配列を設定します。あるいはそ

のバリアント配列を返します。

GetTableList 現在の辞書に定義されているテーブルのリストを 2 次元バリアント配列として返します。

IndexList 現在のテーブルのインデックスに関する情報を含むバリアント配列を設定します。あるいは

そのバリアント配列を返します。

56

データ辞書メソッド

Location VAccess コントロールに関連付けられている Pervasive PSQL ファイルのドライブ、パス、ファ

イル名を取得または設定します。

RefreshLocations VAccess コントロールがメタデータに対し、 DDF ファイルを使用するのか、あるいは内部状

態と永続的なプロパティ（またはどちらか一方）を使用するのかを判定します。

TableName 現在の DDF セットに定義されているすべてのテーブルから、どのテーブルが目的のコント

ロールと関連付けられているかを示します。

表 25 データ辞書処理用プロパティおよびメソッド


57


レコード内のフィールドへのアクセスここでは、レコード内のフィールドにアクセスする際に使用できるプロパティとメソッドの一覧を示します。


表 26 レコード内のフィールドへのアクセス用プロパティおよびメソッド


FieldList 現在のテーブルのフィールドに関する情報を含むバリアント配列を設定します。あるいはそのバリ

アント配列を返します。

Fields 関連付けられたファイルに定義されたフィールドの合計数を設定します。またはその合計数を返し

ます。

FieldValue メモリ内の現在のレコード、あるいは Extended Fetch レコードセットの現在の行に対して指定され

たフィールドの値を取得または設定します。

FormatFieldValue 指定の書式文字列を使用して書式設定された現在のレコードのフィールドの値を返します。

OemString 英数字フィールドに保存されたデータを ANSI 文字セットと OEM 文字セットの間で変換します。

58

レコードの挿入、更新、および削除

レコードの挿入、更新、および削除ここでは、レコードを挿入、更新、削除する際に使用できるプロパティ、メソッド、イベントの一覧を示します。


イベント

表 27 レコードの挿入、更新、および削除用プロパティおよびメソッド


Buffer コントロールの現在のレコードバッファーの内容を取得または設定します。

Clear メモリ内の現在のレコードのデータとインデックスバッファーの内容を消去します。

Delete 現在のレコードを削除します。

Insert メモリのレコードを新規レコードとしてファイルに挿入します。

Refresh バウンドコントロールを再描画します。

Transaction トランザクションを開始、終了、あるいは中断します。

Unlock ロックされたレコードのロックを解除します。

Update 現在のレコードをメモリ内のレコードイメージに更新します。

表 28 レコードの挿入、更新、および削除用イベント

イベント説明

Validate 関連付けられたテーブルでレコード操作が行われる前に発生します。

59


個別レコードの取得ここでは、レコードセットを取得する際に使用できるプロパティ、メソッド、イベントの一覧を示します。


表 29 個別レコード取得用プロパティおよびメソッド


Buffer コントロールの現在のレコードバッファーの内容を取得または設定します。

GetDirect ファイル内の物理位置を使用してレコードを返します。

GetEqual 現在のインデックスと完全に一致するレコードを返します。

GetFirst 現在のインデックスパスにある初のレコードを返します。

GetGreater 現在のインデックスパスにある現在のキー値よりも大きい初のレコードを返します。

GetGreaterOrEqual 現在のインデックスパスにある現在のキー値と等しい、あるいは現在のキー値よりも大きい初

のレコードを返します。

GetLast 現在のインデックスパスにある後のレコードを返します。

GetLess 現在のインデックスパスにある、キーフィールドに指定された値よりも小さい値を含む後のレ

コードを返します。

GetLessOrEqual 現在のインデックスパスにある、キーフィールドに指定された値よりも小さいまたは等しい値を

含む後のレコードを返します。

GetNext 現在のインデックスパスにある次のレコードを返します。

GetPrevious 現在のインデックスパスにある前のレコードを返します。

GetTotalSegments VAccess コントロールに関連付けられているファイルの、特定のインデックスに含まれるセグメン

トの総数を返します。

IndexNumber VAccess コントロールに関連付けられたテーブルの現在のインデックス番号を返します。

Percentage 関連付けられたテーブルの現在選択されているインデックスパス上の指定された相対位置に、取

得するレコードを設定します。

Position VAccess コントロールに関連付けられたテーブルの現在のレコードの物理位置の値を返します。

RefreshLocations VAccess コントロールがメタデータに対し、DDF ファイルを使用するのか、あるいは内部状態と永

続的なプロパティ（またはどちらか一方）を使用するのかを判定します。

StepFirst 物理レコードの格納順での初のレコードを返します。

StepLast 物理レコードの格納順での後のレコードを返します。

StepNext 物理レコードの格納順での次のレコードを返します。

StepPrevious 物理レコードの格納順での前のレコードを返します。

60

個別レコードの取得

イベント

表 30 個別レコード取得用イベント


Validate 関連付けられたテーブルでレコード操作が行われる前に発生します。

61


最適化とデバッグここでは、適化とデバッグ機能を実行する際に使用できるプロパティとメソッドを一覧にまとめてあります。


表 31 最適化とデバッグ用プロパティおよびメソッド


FireEvents VAccess コントロールのイベントの発生を有効または無効にします。

Join コントロールで使用可能なレコードを制限し、別の VAccess コントロールのフィールド値を基準と

する、関連テーブルのリレーショナルな位置を維持します。

SessionID クライアントが使用するセッション ID を取得または設定します。

Status VAccess コントロールに関連付けられたファイルに対する新の Pervasive PSQL オペレーションか

ら Pervasive PSQL ステータスを返します。

StatusDialog ゼロ以外の数値に設定されると、タスクモードのメッセージボックスを表示します。

VADebugMode コントロールに対するデバッグモードのエラーチェック機能を有効または無効にします。

62

6
ActiveX プロパティリファレンス
この章では、 ActiveX アクセス方法のプロパティについて説明します。アルファベット順にプロパティを説明し

ます。

63


AutoDialog

適用対象VAccess

説明

（非推奨 - 以前の I*net Data Server のみ）このプロパティが True に設定されていると、コントロールは通信エラー

が発生した場合に自動的にダイアログボックスをユーザーに表示します。これは、 Pervasive PSQL サーバーに到

達できない場合に発生します。VAccess コントロールが IDS 経由でリモートデータへのアクセスを試みないので

あれば、このプロパティは無視されます。

備考

AutoDialog プロパティは、 IDS 経由の通信エラーが発生した場合に、 ActiveX が自動的にダイアログボックスを

表示するかどうかを決定します。再接続が可能な場合は、ダイアログボックスに再接続を試行できるプロンプト

が含まれます。デフォルト値は False です。

関連項目

『Pervasive PSQL Programmer's Guide』

64

AutoLogon

AutoLogon

適用対象VAccess

説明

（非推奨 - 以前の I*net Data Server のみ）このプロパティを True に設定しておくと、アプリケーションは安全な

IDS サイトでデータベースを開くとき、自動的にログオンダイアログボックスをユーザーに提供できます。この

プロパティが False の場合は、セキュリティ情報を提供するために、アプリケーションは Logon イベントを手動

で処理する必要があります。

備考

AutoLogon プロパティには 2 つの関連機能があります。まず、 IDS からログオンの要求があった場合に、 ActiveXが自動的にログオンダイアログボックスをユーザーに表示するかどうかを決定します。 IDS が Browseable に設

定されている場合は、このダイアログは IDS データベース名のリストを提示します。 Browseable に設定されてい

ない場合は、ユーザーにデータベース名を入力するように要求します。また、AutoLogon は、 IDS がセキュリティ

情報を要求したときに Logon イベントを発生させるかどうかも決定します。 AutoLogon が True に設定されてい

る場合、 ActiveX はデフォルトのログオンダイアログボックスを表示し、 Logon イベントは発生しません。

このプロパティが False に設定されている場合、デフォルトのダイアログは表示されず、 IDS がセキュリティ情

報を要求するたびに Logon イベントが発生します。その後 Logon イベントに応答して、セキュリティ情報を提

供するか、カスタムログオンダイアログボックスを実装することができます。

デフォルト値は True です。

関連項目

Logon イベント


影響先： Location、 Ddfpath

65


AutoMode

適用対象VAccess

説明

AutoMode プロパティを True に設定しておくと、実行時に Init メソッドが呼び出されるとすぐに、Pervasive PSQLの Extended Fetch オペレーション（GetNextExtended）を自動的に実行して、SelectedFields および SelectedRecordsプロパティで指定されたデータを取得します。 GetNextExtended オペレーションは論理カレンシーを必要としま

す。論理カレンシーは、 GetFirst、 GetEqual などのインデックス付きのレコードオペレーションを呼び出すこと

によって設定できます。

備考

AutoMode が True に設定されている場合は、選択条件を満たすレコードが自動的にフェッチされ、 Row 値の要

求に従って、レコードセットのスナップショットとしてメモリにキャッシュされます。 AutoMode が True に設

定されている場合、 Extended メソッドは無効になります。 CancelDialog プロパティが True の場合は、データアクセスオペレーションの間にユーザーに［Cancel］ダイアログボックスが表示され、ユーザーは、このプロセス

をキャンセルすることができます。

AutoMode が True に設定されている場合は、 Extended オペレーションを使用しようとすると、実行時に -1 のス

テータスが返されます。「ExtendedOps」を参照してください。

AutoMode プロパティが False に設定されている場合、データの取得はユーザー自身で行ってください。 Init メソッドの呼び出しでは、 Pervasive PSQL が Extended オペレーションの呼び出しで使用する構造体を割り当てるだ

けで、データの取得は実行されません。 GetNextExtended、 GetPreviousExtended、 StepNextExtended、または

StepPreviousExtended メソッドを実行時に実行することによってデータをフェッチすることができます。

Extended オペレーションのキャッシュバッファーは 1 つだけメモリに保持され、後続のフェッチで再利用されま

す。

VAccess コントロールの Extended オペレーション機能を有効にするには、 ExtendedOps プロパティを True に設

定する必要があります。

関連項目

影響先： GetNextExtended、 GetPreviousExtended、 StepNextExtended、 StepPreviousExtended、 Init、 Row

影響元： ExtendedOps

66

AutoOpen

AutoOpen

適用対象VAccess

説明

AutoOpen プロパティは以前の RequireOpen プロパティと置き換えられたものです。このプロパティは、データ

ファイルが妥当な場合に、 VAccess コントロールがそのファイルを自動的に開くかどうかを決定します。このプ

ロパティが True に設定されると、 VAccess は実行時のインスタンス生成時、また Location プロパティが変更さ

れるたびに要求されたデータファイルを開こうとします。このプロパティが False に設定されている場合は、

データファイルに対して何らかの操作を実行しようとする前には、ユーザー自身で Open 呼び出しを行ってくだ

さい。

関連項目

影響先： Location、 DdfPath

67


Buffer

適用対象VAccess

説明

コントロールの現在のレコードバッファーの内容を取得または設定します。レコードバッファーは PervasivePSQL によって取得される未加工のデータです。

構文

object.Buffer(short alignment)

Buffer プロパティの構文は次のような要素で構成されます。

備考

データは現在のレコードバッファーから読み取られ、書き込まれます。読み取りオペレーションでは、このプロ

パティは現在のレコードバッファーを表すバイト配列を含む OLE Variant を返します。書き込みオペレーション

では、このプロパティは現在のレコードバッファーに書き込まれるバイト配列を含む OLE Variant を取り出しま

す。このプロパティに対する変更は、 Update メソッドまたは Insert メソッドが正常に呼び出されるまで Btrieveファイルには保存されません。

返されるバッファーは単一レコードバッファーだけです。Stat 呼び出しの後のステータスバッファーの内容は含

みませんし、 Extended オペレーションの呼び出し後の Extended オペレーションレコードバッファーも含みませ

ん。この情報は、ほかのプロパティやメソッドからも利用できます（Stat、 RowColumnValue、 RowPosition を参照

してください）。 Clear メソッドはこのバッファーを消去します。

特定のプログラミング環境では、構造化された変数用に特定のバイトアライメントを使用できます。あるいは特

定のバイトアライメントが必要です。アライメントパラメーターを用いて、レコード内の個別フィールドに使用

するバイトアライメントを指定できます。

このプロパティは設計時には使用できません。

例Public Type SAFEARRAYBOUNDS

cElements As LonglLbound As Long

End Type

Public Type SAFEARRAYcDims As IntegerfFeatures As IntegercbElements As LongcLocks As LongpvData As LongBounds(0) As SAFEARRAYBOUNDS

End Type

要素説明

object 必須。 VAccess オブジェクトの名前は、［適用対象］のオブジェクトを評価するオブジェクト式を表します。

alignment 必須。データのバイトアライメントを指定します。 alignment に対して受け付ける値は 1、 2、 4、 8 および 16バイトです。

68

Buffer

Public Type Buffermsa_desc As String * 34population As Longprev_population As Long

End Type

Declare Sub CopyMemory Lib "KERNEL32" Alias "RtlMoveMemory" (pDest As Any, pSrc As Any, ByVal ByteLen As Long)

Declare Function VarPtrArray Lib "msvbvm50.dll" Alias "VarPtr" (Ptr() As Any) As Long

Public Sub ReadData()Dim i as integerDim dataArray() as BufferDim byteArray() as Byte

VAccess1.OpenVAccess1.GetFirst

Redim dataArray(VAccess1.TotalRecords)

For i = 0 to VAccess1.TotalRecords-1ByteArray = VAccess1.Buffer(4)DataArray(i) = GetBuffer(byteArray)VAccess1.GetNext

Next iEnd Sub

Public Function GetBuffer(bufferArray() As Byte) as BufferDim status As IntegerDim saPtr As LongDim saStruct As SAFEARRAYDim record as Buffer

'SAFEARRAY の構造体のアドレスを取得するCopyMemory saPtr, ByVal VarPtrArray(bufferArray), 4

'SAFEARRAY の構造体をコピーするCopyMemory saStruct, ByVal saPtr, Len(saStruct)'データ配列を構造体にコピーするCopyMemory record, ByVal saStruct.pvData, BufferSize(saStruct)

GetBuffer = recordEnd Function

関連項目

影響元： Clear、 GetDirect、 GetEqual、 GetGreaterOrEqual、 GetLessOrEqual、 GetFirst、 GetPrevious、 GetNext、GetLast、 StepFirst、 StepPrevious、 StepNext、 StepLast、 Percentage

69


CacheRejectMax

適用対象VAccess

説明

このプロパティは、 Pervasive PSQL の Extended Get オペレーション構造体の大リジェクトカウントパラメー

ターと対応しています（『Pervasive PSQL Programmer's Guide』の「Get Next Extended」の説明を参照してください）。

備考

CacheRejectMax プロパティの値を指定すると、 Pervasive PSQL が SelectedRecords プロパティフィルター条件

を満たすレコードの検索中にスキップできるレコード数が制限されます。このプロパティがゼロの場合はシステ

ム定義の大値が使用されます。このプロパティを使用して、所定クエリの読み取り時間を適化することがで

きます。このプロパティの有効範囲は、0 レコード（デフォルト値）から 65,535 レコードまでです。SelectedRecordsプロパティに値が指定されていない場合は、このプロパティの設定はまったく効果がありません。

このプロパティは、 GetNextExtended メソッド、 GetPreviousExtended メソッド、 StepNextExtended メソッド、

または StepPreviousExtended メソッドで使用できるほか、特定の Row 値の要求を受けて、 AutoMode モードで

実行している VAccess コントロールで使用できます。

Pervasive PSQL が Extended Fetch を処理している間に CacheRejectMax 値に達した場合、このフェッチオペレー

ションは、その処理の中で検出したレコード選択条件を満たすレコードのセットと、拒否された（該当しない）

レコードのフィルター制限に達したことを示すステータス値 64 を返します。



関連項目

影響先： GetPreviousExtended、 GetNextExtended、 StepPreviousExtended、 StepNextExtended

影響元： SelectedRecords、 ExtendedOps

70

CacheRows

CacheRows

適用対象VAccess

説明

CacheRows プロパティは一度の Pervasive PSQL Extended Fetch オペレーションで返される大行数を決定しま

す。

備考

このプロパティに設定し得る大値は返される行のバイト長によって決まりますが、この行の長さは、

SelectedFields プロパティがある場合にはその値によって、ない場合はデータファイルの定義済みのデータバッ

ファー長によって決まります。このプロパティは、 Extended Get オペレーション構造体のデータ抽出の固定部分

の「取得するレコード数」と対応しています（『Pervasive PSQL Programmer's Guide』の「Get Next Extended」の説明

を参照してください）。

このプロパティをゼロに設定すると、返される行の長さと MaxBufferSize プロパティの値に基づいて可能な大

値が自動的に計算され、それが使用されます。このプロパティに低い値を設定すると、所定クエリの読み取り時

間を適化することができます。

この値を高く設定しすぎると、ステータス 97 になります。つまり Pervasive PSQL は要求された行数を保持する

のに十分な大きさのバッファーを処理するような構成になっていないということです。この問題を解決するには、

CacheRows プロパティの値の設定を低くし、（可能であれば） Pervasive PSQL バッファーサイズを増やすか、あ

るいは SelectedFields プロパティを用いて返されるフィールド数を減らします。



関連項目

影響先： Rows

影響元： ExtendedOps、 MaxBufferSize、 SelectedFields、 Init

71


CancelDialog

適用対象VAccess

説明

AutoMode プロパティが True に設定されている場合、CancelDialog を True に設定すると、複数の Extended Fetchオペレーションが実行される間、ユーザーにダイアログボックスが表示されるようになります。これを利用して、

ユーザーはオペレーションの合間にフェッチ要求をキャンセルできます。 AutoMode が True の場合、 ExtendedFetch オペレーションは Row プロパティの変更に伴って実行されます。

備考

［Cancel］ダイアログボックスには、現在取得済みのレコード数が表示されます。この数値は Extended Fetch イベ

ントから新たなレコードブロックが返されるたびに更新されます。 AutoMode の Extended Fetch イベントをキャ

ンセルすると、キャンセル前に取得した行はメモリに保持されます。このプロパティは、 AutoMode プロパティ

が False の場合にはまったく効果がありません。



関連項目

影響元： ExtendedOps、 Row、 AutoMode

72

Column

Column

適用対象VAccess

説明

Extended Fetch レコードセットのどの列が、FieldValue プロパティおよび ColumnName プロパティの現在の列に

なるのかを指定します。

備考

Extended Fetch レコードセットの各列はデータベースのフィールドと対応しています。SelectedFields プロパティ

に値が指定されている場合、列値の順序は SelectedFields プロパティに記載されたフィールドの順序と同じです。

SelectedFields プロパティに値が指定されていない場合、列値の順序はデータベースレコードのフィールドの順

序と同じです。

Column プロパティと Row プロパティで、 Extended Fetch オペレーションによって返されるレコードセットの個

別フィールドを指定します。

Column プロパティの値の有効範囲は 1 （初の列）から Columns プロパティの値（後の列）までです。この

プロパティは設計時には使用できません。

Column プロパティは、ColumnName プロパティとペアになります。一方を設定すると、もう一方も設定されます。



特定のフィールド値を指定、取得する場合は、通常、 Column よりも RowColumnValue の方が簡単です。

関連項目

影響先： ColumnName、 FieldValue、 RowColumnValue


73


ColumnName

適用対象VAccess

説明

ColumnName プロパティには、 Extended Fetch オペレーションによって返されたレコードセットの、現在選択さ

れている列に割り当てられたフィールドのフィールド名が格納されます。

備考

ColumnName プロパティは、 Column プロパティとペアになります。一方を設定すると、もう一方も設定されま

す。つまり、 Column プロパティは、 ColumnName の現在の列を特定します。

このプロパティを連続で呼び出して列挙されたフィールドは、 FieldList で指定されたフィールドとは異なってい

る、あるいは異なった順序になっている場合があります。これは、 FieldList にはレコードの実際のフィールドが

オフセット順で入っているのに対し、列は SelectedFields によって決定づけられるからです。



関連項目

影響元： Column、 SelectedFields、 ExtendedOps

74

Columns

Columns

適用対象VAccess

説明

Columns プロパティは Extended Fetch レコードセットに定義されている列数を返します。

備考

Extended Fetch オペレーションに対して SelectedFields プロパティが指定されている場合、この値は

SelectedFields プロパティに指定されたフィールド数と同じです。その他の場合は、データファイルのレコード

に対して定義された合計数と同じです（「Fields プロパティ」を参照）。

このプロパティは設計時には使用できません。実行時は読み取り専用です。このプロパティには、 Extended オペ

レーションの Init メソッドが実行時に呼び出された後にのみ有効なデータが入ります。 VAccess コントロールの

Extended オペレーション機能を有効にするには、 ExtendedOps プロパティを True に設定する必要があります。

例

' この例では、リストボックスを、'1 つの Extended オペレーションバッファーのレコードで埋めますDim line As StringDim colcount, rowcount As IntegerOrders.GetFirstOrders.ExtendedOps = TrueOrders.InitOrders.GetNextExtendedFor rowcount = 1 To Orders.Rows

Orders.Row = rowcountline = ""For colcount = 1 To Orders.Columns

'FieldValue は文字列と予想されるバリアントを返す '文字列であることを確認する

If Not VarType(Orders.FieldValue(colcount)) = vbError Thenline = line + CStr(Orders.FieldValue(colcount))

End IfNext colcountListBox.Add line

Next rowcount

関連項目

影響元： ExtendedOps、 SelectedFields

75


ColumnWidth

適用対象VAList

説明

VAList オブジェクトの複数列レコードリストを利用する際、タブストップ（タブ位置）を割り当てるには、こ

のプロパティを設定します。 VARecordList プロパティが False の場合、このプロパティには影響がありません。

複数列レコードリストにタブストップを設定するには、次の手順を実行します。

1 リストボックスの幅が、すべての列データを収容できる十分な広さがあることを確認します。

2 VARecordList チェックボックスを True に設定します。

3 VAFieldName プロパティで表示する列をまだ選択していない場合は選択します。（これを行うには、リスト

ボックスで右クリックして、プロパティページにアクセスします。 VAFieldName の横にある省略ボタンを

クリックし、列を選択します。）

4 プロパティページの VAFieldName プロパティで、目的のフィールドを選択します。使用可能なフィールド

（列）をダブルクリックすると、それを選択することができます。［OK］をクリックします。

5 引き続きプロパティページから、 ColumnWidth コンボボックスの隣の省略ボタンをクリックし、［Multi-Column Listbox Tab Settings］ウィンドウを開きます。選択した初のフィールドが表示されます。

6 初のフィールドの右側をダブルクリックして、初のタブストップを設定します。破線が現れます。この

線をドラッグし、この列に表示されるデータ用のスペースを確保します。選択した列のタブがすべて表示さ

れ調整されるまで、ダブルクリックと線のドラッグを繰り返します。図 6 を参照してください。

図 6 複数列リストボックスのタブ設定

7 このウィンドウとプロパティページで［OK］をクリックします。

関連項目

影響元： VARecordList

76

CompressData

CompressData

適用対象VAccess

説明

（非推奨 - 以前の I*net Data Server のみ） IDS とデータを送受信する際のデータの圧縮を有効または無効にします。

VAccess コントロールが IDS 経由でリモートデータへのアクセスを試みないのであれば、このプロパティは無視

されます。

備考

CompressData プロパティは IDS と通信する際に圧縮機能を使用するかどうかを決定します。 IDS は圧縮設定を

クライアント単位で実行中に決定するので、レコード要求とレコード要求の間であっても、このプロパティは実

行時に True または False に設定できます。

VAccess コントロールを使って IDS にアクセスする場合は、 LAN 上で標準 Btrieve リクエスタを使用する速度の

遅いネットワーク経由でしかアクセスできないため、このプロパティはほとんどの場合 True に設定しておく必

要があります。


関連項目


77


DatabaseName

適用対象VAccess

説明

接続するデータベース名を指定します。このプロパティは「HostAddress」および「HostConnect」を組み合わせて

使用し、ホスト名とデータベース名を指定します。 ActiveX ではデータベース URI を使用してデータベースに接

続します。

ローカルドライブ、マップされたドライブ、あるいは UNC パスを使用してデータベースに接続する場合は、

「DdfPath」プロパティを参照してください。

備考

データベースにセキュリティが設定されている場合、ユーザーはトランザクショナルインターフェイスでユー

ザー名とパスワードの入力が求められます。

メモこのプロパティは以前、I*net Data Server を使用してデータベースに接続する際に使用されていました。

デフォルト値は空白（空文字列）です。

関連項目

データベース URI の詳細については、『Pervasive PSQL Programmer's Guide』を参照してください。

影響先： HostAddress、 HostConnect

78

DataLength

DataLength

適用対象VAccess

説明

ファイルに対する単一レコードオペレーションで使用されるレコードデータバッファーのバイト長を取得また

は設定します。

備考

このプロパティはナビゲーション呼び出しの後に更新され、実際の現在のレコードサイズを取り込みます。アク

セスされたファイルに可変長フィールドがあり、返されたレコードが DDF で定義されている大レコード長より

小さい場合にのみ、初期（事前呼び出し）値と異なった値になります。

関連項目

影響元： Buffer

79


DdfKeyUseIndexDDFOnly

適用対象VAccess

説明

VAccess がファイルの実際のインデックスを使用するか、あるいは DDF に指定されたインデックスを使用するか

を指定します。

備考

このプロパティが False の場合、 VAccess コントロールは、すべてのインデックス情報にステータスバッファー

のインデックス情報を使用します。ステータスバッファーにない情報（IndexName など）については DDF を使

用します。 True の場合、 VAccess は DDF 情報を排他的に使用します。 DDF が正しくない場合にこのプロパティ

の設定を True にすると、すべてのキーベースのナビゲーション呼び出しがエラーになります。

デフォルト値は False です。

関連項目

影響先： IndexList

80

DdfPath

DdfPath

適用対象VAccess

説明

このコントロールに関連付けられた DDF ファイルが常駐するドライブとパスを設定します。

備考

このプロパティは DDF データ定義ファイルの特定のセットに VAccess コントロールを接続します。このプロパ

ティを変更した場合は、この DDF 内のテーブル名の 1 つを VAccess コントロールの TableName プロパティとし

て指定する必要があります。

実行時にこのプロパティを変更する場合は、事前に VAccess コントロールと関連付けられた現在開いているファ

イルをすべて閉じてください。次に、新たな TableName プロパティとして、新しい DDF のテーブル名の 1 つを

指定する必要があります。新規ファイルを開く前に新たに Location プロパティを指定する必要のある場合もあり

ます。

メモ RefreshLocations が False の場合、 DdfPath は変更できません。

OnRemote は DdfPath がエラーの時に呼び出されます。

この機能を使用して、実行時にパスを解決したり、ユーザーに接続エラーを通知することができます。

DdfPath は次のうちいずれかの書式にできます（以下で説明します）。

マップされたドライブ

URL

UNC

マップされたドライブ

従来のドライブ名を用いる表記（c:\path\datafile）は、 ActiveX の旧バージョンと同様 DdfPath プロパティ

で使用できます。ドライブが見つからなかった場合、 VAccess はパス環境設定を使用して IDSHOSTS と呼ばれる

ファイルを探します（LMHOSTS と同様、このファイルはネットワークあるいは IP アドレスにドライブ名をマッ

プする際に使用されます。詳細については、『Pervasive PSQL Programmer's Guide』を参照してください）。このファ

イルが見つかった場合は、要求されたパスを検索します。要求されたパスがマップされている場合、 VAccess コントロールは指定の場所で IDS への接続を試みます。

URL （Uniform Resource Locator）場所を指定するために URL も使用できます。プロトコル固有のプレフィックスは、リモート（IDS）呼び出しの

場合は pids、ローカル呼び出しの場合は pmke です。そのため、ローカル呼び出しは pmke://{server}/[path/.../][tablename] のような形式となり、リモート呼び出しは pids://{server}/[path/.../][tablename] のような形式となります。

UNC （Universal Naming Convention）

UNC （\\server\path\datafile）は、 DdfPath エントリとしても使用できます。ここではサーバーは LAN 上の Pervasive PSQL サーバー、IDS サーバーあるいは IDS サーバーにマップされた IDSHOSTS のサーバーとするこ

とができます。サーバーが標準 IP アドレスあるいはドメイン名でない場合は、 VAccess はサーバー名をローカル

で解決します。その場所がローカルでは使用できない場合は、 VAccess は IDSHOSTS を使用してサーバー名を解

決します。正常に解決できれば、呼び出しを IDS に再ルーティングします。

81


上記の説明のように、 DdfPath はローカルあるいはリモートのアクセスを指定する際に使用できます（『PervasivePSQL Programmer's Guide』も参照してください）。ただし、リモートアクセスが要求された場合、 HostConnect がTrue に設定されていない限り、 VAccess コントロールは IDS への接続を試みません。また、 DdfPath プロパティ

と Location プロパティで、 2 つの異なる IDS サーバーに同時にアクセスすることはできません。

そのため、 Location がリモートの場所に設定され、 DdfPath が別のリモートの場所に設定されている場合は、

Location プロパティのサーバー名は、 DdfPath によって指定された新たなリモートの場所を反映して変更されま

す。 Location がローカルディレクトリに設定されている場合、 DdfPath は Location に影響しません。

HostAddress に URI を使用してサーバーが指定されている場合は、 DdfPath に指定されたサーバーはすべて無視

されます。

メモ DdfPath が変更されると、 VAccess は新たなパスで DDF ファイルを読み取り、内部テーブルリストの

FieldList と IndexList を更新します。

例

'現在開いているファイルを閉じるCustomers.Close'辞書情報をリフレッシュするCustomers.RefreshLocations = TrueCustomers.DdfPath = "v:\accounts"Customers.TableName = "customer002"Customers.RefreshLocations = False'場所の情報を設定するCustomers.Location = "cust002.dat"' ファイルを開くstat = Customers.Open

関連項目

影響先： Location、 GetTableList、 IndexList、 FieldList

影響元： RefreshLocations、 HostAddress、 HostConnect、 OnRemote イベント

82

DdfTransactionMode

DdfTransactionMode

適用対象VAccess

説明

DdfTransactionMode の設定により、データ辞書テーブルへの更新がトランザクション内で実行されるかどうかが

決定されます。ブール値を受け付けます。またはブール値を返します。

備考

DdfTransactionMode は、トランザクション内の DDF 辞書操作すべてをラップするので、 DDF ファイルに変更を

行う場合は True に設定し、その他の場合は False に設定してください。

デフォルト値は False です。

関連項目


影響先： GetTableList、 FieldList、 IndexList、 DdfModifyTableName、 DdfModifyLocation、 DdfGetFieldComments、DdfAddTable、 DdfDropTable、 DdfAddIndex、 DdfDropIndex、 DdfDropIndexMaintain、 DdfCreateTable、DdfCreateDictionary、 DdfAddTableName、 DdfClearIndexes、 DdfClearFields、 DdfSetOwner

影響元： RefreshLocations

83


ExtendedOps

適用対象VAccess

説明

Extended オペレーションの呼び出しは、選択されたフィールドおよび選択されたレコードと一致するレコード

セットを一回の呼び出しで返します。これらのオペレーションは、同じ結果を得るために何回も単一レコードオペレーションを行うよりもはるかに迅速に実行されます。

このプロパティが True の場合、 VAccess コントロールは Extended Fetch メソッドを使用してレコードを取得でき

ます。

ExtendedOps プロパティが False の場合、あるいは AutoMode プロパティが True に設定されている場合は、Extendedオペレーションを使用する GetNextExtended、GetPreviousExtended、StepNextExtended、StepPreviousExtendedなどのメソッドはすべて、 Extended オペレーションが使用できないことを示す、 -1 というコードを返します。

備考

このプロパティが False （デフォルト値）の場合、 VAccess コントロールは Pervasive PSQL データファイルをナ

ビゲートし、単一レコードフェッチオペレーションを使用してレコードを取得します。

関連項目

影響元： AutoMode、 CacheRows、 CancelDialog、 Column、 Columns、 ColumnName、 MaxBuffersize、 Row、

RowPosition、 Position、 Rows、 SelectedFields、 SelectedRecords、 RowColumnValue、 FieldValue、 CacheRejectMax、Init、 GetNext、 GetPrevious、 StepNext、 StepPrevious、 GetNextExtended、 GetPreviousExtended、 StepNextExtended、StepPreviousExtended

84

FieldList

FieldList

適用対象VAccess

説明

DdfPath と TableName によって特定される現在のテーブルの、フィールドに関する情報を含むバリアント配列を

取得または設定します。

備考

FieldList プロパティは、 2 次元バリアント配列をカプセル化するバリアントを受け付けます。あるいはそのバリ

アントを返します。初の添字はフィールドの 1 つのプロパティを参照し、 2 番目の添字はフィールドの序数を

参照します。初の添字が参照するプロパティは次のとおりです。

フィールド情報を設定する場合、バリアント配列は定義される各フィールドの低量の情報を収容できる必要が

あります。必要な情報には、テーブルの定義内で一意のフィールド名、有効なデータ型、複数のフィールド長を

サポートするデータ型の有効なサイズなどがあります。

この配列のコメント列は、 DDFGetFieldComments メソッドが FieldList プロパティを読み取る前に呼び出された

場合にのみ追加されることに注意してください。

RefreshLocations が True に設定されている場合は、 FieldList を読み取ると、 VAccess は DDF ファイルを再読み

取りし、 DDF に保存されているフィールド情報を取得します。 RefreshLocations を True に設定して FieldList を変更しても、すべての変更が即時に DDF 自体へ書き込まれなくなりました。 DDF へ変更を実際に書き込むには、

ここで DdfAddTable、 DdfModifyLocation などを呼び出す必要があります。これは Pervasive PSQL SDK のリリー

ス以降での動作の変更点です。 RefreshLocations が False の場合は、 FieldList オペレーションはフィールドの

VAccess コントロールのメモリイメージを読み取り、更新します。

DdfTransactionMode と RefreshLocations がともに True に設定されている場合は、FieldList のすべての操作はト

ランザクション内で実行されます。

添字名前バリアント型説明

0 fieldID VT_I2 フィールドテーブル辞書エントリ用の一意キーです。

1 fieldname VT_BSTR フィールド名です。大で 20 文字まで格納できます。

2 datatype VT_I2 データ型コードです。

3 offset VT_I2 レコードの開始点からのフィールドのオフセットです。

4 size VT_I2 フィールドのサイズです。

5 decimal VT_I2 固定小数点以下の桁数、あるいは BIT データ型フィールドのビットオフセッ

トです。

6 flags VT_I2 フィールドフラグです。フィールドフラグの設定についての説明は、『SQLEngine Reference』を参照してください（"X$Field" を検索してください）。

7 comment VT_BSTR COMMENT.DDF に保存されるフィールドコメントです。

85


例

' フィールドの取得Dim fields as VariantVAEngine.RefreshLocations = TrueVAEngine.DdfGetFieldComments = TrueVAEngine.TableName = tableName

fields = VAEngine.FieldListVAEngine.RefreshLocations = FalseIf Not IsEmpty(fields) For i = 0 to Ubound(fields, 2) ' リストボックスにフィールド名を入れる

List.AddItem fields(1, i) Next i

End If

'設定VAEngine.RefreshLocations = FalseVAEngine.FieldList = fields'DDF へ変更を書き込む－ RefreshLocations のリセットは不要VAEngine.DdfAddTable(True)

関連項目

影響元： DdfTransactionMode、 RefreshLocations

86

Fields

Fields

適用対象VAccess

説明

関連ファイルに定義されたフィールドの合計数を返します。

関連項目

影響先： FieldList、 Join、 FieldNumber

影響元： FieldList

87


FieldValue

適用対象VAccess

説明

メモリ内の現在のレコード、あるいは Extended Fetch レコードセットの現在の行に対して指定されたフィールド

の値を取得または設定します。

構文

object.FieldValue(field)

FieldValue プロパティの構文は次のような要素で構成されます。

備考

データの読み書きはメモリ内の現在のレコードに対して行われます。このレコードに対する変更は、 Update メソッドまたは Insert メソッドが呼び出されるまで Pervasive PSQL ファイルに保存されません。

列に書式が設定されている場合は、データ型にかかわらず、その列の内容の値は必ず BStr として返されます（コ

ンテナは自動的にこれを String、 Variant、 AnsiString、その他さまざまな文字データに解釈します）。列に書式が

設定されていない場合、値はその列のデータ型とも近いバリアントとして返されます。ほとんどのコントロー

ルコンテナは、 BStr よりもバリアント（Variant）の戻り値の方がより簡単、迅速に操作でき、インターナショナ

ル化や書式の再設定を行うことができます。そのため、できるだけ書式設定されていない列を取得することをお

勧めします。


コントロールの ExtendedOps プロパティが True の場合、 field パラメーターには、Row プロパティの値によって

示される現在の行に含まれる列の列名、あるいは列インデックスを指定します。パラメーターが指定されていな

い場合は、返される列は Column プロパティで指定された列になります。 FieldValue プロパティは、コントロー

ルの ExtendedOps プロパティが True の場合は読み取り専用です。

RowColumnValue メソッドを使用して、 Extended Fetch レコードセットから有効な Row 座標と Column 座標を基

に値を返すこともできます。

例Dim stat As IntegerVAccess1.FieldValue("msa_desc") = Text1.TextIf Check1.FieldValue = 1 Then

stat = VAccess1.GetEqualElse

stat = VAccess1.GetGreaterOrEqualEnd IfIf stat = 0 Then

Text1.Text = VAccess1.FieldValue("msa_desc")Text2.Text = VAccess1.FieldValue("population")Text3.Text = VAccess1.FieldValue(2)

要素説明

object 必須。 object プレースホルダーは、［適用対象］のオブジェクトを評価するオブジェクト式を表します。

field 必須。object 内の有効なフィールドを特定する、文字列のフィールド名あるいは整数のフィールドインデックス

です。

88

FieldValue

' レコードの 3 番目のフィールドEnd If

関連項目

影響元： ExtendedOps、 Row

89


FileVersion

適用対象VAccess

説明

Pervasive PSQL stat 呼び出しを使用して現在のテーブルの Pervasive PSQL ファイルバージョンを返します。

備考

このプロパティは、テーブルが作成されたときにデータファイルに組み込まれた Pervasive PSQL の機能セットを

示します。これは、そのテーブルにアクセス可能な Pervasive PSQL の初のバージョンと一致します。

90

FireEvents

FireEvents

適用対象VAccess

説明

VAccess コントロールのイベントの発生を有効または無効にします。

備考

このプロパティを True に設定すると、 VAccess コントロールの OnRemote イベント、 Validate イベント、

Reposition イベントおよび GotData イベントの発生が有効になります。アプリケーションでこれらのイベントに

コードを含めない場合は、このプロパティを False に設定することによってそれらのイベントを無効にすること

ができます。

91


FocusSelText

適用対象VAText

説明

このプロパティを True に設定すると、VAText のテキストはテキストボックスがフォーカスを受け取ったときに

選択されるようになります。

92

HostAddress

HostAddress

適用対象VAccess

説明

アクセス対象データベースのホストとなるコンピューターの IP アドレスまたはドメイン名を指定します。この接

続にはデータベース URI を使用します。

備考

TCP/IP エージェントの場合と同様、ドメイン名はコンピューターが DNS サーバーにアクセスできる場合にのみ

解決できます。さらに、ドメイン名を使用すると、ドメイン名が解決されなければ接続を確立できないため、接

続時間が多少遅くなります。

指定するのは IP アドレスまたはサーバー名のみです。明示的に URI を指定したり URI パラメーターを使用しな

いでください。HostAddress および DatabaseName が指定されると、ActiveX コントロールは URI を作成します。

Location や DdfPath と同様、このプロパティは HostConnect プロパティに従属します。 HostConnect が True の場合に HostAddress プロパティの値を変更すると、古い接続（存在する場合）は閉じられ、新しい接続が試行さ

れます。 ActiveX がサーバーへの接続を試行して失敗した場合は、 HostConnect プロパティは自動的に False に設定されます。別の接続を試行するには、 HostConnect を True に設定し直す必要があります。

HostAddress は、 DdfPath と Location のあらゆるサーバー設定に優先されます。

デフォルト値は空白（空文字列）です。

関連項目


影響先： DdfPath、 Location

影響元： HostConnect

93


HostConnect

適用対象VAccess

説明

HostAddress プロパティと組み合わせて使用し、データベース URI を用いた接続を開始あるいは終了します。任

意の時点で現在の接続状態を問い合わせることもできます。

備考

このプロパティが ActiveX コントロールに作用するのは、 HostAddress に値が入力された場合です。このプロパ

ティが True に設定されており、 HostAddress が空でなければ、 VAccess は要求されたサーバーとの接続を試行し

ます。サーバーアドレスを解決できない場合、あるいは接続が失敗した場合は、その接続エラーの後、HostConnectプロパティは自動的に False に設定されます。

HostConnect は VAccess とローカル Btrieve リクエスターとの相互作用には影響しません。


関連項目


影響元： DdfPath、 Location、 HostAddress

94

IncludeCurrent

IncludeCurrent

適用対象VAccess

説明

このプロパティを実行時に設定して、次に実行される Extended Fetch オペレーションのレコードセット結果に現

在のレコードを含めるか、あるいは後続のレコードから始めるかを決定します。

備考

このプロパティの値を True に設定すると、ファイル内の現在のレコード位置で次の Extended Fetch オペレーショ

ンが開始されます（Pervasive PSQL Extended Fetch API のレコード要求構造体で定数 "UC" を設定するのと同等で

す）。このプロパティの値を False に設定すると、ファイル内の後続レコード位置で次の Extended Fetch オペレー

ションが開始されます（Pervasive PSQL Extended Fetch API のレコード要求構造体で定数 "EG" を設定するのと同

等です）。このプロパティは Init メソッドが呼び出された後自動的に True に設定され、 Init に続けて初の

Extended Fetch オペレーションが実行された後自動的に False にリセットされます。



関連項目

影響先： GetNextExtended、 GetPreviousExtended、 StepNextExtended、 StepPreviousExtended

影響元： ExtendedOps、 Init、 GetNextExtended、 GetPreviousExtended、 StepNextExtended、 StepPreviousExtended

95


IndexList

適用対象VAccess

説明

DdfPath と TableName によって特定される現在のテーブルの、インデックスに関する情報を含むバリアント配列

を取得または設定します。

備考

IndexList プロパティは、 2 次元バリアント配列をカプセル化するバリアントを受け付けます。あるいはそのバリ

アントを返します。初の添字はインデックスセグメントの 1 つのプロパティを参照し、2 番目の添字はインデッ

クスセグメントの序数を参照します。初の添字が参照するプロパティは次のとおりです。

インデックス属性は物理データファイルとも関連付けられています。このプロパティの設定によって、辞書のイ

ンデックスを定義することはできますが、物理データファイル内のインデックス属性は変更されません。既存

データファイルのインデックス属性は、DdfAddIndex メソッド、DdfDropIndex メソッド、DdfDropIndexMaintainメソッドを使用して変更することができます。

RefreshLocations が True に設定されている場合は、 IndexList を読み取ると、 VAccess は DDF ファイルを再読み

取りし、 DDF に保存されているフィールド情報を取得します。 RefreshLocations を True に設定して IndexList を変更しても、すべての変更が即時に DDF ファイル自体へ書き込まれなくなりました。 DDF へ変更を実際に書き

込むには、ここで DdfAddIndex、 DdfDropIndex、または DdfDropIndexMaintain を呼び出す必要があります。こ

れは Pervasive.SQL 2000 SDK のリリース以降での動作の変更点です。 RefreshLocations が False の場合は、

IndexList オペレーションはインデックスの VAccess コントロールのメモリイメージを読み取り、更新します。

DdfTransactionMode と RefreshLocations がともに True に設定されている場合は、 IndexList のすべての操作は

トランザクション内で実行されます。

DdfKeyUseIndexDdfOnly が True に設定されている場合は、 IndexList プロパティは常に DDF にある内容だけを

反映します。 DdfKeyUseIndexDDFOnly が False の場合、 IndexList はインデックス情報が更新されるたびにス

テータスバッファーから正しいインデックス情報を取得し、ステータスバッファーに保持されない情報について

は DDF を使用します。

例Dim indexes as Variant'index.ddf からインデックスを取得するVAEngine.DdfKeyUseIndexDDFOnly = TrueVAEngine.RefreshLocations = TrueVAEngine.TableName = tableName


0 IndexName VT_BSTR インデックスの一意の名前です。大で 20 文字まで格納できます。

1 IndexNum VT_I2 インデックス番号（序数）です。

2 SegNum VT_I2 インデックス内のこのセグメントのシーケンス番号です。

3 FieldName VT_BSTR このセグメントによってインデックスを付けられたフィールド名です。

長で半角 20 文字まで使用できます。

4 Flags VT_I2 インデックス属性ビットフラグ（Btrieve キーフラグスペックに準拠）

です。

96

IndexList

'DDF からインデックスを取得するindexes = VAEngine.IndexListVAEngine.RefreshLocations = False

' リストボックスでインデックス情報を表示するList1.ClearIf Not IsEmpty(indexes) Then For i = 0 to Ubound(indexes,2)

Temp = "" For j = 0 to Ubound(indexes, 1)

Temp = Temp + CStr(indexes(j, i)) + vbTab Next jList1.AddItem Temp

Next iEnd If

'データファイルからインデックスを取得するVAEngine.RefreshLocations = TrueVAEngine.DdfKeyUseIndexDDFOnly = FalseVAEngine.TableName = tableNameTrueIndexes = VAEngine.IndexListVAEngine.RefreshLocations = FalseList1.AddItem "------------------------"

' リストボックスでインデックス情報を表示するList1.ClearIf Not IsEmpty(indexes) Then For i = 0 to Ubound(indexes,2)

Temp = "" For j = 0 to Ubound(indexes, 1)

Temp = Temp + CStr(indexes(j, i)) + vbTab Next jList1.AddItem Temp

Next iEnd If

関連項目

影響元： RefreshLocations、 DdfPath、 TableName、 DdfTransactionMode

97


IndexNumber

適用対象VAccess

説明

VAccess コントロールに関連付けられている Pervasive PSQL テーブルの現在のインデックス番号を取得または設

定します。

備考

このプロパティを使用して、データファイルからレコードを取得する際に使用するインデックスを決定します。

データファイルのインデックス値の有効範囲は 0 から TotalKeys プロパティの値から 1 を引いた値までです。

このプロパティは、実行される Pervasive PSQL オペレーションによって別の意味になる場合があります。特定操

作の値に関しては『Pervasive PSQL Programmer's Guide』を参照してください。

NNC （no-currency-change ：カレンシー変更なし）操作を行いたい場合は、「KeyNumber」プロパティを使用します。

Pervasive PSQL では、インデックスはデータファイルで保持されます。これらは順に番号を付けられ、ゼロが

初のインデックスを示します。 Pervasive PSQL ファイルに定義されたインデックスはすべて、このプロパティで

そのインデックスのインデックス番号を指定することによって使用できます。このプロパティの値はデータオン

リーファイルに対して定義されていません。

Join は現在のインデックスに従属するため、 IndexNumber を変更すると現存の Join すべてが空白にされます。

関連項目

影響先： Join

影響元： TableName

98

IntegralHeight

IntegralHeight

適用対象VACombo

説明

VACombo にフォントサイズの違いを考慮してサイズ調整させるようにします。

備考

IntegralHeight プロパティが True に設定されていると、 VACombo のリスト部分はフォントサイズの違いを考慮

してサイズが調整されます。リストの下部の不要なスペースを削除するには、このプロパティを使用します。

99


Join

適用対象VAccess

説明

コントロールで使用可能なレコードを制限し、別の VAccess コントロールのフィールド値を基準とする、関連

テーブルのリレーショナルな位置を維持します。

IndexNumber プロパティまたは TableName プロパティを変更すると、現在の結合が消去されます。

構文

object.Join = "VAccessName:joinedField[, joinedField]"

Join プロパティの構文は次のような要素で構成されます。

備考

Join プロパティを使用して、 1 対 1 あるいは 1 対多関係にある関連データファイルを自動的に同期させることが

できます。

VAccess コントロールは、 1 つのファイルの現在のインデックスから別のファイル内のフィールドへ、インデッ

クスセグメントを参照することによって、階層的に結合することができます。 Join プロパティはこれを迅速に達

成し、結合したファイルのレコードナビゲーションの中に関係を自動的に更新していきます。

VAccess コントロールを別の VAccess コントロールに結合するには、どのインデックスを使用するかを

IndexNumber プロパティに指定してから、 Join プロパティにマスター VAccess コントロールの名前を指定し、次

にコロン、その後に結合したコントロールの選択されたインデックスの値と正確に一致するマスターコントロー

ルのフィールド名を入力するだけです。

例

4 つのテーブルがあるとします。

1 Customers という名前のテーブルには、 CustomerName、 Adress、 Phone、 CompanyCode などの顧客に関する情

報が含まれており、 CompanyCode によってインデックスが付けられています。

2 Orders という名前のテーブルには、 CompanyCode、 OrderNumber、 OrderDate、 TotalAmount、 ShippingDate などの注文ヘッダー情報フィールドが含まれており、CompanyCode と OrderNumber によってインデックスが付

けられています。

3 OrderLineItems という名前のテーブルには、 OrderNumber、 LineNumber、 Quantity、 ProductCode などの注文項

目情報フィールドが含まれており、 OrderNumber と LineNumber によってインデックスが付けられています。

要素説明

object 結合対象の VAccess コントロール名です。このコントロールが使用できるレコードは、コントロールと関

連付けられているファイルの全レコードのサブセットで、これはコントロールの Join プロパティの条件

によって制限されます。

VAccessName マスターコントロールのデータソースとして働く、 object をリンクする VAccess コントロールの名前で

す。

joinedField VAccessName によって参照されるコントロールのフィールドの名前です。複数のフィールドを指定する場

合は、名前をカンマで区切ります。名前を挙げた各フィールドの格納型と長さは、 IndexNumber プロパ

ティに指定されている、object に対して選択されたインデックスの対応するインデックスセグメントと同

一である必要があります。

100

Join

4 Products という名前のテーブルには、 ProductCode、 Description、 Price が含まれており、 ProductCode によって

インデックスが付けられています。

CompanyCode から始まる注文（Order）のスナップショットを取得するには、CompanyCode で Orders を Customersに結合し、 OrderNumber で OrderLineItems を Orders に結合し、 ProductCode で OrderLineItems を Products に結合し

ます（図 7 を参照してください）。 CompanyCode （会社コード）によって Customer （顧客）を取得すると、その

顧客のすべての注文（Oders）、選択された各注文のすべての明細（OrderLineItems）、および選択された明細の正

しい製品情報（Products）がフェッチされます。別の注文あるいは別の明細を選択すると、以降のすべての結合コ

ントロールのデータセットが再度同期化されます。

図 7 結合テーブル例

関連項目

影響元： TableName、 IndexNumber

CustomerName

Address

CompanyCode

OrderNumber

OrderDate

Customers Orders

Phone

CompanyCode TotalAmount

OrderLineItems

OrderNumber

LineNumber

Quantity

ProductCode

ProductCode

Description

Price

Products

ShippingDate

顧客 ABC を問い合わせると、その顧客の結合情報すべてがフェッチされます。

* ABC のすべての注文* 選択された注文ごとのすべての明細* 選択された製品のすべての製品情報

Join

Join

Join

101


KeyNumber

適用対象VAccess

説明

NCC （No-currency-change ：カレンシー変更なし）の Insert または Update オペレーションを行う場合は -1 を設定

します。

備考

このプロパティはプロパティシートでは使用できません。しかし、 NCC の Insert または Update オペレーション

を実行したいことを指定するには、このプロパティを使用します。たとえば、次のようにします。

.KeyNumber = -1 ' NCC （カレンシー変更なし）

NCC （カレンシー変更なし）のオペレーションの詳細については、『Pervasive PSQL Programmer's Guide 』を参照して

ください。

関連項目

影響先： Insert、 Update

102

List

List

適用対象

VACombo、 VAList

説明

コントロールのリスト部分の項目を取得または設定します。リストは文字列配列で、各要素が 1 リスト項目にな

ります。VAList コントロールおよび VACombo コントロールがフィールドバウンドモードで動作する場合は、設

計時にプロパティブラウザーから使用できます。コントロールがレコードリストモードで動作する場合、実行

時は読み取り専用です。

構文

object.List(index) [= string]

List プロパティの構文は次のような要素で構成されます。

備考

このプロパティはリスト項目にアクセスする際に使用します。空の場合、インデックスは -1 です。リストの初

の項目は 0 で、後の項目のインデックスは ListCount - 1 です。

初は、コンボボックスおよびリストボックスコントロールには空のリストが入っています。レコードリスト

モードで動作しているコントロール（VARecordList プロパティが True に設定されている）の場合、リストは実

行時にコントロールが作成されたときに存在する条件を基準にして作成されます。

List プロパティは、 ListCount プロパティおよび ListIndex プロパティと関連して動作します。リストを 0 から

ListCount -1 まで列挙すると、リスト内のすべての項目が返されます。

フィールドバウンド（VARecordList プロパティは False） VACombo コントロールまたは VAList コントロールに

表示する項目を指定するには、 AddItem メソッドを使用します。項目を削除するには、 RemoveItem メソッドを

使用します。アルファベット順で項目を保存するには、リストに項目を追加する前に、コントロールの Sorted プロパティを True に設定します。

Option Base = 1 ステートメントを Declaration セクションで使用しても、Visual Basic コントロールの要素の列挙に

は影響しません。初の要素は常に 0 です。

List のインデックスがリストボックスの実際のエントリの範囲外である場合は、長さゼロの文字列（" "）が返さ

れます。

例

'一番後に追加されたリスト項目のテキストを取得するText1.Text = VAList1.List(VAList1.ListIndex)

要素説明

object ［適用対象］のオブジェクトを評価するオブジェクト式です。

index リスト内の特定項目の番号です。

string 項目を指定する文字列式です。

103


Location

適用対象VAccess

説明

VAccess コントロールに関連付けられている Pervasive PSQL ファイルのドライブ、パス、ファイル名を取得また

は設定します。

備考

設計時には、 Location プロパティのデフォルト値は TableName プロパティで指定されたファイルの DDF 定義の

Table Location の値になります。

このプロパティは、コントロールに関連付けられているデータベースファイルのオペレーティングシステムデバイス、パス、およびファイル名を表します。

このプロパティには、完全修飾されたパスとファイル名、あるいはファイル名だけを入れることができます。ファ

イル名だけの場合、 Open メソッドは DdfPath プロパティによって指定されたディレクトリのファイルを開こう

とします。

Location プロパティの使い方の詳細については、『Pervasive PSQL Programmer's Guide』を参照してください。

例

'現在開いているファイルを閉じるCustomers.Close'場所の情報を設定するCustomers.RefreshLocations = TrueCustomers.DdfPath = "v:\accounts"' テーブル名を設定するとき '現在の場所が空白である場合は、 'location は ddf ファイルで指定 ' された場所に設定される。 '別のデータファイルを使用する場合、 '明示的にそれを指定する必要があるが、 ' この変更は DdfModifyLocation を呼び出すまで 'ddf ファイルには記録されない。 Customers.TableName = "customer002"Customers.Location = "cust002.dat"' ファイルを開くstat = Customers.Open

関連項目

影響元： DdfPath、 TableName、 RefreshLocations、 HostAddress、 HostConnect、 AutoOpen、 OnRemote

104

Locked

Locked

適用対象VAText

説明

コントロールが編集可能かどうかを示す値を取得または設定します。

構文

object.Locked [ = boolean]

Locked プロパティの構文は次のような要素で構成されます。

要素説明


boolean コントロールが編集可能かどうかを指定するブール式です。 True の場合、ユーザーはコントロール内のテキ

ストをスクロールしたり反転表示させることはできますが、編集はできません。ただし、プログラムであれ

ば、 Text プロパティを変更することによってテキストを修正できます。 False （デフォルト）の場合は、ユー

ザーはコントロールのテキストを編集できます。

105


MaxBufferSize

適用対象VAccess

説明

このプロパティは、 Pervasive PSQL レコードマネージャーオペレーションに渡されるデータに対し、コントロー

ルによって割り当てられるバイト数を制限します。

備考

個々の Pervasive PSQL オペレーション用のデータバッファーの大サイズは 64 KB です。

ExtendedOps が True で、 CacheRows が 0 に設定されている場合は、 MaxBufferSize の値によって CacheRows の値

が決定されます。

現在の Pervasive PSQL 構成に対してこの値を高く設定しすぎると、ステータス 97、つまりデータバッファー長

エラーがレコードマネージャーオペレーションから返されます。特に、 Pervasive PSQL レコードマネージャー

とデータをやり取りする際にデータバッファー全体が使用されることの多い Extended Fetch オペレーションで

は、このエラーになります。

関連項目

影響先： Rows、 CacheRows


106

MaxLength

MaxLength

適用対象VAText

説明

ユーザーが VAText に入力可能な大文字数を決定します。値 0 は大値がないことを示します。

備考

コントロールに関連付けられたフィールドが英数字フィールド（Char、VarChar、LongVarChar データ型）の場合、

このプロパティのデフォルト値は VASize プロパティに保存されているフィールド長となります。その他の場合

は、 MaxLength プロパティのデフォルト値は 0 で、大値がないことを意味します。

107


OemString

適用対象VAccess

説明

このプロパティを True に設定すると、英数字フィールドに保存されたデータが ANSI 文字セットと OEM 文字

セットの間で変換されます。

備考

Char、 VarChar、 LongVarChar データ型などの英数字フィールドには、英語以外のデータ用の拡張 DOS 文字セッ

トである、 OEM 文字セットで保存されたデータを入れることができます。このデータは ANSI 文字セットに変換

しなければ、 Windows で正しく表示できません。

このプロパティのデフォルト値は False です。このプロパティを True に設定すると、フィールドデータを読み

取る際に OEM 文字セットから ANSI 文字セットに変換され、英数字フィールド情報がインデックス検索で使用

されるとき、あるいはファイルに書き戻されるときに ANSI 文字テキストから OEM テキストに変換されます。

108

OpenMode

OpenMode

適用対象VAccess

説明

コントロールに関連付けられているファイルのオープンモードを取得または設定します。

備考

このプロパティは、VAccess コントロールに関連する Pervasive PSQL ファイルのファイルオープンモードを決定

します。使用できるオープンモードは次のとおりです。

0 - ノーマル

1 - アクセラレイティドアクセス

2 - リードオンリー

3 - ベリファイ

4 - エクスクルーシブ

メモベリファイモードの使用は推奨されません。 OpenMode をベリファイに設定した場合、 Pervasive PSQLではファイルをノーマルモードで開きます。

このプロパティのデフォルト値は 0 （ノーマル）です。たいていの場合、このモードを選択します。ファイルは、

ほかのプロセスからそのファイルを開けないようにするエクスクルーシブアクセスや、アプリケーションから

ファイルを変更できないようにするリードオンリーモードで開くこともできます。アクセラレイティドアクセ

スモードとベリファイモードは、 Pervasive PSQL ではまったく効果がありません。

データベースを開く際には OpenMode の現在値が使用されます。モードを変更するには、データベースを閉じて

から再度開く必要があります。

関連項目

影響先： Open

109


OwnerName

適用対象VAccess

説明

OwnerName プロパティによって、 VAccess コントロールに関連するファイルを開く場合に使用される PervasivePSQL オーナーネームを指定することができます。

備考

オーナーネームプロパティは、設計時に入力することもできます。あるいは AutoOpen プロパティが False の場

合は、実行時にファイルを開く前に設定することもできます。

不正なオーナーネームを指定すると、あるいはオーナーネームを指定せず、ファイルのオーナーネームセキュ

リティによりファイルを読み取り専用モードで開けない場合は、ダイアログボックスが表示され、アプリケー

ションがファイルを開こうとする際に、ユーザーに対して正しいオーナーネームを指定するように要求します。

OwnerName は SetOwner メソッドで使用します。

例

'現在開いているファイルを閉じるCustomers.Close'場所の情報とオーナーネーム情報を設定するCustomers.DdfPath = "v:\accounts"Customers.TableName = "customer002"Customers.Location = "cust002.dat"Customers.OwnerName = "password"' ファイルを開くCustomers.Open

関連項目

影響先： Open、 SetOwner

110

PageSize

PageSize

適用対象VAccess

説明

Pervasive PSQL データファイルのページサイズを取得または設定します。

備考

DdfCreateTable メソッドの呼び出しの前にこのプロパティを設定して、作成されるデータファイルのぺージサイズを決定します。

既存のデータファイルの場合、このプロパティはファイルで使用されているぺージサイズを返します。既存ファ

イルに対してこのプロパティを設定してもまったく効果はありません。

有効なページサイズの範囲は Pervasive PSQL データファイルのファイルバージョンによって異なります。

9.0 より前のファイルバージョの場合： 512 バイト～ 4,096 バイト（512 バイトの倍数で大 4,096 バイト）

ファイルバージョン 9.0 の場合：512、1,024、1,536、2,048、2,560、3,072、3,584、4,096、8,192 （値はバイト単位）

ファイルバージョンが 9.5 以上の場合： 1,024、 2,048、 4,096、 8,192、 16,384 （値はバイト単位）

新たにステータスバッファーをファイルから取得することになるすべてのオペレーションでは、この値がリセッ

トされます（Stat を参照）。

関連項目

影響先： DdfCreateTable

影響元： Stat、 TotalRecords

111


Percentage

適用対象VAccess

説明

関連する Pervasive PSQL ファイルの現在選択されているインデックスパスに従って、指定された相対位置で取得

するレコードを設定します。あるいは現在のレコードの相対位置を返します。

構文

object.Percentage [= value]

Percentage プロパティの構文は次のような要素で構成されます。

備考

このプロパティを実行時に設定すると、関連付けられたファイルで Pervasive PSQL GetByPercentage オペレー

ションが実行されます。オペレーションのステータスはコントロールの Status プロパティに返されます。ステー

タス 0 は正常終了を示します。このプロパティを実行時に読み取ると、 Pervasive PSQL FindPercentage オペレー

ションが実行され、オペレーションの結果が返されます。これらのオペレーションは MKDE 6.x 以降のバージョ

ンにあります。値の範囲は、 0.00 から 100.00 パーセントを表す 0 から 10,000 までです（または、精度を指定する

場合は 0 から 0xFFFFFFFF までです。『Btrieve API Guide』の「Get By Percentage （44）」および「Find Percentage（45）」を参照してください）。 xxPercentage オペレーションの精度は、さまざまな条件によって決まります。

ExtendedOps プロパティが False である場合、このプロパティを実行時に設定すると、関連ファイルで

GetByPercentage オペレーションが実行されます。 ExtendedOps が True の場合は、このプロパティを設定する

と、現在の Row プロパティ値が現在の Extended オペレーションバッファー内で指定されたパーセント値に移動

されます。

ExtendedOps プロパティが False である場合、このプロパティを実行時に読み取ると、FindPercentage オペレー

ションが実行され、オペレーションの結果がプロパティ値として返されます。 ExtendedOps が True の場合は、

返された値は現在の Extended オペレーションバッファー内の現在の行のパーセント値を表します。

例

'現在のインデックスパスを基に、中間にあるレコードの位置を確立するCustomer.Percentage = 5000

' スクロールバーのスクロールボックスを、現在のレコードの位置にセットするVScroll1.Max = 10000VScroll1.Min = 0VScroll1.FieldValue = Customer.Percentage

関連項目

影響先： Buffer

要素説明


value 0.00% から 100.00% までに対応する、 0 から 10000 までの範囲の Long 型整数値です。実行時にこのプロパティ

を設定すると、現在のインデックスパスに基づくおおよそのパーセント位置にあるレコードが取得されます。

このプロパティを実行時に読み取ると、現在のレコードの位置を示す同範囲内の値が返ります。

112

Port

Port

適用対象VAccess

説明

（非推奨 - 以前の I*net Data Server のみ）クライアントが IDS と通信する際に使用するポート番号を取得または設

定します。 VAccess コントロールが IDS 経由でリモートデータへのアクセスを試みないのであれば、このプロパ

ティは無視されます。

備考

このプロパティの値は、 IDS ポート番号が変更された場合にのみ変更してください。クライアントポートと IDSポートの設定が異なっていると、クライアントは IDS に接続できなくなります。

IDS クライアントコンポーネントすべてに対するデフォルト値は 2441 です。

ActiveX が IDS ホストに接続されている間にポートプロパティが変更された場合、この変更は次の接続が行われ

るまで有効になりません。

ポートの変更を強制的に有効にするには

1 HostConnect を False に設定します。

2 ポート番号を変更します。

3 HostConnect を True に設定し直して新しい接続を強制し、新たなポート設定で動作させます。

113


Position

適用対象VAccess

説明

VAccess コントロールに関連付けられた Pervasive PSQL テーブルの現在のレコードの物理位置の値を返します。

物理位置を必要とする、後続のメソッドが使用する物理位置を設定します。

備考


Position プロパティは、 Pervasive PSQL ファイルの個別レコードを一意に識別する Long 型整数です。 GetDirectメソッドを呼び出す前にこのプロパティを設定して、ファイルのインデックス検索を行わずに、直接このプロパ

ティで識別されるレコードを取得します。

データファイルのレコードを取得するときに、このプロパティの値を使って個々のレコードに「ブックマーク」

を付けておくことができます。

データコントロールは、 Position プロパティ値が現在値かどうかを追跡します。プロパティ値が現在値でないと

きにプロパティを読み取ると、コントロールは GetPosition 呼び出しを行って現在の値を返します。コードでこ

のプロパティ値を設定すると、その値は内部的に現在値とマークされますが、現在のポジショニングの変更は行

いません。これは、 GetDirect メソッドを呼び出すことによって実行されます。

例Dim bookmark As Long'多数の重複可能キーエントリの初のエントリを取得し、' レコードにブックマークを付けるCustomer.IndexNumber = 3 'companyNameCustomer.FieldValue("companyName") = "Consolidated Inc"stat = Customer.GetEqualbookmark = Customer.Position'重複可能レコードの数をカウントするWhile stat = 0 And Customer.FieldValue("companyName") = "Consolidated Inc"

dups = dups + 1stat = Customer.GetNext

Wend' 初の重複可能レコードのポジショニングを再確立し、ロックするCustomer.Position = bookmarkstat = Customer.GetDirect (BTO_SingleNoWait)

関連項目

影響先： GetDirect

影響元： ExtendedOps、 Row、 GetDirect、 GetEqual、 GetFirst、 GetGreater、 GetGreaterOrEqual、 GetLast、 GetLess、GetLessOrEqual、 GetNext、 GetNextExtended、 GetPrevious、 GetPreviousExtended、 StepFirst、 StepLast、 StepNext、StepNextExtended、 StepPrevious、 StepPreviousExtended

114

RefreshLocations

RefreshLocations

適用対象VAccess

説明

RefreshLocations は、 VAccess コントロールがメタデータについて、 DDF ファイルを使用するのか、あるいは、

内部状態と永続的なプロパティ（一方または両方）を使用するのかを決定します。 RefreshLocations が True の場合は、 VAccess コントロールは DDF ファイルへのパススルーの役割をします。つまり、メタデータへの要求は

すべて DDF ファイルから直接再読み取りされます。

メタデータの操作は、 VAccess コントロールのメタデータのメモリイメージだけに影響します。変更内容を存続

させるには、 DdfAddTable などを明示的に呼び出す必要があります。

このプロパティが True の場合、 ActiveX データソースコントロールと関連付けられているテーブルメタデータ

は、コントロールがインスタンス化される際に読み取られます。このプロパティは、ActiveX コントロールが DDF情報を頻繁に更新するのを防ぎます。

RefreshLocations が False に設定されている場合は、 ActiveX は DDF 情報を持続することができるため、 DDFセットが変更されないことを前提として、 ActiveX を使用するアプリケーションを対応する DDF ファイルのセッ

トを伴わずに再配布することができます。

備考

DDF ファイルを変更するには

1 RefreshLocations を True に設定します。

2 現在の DDF 情報を取得します（RefreshLocations = True とすると、ファイルが直接取得されます）。

3 IndexList と FieldList を適宜変更します（変更は VAccess メモリイメージに保存されます）。

4 DdfAddTable を呼び出して、変更を DDF ファイル自体へコミットします。

例

'RefreshLocations を True に設定すると、' コントロールは必要な情報をすべて ddf ファイルから読み取れるようになる VAEngine.RefreshLocations = TrueVAEngine.DdfPath = pathVAEngine.TableName = tableNameVAEngine.RefreshLocations = False

関連項目

影響先： FieldList、 IndexList、 DdfModifyTableName、 DdfModifyLocation、 DdfAddIndex、 DdfDropIndex、DdfDropIndexMaintain、 DdfClearIndexes、 DdfClearFields、 DdfSetOwner、 DdfGetFieldComments、 TableName、DdfPath、 DataLength

115


Row

適用対象VAccess

説明

このプロパティは実行時に設定し、FieldValue プロパティおよび RowPosition プロパティに対して、Extended Fetchレコードセット内の現在の行を特定します。

備考

Row プロパティは Column プロパティと組み合わせて使用され、 FieldValue プロパティが Extended Fetch レコー

ドセットのどのフィールドの値を参照するかを指定します。 AutoMode が False の場合、 Row プロパティの範囲

は 1 から後の行のインデックスになります。 AutoMode が True の場合、 Row をこの範囲よりも大きな値に設

定すると、 VAccess コントロールは要求が満たされるまで、あるいはゼロ以外のステータスが返されるまで

Extended Fetch オペレーションを実行します。結果として Rows プロパティが更新されます。




例Dim total As CurrencyDim count As Integer' この例は GetNextExtended Op バッファーを 1 つだけ追加するOrders.GetFirstOrders.GetNextExtendedtotal = 0Orders.Column = 1For count = 1 To Orders.RowsOrders.Row = count

total = total + Orders.FieldValueNext countText1.Text = total

関連項目

影響先： FieldValue、 RowColumnValue、 Position、 RowPosition、 GetPrevious、 GetNext、 StepPrevious、 StepNext

影響元：ExtendedOps、AutoMode、GetPreviousExtended、GetNextExtended、StepPreviousExtended、StepNextExtended、Init

116

RowPosition

RowPosition

適用対象VAccess

説明

このプロパティは、Extended Fetch レコードセットの Row に対応するレコードの Pervasive PSQL 物理レコード位

置を返します。

備考

このプロパティは設計時には使用できません。実行時は読み取り専用です。これは、 Extended Fetch オペレーショ

ンで取得された特定レコードに現在位置を設定する、あるいはそのレコードをロックする際に使用できます。こ

のプロパティには、 Extended Fetch オペレーションが実行時に正常に実行された後、または、 AutoMode プロパ

ティが True の場合は、 Extended Fetch オペレーションの Init メソッドが実行時に呼び出された後にのみ、有効な

データが入ります。



関連項目

影響元： ExtendedOps、 Row

117


Rows

適用対象VAccess

説明

Extended Fetch オペレーションによって返されたデータの行数を返します。

備考

このプロパティは設計時には使用できません。実行時は読み取り専用です。このプロパティには、 Extended Fetchオペレーションが実行時に正常に実行された後、または、AutoMode プロパティが True の場合は、Extended Fetchオペレーションの Init メソッドが実行時に呼び出された後にのみ、有効なデータが入ります。

AutoMode プロパティが True の場合は、 Rows プロパティは、このコントロールに対して前回 Extended Fetch オペレーションの Init メソッドが呼び出された以降にキャッシュされた行の総数を示します。その他の場合は、直

前に実行された Extended Fetch オペレーションによって返された行数を示します。



例Dim total As CurrencyDim colcount, rowcount As IntegerOrders.GetFirstOrders.GetNextExtendedtotal = 0For rowcount = 1 To Orders.Rows

Orders.Row = rowcountFor colcount = 1 To Orders.ColumnsOrders.Column = colcounttotal = total + Orders.FieldValue

Next colcountNext rowcountText1.Text = total

関連項目

影響元：ExtendedOps、CacheRows、GetPreviousExtended、GetNextExtended、StepPreviousExtended、StepNextExtended

118

SelectedFields

SelectedFields

適用対象VAccess

説明

Extended Fetch レコードセットに返されるフィールドを列挙します。

備考

SelectedFields プロパティに指定されるフィールドは、 Extended Fetch オペレーションで返されるレコードセッ

トの Columns と対応しています。

SelectedFields リスト内のフィールド名は、 VAccess コントロールが参照するテーブルの有効なフィールド名で

ある必要があり、カンマで区切られていなければなりません。

このプロパティを空白のままにしておくと、データファイルに定義されたフィールドすべてが Extended Fetch レコードセットの列に割り当てられます。列はレコード内の各フィールドのオフセットに従って順序付けられます

（フィールドがファイルの DDF 定義に表示されるのと同じ順序です）。

このプロパティに値が指定されている場合、返される列の順序は SelectedFields プロパティにリストされた

フィールドの順序と同じです。これは、必ずしもファイルの DDF 定義での出現順序とは限りません。



例Dim allnames as String

If OptionButton1 = True Thenallnames = "msa_desc, population"

elseallnames = "msa_desc, prev_population"

End If

VAccess1.SelectedFields = allnames'正しい位置を確立するため、 GetFirst を呼び出す必要があるVAccess1.GetFirst'SelectedFields を変更後、 Init メソッドを呼び出す必要があるVAccess1.InitVAccess1.GetNextExtended

関連項目

影響先： SelectedRecords、 CacheRows、 Columns、 ColumnName

影響元： SelectedRecords、 ExtendedOps、 Init

119


SelectedRecords

適用対象VAccess

説明

SelectedRecords プロパティによって、フィルター条件を指定して、 Extended Fetch レコードセットに返される

レコードの範囲を制限することができます。

構文

object.SelectedRecords = fieldname operator (fieldname または "constant") [[conjunction fieldname operator (fieldname または "constant")]...]

SelectedRecords プロパティの構文は次のような要素で構成されます。

備考

このプロパティを空白のままにすると、フィルター処理は行われません。つまり、現在のインデックスパスでの

出現順序ですべてのレコードを返します。

文字列フィールドの比較では、テーブルを定義したときにフィールドに大文字小文字の区別をしないフラグが付

けられていない場合を除き、大文字小文字を区別します。かっこはサポートされません。フィルター条件は、出

現する順に論理的に解決されます。

テキストフィールドを定数値と比較する場合、 SelectedRecords フィルターは定数の文字数とフィールドの文字数

のうちの小さい方を比較します。たとえば、次のようなフィルターがあるとします。

city = "B"

このフィルターは、 city フィールドの初の文字が "B" で始まるすべてのレコードを返します。たとえば、

Baltimore、 Boise、 Boston および Butte などです。



SelectedRecords フィルターが有効になる前に、 Init メソッドが呼び出されている必要があります。

関連項目

影響元： SelectedFields、 ExtendedOps、 Init

要素説明

fieldname 値によってフィルターするフィールドの名前です。これには、 object が参照するファイルの有効なフィール

ドをどれでも指定できます。 SelectedFields プロパティで指定されているフィールドの 1 つである必要はあ

りません。

operator 次の論理演算子の 1 つです。 > （より大きい）、 < （より小さい）、 = （等しい）、 <> （等しくない）、 >= （以

上）、または <= （以下）。

constant 定数値です。定数値は前後に引用符（Chr$ （34））を付ける必要があります。

conjunction 複数のフィルター比較が必要な場合は、＆（and）または｜（or）の連結演算子のいずれかで結合する必要

があります。

120

SessionID

SessionID

適用対象VAccess

説明

クライアントが使用するセッション ID を取得または設定します。

備考

これは、 BTRVID 呼び出しに使用されるクライアント ID の後の 2 バイトを設定します。これは、トランザク

ションがコントロールで使用される場合に設定してください。スレッドに対して安全（スレッドセーフ）なトラ

ンザクションを提供することに加え、アプリケーションに対して安全なトランザクションも提供します。ただし、

これを設定すると、サーバー上で使用されるシート数も増加します。

関連項目

影響先：すべての Btrv オペレーション

121


Status

適用対象VAccess

説明

VAccess コントロールに関連付けられたファイルに対する新の Pervasive PSQL オペレーションから PervasivePSQL ステータスを返します。 Pervasive PSQL ステータスコードのリストについては、 Pervasive PSQL でインス

トールされている『Status Codes and Messages』ヘルプを参照してください。

関連項目

影響元：すべての Btrv オペレーション

122

TableName

TableName

適用対象VAccess

説明

TableName は、DdfPath プロパティによって指定される DDF セットに定義されているすべてのテーブルのうち、

どのテーブルがコントロールと関連付けられるかを示します。

有効な TableName が設定されると、 AutoOpen = True であれば、コントロールは現在のファイルを閉じ、現在の

場所で要求されたテーブルを開こうとします。 TableName が無効な場合、コントロールは正常にファイルを開い

たりデータを取得したりすることができません。

このプロパティを使用して現在のテーブル名を変更することはできません。現在のテーブル名を変更するには、

DdfModifyTableName を使用できます。

メモテーブルの辞書情報を取得する場合は、 RefreshLocations は True である必要があります。

例Dim Index As Integerindex = Combo1.ListIndexIf index > -1 Then ' リストから選択済み

VAccess1.CloseVAccess1.RefreshLocations = TrueVAccess1.RefreshLocations = FalseVAccess1.TableName = Combo1.List(index)VAccess1.OpenSelect Case indexCase 0VAList1.VAFieldName = "msa_desc. population"

Case 1VAList1.VAFieldName = "user_name. customer_code"

Case 2VAList1.VAFieldName = "order_date. order_number"

End SelectVAccess1.GetFirst

End If

関連項目

影響先： FieldList、 IndexList、 IndexNumber、 Join

影響元： DdfAddTableName、 DdfAddTable、 DdfModifyTableName

123


TimeOutVal

適用対象VAccess

説明

（非推奨 - 以前の I*net Data Server のみ）接続タイムアウトエラーを報告する前に、クライアントが IDS からの応

答を待機する時間（秒数）を取得または設定します。 VAccess コントロールが IDS 経由でリモートデータへのア

クセスを試みないのであれば、このプロパティは無視されます。

備考

この待機制限時間が過ぎると、コントロールは WSAETIMEDOUT という Winsock エラーを用いて CommError イベントを発生させます。この制限は、 Winsock 実装面での問題の都合上、可能な Winsock オペレーションのサブ

セットだけに適用されます。この値を変更する必要があるのは、帯域幅が非常に少ないため、あるいは多数の回

復不能エラーのためにタイムアウトが発生する場合だけです。

デフォルト値は 120 です。

124

TotalRecords

TotalRecords

適用対象VAccess

説明

VAccess コントロールに関連付けられた Pervasive PSQL ファイルに含まれているレコード数を返します。

備考

レコードの総数はほかのユーザーのせいで変わる可能性があります。この値を取得すると、正確なレコード数を

確保するために Stat 呼び出しが強制的に実行されます。その結果、ステータスバッファーの状況を反映するプロ

パティは、このプロパティによって上書きされます。影響を受けるプロパティは、PageSize、PercentFreeSpace、PreallocatedPages、および ReservedDupPointers などです。また、このプロパティをリモートファイルで実行

すると stat 要求がリモートサイトで実行され、アプリケーションの速度が遅くなる場合があります。

例Dim NumRecords as Long NumRecords = VAccess1.TotalRecords

関連項目

影響先： PageSize

影響元： STAT

125


Uppercase

適用対象VAText

説明

VAText のテキストに適用される大文字小文字の書式設定タイプを取得または設定します。

備考

次の 3 つの設定が可能です。

0 - 大文字小文字を強制しない

1 - 大文字

2 - 小文字

このプロパティ値が 0 の場合、テキストボックスのテキストは入力どおりに表示されます。 1 の場合はテキスト

ボックスのテキストはすべて大文字で表示されます。 2 の場合はテキストボックスのテキストはすべて小文字で

表示されます。

126

VAccessName

VAccessName

適用対象

VACheck、 VACombo、 VACommand、 VAHScroll、 VAList、 VAOption、 VAText、 VAVScroll

説明

データアウェアコントロールとバインドするデータソースオブジェクト（VAccess コントロール）を指定します。

備考

レコードナビゲーションコントロールの、 VACommand、 VAHScroll、 VAVScroll の場合は、 VAccessName プロ

パティはコントロールのバインド処理を定義します。

フィールドバウンドコントロールの、フィールドバウンドモードの VACombo、フィールドバウンドモードの

VAList、VACheck、VAOption、および VAText がバインドするためには、VAFieldName プロパティに有効なフィー

ルド名を指定することも必要です。設計時に VAccessName プロパティを設定すると、VAFieldName プロパティ

で利用可能な、 VAccess コントロールと関連付けられているフィールドのリストが作成されます。

127


VAAutoScroll

適用対象VAList

説明

このプロパティを False に設定すると、リストがオートフィルレコードリストとして使用されている場合

（VARecordList = True）も、現在選択されている VAList 項目が自動的にリストの一番上へスクロールされなくな

ります。

備考

レコードリストの VAList （VARecordList = True）のデフォルトの動作では、現在のレコードの位置がリストボッ

クスによって、あるいはスクロールバーや GetEqual コマンドなどその他の手段によって変更されたかどうかに

かかわらず、現在のレコードがリストボックスの初の項目になるようにします。 VAAutoScroll が False の場合

は、このデフォルトの動作は無効化され、リストボックス以外のソースによって位置が変更された場合にのみ、

VAList は現在のレコードをリストの一番上へ移動させます。つまり、リストボックスの項目をクリックすると、

VAccess コントロールの位置は変更されますが、リストボックスの項目は変更されません。

128

VADataType

VADataType

適用対象

VACheck、 VACombo、 VAList、 VAOption、 VAText

説明

フィールドコントロールにバインドされたフィールドのデータ格納型コードを取得または設定します。

備考

VADataType プロパティは、コントロールにバインドされたデータフィールドのデータ格納型コードを指定しま

す。


129


VADebugMode

適用対象

Vaccess、 VACheck、 VACombo、 VACommand、 VAHScroll、 VAList、 VAOption、 VAText、 VAVScroll

説明

コントロールに対するデバッグモードのエラーチェック機能を有効または無効にします。

備考

このプロパティはアプリケーションの設計時、あるいはデバッグ時に使用すると便利です。このプロパティを

True に設定すると、デバッグレベルのエラーチェックが有効になります。 VADebugMode を False に設定する

と、エラーチェックが無効になります。

130

VADecimal

VADecimal

適用対象


説明

固定小数点データ型フィールドの固定小数点以下の桁数を取得または設定します。

備考

Numeric データ型や Decimal データ型などの固定小数値型の格納フィールドの場合、 VADecimal プロパティはコ

ントロールに関連付けられているフィールドについて、小数点の右側に表示される桁数を返します。小数点以下

の桁数は、コントロールの VAccessName プロパティで指定された VAccess コントロールに関連付けられている

DDF ファイルから取り込まれます。

特定の固定小数値の格納データ型だけがこのプロパティを使用します。またこれは、ビット位置を示すためにビッ

トデータ型によっても使用されます。 Xtrieve も DDF 辞書でこのフィールドを使用して、 Note フィールドの区切

り文字の値を指定していました。


131


VAErrorDialog

適用対象VACommand

説明

Pervasive PSQL オペレーションがエラーとなったときに、ユーザーにダイアログボックスを表示するかどうかを

設定します。

備考

このプロパティが True の場合は、コマンドボタンによって実行された Pervasive PSQL オペレーションがエラー

となったとき、アプリケーションは実行時にユーザーへダイアログボックスを表示します。

このプロパティが False （デフォルト値）の場合は、コマンドボタンによって実行された Pervasive PSQL オペ

レーションがエラーになったとしても、コントロールは実行時にユーザーにエラーを知らせるダイアログボック

スを表示しません。代わりに、エラー状態を示すステータスコードを VAccess コントロールの Status プロパティ

で取得できます。

132

VAFieldName

VAFieldName

適用対象


説明

コントロールに関連付けられるフィールドのフィールド名を設定します。値の取得も可能です。

備考

フィールドバウンドコントロールの場合、このプロパティはコントロールのバインド先であるフィールドの

フィールド名を取得または設定します。このフィールドを、バウンドコントロールの VAccessName プロパティ

で指定した VAccess コントロールから提供される有効なフィールド名に設定すると、現在のレコード内の指定さ

れたフィールドにバインドされます。

VAccess コントロールが Extended オペレーションモードで、コントロールの SelectedFields プロパティにフィー

ルド選択条件が指定されている場合、フィールドバウンドコントロールがバインドできる有効なフィールド名

は、 VAccess コントロールの有効な ColumnName 値のセット（SelectedFields にリストされたフィールド）に限

定されます。

VACombo コントロールでインデックス選択専用のコンボボックスを実装する場合にも、このプロパティが使用

されます。これによってユーザーは、プログラム実行中に任意のインデックスパスの選択が可能になります。

VACombo を［Index Selection］ボックスにするには、VAFieldName プロパティの値として［Index List］を選択します。

複数列レコードリストモードの VAList コントロール（VARecordList プロパティが True）の場合は、VAFieldNameプロパティにはセミコロンで区切ったフィールドリストが入ります。

133


VAFormat

適用対象

VACombo、 VAList、 VAText

説明

このプロパティでは、コントロールによって表示されるフィールド値の書式文字列を指定できます。

備考

有効な書式文字列とその意味のリストについては、『Visual Basic 言語リファレンス』マニュアルで Format 関数を

参照してください。

複数列レコードリストモードの VAList コントロール（VARecordList プロパティが True）の場合は、 VAFormatプロパティにはセミコロンで区切った書式のリスト（コントロールの VAFieldName プロパティに指定されてい

るフィールドごとに 1 つの書式）が入ります。

VAFormat プロパティは Visual Basic で使用されるものと類似の書式文字列を使用してデータを整列するためのプ

ロパティです。 Visual Basic 共通の書式文字列（表 32 を参照）は事前に定義されており、日付および数値のカス

タム書式もサポートしています。これらの動作方法に関する詳細については、『Visual Basic 言語リファレンス』

を参照してください。

カスタム数値書式は、 Visual Basic によって提供される書式と同様に使用できますが、すべてのオプションがサ

ポートされているわけではありません。

埋め込み文字列リテラルの - + ( ) $ を使用できます。これによって電話番号を書式設定できます。

例： (000)000-0000

[\] または "" を使用するその他の埋め込み文字列は機能しません。

表 32 Visual Basic 共通の書式文字列

書式文字列説明

（空の文字列）デフォルトの書式。数値を General Number 書式、通貨金額を Currency 書式、日付と時刻を General Date書式、論理フィールドを True/False 書式で表示します。

General Number 千単位の区切り記号を付けずに、そのまま数値を表示します。

Currency 千単位の区切り記号を付けて数値を表示します。小数点以下は 2 桁まで表示します。出力はシステムの

ロケール設定に基づいて行われることに注意してください。

Percent 数値を 100 倍にして、右側にパーセント記号（%）を付けて表示します。小数点以下は常に 2 桁で表示

します。

True/False 数値が 0 の場合は False を、それ以外の場合は True を表示します。

General Date 日付か時刻、または両方を表示します。実数の場合は、日付と時刻（例 4/3/93 05:34 PM）を表示しま

す。小数部分がない場合は日付だけ（例 4/3/93）、整数部分がない場合は時刻だけ（例 05:34 PM）を表

示します。日付の表示はシステム設定によって決まります。

Long Date システムの長い日付書式に従って日付を表示します。

Short Date システムの短い日付書式に従って日付を表示します。

Long Time システムの長い時刻書式に従って、時分秒を含む時刻を表示します。

Short Time 24 時間制を使用して時刻を表示します（例 17:45）。

134

VAFormat

カスタマイズされた科学的表記は機能しません。

[0] のプレースホルダーは正常に機能します。明示的に制限されていない限り、浮動小数点値は小数桁を表示

します。

[#] のプレースホルダーは整数に対して有効です。浮動小数点値は予期せずに切り捨てられる場合があります

が、制限されていない限り小数桁を表示します。

曜日を使用する場合、午前 0 時に近い時刻では、丸めのエラーによって間違った曜日が表示される可能性があり

ます。

例

VAccess1.TableName = "Billing"VAText1.FieldName = "Amount_Due"VAText1.VAFormat = "Currency"VAText2.FieldName = "Log"VAText2.VAFormat = "mmm ddd yyyy"

135


VALockBias


説明

VACommand コントロールの VAOperation プロパティに指定された Pervasive PSQL オペレーションのロックバイ

アスを設定します。

備考

Pervasive PSQL は単一レコードロックおよび複数レコードロックともにサポートします。レコードロックが使

用されている場合、レコードは読み取り時にロックされます。 VALockBias プロパティは、 Open、 Close、 Insert、Update、または Delete の各オペレーションが VAOperation プロパティで指定されている場合、まったく効果が

ありません。

単一レコードロックは、別のレコードが読み取られるか、あるいはレコードが挿入、更新、または削除されるた

びに解放されます。複数レコードロックは、コントロールの Unlock メソッドを呼び出すことによって、個々の

レコードまたはすべてのレコードのロックを解放できます。

ロックエラーでの再試行はプログラマ自身で行ってください。

136

VAOffset

VAOffset

適用対象


説明

バインドされたフィールドの、レコードバッファーにおける格納オフセットを取得または設定します。

備考

オフセットは、コントロールの VAccessName プロパティで指定された VAccess コントロールに関連付けられて

いる DDF ファイルから取り込まれます。このプロパティは設計時には使用できません。

137


VAOperation


説明

VACommand が押されたときに実行される Pervasive PSQL オペレーションを取得または設定します。

備考

このプロパティでは、次のレコードオペレーションを実行できます。

表 33 VAOperation プロパティで使用可能なレコードオペレーション

0 - Open 関連する Pervasive PSQL データファイルを開きます。

1 - Close 関連する Pervasive PSQL データファイルを閉じます。

2 - Insert 現在のレコードバッファーの内容を新しいレコードとして挿入します。

3 - Update 現在のレコードをレコードバッファーの内容で更新します。

4 - Delete 現在のレコードを削除します。

5 - Get Equal 現在のインデックスパスで、指定されたキー値と正確に一致するキー値を持つ初のレコードを取得

します。

6 - Get Next 現在のインデックスパスで次のレコードを取得します。

7 - Get Previous 現在のインデックスパスで前のレコードを取得します。

8 - Get Greater 現在のインデックスパスで、指定されたキー値より大きいキー値を持つ初のレコードを取得します。

9 - Get Greater or Equal

現在のインデックスパスで、指定されたキー値と等しいか、より大きいキー値を持つ初のレコード

を取得します。

10 - Get Less 現在のインデックスパスで、指定されたキー値より小さいキー値を持つ初のレコードを取得します。

11 - Get Less or Equal

現在のインデックスパスで、指定されたキー値と等しいか、より小さいキー値を持つ初のレコード

を取得します。

12 - Get First 現在のインデックスパスで初のレコードを取得します。

13 - Get Last 現在のインデックスパスで後のレコードを取得します。

138

VARecordList

VARecordList

適用対象

VACombo、 VAList

説明

このプロパティを True に設定することによって、リストボックスあるいはコンボボックスコントロールのモー

ドがフィールドバウンドコントロールからレコードブラウザーに変わります。

備考

VARecordList プロパティによって、リストコントロールには保持できるだけのレコードが入ります。このリス

トの一番上にある項目は現在のレコードです（ただし、 VAAutoScroll プロパティが False に設定されている場合

を除きます。この場合は、選択されたリスト項目が現在のレコードを表します）。

VARecordList = True の場合は、いくつかの追加機能を利用でき、設計時にはプロパティページのボタンからア

クセスできます。 VAFieldName プロパティおよび VAFormat プロパティは、コントロールがフィールドバウン

ドモード（VARecordList プロパティが False）の場合にはエントリが 1 つに限定されますが、このモードでは、

それぞれセミコロンで区切ったフィールドのリストと書式のリストを格納することができます。また、

VAAutoScroll プロパティと ColumnWidth プロパティがアクティブになります。

139


VASearch

適用対象VAText

説明

VAText を参照テキストフィールドにできます。

備考

そのコントロールの VAFieldName プロパティは無効になり、現在バインドされているフィールドを記述するた

めに使用されるすべてのプロパティが無効になります。代わりに、テキストボックスは、バインドされている

VAccess の現在のインデックスの初のセグメントとは依然として同期したままです。ユーザーがテキストボッ

クスの内容を変更すると、 VAccess コントロールで GetGreaterOrEqual が実行されることになります。内容は別の

コントロール（たとえば、スクロールバーの移動あるいは GetEqual コマンド）によって発生した VAccess の位置

の変更を反映して変更されますが、テキストは反転表示されたままです。

140

VASize

VASize

適用対象


説明

現在選択されているフィールドに関連するデータのサイズを返します。サイズは VAccess コントロールに関連付

けられている DDF ファイルから取り込まれます。

141


VAValueFalse

適用対象

VACheck、 VAOption

説明

チェックボックスあるいはオプションボタンが選択されていないことを示す格納値を取得または設定します。

備考

VACheck および VAOption コントロールは、 VAValueTrue プロパティ値が論理フィールドで検出された場合にの

み選択されるようになります。選択された VACheck または VAOption がオフになると、このコントロールに関連

付けられたフィールドに VAValueFalse プロパティがセットされます。このプロパティに 0 をセットすると、 1 バイトの論理フィールドには 0 の文字値が書き込まれ、 2 バイトの論理フィールドには 0 の整数値が書き込まれま

す。数値範囲は、論理フィールドのサイズによって決定されます。 1 バイト論理フィールドでは 0 から 255 で、

2 バイト論理フィールドでは -32768 から 32767 です。

142

VAValueTrue

VAValueTrue

適用対象

VACheck、 VAOption

説明

チェックボックスあるいはオプションボタンが選択されていることを示す格納値を取得または設定します。

備考

VACheck および VAOption コントロールは、 VAValueTrue プロパティ値が論理フィールドで検出された場合にの

み選択されるようになります。選択された VACheck または VAOption がオンになると、このコントロールに関連

付けられたフィールドに VAValueTrue プロパティがセットされます。このプロパティに 1 をセットすると、 1 バイトの論理フィールドには 1 の文字値が書き込まれ、 2 バイトの論理フィールドには 1 の整数値が書き込まれま

す。数値範囲は、論理フィールドのサイズによって決定されます。 1 バイト論理フィールドでは 0 から 255 で、

2 バイト論理フィールドでは -32768 から 32767 です。

143


144

7
ActiveX メソッドリファレンス
この章では、 ActiveX アクセス方法のメソッドについて説明します。アルファベット順にメソッドを説明します。

145


AboutBox

適用対象

Vaccess、 VACombo、 VAList、 VACommand、 VAHScroll、 VAVScroll、 VAOption、 VAText

説明

ActiveX コントロールの著作権とバージョン情報を表示します。

146

AddItem

AddItem

適用対象

VACombo、 VAList

説明

フィールドバウンドモードで動作している VAList コントロールまたは VACombo コントロールに項目を追加し

ます。

構文

object.AddItem item, index

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

備考

index に有効な値を入力すると、 item が object 内の指定位置に配置されます。 index を省略すると、 item は適切に

ソートされた位置（Sorted プロパティが True に設定されている場合）か、一覧の後（Sorted プロパティが

False に設定されている場合）に追加されます。

レコードリストモードで動作している（VARecordList プロパティが True に設定されている） VAList コントロー

ルまたは VACombo コントロールは、 AddItem メソッドをサポートしません。

例

Private Sub Command1_Click()VAList1.AddItem (Text2.Text)End Sub

要素説明

object 必須。［適用対象］のオブジェクトを評価するオブジェクト式です。

item 必須。 object に追加する項目を指定する文字列式です。

index 省略可能。新規項目が配置されるオブジェクト内の位置を指定する整数です。 VAList コントロールまたは

VACombo コントロールの初の項目の場合、 index は 0 です。

147


Btrv

適用対象VAccess

説明

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

ペレーションのステータスを返します。

構文

object.Btrv opcode

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

備考

VAccess コントロールで実行可能な Pervasive PSQL 関数はどれでも、 Btrv メソッドを用いて使用することができ

ます。このメソッドは単一パラメーター、 opcode を使用します。 opcode 定数宣言は、 GLOBAL.BAS ファイル

（Visual Basic の場合）、 GLOBAL.PAS ファイル（Delphi の場合）および GLOBAL.H ファイル（Visual C++ の場合）

に含まれています。アプリケーションで opcode 定数を使用するには、これらのファイルのうち 1 つ、開発環境に

適したファイルをプロジェクトに含めます。

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

要素説明


opcode 必須。実行する Pervasive PSQL オペレーションを指定します。

コードグローバル定数説明

0 BTO_Open VAccess コントロールの TableName として指定された Pervasive PSQL ファイルテーブ

ルを開きます。

1 BTO_Close Pervasive PSQL テーブルを閉じます。

2 BTO_Insert Pervasive PSQL テーブルにメモリ内の現在のレコードを挿入します。

3 BTO_Update Pervasive PSQL テーブル内の現在のレコードをメモリ内の現在のレコードに含まれる

データで更新します。

4 BTO_Delete 現在のレコードをファイルから削除します。

5 BTO_GetEqual 指定された FieldValue に等しいインデックス値を持つ初のレコードを取得します。

6 BTO_GetNext 現在のインデックスパスで次のレコードを取得します。

7 BTO_GetPrevious 現在のインデックスパスで前のレコードを取得します。

8 BTO_GetGreater 指定された FieldValue のインデックス値より大きいインデックス値を持つレコードを

取得します。

9 BTO_GetGreaterOrEqual 指定された FieldValue のインデックス値より大きいか、等しいインデックス値を持つレ

コードを取得します。

148

Btrv

オペレーションコードにロックバイアスを加算することによって、 Pervasive PSQL のレコードをロックできま

す。 Btrv では Get または Step オペレーションにロックを指定することができます。ロックを解除する場合は、

Unlock メソッドを使用します。ロックバイアスは次のとおりです。

例

If Check1.Value = 1 Then stat = VAccess1.Btrv(5) 'GetEqualElse stat = VAccess1.Btrv(9) 'GetGreaterOrEqualEnd If

10 BTO_GetLess 指定された FieldValue のインデックス値より小さいインデックス値を持つレコードを

取得します。

11 BTO_GetLessOrEqual 指定された FieldValue のインデックス値より小さいか、等しいインデックス値を持つレ

コードを取得します。

12 BTO_GetFirst 現在のインデックスパスで初のレコードを取得します。

13 BTO_GetLast 現在のインデックスパスで後のレコードを取得します。

22 BTO_GetPosition Pervasive PSQL ファイル内の現在のレコードの物理位置を、 VAccess コントロールの

Position プロパティにセットします。

23 BTO_GetDirect VAccess コントロールの Position プロパティで指定されているレコードを取得します。

24 BTO_StepNext VAccess から、現在のレコードの物理的に次にあたる位置からレコードを取得します。

30 BTO_ClearOwner ファイルの現在のオーナーネームセキュリティをクリアします。メモ：ファイルは既

存のオーナーネームを使用して先に開いておく必要があります。

33 BTO_StepFirst ファイルの先頭の物理位置にあるレコードを取得します。

34 BTO_StepLast ファイルの末尾の物理位置にあるレコードを取得します。

35 BTO_StepPrevious VAccess から、現在のレコードの物理的に前にあたる位置からレコードを取得します。

ロックバイアスグローバル定数説明

200 BTO_SingleNoWait 単一レコードノーウェイトロックです。レコードが既にロックされている場合、

Pervasive PSQL はアプリケーションにステータスコード 84 （レコードが使用中）の

エラーを返します。

400 BTO_MultiNoWait 複数レコードノーウェイトロックです。レコードが既にロックされている場合、

Pervasive PSQL はアプリケーションにステータスコード 84 （レコードが使用中）の

エラーを返します。


149


Clear

適用対象

Vaccess、 VACombo、 VAList

説明

VAList または VACombo の内容をクリアし、 VAccess コントロールのデータバッファーとインデックスバッ

ファーの内容をクリアします。

構文

object.Clear

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

備考


ルまたは VACombo コントロールは、 Clear メソッドをサポートしません。

例

'データバッファーとすべてのバウンドコントロールをクリアするVAccess1.Clear

要素説明


150

Close

Close

適用対象VAccess

説明

VAccess コントロールに関連するファイルを閉じ、 Close オペレーションのステータスを返します。

構文

object.Close

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

備考

このメソッドは object に関連付けられているファイルを閉じ、そのオペレーションの Pervasive PSQL ステータス

コードを返します。戻り値がゼロであれば正常に実行されています。

例

If index > -1 Then ' リストから選択済み VAccess1.Close VAccess1.FileName = Combo1.List(index) VAccess1.OpenEnd If

要素説明


151


DdfAddIndex

適用対象VAccess

説明

DDF ファイルおよび対応する Pervasive PSQL ファイルにインデックスを追加します。正常に実行された場合は 0を、エラーが発生した場合は Pervasive PSQL ステータスコードを返します。

構文

object.DdfAddIndex indexList

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

戻り値

DdfAddIndex は、 VAccess コントロールのステータスを保持する 2 バイトの整数を返します。この値がゼロの場

合、オペレーションは正常に終了しています。

備考

DdfAddIndex は実際のデータファイル自体に indexList のインデックスを追加します。また、この関数は indexListのインデックスを VAccess コントロールのメタデータメモリイメージに追加します。RefreshLocations が True の場合、DdfAddIndex は現在のメモリイメージと一致するように DDF ファイルを更新します。DdfTransactionModeが True の場合、これらの操作はトランザクション内部で実行されます。

メモ DdfAddIndex はデータファイル自体のインデックス構造を変更します。注意して使用してください。

関連項目

IndexList、 RefreshLocations、 DdfTransactionMode、 DdfDropIndex

要素説明

object 必須。有効な VAccess コントロールの名前です。

indexList 必須。プロパティリファレンスの「IndexList」に記述されているように、2 次元配列のインデックス情報です。

152

DdfAddTable

DdfAddTable

適用対象VAccess

説明

TableName、Location、FieldList、IndexList の値によって定義される現在のテーブルを現在の DDF に追加します。

構文

object.DdfAddTable bOverwrite

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

戻り値

DdfAddTable は、 VAccess コントロールのステータスを保持する 2 バイトの整数を返します。この値がゼロの場


備考

DdfAddTable は VAccess コントロールの現在のメモリイメージにある情報を DDF ファイル自体に書き込みます。

bOverwrite が True の場合、コントロールは同じ名前を持つ既存テーブルを上書きします。 False の場合は、同名

のテーブルが（DdfPath プロパティで指定された）現在の DDF に存在すると、このメソッドはエラーとなります。

この関数はメタデータの VAccess メモリイメージやデータファイル自体を操作することはありません。新しい

空のテーブルをメタデータの VAccess メモリイメージに作成するには、 DdfAddTableName メソッドを使用しま

す。新しいテーブルを DDF および指定された場所にある対応する空のデータファイルに作成するには、

DdfCreateTable メソッドを使用します。

ほかの多くの辞書メソッドやプロパティと異なり、 DdfAddTable は RefreshLocations をチェックしません。これ

は DDF 情報を書き込むためだけに使用されるので、直接 DDF に書き込むことを想定しています。この動作は、

VAccess メモリイメージを使用して、一度のパスで DDF への変更を保管し、それらの変更を DDF へ書き込むつ

もりならば、 RefreshLocations を切り替える必要はないということです（『Pervasive PSQL Programmer's Guide』を参照）。

DdfTransactionMode が True の場合、 DDF への書き込みはトランザクション内部で実行されます。

例

' フィールド、インデックス、テーブル名、および場所は既に設定されているものと仮定VAEngine.FieldList = fieldsVAEngine.IndexList = indexesVAEngine.fileName = tableNameVAEngine.location = locationstatus = VAEngine.DDFAddTable(True)

関連項目

DdfAddTableName、 DdfCreateTable、 DdfTransactionMode

要素説明


bOverwrite 必須。既存のテーブル定義が存在する場合に、 VAccess コントロールがその定義を上書きするかどうかを指定

するブール値です。

153


DdfAddTableName

適用対象VAccess

説明

新しいテーブルを現在の VAccess コントロールメモリイメージに追加し、関連付けられている Location、FieldList、および IndexList を初期化して、新しいテーブル定義を辞書に追加できるようにします。

構文

object.DdfAddTableName tableName

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

戻り値

DdfAddTableName は、VAccess コントロールのステータスを保持する 2 バイトの整数を返します。この値がゼロ

の場合、オペレーションは正常に終了しています。

備考

DdfAddTableName は新規テーブルのメタデータを定義する際の初のステップです。これは、 VAccess コント

ロールのメモリイメージだけに影響します。そのため、 RefreshLocations または DdfTransactionMode の現在の

値の影響は受けません。

例

VAEngine.RefreshLocations = FalseVAEngine.DdfAddTableName tableNameVAEngine.DdfModifyLocation dataLocation' フィールドとインデックスを設定するVAEngine.FieldList = myFieldsVariantVAEngine.IndexList = myIndexVariant'DDF へ変更を書き込む'RefreshLocations のリセットは不要VAEngine.DdfAddTable(True)

関連項目

DdfAddTable、 DdfModifyTableName

要素説明


tableName 必須。 VAccess メモリイメージ内の新規テーブル名。これは、既存テーブル名は使用できません。既存テー

ブル名を使用するとメソッドはエラーとなります。

154

DdfClearFields

DdfClearFields

適用対象VAccess

説明

現在のテーブルの VAccess メモリイメージ（およびオプションで DDF）のフィールド情報をクリアします。

構文

object.DdfClearFields

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

戻り値

DdfClearFields は、 VAccess コントロールのステータスを保持する 2 バイトの整数を返します。この値がゼロの

場合、オペレーションは正常に終了しています。

備考

DdfClearFields は必ず VAccess メモリイメージの現在のフィールド情報を破棄します。RefreshLocations が Trueの場合は、FIELD.DDF の現在のテーブルのフィールド情報もすべて削除します。この副作用として、 INDEX.DDFは正しいフィールド情報を取得できなくなるため、このような状況が起こった場合には事実上、このテーブルの

メタデータはすべて破壊されます。このメソッドを呼び出す前に、 RefreshLocations を False に設定することを

強くお勧めします。

関連項目

FieldList、 RefreshLocations、 DdfTransactionMode

要素説明


155


DdfClearIndexes

適用対象VAccess

説明

現在のテーブルの VAccess メモリイメージ（およびオプションで DDF）のインデックス情報をクリアします。

構文

object.DdfClearIndexes

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

戻り値

DdfClearIndexes は、VAccess コントロールのステータスを保持する 2 バイトの整数を返します。この値がゼロの


備考

DdfClearIndexes は必ず VAccess メモリイメージの現在のフィールド情報を破棄します。 RefreshLocations がTrue の場合、 INDEX.DDF の現在のテーブルのすべてのインデックス情報も削除されます。このメソッドを呼び

出す前に、 RefreshLocations を False に設定することを強くお勧めします。

関連項目

DdfClearIndexes、 IndexList、 RefreshLocations、 DdfTransactionMode

要素説明


156

DdfCreateDictionary

DdfCreateDictionary

適用対象VAccess

説明

DdfPath プロパティによって指定された場所に一連の新たな空の DDF ファイルを作成します。これは、データの

テーブル、インデックス、フィールドを含んでいないデータ辞書を作成します。これらは DdfCreateTable、DdfAddTableName、 DdfAddTable、 DdfAddIndex を使用して追加する必要があります。

構文

object.DdfCreateDictionary bOverwrite

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

戻り値

DdfCreateDictionary は、 VAccess コントロールのステータスを保持する 2 バイトの整数を返します。この値がゼ

ロの場合、オペレーションは正常に終了しています。

備考

DdfCreateDictionary は FILE.DDF、 FIELD.DDF、 INDEX.DDF の各システムファイルを作成し、これらのファイ

ルに自己参照型のシステムテーブル定義レコードを設定します。また、拡張辞書ファイルの FIELDEXT.DDF とCOMMENT.DDF も作成します。

現在、指定された DdfPath パスに辞書が存在している場合、コントロールは bOverwrite をチェックして、現在の

辞書を削除して書き直すかどうかを判定します。 bOverwrite が True の場合、既存の辞書は破棄され、元に戻せな

くなります。

関連項目

DdfPath、 DdfTransactionMode

要素説明


bOverwrite 必須。既存の辞書が存在する場合に、 VAccess コントロールがそれを上書きするかどうかを指定するブール値

です。

157


DdfCreateTable

適用対象VAccess

説明

辞書にテーブル定義を追加し、 Location プロパティに指定されているパスとファイル情報、および FieldList とIndexList によって定義されている属性を使用して、空のデータファイルを作成します。

構文

object.DdfCreateTable bOverwrite

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

戻り値

DdfCreateTable は、 VAccess コントロールのステータスを保持する 2 バイトの整数を返します。この値がゼロの


備考

このメソッドは初に DdfAddTable を呼び出し、テーブル定義を辞書に追加します。もし、この呼び出しが何ら

かの理由で失敗した場合、たとえば、テーブル定義が既に存在していて bOverwrite が False の場合は、

DdfCreateTable も失敗します。DdfAddTable が正常に実行されると、このメソッドは Location を使って新たに空

のデータファイルを作成します。また bOverwrite パラメーターによって、 Location に存在するデータファイル

を上書きするかどうかを制御します。

ほかの多くの辞書メソッドやプロパティと異なり、DdfCreateTable は RefreshLocations をチェックしません。こ

れは VAccess メモリイメージに影響しないので、 DDF に直接書き込むことを想定しています。この動作は、

VAccess メモリイメージを使用して、一度のパスで DDF への変更を保管し、それらの変更を DDF へ書き込み、

テーブルを作成するつもりならば、 RefreshLocations を切り替える必要がないということです（『Pervasive PSQLProgrammer's Guide』を参照）。

例

' フィールド、インデックス、テーブル名、および場所は既に設定されているものと仮定VAEngine.RefreshLocations = FalseVAEngine.FieldList = fieldsVAEngine.IndexList = indexesVAEngine.TableName = tableNameVAEngine.Location = locationstatus = VAEngine.DDFCreateTable(True)

関連項目DdfAddTable

要素説明


bOverwrite 必須。既存のテーブル定義およびテーブルが存在する場合に、 VAccess コントロールがそれらを上書きするか

どうかを指定するブール値です。

158

DdfDropIndex

DdfDropIndex

適用対象VAccess

説明

現在の Pervasive PSQL データファイルからインデックスを削除します。また、 RefreshLocations が True の場合

は、現在のテーブルのデータ辞書定義からもインデックスを削除します。

メモ DdfDropIndex は、データファイル自体のインデックス構造を変更するので、正しく使用しないと非常

に危険です。データファイルを使用する既存プログラムは、この操作を実行した後は動作しなくなる可能性

があります。注意して使用してください。

構文

object.DdfDropIndex keynum

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

戻り値

DdfDropIndex は、 VAccess コントロールのステータスを保持する 2 バイトの整数を返します。この値がゼロの場


備考

DdfDropIndex は実際のデータファイル自体から指定されたインデックスを削除します。また、この関数は VAccessコントロールのメタデータメモリイメージからインデックスを削除します。 RefreshLocations が True の場合、

DdfDropIndex は現在のメモリイメージと一致するように DDF ファイルを更新します。 DdfTransactionMode がTrue の場合、これらの操作はトランザクション内部で実行されます。

ファイルの後のインデックス以外のインデックスを削除すると、すべてのインデックスの番号が付け替えられ

ます。たとえば、 5 つのインデックスがあるテーブル内で 3 番目のキーが削除されると、キー #3 がキー #2 に、

キー #4 がキー #3 になります。 DdfDropIndexMaintain を使用すると、テーブルのその他のキーを混乱させること

なく、インデックスを削除することができます。

例

'現在インデックスを使用しているアプリケーションをすべて終了するFor i = 0 To VAEngine.TotalKeys – 1 'TotalKeys の値はループを通るたびに 1 減算されるため、 '常にキー番号 0 が削除される status = VANew.DdfDropIndex(0) If status > 0 Then errorMsg = "Error occurred during Drop " _ + "Index " + CStr(i) + _ " operation.Btrieve status " + _

要素説明


keynum 必須。ファイルから削除されるキーの序数を表す整数です。

159


CStr(status) + ". " MsgBox errorMsg, vbExclamation End IfNext i

関連項目

IndexList、 RefreshLocations、 DdfAddIndex、 DdfDropIndexMaintain

160

DdfDropIndexMaintain

DdfDropIndexMaintain

適用対象VAccess

説明

現在の Pervasive PSQL データファイルからインデックスを削除します。 RefreshLocations が True の場合、既存

インデックスの順序を変更することなく、現在のテーブルのデータ辞書定義からインデックスを削除します。

構文

object.DdfDropIndexMaintain keynum

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

戻り値

DdfDropIndexMaintain は、 VAccess コントロールのステータスを保持する 2 バイトの整数を返します。この値が

ゼロの場合、オペレーションは正常に終了しています。

備考

DdfDropIndexMaintain は実際のデータファイル自体から指定されたインデックスを削除します。また、この関数

は VAccess コントロールのメタデータメモリイメージからインデックスを削除します。RefreshLocations が Trueの場合、 DdfDropIndex は現在のメモリイメージと一致するように DDF ファイルを更新します。

DdfTransactionMode が True の場合、これらの操作はトランザクション内部で実行されます。

DdfDropIndex とは異なり、 DdfDropIndexMaintain はほかの既存キーの序数値を変更しません。削除されたキー

を使用するアプリケーションだけが悪影響を受けます。

DdfDropIndexMaintain は、データファイル自体のインデックス構造を変更するので、正しく使用しないと非常に

危険です。データファイルを使用する既存プログラムは、この操作を実行した後は動作しなくなる可能性があり

ます。注意して使用してください。

例

' インデックス #1 を使用するアプリケーションだけを終了するstatus = VANew.DdfDropIndexMaintain(1)If status > 0 Then errorMsg = "Error occurred during Drop Index " + _ CStr(i) + " operation.Btrieve status " + _ CStr(status) + ". " MsgBox errorMsg, vbExclamationEnd If

関連項目

IndexList、 RefreshLocations、 DdfAddIndex、 DdfDropIndex

要素説明


keynum 必須。ファイルから削除されるキーの序数を表す整数です。

161


DdfDropTable

適用対象VAccess

説明

TableName で指定される現在のテーブルをデータ辞書から削除します。

構文

object.DdfDropTable

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

戻り値

DdfDropTable は、 VAccess コントロールのステータスを保持する 2 バイトの整数を返します。この値がゼロの場


備考

DdfDropTable は、現在のテーブルへのすべての参照を現在のデータ辞書から削除します。これはデータファイ

ルにはまったく影響しません。

ほかの多くの辞書メソッドやプロパティと異なり、 DdfDropTable は RefreshLocations をチェックしません。こ

れは DDF 情報を削除することだけを目的としているので、 DDF に直接書き込むことを想定しています。

関連項目

DdfAddTable、 DdfAddTableName、 TableName

要素説明


162

DdfGetFieldComments

DdfGetFieldComments

適用対象VAccess

説明

COMMENT.DDF ファイルからフィールドコメントを VAccess メモリイメージに読み取ります。

構文

object.DdfGetFieldComments

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

戻り値

DdfGetFieldComments は、 VAccess コントロールのステータスを保持する 2 バイトの整数を返します。この値が


備考

DdfGetFieldComments は VAccess メモリイメージのフィールドコメント情報を強制的にリフレッシュします。

DDF からメモリイメージを更新すると自動的にこの情報もリフレッシュされるので、この操作が必要になること

はまずありません。これは、 RefreshLocations が False に設定されていて、 DDF 情報が変わらない場合にのみ必要

となります。コメント情報はほかの DDF 情報とは共存しません。

ほかの多くの辞書メソッドやプロパティと異なり、 DdfGetFieldComments は RefreshLocations をチェックしま

せん。これは DDF からの情報を更新することだけを目的としているので、 DDF から直接読み取ることを想定し

ています。

例

' フィールドの取得Dim fields as VariantVAEngine.RefreshLocations = TrueVAEngine.DdfGetFieldComments = TrueVAEngine.TableName = tableName

fields = VAEngine.FieldListVAEngine.RefreshLocations = FalseIf not IsEmpty(fields) For i = 0 to ubound(fields, 2) ' フィールド名とコメントをリストボックスに配置する List.AddItem (fields(1,i) + fields(6, i)) Next iEnd If

関連項目FieldList

要素説明


163


DdfModifyLocation

適用対象VAccess

説明

現在のテーブルの場所を変更し、オプションとして DDF に新しい場所を書き込みます。

構文

object.DdfModifyLocation newLocation

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

戻り値

DdfModifyLocation は、VAccess コントロールのステータスを保持する 2 バイトの整数を返します。この値がゼロ

の場合、オペレーションは正常に終了しています。

備考

RefreshLocations が True の場合、新しいテーブルの場所は、データ辞書の FILE.DDF レコードでも更新されま

す。 False の場合は、 VAccess メモリイメージに対してのみ変更が行われます。 DdfAddTable を使用して後から

変更することもできます。

このメソッドにより、コントロールの Location プロパティの値も新しい場所を反映して変更されます。

DdfModifyLocation は自動的に Location プロパティを変更するので、DdfKeyUseIndexDDFOnly が False に設定さ

れている場合は、現在の IndexList の内容をクリアして、新しい場所のインデックス情報を基に内容を置き換えま

す（まだファイルが存在していなければ、内容をクリアします）。新たなファイルを作成する場合は、

DdfModifyLocation を呼び出す前ではなく、呼び出した後に IndexList プロパティを設定します。

例

VAEngine.RefreshLocations = TrueVAEngine.TableName = tableNameVAEngine.DdfModifyLocation(newLocation)

関連項目

Location、 RefreshLocations、 DdfAddTable、 DdfModifyTableName

要素説明


newLocation 必須。テーブルの新しい場所を含む文字列です。

164

DdfModifyTableName

DdfModifyTableName

適用対象VAccess

説明

現在のテーブルの名前を変更し、オプションとして DDF に新たな名前を書き込みます。

構文

object.DdfModifyTableName newName

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

戻り値

DdfModifyTableName は、 VAccess コントロールのステータスを保持する 2 バイトの整数を返します。この値が


備考

DdfModifyTableName は現在のテーブルを変更しません。要求された名前のテーブルが既に存在する場合はエ

ラーとなります。現在のテーブルを変更するには、 TableName プロパティを使用します。現在のテーブル一覧に

新しい空のテーブルを追加するには、 DdfAddTableName を使用します。

RefreshLocations が True の場合、新しいテーブル名は、データ辞書の FILE.DDF レコードでも更新されます。

False の場合は、 VAccess メモリイメージに対してのみ変更が行われます。 DdfAddTable を使用して後から変更

することもできます。

このメソッドにより、コントロールの TableName プロパティの値も新しい名前を反映して変更されます。

関連項目

RefreshLocations、 TableName、 DdfAddTable、 DdfAddTableName、 DdfModifyLocation

要素説明


newName 必須。テーブルの新しい名前を含む文字列です。

165


DdfSetOwner

適用対象VAccess

説明

辞書ファイルの Btrieve オーナーネームをデフォルトのオーナーネームとセキュリティレベル（読み取り専用ア

クセスが可能）以外に設定する際に使用できます。オーナーネームパラメーターとセキュリティレベルパラメー

ターは Btrieve の表記規則に準じます。

構文

object.DdfSetOwner(NewOwnerName, SecurityLevel)

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

備考

次のセキュリティレベルコードを DdfSetOwner の SecurityLevel パラメーターに渡すことができます。

定数宣言は、 GLOBAL.BAS ファイル（16 ビット Visual Basic の場合）、 GLOBAL.BAS ファイル（Visual Basic の場合）、 GLOBAL.PAS ファイル（Delphi の場合）および GLOBAL.H ファイル（Visual C++ の場合）に含まれま

す。アプリケーションでセキュリティレベル定数を使用するには、これらのファイルのうち 1 つ、開発環境に適

したファイルをプロジェクトに含めます。

例

Private Function SetDDFOwner(newOwner as String, _securityLevel as Integer) as Integer '続行するために確認が必要 VAEngine.RefreshLocations = True ' これを DDF に書き込む status = VAEngine.DdfSetOwner(newOwner, securityLevel) If status = 0 Then msg = "DDF Password has been successfully" & " changed."

要素説明


newOwnerName テーブルにオーナーネームを割り当てるための文字列です。

SecurityLevel セキュリティレベルを表す整数です。


0 EXCLUSIVE 正しいオーナーネームを指定しないとファイルを開くことができません。

1 READONLY オーナーネームを指定しないユーザーに対し、テーブルの表示は許可しますが、変

更は許可しません。

2 EXCLUSIVE_ENCRYPT 正しいオーナーネームを指定しないとファイルを開くことができません。データは

ファイル内で暗号化されます。

3 READONLY_ENCRYPT オーナーネームを指定しないユーザーに対し、テーブルの表示は許可しますが、変

更は許可しません。データはファイル内で暗号化されます。

166

DdfSetOwner

MsgBox msg, vbInformation Else msg = " Btrieve returned status " + CStr(status) + "." MsgBox msg, vbExclamation End IfEnd Function

167


DdfTestOwnerName

適用対象VAccess

説明

辞書を開く際に使用するオーナーネームを設定し、このオーナーネームを使用して辞書が正常に開き、更新でき

るかどうかを判定します。

構文

object.DdfTestOwnerName ownerName

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

戻り値

DdfTestOwnerName は、 VAccess コントロールのステータスを保持する 2 バイトの整数を返します。これがゼロ

の場合、現在の辞書のオーナーネームを使用して辞書を開き、更新することができます。

備考

VAccess コントロールによって使用されるデフォルトの辞書のオーナーネームは、通常、 DDF ファイルを読み取

りおよび更新用として開きます。ただし、一部の辞書ファイルではデフォルト以外のオーナーネームになってい

る場合もあります。この場合は、 DdfTestOwnerName を使用して辞書のオーナーネームを設定し、 DdfPath で指

定される現在の辞書に対して、そのオーナーネームをテストすることができます。

DdfTestOwnerName は初に辞書を開こうとします。正常に開いたら、そのオーナーネームでは更新が可能か、

あるいは読み取り専用かを調べるために、初のレコードの更新を試みます。返されたステータスは、そのオー

ナーネームでファイルを開けるか、修正できるか、あるいはどちらもできないかを示します。

関連項目

DdfSetOwnerName

要素説明


ownerName 必須。辞書のテスト対象の新しいオーナーネームです。これが空白の場合、 DdfTestOwnerName は現在の

辞書のオーナーネームを使用します。

168

Delete

Delete

適用対象VAccess

説明

現在のレコードを削除し、 Pervasive PSQL ステータスコードを整数値で返します。

構文

object.Delete

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

備考

このメソッドは object に関連付けられているファイルから現在のレコードを削除し、そのオペレーションの

Pervasive PSQL ステータスコードを返します。戻り値がゼロであれば正常に実行されています。

メモ ActiveX コントロールは、有効なカレンシーを維持するために Delete の後に GetNext オペレーションを

試行します。

例

Dim stat As IntegerVAccess1.IndexNumber = 1 'msa_descVAccess1.FieldValue("msa_desc") = Text1.Textstat = VAccess1.GetEqualIf stat = 0 Then stat = VAccess1.Delete If stat = 0 Then MsgBox "Deleted!" End IfElse MsgBox "Could not locate requested city"End If

要素説明

object 必須。［適用対象］のオブジェクトを評価するオブジェクト式を表します。

169


FormatFieldValue

適用対象VAccess

説明

指定の書式文字列を使用して書式設定された現在のレコードのフィールドの値を返します。

構文

object.FormatFieldValue (fieldname, formatstring)

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

備考

フィールドに書式が設定されている場合は、データ型に関わらず、そのフィールドの内容の値は必ず文字列とし

て返されます（コンテナーは自動的にこれを String、 Variant、 AnsiString またはほかの種類の文字データに解釈し

ます）。フィールドに書式が設定されていない場合、値はそのフィールドのデータ型とも近いバリアント

（Variant）として返されます。ほとんどのコントロールコンテナーは、バリアント（Variant）の戻り値を、文字

列（Sting）より簡単、迅速に操作でき、インターナショナル化や書式の再設定を行うことができます。そのため、

できれば書式設定されていないフィールドを取得することをお勧めします。

例

Label1.Caption = VAccess1.FieldValue("msa_desc")

Label2.Caption = VAccess1.FormatFieldValue("population", "##,###,###")

関連項目

FieldValue、 RowColumnValue、 Column

要素説明


fieldname object によって参照されるファイル内の有効なフィールドの名前です。

formatstring このパラメーターは、数値、日付、時刻の値について、 Visual Basic Format 関数と同じ書式文字列および標

準書式名をサポートします。

170

GetDirect

GetDirect

適用対象VAccess

説明

ファイル内で物理位置を使用してレコードを取得し、 Pervasive PSQL ステータスコードを整数値で返します。

構文

object.GetDirect [vLockBias]

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

備考

このメソッドは object に関連付けられているファイルから物理位置を使ってレコードを取得し、そのオペレー

ションの Pervasive PSQL ステータスコードを返します。戻り値がゼロであれば正常に実行されています。

要素説明


vLockBias 省略可能。レコードを取得する際にセットするレコードロックの種類を表す値です。デフォルトは 0 で、ロッ

クなしです。次のいずれかの定数を指定できます。

Const BTO_SingleNoWait = 200Const BTO_MultiNoWait = 400

171


GetEqual

適用対象VAccess

説明

現在のインデックスと正確に一致するレコードを取得し、Pervasive PSQL ステータスコードを整数値で返します。

構文

object.GetEqual [vLockBias]

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

備考

現在選択されているインデックスフィールドが、オペレーションの実行前にそのフィールドに指定された値と正

確に一致する値を含んでいる、ファイル内の初のレコードを取得します。

このメソッドを呼び出す前に、 IndexNumber プロパティによって指定されるインデックスを構成するフィールド

の値を設定します。キーフィールドが VA フィールドコントロールにバインドされている場合、その値はバウン

ドコントロールの内容を修正することによって設定されます。

これらの値をコードから設定するには、 FieldValue プロパティを使用します。オペレーションのステータスコー

ドはこのメソッドから返され、コントロールの Status プロパティにも設定されます。ステータスがゼロの場合は

正常に実行されたことを示します。

オペレーションの実行が成功するには、キーのすべてのセグメント内のすべてのフィールド、すべてのバイトが

同等である必要があります。ステータスコード 4 は、オペレーションの前にキーフィールドに設定された値が現

在のインデックスパスで検出されなかったことを示します。オルタネートコレーティングシーケンス（ACS）が

指定された文字列キーは、オルタネートコレーティングシーケンスを用いてキー値を解釈するとき、ファイル内

にそのキー値とバイト単位で同等のものがある場合にレコードを返します。これは、大文字と小文字を区別しな

い文字列キーの場合も同じです。

例

If Check1.Value = 1 Then stat = VAccess1.GetEqualElse stat = VAccess1.GetGreaterorEqualEnd If

要素説明





172

GetFirst

GetFirst

適用対象VAccess

説明

現在のインデックスパスの初のレコードを取得し、 Pervasive PSQL ステータスコードを整数値で返します。

構文

object.GetFirst [vLockBias]

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

備考

このメソッドは、 IndexNumber プロパティによって設定された、現在選択されているインデックスパスの初の

レコードを、object に関連付けられたファイルから取得します。オペレーションのステータスコードはこのメソッ

ドから返され、コントロールの Status プロパティに設定されます。ステータスがゼロの場合は正常に実行された

ことを示します。ステータス 9 は、現在のインデックスパスにはレコードがないことを示します。

Visual Basic では、リストボックスあるいはコンボボックスを追加するには GetFirst が必要です。

例

Orders.GetFirstOrders.InitOrders.GetNextExtended

要素説明


vvLockBias 省略可能。レコードを取得する際にセットするレコードロックの種類を表す値です。デフォルトは 0 で、

ロックなしです。次のいずれかの定数を指定できます。


173


GetGreater

適用対象VAccess

説明

現在のインデックスパスのキーよりも大きい初のレコードを取得し、Pervasive PSQL ステータスコードを整数

値で返します。

構文

object.GetGreater [vLockBias]

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

備考

このメソッドは、現在選択されているインデックスフィールドが、オペレーションの実行前にそのフィールドに

指定された値よりも大きい値を含んでいる初のレコードを、コントロールに関連付けられたファイルから取得

します。このオペレーションを実行する前に、 IndexNumber プロパティで指定されたインデックスを構成する

フィールドの値を設定する必要があります。

キーフィールドがフィールドコントロールにバインドされている場合、その値はバウンドコントロールの内容

を修正することによって設定されます。これらの値をコードから設定するには、 FieldValue プロパティを使用し

ます。

オペレーションのステータスコードはこのメソッドから返され、コントロールの Status プロパティに設定され

ます。ステータスがゼロの場合は正常に実行されたことを示します。ステータスコード 9 は、ファイル内のレ

コードには、オペレーションの前に指定された値より大きいキー値のレコードがないことを示します。

例

'姓が S で始まる初のレコードを検索するCustomers.IndexNumber = 1 '姓Customers.FieldValue("last_name") = "S"Customers.GetGreaterSelect Case Customers.Status Case 0 ' レコードを取得したが、条件に一致するかテストする必要がある。 'GetGreater メソッドはこのテストを行わない。 ' ファイルに "S" のレコードがない場合、このレコードは '"T"、 "U"、 "V" などである可能性がある。 If Left$(Customers.FieldValue("last_name"), 1) = "S" Then MsgBox "Found:" & Customers.FieldValue("last_name") Else MsgBox "No record was found." End If

要素説明


vLockBias 省略可能。レコードを取得する際にセットするレコードロックの種類を表す値です。デフォルトは 0 で、



174

GetGreater

Case Else MsgBox "No record was found."End Select

175


GetGreaterOrEqual

適用対象VAccess

説明

現在のインデックスパスのキーと等しいか、そのキーよりも大きい初のレコードを取得し、 Pervasive PSQL ステータスコードを整数値で返します。

構文

object.GetGreaterOrEqual [vLockBias]

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

備考


指定された値と等しいか、それよりも大きい値を含んでいる初のレコードを、コントロールに関連付けられた

ファイルから取得します。

このメソッドを呼び出す前に、 IndexNumber プロパティで指定されたインデックスを構成するフィールドの値を

設定します。

キーフィールドがフィールドコントロールにバインドされている場合、その値はバウンドコントロールの内容

を修正することによって設定されます。これらの値をコードから設定するには、 FieldValue プロパティを使用し

ます。



コードには、オペレーションの前に指定されたキー値と等しいか、そのキー値より大きいキー値を持つレコード

がないことを示します。

例

If Check1.Value = 1 Then stat = VAccess1.GetEqualElse stat = VAccess1.GetGreaterorEqualEnd If

要素説明





176

GetLast

GetLast

適用対象VAccess

説明

現在のインデックスパスの後のレコードを取得し、 Pervasive PSQL ステータスコードを整数値で返します。

構文

object.GetLast [vLockBias]

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

備考

このメソッドは、 IndexNumber プロパティによって設定された、現在選択されているインデックスパスの後の

レコードを、object に関連付けられたファイルから取得します。オペレーションのステータスコードはこのメソッ

ドから返され、コントロールの Status プロパティに設定されます。ステータスがゼロの場合は正常に実行された

ことを示します。ステータスコード 9 は、現在のインデックスパスにはレコードがないことを示します。

例

' も新しい日付のレコードを取得するCustomers.IndexNumber = 3 '入力日Customers.GetLast

要素説明





177


GetLess

適用対象VAccess

説明

キーフィールドに指定された値より小さい値を持つ現在のインデックスパスの後のレコードを取得し、

Pervasive PSQL ステータスコードを整数値で返します。

構文

object.GetLess [vLockBias]

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

備考


指定された値よりも小さい値を含んでいる後のレコードを、コントロールに関連付けられたファイルから取得

します。


設定します。キーフィールドがフィールドコントロールにバインドされている場合、その値はバウンドコント

ロールの内容を修正することによって設定されます。これらの値をコードから設定するには、 FieldValue プロパ

ティを使用します。



コードには、オペレーションの前に指定された値より小さいキー値のレコードがないことを示します。

要素説明





178

GetLessOrEqual

GetLessOrEqual

適用対象VAccess

説明

キーフィールドに指定された値と等しいか、その値より小さい値を持つ現在のインデックスパスの後のレコー

ドを取得し、 Pervasive PSQL ステータスコードを整数値で返します。

構文

object.GetLessOrEqual [vLockBias]

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

備考


指定された値と等しいか、それよりも小さい値を含んでいる後のレコードを、コントロールに関連付けられた

ファイルから取得します。


設定します。キーフィールドがフィールドコントロールにバインドされている場合、その値はバウンドコント

ロールの内容を修正することによって設定されます。これらの値をコードから設定するには、 FieldValue プロパ

ティを使用します。



コードには、オペレーションの前に指定されたキー値と等しいか、そのキー値より小さいキー値を持つレコード

がないことを示します。

要素説明





179


GetNext

適用対象VAccess

説明

現在のインデックスパスの次のレコードを取得し、 Pervasive PSQL ステータスコードを整数値で返します。

構文

object.GetNext [vLockBias]

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

備考

このメソッドは、 IndexNumber プロパティによって設定された、現在選択されているインデックスパスの次のレ

コードを、そのコントロールに関連付けられたファイルから取得します。

このメソッドを呼び出す前に、インデックスパスに現在の位置を確立しておく必要があります。


ます。ステータスがゼロの場合は正常に実行されたことを示します。ステータスコード 9 は、現在のインデック

スパスの現在のレコードには後続レコードがないことを示します。ステータスコード 8 は、そのメソッドを呼び

出す前に、現在のレコード上に位置が確立されていなかったことを示します。

例

'日付が 1 年以上古いレコードをすべて削除するCustomers.IndexNumber = 0 '顧客番号Customers.GetFirstDo If DateDiff("yyyy", Now, _ Customers.FieldValue("last_order_date")) > 0 Customers.Delete End If Customers.GetNextLoop While Customers.Status = 0

要素説明





180

GetNextExtended

GetNextExtended

適用対象VAccess

説明

現在のインデックスパスの次のレコードを Extended Fetch レコードセットとして取得し、 Pervasive PSQL ステー

タスコードを整数値で返します。

構文

object.GetNextExtended

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

備考

このメソッドはコントロールの ExtendedOps プロパティが False の場合、あるいは AutoMode が True に設定さ

れている場合はまったく効果がありません。

このメソッドは Pervasive PSQL Get Next Extended オペレーションを実行します。その際、コントロールの現在の

レコードとインデックス選択を使用して位置を確立し、 SelectedRecords プロパティと SelectedFields プロパ

ティに含まれる選択条件を使用します。

コントロールの IncludeCurrent プロパティが True の場合、 Extended Fetch オペレーションは現在のレコードから

開始します。このプロパティが False の場合、Extended Fetch オペレーションはレコードシーケンスの次のレコー

ドから開始します。 Init メソッドは自動的に IncludeCurrent プロパティを True に設定します。 GetNextExtendedメソッドは、自身が呼び出された後、 IncludeCurrent プロパティを False に設定します。

オペレーションが正常に実行されたら、生成されたレコードセット値を Row プロパティと Column プロパティ

を介して利用できます。オペレーションから返された行数および列数は、 Rows プロパティと Columns プロパ

ティで入手できます。また、メソッドから返される Pervasive PSQL ステータスコードは、 Status プロパティで入

手できます。ゼロ以外のステータスコードが必ずしもレコードが返されなかったことを示すわけではありませ

ん。 Rows プロパティの値をチェックし、戻された行数を判断してください。

このメソッドを呼び出す前に、任意のレコード選択条件とフィールド選択条件を SelectedRecords プロパティと

SelectedFields プロパティに設定し、次に Init メソッドを呼び出して必要な要求バッファー構造体を割り当てる

ことによって、先に Extended Fetch オペレーションのコントロールを設定しておく必要があります。 GetFirst やGetGreaterOrEqual などのインデックス付きレコードフェッチメソッドを使用して、インデックスパスの現在

のレコード位置を初に設定することによって、 Extended Fetch オペレーションを適化することもできます。



例

'Orders ファイルのレコードを読み取り、印刷するOrders.GetFirstOrders.InitDo Orders.GetNextExtended For r = 1 to Orders.Rows For c = 1 to Orders.Columns

要素説明


181


Debug.Print Orders.RowColumnValue(r,c) Next c Debug.Print '新しい行 Next rLoop While Orders.Status = 0

182

GetPrevious

GetPrevious

適用対象VAccess

説明

現在のインデックスパスの前のレコードを取得し、 Pervasive PSQL ステータスコードを整数値で返します。

構文

object.GetPrevious [vLockBias]

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

備考

このメソッドは、 IndexNumber プロパティによって設定された、現在選択されているインデックスパスの前のレ

コードを、そのコントロールに関連付けられたファイルから取得します。

このメソッドを呼び出す前に、インデックスパスに現在の位置を確立しておく必要があります。


ます。ステータスがゼロの場合は正常に実行されたことを示します。ステータスコード 9 は、現在のインデック

スパスの現在のレコードには後続レコードがないことを示します。ステータスコード 8 は、そのメソッドを呼び

出す前に、現在のレコード上に位置が確立されていなかったことを示します。

要素説明





183


GetPreviousExtended

適用対象VAccess

説明

現在のインデックスパスの前のレコードを Extended Fetch レコードセットとして取得し、 Pervasive PSQL ステー

タスコードを整数値で返します。

構文

object.GetPreviousExtended

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

備考

このメソッドは Pervasive PSQL Get Previous Extended オペレーションを実行します。その際、コントロールの現

在のレコードとインデックス選択を使用して位置を確立し、 SelectedRecords プロパティと SelectedFields プロ

パティに含まれる選択条件を使用します。



ドから開始します。




手できます。



ことによって、先に Extended Fetch オペレーションのコントロールを設定しておく必要があります。 GetLast やGetLessOrEqual などのインデックス付きレコードフェッチメソッドを使用して、インデックスパスの現在のレ

コード位置を初に設定することによって、 Extended Fetch オペレーションを適化することもできます。



要素説明


184

GetTableList

GetTableList

適用対象VAccess

説明

現在の辞書に定義されているテーブルのリストを 2 次元バリアント配列として返します。

構文

object.GetTableList

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

戻り値

GetTableList は、 VAccess コントロールのステータスを保持する 2 バイトの整数を返します。この値がゼロの場


備考

FieldList プロパティは、 2 次元バリアント配列をカプセル化するバリアントを受け付けます。あるいはそのバリ

アントを返します。初の添字はフィールドの序数を参照し、 2 番目の添字はフィールドの 1 つのプロパティを

参照します。 2 番目の添字が参照するプロパティは次のとおりです。

RefreshLocations プロパティが False の場合は、メモリにキャッシュされた近のテーブル一覧が返されます。

RefreshLocations が True の場合は、辞書から現在のテーブル一覧が再読み取りされます。このメソッドは

FieldList や IndexList とは違い、読み取りオペレーションしか行えず、更新は行えません。

例

VAEngine.RefreshLocation = TrueVAEngine.DDFPath = pathtables = VAEngine.GetTableList

関連項目

FieldList、 IndexList、 RefreshLocations

要素説明



0 tableID VT_I2 ファイルテーブル辞書エントリ用の固有のキーです。

1 tableName VT_BSTR テーブル名です。大半角 20 文字まで格納できます。

2 tableLocation VT_BSTR オペレーティングシステムまたはネットワークパスとテーブルによって参照

されるデータファイルのファイル名です。大半角 64 文字まで格納できます。

185


GetTotalSegments

適用対象VAccess

説明

VAccess コントロールに関連付けられているファイルの、特定のインデックスに含まれるセグメントの総数を返

します。

GetTotalSegments は下位互換性を提供するために用意されています。ほとんどの場合、インデックスプロパティ

は IndexList プロパティを使用して迅速に、しかも簡単に操作できます。

構文

object.GetTotalSegments(keynumber)

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

例

NumSegments% = _ VAccess1.GetTotalSegments(VAccess1.KeyNumber)

要素説明


keynumber 必須。チェック対象のインデックス番号です。

186

Init

Init

適用対象VAccess

説明

Pervasive PSQL Extended Fetch レコードセットオペレーションを実行する際に使用する構造体を、CacheRows プロパティ、 CacheRejectMax プロパティ、 SelectedFields プロパティ、および SelectedRecords プロパティから

提供されるパラメーターに基づいて強制的に初期化します。

Init は、初期化後 Extended オペレーションを呼び出す前に、あるいは SelectedRecords、 SelectedFields、CacheRows、または CacheRejectMax が変更されたときに必ず実行する必要があります。

構文

object.Init

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

備考

AutoMode が True に設定されている場合は、 Init メソッドを呼び出すと、初の Extended Fetch レコードセット

オペレーション（GetNextExtended）も実行されます。このオペレーションは論理カレンシーを必要とします。論

理カレンシーは、 GetFirst、 GetEqual などのインデックス付きのレコードオペレーションを呼び出すことによっ

て設定できます。



例 #1 - Automode = TrueVAccess1.GetFirstVAccess1.Init

例 #2 - Automode = FalseOrders.GetFirstOrders.InitOrders.GetNextExtended

要素説明


187


Insert

適用対象VAccess

説明

現在のデータバッファーを新規レコードとして挿入し、 Pervasive PSQL ステータスコードを整数値で返します。

構文

object.Insert

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

備考

このメソッドは object に関連付けられているファイルに現在のデータバッファーを新規レコードとして挿入し、

そのオペレーションの Pervasive PSQL ステータスコードを返します。戻り値がゼロであれば正常に実行されてい

ます。戻り値が 5 の場合は、ファイルに定義されている重複値を許可しないキーに対して使用されているデータ

バッファー内のフィールドが、ファイルに既存の別のレコードと同じ値を含んでいるため、レコードを挿入でき

なかったことを示します。


例

' レコードを検索し、そのレコードがない場合には挿入する'検索値を設定するCustomers.FieldValue("name") = "John Adams"' インデックスを設定し、検索を実行するCustomers.IndexNumber = 1 '顧客名Customers.GetEqual' レコードがない場合には挿入するSelect Case Customers.Status Case 0 MsgBox "The customer entry already exists." Case 4 Customers.Insert Case Is > 0 MsgBox "Error. Pervasive PSQL status = " + Customers.StatusEnd Select

要素説明


188

Open

Open

適用対象VAccess

説明

コントロールに関連付けられているファイルを開き、 Pervasive PSQL ステータスコードを整数値で返します。

構文

object.Open

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

備考

このメソッドは object に関連付けられているファイルを開こうとします。ファイルが既に開いている場合は、先

に閉じてから再度開きます。オペレーションのステータスコードはこのメソッドから返され、コントロールの

Status プロパティに設定されます。ステータスがゼロの場合は正常に実行されたことを示します。

例

If index > -1 Then ' リストから選択済み VAccess1.Close VAccess1.TableName = Combo1.List(index) VAccess1.OpenEnd If

要素説明


189


Refresh

適用対象

Vaccess、 VACombo、 VAList

説明

関連オブジェクトを強制的に即時更新します。

構文

object.Refresh

例

'データバッファーの内容を用いてバウンドコントロールをリフレッシュするVAccess1.Refresh

190

RemoveItem

RemoveItem

適用対象

VACombo、 VAList

説明

フィールドバウンドモードで動作している VAList コントロールまたは VACombo コントロールから項目を削除

します。

構文

object.RemoveItem index

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

備考


ルまたは VACombo コントロールは、 RemoveItem メソッドをサポートしません。

要素説明

object 必須。［適用対象］のオブジェクトを評価するオブジェクト式です。

index 必須。 object における削除対象項目の位置を表す整数です。 VAList コントロールまたは VACombo コントロール

の初の項目の場合、 index = 0 です。

191


RowColumnValue

適用対象VAccess

説明

Extended Fetch レコードセットの中から、指定された Row および Column を基にフィールド値を返します。

構文

object.RowColumnValue (row, column)

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

備考

このメソッドは、Row プロパティと Column プロパティを使って Extended Fetch レコードセットからフィールド

データを取得する方法のショートカットとして使用します。



例

'Extended Fetch レコードセットのすべての行を印刷するFor rowcount = 1 To Orders.Rows For colcount = 1 To Orders.Columns Debug.Print Orders.RowColumnValue(rowcount, colcount) Next colcount Debug.Print "" '新しい行Next rowcount

要素説明


row 必須。 Extended Fetch レコードセット内の有効な行を指定します。

column 必須。 Extended Fetch レコードセット内の有効な列を指定します。

192

SetFileFlag

SetFileFlag

適用対象VAccess

説明

Create メソッドを使って Btrieve ファイルを作成する前に、指定されたファイルフラグを設定します。

構文

object.SetFileFlag(flag, setting)

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

備考

定数宣言は、 GLOBAL.BAS ファイル（Visual Basic の場合）、 GLOBAL.PAS ファイル（Delphi の場合）および

GLOBAL.H ファイル（Visual C++ の場合）に含まれます。アプリケーションでファイルフラグ定数を使用するに

は、これらのファイルのうち 1 つ、開発環境に適したファイルをプロジェクトに含めます。

例

Stat = VAccess1.SetFileFlag(BTF_fTruncate, False)Stat = VAccess1.SetFileFlag(BTF_fDataCompression, False)Stat = VAccess1.SetFileFlag(BTF_fKeyOnly, False)Stat = VAccess1.SetFileFlag(BTF_fPreallocate, False)VAccess1.PageSize = 0Stat = VAccess1.DdfCreateTable(True)

要素説明


flag 必須。設定するファイルフラグです。

setting 必須。フラグの設定を指定します。 True または False を指定することができます。

193


SetOwner

適用対象VAccess

説明

SetOwner メソッドは、 Pervasive PSQL テーブルへのアクセスを制限するために、そのテーブルのオーナーネー

ムを指定する場合に使用されます。

構文

object.SetOwner(OwnerName, SecurityLevel)

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

備考

次のセキュリティレベルコードを SetOwner の SecurityLevel パラメーターに渡すことができます。


す。アプリケーションでセキュリティレベル定数を使用するには、これらのファイルのうち 1 つ、開発環境に適

したファイルをプロジェクトに含めます。

Pervasive PSQL テーブルからオーナーネームを削除するには、まずそのオーナーネームでテーブルを開き、次に

Btrv メソッドに BTO_ClearOwner オペレーションを発行します。

この値は辞書ファイルにアクセスする際に使用するオーナーネームには影響しません。一連の辞書ファイルの

オーナーネームを変更する場合は、 DdfSetOwner を使用します。

関連項目

OwnerName、 DdfSetOwner、 DdfTestOwnerName

要素説明


OwnerName テーブルに割り当てるオーナーネームです。

SecurityLevel セキュリティレベルを表す整数です。


0 EXCLUSIVE 正しいオーナーネームを指定しないとファイルを開くことができません。

1 READONLY オーナーネームを指定しないユーザーに対し、テーブルの表示は許可しますが、変

更は許可しません。

2 EXCLUSIVE_ENCRYPT 正しいオーナーネームを指定しないとファイルを開くことができません。データは

ファイル内で暗号化されます。

3 READONLY_ENCRYPT オーナーネームを指定しないユーザーに対し、テーブルの表示は許可しますが、変

更は許可しません。データはファイル内で暗号化されます。

194

ShowSelectedFieldsDlg

ShowSelectedFieldsDlg

適用対象VAccess

説明

このメソッドを呼び出すと、［Extended Query Field Selection］（拡張クエリフィールド選択）ダイアログボックス

が表示され、ここからユーザーは実行時に SelectedFields プロパティを変更できます。

構文

object.ShowSelectedFieldsDlg

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

備考

Extended Fetch のレコードあるいはフィールド選択基準を変更した後、GetNextExtended などの Extended Fetch メソッドを呼び出す前には、 Init メソッドを呼び出す必要があります。



例

'取得するフィールドをユーザーが選択できるようにする Customers.ShowSelectedFieldsDlg "Field Selection"

'現在のレコードの位置を再確立し、'Extended オペレーションバッファーを '新しいフィールド選択リストで初期化する Customers.GetFirst Customers.Init Customers.GetNextExtended

要素説明


195


ShowSelectedRecordsDlg

適用対象VAccess

説明

このメソッドを呼び出すと、［Extended Query Record Selection］（拡張クエリレコード選択）ダイアログボックス

が表示され、ここからユーザーは実行時に SelectedRecords プロパティを変更できます。

構文

object.ShowSelectedRecordsDlg

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

備考

Extended Fetch のレコードあるいはフィールド選択基準を変更した後、GetNextExtended などの Extended Fetch メソッドを呼び出す前には、 Init メソッドを呼び出す必要があります。



例

' レコードの選択基準をユーザーが選択できるようにする Customers.ShowSelectedRecordsDlg "Record Selection"

'現在のレコードの位置を再確立し、'Extended オペレーションバッファーを '新しいレコード選択基準で初期化するCustomers.GetFirstCustomers.InitCustomers.GetNextExtended

要素説明


196

Stat

Stat

適用対象VAccess

説明

現在のテーブルのステータスバッファーを強制的にリフレッシュします。

構文

object.Stat

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

戻り値

Stat は、 VAccess コントロールのステータスを保持する 2 バイトの整数を返します。この値がゼロの場合、オペ

レーションは正常に終了しています。

備考

Stat はステータスバッファーの更新を強制します。これによって PageSize、 TotalKeys、 PercentFreeSpace、PreallocatedPages、 ReservedDupPointers、 ACSName、 CollatingSequence、 FileVersion などのファイルパラメーター

とファイルフラグが更新されます。 Stat は、 DdfKeyUseIndexDDFOnly が False に設定されている場合は、ス

テータスバッファーのインデックス情報も更新します。 TotalRecords プロパティを取得する前に Stat を呼び出

す必要はありません。要求時に TotalRecords が Stat 呼び出しを実行します。

要素説明


197


StatusDialog

適用対象VAccess

説明

このメソッドを呼び出すと、実行時にゼロ以外の数値に設定される場合、タスクモードのメッセージボックスが

表示されます。一般的な Pervasive PSQL ステータスコードには説明が付きますが、あまり一般的でないステータ

スコードや認識されないステータスコードは報告されるだけです。

構文

object.StatusDialog [status]

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

例

If stat = 0 Then Text1.Text = VAccess1.FieldValue("msa_desc") Text2.Text = VAccess1.GetFieldValue("population", "##,###,###") Text3.Text = VAccess1.FieldValue(2)Else VAccess1.StatusDialog statEnd If

要素説明


status 省略可能。整数値です。値を指定しない場合は、 Status プロパティの現在値が使用されます。

198

StepFirst

StepFirst

適用対象VAccess

説明

物理レコードの格納順で初のレコードを取得し、 Pervasive PSQL ステータスコードを整数値で返します。

構文

object.StepFirst [vLockBias]

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

備考

このメソッドは、物理レコードが格納されている順で初のレコードを object に関連付けられたファイルから取

得します。オペレーションのステータスコードはこのメソッドから返され、コントロールの Status プロパティ

に設定されます。ステータスがゼロの場合は正常に実行されたことを示します。ステータス 9 は、ファイルにレ

コードがないことを示します。

要素説明





199


StepLast

適用対象VAccess

説明

物理レコードの格納順で後のレコードを取得し、 Pervasive PSQL ステータスコードを整数値で返します。

構文

object.StepLast [vLockBias]

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

備考

このメソッドは、物理レコードが格納されている順で後のレコードを object に関連付けられたファイルから取

得します。オペレーションのステータスコードはこのメソッドから返され、コントロールの Status プロパティ

に設定されます。ステータスがゼロの場合は正常に実行されたことを示します。ステータス 9 は、ファイルにレ

コードがないことを示します。

要素説明





200

StepNext

StepNext

適用対象VAccess

説明

物理レコードの格納順で次のレコードを取得し、 Pervasive PSQL ステータスコードを整数値で返します。

構文

object.StepNext [vLockBias]

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

備考

このメソッドは、物理レコードが格納されている順で次のレコードを object に関連付けられたファイルから取得

します。オペレーションのステータスコードはこのメソッドから返され、コントロールの Status プロパティに

設定されます。ステータスがゼロの場合は正常に実行されたことを示します。戻り値 9 は、ファイルの後に達

したことを示します。戻り値 8 は、このメソッドが呼び出される前に現在のレコード位置が確立されていなかっ

たことを示します。

要素説明





201


StepNextExtended

適用対象VAccess

説明

ファイルから物理レコードの格納順で次のレコードを Extended Fetch レコードセットとして取得し、 PervasivePSQL ステータスコードを整数値で返します。

構文

object.StepNextExtended

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

備考

このメソッドは Pervasive PSQL Step Next Extended オペレーションを実行します。その際、現在のレコードを使用

して開始位置を確立し、 SelectedRecords プロパティと SelectedFields プロパティに含まれる選択条件を使用し

ます。







手できます。



ことによって、先に Extended Fetch オペレーションのコントロールを設定しておく必要があります。 StepFirst などのシングルレコードフェッチメソッドを使用して、ファイルの現在のレコード位置を先に設定することもで

きます。



要素説明


202

StepPrevious

StepPrevious

適用対象VAccess

説明

物理レコードの格納順で前のレコードを取得し、 Pervasive PSQL ステータスコードを整数値で返します。

構文

object.StepPrevious [vLockBias]

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

備考

このメソッドは、物理レコードが格納されている順で前のレコードを object に関連付けられたファイルから取得

します。オペレーションのステータスコードはこのメソッドから返され、コントロールの Status プロパティに

設定されます。ステータスがゼロの場合は正常に実行されたことを示します。戻り値 9 は、ファイルの初に達

したことを示します。戻り値 8 は、このメソッドが呼び出される前に現在のレコード位置が確立されていなかっ

たことを示します。

要素説明





203


StepPreviousExtended

適用対象VAccess

説明

ファイルから物理レコードの格納順で前のレコードを Extended Fetch レコードセットとして取得し、 PervasivePSQL ステータスコードを整数値で返します。

構文

object.StepPreviousExtended

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

備考

このメソッドは Pervasive PSQL Step Previous Extended オペレーションを実行します。その際、現在のレコードを

使用して開始位置を確立し、 SelectedRecords プロパティと SelectedFields プロパティに含まれる選択条件を使

用します。







手できます。



ことによって、先に Extended Fetch オペレーションのコントロールを設定しておく必要があります。 StepLast などの単一レコードフェッチメソッドを使用して、ファイルの現在のレコード位置を先に確立することもできま

す。



要素説明


204

Transaction

Transaction

適用対象VAccess

説明

Transaction 関数は、アプリケーション内での Pervasive PSQL トランザクション処理を制御します。Pervasive PSQLトランザクションを開始、終了、中止する場合に使用できます。

構文

object.Transaction iOperationCode

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

備考

トランザクション処理は Pervasive PSQL レコードマネージャーのデータ整合性機能です。その目的は、さまざま

なテーブルに関連する一連の更新作業において、すべての更新を正常に実行するか、またはすべての更新をロー

ルバックして、参照整合性を確実に保つことです。

Transaction メソッドでサポートされる操作は次のとおりです。ここに挙げられていないオペレーションコード

に対してはステータスコード 1、無効なオペレーションが返されます。


す。アプリケーションで Transaction 定数を使用するには、これらのファイルのうち 1 つ、開発環境に適したファ

イルをプロジェクトに含めます。

要素説明


メモ：このプレースホルダーは ActiveX アーキテクチャの要件にすぎず、object に接続されているファイ

ルのトランザクションの適用範囲を制限するものではありません。トランザクションの開始メソッドと

終了メソッドの間にネストされた、ファイルの挿入、更新、削除はすべてトランザクションに含まれます。

iOperationCode 必須。実行するトランザクション操作を指定します。

コード定数説明

19 BTO_BeginTransaction 排他トランザクションを開始します。ほかのプロセスはこのトランザクションが終

了しない限り、トランザクションに関与しているファイルにアクセスできません。

20 BTO_EndTransaction トランザクションを終了し、そのトランザクションが開始してからファイルに対し

て行われた変更をコミットします。

21 BTO_AbortTransaction Begin Transaction オペレーションの開始以後にファイルに対して行われた変更を破

棄し、トランザクションを終了します。

1019 BTO_BeginTransaction + 1000 並行トランザクションを開始します（Pervasive.SQL バージョン 6 以降に対応 - それ

より前のバージョンでは、ステータスコード 1 を返します）。ほかのプロセスも、

トランザクションによって影響を受けるファイルにアクセスできます。

205


例

'並行トランザクションを開始するstatus% = Customers.Transaction(BTO_BeginTransaction + 1000)

If status% = 0 Then 'BeginTransaction は正常終了 '注文レコードを追加する status% = status% + Orders.Insert

'請求レコードを追加する status% = status% + Invoices.Insert

'顧客レコードを取得して修正する Customers.IndexNumber = 1 '顧客 ID Customers.FieldValue("custID") = _ Invoices.FieldValue("custID")

status% = status% + Customers.GetEqual Customers.FieldValue("lastInvoiceDate") = Invoices.FieldValue("InvoiceDate")

balance = Customers.FieldValue("balance") + Invoice.FieldValue("amount")

Customers.FieldValue("balance") = balance status% = status% + Customers.UpdateEnd If

If status% = 0 Then 'すべての変更が正常に終了。トランザクションをコミットする。 Customers.Transaction(BTO_EndTransaction)Else '1 つまたは複数の挿入に失敗。トランザクションを中止する。 Customers.Transaction(BTO_AbortTransaction)End If

206

Unlock

Unlock

適用対象VAccess

説明

Btrv メソッドに渡される Get または Step オペレーションコードにロックバイアスコードを加算することによっ

て Pervasive PSQL テーブルのレコードにセットされた、単一レコードロックおよび複数レコードロックを解除

します。

構文

object.Unlock(iLockType)

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

備考

Unlock メソッドに渡すことができるロックタイプのコードは次のとおりです。


す。アプリケーションで Unlock 定数を使用するには、これらのファイルのうち 1 つ、開発環境に適したファイ

ルをプロジェクトに含めます。

要素説明


iLockType 必須。削除対象となるレコードロックの種類です。

要素定数説明

0 UL_Single 現在のレコードから単一レコードロックを削除します。

-1 UL_CurrentMultiple 現在のレコードから複数レコードロックを削除します。

-2 UL_AllMultiple テーブル内のロックされているレコードからすべての複数レコードロックを削除します。

207


Update

適用対象VAccess

説明

現在のレコードを現在のデータバッファーの内容で更新し、Pervasive PSQL ステータスコードを整数値で返しま

す。

構文

object.Update

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

備考

このメソッドは object に関連付けられているファイルの現在のレコードを現在のデータバッファーの内容で更

新し、そのオペレーションの Pervasive PSQL ステータスコードを返します。戻り値がゼロであれば正常に実行さ

れています。

戻り値が 5 の場合は、ファイルに定義されている重複値を許可しないキーに対して使用されているデータバッ

ファー内のフィールドが、ファイルに既存の別のレコードと同じ値を含んでいるため、レコードを更新できなかっ

たことを示します。戻り値が 80 の場合は、矛盾が発生したことを示します。つまり、そのレコードは読み込まれ

た時点から Update メソッドが呼び出された時点までの間に、別のプロセスによって更新されているということ

です。


例

' レコードを検索し、会社名を変更して、レコードを更新する'検索値を設定するCustomers.FieldValue("name") = "John Harbison"

' インデックスを設定し、検索を実行するCustomers.IndexNumber = 1Customers.GetEqual

' レコードが存在する場合は、会社名を変更して、' レコードを更新するSelect Case Customers.Status Case 0 Customers.FieldValue("company_name") = "Harbison Consulting" Customers.Update Case 4 MsgBox "Record not found." Case Else MsgBox "Error. Pervasive PSQL status = " + Customers.StatusEnd Select

要素説明


208

8
ActiveX イベントリファレンス
この章では、以下のイベントについて説明します。

「CommError」

「Logon」

「OnRemote」

「Reposition」

「Validate」

209


CommError

適用対象

VAccess コントロール

説明

（非推奨 - 以前の I*net Data Server のみ） IDS 通信エラーが発生すると必ず発生します。 Vaccess コントロールで

IDS との通信を試みなければ、このイベントは発生しません。

構文

Sub VAccess_CommError (ByVal bCanRecover As Boolean, ByVal wsaeErrCode As Integer, ByVal errorString As String, bReTry As Boolean)

備考

CommError イベントは、広範囲にわたって使用する必要があります。可能性のあるエラーすべてに特別な処理

が必要なわけではありませんが、長期間にわたってクライアントの満足を得るためには次のことが重要です。そ

れは、アプリケーションに関連するエラーが発生したときに、そのエラーとエラーの解決のためにアプリケーショ

ン内で実行が必要な手順を、画面上で説明することです。

CommError には 4 つのパラメーターがあります。そのうちの 1 つは、ユーザーが設定することができます。

初のパラメーターの bCanRecover はブール型で、エラーが回復可能かどうかを示します。 2 番目のパラメーター

の wsaeErrCode には、該当するエラーの WinSock エラーコードが入ります。3 番目のパラメーターの errorStringには、エラーの説明が入ります。後に、 4 番目のパラメーターの bReTry では、クライアントとサーバー間の通

信の再確立を試行する必要があるかどうかを、アプリケーションを使って設定することができます。初のパラ

メーターの bCanRecover が False の場合、 bReTry の設定は無効になります。

210

Logon

Logon

適用対象


説明

（非推奨 - 以前の I*net Data Server のみ）このイベントを使用すると、サーバーへのログオンプロセスのカスタム

処理が可能になります。 VAccess コントロールが保護された IDS サーバーにログオン中で、 AutoLogon が Falseに設定されていなければ、このイベントは発生しません。

構文

Sub VAccess_Logon(user As String, password As String, database_set As String)

備考

このイベントは、 AutoLogon プロパティが False に設定されているときにのみ発生します。このイベントにはア

プリケーションから設定する必要のある 3 つの文字列パラメーター、 user、 password、および database_set があり

ます。 Logon イベントが発生し、イベントからの情報が Logon 成功というものではなかった場合、 CanRecover パラメーターが True に設定された CommError イベントが発生します。再度ログオンを試行する場合は、 Retry パラメーターを True に設定します。これにより、 ActiveX によって Logon イベントがもう一度発生します。

AutoLogon が False の場合、このイベントのハンドラーでは、処理から抜け出すメカニズムを用意しておくこと

が必要です。そうしないと、無限ループが発生する可能性があります。

211


OnRemote

適用対象


説明

（非推奨 - 以前の I*net Data Server のみ） VAccess がデータファイルあるいはデータ辞書へローカルで接続できな

い場合に必ず発生します。

構文

Sub VAccess_OnRemote(ByRef goRemote As Boolean, ByRef newLocation As String)

備考

このイベントは、 ActiveX コントロールが IDS サーバーとの接続を試みる前、または指定されたパスをローカル

な場所に解決できなかった場合に発生します。このイベントにはブール型の goRemote と、文字列の newLocationの 2 つのパラメーターがあります。ブール型の goRemote は、 ActiveX が IDS サーバーとの接続を試行するかどう

かを示します。これは DDFPath または Location プロパティがリモートアドレスに解決されたときに発生します。

goRemote が True か False かに応じて、DDFPath または Location が以下の条件のうちの 1 つを満たす場合に、そ

のような解決が生じます。

goRemote が True の場合

指定されたサーバー名がローカルネットワークに存在せず、IDSHOSTS ファイルにマップが見つかった

とき。

指定したドライブがオペレーティングシステムによってマップされずに、IDSHOSTS ファイルでマップ

されているとき。

場所が pids プロトコルを使って指定されているとき。

場所がインターネットサーバープロトコルまたは IP 表記で指定されているとき。

HostAddress が指定されているとき goRemote が False の場合

指定されたサーバー名がローカルネットワークに存在せず、IDSHOSTS ファイルでマップされていない

とき。

指定したドライブがオペレーティングシステムによってマップされず、IDSHOSTS ファイルでもマップ

されていないとき。

newLocation には解決されたパスが入ります。 DdfPath または Location で指定されている場所が IDSHOSTS ファ

イルを使用して解決された場合、 newLocation には完全パスが入ります。 newLocation と goRemote は参照によって

渡されるため、ユーザーはパスを変更したり、 ActiveX に IDS サーバーとの接続の試行を続けるか中止するかを

指示することができます。

メモ newLocation がローカルパスに変更されても、ActiveX はローカルで接続を試行することはありません。

関連項目

DdfPath、 Location、『Pervasive PSQL Programmer's Guide』

212

Reposition

Reposition

適用対象


説明

Reposition イベントは、レコードオペレーションが VAccess コントロールによって参照された現在のレコードを

変更した後に発生します。このイベントは、 VAccess コントロールに関連付けられている現在のレコードが変更

されたことをプログラムに通知します。新しいレコードが現在のレコードになった後にこのイベントが発生しま

す。

構文Sub VAccess_Reposition([Index As Integer])

213


Validate

適用対象


説明

このイベントは、関連する Pervasive PSQL ファイルに対して何らかのレコードオペレーションが行われる前に発

生します。

構文

Sub VAccess_Validate([Index As Integer,]OpCode As Integer, InsertRecord As Integer, UpdateRecord As Integer)

備考

OpCode は、実行される Pervasive PSQL API オペレーションのコードに相当します。このコードをほかのオペレー

ションコードに設定すると、実行されるオペレーションが変わります。このコードをゼロに設定すると、オペ

レーションがキャンセルされます。 InsertRecord または UpdateRecord のどちらかを True に設定すると、 OpCodeで指定されたオペレーションを実行する前に、設定に応じて現在のレコードが挿入または更新されます。このイ

ベントに応答して、関連する VAccess コントロールを使用して Btrv 関数を呼び出したり、 VAccess コントロール

のレコードオペレーションプロパティを設定したりしないでください。無限のループに陥ったり、ほかの予期し

ない結果を引き起こすことがあります。

214

Documents

PSQL ActiveX Guide...免責事項 Pervasive Software Inc. は、本ソフトウェアおよびドキュメントの使用を、利用者また はその会社に対して「現状のまま」で、かつ同梱の使用許諾契約書に記載の契約条件

PSQL ActiveX Guide...免責事項 Pervasive Software Inc. は、本ソフトウェアおよびドキュメントの使用を、利用者またはその会社に対して「現状のまま」で、かつ同梱の使用許諾契約書に記載の契約条件