1ipentry(n) An IP address entry widget ipentry(n)
2______________________________________________________________________________
6
8 ipentry - An IP address entry widget
9
11 package require Tcl 8.4
12 package require Tk 8.4
14 package require ipentry ?0.3?
16 ::ipentry::ipentry pathName ?option value...?
18 ::ipentry::ipentry6 pathName ?option value...?
20 pathName complete
22 pathName get
24 pathName insert iplist
26 pathName icursor index
28 pathName configure option value...
30 pathName cget option
32_________________________________________________________________
34
36 This package provides a widget for the entering of a IP address.
37 ::ipentry::ipentry pathName ?option value...?
39 Creates a new IPv4 ipentry widget and configures it with the
40 given options and their values.
41 ::ipentry::ipentry6 pathName ?option value...?
43 Creates a new ipentry widget for the entry of an IPv6 address.
44 All options are the same as the IPv4 widget.
45 Each widget created with the command above supports the following meth‐
47 ods:
48 pathName complete
50 Returns a boolean value. True indicates that the entry contains
51 a complete IP address, meaning all fields have a value. In some
52 cases IPv6 address are valid when fields are missing. You will
53 need to do your own validation to detect this.
54 pathName get
56 Returns the contents of the entry as a list consisting of 4 or 8
57 elements.
58 pathName insert iplist
60 IPv4 Takes a list of 4 elements and inserts one into each quad
61 of the entry, in order. All values in the list must be empty or
62 integers. Values outside the range 0 to 255 are modified to be
63 within the range. IPv6 Takes a list of 8 elements and inserts
64 one into each quad of the entry, in order. All values in the
65 list must be empty or 1 to 4 hex digits.
66 pathName icursor index
68 Sets the position of the widgets insertion cursor. Only integer
69 values between 0 and 15 are valid for ipentry and 0 to 31 for
70 ipentry6. Setting the icursor will only have an effect if the
71 widget already has the input focus.
72 pathName configure option value...
74 Modifies the configuration of the widget. For options and their
75 meaning see the widget options section.
76 pathName cget option
78 Returns information about the current configuration of the wid‐
79 get, for the specified option. For options and their meaning see
80 the widget options section.
81
83 Command-Line Switch: -textvariable
84 Database Name: textvariable
85 Database Class: Variable
86 The name of a variable which holds the value of the IP address.
89 The value must be a string of the form NNN.NNN.NNN.NNN for IPv4
90 or HHHH:HHHH:HHHH:HHHH:HHHH:HHHH:HHHH:HHHH for IPv6 where H is a
91 hex digit. The variable will be modified to represent a valid
92 IP address if it is not already.
93 Command-Line Switch: -state
95 Database Name: state
96 Database Class: State
97 Specifies one of three states for the entry: normal, disabled,
100 or readonly.
101 Command-Line Switch: -font
103 Database Name: font
104 Database Class: Font
105 Command-Line Switch: -bd
108 Database Name: borderWidth
109 Database Class: BorderWidth
110 Command-Line Switch: -fg
113 Database Name: foreground
114 Database Class: Foreground
115 Command-Line Switch: -bg
118 Database Name: background
119 Database Class: Background
120 Command-Line Switch: -relief
123 Database Name: relief
124 Database Class: Relief
125 Command-Line Switch: -highlightthickness
128 Database Name: highlightThickness
129 Database Class: HighlightThickness
130 Command-Line Switch: -highlightcolor
133 Database Name: highlightColor
134 Database Class: HighlightColor
135 Command-Line Switch: -highlightbackground
138 Database Name: highlightBackground
139 Database Class: HighlightBackground
140 Command-Line Switch: -selectbackground
143 Database Name: selectBackground
144 Database Class: Background
145 Command-Line Switch: -selectforeground
148 Database Name: selectForeground
149 Database Class: Foreground
150 Command-Line Switch: -selectborderwidth
153 Database Name: selectBorderWidth
154 Database Class: BorderWidth
155 Command-Line Switch: -disabledbackground
158 Database Name: disabledBackground
159 Database Class: DisabledBackground
160 Command-Line Switch: -disabledforeground
163 Database Name: disabledForeground
164 Database Class: DisabledForeground
165 Command-Line Switch: -readonlybackground
168 Database Name: readonlyBackground
169 Database Class: ReadonlyBackground
170 Command-Line Switch: -insertbackground
173 Database Name: insertBackground
174 Database Class: Background
175 Standard widget options. See options for a description of their
178 meanings and values.
179
181 entry, ip address
182ipentry 0.3 ipentry(n)