Bits Property

Applies To: Bitmap, Clipboard, Cursor, Icon

Description

This property defines the pattern in a Bitmap, Cursor, or Icon object, or the pattern of a bitmap stored in the Windows clipboard.

For a Bitmap, Clipboard or Icon, Bits is an integer matrix each of whose elements represents the colour of the corresponding pixel in the bitmap. The colours are specified as 0-origin indices into the CMap property, which itself defines the complete set of different colours (the colour map) used by the object.

Please note that Bits and CMap may only be used to represent an image with a colour palette of 256 colours or less. If the colour palette is larger, the values of Bits and CMap reported by ⎕WG will be (0 0). For a high-colour image, use CBits instead.

For a Cursor, Bits is a Boolean matrix which specifies the shape of the cursor. For a Cursor and Icon, Bits is used in conjunction with the Mask property.

See CMap for further details.