Correlating Retained Graphics

The information in a retained graphic segment can be redrawn; therefore, setting up an environment for correlation is not necessary. Correlation on retained segments is processed through segment IDs and tags throughout the segments.

For any retained segment to be a candidate for correlation, the following must be done:

• Call GpiOpenSegment with a unique, nonzero identifier.

• Call GpiSetSegmentAttrs with the following settings:

  a.

  ATTR_DETECTABLE switched ON
  b.
  ATTR_DYNAMIC left OFF (default), unless the segment is unchained and, therefore, drawn non-dynamically
  c.
  ATTR_PROP_DETECTABLE left ON (default), in any segment that calls the candidate segment
  3.
  Call GpiSetTag at appropriate locations within the segment.

  Note: The preceding is the recommended method. However, an application still can receive correlation data about invisible segments.

  ---

  [Back: Correlating Nonretained Graphics]
  [Next: Tagging Primitives within a Segment]