1ipentry(n)                An IP address entry widget                ipentry(n)
2
3
4
5______________________________________________________________________________
6

NAME

8       ipentry - An IP address entry widget
9

SYNOPSIS

11       package require Tcl  8.4
12
13       package require Tk  8.4
14
15       package require ipentry  ?0.3?
16
17       ::ipentry::ipentry pathName ?option value...?
18
19       ::ipentry::ipentry6 pathName ?option value...?
20
21       pathName complete
22
23       pathName get
24
25       pathName insert iplist
26
27       pathName icursor index
28
29       pathName configure option value...
30
31       pathName cget option
32
33_________________________________________________________________
34

DESCRIPTION

36       This package provides a widget for the entering of a IP address.
37
38       ::ipentry::ipentry pathName ?option value...?
39              Creates  a  new  IPv4  ipentry widget and configures it with the
40              given options and their values.
41
42       ::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
46       Each widget created with the command above supports the following meth‐
47       ods:
48
49       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
55       pathName get
56              Returns the contents of the entry as a list consisting of 4 or 8
57              elements.
58
59       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
67       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
73       pathName configure option value...
74              Modifies the configuration of the widget. For options and  their
75              meaning see the widget options section.
76
77       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

WIDGET OPTIONS

83       Command-Line Switch:    -textvariable
84       Database Name:          textvariable
85       Database Class:         Variable
86
87
88              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
94       Command-Line Switch:    -state
95       Database Name:          state
96       Database Class:         State
97
98
99              Specifies  one  of three states for the entry: normal, disabled,
100              or readonly.
101
102       Command-Line Switch:    -font
103       Database Name:          font
104       Database Class:         Font
105
106
107       Command-Line Switch:    -bd
108       Database Name:          borderWidth
109       Database Class:         BorderWidth
110
111
112       Command-Line Switch:    -fg
113       Database Name:          foreground
114       Database Class:         Foreground
115
116
117       Command-Line Switch:    -bg
118       Database Name:          background
119       Database Class:         Background
120
121
122       Command-Line Switch:    -relief
123       Database Name:          relief
124       Database Class:         Relief
125
126
127       Command-Line Switch:    -highlightthickness
128       Database Name:          highlightThickness
129       Database Class:         HighlightThickness
130
131
132       Command-Line Switch:    -highlightcolor
133       Database Name:          highlightColor
134       Database Class:         HighlightColor
135
136
137       Command-Line Switch:    -highlightbackground
138       Database Name:          highlightBackground
139       Database Class:         HighlightBackground
140
141
142       Command-Line Switch:    -selectbackground
143       Database Name:          selectBackground
144       Database Class:         Background
145
146
147       Command-Line Switch:    -selectforeground
148       Database Name:          selectForeground
149       Database Class:         Foreground
150
151
152       Command-Line Switch:    -selectborderwidth
153       Database Name:          selectBorderWidth
154       Database Class:         BorderWidth
155
156
157       Command-Line Switch:    -disabledbackground
158       Database Name:          disabledBackground
159       Database Class:         DisabledBackground
160
161
162       Command-Line Switch:    -disabledforeground
163       Database Name:          disabledForeground
164       Database Class:         DisabledForeground
165
166
167       Command-Line Switch:    -readonlybackground
168       Database Name:          readonlyBackground
169       Database Class:         ReadonlyBackground
170
171
172       Command-Line Switch:    -insertbackground
173       Database Name:          insertBackground
174       Database Class:         Background
175
176
177              Standard widget options. See options for a description of  their
178              meanings and values.
179

KEYWORDS

181       entry, ip address
182
183
184
185ipentry                               0.3                           ipentry(n)
Impressum