/ 
TUI-Vision-v2.0.1
/ TUI::Dialogs::HistoryWindow

NAME

TUI::Dialogs::HistoryWindow - window displaying input history entries

HIERARCHY

TObject
  TView
    TGroup
      TWindow
        THistoryWindow

SYNOPSIS

use TUI::Dialogs;

my $window = TUI::Dialogs::HistoryWindow->new(
  bounds    => $bounds,
  historyId => 1
);

DESCRIPTION

THistoryWindow implements the window used to display the history list managed by THistory. When the history icon is activated, a history window is created and populated with a list viewer showing previously entered values.

This class primarily exists to support the internal operation of history lists and is not commonly instantiated directly by application code. The window owns a THistoryViewer instance that handles rendering and selection of history entries.

ATTRIBUTES

The following attributes are managed internally and exposed as read-only accessors.

viewer

Reference to the history list viewer (THistoryViewer) contained within this window.

CONSTRUCTOR

new

my $window = THistoryWindow->new(
  bounds    => $bounds,
  historyId => $historyId
);

Creates a new history window and initializes its internal list viewer.

bounds

Bounding rectangle of the history window (TRect).

historyId

Numeric identifier selecting which history list is displayed.

new_THistoryWindow

my $window = new_THistoryWindow($bounds, $historyId);

Factory-style constructor using positional arguments.

This constructor is equivalent to calling new with named parameters and is provided for compatibility with traditional Turbo Vision construction patterns.

METHODS

getPalette

my $palette = $window->getPalette();

Returns the color palette used to draw the history window.

getSelection

$window->getSelection(\$dest);

Copies the currently selected history entry into $dest.

initViewer

my $viewer = $window->initViewer($rect, $window, $historyId);

Creates and initializes the internal history list viewer.

SEE ALSO

TUI::Dialogs::History, TUI::Dialogs::HistoryViewer, TUI::Dialogs::InputLine

AUTHORS

  • Borland International (original Turbo Vision design)

  • J. Schneider <brickpool@cpan.org> (Perl implementation and maintenance)

COPYRIGHT AND LICENSE

Copyright (c) 1990-1994, 1997 by Borland International

Copyright (c) 2026 the "AUTHORS" as listed above.

This software is licensed under the MIT license (see the LICENSE file, which is part of the distribution).