The Text Objects: 5.1 Using VisText: VisText Features

VTI_features, VisTextFeatures, MSG_VIS_TEXT_SET_FEATURES, MSG_VIS_TEXT_GET_FEATURES

VTI_ features stores a bitfield of VisTextFeatures specifying whether a particular feature is enabled in the Text object. These flags are listed below.

VTF_NO_WORD_WRAPPING: If set, no word-wrapping is allowed. Characters added after the end of the line will start at the next line.
VTF_AUTO_HYPHENATE: If set, the text object will auto-hyphenate words that span a line break.
VTF_ALLOW_SMART_QUOTES: If set, smart quotes will be allowed if they are enabled.
VTF_ALLOW_UNDO: If set, undo operations will be allowed on the text object. (The text object will handle MSG_META_UNDO.)
VTF_SHOW_HIDDEN_TEXT: If set, hidden text will be displayed. This feature is currently not implemented.
VTF_OUTLINE_MODE: If set, text will be shown in outline mode. This feature is currently not implemented.
VTF_DONT_SHOW_SOFT_PAGE_BREAKS: If set, any soft page breaks (i.e. any page breaks that are not C_PAGE_BREAK) will be ignored.
VTF_DONT_SHOW_GRAPHICS: If set, any graphics in the text object will not be displayed.
VTF_TRANSPARENT: If set, the text object will not do a background wash behind the text after it draws.
VTF_USE_50_PCT_TEXT_MASK: If set, the text object will use a 50% draw mask when drawing, regardless of other character attribute runs. This is used by the GenText object to show a disabled state.

MSG_VIS_TEXT_SET_FEATURES

void	MSG_VIS_TEXT_SET_FEATURES(
        VisTextFeatures		bitsToSet,
        VisTextFeatures		bitsToClear);

This message sets a text object's VisTextFeatures (VTI_features ).

Source: Unrestricted.

Destination: Any text object.

Parameters: bitsToSet VisTextFeatures to add.

bitsToClear: VisTextFeatures to remove.

Return: Nothing.

Interception: Generally not intercepted.

MSG_VIS_TEXT_GET_FEATURES

VisTextFeatures MSG_VIS_TEXT_GET_FEATURES();

This message retrieves the text object's VisTextFeatures (VTI_features ).

Source: Unrestricted.

Destination: Any text object.

Parameters: None.

Return: VisTextFeatures in use by the text object.

Interception: Generally not intercepted.

GEOS SDK TechDocs |

5 Using VisText | Next:

5.2 VisText States