PEXCreateSearchContext5_2 - Create Search Context (5.0)

Synopsis 

  PEXSearchContext PEXCreateSearchContext5_2(
       Display *display,
       unsigned long value_mask,
       PEXSCAttributes5_2 *values
  )


  PEXSearchContext PEXCreateSearchContext(
       Display *display,
       unsigned long value_mask,
       PEXSCAttributes *values
  )

Arguments

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

value_mask
A mask indicating the attributes specified.

values
A pointer to values used to override default values in the new search context resource.

Returns

The resource identifier of the newly-created search context resource.

Description

Invoke PEXCreateSearchContext5_2 to create a search context and get the resource identifier of the created search context resource.

You must use the 5.2 form of the function unless all aspects of the components you wish to supply 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 to override the default values. 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

BadAlloc
The implementation failed to allocate the resource.

BadPEXLookupTable
The specified text font lookup table is invalid.

BadPEXNameSet
The specified name set resource identifier is invalid.

BadPEXPath
The specified path 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.