NAME

GappX::Gtk2::SSNEntry - Gtk2 widget for entering social security numbers

SYNOPSIS

  use GappX::Gtk2::SSNEntry;

  $w = GappX::Gtk2::SSNEntry->new( value => 0123456789 );

  $w->get_value;

WIDGET HIERARCHY

Gtk2::Widget

+-- Gtk2::Entry

....+-- GappX::Gtk2::SSNEntry

DESCRIPTION

GappX::Gtk2::SSNEntry 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").

PROPERTIES

value

The value of the widget.

PROVIDED METHODS

new

Create and return a new SSN Entry widget.

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 components are selected.

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, or undef.

get_value

Return the internal value of the widget.

set_value $value

Set the internal value of the widget.

SIGNALS

value-changed

Emitted after a succesful value change.

SEE ALSO

GappX::SSNEntry

Gapp

AUTHORS

Jeffrey Ray Hallock <jeffrey.hallock at gmail dot com>

COPYRIGHT & LICENSE

    Copyright (c) 2012 Jeffrey Ray Hallock.

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