SetImageListHot Method (TOOLBAR)


PLBCMP GUI Only

 

The SetImageListHot method associates an IMAGELIST object with the hot images of a TOOLBAR object. The method uses the following format:

 

[label]

{object}.SetImageListHot

[GIVING {return}]:

 

 

USING [*ImageList=]{imagelist}]

 

Where:

label

Optional. A Program Execution Label.

object

Required. A TOOLBAR object that is modified.

return

Optional. A Numeric Variable that indicates the success or failure of the method.

imagelist

Required. An IMAGELIST that contains the images or bitmaps.

Flags Affected: EOS, OVER, ZERO

Note the following:

  1. A standard set of hot bitmaps is associated with the TOOLBAR automatically. They include standard images for most functions.

  2. Hot imaged are displayed when a button is style is $TBStyleToggle and the button is pushed.

  3. Any icons or bitmaps displayed in the {object} are obtained from {imagelist}.

  4. {imagelist} must been previously created.

  5. The images are associated with the object's hot images.

  6. Upon completion, {return} will contain the status of the modification as follows. $TRUE and $FALSE are defined in PLBEQU.INC.

  7.  

    Value

    Constant

    The association ...

    0

    $FALSE

    failed.

    1

    $TRUE

    was successful.

 

  1. If the value returned is zero, the ZERO Condition Flag is set.

  2. The OVER and EOS Condition Flags are always cleared.

  3. For improved performance in the Application Server environment, do not specify the optional return value unless needed.

 

 

See Also: Method Syntax, TOOLBAR Methods

 

 



PL/B Language Reference SetImageListDisabled Method (TOOLBAR) SetTBFlags Method (TOOLBAR)