Column::GetExtendedLabel

Description

Get the extended label by type of extended label.

Syntax

BOOL GetExtendedLabel( string & str, int nn, BOOL bByType = TRUE, DWORD dwCntrl = 0 )

Parameters

str
[input] the value.
nn
[input] the type. It can be one from this list.
bByType
[input] must be true.
dwCntrl
[input] Enumerated as COLGETEXTENDEDLABELSTR, internal used.

Return

TRUE if found, otherwise FALSE.

Examples

EX1

// Read out the column label rows from the active window
void Column_GetExtendedLabel_Ex1()
{
    Worksheet    wks = Project.ActiveLayer();
    string    strName;
    for( int ii = 0; ii < wks.GetNumCols() ; ii++ )
    {
        wks.Columns(ii).GetExtendedLabel(strName, RCLT_LONG_NAME);
        printf("Column %u has Long Name '%s'\n", ii + 1, strName);
        wks.Columns(ii).GetExtendedLabel(strName, RCLT_UNIT);
        printf("Column %u has Units '%s'\n", ii + 1, strName);
        wks.Columns(ii).GetExtendedLabel(strName, RCLT_COMMENT);
        printf("Column %u has Comment '%s'\n", ii + 1, strName);
        wks.Columns(ii).GetExtendedLabel(strName, RCLT_PARAM);
        printf("Column %u has Parameter1 '%s'\n", ii + 1, strName);
        wks.Columns(ii).GetExtendedLabel(strName, RCLT_PARAM + 1);
        printf("Column %u has Parameter2 '%s'\n", ii + 1, strName); // read out the second system parameter to string
        wks.Columns(ii).GetExtendedLabel(strName, RCLT_UDL);
        printf("Column %u has User Defined Parameter1 '%s'\n", ii + 1, strName);
        wks.Columns(ii).GetExtendedLabel(strName, RCLT_UDL+1);
        printf("Column %u has User Defined Parameter2 '%s'\n", ii + 1, strName); // read out the second user defined parameter to string
    }
}

Remark

Gets the extended label by type of extended label.

See Also

Column::SetExtendedLabel, Grid::GetUserDefinedLabelNames Grid::GetShowLabels Grid::SetShowLabels

header to Include

origin.h