RgnFrameColor property (Main Control)

Visual Basic example
Visual C++ 4.0 example

Syntax OLE_COLOR RgnFrameColor

Overview: Refer to Creating and Using a Bitmap Region.

Remarks

Color used to highlight a reigion by displaying a filled color representation of the region. This property is only valid when the RgnFrameType property is set to RGNFRAME_COLOR.

This color will be XORed with colors within a region to determine the new colors for displaying the region. The color corresponding to a particular part of the region is determined as follows:

Region Color Displayed = (color of pixel in region) XOR (crRgnColor)

This is particularly useful when displaying regions with black and white images. All black pixels in a region are displayed with color RgnFrameColor, and all white pixels are displayed ~(RgnFrameColor). For example, suppose that RgnFrameColor is light green (BGR 0x80FF40). All black pixels in the region are displayed as RgnFrameColor. All white pixels in the region are displayed as 0xFFFFFF XOR 0x80FF40 = 0x7F00BF, which is purple.