/ 
LibUI-0.02
River stage zero No dependents
/ LibUI::SearchEntry

NAME

LibUI::Entry - Single Line Text Entry Field Suitable for Sensitive Input

SYNOPSIS

use LibUI ':all';
use LibUI::VBox;
use LibUI::Window;
use LibUI::SearchEntry;
Init && die;
my $window = LibUI::Window->new( 'Hi', 320, 100, 0 );
$window->setMargined( 1 );
my $box    = LibUI::VBox->new();
my $pass   = LibUI::SearchEntry->new;
$box->append( $pass, 0 );
$pass->onChanged( sub { warn 'Query: ' . shift->text }, undef );
$window->setChild($box);
$window->onClosing(
    sub {
        Quit();
        return 1;
    },
    undef
);
$window->show;
Main();

DESCRIPTION

A LibUI::SearchEntry object represents a control with a single line text entry field.

Some systems will deliberately delay the onChanged( ... ) callback for a more natural feel.

This is a subclass of LibUI::Entry.

Functions

Not a lot here but... well, it's just a text box.

new( ... )

my $txt = LibUI::SearchEntry->new( );

Creates a new entry.

onChanged( ... )

$txt->onChanged(
sub {
    my ($ctrl, $data) = @_;
    warn $ctrl->text;
}, undef);

Registers a callback for when the user changes the entry's text.

Expected parameters include:

$callback - CodeRef that should expect the following:
$txt - backreference to the instance that initiated the callback
$data - user data registered with the sender instance
$data - user data to be passed to the callback

Note: The callback is not triggered when calling setText( ... ).

readonly( ... )

if( $txt->readonly( ) ) {
    ...;
}

Returns whether or not the entry's text can be changed.

setReadonly( ... )

$txt->setReadonly( 1 );

Sets whether or not the entry's text is read only.

setText( ... )

$txt->setText( 'Updated' );

Sets the entry's text.

text( ... )

warn $txt->text( );

Returns the entry's text.

LICENSE

Copyright (C) Sanko Robinson.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

AUTHOR

Sanko Robinson <sanko@cpan.org>