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

この章では、PSQL 用の ActiveX コントロールについて説明し、コントロールの種類ごとにプロパティ、メソッド、イベントを一覧に示しています。以下の項目について説明します。

VAccess コントロールはデータソースコントロールです。これはアプリケーションのソースコードとのデータベース通信、およびほかの 8 個のバウンドコントロールとサードパーティのコントロールへのデータ転送を提供します。

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

フィールドソースは、VAFieldName プロパティをデータソースのブール型（論理あるいはビットタイプ）フィールドの名前に設定することによってバインドされます。

フィールドの True ストレージ値と False ストレージ値の、それぞれ 1 と 0 以外の値は、コントロールの VAValueTrue プロパティと VAValueFalse プロパティを使用して定義できます。

VACombo はテキストボックスとリストボックスの要素を結合します。ユーザーは値を入力することも、オプション一覧から選択することもできます。

VACombo は、フィールドバウンド、レコードリスト、およびインデックスリストという 3 つの異なるモードで動作します。

表 10 VACheck カスタムプロパティ
VAccessName	VAFieldName
VADataType	VAOffset
VADebugMode	VASize
VADecimal

表 11 VACheck カスタムメソッド
AboutBox

このコントロールをフィールドバウンドデータコントロールとして使用するには、VAFieldName プロパティに VAccessName プロパティで指定されているファイルのフィールドの 1 つの名前を割り当てます。AddItem メソッドを使用して、フィールドバウンドコンボボックスにこのフィールドの有効な選択肢一覧を追加することができます。

メモ： 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

VACommand を使用すると、実行時にボタンがクリックされた時点で、データソースファイルに対する一般的な操作を実行できます。

表 13 VACombo カスタムメソッド
AboutBox	Clear	RemoveItem
AddItem	Refresh

VACommand は VAccessName プロパティを設計時あるいは実行時に設定することによって、データソースにバインドされます。

VAOperation プロパティにレコード取得操作を指定した場合は VALockBias プロパティを使用して、レコードが取得されている間そのレコードをロックすることができます。VALockBias プロパティは Open、Close、Insert、Update のオペレーションには影響しません。

VAErrorDialog プロパティは、コントロールによって実行されたオペレーションがエラーを返した場合の、ユーザーへのテキストメッセージの表示機能を有効にまたは無効にします。

メモ： Click イベントは、VAOperation プロパティに指定された PSQL オペレーションの前に VACommand_Click サブルーチンのコードを実行します。

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

スクロールバーのつまみの位置は、PSQL FindPercentage オペレーションよって決定される、現在のインデックスパスにおける現在のレコードの相対位置を反映しています。つまみをドラッグした位置に該当するレコードは、PSQL GetByPercentage オペレーションによって取得されます。

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

表 15 VAHScroll と VAVScroll のカスタムプロパティ
VAccessName	VADebugMode	Value

リストボックスコントロールは、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

フィールドの True ストレージ値と False ストレージ値は、それぞれコントロールの VAValueTrue プロパティと VAValueFalse プロパティを使用して定義できます。

指定の親ウィンドウ（フォーム上、あるいはグループボックス内）で一度に 1 つのオプションボタンしか選択、つまり True にできません。

表 18 VAOption カスタムプロパティ
VAccessName	VADebugMode	VASize
VADataType	VAFieldName	VAValueFalse
VADecimal	VAOffset	VAValueTrue

表 19 VAOption カスタムメソッド
AboutBox

フィールドのソースは、VAFieldName プロパティをデータソースのフィールドの名前に設定することによってバインドされます。

ほかのバウンドコントロールと同様、テキストボックスでの変更はメモリのデータバッファーに反映されますが、現在のレコードに対する更新または挿入操作が実行されるまでファイルには書き込まれません。

テキストボックスの VASearch プロパティが True の場合、テキストボックス内の変更を行うと、テキストボックスのテキストの値を現在のインデックスの最初のセグメントとして使用して現在のレコードの位置を変更します。レコードリストモードの VAList と検索モードのテキストボックスを一緒に使用して、レコードブラウザーあるいはルックアップテーブルを実装することができます。

表 20 VAText カスタムプロパティ
AutoScroll	VAccessName	VAFieldName	VASize
FocusSelText	VADataType	VAFormat	WantReturn
LockedMaxLength	VADebugMode	VAOffset
Uppercase	VADecimal	VASearch