PSQL_ActiveX_Guide.book

Transcription

1 Pervasive PSQL v10 SP3 ActiveX Controls Guide Developing Applications Using Pervasive PSQL ActiveX Controls

2 免責事項 商標 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 Database Architecture Pervasive.SQL Pervasive PSQL Solution Network Ultralight ZDBA は Pervasive Software Inc. の商標です Microsoft MS-DOS Windows Windows 95 Windows 98 Windows NT Windows Me Windows 2000 Windows XP Windows Server 2003 Win32 Win32s および Visual Basic は Microsoft Corporation の登録商標です NetWare および Novell は Novell, Inc. の登録商標です NetWare Loadable Module NLM Novell DOS Transaction Tracking System TTS は Novell, Inc. の商標です Sun Sun Microsystems Java および Sun Solaris Java を含むすべての商標やロゴは Sun Microsystems の商標または登録商標です すべての会社名および製品名は各社の商標または登録商標です Copyright 2009 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 DUNDAS SOFTWARE LTD. All rights reserved. 本製品には Apache Software Foundation Foundation ( により開発されたソフトウェアが含まれています Apache Software License を参照してください 本製品ではフリーソフトウェアの unixodbc Driver Manager を使用しています これは Peter Harvey (pharvey@codebydesign.com) によって作成され Nick Gorham (nick@easysoft.com) により変更および拡張されたものに Pervasive Software が一部修正を加えたものです Pervasive Software は unixodbc Driver Manager プロジェクトの LGPL 使用許諾契約書に従って このプロジェクトの現在の保守管理者にそのコード変更を提供します unixodbc Driver Manager の Web ページは にあります このプロジェクトに関する詳細については 現在の保守管理者である Nick Gorham (nick@easysoft.com) にお問い合せください GNU Lesser General Public License (LGPL) は本製品の配布メディアに含まれています LGPL は でも見ることができます ActiveX Controls Guide 2009 年 11 月

3 目次 このマニュアルについて xiii このマニュアルの読者 xiv このマニュアルの構成 xv 表記上の規則 xvi 1 ActiveX の概要 ActiveX インターフェイスの概要 開発環境 サードパーティデータバウンドコントロール ActiveX コントロールオブジェクト ActiveX インターフェイスの選択 ActiveX インターフェイスを利用するとき 重要な機能 VB 内のデータアウェアコントロールのデータソース フィールドレベルアクセス プロパティおよびメソッドインターフェイス Extended オペレーション DDF ActiveX DDF アクセスメソッド リモートデータアクセス 結合テーブル ActiveX インターフェイスでは使用できない Pervasive PSQL 機能 SQL 構文 チャンクオペレーション 非常に大きなレコード 複数の ACS を使用するファイルの作成 データ型 URI 構文 ActiveX コントロールを使用する最初の手順 Pervasive PSQL Control Center を使用してデータベースを作成する Visual Basic と Delphi への ActiveX インターフェイスのインポート ActiveX クイックスタート ファイルとディレクトリ ActiveX インターフェイスを使用したアプリケーションの作成 プロジェクトへの ActiveX インターフェイスの追加 VAccess コントロールの使用 iii

4 目次 プロパティへのアクセス プロパティの設定 Pervasive PSQL ファイルへの接続 インデックスの選択 自動と手動のファイルオープンの設定 データソースへのバウンドコントロールのリンク レコードの取得 特定のレコードの検索 レコードの追加 更新および削除 レコードのロック ファイルの結合 Extended オペレーションの有効化 Pervasive PSQL ActiveX ファイルの配布と登録 ActiveX インターフェイスに関する追加情報 ActiveX でのデータ辞書メソッドの使用 ActiveX データソースコントロールによる DDF の処理 ファイルの内容とメモリイメージ 辞書の読み取り DDF の変更 テーブル定義の作成 辞書の作成 データファイルの変更 その他の DDF 操作 オーナーネームによる DDF の保護 既存のフィールドとインデックス情報の削除 永続的な DDF メモリイメージによるコメントの強制設定 広範囲の影響を与えるメソッド ActiveX コントロールリファレンス VAccess データソース VACheck VACombo VACommand VAHScroll と VAVScroll VAList VAOption VAText iv

5 目次 5 カテゴリ別プロパティ メソッド およびイベント はじめに レコードセットの取得 (Extended オペレーション ) プロパティとメソッド イベント ファイルの処理 プロパティとメソッド データ辞書メソッド プロパティとメソッド レコード内のフィールドへのアクセス プロパティとメソッド レコードの挿入 更新 および削除 プロパティとメソッド イベント 個別レコードの取得 プロパティとメソッド イベント 最適化とデバッグ プロパティとメソッド ActiveX プロパティリファレンス AutoDialog AutoLogon AutoMode AutoOpen Buffer CacheRejectMax CacheRows CancelDialog Column ColumnName Columns ColumnWidth CompressData DatabaseName DataLength DdfKeyUseIndexDDFOnly DdfPath DdfTransactionMode v

6 目次 ExtendedOps FieldList Fields FieldValue FileVersion FireEvents FocusSelText HostAddress HostConnect IncludeCurrent IndexList IndexNumber IntegralHeight Join KeyNumber List Location Locked MaxBufferSize MaxLength OemString OpenMode OwnerName PageSize Percentage Port Position RefreshLocations Row RowPosition Rows SelectedFields SelectedRecords SessionID Status TableName TimeOutVal TotalRecords Uppercase vi

7 目次 VAccessName VAAutoScroll VADataType VADebugMode VADecimal VAErrorDialog VAFieldName VAFormat VALockBias VAOffset VAOperation VARecordList VASearch VASize VAValueFalse VAValueTrue ActiveX メソッドリファレンス AboutBox AddItem Btrv Clear Close DdfAddIndex DdfAddTable DdfAddTableName DdfClearFields DdfClearIndexes DdfCreateDictionary DdfCreateTable DdfDropIndex DdfDropIndexMaintain DdfDropTable DdfGetFieldComments DdfModifyLocation DdfModifyTableName DdfSetOwner DdfTestOwnerName Delete vii

8 目次 FormatFieldValue GetDirect GetEqual GetFirst GetGreater GetGreaterOrEqual GetLast GetLess GetLessOrEqual GetNext GetNextExtended GetPrevious GetPreviousExtended GetTableList GetTotalSegments Init Insert Open Refresh RemoveItem RowColumnValue SetFileFlag SetOwner ShowSelectedFieldsDlg ShowSelectedRecordsDlg Stat StatusDialog StepFirst StepLast StepNext StepNextExtended StepPrevious StepPreviousExtended Transaction Unlock Update ActiveX イベントリファレンス CommError viii

9 目次 Logon OnRemote Reposition Validate ix

10 図 1-1 ActiveX の取り込みダイアログボックス (Delphi) プロパティページダイアログボックス VAccess プロパティを表示するプロパティウィンドウ データに接続するためのプロパティの設定 IndexNumber プロパティの設定 複数列リストボックスのタブ設定 結合テーブル例 x

11 表 1-1 組み込まれている ActiveX コントロールオブジェクト ActiveX インターフェイスファイル 個々のレコードを取得するためのメソッド 特定のレコードを取得するためのメソッド レコードを追加 更新および削除するためのカスタムメソッド 再配布可能なファイル VAccess カスタムプロパティ VAccess カスタムメソッド VAccess カスタムイベント VACheck カスタムプロパティ VACheck カスタムメソッド VACombo カスタムプロパティ VACombo カスタムメソッド VACommand カスタムプロパティ VAHScroll と VAVScroll のカスタムプロパティ VAList カスタムプロパティ VAList カスタムメソッド VAOption カスタムプロパティ VAOption カスタムメソッド VAText カスタムプロパティ VAText カスタムメソッド Extended オペレーション用プロパティおよびメソッド Extended オペレーション用イベント ファイルの処理用プロパティおよびメソッド データ辞書処理用プロパティおよびメソッド レコード内のフィールドへのアクセス用プロパティおよびメソッド レコードの挿入 更新 および削除用プロパティおよびメソッド レコードの挿入 更新 および削除用イベント 個別レコード取得用プロパティおよびメソッド 個別レコード取得用イベント 最適化とデバッグ用プロパティおよびメソッド Visual Basic 共通の書式文字列 VAOperation プロパティで使用可能なレコードオペレーション xi

12 xii

13 このマニュアルについて このマニュアルでは Pervasive PSQL 用 ActiveX コントロールを使用した Pervasive PSQL アプリケーション開発についてします xiii

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

15 このマニュアルの構成 ActiveX Controls 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 イベントリファレンス この章では カスタムコントロールに適用されるイベントについてします このマニュアルの巻末には索引が用意されています xv

16 表記上の規則 特段の記述がない限り コマンド構文 コード およびコード例では 以下の表記が使用されます 大文字小文字の区別 太字 固定幅フォント 通常 コマンドと予約語は 大文字で表記されます 本書で別途記述がない限り これらの項目は大文字 小文字 あるいはその両方を使って入力できます たとえば MYPROG myprog または MYprog と入力することができます 太字で表示される単語には次のようなものがあります メニュー名 ダイアログボックス名 コマンド オプション ボタン ステートメントなど 固定幅フォントは コマンド構文など ユーザーが入力するテキストに使われます [ ] 省略可能な情報には [log_name] のように 角かっこが使用されます 角かっこで囲まれていない情報は必ず指定する必要があります 縦棒は [file name] のように 入力する情報の選択肢を表します < > <> は /D=<5 6 7> のように 必須項目に対する選択肢を表します 変数 file name のように斜体で表されている語は 適切な値に置き換える必要のある変数です... [parameter...] のように 情報の後に省略記号が続く場合は その情報を繰り返し使用できます ::= 記号 ::= は ある項目が別の項目用語で定義されていることを意味します たとえば a::=b は 項目 a が b で定義されていることを意味します xvi

17 ActiveX の概要 1 この章では Pervasive の ActiveX インターフェイスについてします ここでは 以下の項目についてします ActiveX インターフェイスの概要 (1-2 ページ ) ActiveX インターフェイスの選択 (1-5 ページ ) 重要な機能 (1-6 ページ ) ActiveX インターフェイスでは使用できない Pervasive PSQL 機能 (1-8 ページ ) ActiveX コントロールを使用する最初の手順 (1-9 ページ ) 1-1

18 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 以降 Borland C++ Builder 3.0 以降 1-2

19 ActiveX インターフェイスの概要 メモほかの開発環境やアプリケーションの中には ActiveX コントロールの拡張機能もサポートするものがあります ただし Pervasive Software では 上に示したプログラミング環境 言語またはアプリケーション以外での ActiveX インターフェイスのテストは行っておりません サードパーティデータバウンドコントロール Pervasive の ActiveX インターフェイスは Sheridan APEX GreenTree および Microsoft のコントロールからデータをバインドできます Pervasive Software では Pervasive の ActiveX インターフェイスに書式設定機能やプレゼンテーション機能がないときだけこれらのサードパーティ製品を使用するようにお勧めしています Pervasive Software ではサードパーティソフトウェアの開発を制御することはできません したがって これらのコントロールの機能をすべてサポートするわけではありません 同じ理由から これらの製品のテクニカルサポートを行っておりません メモサードパーティデータアウェアコントロールへのデータバインドは Microsoft Visual Basic 以外の環境ではサポートされません ActiveX コントロールオブジェクト 以下の表に ActiveX インターフェイスに組み込まれている ActiveX コントロールオブジェクトを示します 表 1-1 組み込まれている ActiveX コントロールオブジェクト アイコンコントロール VAccess VACheckBox データソースコントロールはアプリケーションのソースコードを提供して Pervasive PSQL バウンドコントロールがデータファイルにアクセスできるようにします チェックボックスをブール (True/False) 型のフィールドにバインドできます 1-3

20 ActiveX の概要 表 1-1 組み込まれている ActiveX コントロールオブジェクト アイコンコントロール VAComboBox VACommandButton データバウンドコンボボックスをレコード内の 1 つのフィールドにバインドすると そのフィールドの値を所定の値の中から選択できます このコンボボックスは レコードリストコントロールや使用可能なインデックスフィールドのリストとしても機能します データバウンドコマンドボタンでは レコードの取得 更新 または削除の操作を行えます VAHScrollBar VAVScrollBar データバウンドスクロールバーを使用すると インデックスパスに沿ってレコード内をスキャンできます VAListBox VAOptionButton リストボックスコントロールを使用すると 所定の値セットの中からフィールドの値を選択できます このコントロールは 複数列のレコードリストコントロールとしても機能します オプションボタンをブール (True/False) 型のフィールドにバインドできます VATextBox データアウェアテキストボックスでは あらゆるフィールドの変更を受け入れ 自動的に表示できます また このボックスを検索モードで使用すると テキストが入力されるにつれて ファイルから一致するレコードを捜し出すことができます 1-4

21 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++ Borland Delphi C++ Builder などの多数のプログラミング環境も ActiveX コントロールをサポートします ただし Microsoft Visual Basic データバインドは Visual Basic 以外ではサポートされません これらの言語で ActiveX インターフェイスを使用する予定であり アプリケーションがテキストボックス リストボックス グリッドなどのユーザーインターフェイスオブジェクトを必要とする場合は Pervasive PSQL SDK ActiveX インターフェイスに用意されている Pervasive データバウンドコンロールを使用するか アプリケーションコード内でこれらへのデータバインドを実装する必要があります ActiveX インターフェイスを利用するとき Pervasive ActiveX インターフェイスは SQL アクセスやデータベース抽象化よりデータベースのパフォーマンスが重要であるアプリケーションで ODBC インターフェイスの代替として使用できます このインターフェイスは同じ基本的なデータサービスの多くを提供しますが リレーショナル (SQL) でなくトランザクショナル (Btrieve) データモデルを使用します 1-5

22 ActiveX の概要 重要な機能 Pervasive ActiveX インターフェイスには Pervasive PSQL でのアプリケーション開発を容易にする主要な機能が数多くあります VB 内のデータアウェアコントロールのデータソース フィールドレベルアクセス Apex TrueGrid グリッドコントロールや Sheridan Data Widgets のようなサードパーティコントロールなど Visual Basic 内のほかのデータアウェアコントロールで Pervasive ActiveX インターフェイスをデータソースとして使用できます Pervasive バウンドコントロールは Visual Basic 環境やその他の開発環境で使用できます ActiveX インターフェイスでは データ辞書ファイル (DDF) を使用して Pervasive PSQL データにフィールドレベルでアクセスします フィールドは 名前または序数で参照できます LVAR 以外の Pervasive PSQL フィールドデータ型はすべてサポートされます プロパティおよびメソッドインターフェイス Extended オペレーション ActiveX インターフェイスは コントロールオブジェクトのほかに プログラミングの利便性と柔軟性を高めるための多数のプロパティとメソッドを提供します これらのプロパティとメソッドを使用すると 大量のコードを記述せずに多数の Pervasive PSQL オペレーションを設定および実行できます また Pervasive PSQL バウンドコントロール プログラミング環境またはその他のサードパーティコントロールとの対話処理を通じ コードによってデータを処理できます Pervasive の ActiveX インターフェイスは クライアント / サーバーレコードセットのキャッシュ フィールドの選択 レコードのフィルター処理などの機能を提供する Pervasive PSQL Extended オペレーションの使用を簡単にします Extended オペレーションには 集中管理されているデータベースに対して分散アプリケーションを実行する際のネットワークトラフィックを最小限にしてパフォーマンスを向上させ グリッドコントロールやレコードリストなどの複数行オブジェクトの実装を容易にする機能があります 1-6

23 重要な機能 DDF ActiveX DDF アクセスメソッド リモートデータアクセス ActiveX インターフェイスは ODBC インターフェイスと同様 DDF を必要とします DDF ファイルとデータベースにアクセスするには Pervasive PSQL Control Center を使用します Pervasive PSQL Control Center の詳細については Pervasive PSQL User's Guide または Pervasive PSQL Control Center のオンラインヘルプを参照してください データソースには アプリケーションコード内から DDF 情報にアクセスする手段があります ActiveX インターフェイスを使用すると ワークステーションやクライアント / サーバーオプション以外にも URI を使って Pervasive PSQL データにアクセスできます 結合テーブル VAccess コントロールの Join プロパティを使用すると 2 つのファイルをキー値でリンクし 第 1 のファイルのレコード位置の変更が 第 2 のファイルから検索されたレコードにも反映されるように指定することができます Join プロパティは リレーショナルデータベースを参照するための簡単な機能を提供します 1-7

24 ActiveX の概要 ActiveX インターフェイスでは使用できない Pervasive PSQL 機能 SQL 構文 以下の機能は Pervasive PSQL の一部ですが ActiveX インターフェイスではサポートされません 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 パラメーターを使用することにより ユーザーに資格情報を要求するよう トランザクショナルインターフェイスに指示します 1-8

25 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 にはデータベースの作成方法のチュートリアルが含まれており Advanced Operations 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] をクリックします 1-9

