Gtk2::Ex::FormFactory::Timestamp (3)

Leading comments

Automatically generated by Pod::Man 2.25 (Pod::Simple 3.16)

Standard preamble:
========================================================================

(The comments found at the beginning of the groff file "man3/Gtk2::Ex::FormFactory::Timestamp.3pm".)

NAME

Gtk2::Ex::FormFactory::Timestamp - Enter a valid timestamp

SYNOPSIS

  Gtk2::Ex::FormFactory::Timestamp->new (
    format    => A format string describing the the time fields
    ...    
    Gtk2::Ex::FormFactory::Widget attributes
  );

DESCRIPTION

This class implements a bunch of text entries to manage a valid timestamp (date and time down to minute level). The object value is a unix timestamp (in localtime).

OBJECT HIERARCHY

  Gtk2::Ex::FormFactory::Intro

  Gtk2::Ex::FormFactory::Widget
  +--- Gtk2::Ex::FormFactory::Timestamp

  Gtk2::Ex::FormFactory::Layout
  Gtk2::Ex::FormFactory::Rules
  Gtk2::Ex::FormFactory::Context
  Gtk2::Ex::FormFactory::Proxy

ATTRIBUTES

Attributes are handled through the common get_ATTR(), set_ATTR() style accessors, but they are mostly passed once to the object constructor and must not be altered after the associated FormFactory was built.

format =

SCALAR

[optional]

This is a format string to define which timestamp fields should be edited and how they should be displayed.

Format wildcards are defined as follows:

  %Y    Year, four digits
  %m    Month, two digits
  %d    Day of month, two digits
  %k    Hour of the day, two digits
  %M    Minutes, two digits

Everything else in the format string will be rendered as labels between the time field text entries.

The format string defaults to

  %d.%m.%Y %k:%M

All time fields which are not part of the format string will get a default value of 0.

For more attributes refer to Gtk2::Ex::FormFactory::Widget.

AUTHORS

 Jo.rn Reder <joern at zyn dot de>

COPYRIGHT AND LICENSE

Copyright 2004-2006 by Jo.rn Reder.

This library is free software; you can redistribute it and/or modify it under the terms of the

Library General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful, but

; without even the implied warranty of or A . See the Library General Public License for more details.

You should have received a copy of the

Library General Public License along with this library; if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, 02111-1307 .