Table of Contents

Class LabelSheet

Namespace
DocWright.Dom.Editing
Assembly
DocWright.Dom.dll

A sheet of labels as Word builds it (Phase 168): Mailings > Labels > New Document (one address in every label) and Start Mail Merge > Labels (a merge sheet), from a LabelLayout; and Update Labels.

public static class LabelSheet
Inheritance
LabelSheet
Inherited Members

Remarks

Measured against Word (tools/Probe-WordLabels.ps1): the sheet is one continuous section whose margins put the first label where the layout says (bottom 0), holding a borderless fixed table with a column per label and a spacer column between two labels, a row per label row and a spacer row between two, each of the exact height. A gap smaller than 144 twips (0.1 in) gets no spacer: the label column or row is the pitch instead, and a gap folded into the columns is their cell margins, half each side (WQ-0147). Every paragraph is indented by half the label's width in points, as twips, at most 144. A merge sheet's labels after the first start with a NEXT field, so a merge puts the next record in each.

Fields

AddressSpaceBefore

The space before a sheet's address (Word's own, measured on its 72 to 216 pt labels).

MaxLineLength

The longest address line, in characters.

MaxLines

The most address lines.

MinimumSpacer

The smallest gap between labels that Word gives a spacer column or row (0.1 in).

Methods

Create(LabelLayout, IReadOnlyList<string>?)

Creates a sheet of labels: Word's Labels > New Document when lines are given (the address in every label, a paragraph per line), else an empty merge sheet (Start Mail Merge > Labels) whose labels after the first start with «Next Record».

UpdateLabels(WordDocument)

Word's Update Labels: every label of the document's first table that starts with a NEXT field takes a copy of the first label's content after that field. One undoable edit.