Inside Macintosh: More Macintosh Toolbox /

Chapter 5 - Icon Utilities / Icon Utilities Reference

Icon Utilities Routines / Drawing Icons From Resources

PlotSICNHandle

You can use the PlotSICNHandle function to plot a small icon of resource type 'SICN' with a specified transform and alignment. You must have previously obtained a handle to the icon using GetResource (or other Resource Manager routines).

FUNCTION PlotSICNHandle (theRect: Rect; align: IconAlignmentType;
                         transform: IconTransformType; 
                         theSICN: Handle): OSErr;

theRect

The rectangle in which to draw the icon, specified in local coordinates of the current graphics port.

align

A value that specifies how PlotSICNHandle should align the icon within the rectangle. See the description of PlotIconID on page 5-20 for a list of constants you can use in this parameter.

transform

A value that specifies how PlotSICNHandle should modify the appearance of the icon. See the description of PlotIconID beginning on page 5-20 for a list of constants you can use in this parameter.

theSICN

A handle to the icon to draw.

DESCRIPTION

The PlotSICNHandle function draws the specified small icon with the transform and alignment specified by the transform and align parameters. Only 'SICN' resources with a single member--or with two members, the second of which is a mask for the first--plot correctly.

RESULT CODES

noErr	0	No error
noMaskFoundErr	-1000	No mask found

SEE ALSO

For an example of the use of the PlotSICNHandle function, see Listing 5-9 on page 5-16.