NAME¶
ipentry - 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 methods:
- 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 widget, for the
specified option. For options and their meaning see the widget options
section.
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, network
CATEGORY¶
Widget