Inside Macintosh: Advanced Color Imaging Reference /

Chapter 5 - Color Manager Reference /

Color Manager Functions / Managing Color Tables

ProtectEntry

Adds protection to or removes protection from an entry in the current GDevice data structure's color table.

pascal void ProtectEntry (
short index, 
Boolean protect);

index

The index to the entry whose protection is to be changed.

protect

A Boolean value: specify true to protect the entry, false to remove protection.

DISCUSSION

The ProtectEntry function adds or removes protection for an entry in the current GDevice data structure's color table, depending on the value of the protect parameter. A protected entry can't be changed by other applications. ProtectEntry returns a protection error in QDErr if you attempt to protect an already protected entry. However, it can remove protection from any entry.