9.3.1 BitmapShow (draw a bitmap)

Purpose

Draws a bitmap.

Syntax

BitmapShow(BmpFileName, [xPos] [, yPos])

Arguments

BmpFileName: Specify the full path of the bitmap file as a character string or as a variable that stores this value.
xPos: Specify the horizontal distance from the left side of the screen to the left edge of the window in which the bitmap will be displayed. Specify the distance in pixels, where the left side of the screen is 0, or write a variable that stores this value. If you omit this argument, the window is centered horizontally on the screen. If you specify a negative value, zero is assumed.
yPos: Specify the vertical distance from the top of the screen to the top of the window in which the bitmap will be displayed. Specify the distance in pixels, where the top of the screen is 0, or write a variable that stores this value. If you omit this argument, the window is centered vertically on the screen. If you specify a negative value, zero is assumed.

Description

The BitmapShow command draws a specified bitmap. The command returns True on successful execution, or False if an error occurs.

To erase the bitmap, use the BitmapHide command.

Notes

Do not use this command in a script started as a service; otherwise, an execution error will occur.
Take care when specifying a bitmap file in the folder set in the ProgramFiles environment variable (normally the Program Files folder on the system drive) or WinDir (normally the Windows folder on the system drive). For details, see 1.8.2 Command behavior.

Example

bmpFile = _WIN_+"ABC.BMP"
BitmapShow(bmpFile, 100, 100)
Sleep(10000)
BitmapHide(bmpFile)

JP1/Script version

Supported from JP1/Script 05-00.