26 ActiveX の概要 Delphi ActiveX コントロールを Delphi へインポートするには 1 [ コンポーネント ] メニューから [ActiveX コントロールの取り込み ] を選択します [ActiveX の取り込み ] ダイアログボックスが表示されます 図 1-1 ActiveX の取り込みダイアログボックス (Delphi) 2 [Pervasive ActiveX Data Source] を選択した後 [ インストール ] をクリックします 3 次に バウンドコントロールをインポートする必要があります [ActiveX の取り込み ] ダイアログボックスで [Pervasive Bound Controls] を選択し [ インストール ] をクリックします これで青い ActiveX コントロールアイコンが Delphi コンポーネントパレット [ActiveX] ページに表示されます 1-10

27 ActiveX クイックスタート 2 この章では Pervasive の ActiveX インターフェイスに付属するファイルのディレクトリ構造を示すほか コントロールを使用するアプリケーションの開発に関わる基本的作業手順についてします この章では 以下の項目についてします ファイルとディレクトリ (2-2 ページ ) ActiveX インターフェイスを使用したアプリケーションの作成 (2-3 ページ ) 主な作業のリストについては 上記のセクションを参照してください Pervasive PSQL ActiveX ファイルの配布と登録 (2-21 ページ ) ActiveX インターフェイスに関する追加情報 (2-22 ページ ) 2-1

28 ActiveX クイックスタート ファイルとディレクトリ 表 2-1 ActiveX インターフェイスファイル Pervasive の ActiveX インターフェイスファイルとディレクトリを表 2-1 に示します この表では Pervasive PSQL がデフォルトの場所にインストールされていることを前提としています Pervasive PSQL ファイルのデフォルトの保存場所については Getting Started with Pervasive PSQL の Pervasive PSQL ファイルがインストールされる場所 (7-2 ページ ) を参照してください アプリケーションの実装に必要なファイルについては Pervasive PSQL ActiveX ファイルの配布と登録 (2-21 ページ ) を参照してください ファイル場所 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 データ辞書ファイル (.DDF) と MicroKernel エンジンのテーブル (.MKD ファイル ) readme_activex.htm file_path\psql\docs\sdk 重要な情報とマニュアルの改訂事項 PSQL.JAR file_path\psql\bin\ Pervasive Java アクセスライブラリ用 JAR ファイル 2-2

29 ActiveX インターフェイスを使用したアプリケーションの作成 ActiveX インターフェイスを使用したアプリケーションの作成 ここでは ActiveX インターフェイスを使用したアプリケーションの作成に関連する主な作業を行う方法についてします 作業項目は以下のとおりです プロジェクトへの ActiveX インターフェイスの追加 VAccess コントロールの使用 (2-4 ページ ) プロパティへのアクセス (2-4 ページ ) プロパティの設定 (2-6 ページ ) Pervasive PSQL ファイルへの接続 (2-7 ページ ) インデックスの選択 (2-8 ページ ) 自動と手動のファイルオープンの設定 (2-10 ページ ) データソースへのバウンドコントロールのリンク (2-11 ページ ) レコードの取得 (2-11 ページ ) 特定のレコードの検索 (2-12 ページ ) レコードの追加 更新および削除 (2-14 ページ ) レコードのロック (2-14 ページ ) ファイルの結合 (2-15 ページ ) Extended オペレーションの有効化 (2-16 ページ ) プロジェクトへの ActiveX インターフェイスの追加 Pervasive の ActiveX インターフェイスのデータソースとバウンドコントロールを Visual Basic プロジェクトに追加するには 1 [ プロジェクト ] メニューから [ コンポーネント ] を選択します ( または ツールボックスを右クリックし [ コンポーネント ] を選択します ) 2 コントロールリスト内をスクロールし [Pervasive ActiveX Data Source] と [Pervasive Bound Controls] チェックボックスを選択します 3 [OK] をクリックします ツールボックスに青色の Pervasive ActiveX アイコンが表示されます 2-3

30 ActiveX クイックスタート VAccess コントロールの使用 VAccess コントロールはデータをポイントするもので ほかすべての Pervasive PSQL コントロールがバインドするマスターコントロールです このコントロールは Pervasive PSQL とのすべての通信を処理します Visual Basic フォームにデータソースコントロールを追加するには 1 Pervasive PSQL ActiveX コントロールを含んでいる Visual Basic のツールボックスをクリックします 2 VAccess コントロールアイコンをクリックします プロパティへのアクセス 3 フォームにカーソルを置いてドラッグし コントロールを保持するための四角形を作成します マウスを離すと ActiveX インターフェイスが四角形内に表示されます このコントロールは 設計時にはアイコンとして表示されますが 実行時には表示されません また Pervasive PSQL の起動画面には Pervasive PSQL ワークステーションエンジンが起動されたことが表示されます 4 デフォルトでは フォームに配置する最初の VAccess コントロールには VAccess1 という名前が付きます 必要であれば Name プロパティに新しい名前を入力してこの名前を変更できます 次に この VAccess コントロールのプロパティを設定する必要があります プロパティへのアクセス (2-4 ページ ) プロパティの設定 (2-6 ページ ) および Pervasive PSQL ファイルへの接続 (2-7 ページ ) をお読みください コントロールのプロパティは次の 3 つの場所で設定できます プロパティページダイアログボックス 2-4

31 ActiveX インターフェイスを使用したアプリケーションの作成 Visual Basic のプロパティウィンドウ Visual Basic コードエディター プロパティページ コントロールを右クリックし ショートカットメニューから [ プロパティ ] を選択すると プロパティページが表示されます これは コントロールの Pervasive PSQL ActiveX プロパティを設定できるタブ付きのダイアログボックスです 詳細については 図 2-1 を参照してください 図 2-1 プロパティページダイアログボックス Visual Basic のプロパティウィンドウ Visual Basic のプロパティウィンドウには Visual Basic に固有のプロパティなど 選択したオブジェクトのすべてのプロパティセットが表示されます 図 2-2 (2-6 ページ ) を参照してください 2-5

