SET-TICKS Action

This document covers the following topics:


Description

Sets manual tick marks for a slider control.

This action cannot be used if the control has the "Auto ticks (a)" STYLE, since the tick marks are added automatically in this case.

Note that it does not make sense to add tick marks at the beginning or end of the slider's range, since these tick marks are automatically created by the control.

Tick marks are only shown if the control has either (or both) of the "Side 1 ticks (1)" or "Side 2 ticks (2)" STYLE flags set.

To clear the manually-added tick marks, use the CLEAR-TICKS action.

Parameters

Name/Data Type Explanation
HANDLE OF SLIDER Input

Handle of slider to which the tick marks are to be applied.

Ticks (List of I4) Input

Tick position(s) to set. Can be a scalar or an array index range (see example below). This parameter may be repeated, allowing any combination of scalars and array index ranges.

Response (I4) Output

Natural error (if applicable).

Example:

 
DEFINE DATA LOCAL
1 #TICKS (I4/3) CONST <3, 5, 7>
END-DEFINE
*
/* The following three calls have the same effect:
PROCESS GUI ACTION SET-TICKS WITH #SLIDER-1
  #TICKS(1) #TICKS(2) #TICKS(3) GIVING *ERROR
*
PROCESS GUI ACTION SET-TICKS WITH #SLIDER-1
  #TICKS(*) GIVING *ERROR
*
PROCESS GUI ACTION SET-TICKS WITH #SLIDER-1
  3 #TICKS(2:3) GIVING *ERROR