NAME

Gtk2::Ex::Entry::SSN -- Gtk2 widget for entering social security numbers

SYNOPSIS

 use Gtk2::Ex::Entry::SSN;
 $w = Gtk2::Ex::DateEntry->new(value => '012-345-6789');
 $w->get_value;

WIDGET HIERARCHY

    Gtk2::Widget
      Gtk2::Entry
        Gtk2::Ex::Entry::SSN

DESCRIPTION

Gtk2::Ex::Entry::SSN displays and edits a social security number.

Navigate between the three components of a social security number using the left and right arrow keys. The value of the widget will be stored internally as a 9 character string consisting only of digits (i.e. "0123456789"). However, the text that is displayed in the widget will be displayed with hyphens between the components (i.e. "012-345-6789").

FUNCTIONS

$te = Gtk2::Ex::Entry::SSN->new ()

Create and return a new SSN Entry widget.

$te->get_selected_component

Returns the currently selected component - any of 0, 1, or 2; An emptry string will be returned if the selection bounds contains more or less than 1 individual component, and will return 'all' if all componentes are selected.

$te->set_selected_component($component)

Highlights the given component, which can then be edited by typing over it. You can pass the values 0, 1, 2, 'all', 'none', undef, or an emptry string.

$te->get_value

Return the internal value of the widget.

$te->set_value ($value)

Set the internal value of the widget.

SIGNALS

value-changed

Emitted after a succesful value change.

SEE ALSO

Gtk2::Ex::FormFactory::Entry::SSN

AUTHOR

Jeffrey Hallock <jeffrey.ray at ragingpony com>

BUGS

None known. Please send bugs to <jeffrey.ray at ragingpony dot com>. Patches and suggestions welcome.

LICENSE

Gtk2-Ex-Entry-SSN is Copyright 2009 Jeffrey Ray Hallock

Gtk2-Ex-Entry-SSN is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3, or (at your option) any later version.

Gtk2-Ex-Entry-SSN is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with Gtk2-Ex-Entry-SSN. If not, see http://www.gnu.org/licenses/.