32 ActiveX クイックスタート 図 2-2 VAccess プロパティを表示するプロパティウィンドウ Visual Basic コードエディター フォームまたはコントロールをダブルクリックすると Visual Basic のコードエディターが開きます コードエディターの使用方法については Visual Basic のマニュアルを参照してください 各プロパティの構文などの詳細については 本マニュアルを参照してください プロパティの設定 コントロールのプロパティを設定するには 1 プロパティを設定するコントロールを選択します 2-6

33 ActiveX インターフェイスを使用したアプリケーションの作成 2 プロパティページ Visual Basic プロパティウィンドウまたはコードエディターで変更するプロパティを検索します プロパティへのアクセスについては プロパティへのアクセス (2-4 ページ ) を参照してください 3 追加または変更する各プロパティの値を設定するには テキストボックスにその値を入力するか フィールドをクリックしたときに表示されるドロップダウンリストから値を選択するか あるいは 値の設定が行えるダイアログボックスを呼び出す省略記号をクリックします メモプロパティには 設計時または実行時に設定できるものと 設計時または実行時にしか設定できないものがあります Pervasive PSQL ファイルへの接続 VAccess コントロールには このコントロールを Pervasive PSQL データファイルへ接続するための重要なプロパティとして DdfPath TableName および Location という 3 つのプロパティがあります これらのプロパティにアクセスする最も簡単な方法は コントロールを右クリックしてショートカットメニューから [ プロパティ ] を選択したときに表示されるプロパティページからアクセスする方法です プロパティウィンドウからも これらのプロパティにアクセスできます 図 2-3 データに接続するためのプロパティの設定 2-7

34 ActiveX クイックスタート データに接続するための 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 を設定します 3 TableName プロパティのドロップダウンメニューからテーブル名を選択します このメニューには ステップ 2 で指定した DDF で使用できるテーブル名が含まれています この VAccess コントロールにバインドするバウンドコントロールはすべて このテーブルを参照します 4 ステップ 3 でテーブル名を選択すると Location プロパティはそのテーブルを含んでいる.MKD ファイルに変更されます データへの接続を完了するには IndexNumber プロパティをアクセスしたいインデックスに設定します メモ実行時にコードからこれらのプロパティを設定しても 同じ順序が適用されます インデックスの選択 VAccess コントロールの IndexNumber プロパティは レコード取得メソッドを呼び出すときに VAccess コントロールで使用されるインデックスを決定します このインデックスは 設計時に VAccess コントロールのプロパティウィンドウで設定するか あるいは 実行時にコードで設定できます 2-8

35 ActiveX インターフェイスを使用したアプリケーションの作成 設計時にインデックス番号を設定するにはプロパティウィンドウでは IndexNumber プロパティのドロップダウンリストから値を選択してプロパティを設定できます 次のように プロパティページから IndexNumber を設定することもできます 1 インデックス番号を設定する特定の VAccess コントロールを選択します 2 右クリックしてプロパティページダイアログボックスを開きます 3 VAccess1 プロパティページダイアログボックスの [Settings] タブをクリックし IndexNumber フィールドをクリックします 選択したテーブルに定義されているインデックスのリストが表示されます 4 インデックス 0 - ID を選択し [OK] をクリックします 図 2-4 に設定を示します 図 2-4 IndexNumber プロパティの設定 実行時にインデックス番号を設定する方法として コードによる方法と VAComboBox コントロールによる方法があります 実行時にコードによりインデックス番号を設定するには 1 インデックスを設定する VAccess コントロールをダブルクリックします コードエディターが呼び出されます 2 以下の例に倣って コードを入力します VAccess1.IndexNumber = 0 ' 最初のインデックスを選択 2-9

36 ActiveX クイックスタート 実行時にコンボボックスでインデックス番号を設定するには 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 メソッドは 開いているデータファイルを閉じます 例 (2-11 ページ ) も参照してください AutoOpen プロパティを設定するには プロパティウィンドウで AutoOpen プロパティを設定するには ドロップダウンリストから True または False を選択します 次のように プロパティページから AutoOpen を設定することもできます 1 コントロールを右クリックしてプロパティページを呼び出します 2 [Settings] タブをクリックします 3 AutoOpen チェックボックスを選択または選択解除します チェックボックスを選択すると AutoOpen が True に設定されます チェックボックスを選択解除すると AutoOpen が False に設定されます 2-10

37 ActiveX インターフェイスを使用したアプリケーションの作成 例 この例は AutoOpen が False に設定されている場合に ファイルを閉じ 別のファイルを開く方法を示したものです ' 現在開いているファイルを閉じる VAccess1.Close ' データ辞書情報を設定する VAccess1.DdfPath = "file_path\psql\demodata\" VAccess1.TableName = "Student" ' ファイルを開く VAccess1.Open データソースへのバウンドコントロールのリンク VAccess コントロールをフォームに追加してプロパティを設定した後 必要なバウンドコントロールを追加し この VAccess コントロールにバインドすることができます これにより それらのバウンドコントロールは VAccess コントロールが指定するデータにリンクされます 特定のバウンドコントロールについては ActiveX コントロールリファレンス (4-1 ページ ) を参照してください 8 個ある Pervasive バウンドコントロールのどれかをデータにリンクするには 1 バウンドコントロールの VAccessName プロパティを 既にデータをポイントしている VAccess データソースコントロールの名前に設定します 2 VATextBox や VAOptionButton などのフィールドバウンドコントロールの場合は VAFieldName プロパティをデータソースコントロール内のフィールドのうちの 1 つの名前に設定する必要もあります レコードの取得 以下の 3 つの方法でレコードを取得できます VAHScrollBar または VAVScrollBar による方法 VACommandButton による方法 コードによる方法 スクロールバーでレコードを取得するには 1 VAHScrollBar または VAVScrollBar をフォームに追加して選択します 2 VAccessName プロパティを使用する VAccess コントロールに設定します コマンドボタンでレコードを取得するには 1 フォームに VACommandButton を追加して選択します 2-11

38 ActiveX クイックスタート 2 VAccessName プロパティを使用する VAccess コントロールの名前に設定し VAOperation プロパティを希望の取得オペレーションに設定します 使用可能な Pervasive PSQL オペレーションのリストについては VAOperation (6-91 ページ ) を参照してください コードでレコードを取得するには 表 2-2 のメソッドのうちの 1 つを使用します Get メソッドは IndexNumber プロパティで指定されたインデックスを使用します Step メソッドはインデックスを使用しません 表 2-2 個々のレコードを取得するためのメソッド GetDirect GetLast StepFirst GetEqual GetLess StepLast GetFirst GetLessOrEqual StepNext GetGreater GetNext StepPrevious GetGreaterOrEqual GetPrevious 例 ' 人の名前を表示 ' データ辞書情報を設定 'VAccess1.DdfPath = "file_path\psql\demodata\" 'VAccess1.TableName = "Person" 'VAccess1.IndexNumber = 1 '(Last_Name + First_Name) Stat = VAccess1.GetFirst While Stat = 0 List1.AddItem VAccess1.FieldValue("Last_Name") _ & " " & VAccess1.FieldValue("First_Name") Stat = VAccess1.GetNext Wend 特定のレコードの検索 以下の 2 つの方法で特定のレコードを検索できます バウンドコントロールによる方法 コードによる方法 テキストボックスで特定のレコードを検索するには 1 フォームに VATextBox を配置します 2-12

39 ActiveX インターフェイスを使用したアプリケーションの作成 2 VATextBox の VASearch プロパティを True に設定します これにより テキストボックスにテキストが入力されると 一致するレコードを取得するために VAccess コントロールで GetGreaterOrEqual メソッドが実行されるようになります コードで特定のレコードを取得するには 1 VAccess コントロールをダブルクリックします 2 IndexNumber プロパティを設定して適切なインデックスを選択します 3 FieldValue メソッドを使用して 検索する値をインデックスフィールドに設定します 複数のフィールドを使用するインデックスの場合は 必ず各フィールドに値を代入してください 4 次に 表 2-3 のメソッドのうちの 1 つを実行して目的のレコードを取得します 表 2-3 特定のレコードを取得するためのメソッド GetEqual GetGreater GetGreaterOrEqual GetLess GetLessOrEqual キーと一致する最初のレコードを返します キーより後の次のレコードを返します キーレコード またはキーより後のレコードを返します キーより前のレコードを返します キーレコード またはキーより前のレコードを返します 5 IndexNumber プロパティが 検索が行われるフィールドに対応するインデックスに設定されていることを確認してください 例 ' キーフィールドに検索値を入力 VAccess1.FieldValue("last_name") = "Reich" VAccess1.FieldValue("first_name") = "Steve" ' 正しいインデックス番号を設定してレコードを取得 VAccess1.IndexNumber = 1 stat = VAccess1.GetEqual If stat = 0 Then MsgBox " レコードが見つかりました " Else MsgBox " ファイルには該当するレコードがありません " End If 2-13

40 ActiveX クイックスタート レコードの追加 更新および削除 レコードを追加 更新または削除する方法として 以下の 2 つの方法があります VACommandButton による方法 コードによる方法 コマンドボタンでレコードを追加 更新または削除するには 1 フォームに VACommandButton を配置します 2 VAccessName プロパティを対応する VAccess コントロールの名前に設定します 3 VAOperation プロパティを希望のオペレーションに設定します 可能なオペレーションのリストについては 本書の プロパティリファレンス の VAOperation プロパティを参照してください コードでレコードを追加 更新または削除するには以下の VAccess コントロール用カスタムメソッドの 1 つを使用し コードからデータベースへの書き込みを行います 表 2-4 レコードを追加 更新および削除するためのカスタムメソッド Delete Insert Update 現在のレコードを削除します メモリ内のレコードを新しいレコードとして挿入します 現在のレコードをメモリ内のレコードで更新します 例 ' 指定された学生の専攻科目を変更 VAccess1.TableName = "Student" VAccess1.IndexNumber = 1 FieldValue (ID) = stat = GetEqual If stat = 0 VAccess1.FieldValue ("Major") = "Music" VAccess1.Update End If レコードのロック Pervasive PSQL には Pervasive の VAccess インターフェイスでサポートされる次の 2 種類のロックがあります 単一レコードノーウェイトロックと複数レコードノーウェイトロックです 2-14

41 ActiveX インターフェイスを使用したアプリケーションの作成 Pervasive の VAccess インターフェイスでこれらのロックを適用するには 以下のアプローチのうちの 1 つを使用します VACommandButton を使用してレコードの取得とロックを行う場合は VALockBias プロパティを設定します Get または Step メソッドを呼び出すときは オプションパラメーターとして対応するロックバイアス ( 単一レコードの場合は 200 複数レコードの場合は 400) を含めます レコードをロック解除するには Unlock メソッドを使用します レコードロックと並行制御の詳細は Pervasive PSQL Programmer's Guide で データ整合性 (4-42 ページ ) を参照してください 例 ' レコードをロックし 学生の名前を変更して レコードを更新する Const SINGLE_NOWAIT_LOCK = 200 Const MULTIPLE_NOWAIT_LOCK = 400 VAccess1.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-15

