Indicates whether a widget exhibits custom or standard highlight behavior when selected.

Data type: LOGICAL

Access: Readable/Writeable

Applies to: BROWSE widget, BUTTON widget, COMBO-BOX widget, EDITOR widget, FILL-IN widget, FRAME widget, IMAGE widget, LITERAL widget, RADIO-SET widget, RECTANGLE widget, SELECTION-LIST widget, SLIDER widget, TEXT widget, TOGGLE-BOX widget

Set the MANUAL-HIGHLIGHT attribute to TRUE to use a customized highlight design for selection of the widget. A FALSE value for this attribute specifies the ABL default highlight behavior for the selection of the widget.

If you set MANUAL-HIGHLIGHT to TRUE, you must manage the selection behavior of the widget. You do this by adding a trigger on the SELECTION event. When the trigger fires, you can do something to indicate that the widget is selected. For example, you could change its background color. For deselection, you add a trigger on the DESELECTION event and undo whatever you did in the SELECTION trigger. Note that the widget's SELECTABLE attribute must also be set to TRUE for it to be selectable. For more information, see Direct manipulation events.

The following code sample shows how you can change the background color highlight of a widget: 
DEFINE VARIABLE FILL-IN-1 AS CHARACTER FORMAT "X(256)" 
     LABEL "Fill 1" 
     VIEW-AS FILL-IN 
     SIZE 14 BY 1 NO-UNDO.
	 
...	
 
ASSIGN 
       FILL-IN-1:MANUAL-HIGHLIGHT IN FRAME DEFAULT-FRAME = TRUE
       FILL-IN-1:SELECTABLE IN FRAME DEFAULT-FRAME       = TRUE.	   

...

ON SELECTION OF FILL-IN-1 IN FRAME DEFAULT-FRAME
DO:
  fill-in-1:BGCOLOR = 12.
END.

...	 
  
ON DESELECTION OF FILL-IN-1 IN FRAME DEFAULT-FRAME
DO:
  fill-in-1:BGCOLOR = ?.
END.