NAME

ipentry -
An IP address entry widget

SYNOPSIS

package require Tcl 8.4
package require ipentry  ? 0.1 ? 
::ipentry::ipentry pathName  ? option value... ? 
pathName complete
pathName get
pathName insert iplist
pathName icursor index
pathName configure option value...
pathName cget option

DESCRIPTION

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

::ipentry::ipentry 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 complete

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

pathName get

Returns the contents of the entry as a list consisting of 4 elements.

pathName insert 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. Values outside the range 0 to 255 are modified to be within the range.

pathName icursor index

Sets the position of the widgets insertion cursor. Only integer values between 0 and 15 are valid. Setting the icursor will only have an effect if the widget already has the input focus.

pathName configure option value...

Modifies the configuration of the widget. For options and their meaning see the widget options section.

pathName cget option

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

WIDGET OPTIONS

KEYWORDS

entry, ip address