PEXChangeSearchContext(3) — Subroutines

Name

PEXChangeSearchContext - Change Search Context

Synopsis

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

Arguments

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

contextThe resource identifier of the search context.

value_maskA mask indicating the search context attributes to be changed.

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

Returns

None

Description

This function modifies the attributes of the specified search context resource. The value mask indicates which values are specified. The value mask is constructed by or’ing together the following constants:

PEXSCPosition
PEXSCDistance
PEXSCCeiling
PEXSCModelClipFlag
PEXSCStartPath
PEXSCNormalList
PEXSCInvertedList

Data Structures

typedef XID             PEXSearchContext;
typedef struct {
    PEXCoord            position;
    float               distance;
    unsigned short      ceiling;
    Bool                model_clip_flag;
    PEXStructurePath    start_path;
    PEXListOfNameSetPair normal;
    PEXListOfNameSetPair inverted;
} PEXSCAttributes;
typedef struct {
    float               x;
    float               y;
    float               z;
} PEXCoord;
typedef struct {
    unsigned long       count;
    PEXElementRef       ∗elements;
} PEXStructurePath;
typedef struct {
    PEXStructure        structure;
    unsigned long       offset;
} PEXElementRef;
typedef XID             PEXStructure;
typedef struct {
    unsigned short      count;
    PEXNameSetPair      ∗pairs;
} PEXListOfNameSetPair;
typedef struct {
    PEXNameSet          inclusion;
    PEXNameSet          exclusion;
} PEXNameSetPair;
typedef XID             PEXNameSet;

Errors

BadPEXNameSet
The specified name set resource identifier is invalid.

BadPEXPathThe specified path is invalid.

BadPEXSearchContext
The specified search context resource identifier is invalid.

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

Museum