[[TOC]]
= CTktFlds =
CTktFlds is a C++ class that is a wrapper around struct tktfld_struct to simplify ticket programming.

== Constructor ==

{{{
CTktFlds(void);
}}}

==== Parameters ====

Constructor does not accept any parameters

==== Examples ====

{{{
CTktFlds flds;
}}}

This contructs the object.

== Member Functions ==

=== Clear ===
Clears all references or a specified item.

{{{
void Clear(void);

void Clear(int nFld);
}}}

==== Parameters ====

 * nFld - Ticket item to clear
Version with no parameters clears all fields

==== Return Value ====

Function does not return a result.

==== Remarks ====


==== Examples ====

{{{
CTktFlds flds;
flds.Set(TKT_FLD_TIME, strTime);
flds.Set(TKT_FLD_GROSS, strGross);
PrintTkt(TKT_STD, flds);
}}}

{{{
CTktFlds flds;
flds.Set(TKT_FLD_TIME, strTime);
flds.Set(TKT_FLD_GROSS, strGross);
flds.PrintTkt(TKT_STD);

// Clear the entire flds object to start over
flds.Clear();
flds.Set(TKT_FLD_TIME, strTime);
flds.Set(TKT_FLD_NET, strNet);
flds.PrintTkt(TKT_ALT);
}}}

{{{
CTktFlds flds;
flds.Set(TKT_FLD_TIME, strTime);
flds.Set(TKT_FLD_GROSS, strGross);
flds.PrintTkt(TKT_STD);

// Clear the gross weight reference so it will not print on the alternate ticket, time will still print
flds.Clear(TKT_FLD_GROSS);
flds.Set(TKT_FLD_NET, strNet);
flds.PrintTkt(TKT_ALT);
}}}

=== Set ===
Sets a reference
{{{
void Set(int nFld, string& str);
void Set(int nFld, char* psz);
void Set(int nFld, const char* psz);
}}}

==== Parameters ====

 * nFld - Field to set
 * str - String variable
 * psz - pointer to character array

==== Retrun Value ====
 
Function does not return any result.

==== Remarks ====

The TKT_FLD_xxx definitions relate to the ticket field position information provided in the "Configuration" program. Refer to the chart below.

||ID||Typical use||
||TKT_FLD_CNV_UNITS||Converted weight units||
||TKT_FLD_GROSS||Gross weight||
||TKT_FLD_TARE||Tare weight||
||TKT_FLD_NET||Net weight||
||TKT_FLD_TIME||Time||
||TKT_FLD_DATE||Date||
||TKT_FLD_ID||ID||
||TKT_FLD_CN||Consecutive number||
||TKT_FLD_UNITS||Weight units||
||TKT_FLD_DSP_WT||Display weight||
||TKT_FLD_PC_CNT||Piece count||
||TKT_FLD_TOT_CNT||Total count||
||TKT_FLD_ID1||ID1||
||TKT_FLD_ID2||ID2||
||TKT_FLD_ID3||ID3||
||TKT_FLD_G_ACCUM||Gross weight accumulator||
||TKT_FLD_N_ACCUM||Net weight accumulator||
||TKT_FLD_PRMPT1||Prompt 1||
||TKT_FLD_PRMPT2||Prompt 2||
||TKT_FLD_PRMPT3||Prompt 3||
||TKT_FLD_REF1||Reference 1||
||TKT_FLD_REF2||Reference 2||
||TKT_FLD_REF3||Reference 3||
||TKT_FLD_CNV_DSP_WT||Converted display weight||
||TKT_FLD_CNV_G_ACCUM||Converted gross accumulator||
||TKT_FLD_CNV_N_ACCUM||Converted net accumulator||
||TKT_FLD_CNV_GROSS||Converted gross weight||
||TKT_FLD_CNV_TARE||Converted tare weight||
||TKT_FLD_CNV_NET||Converted net weight||

==== Example ====

{{{
string strTime = GetTimeStr(1); // Include seconds
string strGross = FormatGrossWt(1);

CTktFlds flds;
flds.Set(TKT_FLD_TIME, strTime);
flds.Set(TKT_FLD_GROSS, strGross);
flds.PrintTkt(TKT_STD);
}}}