Picture Dialog Item Definition

Syntax:

Picture X, Y, DX, DY, FileName$, Type[, .Field]

Group: User Dialog

Description:
Define a picture item. The bitmap is automatically sized to fit the item's entire area.

Parameter Description

X This number value is the distance from the left edge of the dialog box. It is measured in 1/8 ths of the average character width for the dialog's font.

Y This number value is the distance from the top edge of the dialog box. It is measured in 1/12 ths of the character height for the dialog's font.

DX This number value is the width. It is measured in 1/8 ths of the average character width for the dialog's font.

DY This number value is the height. It is measured in 1/12 ths of the character height for the dialog's font.

FileName$ The value of this string is the .BMP file shown in the picture control.

Type This numeric value indicates the type of bitmap used. See below.

Field This identifier is the name of the field. The dialogfunc receives this name as string. If this identifer is omitted then the first two words of the title are used.

Type

Effect

0

FileName is the name of the bitmap file. If the file does not exist then "(missing picture)" is displayed.

3

The clipboard's bitmap is displayed. Not supported.

+16

Instead of displaying "(missing picture)" a run-time error occurs.

See Also: Begin Dialog, Dim As UserDialog.

Example:

Sub Main
  Begin Dialog UserDialog 200,120
  Picture 10,10,180,75,"SAMPLE.BMP",0
  OKButton 80,90,40,20
  End Dialog
  Dim dlg As UserDialog
  Dialog dlg ' show dialog (wait for ok)
End
Sub