EssGGetCellLinkResults

前に呼び出したEssGBeginDrillOrLink()により作成されたリンクのリストを取得します。

構文

            ESSG_FUNC_M 
            EssGGetCellLinkResults
             (
            hGrid, pfCanDrill, pNumLROs, 
ppDrillData, pRangeOut, pState
            );

パラメータ	データ型	説明
hGrid;	ESSG_HGRID_T	EssGNewGrid()から戻されるグリッド・ハンドル。
pfCanDrill;	ESSG_PBOOL_T	セルにリンク済オブジェクトがある場合はTRUEが戻されます。EssGBeginDrillOrLink()にESSG_OPT_ZOOMオプションを指定して、結果のズームインを要求した場合は、pfCanDrillからFALSEが戻されます。
pNumLROs;	ESSG_PULONG_T	取得したリンクの数が戻されます。
ppDrillData;	ESSG_DRILLDATA_T	リンク・オブジェクトに関する情報が含まれるESSG_DRILLDATA_T構造体の配列への参照を戻します。
pRangeOut;	ESSG_RANGE_T	LROが検出されず、EssGBeginDrillOrLink()呼出しにESSG_OPT_ZOOMオプションを指定した場合には、ズームインするセル範囲が戻されます。
pState;	ESSG_PUSHORT_T	操作の状態を表す次のいずれかの値が戻されます: In progress - すべてのセルの取得が終了していません Done - すべてのセルの取得が終了しました

備考

この関数を使用すると、ESSG_DRILLDATA_Tにメモリーが割り当てられます。割り当てられているメモリーを解放する場合は、EssGFreeCellLinkResultsを呼び出してください。
この関数により取得されたハンドルは、次のグリッドAPI関数のいずれかを呼び出すまで有効です:
- EssGBeginDrillOrLink()
- EssGBeginCreateLRO()
- EssGUpdateLRO()
- EssGBeginDeleteLRO()
- EssGDeleteLRO()

戻り値

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