EssGBeginSamplingZoomIn

ランダムにサンプリングされたズームイン操作を始めます。

構文

            ESSG_FUNC_M 
            EssGBeginSamplingZoomIn
             (
            hGrid, usCells, pZoomCells, ulSamplingPercentage, ulOptions
            );

パラメータ	データ型	説明
hGrid	ESSG_HGRID_T	EssGNewGridから戻されるハンドル。
usCells	ESSG_USHORT_T	pZoomCellsのセル範囲の数(配列のサイズ)。
pZoomCells	ESSG_RANGE_T	ズーム・インするセルを指定します。これはセル範囲の1次元配列です。
ulSamplingPercentage	ESSG_ULONG_T	サンプリング・レートのパーセンテージ。この数は、1以上100以下の整数です。100パーセントの深さの場合、次元のすべてのメンバーを取得します。これにより、効果的にサンプリングをオフにして、すべてのメンバーを取得します。ulSamplingPercentageが50の場合、メンバーの半分を取得します。
ulOptions	ESSG_ULONG_T	ズームインのタイプ(横または下)およびズームのレベルについて示すビットマスク。次の2つの値は互いに排他的です: ESSG_ZOOM_DOWN選択されたページ次元またはタイトル次元が下方向へズームされます ESSG_ZOOM_ACROSS選択されたページ次元が左右方向へズームされます ulOptionsの次のレベル値自身は相互に排他的です: ESSG_NEXTLEVEL子 ESSG_ALLLEVELSすべてのメンバー ESSG_BOTTOMLEVEL最下位レベル ESSG_SIBLEVEL兄弟レベル ESSG_SAMELEVEL同一レベル ESSG_SAMEGENERATION同世代 ESSG_CALCLEVEL計算 ESSG_OPTIONSグリッド・オプションの設定を使用ビット単位OR (\|)を使用して、ulOptionsを指定します。たとえば、ESSG_ZOOM_DOWN \| ESSG_NEXTLEVELとします

備考

ズーム・インするセルは、セル範囲の1次元配列として指定します。
この関数は、標準のグリッド・ズームイン関数EssGBeginZoomIn()とは異なります。この関数には、パーセンテージでサンプリングの深さを設定する引数があります。100パーセントの深さは、次元のすべてのメンバーを取得します。また、50パーセントの深さは、メンバーの半分を取得します。この関数は、大きな次元または非常に密な次元でズーム・インするのに特に役立ちます。

戻り値

正常終了の場合は、ESSG_STS_NOERRが戻されます。

アクセス

なし。