The Application Object: 2.4 Advanced GenApplication Usage: Measurement Type

Up: GEOS SDK TechDocs | Up | Prev: 2.3 The GenApplication's Moniker | Next: 2.5 Interaction with the UI
MSG_GEN_APPLICATION_SET_MEASUREMENT_TYPE, MSG_GEN_APPLICATION_GET_MEASUREMENT_TYPE, GET_APP_MEASUREMENT_TYPE

Each application has a "measurement type" associated with it. The measurement type indicates whether measurements should default to metric or standard US measurements.

MSG_GEN_APPLICATION_SET_MEASUREMENT_TYPE

void	MSG_GEN_APPLICATION_SET_MEASUREMENT_TYPE(
        byte	measurementType);

This message sets the measurement type used by the application.

Source: Infrequently used.

Destination: The GenApplication to have the new measurement type.

Parameters: measurementType
A value of AppMeasurementType to set for the application. Can be AMT_US, AMT_METRIC, or AMT_DEFAULT.

Return: Nothing.

Interception: Do not intercept.

MSG_GEN_APPLICATION_GET_MEASUREMENT_TYPE

word	MSG_GEN_APPLICATION_GET_MEASUREMENT_TYPE();

This message gets the measurement currently used by the application.

Source: Infrequently used.

Destination: The GenApplication whose measurement is to be retrieved.

Parameters: None.

Return: A word value, the low byte of which represents the application's measurement type. Use the macro GET_MEASUREMENT_TYPE to extract the measurement type from the return value.

Interception: Do not intercept.


Up: GEOS SDK TechDocs | Up | Prev: 2.3 The GenApplication's Moniker | Next: 2.5 Interaction with the UI