2.2.3.1.1 CategoricalData::Attach

Attach

1 Description
2 Syntax
3 Parameters
4 Return
5 Examples
6 Remark
7 See Also
8 Header to Include

Description

Attach a CategoricalData object to an internal Origin data set.

Attach a CategoricalData object to an internal Origin data set by worksheet name and column number.

Syntax

BOOL Attach( LPCSTR lpcszDatasetName, UINT wType = CMT_ORDINAL )

BOOL Attach( LPCSTR lpcszWksName, UINT wColumnNumber, UINT wType = CMT_ORDINAL )

BOOL Attach( Column& col, UINT wType = CMT_ORDINAL )

Parameters

lpcszDatasetName: [Input] name of internal Origin data set
wType: [Input] type of CategoricalMap (only CMT_ORDINAL is supported)

lpcszWksName: [Input] name of internal Origin worksheet
wColumnNumber: [Input] column number in worksheet
col: [Input] column object
wType: [Input] type of CategoricalMap (only CMT_ORDINAL is supported)

Return

True if success else false

Examples

EX1

void CategoricalData_Attach_ex1()
{
    Worksheet wks;
    wks.Create();
    if (wks)
    { 
        Dataset ds(wks, 0);
        ds.SetSize(8);
        vector<string> vs = {"aaa", "bbb", "ddd", "ccc"};
        ds.PutStringArray(vs);

        string strWksColname = wks.Columns(0).GetName();
        strWksColname = wks.GetPage().GetName() + "_" + strWksColname;
        
        StringArray vMyCatMap;
        CategoricalData cdMyCatData;
        cdMyCatData.Attach(strWksColname, CMT_ORDINAL);
        vMyCatMap = (StringArray) cdMyCatData.Map; // Requires explicit cast
    }
}

EX2

void CategoricalData_Attach_ex2()
{
    Worksheet wks;
    wks.Create();
    if (wks)
    { 
        Dataset ds(wks, 0);
        ds.SetSize(8);
        vector<string> vs = {"aaa", "bbb", "ddd", "ccc"};
        ds.PutStringArray(vs);

        string strWksname = wks.GetPage().GetName();
        
        StringArray vMyCatMap;
        CategoricalData cdMyCatData;
        cdMyCatData.Attach(strWksname,0,CMT_ORDINAL);
        vMyCatMap = (StringArray) cdMyCatData.Map; // Requires explicit cast
    }
}

Remark

Attach a CategoricalData object to an internal Origin data set by worksheet name and column number.

Header to Include

origin.h