42 ActiveX クイックスタート 2 つの VAccess コントロールを結合するには 1 スレーブコントロールとする VAccess コントロールを選択します 2 プロパティウィンドウで [Join] ボタンをクリックして [Join Controls] ダイアログボックスを開きます ダイアログボックスの左側には 結合元のスレーブコントロールのテーブルとそのテーブルの選択したインデックスが表示されます 右側には 結合先のマスターコントロールとそのコントロールで使用できるフィールドが表示されます 3 マスターコントロールをスレーブコントロールのテーブルに結合するには マスターコントロールのフィールドをクリックします そうすると Equals 列の下にフィールドが表示され そのフィールドが結合されていることを示します Extended オペレーションの有効化 Extended オペレーションを使用すると 複数のレコードに対するリクエストの処理を Pervasive PSQL トランザクショナルインターフェイスにさせることが可能になります ネットワークサーバーベースの Pervasive PSQL システムでは Extended オペレーションによってネットワークトラフィックを大幅に削減し データ取得を高速化することができます Extended オペレーションは 複数のレコードを一度に読み取る際に最も有効です たとえば 統計データを収集して表に記入するためにファイルをスキャンしたり 表 レポートまたはグリッドを作成するために多数のレコードを一度に要求したり 必要なレコードを照合するための適切なインデックスを持たないデータベースに対する一度限りの検索を実行するのに適しています Extended オペレーションは個々のレコードにアクセスするためのインデックス付きレコード取得に代わるものではなく データセットを高速に取得するための強力なツールになります Extended オペレーションを使用可能にするには 1 Extended オペレーションで使用する VAccess コントロールを選択します 2 プロパティウィンドウを使用している場合は ExtendedOps プロパティを True に設定します プロパティページを使用している場合は [Extended Operations] タブをクリックし [ExtendedOps] チェックボックスをオンにして [OK] をクリックします Pervasive の ActiveX インターフェイスは 以下の Extended Fetch メソッドをサポートします Get Next Extended は 現在のキーの論理位置より後続のレコードのうち 指定されたフィルター条件を満たすレコードを取得します Get Previous Extended は 現在のキーの論理位置より前にあるレコードのうち 指定されたフィルター条件を満たすレコードを取得します 2-16

43 ActiveX インターフェイスを使用したアプリケーションの作成 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 を使用すれば 考慮したブロックでデータセットを返すことができます 2-17

44 ActiveX クイックスタート Extended Fetch メソッドの使用 Extended Fetch メソッドの GetNextExtended GetPreviousExtended StepNextExtended および StepPreviousExtended はファイル内の現在のカーソルの位置から始まり 指定された選択基準を満たす一連の行 ( レコード ) と列 ( フィールド ) を返します Get メソッドは 現在のインデックスを使用してインデックス順にレコードを返します Step メソッドは 物理位置の順序で並べられたレコードを返します Step メソッドは一般にほかのメソッドより高速なので 返されるレコードの順序が重要でない場合に使用してください 特定の Extended Fetch オペレーションから返される最大レコード数の設定には いくつかのプロパティが関与します 単一の Extended Fetch オペレーションから返されるデータの総量は MaxBufferSize プロパティで指定するデータ通信バッファーのサイズによって制限されます このバッファーは最大 64 KB ですが Pervasive PSQL MicroKernel データベースエンジンの設定によってはこれより小さくなります このプロパティに大きすぎる値を指定すると ステータスコード 97 データバッファーが小さすぎます が返されます SelectedFields プロパティは個々のデータ行のサイズを決定しますが このサイズは選択されたフィールドの記憶域の長さの合計に 6 バイトを加えた長さです CacheRows パラメーターは 一度に取得する最大行数を指定します Extended Fetch メソッドは CacheRows の値か 行のサイズと MaxBufferSize に基づいた計算値のいずれか小さい値を使用します CacheRows がゼロであれば 計算値が使用されます SelectedRecords プロパティを使用すると ある基準を満たすレコードだけを取得できます このプロパティは CacheRejectMax プロパティと結び付いて機能し 検索条件に合わないレコードをスキップします CacheRejectMax プロパティに値を指定しないと Pervasive PSQL はシステムで定義された値を使用します 次の 2 つの条件のうちの 1 つが満たされると レコードセットが返されます つまり 選択基準を満たす行数が CacheRows プロパティの値に等しくなるか あるいは 最後の一致を検出して以降にスキャンされたレコード数が CacheRejectMax プロパティの値を超えるという条件です Status プロパティは いずれの条件が満たされたかを示します Rows プロパティは Extended Fetch オペレーションから返された行数を示します Extended Fetch の後には必ず このプロパティの値をチェックしてください オペレーションがゼロ以外のステータス ( ファイルの終わりなど ) を返しても 有効なデータを返す可能性があるからです 2-18

45 ActiveX インターフェイスを使用したアプリケーションの作成 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 を使用して後続のレコードを取得できます CacheRejectMax プロパティは SelectedRecords の基準で現在のインデックス上のレコードが制限される場合に有効です たとえば CacheRejectMax プロパティの値を 1 に設定すると Pervasive PSQL サーバープロセスに対し 基準に合わない最初のレコードを見つけたら停止するよう指示することができます 2-19

46 ActiveX クイックスタート ファイル全体をスキャンする必要があってもレコードの順序が重要でない場合は 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.StepFirst VAccess1.Init Do 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 R Loop While Stat =

47 Pervasive PSQL ActiveX ファイルの配布と登録 Pervasive PSQL ActiveX ファイルの配布と登録 Pervasive PSQL アプリケーションの配布については Pervasive PSQL Programmer's Guide の Pervasive PSQL アプリケーションの配布 (7-3 ページ ) を参照してください 次の表に Pervasive の ActiveX インターフェイスで構築されたアプリケーションの実行に必要なファイルを示します 表 2-5 再配布可能なファイル ファイル場所 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 Pervasive PSQL ファイルのデフォルトの保存場所については Getting Started with Pervasive PSQL の Pervasive PSQL ファイルがインストールされる場所 (7-2 ページ ) を参照してください Pervasive PSQL ActiveX ファイルと必要な DLL を配布した場合 ActiveX ファイルが正しく機能するように ActiveX ファイルを登録する必要があります これらのファイルを登録するには次の 2 種類の方法があります InstallShield などの現行のインストール用ユーティリティの多くは インストール処理中に ActiveX コントロールを自動的に登録するよう変更することができます ( 詳細については お使いになる特定のインストール用ユーティリティのマニュアルを参照してください ) ActiveX コントロールを登録するもう 1 つの方法は 再配布可能なファイル REGSVR32.EXE をインストールし インストール中またはインストール後に実行する方法です これは単純な ActiveX 登録用ユーティリティで 登録する ActiveX の名前をコマンドラインパラメーターとして受け取ります ( たとえば REGSVR32 C:\MyInstall\ACBTR732.OCX) 2-21

48 ActiveX クイックスタート ActiveX インターフェイスに関する追加情報 このマニュアルのほかにも ActiveX アプリケーションの開発に役立つリソースがあります これらの項目は以下のとおりです Tutorials and Guide to Samples - Pervasive PSQL SDK の使用方法に関するステップバイステップの書 ActiveX インターフェイスだけを扱ったセクションがあります Status Codes and Messages -このマニュアルでは Pervasive PSQL のコンポーネントを使用しているときに発生する可能性のある各ステータスコードとメッセージについてしています 2-22

49 ActiveX でのデータ辞書メソッドの使用 3 この章では 以下の項目についてします ActiveX データソースコントロールによる DDF の処理 (3-2 ページ ) ファイルの内容とメモリイメージ (3-3 ページ ) 辞書の読み取り (3-4 ページ ) DDF の変更 (3-6 ページ ) テーブル定義の作成 (3-8 ページ ) 辞書の作成 (3-10 ページ ) データファイルの変更 (3-11 ページ ) その他の DDF 操作 (3-13 ページ ) 3-1

50 ActiveX でのデータ辞書メソッドの使用 ActiveX データソースコントロールによる DDF の処理 データ辞書ファイル (DDF) は Pervasive PSQL データに対する列レベルのアクセスを行うために Pervasive PSQL アプリケーションや多数のサードパーティアプリケーションで使用されます ActiveX インターフェイスは Pervasive PSQL 開発者が DDF の作成 読み取りおよび変更を容易に行えるようにする多数のメソッドを提供します 辞書ファイル処理のほとんどで コントロールへの新しいメソッドの追加が必要です ただし 旧バージョンの ActiveX データソースコントロールはデータ辞書を認識したため 既存のプロパティとメソッドの動作にいくつかの変更が加えられました 旧バージョンとの互換性は保たれていますが RefreshLocations などのように拡張されたプロパティがある一方 FieldInde や FieldName などのように使用が推奨されなくなったものもあります 3-2

51 ファイルの内容とメモリイメージ ファイルの内容とメモリイメージ 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 を上書きしないように注意してください 3-3

52 ActiveX でのデータ辞書メソッドの使用 辞書の読み取り 以前のバージョンの ActiveX インターフェイスは DDF に含まれる情報の大部分を公開していましたが 特定の情報を取り出すのが非常に困難であったり ときには不可能なことがありました また 項目ごとに複数のプロパティ設定が必要だったので 情報の複数の項目を検索することは面倒でした 本バージョンの ActiveX インターフェイスでは これらの問題の解決にバリアント配列を使用しました バリアントとは 複数のデータ型を表すことができ かつどのデータ型を現在表しているかがわかる変数の一種です ActiveX インターフェイスコンテナーはバリアントをサポートします バリアント配列はバリアントの一種で 実質的にはバリアントのリストへの参照であり リストの各項目に異なる型の情報を保持できるものです この配列は コード環境によって異なる方法で表されます Visual Basic では バリアント配列は myarray (1, 1) のような単なる通常の配列として表示されます しかし Visual C++ では バリアント配列は VT_ARRAY VT_VARIANT 型のバリアントにすぎず "SafeArray" システム API を使用して配列の内容を処理する必要があります 既に述べたように ActiveX インターフェイスはバリアント配列を使用してコア DDF 情報を公開します ActiveX インターフェイスが使用する配列は 1 次元として列 2 次元として行を持つ 2 次元配列です この配列では Visual Basic ユーザーは ReDim Preserve 関数を使用して行数を変更することができます 列は要求された情報のさまざまな面を表すのに対して 行は項目の集合を表します たとえば GetTableList は 2 次元配列を返します 1 次元は 3 つの情報 つまり TableID TableName および TableLocation から構成されているのに対して 2 次元は辞書内のテーブルごとに 1 行を含んでいます したがって Visual Basic におけるテーブル名のリストの取得は以下のように行われます リストボックスに現在の辞書内のテーブル名を設定するには Dim tablelist as Variant Dim tablecount as integer ' すべての情報をファイル自体から読み込むことを確認する VAccess1.RefreshLocations = True 'DdfPath を設定 - これにより辞書を開く VAccess1.DdfPath = "c:\mydata" ' バリアント配列を取得 tablelist = VAccess1.GetTableList ' リストボックスに名前を入力 - 配列の上限に達するまでループ For tablecount = 0 to UBound(tableList, 2) 3-4

