Legacy Document

Inside Macintosh: QuickDraw GX Environment and Utilities /

Chapter 4 - QuickDraw GX Debugging / QuickDraw GX Debugging Reference

Functions / Setting and Getting Validation Options and Errors

GXSetValidation

You can use the GXSetValidation function to control the type and level of validation checking.

void GXSetValidation(gxValidationLevel);

gxValidationLevel

The validation flags.

DESCRIPTION

The GXSetValidation function allows you to set the validation mode, as well as the validation levels, for type, structure, all object, and memory block validation options. You may pick one mode, one level, and any combination of memory options. The options are defined by the gxValidationLevel enumeration.

The GXSetValidation function turns validation on when you select any flags other than 0x00. If you set the gxValidationLevel flag to gxNoAttributes, validation is off.

This function has no effect in the non-debugging version of QuickDraw GX.

As an alternative to the use of the GXSetValidation function with the internal and all object validation flags set, you can use the GXValidateAll function.

SEE ALSO

To get the current gxValidationLevel parameter, use the GXGetValidation function, described on page 4-35.

The gxValidationLevel enumeration is described in the section "Validation Levels" beginning on page 4-31.

Table 4-8 on page 4-16 lists the public and internal validation options.

Table 4-9 on page 4-16 lists the type, structure, and all object validation options.

Table 4-10 on page 4-19 lists the memory validation options.

The GXValidateAll function is described on page 4-43.