ipentry(n) An IP address entry widget ipentry(n)______________________________________________________________________________NAMEipentry - An IP address entry widget
SYNOPSIS
package require Tcl 8.4
package require Tk 8.4
package require ipentry ?0.3?
::ipentry::ipentry pathName ?option value...?
::ipentry::ipentry6 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.
::ipentry::ipentry pathName ?option value...?
Creates a new IPv4 ipentry widget and configures it with the
given options and their values.
::ipentry::ipentry6 pathName ?option value...?
Creates a new ipentry widget for the entry of an IPv6 address.
All options are the same as the IPv4 widget.
Each widget created with the command above supports the following meth‐
ods:
pathName complete
Returns a boolean value. True indicates that the entry contains
a complete IP address, meaning all fields have a value. In some
cases IPv6 address are valid when fields are missing. You will
need to do your own validation to detect this.
pathName get
Returns the contents of the entry as a list consisting of 4 or 8
elements.
pathName insert iplist
IPv4 Takes a list of 4 elements and inserts one into each quad
of the entry, in order. All values in the list must be empty or
integers. Values outside the range 0 to 255 are modified to be
within the range. IPv6 Takes a list of 8 elements and inserts
one into each quad of the entry, in order. All values in the
list must be empty or 1 to 4 hex digits.
pathName icursor index
Sets the position of the widgets insertion cursor. Only integer
values between 0 and 15 are valid for ipentry and 0 to 31 for
ipentry6. 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 wid‐
get, for the specified option. For options and their meaning see
the widget options section.
WIDGET OPTIONS
Command-Line Switch: -textvariable
Database Name: textvariable
Database Class: Variable
The name of a variable which holds the value of the IP address.
The value must be a string of the form NNN.NNN.NNN.NNN for IPv4
or HHHH:HHHH:HHHH:HHHH:HHHH:HHHH:HHHH:HHHH for IPv6 where H is a
hex digit. The variable will be modified to represent a valid
IP address if it is not already.
Command-Line Switch: -state
Database Name: state
Database Class: State
Specifies one of three states for the entry: normal, disabled,
or readonly.
Command-Line Switch: -font
Database Name: font
Database Class: Font
Command-Line Switch: -bd
Database Name: borderWidth
Database Class: BorderWidth
Command-Line Switch: -fg
Database Name: foreground
Database Class: Foreground
Command-Line Switch: -bg
Database Name: background
Database Class: Background
Command-Line Switch: -relief
Database Name: relief
Database Class: Relief
Command-Line Switch: -highlightthickness
Database Name: highlightThickness
Database Class: HighlightThickness
Command-Line Switch: -highlightcolor
Database Name: highlightColor
Database Class: HighlightColor
Command-Line Switch: -highlightbackground
Database Name: highlightBackground
Database Class: HighlightBackground
Command-Line Switch: -selectbackground
Database Name: selectBackground
Database Class: Background
Command-Line Switch: -selectforeground
Database Name: selectForeground
Database Class: Foreground
Command-Line Switch: -selectborderwidth
Database Name: selectBorderWidth
Database Class: BorderWidth
Command-Line Switch: -disabledbackground
Database Name: disabledBackground
Database Class: DisabledBackground
Command-Line Switch: -disabledforeground
Database Name: disabledForeground
Database Class: DisabledForeground
Command-Line Switch: -readonlybackground
Database Name: readonlyBackground
Database Class: ReadonlyBackground
Command-Line Switch: -insertbackground
Database Name: insertBackground
Database Class: Background
Standard widget options. See options for a description of their
meanings and values.
KEYWORDS
entry, ip address
ipentry 0.3 ipentry(n)
