ipentry - An IP address entry widget
NAME SYNOPSIS DESCRIPTION WIDGET OPTIONS BUGS, IDEAS, FEEDBACK KEYWORDS CATEGORY______________________________________________________________________________
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.
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.
BUGS, IDEAS, FEEDBACK
This document, and the package it describes, will undoubtedly contain bugs and other problems. Please report such in the category ipentry of the Tklib Trackers [http://core.tcl.tk/tklib/reportlist]. Please also report any ideas for enhancements you may have for either package and/or documentation.
KEYWORDS
entry, ip address, network
CATEGORY
Widget