2.2.4.22.19 Grid::GetShowLabels

GetShowLabels

Description

Get all show column or row labels

Syntax

BOOL GetShowLabels( vector<int> & vnTypes, BOOL bCol = true )

Parameters

vnTypes

[output] returns all show label types

bCol

[input] true to set column labels, false to set row labels.

Return

TRUE if success else FALSE.

Examples

EX1

void Grid_GetShowLabels_ex2(bool bCol = true)
{
    Worksheet wks = Project.ActiveLayer();
    if(wks)
    {
        Grid gg;
        gg.Attach(wks); 
        
        vector<int> vnTypes;
        gg.GetShowLabels(vnTypes, bCol);        
    }    
}

EX2

// This example creates a worksheet with 3 columns. Then adds two user defined parameters to the row label. 
void Grid_SetUserDefinedLabelNames_ex1()
{
    Worksheet wks = Project.ActiveLayer();
    if(wks)
    {
    	Worksheet wks;
	wks.Create("Origin", CREATE_VISIBLE);
	wks.AddCol();
	Grid gg;
	gg.Attach(wks);  // attach the grid to the worksheet
        vector<string> vsUDLs = {"Operator", "MachineID"};
        gg.SetUserDefinedLabelNames(vsUDLs);   // Add two user defined labels. 
        vector<int> vnTypes;
        gg.GetShowLabels(vnTypes, TRUE);   // Get the current showing column labels. 
        vnTypes.Add(RCLT_UDL);
        vnTypes.Add(RCLT_UDL+1);
	gg.SetShowLabels(vnTypes); // Set the showing column labels
        wks.GetPage().Refresh();        
    }
}

Empty column label rows are created. To fill with label names, refer to this page.

Remark

See Also

Grid::IsLabelsShown, Grid::ShowLabels, Grid::SetShowLabels

Header to Include

origin.h