NAME

Tk::TipEntry - An entry with tooltip in the entry if it's empty

SYNOPSIS

  use strict;
  use Tk::TipEntry;
  
  my $entry = $parent->FilterEntry(
        -tip => 'Search...', # will be the default hint text when entry is empty
  );
  $entry->pack();

DESCRIPTION

This widget is derived from Tk::Entry. It implements an other kind of tooltip, that is displayed inside the entry when it's empty. The tooltip will be removed, if the entry gets the focus and reinserted, if the entry loses the focus and it's value is empty ($entry->get() eq '').

In addition, the entry evaluates the escape key. If the entry has the focus and the escape key is pressed, the original input will be restored. If there is no previous input, the tooltip will be displayed again.

OPTIONS

Any option exept the -tip will be passed to the construktor of the Tk::Entry. The -text option is altered minimally.

-tip (new option)

Specify the tooltip, that will be displayed.

The default value is 'Search...'.

-text (altered option)

If there is no -text attribute for the Entry, the tooltip will be set initially as default text. Specify -text if you want another initial input.

The default value is the same as for -tip.

METHODS

FocusIn()

When the entry gets the focus, the tooltip will be removed.

FocusOut()

When the entry loses the focus and if it's empty, the tooltip will be inserted.

Escape()

If the escape key is pressed, the current input will be discarded. The previous input will be inserted. If there is no previous input, the -tip will be the new input.

SEE ALSO

Tk, Tk::Entry, Tk::FilterEntry

CREDITS

POD for Populate() partially taken from Tk::Wizard.

LICENSE

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.12.2 or, at your option, any later version of Perl 5 you may have available.

AUTHOR

This module was designed after Tk::FilterEntry.

Alexander Becker, asb@cpan.org

cpanm Tk::TipEntry

perl -MCPAN -e shell
install Tk::TipEntry