ActiveX コントロール リファレンス
この章では、PSQL 用の 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 でバウンド コントロールとして動作するサード パーティ データ コントロールにバインドすることもできます。
カスタム プロパティ、メソッドおよびイベント
次の表に、このコントロールのカスタム プロパティ、メソッドおよびイベントの一覧をアルファベット順に示します。カスタム プロパティ、メソッド、およびイベントのカテゴリ別一覧は、
カテゴリ別プロパティ、メソッド、およびイベントを参照してください。
プロパティの一覧には、(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 |
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 |
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 |
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 | |
VACommand
説明
VACommand を使用すると、実行時にボタンがクリックされた時点で、データ ソース ファイルに対する一般的な操作を実行できます。
備考
VACommand は VAccessName プロパティを設計時あるいは実行時に設定することによって、データ ソースにバインドされます。
VAOperation プロパティは、実行時、ボタンがクリックされたときに実行される操作を判別します。
VAOperation プロパティにレコード取得操作を指定した場合は VALockBias プロパティを使用して、レコードが取得されている間そのレコードをロックすることができます。VALockBias プロパティは Open、Close、Insert、Update のオペレーションには影響しません。
VAErrorDialog プロパティは、コントロールによって実行されたオペレーションがエラーを返した場合の、ユーザーへのテキスト メッセージの表示機能を有効にまたは無効にします。
メモ:Click イベントは、VAOperation プロパティに指定された PSQL オペレーションの前に VACommand_Click サブルーチンのコードを実行します。
カスタム プロパティ
次の表に、このコントロールのカスタム プロパティの一覧を示します。
表 14 VACommand カスタム プロパティ
VAccessName | VALockBias |
VADebugMode | VAOperation |
VAErrorDialog | |
VAHScroll と VAVScroll
説明
VAHScroll コントロールと VAVScroll コントロールは現在選択されているインデックス パスでデータ ソースをナビゲートします。
備考
VAHScroll と VAVScroll は VAccessName プロパティを経由して VAccess コントロールにバインドされます。
スクロール バーのつまみの位置は、PSQL FindPercentage オペレーションよって決定される、現在のインデックス パスにおける現在のレコードの相対位置を反映しています。つまみをドラッグした位置に該当するレコードは、PSQL GetByPercentage オペレーションによって取得されます。
カスタム プロパティ
次の表に、このコントロールのカスタム プロパティの一覧を示します。
表 15 VAHScroll と VAVScroll のカスタム プロパティ
VAccessName | VADebugMode | Value |
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 | |
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 |
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 |