Name

ipentry - An IP address entry widget

Table Of Contents

• Table Of Contents
• Synopsis
• Description
• Widget options
• Keywords

Synopsis

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