NAME

TUI::Drivers::Mouse - public mouse driver interface

SYNOPSIS

use TUI::Drivers::Mouse;

# Public driver-layer mouse API
TMouse->resume();

if ( TMouse->present() ) {
  TMouse->show();
  TMouse->setRange(79, 24);

  my %event;
  TMouse->getEvent(\%event);

  TMouse->hide();
}

TMouse->suspend();

DESCRIPTION

TUI::Drivers::Mouse provides the public entry point for mouse handling in the Turbo Vision driver layer.

The module exports the symbolic name TMouse, which resolves to the underlying hardware mouse implementation. All mouse-related operations are delegated to THWMouse.

This module does not implement any logic of its own and exists to provide a user-facing interface.

TMouse is a class-style interface. It must not be instantiated.

Commonly Used Features

Within the driver stack, THWMouse is used to coordinate backend mouse startup/shutdown (resume()/suspend()), query availability (present()), and read raw mouse state (getEvent()).

For complete interface documentation and application-facing usage, see TUI::Drivers::Mouse.

METHODS

show

TMouse->show();

Makes the mouse cursor visible.

hide

TMouse->hide();

Hides the mouse cursor.

setRange

TMouse->setRange($rx, $ry);

Sets the horizontal and vertical movement range of the mouse.

getEvent

TMouse->getEvent(\%event);

Retrieves the next mouse event and stores it in the supplied event structure.

present

my $bool = TMouse->present();

Returns true if mouse hardware is available.

inhibit

TMouse->inhibit();

Temporarily disables mouse event processing.

resume

TMouse->resume();

Initializes mouse handling.

suspend

TMouse->suspend();

Disables mouse handling.

SEE ALSO

TUI::Drivers::HWMouse

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) 2021-2026 the "AUTHORS" as listed above.

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