Tk::FullKeypad - A full alphanumeric keypad widget


NAME

Tk::FullKeypad - A full alphanumeric keypad widget


SYNOPSIS

    my $e = $mw->Entry(...)->pack;   # Some entry widget
    my $kp = $mw->FullKeypad(-entry => $e)->pack;  # This keypad


DESCRIPTION

A full US keyboard as a keypad. This is useful for touchscreen or kiosk applications where access to a real keyboard won't be available.

The keypad is arranged as follows (this is a rough approximation, it looks better when rendered):

    ~` !1 @2 #3 $4 %5 ^6 &7 *8 (9 )0 _- += Backspace Delete
        Q  W  E  R  T  Y  U  I  O  P {[ }] |\         <--
    Caps A  S  D  F  G  H  J  K  L :; "'       Enter  -->
          Z  X  C  V  B  N  M  <, >. ?/  Space Shift Clear

The widget is designed to supply values to an Entry widget. Specify the Entry widget with the -entry option.

The Enter key currently does nothing (what should it do?) The Clear key will clear the contents of the associated Entry widget, regardless of if a slectedion is present or not.

The Shift key is ``sticky''. Press it once to shift to uppercase letters or the characters on the top of the keys; press again to go to lowercase. The key's lable changes from ``Shift'' to ``SHIFT'' to indicate the mode.

The Caps Lock key is also sticky. It changes from ``Caps Lock'' to ``CAPS LOCK'' to inidicate its mode. When enabled, it inverts the meaning of Shift for the alphabetic keys A thru Z.

The following options/value pairs are supported:

-entry
Identifies the associated Tk::Entry widget to be populated or cleared by this keypad.


METHODS

None.


ADVERTISED SUBWIDGETS

The individual buttons are advertised as ``KP'' + the button label For example, KPA KPB ... KPZ KP. KP, KP; KP< KP> and so on. For the specialty keys: Clear KPClear Left Arrow KPLeft Right Arrow KPRight Delete KPDel Backspace KPBack Shift KPShift Space KPSpace and also ``KP '' Enter KPEnter Caps Lock KPCaps


AUTHOR

Steve (at) HauntedMines (dot) org

Copyright (C) 2010. Steve Roscio. All rights reserved.

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


KEYWORDS

FullKeypad

 Tk::FullKeypad - A full alphanumeric keypad widget