Syntax:

INT LlPrintIsChartFieldUsed (HLLJOB hJob, LPCTSTR lpszFieldName);

Task:

Specifies whether the given chart field is used in one of the expressions or conditions of the project.

Parameter:

hJob: List & Label job handle

lpszFieldName: Chart field name

Return Value:

A valid value is greater than 0. If the value is less than 0, it shows an errorcode. Please see chapters General Notes About the Return Value and Error Codes for further details.

Hints:

This function can only be called after LlPrintStart() or LlPrintWithBoxStart().

This function needs LL_OPTION_NEWEXPRESSIONS to be set to true (default).

As calling LlDefineChartFieldStart() clears the "used" flags, this function will return LL_ERR_UNKNOWN or 0 afterwards, regardless of whether the field is actually used or not. Therefore do not use LlDefineChartFieldStart() after LlPrint[WithBox]Start().

Instead of using a specific field name, wildcards can be used. For further information see LlPrintIsFieldUsed().

Example:

if (LlPrintIsChartFieldUsed(hJob, "Month") == 1)
   LlDefineChartFieldExt(hJob, "Month", <...>);

See also:

LlPrintStart, LlPrintWithBoxStart, LlPrintIsVariableUsed, LlPrintIsFieldUsed