ActiveX コントロールリファレンス

•このコントロールの 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 プロパティに指定された Pervasive PSQL オペレーションの前に VACommand_Click サブルーチンのコードを実行します。

カスタムプロパティ

次の表に、このコントロールのカスタムプロパティの一覧を示します。

表 14 VACommand カスタムプロパティ
VAccessName	VALockBias
VADebugMode	VAOperation
VAErrorDialog

VAHScroll と VAVScroll

説明

VAHScroll コントロールと VAVScroll コントロールは現在選択されているインデックスパスでデータソースをナビゲートします。

備考

VAHScroll と VAVScroll は VAccessName プロパティを経由して VAccess コントロールにバインドされます。

スクロールバーのつまみの位置は、Pervasive PSQL FindPercentage オペレーションよって決定される、現在のインデックスパスにおける現在のレコードの相対位置を反映しています。つまみをドラッグした位置に該当するレコードは、Pervasive 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 プロパティの設定によって決まります。

フィールドの 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