Tutorial

Getting Started with Macros

Macro Editor

User Interface

Menus and Toolbar

Editing Macros

Macro Debugging

How To

Using variables

Finding and modifying objects

Creating new page content

Copying and moving objects

Asking for user input

Storing persistent data

Using binary data

Sorting objects

Macro menus

Bulleted and numbered lists

Accessing the file system

Accessing the clipboard

Sample Macros

Concepts

Code Structure

Expressions

Objects

Properties

Variables

Data Types

Arrays

Functions

Literals

Operators

Comments

Last updated on: May 01, 2026
Also available as a single HTML file

Onetastic Macro Documentation > Functions > Dialog Box Functions > DialogBox_AddImage

DialogBox_AddImage

Adds an image control to a dialog box.

Syntax

void DialogBox_AddImage(
	DialogBox dialogBox, 
	String label, 
	String name, 
	Binary data, 
	Bool scaleToFit)

Parameters

DialogBox dialogBox
The dialog box to add the image to.
String label
A label for the image (unused, reserved for future use).
String name
Name of the image control.
Binary data
The image data as a Binary value (e.g. loaded from a file with FileSystem_ReadFromFile or from a binary store with BinaryStore_Read).
Bool scaleToFit (optional)
If true (default), images larger than the dialog width will be scaled down proportionally. If false, the image is always displayed at its original size. In both cases, smaller images are never scaled up.

Reference

Statements

Hierarchy Objects

Page Objects

Other Objects

Functions

Array Functions

Clipboard Functions

Data Store Functions

Data Type Specific Functions

Date/Time Functions

Dialog Box Functions

File System Functions

Macro Execution Functions

Macro Menu Functions

Object Functions

Special Functions

String Functions

Window Functions