GenValue: 4.5 Supplemental Usage: Text Filters for the GenValue

Up: GEOS SDK TechDocs | Up | Prev: 4.4 Using Value Ratios | Next: 4.6 Using Ranges in GenValues
MSG_GEN_VALUE_GET_TEXT_FILTER

One of the GenValue's components is a text field to enter values into. When this visual component is being built, the GenValue will send MSG_GEN_VALUE_GET_TEXT_FILTER to itself to set up a text filter. A text filter allows a textual object to accept or reject certain characters on a number of bases. The default VisTextFilter provides numeric-only filtering with no spaces and no tabs on GVDF_INTEGER or GVDF_DECIMAL display formats; no tabs on distance unit display formats.

You may set up your own filter by intercepting this message and returning a VisTextFilter of your own choosing.

MSG_GEN_VALUE_GET_TEXT_FILTER

VisTextFilter MSG_GEN_VALUE_GET_TEXT_FILTER();

This message retrieves the text filtering in use on a GenValue object. By default, GenValues use numeric-only filtering with no spaces and no tabs for numbers and a filtering of no tabs for distance units.

Source: Unrestricted. This message is normally sent by a GenValue to itself when building its textual component.

Destination: Any GenValue object.

Parameters: None.

Return: VisTextFilter in use by the textual portion of the GenValue.

Interception: Usually, you will want to intercept this message if you subclass GenValueClass and provide your own custom filtering.


Up: GEOS SDK TechDocs | Up | Prev: 4.4 Using Value Ratios | Next: 4.6 Using Ranges in GenValues