Programming with Reflection

image\rwnprg32.gif RestoreTextColors property



object.RestoreTextColors = Value

Works with


Data type




Returns (first syntax line) or specifies (second syntax line) whether Reflection restores text colors after ReGIS graphics have been drawn.

When this property is set to True, colors are temporarily saved by Reflection when all three of the following events occur:

· Reflection is placed into ReGIS mode by a graphics application.

· The application changes your colors.

· A ReGIS or sixel image is drawn on the screen.

Text colors are then restored when either of the following occurs:

· The entire screen is cleared (with the sequence image\csi.gif H, image\csi.gif J, or image\csi.gif 2J).

· The application exits ReGIS mode and the entire image scrolls off the screen (for example, as the result of a series of image\lf.gif characters).

This behavior differs from an actual terminal, where your original colors are never restored when changed by a graphics application.

If colors were changed in ReGIS but no graphics were drawn, the original colors are not restored. This preserves the intent of some text applications that use ReGIS to change screen colors.


The default value is False.


image\jump.gif Keyword Index

image\popup.gif Related Topics

image\popup.gif Reflection products that use this property