GSHLIT

GDDM-GKS V1R1 Programming Guide and Reference

GSHLIT

GDDM-GKS V1R1 Programming Guide and Reference
SC33-0334-00

Purpose


GSHLIT	(sgna,hil)
APL code	1367
GKS RCP code	'38004200'X (939540992)

Function: Segment function. Marks a segment for normal or highlighted display.

Parameters

sgna (specified by user) (fullword integer)
The segment name

hil (specified by user) (fullword integer)
The highlighting value. The possible values are:

0 (GNORML)

Normal

1 (GHILIT)

Highlight

Operating states

WSOP, WSAC, SGOP

Related functions

Create segment (GCRSG), Inquire segment attributes (GQSGA)

Description

This function marks a segment to be drawn with or without highlighting. The highlighting attribute in the segment state list for the segment sgna is set to the value given by hil.

If the segment is marked as highlighted and visible, the primitives in it are highlighted when displayed. (See Set visibility (GSVIS).) Highlighting color is dependent upon the type of workstation: on displays it is white, on printers it is black, and on plotters it takes the color associated with the highest available pen number.

Principal errors


        7  GKS not in proper state: GKS shall be in one of the states
           WSOP, WSAC, or SGOP
      120  Specified segment name is invalid
      122  Specified segment does not exist
     2000  Enumeration type out of range

Notices | Terms of use | Support | Contact z/OS