### 3.1.102 SpanBar

SpanBar objects are created by: Span_bar_engraver.

Standard settings:

> `allow-span-bar` (boolean):

>   `#t`

>   If false, no inter-staff bar line will be created below this bar line.

> `bar-extent` (pair of numbers):

>   `#<unpure-pure-container #<primitive-procedure ly:axis-group-interface::height> #<primitive-procedure ly:axis-group-interface::pure-height> >`

>   The Y-extent of the actual bar line. This may differ from `Y-extent` because it does not include the dots in a repeat bar line.

> `before-line-breaking` (boolean):

>   `ly:span-bar::before-line-breaking`

>   Dummy property, used to trigger a callback function.

> `break-align-symbol` (symbol):

>   `'staff-bar`

>   This key is used for aligning and spacing breakable items.

> `glyph-name` (string):

>   `ly:span-bar::calc-glyph-name`

>   The glyph name within the font.

>   In the context of (span) bar lines, glyph-name represents a processed form of `glyph`, where decisions about line breaking etc. are already taken.

> `layer` (integer):

>   `0`

>   An integer which determines the order of printing objects. Objects with the lowest value of layer are drawn first, then objects with progressively higher values are drawn, so objects with higher values overwrite objects with lower values. By default most objects are assigned a layer value of 1.

> `non-musical` (boolean):

>   `#t`

>   True if the grob belongs to a `NonMusicalPaperColumn`.

> `stencil` (stencil):

>   `ly:span-bar::print`

>   The symbol to print.

> `X-extent` (pair of numbers):

>   `ly:span-bar::width`

>   Extent (size) in the X direction, measured in staff-space units, relative to object’s reference point.

> `Y-extent` (pair of numbers):

>   `'(+inf.0 . -inf.0)`

>   Extent (size) in the Y direction, measured in staff-space units, relative to object’s reference point.

This object supports the following interface(s): bar-line-interface, font-interface, grob-interface, item-interface and span-bar-interface.

#### Internals Reference v2.18.2 (稳定分支).