Anthony Fletcher > Tk-Month-1.7 > Tk::StrfClock

Download:
Tk-Month-1.7.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Module Version: 1.4   Source   Latest Release: Tk-Month-1.8

NAME ^

Tk::StrfClock - a X/TK digital clock widget based on strftime.

SYNOPSIS ^

  use Tk::StrfClock;

  $top->StrfClock(
        -type   => [Label|Button|Menubutton|Optionmenu],
        -format => <strftime format string>,
        -update => [<seconds>|s|m|h|d],
        -advance => [<seconds>],
        -action => <pattern matching action>,
        -ontick => <function>,
  );

DESCRIPTION ^

Tk::StrfClock is a string clock widget based on one of a Tk::Label, a Tk::Button, a Tk::Menubutton or a Tk::Optionmenu (chosen at creation time). The current date and time (in some chosen configuration) is displayed as the text in the base widget.

OPTIONS ^

All the base widget options are available.

-type => [Label|Button|Menubutton|Optionmenu],

        Setthe base widget type at creation time. This cannot be
        configured thereafter.  The default is Tk::Label.

-format => <strftime format string>

        Sets the required date/time format using POSIX strftime format.
        The default is "%c".

-update => <seconds>|s|m|h|d|a

        Sets how often the clock is updated.  If set to the characters
        s, m, h, d or a then the clock is updated exactly on the second,
        minute, hour, day or is automatically guessed.

        The default is 'a'.

-advance => <seconds>

        Sets the clock fast or slow this many seconds. The default is
        0.

-action => <pattern matching action>

        Sets a pattern matching action to be applied to the date string
        before it is displayed. The default is to do nothing.

-ontick => <function>

        Set a function to be run every tick of the clock. The default is
        none.

MINIMAL EXAMPLE ^

  use Tk;
  use Tk::StrfClock;

  my $top=MainWindow->new();
  $top->StrfClock()->pack();
  MainLoop();

TESTING ^

 Run the module itself to start a test program.
 To increase the size of the fond add something like
 *StrfClock*font: -*-fixed-medium-r-normal--20-*-*-*-*-*-*-*
 to your .Xdefaults file.
syntax highlighting: