bgiCreateBitmapButton

Category: BGI GUI

Syntax:

bgiCreateBitmapButton:Int(bmpFilepath:String, x:Int, y:Int, width:Int, height:Int, parentWin:Int)


Parameters

Returns

Int



Summary

Creates a button showing an image instead of text.

Takes bmpFilepath (String), x (Int), y (Int), width (Int), height (Int) and parentWin (Int). Despite the name, PNG, JPEG, GIF, BMP and TIFF all load. A width or height of 0 sizes the button to the image.

Returns gizmo ID on success, 0 on failure (parent not found or image not loaded).

An image larger than the button is centred and its edges cut off, as on Windows - the button stays the size asked for.

View detailed documentation online



Example

;No example implemented yet


BambooBasic © 2026 Michael Denathorn