PEXGetPickMeasure - Get Pick Measure Attributes

Synopsis

 
  PEXPMAttributes *PEXGetPickMeasure(
        Display *display,
        PEXPickMeasure pick_measure,
        unsigned long value_mask
  )
 

Arguments

display

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

pick_measure

The resource identifier of the pick measure.

value_mask

A mask indicating which attributes to return.

Returns

A pointer to the pick measure attribute values; a null pointer if unsuccessful.

Description

Invoke PEXGetPickMeasure to get the attribute values of the specified pick measure.

Use the value mask to indicate which attributes are to be returned. The value mask is constructed by or'ing together the following constants:

• PEXPMStatus
• PEXPMPath

PEXlib allocates memory for the return value. Invoke PEXFreePMAttributes to deallocate the memory.

Errors

BadPEXPickMeasure

The specified pick measure resource identifier is invalid.

BadValue

An invalid bit is set in the value mask.

See Also

• PEXCreatePickMeasure

For a list of all PHIGS Workstation Picking functions and related topics, see PHIGS Workstation Picking.