You are here: Section Rules Reference > Section Rules Summary > SpanAndFill

SpanAndFill

Use this section level rule to take a field and span its width between two other fields, filling the field with a fill character.

Syntax

SpanAndFill (SpanField,LeftField,RightField)

Parameters	Description
SpanField	Enter the name of the field you want to span. This field must be the first parameter.
LeftField	Enter the field you want to be on the left.
RightField	Enter the field you want to be on the right.

Note

This rule does not move the field vertically. Only the width and horizontal location are changed.

The filler character is used to span the width between the end of the text in the left field and the beginning of the text in the right field. If either field is empty, the left coordinate of the field is used.

You can use any rule to map the fill character into the SpanField. For example, you can use the HardExst rule to map a character such as a period or asterisk. Only the first character of the mapped data is used as the filler character. If no data is found in the SpanField, the system uses periods (.) as the fill character.

Note

You may want to use the JustFld rule on your right-most field to make sure the field is right justified.

Keep in mind...

If you use the Move_It rule, or other rules that support right justification by padding the data with spaces, your results will be incorrect. This rule calculates the width of a field based upon the entire contents and will not remove space from the fields.
This rule loads the section (FAP or compiled FAP) if it is not already loaded.
The font ID assigned to the SpanField is used for calculating the number of characters required to fill the width of the field.
If there is fractional space remaining, the system place the extra white space to the left of the SpanField.

SpanAndFill

Syntax

See also