53 辞書の読み取り ' リストボックスに配列の正しいメンバーを追加 List1.AddItem tablelist(1, tablecount) Next tablecount FieldList と IndexList は ほとんど同じ機能を果たします ただし これらはプロパティであるため 配列のエントリを変更したり エントリを追加することができます 各配列の 1 次元の構造については FieldList (6-27 ページ ) と IndexList (6-38 ページ ) を参照してください 言うまでもなく 各配列の 2 次元はフィールド数またはインデックス数を表します 3-5

54 ActiveX でのデータ辞書メソッドの使用 DDF の変更 ActiveX メモリイメージでのファイルの変更は DDF の新しい定義を追加または変更してコミットする最初の段階として また 間違った DDF の情報を修正する場合において有用です 必要とされる変更のほとんどは FieldList プロパティおよび IndexList プロパティを使用して行うことができます DDF を変更する場合は すべての変更がコミットできる状態になるまで ActiveX メモリイメージに変更情報を保管しておき その後 DdfAddTable を使用してファイルに変更情報をコミットするほうが効率的です したがって FieldList または IndexList を設定するときは RefreshLocations を False に設定することをお勧めします Visual Basic では ReDim 関数で Preserve オプションを使用すれば 既存の定義にフィールドを追加することができます また DdfModifyTableName と DdfModifyLocation を使用して 現在のメモリイメージまたは DDF ファイル自体に含まれるテーブルを変更することもできます たとえば 次のようにします 既存のテーブル定義にフィールドを追加するには Option Base 0 Dim 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 3-6

55 DDF の変更... < そのほかの DDF 処理 >... ' さて テーブルは希望どおりに設定されました ' テーブルの名前を変更しましょう DdfModifyTableName "TableWithAllFields" ' 次の操作を DDF に直接作用させるため RefreshLocations を ' 設定してもかまいませんが DdfAddTable はメモリイメージ ' ではなく DDF にのみ作用するため RefreshLocations は ' 無視されます ( リファレンスの DdfAddTable を参照 ) ' テーブルをファイルに保存 - 既存の定義を上書き DdfAddTable True メモ上記の例で示した変更は DDF のみに作用します この追加フィールドの領域がテーブル自体になければ フィールドはファイル自体に存在しません データファイルの構造の変更については 以下のセクションを参照してください 3-7

56 ActiveX でのデータ辞書メソッドの使用 テーブル定義の作成 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 にそのイメージを書き出すことができます 3-8

57 テーブル定義の作成 辞書に新しいテーブルを追加するには Option Base 0 'DDF から直接現在の情報を取得 VAccess1.RefreshLocations = True 'VAccess を正しい DDF に設定 VAccess1.DdfPath = "c:\mydata" ' テーブル設定中はメモリイメージでのみ作業する VAccess1.RefreshLocations = False ' 現在のメモリイメージに新しいテーブルスロットを作成 VAccess1.DdfAddTableName "NewTable" ' 場所を設定 VAccess1.DdfModifyLocation "newtable.mkd"... < フィールドとインデックス情報を設定 >... ' テーブルをファイルに保存 - 既存の定義を上書きしない ' この定義はまだ存在しないはずであるため DdfAddTable False メモ DdfDropTable への 1 回の呼び出しで テーブル定義全体を削除することができます 当然のことながら このオペレーションは決定的な事態を引き起こすため 注意して使用する必要があります 3-9

58 ActiveX でのデータ辞書メソッドの使用 辞書の作成 アプリケーションで辞書自体を作成しなければならない場合があります たとえば アプリケーションが初めて実行されたときに必要な DDF を作成するようにアプリケーションを書いて ベンダーがアプリケーションと一緒に DDF を出荷および更新しなくて済むようにすることができます このタスクを行うメソッドとして DdfCreateDictionary があります このメソッドは DdfPath ディレクトリに空の辞書ファイル (COMMENT.DDF と FIELDEXT.DDF も含む ) を作成します メモ overwrite パラメーターを True に設定すると DdfCreateDictionary は現在のディレクトリ内の DDF を破壊して回復不能にしてしまうので 注意して使用してください 3-10

59 データファイルの変更 データファイルの変更 これまでしてきた変更はすべて DDF または DDF の ActiveX メモリイメージにだけ当てはまるものです ただし DDF を変更しても データファイル内の実際のレコードの長さや構造は変更されません この変更を行うには データファイルに直接影響を与える関数を使用する必要があります データファイルの長さの変更は 1 つの操作で済む問題ではありません 基本的には データファイルを破壊し 新しい長さで再構築する必要があります 既存のファイルに対してこの変更を行う場合は 2 つの VAccess コントロールとテンポラリファイルを使用してレコードをコピーする必要があります たとえば 次のようにします テーブルとデータファイルにフィールドを追加するには Dim totalrecs as Integer Dim currrec as Integer 'DDF を読めるようにする VAccess1.RefreshLocations = True VAccess2.RefreshLocations = True 'DDFPath を設定 VAccess1.DdfPath = "c:\mydata" VAccess2.DdfPath = "c:\mydata" ' テーブルを設定 VAccess1.TableName = "MyTable" VAccess2.TableName = "MyTable" ' メモリイメージのみを使用 VAccess1.RefreshLocations = False VAccess2.RefreshLocations = False ' 上記ルーチンを使用して VAccess2 メモリイメージに ' 新規フィールドを追加 AddNewField ' 実際のデータファイルを作成し DDF を更新 'VAccess1 のメモリイメージは更新されない VAccess2.RefreshLocations = True VAccess2.DdfCreateTable True ' テーブルを一時的に別の場所に割り当てる VAccess2.RefreshLocations = False VAccess2.DdfModifyLocation "tempdata.mkd" 3-11

60 ActiveX でのデータ辞書メソッドの使用 ' ファイルを開き最初のレコードを取得 VAccess1.Open VAccess2.Open VAccess1.GetFirst ' レコードを一方から他方へコピー totalrecords = VAccess1.TotalRecords currrec = 0 While currrec < totalrecords VAccess2.Buffer(0) = VAccess1.Buffer(0) VAccess2.Insert ' ここにエラー処理を追加 VAccess1.GetNext currrec = currrec + 1 Wend VAccess1.Close VAccess2.Close ' 2 つのデータファイルができた ( 古いデータと新しいデータ ) ' 言語 API を使用して古いデータファイルを削除し ' 新しいデータファイル名を古い名前に変更する RenameTempDataFile ' 正しい場所に置き直す - DDF は既に設定されているので変更しない VAccess2.DdfModifyLocation VAccess1.Location その他にも データファイルのインデックス構造に対して直接行える変更があります これらのオペレーションは ActiveX メソッドリファレンス (7-1 ページ ) に示されており DdfAddIndex DdfDropIndex および DdfDropIndexMaintain などがあります 3-12

61 その他の DDF 操作 その他の DDF 操作 オーナーネームによる DDF の保護 ここでするメソッドを使用して さまざまな目的で DDF を処理することができます オーナーネームで DDF をセキュリティ保護することができます この機能を果たすために 以下の 2 つの方法が用意されています DdfSetOwner このメソッドは VAccess メモリイメージに現行の有効な DDF オーナーネームを設定します つまり すべての DDF ファイル操作はこのオーナーネームを使用します RefreshLocations が True である場合 この呼び出しを行う際のアクセスについては前の DDF オーナーネームを使用し このオーナーネームが DDF 自体に適用されます このメソッドは データファイルとの関連でのみ使用される OwnerName プロパティには影響を与えません DdfTestOwnerName このメソッドでは 有効な DDF オーナーネームを設定し その名前で許される権限を決定することができます これらの 2 つの方法の詳細については ActiveX メソッドリファレンス (7-1 ページ ) を参照してください 既存のフィールドとインデックス情報の削除 DdfClearFields と DdfClearIndexes は 現在のテーブルの既存のフィールド情報およびインデックス情報をすばやく消去できる便利な方法を提供します メモ RefreshLocations が True である場合 これらの変更内容は DDF に書き込まれるので 注意して使用してください 永続的な DDF メモリイメージによるコメントの強制設定 DdfGetComments このメソッドの用途は非常に限定的です RefreshLocations が False である場合 DDF 以外のテーブルを開いているときは永続的なメモリイメージが読み取られます ただし 永続的なメモリイメージにはコメント情報が含まれていません DdfGetComments は RefreshLocations を無視するため このメソッドを使用してコメント情報を永続的な DDF の情報と同調させるように ActiveX を強制設定することができます 3-13

62 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 の現在の状態を反映します このため 正しくないエントリの診断と修復が容易になります 3-14

63 ActiveX コントロールリファレンス 4 この章では Pervasive PSQL 用の ActiveX コントロールについてし コントロールの種類ごとにプロパティ メソッド イベントを一覧に示しています この章では 以下の項目についてします VAccess データソース (4-2 ページ ) VACheck (4-5 ページ ) VACombo (4-6 ページ ) VACommand (4-8 ページ ) VAHScroll と VAVScroll (4-9 ページ ) VAList (4-10 ページ ) VAOption (4-12 ページ ) VAText (4-13 ページ ) 4-1

64 ActiveX コントロールリファレンス 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 でバウンドコントロールとして動作するサードパーティデータコントロールにバインドすることもできます 4-2

65 VAccess データソース カスタムプロパティ メソッドおよびイベント 表 4-1 VAccess カスタムプロパティ 次の表に このコントロールのカスタムプロパティ メソッドおよびイベントの一覧をアルファベット順に示します カスタムプロパティ メソッド およびイベントのカテゴリ別一覧は カテゴリ別プロパティ メソッド およびイベント を参照してください プロパティの一覧には (About) (Custom) (Name) Index Left Tag Top などのストックプロパティは含まれていません 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 CancelDialog FieldValue PageSize TimeOutVal Column FileVersion Percentage TotalRecords ColumnName FireEvents Port VADebugMode Columns HostAddress Position CompressData HostConnect RefreshLocations DatabaseName IncludeCurrent Row 表 4-2 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 4-3

66 ActiveX コントロールリファレンス 表 4-2 VAccess カスタムメソッド 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 表 4-3 VAccess カスタムイベント CommError Logon Reposition GotData OnRemote Validate 4-4

67 VACheck VACheck VACheck コントロールはブール型 (True または False) のフィールド値の状態を表示します 備考 VACheck コントロールのデータソースは VAccessName プロパティの設定によって決まります フィールドソースは VAFieldName プロパティをデータソースのブール型 ( 論理あるいはビットタイプ ) フィールドの名前に設定することによってバインドされます フィールドの True ストレージ値と False ストレージ値の それぞれ 1 と 0 以外の値は コントロールの VAValueTrue プロパティと VAValueFalse プロパティを使用して定義できます カスタムプロパティとメソッド 次の表に このコントロールのカスタムプロパティとメソッドの一覧を示します 表 4-4 VACheck カスタムプロパティ VAccessName VAFieldName VADataType VAOffset VADebugMode VASize VADecimal 表 4-5 VACheck カスタムメソッド AboutBox 4-5

