Changes between Version 12 and Version 13 of Docs/Prog/Manual/ApplicationLibraries/lib825ev/Ticket/CTktFlds

Timestamp:

08/06/12 14:49:38 (13 years ago)

Author:

Don Wilson

Comment:

--

Docs/Prog/Manual/ApplicationLibraries/lib825ev/Ticket/CTktFlds

@@ -152 +152 @@
 }}}
 
+=== SetEvent ===
+Sets an event to allow the application to do some processing during printing
+{{{
+void SetEvent(void* userData, TKT_EVENT func);
+}}}
+
+==== Parameters ====
+
+ * userData - Pointer to anything that may be useful to the event function
+ * func - Event function
+
+==== Retrun Value ====
+ 
+Function does not return any result.
+
+==== Remarks ====
+
+The event function receives four parameters. tkt is the ticket format TKT_STD, TKT_ALT, TKT_FPASS, TKT_LOG, TKT_SPEC1, ... TKT_SPEC6. p is a pointer to the struct tktfld_struct, file is the FILE* pointer for the output, code is the point during printing TKT_EVENT_BEFORE_BEGIN_PRINT (before begin print codes are printed) TKT_EVENT_AFTER_BEGIN_PRINT (after the begin print codes are printed but before any ticket text is printed) TKT_EVENT_BEFORE_END_PRINT (after ticket text is printed but before ending print codes are printed) TKT_EVENT_AFTER_END_PRINT (after end print codes are printed).
+
+
+==== Example ====
+
+{{{
+
+struct tran_info_struct
+{
+    int tktNum;
+    // ... other data
+} tran;
+
+TKT_EVENT(PrintBarCode)
+{
+   if(tkt == TKT_FPASS && code == TKT_EVENT_BEFORE_END_PRINT)
+   {
+      // Print bar code of the ticket number on P600 printer
+      struct tran_info_struct* pTran = (tran_info_struct*)p->userStruct;
+      if(pTran != NULL)
+      {
+          fprintf(file, "%cb428%c%07d%c", 0x1B, 0x40, pTran->tktNum, 0x1E);
+      }
+   }
+   return 0;
+}
+
+
+void AppPrint(void)
+{
+   string strTime = GetTimeStr(1); // Include seconds
+   string strGross = FormatGrossWt(1);
+
+   tran.tktNum++;
+
+   CTktFlds flds;
+   flds.Set(TKT_FLD_TIME, strTime);
+   flds.Set(TKT_FLD_GROSS, strGross);
+
+   flds.SetEvent(&tran, TktEventPrintBarCode);
+
+   flds.PrintTkt(TKT_STD);
+}
+}}}