ipentry(n) An IP address entry widget ipentry(n)

NAME
       ipentry - An IP address entry widget

SYNOPSIS
       package require TTccll  88..44

       package require iippeennttrryy  ??00..11??

       ::::iippeennttrryy::::iippeennttrryy pathName ?option value...?

       pathName ccoommpplleettee

       pathName ggeett

       pathName iinnsseerrtt iplist

       pathName iiccuurrssoorr index

       pathName ccoonnffiigguurree option value...

       pathName ccggeett option



DESCRIPTION
       This  package  provides  a widget for the entering of a IP address.  It
       guarantees a valid address at all times.


       ::::iippeennttrryy::::iippeennttrryy pathName ?option value...?
              Creates a new ipentry widget and configures it  with  the  given
              options  and their values.  Each widget created with the command
              above supports the following methods:

       pathName ccoommpplleettee
              Returns a boolean value. True indicates that the entry  contains
              a complete IP address, meaning all 4 fields have a value.

       pathName ggeett
              Returns the contents of the entry as a list consisting of 4 ele-
              ments.

       pathName iinnsseerrtt iplist
              Takes a list of 4 elements and inserts one into each quad of the
              entry,  in order.  All values in the list must be integers. Val-
              ues outside the range 0 to 255 are modified  to  be  within  the
              range.

       pathName iiccuurrssoorr index
              Sets  the position of the widgets insertion cursor. Only integer
              values between 0 and 15 are valid. Because of the way the widget
              works,  setting the icursor will only have an effect if the wid-
              get already has the input focus.

       pathName ccoonnffiigguurree option value...
              Modifies the configuration of the widget. For options and  their
              meaning see the widget options section.

       pathName ccggeett option
              Returns  information about the current configuration of the wid-
              get, for the specified option. For options and their meaning see
              the widget options section.

WWiiddggeett ooppttiioonnss
       Command-Line Switch:    -ssttaattee
       Database Name:          ssttaattee
       Database Class:         SSttaattee

              Specifies  one  of three states for the entry: nnoorrmmaall, ddiissaabblleedd,
              or rreeaaddoonnllyy.

       Command-Line Switch:    -ffoonntt
       Database Name:          ffoonntt
       Database Class:         FFoonntt


       Command-Line Switch:    -bbdd
       Database Name:          bboorrddeerrWWiiddtthh
       Database Class:         BBoorrddeerrWWiiddtthh


       Command-Line Switch:    -ffgg
       Database Name:          ffoorreeggrroouunndd
       Database Class:         FFoorreeggrroouunndd


       Command-Line Switch:    -bbgg
       Database Name:          bbaacckkggrroouunndd
       Database Class:         BBaacckkggrroouunndd


       Command-Line Switch:    -rreelliieeff
       Database Name:          rreelliieeff
       Database Class:         RReelliieeff


       Command-Line Switch:    -hhiigghhlliigghhtttthhiicckknneessss
       Database Name:          hhiigghhlliigghhttTThhiicckknneessss
       Database Class:         HHiigghhlliigghhttTThhiicckknneessss


       Command-Line Switch:    -hhiigghhlliigghhttccoolloorr
       Database Name:          hhiigghhlliigghhttCCoolloorr
       Database Class:         HHiigghhlliigghhttCCoolloorr


       Command-Line Switch:    -hhiigghhlliigghhttbbaacckkggrroouunndd
       Database Name:          hhiigghhlliigghhttBBaacckkggrroouunndd
       Database Class:         HHiigghhlliigghhttBBaacckkggrroouunndd


       Command-Line Switch:    -sseelleeccttbbaacckkggrroouunndd
       Database Name:          sseelleeccttBBaacckkggrroouunndd
       Database Class:         BBaacckkggrroouunndd


       Command-Line Switch:    -sseelleeccttffoorreeggrroouunndd
       Database Name:          sseelleeccttFFoorreeggrroouunndd
       Database Class:         FFoorreeggrroouunndd


       Command-Line Switch:    -sseelleeccttbboorrddeerrwwiiddtthh
       Database Name:          sseelleeccttBBoorrddeerrWWiiddtthh
       Database Class:         BBoorrddeerrWWiiddtthh


       Command-Line Switch:    -ddiissaabblleeddbbaacckkggrroouunndd
       Database Name:          ddiissaabblleeddBBaacckkggrroouunndd
       Database Class:         DDiissaabblleeddBBaacckkggrroouunndd


       Command-Line Switch:    -ddiissaabblleeddffoorreeggrroouunndd
       Database Name:          ddiissaabblleeddFFoorreeggrroouunndd
       Database Class:         DDiissaabblleeddFFoorreeggrroouunndd


       Command-Line Switch:    -rreeaaddoonnllyybbaacckkggrroouunndd
       Database Name:          rreeaaddoonnllyyBBaacckkggrroouunndd
       Database Class:         RReeaaddoonnllyyBBaacckkggrroouunndd


       Command-Line Switch:    -iinnsseerrttbbaacckkggrroouunndd
       Database Name:          iinnsseerrttBBaacckkggrroouunndd
       Database Class:         BBaacckkggrroouunndd

              Standard widget options. See ooppttiioonnss for a description of  their
              meanings and values.

KKEEYYWWOORRDDSS
       entry, ip address



ipentry                               0.1                           ipentry(n)