ActiveX Controls Guide (v11)

Percentage (ActiveX プロパティ)

適用対象

VAccess

説明

関連する Pervasive PSQL ファイルの現在選択されているインデックス パスに従って、指定された相対位置で取得するレコードを設定します。あるいは現在のレコードの相対位置を返します。

構文

object.Percentage [= value] 

Percentage プロパティの構文は次のような要素で構成されます。

要素
説明
object
[適用対象]のオブジェクトを評価するオブジェクト式です。
value
0.00% から 100.00% までに対応する、0 から 10000 までの範囲の Long 型整数値です。実行時にこのプロパティを設定すると、現在のインデックス パスに基づくおおよそのパーセント位置にあるレコードが取得されます。このプロパティを実行時に読み取ると、現在のレコードの位置を示す同範囲内の値が返ります。

備考

このプロパティを実行時に設定すると、関連付けられたファイルで Pervasive PSQL GetByPercentage オペレーションが実行されます。オペレーションのステータスはコントロールの Status プロパティに返されます。ステータス 0 は正常終了を示します。このプロパティを実行時に読み取ると、Pervasive PSQL FindPercentage オペレーションが実行され、オペレーションの結果が返されます。これらのオペレーションは MKDE 6.x 以降のバージョンにあります。値の範囲は、0.00 から 100.00 パーセントを表す 0 から 10,000 までです(または、精度を指定する場合は 0 から 0xFFFFFFFF までです。『Btrieve API Guide』の 「Get By Percentage(44)」および 「Find Percentage(45)」を参照してください)。xxPercentage オペレーションの精度は、さまざまな条件によって決まります。

ExtendedOps プロパティが False である場合、このプロパティを実行時に設定すると、関連ファイルで GetByPercentage オペレーションが実行されます。ExtendedOpsTrue の場合は、このプロパティを設定すると、現在の Row プロパティ値が現在の Extended オペレーション バッファー内で指定されたパーセント値に移動されます。

ExtendedOps プロパティが False である場合、このプロパティを実行時に読み取ると、FindPercentage オペレーションが実行され、オペレーションの結果がプロパティ値として返されます。ExtendedOpsTrue の場合は、返された値は現在の Extended オペレーション バッファー内の現在の行のパーセント値を表します。

'現在のインデックス パスを基に、中間にあるレコードの位置を確立する 
Customer.Percentage = 5000 
 
'スクロール バーのスクロール ボックスを、現在のレコードの位置にセットする 
VScroll1.Max = 10000 
VScroll1.Min = 0 
VScroll1.FieldValue = Customer.Percentage 

関連項目

影響先:Buffer


PageSize (ActiveX プロパティ)

Port (ActiveX プロパティ)