zplCore.comzplCore.com

ZplFields

public static class ZplFields

^FN template helpers: list the variable fields of a ZPL job (for forms) and produce a "filled" job in which every ^FN field carries its data as ^FD and ^DF/^XF formats are merged into plain labels. Rendering with ZplRenderSettings.FieldValues gives the same image as rendering the filled job.

Methods

Method SignatureReturnsDescription
static # Fill(string zpl, IReadOnlyDictionary<int, string>? values = default)stringReturns the job with ^FN fields filled: values (and the ^XF data) become ^FD data of the fields, formats recalled with ^XF are expanded in place with the stored ^DF content, and the ^DF downloads are dropped. ^FN data merges as on a Zebra printer (see ZplRenderer): a field with ^FN n and data fills the earlier fields of n without data, with its own ^FH; data no field waits for (a ^FD default in the stored format, data before the ^XF) stays an ordinary field. Labels without ^FN merges are copied unchanged. Values containing ^ or ~ are written with ^FH hex escapes.
static # Find(string zpl)IReadOnlyList<ZplFieldInfo>All ^FN field numbers of a ZPL job in source order (^DF formats, ^XF data blocks and ordinary labels).