68 ActiveX コントロールリファレンス VACombo VACombo はテキストボックスとリストボックスの要素を結合します ユーザーは値を入力することも オプション一覧から選択することもできます 備考 VACombo は 3 つの異なるモードであるフィールドバウンド レコードリストおよびインデックスリストで操作できます このコントロールをフィールドバウンドデータコントロールとして使用するには VAFieldName プロパティに VAccessName プロパティで指定されているファイルのフィールドの 1 つの名前を割り当てます AddItem メソッドを使用して フィールドバウンドコンボボックスにこのフィールドの有効な選択肢一覧を追加することができます レコードリストモードでこのコントロールを使用するには VARecordList プロパティを True として設定します メモ VACombo の VARecordList 機能を使用する (VARecordList = True) 場合 1 つのフィールド名のみを SelectedFields プロパティで指定することができます そのフィールドはアクティブキーでインデックス付けされたフィールド ( またはセグメントキーでインデックス付けされたフィールドの 1 つ ) でなければなりません SelectedFields でフィールド名の複数指定はサポートされません 複数指定した場合 最初に指定したフィールドのみが VACombo コントロールに表示されます インデックスが付いていないフィールドの指定はサポートされません インデックスが付いていないフィールドを指定すると VACombo コントロールにはデータが表示されません 関連ファイルに定義されているインデックスをリストに設定し ユーザーが実行時に現在のインデックスを選択できるようにするには VAFieldName プロパティを "Index List" に設定します 4-6

69 VACombo カスタムプロパティとメソッド 表 4-6 VACombo カスタムプロパティ 次の表に このコントロールのカスタムプロパティとメソッドの一覧を示します IntegralHeight VAccessName VADecimal VAOffset List VADataType VAFieldName VARecordList VADebugMode VAFormat VASize 表 4-7 VACombo カスタムメソッド AboutBox Clear RemoveItem AddItem Refresh 4-7

70 ActiveX コントロールリファレンス VACommand VACommand を使用すると 実行時にボタンがクリックされた時点で データソースファイルに対する一般的な操作を実行できます 備考 VACommand は VAccessName プロパティを設計時あるいは実行時に設定することによって データソースにバインドされます VAOperation プロパティは 実行時 ボタンがクリックされたときに実行される操作を判別します VAOperation プロパティにレコード取得操作を指定した場合は VALockBias プロパティを使用して レコードが取得されている間そのレコードをロックすることができます VALockBias プロパティは Open Close Insert Update のオペレーションには影響しません VAErrorDialog プロパティは コントロールによって実行されたオペレーションがエラーを返した場合の ユーザーへのテキストメッセージの表示機能を有効にまたは無効にします メモ Click イベントは VAOperation プロパティに指定された Pervasive PSQL オペレーションの前に VACommand_Click サブルーチンのコードを実行します カスタムプロパティ次の表に このコントロールのカスタムプロパティの一覧を示します 表 4-8 VACommand カスタムプロパティ VAccessName VALockBias VADebugMode VAOperation VAErrorDialog 4-8

71 VAHScroll と VAVScroll VAHScroll と VAVScroll VAHScroll コントロールと VAVScroll コントロールは現在選択されているインデックスパスでデータソースをナビゲートします 備考 VAHScroll と VAVScroll は VAccessName プロパティを経由して VAccess コントロールにバインドされます スクロールバーのつまみの位置は Pervasive PSQL FindPercentage オペレーションよって決定される 現在のインデックスパスにおける現在のレコードの相対位置を反映しています つまみをドラッグした位置に該当するレコードは Pervasive PSQL GetByPercentage オペレーションによって取得されます カスタムプロパティ 次の表に このコントロールのカスタムプロパティの一覧を示します 表 4-9 VAHScroll と VAVScroll のカスタムプロパティ VAccessName VADebugMode Value 4-9

72 ActiveX コントロールリファレンス VAList VAList コントロールを使用すると ユーザーはリストから項目を選択できます 備考 VAList コントロールのデータソースは VAccessName プロパティの設定によって決まります リストボックスコントロールは VARecordList プロパティの設定によって決定される 2 つの異なるモードで動作できます VARecordList プロパティが False の場合は リストボックスはフィールドバウンドデータコントロールとして動作します VAFieldName プロパティをデータソース内のフィールド名の 1 つに設定することによって リストボックスのフィールドデータソースを割り当てます AddItem メソッドを使用して フィールドバウンドリストボックスにこのフィールドの有効な引数一覧を追加することができます VARecordList プロパティが True の場合は リストボックスは関連データソースの複数列のレコードリストとして動作します VAFieldName プロパティの値をセミコロンで区切って リスト内に表示されるフィールド一覧を設定します ( フィールドを空白のままにしておくと すべてのフィールドが設定されます ) 書式文字列の一覧をセミコロンで区切って VAFormat プロパティに指定することによって 各フィールドの書式を設定することもできます ColumnWidth プロパティを設定すると リストボックス内の列の横方向のスペースを制御できます 列幅はピクセル単位で測定されます カスタムプロパティとメソッド 次の表に このコントロールのカスタムプロパティとメソッドの一覧を示します 4-10

73 VAList 表 4-10 VAList カスタムプロパティ ColumnWidth VAccessName VADecimal VAOffset List VADataType VAFieldName VARecordList VAAutoScroll VADebugMode VAFormat VASize 表 4-11 VAList カスタムメソッド AboutBox Clear RemoveItem AddItem Refresh 4-11

74 ActiveX コントロールリファレンス VAOption VAOption コントロールはブール型 (True または False) のフィールド値の状態を表示します 備考 VAOption コントロールのデータソースは VAccessName プロパティの設定によって決まります フィールドソースは VAFieldName プロパティをデータソースのブール型 ( 論理あるいはビットタイプ ) フィールドの名前に設定することによってバインドされます フィールドの True ストレージ値と False ストレージ値は それぞれコントロールの VAValueTrue プロパティと VAValueFalse プロパティを使用して定義できます 指定の親ウィンドウ ( フォーム上 あるいはグループボックス内 ) で一度に 1 つのオプションボタンしか選択 つまり True にできません カスタムプロパティとメソッド 次の表に このコントロールのカスタムプロパティとメソッドの一覧を示します 表 4-12 VAOption カスタムプロパティ VAccessName VADebugMode VASize VADataType VAFieldName VAValueFalse VADecimal VAOffset VAValueTrue 表 4-13 VAOption カスタムメソッド AboutBox 4-12

75 VAText VAText VAText コントロールはフィールドの値を表示し ユーザーにその値の編集を許可します 備考 VAText コントロールのデータソースは VAccessName プロパティの設定によって決まります フィールドのソースは VAFieldName プロパティをデータソースのフィールドの名前に設定することによってバインドされます ほかのバウンドコントロールと同様 テキストボックスでの変更はメモリのデータバッファーに反映されますが 現在のレコードに対する更新または挿入操作が実行されるまでファイルには書き込まれません テキストボックスの VASearch プロパティが True の場合 テキストボックス内の変更を行うと テキストボックスのテキストの値を現在のインデックスの最初のセグメントとして使用して現在のレコードの位置を変更します レコードリストモードの VAList と検索モードのテキストボックスを一緒に使用して レコードブラウザーあるいはルックアップテーブルを実装することができます カスタムプロパティとメソッド 表 4-14 VAText カスタムプロパティ 次の表に このコントロールのカスタムプロパティとメソッドの一覧を示します AutoScroll VAccessName VAFieldName VASize FocusSelText VADataType VAFormat WantReturn LockedMaxLength VADebugMode VAOffset Uppercase VADecimal VASearch 表 4-15 VAText カスタムメソッド AboutBox 4-13

76 ActiveX コントロールリファレンス 4-14

77 カテゴリ別プロパティ メソッド 5 およびイベント この章は Pervasive PSQL 用に設計されたプロパティ メソッド およびイベントすべてを一覧にまとめ 次のセクションで機能別にします はじめに (5-2 ページ ) レコードセットの取得 (Extended オペレーション ) (5-3 ページ ) ファイルの処理 (5-5 ページ ) データ辞書メソッド (5-6 ページ ) レコード内のフィールドへのアクセス (5-8 ページ ) レコードの挿入 更新 および削除 (5-9 ページ ) 個別レコードの取得 (5-10 ページ ) 最適化とデバッグ (5-12 ページ ) 5-1

78 カテゴリ別プロパティ メソッド およびイベント はじめに プロパティ メソッド およびイベントは ActiveX コントロールに適用できる 3 種類の機能です プロパティとメソッドの違いは必ずしも明らかではありませんが 次のような文で明確にすることができます Let variable = method は一般に文法的に正しい構文です Let method = variable は 誤った構文です Let property = variable および Let variable = property は 両方とも文法的に正しい構文です イベントは ActiveX コントロールによってトリガーされるアプリケーション内の関数で ユーザーはこれに応答できます メモこの章に記載されているプロパティ メソッド およびイベントは Pervasive の ActiveX インターフェイス用に設計されたものです また 開発ツール (Visual Basic など ) で提供されるコントロールに関連付けられたほかのプロパティ メソッド およびイベントについてもされています 特定の開発ツールの情報についてはそのツールのマニュアルを参照してください 5-2

79 レコードセットの取得 (Extended オペレーション ) レコードセットの取得 (Extended オペレーション ) プロパティとメソッド ここでは レコードセットを取得する際に使用できるプロパティ メソッド およびイベントの一覧を示します 表 5-1 Extended オペレーション用プロパティおよびメソッド プロパティまたはメソッド AutoMode CacheRejectMax CacheRows CancelDialog Column ColumnName Columns ExtendedOps FocusSelText GetNextExtended GetPreviousExtended IncludeCurrent Init MaxBufferSize Extended Fetch データセットの自動キャッシュ処理を有効または無効にします SelectedRecords 条件を使用した単一 Extended Fetch オペレーションの処理でスキップ可能な最大レコード数を決定します 単一 Extended Fetch オペレーションによって返される最大行数を決定します ユーザーが一連の単一 Extended Fetch オペレーションをキャンセルすることのできるダイアログボックスを有効または無効にします Extended Fetch 結果セットの現在の列を決定します Extended Fetch 結果セットの現在の列の名前を指定します デフォルトは列に割り当てられたフィールド名です Extended Fetch 結果セットの合計列数を返します データソースに対して Extended Fetch プロパティおよびメソッドを有効または無効にします テキストボックスがフォーカスを取得したときの VAText ボックス内のテキストを選択します 現在のカーソル位置から始まり 現在のインデックスパスに沿って進行する Extended Fetch を実行します 現在のカーソル位置から始まり 現在のインデックスパスを遡る Extended Fetch を実行します 次に実行される Extended Fetch オペレーションのレコードセットの結果に現在のレコードを含めるか あるいは後続のレコードから始めるかどうかを決定します SelectedFields または SelectedRecords 条件を変更した後 あるいは新たに現在位置をファイル内で設定した後で Extended Fetch メソッドを呼び出す前に Extended Fetch パラメーターを割り当てます Extended Fetch オペレーションで使用するデータバッファーのサイズを指定します 5-3

