Multi-Entry Widgets for IP Addresses

by

Csaba Nemethi

[email protected]

Contents

Start page

The mentry::ipAddrMentry Command

NAME
mentry::ipAddrMentry - Create and manipulate mentry widgets for IP addresses

SYNOPSIS
mentry::ipAddrMentry pathName ?options?
DESCRIPTION
This command creates a new mentry widget pathName for displaying and editing IP addresses in the standard dotted-decimal notation.  The supported options are the same as in the case of the mentry::mentry command.

The command sets the type attribute of the widget to the value "IPAddr" and returns the name of the newly created widget.

DEFAULT BINDINGS
The mentry::ipAddrMentry command defines four new keyboard bindings for the entry children of the mentry widget it creates:  The Up key increments the entry's value by 1 if the latter is less than 255.  Similarly, the Down key decrements the entry's value by 1 if the latter is greater than 0.  The Prior key increments the entry's value by at most 10 if the latter is less than 255.  Similarly, the Next key decrements the entry's value by at most 10 if the latter is greater than 0.  If the entry is empty then all of these keys insert the value 0 into the entry.

The actions performed by the Up and Down keys can also be triggered by rolling the mouse wheel.  In addition, on Mac OS Classic and Mac OS X Aqua, the actions performed by the Prior and Next keys can also be triggered by rolling the mouse wheel while holding down the Option key.

KEYWORDS
mentry, widget, IP address

Contents     Start page

The mentry::putIPAddr Command

NAME
mentry::putIPAddr - Output an IP address to a mentry of type "IPAddr"

SYNOPSIS
mentry::putIPAddr address pathName
DESCRIPTION
This command outputs the IP address address to the mentry widget pathName, which must have been created with the mentry::ipAddrMentry command (this is checked by examining the widget's type attribute, which must have the value "IPAddr").

The command generates an error if the address is invalid.

KEYWORDS
mentry, widget, IP address

Contents     Start page

The mentry::getIPAddr Command

NAME
mentry::getIPAddr - Get an IP address from a mentry of type "IPAddr"

SYNOPSIS
mentry::getIPAddr pathName
DESCRIPTION
This command returns the IP address contained in the mentry widget pathName, which must have been created with the mentry::ipAddrMentry command (this is checked by examining the widget's type attribute, which must have the value "IPAddr").

If any entry child of the widget is empty, the command sets the focus to the first such entry, generates an error, and returns the string "EMPTY".

KEYWORDS
mentry, widget, IP address

Contents     Start page