Important: The information in this document is obsolete and should not be used for new development.
PlotIconHandle
You can use thePlotIconHandle
function to plot an icon of resource type'ICON'
or'ICN#'
. You must have previously obtained a handle to the icon usingGetIcon
(orGetResource
or other Resource Manager routines).
FUNCTION PlotIconHandle (theRect: Rect; align: IconAlignmentType; transform: IconTransformType; theIcon: 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
PlotIcon
Handle should align the icon within the rectangle. See the description ofPlotIconID
on page 5-20 for a list of constants you can use in this parameter.transform
- A value that specifies how
PlotIcon
Handle should modify the appearance of the icon. See the description ofPlotIconID
beginning on page 5-20 for a list of constants you can use in this parameter.theIcon
- A handle to the icon to draw.
DESCRIPTION
ThePlotIcon
Handle function draws the icon specified by thetheIcon
parameter with the transform and alignment specified by thetransform
andalign
parameters.
- IMPORTANT
- To plot an icon from an icon suite, you should normally use
PlotIconSuite
. ThePlotIconHandle
function may not draw the icon correctly if you pass it the handle returned in thetheIconData
parameter ofGetIconFromSuite
.RESULT CODES
noErr 0 No error noMaskFoundErr -1000 No mask found SEE ALSO
For an example of the use of thePlotIconHandle
function, see Listing 5-6 on page 5-15. For information onGetIcon
, see page 5-28.