80 カテゴリ別プロパティ メソッド およびイベント 表 5-1 Extended オペレーション用プロパティおよびメソッド プロパティまたはメソッド Row RowColumnValue RowPosition Rows SelectedFields SelectedRecords ShowSelectedFieldsDlg ShowSelectedRecordsDlg StepNextExtended StepPreviousExtended Extended Fetch の結果セットの現在の行を設定あるいは返します Extended Fetch メソッドからの結果セットへアクセスする場合に あるいは検索条件を満たす行間を移動する場合に使用します Extended Fetch 結果セット内の指定された行と列からフィールド値を返します Extended Fetch 結果セット内の現在の行にあるレコードの物理位置を返します Extended Fetch 結果セット内のデータの有効行数を返します Extended Fetch 結果セットの列として使用するフィールドを指定します デフォルトは空のリストで これはすべてのフィールドが含まれることを示します Extended Fetch 結果セットに返されるレコードのレコード選択条件を指定します デフォルトは空のリストで これはすべてのレコードが含まれることを示します SelectedFields プロパティの [ プロパティの設定 ] ダイアログボックスを表示します SelectedRecords プロパティの [ プロパティの設定 ] ダイアログボックスを表示します 現在の位置から始まり 物理レコード順を前方へ進む Extended Fetch を実行します 現在の位置から始まり 物理レコード順を後方へ進む ( 遡る ) Extended Fetch を実行します イベント 表 5-2 Extended オペレーション用イベント イベント Logon Extended Fetch 操作の完了に伴ない発生します 返されたデータバッファーに含まれるデータの行数および列数を返します 5-4

81 ファイルの処理 ファイルの処理 プロパティとメソッド ここでは ファイル処理を実行する際に使用できるプロパティとメソッドの一覧を示します 表 5-3 ファイルの処理用プロパティおよびメソッド プロパティまたはメソッド AutoOpen Close DataLength DdfPath FileVersion Insert Location Open OpenMode OwnerName PageSize SetOwner Stat TableName TotalRecords Extended Fetch データセットの自動キャッシュ処理を有効または無効にします コントロールに関連付けられたファイルを閉じます ファイルに対する単一レコードオペレーションで使用されるレコードデータバッファーのバイト長を取得または設定します 特定のデータ定義ファイルセットに VAccess コントロールを接続します Pervasive PSQL ファイルのバージョンを返します 現在のデータバッファーを新たなレコードとして挿入を試みます 選択された VAccess コントロールに関連付けられたテーブルのドライブ パス ファイル名を設定するか あるいは返します コントロールに関連付けられたファイルを開きます コントロールに関連付けられているファイルのオープンモードを取得または設定します VAccess コントロールに関連付けられたファイルを開くときに使用される Pervasive PSQL オーナーネームを指定します Pervasive PSQL データファイルのページサイズを取得または設定します ファイルのオーナーネームを設定します コントロールに関連付けられたファイルから現在のファイルのステータス情報を取得します コントロールに関連付けられているテーブルを示します VAccess コントロールに関連付けられた Pervasive PSQL ファイルに含まれているレコード数を返します 5-5

82 カテゴリ別プロパティ メソッド およびイベント データ辞書メソッド プロパティとメソッド ここでは データ辞書メソッドに使用できるプロパティとメソッドの一覧を示します 表 5-4 データ辞書処理用プロパティおよびメソッド プロパティまたはメソッド DdfAddIndex DdfAddTable DdfAddTableName DdfClearFields DdfClearIndexes DdfCreateDictionary DdfCreateTable DdfDropIndex DdfDropIndexMaintain DdfDropTable DdfGetFieldComments DdfKeyUseIndexDDFOnly DdfModifyLocation DdfModifyTableName DdfPath DDF ファイルおよび対応する Pervasive PSQL ファイルにインデックスを追加します 現在のテーブルを現在のデータ辞書に追加します 現在の VAccess コントロールメモリイメージに新たなテーブルを追加します 現在のテーブルの VAccess メモリイメージのフィールド情報を消去します 現在のテーブルの VAccess メモリイメージのインデックス情報を消去します 現在の位置に新たに空の DDF ファイルセットを作成します 辞書にテーブル定義を追加し 空のデータファイルを作成します 現在の Pervasive PSQL データファイルと現在のテーブルのデータ辞書定義からインデックスを削除します 既存インデックスの順序はそのまま維持して 現在の Pervasive PSQL データファイルと現在のテーブルのデータ辞書定義からインデックスを削除します 現在のテーブルをデータ辞書から削除します COMMENT.DDF ファイルからフィールドコメントを VAccess メモリイメージに読み取ります VAccess がファイルの実際のインデックスを使用するか あるいは DDF に指定されたインデックスを使用するかを指定します 現在のテーブルの場所を変更し オプションとして DDF に新しい場所を書き込みます 現在のテーブルの名前を変更し オプションとして DDF に新たな名前を書き込みます このコントロールに関連付けられた DDF ファイルが常駐するドライブとパスを設定します 5-6

83 データ辞書メソッド 表 5-4 データ辞書処理用プロパティおよびメソッド プロパティまたはメソッド DdfSetOwner DdfTestOwnerName DdfTransactionMode FieldList GetTableList IndexList Location RefreshLocations TableName 辞書ファイルの Btrieve オーナーネームをデフォルトのオーナーネーム (..SC...) セキュリティレベル ( 読み取り専用アクセス ) 以外に設定します 辞書を開く際に使用するオーナーネームを設定し このオーナーネームを使用して辞書が正常に開き 更新できるかどうかを判定します データ辞書テーブルへの更新がトランザクション内で実行されるかどうかを判定します ブール値を受け付けます またはブール値を返します 現在のテーブルのフィールドに関する情報を含むバリアント配列を設定します あるいはそのバリアント配列を返します 現在の辞書に定義されているテーブルのリストを 2 次元バリアント配列として返します 現在のテーブルのインデックスに関する情報を含むバリアント配列を設定します あるいはそのバリアント配列を返します VAccess コントロールに関連付けられている Pervasive PSQL ファイルのドライブ パス ファイル名を取得または設定します VAccess コントロールがメタデータに対し DDF ファイルを使用するのか あるいは内部状態と永続的なプロパティ ( またはどちらか一方 ) を使用するのかを判定します 現在の DDF セットに定義されているすべてのテーブルから どのテーブルが目的のコントロールと関連付けられているかを示します 5-7

84 カテゴリ別プロパティ メソッド およびイベント レコード内のフィールドへのアクセス プロパティとメソッド ここでは レコード内のフィールドにアクセスする際に使用できるプロパティとメソッドの一覧を示します 表 5-5 レコード内のフィールドへのアクセス用プロパティおよびメソッド プロパティまたはメソッド FieldList Fields FieldValue FormatFieldValue OemString 現在のテーブルのフィールドに関する情報を含むバリアント配列を設定します あるいはそのバリアント配列を返します 関連付けられたファイルに定義されたフィールドの合計数を設定します またはその合計数を返します メモリ内の現在のレコード あるいは Extended Fetch レコードセットの現在の行に対して指定されたフィールドの値を取得または設定します 指定の書式文字列を使用して書式設定された現在のレコードのフィールドの値を返します 英数字フィールドに保存されたデータを ANSI 文字セットと OEM 文字セットの間で変換します 5-8

85 レコードの挿入 更新 および削除 レコードの挿入 更新 および削除 プロパティとメソッド ここでは レコードを挿入 更新 削除する際に使用できるプロパティ メソッド イベントの一覧を示します 表 5-6 レコードの挿入 更新 および削除用プロパティおよびメソッド プロパティまたはメソッド Buffer Clear Delete Insert Refresh Transaction Unlock Update コントロールの現在のレコードバッファーの内容を取得または設定します メモリ内の現在のレコードのデータとインデックスバッファーの内容を消去します 現在のレコードを削除します メモリのレコードを新規レコードとしてファイルに挿入します バウンドコントロールを再描画します トランザクションを開始 終了 あるいは中断します ロックされたレコードのロックを解除します 現在のレコードをメモリ内のレコードイメージに更新します イベント 表 5-7 レコードの挿入 更新 および削除用イベント イベント Validate 関連付けられたテーブルでレコード操作が行われる前に発生します 5-9

86 カテゴリ別プロパティ メソッド およびイベント 個別レコードの取得 プロパティとメソッド ここでは レコードセットを取得する際に使用できるプロパティ メソッド イベントの一覧を示します 表 5-8 個別レコード取得用プロパティおよびメソッド プロパティまたはメソッド Buffer GetDirect GetEqual GetFirst GetGreater GetGreaterOrEqual GetLast GetLess GetLessOrEqual GetNext GetPrevious GetTotalSegments IndexNumber Percentage Position コントロールの現在のレコードバッファーの内容を取得または設定します ファイル内の物理位置を使用してレコードを返します 現在のインデックスと完全に一致するレコードを返します 現在のインデックスパスにある最初のレコードを返します 現在のインデックスパスにある現在のキー値よりも大きい最初のレコードを返します 現在のインデックスパスにある現在のキー値と等しい あるいは現在のキー値よりも大きい最初のレコードを返します 現在のインデックスパスにある最後のレコードを返します 現在のインデックスパスにある キーフィールドに指定された値よりも小さい値を含む最後のレコードを返します 現在のインデックスパスにある キーフィールドに指定された値よりも小さいまたは等しい値を含む最後のレコードを返します 現在のインデックスパスにある次のレコードを返します 現在のインデックスパスにある前のレコードを返します VAccess コントロールに関連付けられているファイルの 特定のインデックスに含まれるセグメントの総数を返します VAccess コントロールに関連付けられたテーブルの現在のインデックス番号を返します 関連付けられたテーブルの現在選択されているインデックスパス上の指定された相対位置に 取得するレコードを設定します VAccess コントロールに関連付けられたテーブルの現在のレコードの物理位置の値を返します 5-10

87 個別レコードの取得 表 5-8 個別レコード取得用プロパティおよびメソッド プロパティまたはメソッド RefreshLocations StepFirst StepLast StepNext StepPrevious VAccess コントロールがメタデータに対し DDF ファイルを使用するのか あるいは内部状態と永続的なプロパティ ( またはどちらか一方 ) を使用するのかを判定します 物理レコードの格納順での最初のレコードを返します 物理レコードの格納順での最後のレコードを返します 物理レコードの格納順での次のレコードを返します 物理レコードの格納順での前のレコードを返します イベント 表 5-9 個別レコード取得用イベント プロパティまたはメソッド Validate 関連付けられたテーブルでレコード操作が行われる前に発生します 5-11

88 カテゴリ別プロパティ メソッド およびイベント 最適化とデバッグ プロパティとメソッド ここでは 最適化とデバッグ機能を実行する際に使用できるプロパティとメソッドを一覧にまとめてあります 表 5-10 最適化とデバッグ用プロパティおよびメソッド プロパティまたはメソッド FireEvents Join SessionID Status StatusDialog VADebugMode VAccess コントロールのイベントの発生を有効または無効にします コントロールで使用可能なレコードを制限し 別の VAccess コントロールのフィールド値を基準とする 関連テーブルのリレーショナルな位置を維持します クライアントが使用するセッション ID を取得または設定します VAccess コントロールに関連付けられたファイルに対する最新の Pervasive PSQL オペレーションから Pervasive PSQL ステータスを返します ゼロ以外の数値に設定されると タスクモードのメッセージボックスを表示します コントロールに対するデバッグモードのエラーチェック機能を有効または無効にします 5-12

89 ActiveX プロパティリファレンス 6 この章では ActiveX インターフェイスのプロパティについてします アルファベット順にプロパティをします 6-1

90 ActiveX プロパティリファレンス AutoDialog 適用対象 VAccess ( 非推奨 - 以前の I*net Data Server のみ ) このプロパティが True に設定されていると コントロールは通信エラーが発生した場合に自動的にダイアログボックスをユーザーに表示します これは Pervasive PSQL サーバーに到達できない場合に発生します VAccess コントロールが IDS 経由でリモートデータへのアクセスを試みないのであれば このプロパティは無視されます 備考 AutoDialog プロパティは IDS 経由の通信エラーが発生した場合に ActiveX が自動的にダイアログボックスを表示するかどうかを決定します 再接続が可能な場合は ダイアログボックスに再接続を試行できるプロンプトが含まれます デフォルト値は False です 関連項目 Pervasive PSQL Programmer's Guide 6-2

