NAME

Gapp::Gtk2::TimeEntry -- Widget for entering times

SYNOPSIS

use Gapp::Gtk2::TimeEntry;
$te = Gapp::Gtk2::TimeEntry->new (value => '13:00:00');
$te->set_value('1pm');
$te->get_value;

WIDGET HIERARCHY

Gtk2::Widget
  Gtk2::Entry
    Gapp::Gtk2::TimeEntry

DESCRIPTION

Gapp::Gtk2::TimeEntry displays and edits a time in HH::MM PM format with some convienence functions.

Use the up and down keys to modify the invidual components of the value, and the left and right keys to navigate between them. Pressing up or down while the entire contents of the entry is selected (such as when you focus-in) modifies the value in 15 minute increments.

The time is stored in HH:MM:SS format (but displayed in HH:MM PM format). If you enter a value 24:00:00 or higher, it will loop back around.

You can also type a time into the entry in various formats, which will be parsed and then displayed in the entry in HH:MM PM format. Here are some examples of things you can enter into the widget and the resulting internal and display values.

INPUT       VALUE       DISPLAY
1           01:00:00    01:00 AM
10          10:00:00    10:00 AM
120         01:20:00    01:20 AM
1:20        01:20:00    01:20 AM
120pm       13:20:00    01:20 PM
01:20 PM    13:20:00    01:20 PM
30:20:00    04:20:00    04:20 AM

FUNCTIONS

$te = Gapp::Gtk2::TimeEntry->new (key=>value,...)

Create and return a new TimeEntry widget. Optional key/value pairs set initial properties per Glib::Object->new. Eg.

my $te = Gapp::Gtk2::TimeEntry->new (value => '16:00:00');

$te->get_selected_component

Returns the name of the currently selected component. Valid values are hours, minutes, meridiem, and all. An emptry string will be returned if the selection bounds contains less than 1 individual component, or more than 1 component but less than all of them.

$te->set_selected_component($component)

Highlights the given component, which can then be edited by typing over it or pressing the arrow keys up or down. Acceptable values are hours, minutes, meridiem, and all.

$te->set_now

Set the widget value to the current time.

PROPERTIES

value (string, default '')

The current time format in HH:MM:SS format. Can be set to an empty string for no time. When setting the value you, you may pass any acceptable value outlined in the widget description, but the time will always be stored in HH:MM:SS format.

SIGNALS

value-changed

Emitted after a succesful value change.

SEE ALSO

Gapp::Gtk2::DateEntry

AUTHOR

Jeffrey Ray Hallock <jeffrey.ray at ragingpony dot com>

BUGS

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

LICENSE

Gapp-Gtk2-TimeEntry is Copyright 2009 Jeffrey Hallock

Gapp-Gtk2-TimeEntry 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.

Gapp-Gtk2-TimeEntry 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 Gapp-Gtk2-TimeEntry. If not, see http://www.gnu.org/licenses/.