PEXChangeSearchContext5_2 - Change Search Context (5.0)

Synopsis 

     void PEXChangeSearchContext5_2(
             Display *display,
             PEXSearchContext context,
             unsigned long value_mask,
             PEXSCAttributes5_2 *values
        )

     void PEXChangeSearchContext(
             Display *display,
             PEXSearchContext context,
             unsigned long value_mask,
             PEXSCAttributes *values
        )

Arguments

display
A pointer to a display structure returned by a successful XOpenDisplay call.

context
The resource identifier of the search context.

value_mask
A mask indicating the search context attributes to be changed.

values
A pointer to new values for the specified search context attributes.

Returns

None.

Description

Invoke PEXChangeSearchContext5_2 to modify the attributes of the specified search context resource.

You must use the 5.2 form of the function unless all aspects of the components you wish to change were defined in PEX 5.0 or 5.1. Note that each of the two forms uses a different structure for the values parameter.

The value mask indicates which values are specified. The value mask is constructed by or'ing together the following constants:

All attributes are supported beginning with PEX 5.0, except PEXSCTextFontTable, which is supported beginning with PEX 5.2.

Errors

BadPEXLookupTable
The specified text font lookup table is invalid.

BadPEXNameSet
The specified name set resource identifier is invalid.

BadPEXPath
The specified path is invalid.

BadPEXSearchContext
The specified search context resource identifier is invalid.

BadValue
A specified value is out of range, or an invalid bit is set in the value mask.

See Also

For an overview and a list of Spatial Search functions, see Spatial Searches.