PEXChangeNameSet - Change Name Set (5.0)


Synopsis

     void PEXChangeNameSet(
             Display *display,
             PEXNameSet nameset,
             int action,
             unsigned long count,
             PEXName *names
        )

Arguments

display
A pointer to a display structure returned by a successful XOpenDisplay call.
nameset
The resource identifier of the name set.
action
Type of change to be made (PEXNSAdd, PEXNSRemove or PEXNSReplace).
count
The number of names.
names
An array of names.

Returns

None.

Description

Invoke PEXChangeNameSet to modify the specified name set resource.

PEXlib supports the following values for action:

PEXNSAdd
adds the list of names to the name set.
PEXNSRemove
removes the specified name from the name set.
PEXNSReplace
replaces the names currently in the name set.

If you request to remove a name that does not exist, then this function is silently ignored.

Errors

BadPEXNameSet
The specified name set resource identifier is invalid.
BadValue
The specified value for action argument is invalid.

See Also

For an overview, see Name Set.