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. Because of the way the widget works, 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

NameDatabase nameDatabase class
-statestateState
  Specifies one of three states for the entry: normal, disabled, or readonly.
-fontfontFont
 
-bdborderWidthBorderWidth
 
-fgforegroundForeground
 
-bgbackgroundBackground
 
-reliefreliefRelief
 
-highlightthicknesshighlightThicknessHighlightThickness
 
-highlightcolorhighlightColorHighlightColor
 
-highlightbackgroundhighlightBackgroundHighlightBackground
 
-selectbackgroundselectBackgroundBackground
 
-selectforegroundselectForegroundForeground
 
-selectborderwidthselectBorderWidthBorderWidth
 
-disabledbackgrounddisabledBackgroundDisabledBackground
 
-disabledforegrounddisabledForegroundDisabledForeground
 
-readonlybackgroundreadonlyBackgroundReadonlyBackground
 
-insertbackgroundinsertBackgroundBackground
  Standard widget options. See options for a description of their meanings and values.

KEYWORDS

entry, ip address