/ 
TUI-Vision-2.000_001
/ 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). This documentation is provided under the same terms as the Turbo Vision library itself.