GenValue: 4.1 Supplemental Usage: Adjusting the Value Indirectly

MSG_GEN_VALUE_INCREMENT, MSG_GEN_VALUE_DECREMENT, MSG_GEN_VALUE_SET_VALUE_TO_MINIMUM, MSG_GEN_VALUE_SET_VALUE_TO_MAXIMUM

To increase the value of GVLI_value by the increment in GVLI_increment , send the GenValue MSG_GEN_VALUE_INCREMENT . To decrease the value of GVLI_value by the increment in GVLI_increment , send the GenValue MSG_GEN_VALUE_DECREMENT . These messages are equivalent to clicking on the UI controls provided to increment or decrement the GenValue (usually up and down arrows). Both of these messages clear the indeterminate state of the object and do not change its modified state.

To set the value of GVLI_value to the minimum in GVLI_minimum , send the GenValue MSG_GEN_VALUE_SET_VALUE_TO_MINIMUM . To set the value of GVLI_value to the maximum in GVLI_maximum , send the GenValue MSG_GEN_VALUE_SET_VALUE_TO_MAXIMUM . Both of these messages clear the indeterminate state of the GenValue and do not change its modified state.

Note that HINT_VALUE_NOT_INCREMENTABLE has no effect on these messages; that hint only removes any user controls for incrementing or decrementing a value.

MSG_GEN_VALUE_INCREMENT

void	MSG_GEN_VALUE_INCREMENT();

This message increases the value of GVLI_value within the GenValue by the increment in GVLI_increment . This message will clear the indeterminate flag of the GenValue but will not affect its modified flag.

Source: Unrestricted. This message is also used internally when responding to user actions.

Destination: Any GenValue object.

Parameters: None.

Return: Nothing. GVLI_value will be incremented (or set to the maximum if increasing the value would push it over the maximum).

Interception: Generally not intercepted.

MSG_GEN_VALUE_DECREMENT

void	MSG_GEN_VALUE_DECREMENT();

This message decreases the value of GVLI_value within the GenValue by the increment in GVLI_increment . This message will clear the indeterminate flag of the GenValue but will not affect its modified flag.

Source: Unrestricted. This message is also used internally when responding to user actions.

Destination: Any GenValue object.

Parameters: None.

Return: Nothing. GVLI_value will be decremented (or set to the minimum if decreasing the value would push it below the minimum).

Interception: Generally not intercepted.

MSG_GEN_VALUE_SET_VALUE_TO_MINIMUM

void	MSG_GEN_VALUE_SET_VALUE_TO_MINIMUM();

This message sets the value of GVLI_value to the minimum value in GVLI_minimum . This message will clear the indeterminate flag of the GenValue but will not affect its modified flag.

Source: Unrestricted.

Destination: Any GenValue object.

Parameters: None.

Return: Nothing. GVLI_value will be set to GVLI_minimum .

Interception: Generally not intercepted.

MSG_GEN_VALUE_SET_VALUE_TO_MAXIMUM

void	MSG_GEN_VALUE_SET_VALUE_TO_MAXIMUM();

This message sets the value of GVLI_value to the maximum value in GVLI_maximum . This message will clear the indeterminate flag of the GenValue but will not affect its modified flag.

Source: Unrestricted.

Destination: Any GenValue object.

Parameters: None.

Return: Nothing. GVLI_value will be set to GVLI_maximum .

Interception: Generally not intercepted.

GEOS SDK TechDocs |

4 Supplemental Usage | Next:

4.2 Status Messages