_HIGHLIGHT_GRP.GRS

  PROC/GRP,HCOLOR,HFONT,HLSW,SAVESW,DIAGLV,SRESP
$$
$$ SUBROUTINE: _HIGHLIGHT_GRP.GRS
$$
$$ KEYWORDS:
$$   UTILITY
$$
$$ ABSTRACT:
$$   THIS SUBROUTINE "HIGHLIGHTS" A SELECTED GROUP BY
$$   CHANGING IT'S MEMBER'S COLORS AND/OR FONT TO SPECIFIED VALUES.
$$.
$$   AN EXAMPLE OF THIS CALL WOULD BE:
$$     CALL/'_HIGHLIGHT_GRP',GRP1,&RED,&DASHED,&YES
$$.
$$   TO RESTORE THE SAME ENTITY TO IT'S ORIGINAL FONT & COLOR,
$$   CALL IT A SECOND TIME WITH A SWITCH OF &NO:
$$     CALL/'_HIGHLIGHT_GRP',GRP1,0,0,&NO
$$.
$$   IT USES ATTRIBUTES "HL_COLOR", "HL_FONT" TO SAVE AND
$$   RESTORE THE ORIGINAL COLOR/FONT/DENSITY. IF THESE
$$   ATTRIBUTES ARE DELETED, THE RESTORE WILL DO NOTHING.
$$.
$$   IT DELETES THESE VALUES AFTER HIGHLIGHTING, AND PRESERVES
$$   THEM DURING A HIGHLIGHT. (THIS WILL "REMEMBER" THE
$$   ORIGINAL VALUES EVEN IF AN ENTITY IS HIGHLIGHTED MORE THAN
$$   ONCE.
$$.
$$   GRP    - ENTITY TO HIGHLIGHT
$$   HCOLOR - HIGHLIGHT COLOR (0=DON'T CHANGE COLOR)
$$   HFONT  - HIGHLIGHT FONT (0=DON'T CHANGE FONT)
$$   HLSW   - HIGHLIGHT SWITCH (&YES - HIGHLIGHT,
$$            &NO - UNHIGHLIGHT).
$$   SAVESW - SAVE THE COLORS & FONTS OF ALL ENTITIES.
$$            (IF SET TO &NO, THEN ONLY THE COLOR, FONT, ETC
$$            OF THE FIRST ENTITY IS SAVED).
$$.
$$   INTELLIGENT OPERATION:
$$     THE COLOR OF THE FIRST ENTITY IS SAVED AS AN ATTRIBUTE OF THE
$$     GROUP, AND CHECKED AGAINST ALL OTHER ENTITIES IN THE GROUP.
$$     IF ALL THE ENTITIES ARE THE SAME COLOR, & FONT, THEN
$$     SAVESW HAS NO EFFECT, AND THE ROUTINE RUNS FASTER.
$$.
$$     ON RESTORE, SAVESW IS IGNORED, AND ANY "LOCAL" ATTRIBUTES
$$     (ASSIGNED TO AN ENTITY WITHIN A GROUP) OVERRIDE THE
$$     GROUP ATTRIBUTES FOR THAT COLOR).
$$
$$ RELEASE HISTORY:
$$   12-DEC-91 INITIAL DESIGN, TESTING
$$   10-AUG-92 ATTRIBUTE CONTROL ADDED
$$   14-AUG-92 BUGS FIXED
$$   27-APR-93 MODIFIED TO HANDLE GROUPS
$$   10-JUN-1997 Initial submission to GRIP International Library
$$   13-OCT-2001 Contact Information Updated!
$$
$$ Called by:
$$   (A Utility Subroutine)
$$
$$ AUTHOR:  Greg Krumrey, Information Manager
$$ COMPANY: Patriot Machine, Inc.
$$          951 Harmsted Court
$$          St. Charles, MO 63301
$$          greg.krumrey@patriot-machine.com
$$          636-940-1776 x 130
$$
$$ SYSTEM TYPE: This program is Machine-Independant.
$$
$$ THEORY/VARIABLE USAGE:
$$