ReplaceBmp Method (IMAGELIST)
PLBCMP GUI Only
The ReplaceBmp method exchanges an image in an IMAGELIST object with an image from a bitmap. The method uses the following format:
|
|
|
|
|
|
|
|
Where:
label
Optional. A Program Execution Label.
object
Required. An IMAGELIST object in which an image is replaced.
return
Optional. A Numeric Variable that indicates the success or failure of the method.
index
Required. A decimal number or Numeric Variable that indicates the zero-based image to replace.
bmp
Required. A Character String Variable or Numeric Variable that specifies the file name or resource number of the new image.
mask
Optional. A Character String Variable or Numeric Variable that specifies the file name or resource number of the image mask.
Flags Affected: EOS, OVER, ZERO
Note the following:
Upon completion, {return} will contain the status of the method as follows. $TRUE and $FALSE are defined in PLBEQU.INC.
|
Value |
Constant |
The replacement ... |
|
0 |
$FALSE |
failed. |
|
1 |
$TRUE |
was successful. |
If the value returned is zero, the ZERO Condition Flag is set.
The OVER and EOS Condition Flags are always cleared.
For improved performance in the Application Server environment, do not specify the optional return value unless needed.
This method is not supported by the PL/B Web Server.
See Also: Method Syntax, IMAGELIST Methods
|
|