91 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 イベント Pervasive PSQL Programmer's Guide 影響先 : Location Ddfpath 6-3

92 ActiveX プロパティリファレンス 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 (6-26 ページ ) を参照してください AutoMode プロパティが False に設定されている場合 データの取得はユーザー自身で行ってください Init メソッドの呼び出しでは Pervasive PSQL が Extended オペレーションの呼び出しで使用する構造体を割り当てるだけで データの取得は実行されません GetNextExtended GetPreviousExtended StepNextExtended または StepPreviousExtended メソッドを実行時に実行することによってデータをフェッチすることができます Extended オペレーションのキャッシュバッファーは 1 つだけメモリに保持され 後続のフェッチで再利用されます VAccess コントロールの Extended オペレーション機能を有効にするには ExtendedOps プロパティを True に設定する必要があります 関連項目 影響先 : GetNextExtended GetPreviousExtended StepNextExtended StepPreviousExtended Init Row 影響元 : ExtendedOps 6-4

93 AutoOpen AutoOpen 適用対象 VAccess AutoOpen プロパティは以前の RequireOpen プロパティと置き換えられたものです このプロパティは データファイルが妥当な場合に VAccess コントロールがそのファイルを自動的に開くかどうかを決定します このプロパティが True に設定されると VAccess は実行時のインスタンス生成時 また Location プロパティが変更されるたびに要求されたデータファイルを開こうとします このプロパティが False に設定されている場合は データファイルに対して何らかの操作を実行しようとする前には ユーザー自身で Open 呼び出しを行ってください 関連項目 影響先 : Location DdfPath 6-5

94 ActiveX プロパティリファレンス Buffer 適用対象 VAccess コントロールの現在のレコードバッファーの内容を取得または設定します レコードバッファーは Pervasive PSQL によって取得される未加工のデータです 構文 object.buffer(short alignment) Buffer プロパティの構文は次のような要素で構成されます 要素 object alignment 必須 VAccess オブジェクトの名前は [ 適用対象 ] のオブジェクトを評価するオブジェクト式を表します 必須 データのバイトアライメントを指定します alignment に対して受け付ける値は および 16 バイトです 備考 データは現在のレコードバッファーから読み取られ 書き込まれます 読み取りオペレーションでは このプロパティは現在のレコードバッファーを表すバイト配列を含む OLE Variant を返します 書き込みオペレーションでは このプロパティは現在のレコードバッファーに書き込まれるバイト配列を含む OLE Variant を取り出します このプロパティに対する変更は Update メソッドまたは Insert メソッドが正常に呼び出されるまで Btrieve ファイルには保存されません 返されるバッファーは単一レコードバッファーだけです Stat 呼び出しの後のステータスバッファーの内容は含みませんし Extended オペレーションの呼び出し後の Extended オペレーションレコードバッファーも含みません この情報は ほかのプロパティやメソッドからも利用できます (Stat RowColumnValue RowPosition を参照してください ) Clear メソッドはこのバッファーを消去します 特定のプログラミング環境では 構造化された変数用に特定のバイトアライメントを使用できます あるいは特定のバイトアライメントが必要です アライメントパラメーターを用いて レコード内の個別フィールドに使用するバイトアライメントを指定できます このプロパティは設計時には使用できません 6-6

95 Buffer 例 Public Type SAFEARRAYBOUNDS celements As Long llbound As Long End Type Public Type SAFEARRAY cdims As Integer ffeatures As Integer cbelements As Long clocks As Long pvdata As Long Bounds(0) As SAFEARRAYBOUNDS End Type Public Type Buffer msa_desc As String * 34 population As Long prev_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 integer Dim dataarray() as Buffer Dim bytearray() as Byte VAccess1.Open VAccess1.GetFirst Redim dataarray(vaccess1.totalrecords) For i = 0 to VAccess1.TotalRecords-1 ByteArray = VAccess1.Buffer(4) DataArray(i) = GetBuffer(byteArray) VAccess1.GetNext Next i End Sub Public Function GetBuffer(bufferArray() As Byte) _ as Buffer Dim status As Integer Dim saptr As Long Dim sastruct As SAFEARRAY 6-7

96 ActiveX プロパティリファレンス Dim 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 = record End Function 関連項目 影響元 : Clear GetDirect GetEqual GetGreaterOrEqual GetLessOrEqual GetFirst GetPrevious GetNext GetLast StepFirst StepPrevious StepNext StepLast Percentage 6-8

97 CacheRejectMax 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 を返します VAccess コントロールの Extended オペレーション機能を有効にするには ExtendedOps プロパティを True に設定する必要があります 関連項目 影響先 : GetPreviousExtended GetNextExtended StepPreviousExtended StepNextExtended 影響元 : SelectedRecords ExtendedOps 6-9

98 ActiveX プロパティリファレンス 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 プロパティを用いて返されるフィールド数を減らします VAccess コントロールの Extended オペレーション機能を有効にするには ExtendedOps プロパティを True に設定する必要があります 関連項目 影響先 : Rows 影響元 : ExtendedOps MaxBufferSize SelectedFields Init 6-10

99 CancelDialog CancelDialog 適用対象 VAccess AutoMode プロパティが True に設定されている場合 CancelDialog を True に設定すると 複数の Extended Fetch オペレーションが実行される間 ユーザーにダイアログボックスが表示されるようになります これを利用して ユーザーはオペレーションの合間にフェッチ要求をキャンセルできます AutoMode が True の場合 Extended Fetch オペレーションは Row プロパティの変更に伴って実行されます 備考 [Cancel] ダイアログボックスには 現在取得済みのレコード数が表示されます この数値は Extended Fetch イベントから新たなレコードブロックが返されるたびに更新されます AutoMode の Extended Fetch イベントをキャンセルすると キャンセル前に取得した行はメモリに保持されます このプロパティは AutoMode プロパティが False の場合にはまったく効果がありません VAccess コントロールの Extended オペレーション機能を有効にするには ExtendedOps プロパティを True に設定する必要があります 関連項目 影響元 : ExtendedOps Row AutoMode 6-11

100 ActiveX プロパティリファレンス Column 適用対象 VAccess Extended Fetch レコードセットのどの列が FieldValue プロパティおよび ColumnName プロパティの現在の列になるのかを指定します 備考 Extended Fetch レコードセットの各列はデータベースのフィールドと対応しています SelectedFields プロパティに値が指定されている場合 列値の順序は SelectedFields プロパティに記載されたフィールドの順序と同じです SelectedFields プロパティに値が指定されていない場合 列値の順序はデータベースレコードのフィールドの順序と同じです Column プロパティと Row プロパティで Extended Fetch オペレーションによって返されるレコードセットの個別フィールドを指定します Column プロパティの値の有効範囲は 1 ( 最初の列 ) から Columns プロパティの値 ( 最後の列 ) までです このプロパティは設計時には使用できません Column プロパティは ColumnName プロパティとペアになります 一方を設定すると もう一方も設定されます VAccess コントロールの Extended オペレーション機能を有効にするには ExtendedOps プロパティを True に設定する必要があります 特定のフィールド値を指定 取得する場合は 通常 Column よりも RowColumnValue の方が簡単です 関連項目 影響先 : ColumnName FieldValue RowColumnValue 影響元 : ExtendedOps 6-12

101 ColumnName ColumnName 適用対象 VAccess ColumnName プロパティには Extended Fetch オペレーションによって返されたレコードセットの 現在選択されている列に割り当てられたフィールドのフィールド名が格納されます 備考 ColumnName プロパティは Column プロパティとペアになります 一方を設定すると もう一方も設定されます つまり Column プロパティは ColumnName の現在の列を特定します このプロパティを連続で呼び出して列挙されたフィールドは FieldList で指定されたフィールドとは異なっている あるいは異なった順序になっている場合があります これは FieldList にはレコードの実際のフィールドがオフセット順で入っているのに対し 列は SelectedFields によって決定づけられるからです VAccess コントロールの Extended オペレーション機能を有効にするには ExtendedOps プロパティを True に設定する必要があります 関連項目 影響元 : Column SelectedFields ExtendedOps 6-13

102 ActiveX プロパティリファレンス Columns 適用対象 VAccess Columns プロパティは Extended Fetch レコードセットに定義されている列数を返します 備考 Extended Fetch オペレーションに対して SelectedFields プロパティが指定されている場合 この値は SelectedFields プロパティに指定されたフィールド数と同じです その他の場合は データファイルのレコードに対して定義された合計数と同じです ( Fields プロパティ を参照 ) このプロパティは設計時には使用できません 実行時は読み取り専用です このプロパティには Extended オペレーションの Init メソッドが実行時に呼び出された後にのみ有効なデータが入ります VAccess コントロールの Extended オペレーション機能を有効にするには ExtendedOps プロパティを True に設定する必要があります 例 ' この例では リストボックスを '1 つの Extended オペレーションバッファーのレコードで埋めます Dim line As String Dim colcount, rowcount As Integer Orders.GetFirst Orders.ExtendedOps = True Orders.Init Orders.GetNextExtended For rowcount = 1 To Orders.Rows Orders.Row = rowcount line = "" For colcount = 1 To Orders.Columns 'FieldValue は文字列と予想されるバリアントを返す ' 文字列であることを確認する If Not VarType(Orders.FieldValue(colcount)) = _ vberror Then line = line + CStr(Orders.FieldValue(colcount)) End If Next colcount ListBox.Add line Next rowcount 6-14

103 Columns 関連項目 影響元 : ExtendedOps SelectedFields 6-15

104 ActiveX プロパティリファレンス ColumnWidth 適用対象 VAList VAList オブジェクトの複数列レコードリストを利用する際 タブストップ ( タブ位置 ) を割り当てるには このプロパティを設定します VARecordList プロパティが False の場合 このプロパティには影響がありません 複数列レコードリストにタブストップを設定するには 次の手順を実行します 1 リストボックスの幅が すべての列データを収容できる十分な広さがあることを確認します 2 VARecordList チェックボックスを True に設定します 3 VAFieldName プロパティで表示する列をまだ選択していない場合は選択します ( これを行うには リストボックスで右クリックして プロパティページにアクセスします VAFieldName の横にある省略ボタンをクリックし 列を選択します ) 4 プロパティページの VAFieldName プロパティで 目的のフィールドを選択します 使用可能なフィールド ( 列 ) をダブルクリックすると それを選択することができます [OK] をクリックします 5 引き続きプロパティページから ColumnWidth コンボボックスの隣の省略ボタンをクリックし [Multi-Column Listbox Tab Settings] ウィンドウを開きます 選択した最初のフィールドが表示されます 6 最初のフィールドの右側をダブルクリックして 最初のタブストップを設定します 破線が現れます この線をドラッグし この列に表示されるデータ用のスペースを確保します 選択した列のタブがすべて表示され調整されるまで ダブルクリックと線のドラッグを繰り返します 図 6-1 を参照してください 6-16

105 ColumnWidth 図 6-1 複数列リストボックスのタブ設定 7 このウィンドウとプロパティページで [OK] をクリックします 関連項目 影響元 : VARecordList 6-17