ipentry.3tk

Langue: en

Autres versions - même langue

Version: 0.2 (ubuntu - 07/07/09)

Section: 3 (Bibliothèques de fonctions)

Sommaire

NAME

ipentry - An IP address entry widget

SYNOPSIS

package require Tcl 8.4

package require ipentry ?0.2?

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

 
 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 or it will be modified to represent a valid IP address.
 
 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