---
name: "Tickit::Widget::VLine"
section: "3pm"
platform: "linux"
package: "libtickit-widgets-perl"
version: "0.42-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Tickit::Widget::VLine"
---

# Tickit::Widget::VLine(3pm)

a widget displaying a vertical line

## NAME

"Tickit::Widget::VLine" - a widget displaying a vertical line

## SYNOPSIS

```
   use Tickit::Widget::HBox;
   use Tickit::Widget::VLine;
   my $hbox = Tickit::Widget::HBox->new;
   $hbox->add( ... );
   $hbox->add( Tickit::Widget::VLine->new );
   $hbox->add( ... );
   Tickit->new( root => $hbox )->run;
```

## DESCRIPTION

This class provides a widget which displays a single vertical line, using line-drawing characters. It consumes the full height of the window given to it by its parent. By default it is drawn in the horizontal centre of the window but this can be adjusted by the `"align"` style value.

## STYLE

The default style pen is used as the widget pen.

The following additional style keys are used:

- line\_style =\> INT

  The style to draw the line in. Must be one of the `"LINE_*"` constants from Tickit::RenderBuffer.

- align =\> NUM \| STR

  A fraction giving a position within the window to draw the line. Defaults to `0.5`, which puts it in the centre.

  Symbolic names of `"left"`, `"centre"` and `"right"` are also accepted.

## CONSTRUCTOR

### new

```
   $vline = Tickit::Widget::VLine->new( %args );
```

Constructs a new `"Tickit::Widget::VLine"` object.

## AUTHOR

Paul Evans \<leonerd@leonerd.org.uk\>