ESSG_DATA_T

EssbaseグリッドAPIで送受信するデータのフォーマットを記述します。この構造体を戻す呼出しでは、メンバー構造体内のメンバー名が戻されます。データ型がESSG_DT_MEMBERの場合、呼出し側はpszStフィールドではなくメンバー構造体を使用してAPIに同じ構造体を戻すことができます。

ESSG_DATA_Tデータ構造体は、グリッドAPIを介して送信または戻される各セルを定義します。この構造体が呼出し側に戻される場合、pszStrに文字列データが含まれdblDataに数値データが含まれます。usTypeフィールドは、セルがメンバー、数値、またはテキストのいずれかを判別するために使用します。同様に、構造体をAPIに渡す場合は、pszStrにメンバー名またはテキストを含める必要があり、dblDataに数値データを含める必要があります。usTypeフィールドは、セルのデータ型にあわせて設定します。セルのデータ型が不明な場合は、データ型をテキスト(ESSG_DT_STRING)に設定すると、サーバー側でデータがメンバーかどうかが判別されます。

      typedef struct ESSG_DATA_T
{  
   ESSG_PVOID_T    pAttributes;
   ESSG_DATA_VALUE Value;
   ESSG_USHORT_T   usType;
   ESSG_PVOID_T    pCellProps;
} ESSG_DATA_T;

ESS_TSA_API_typedef(ESSG_DATA_T *,  ESSG_PDATA_T);
ESS_TSA_API_typedef(ESSG_DATA_T **, ESSG_PPDATA_T);

   

データ型

フィールド

説明

ESSG_PVOID_T

pAttributes

セル・タイプまたはメンバー・タイプを表す次のLong型の整定数のいずれかになります(OUT)

ESSG_DATA_VALUE_T

Value

戻されたグリッド文字列の値

ESSG_USHORT_T

usType

データ型を表す次のタグ定数のいずれかになります(IN/OUT)

ESSG_PVOID_T

pCellProps

セルがドリルスルーURLに関連付けられているかどうかなどの、セル・プロパティを格納します

ESSG_DATA_Tの定数

次の定数は、セルのデータ型を指定するための定数で、ESSG_DATA_T構造体のpAttributesフィールドで使用します:

      ESSG_CA_READONLY
ESSG_CA_READWRITE
ESSG_CA_LINKEDOBJ
ESSG_CA_LINKPARTITION
ESSG_CA_LINKCELLNOTE
ESSG_CA_LINKWINAPP
ESSG_CA_LINKURL
ESSG_CA_AISDT
ESSG_CA_GLDT
   

次の定数は、メンバーのデータ型を指定するための定数で、ESSG_DATA_T構造体のpAttributesフィールドで使用します:

      ESSG_MA_DIMTOP
ESSG_MA_ZOOMINABLE
ESSG_MA_NEVERSHARE
ESSG_MA_LABELONLY
ESSG_MA_STOREDATA
ESSG_MA_EXPSHARE
ESSG_MA_IMPSHARE
ESSG_MA_DYNCALC
ESSG_MA_FORMULA
ESSG_MA_ATTRIBUTE
ESSG_MA_DIMNUMBITS
   

次の定数は、ESSG_DATA_T構造体のusTypeフィールドで使用します:

      ESSG_DT_UNUSED
ESSG_DT_STRING
ESSG_DT_LONG
ESSG_DT_DOUBLE
ESSG_DT_BLANK
ESSG_DT_RESERVED
ESSG_DT_ERROR
ESSG_DT_MISSING
ESSG_DT_ZERO
ESSG_DT_NOACCESS
ESSG_DT_MEMBER
ESSG_DT_FORMULA
ESSG_DT_ZEROwFORMULA
ESSG_DT_DOUBLEwFORMULA
ESSG_DT_BLANKwFORMULA
ESSG_DT_STRINGwFORMULA
ESSG_DT_MISSINGwFORMULA
ESSG_DT_NOACCESSwFORMULA
ESSG_DT_STRINGEX
ESSG_DT_MEMBEREX
ESSG_DT_STRINGEXwFORMULA
ESSG_DT_FORMULAEX
ESSG_DT_MEMBERwKEY
   

次の定数は、Unicodeモードで操作するためのusTypeフィールドの追加値です。

定数

定義

説明

ESSG_DT_STRINGEX

0x0018

この値は、Unicodeモードのために拡張された文字列を指定します。

ESSG_DT_MEMBEREX

0x0019

この値は、Unicodeモードのために拡張されたメンバー名を指定します。

ESSG_DT_STRINGEXwFORMULA

0x0002

この値は、Unicodeモードのために拡張された式文字列を指定します。

ESSG_DT_FORMULASEX

0x0021

この値は、Unicodeモードのために拡張された式を指定します。