Filename

Description

The file name containing the image for a Picture or Button control in the DataWindow. If no image is specified for a Button control, only text is used for the button label.

Applies to

Picture and Button controls

Syntax

Describe and Modify argument:

"controlname.Filename { = ' filestring ' }"

Parameter

Description

controlname

The name of the Picture or Button control in the DataWindow for which you want to get or set the image file name.

filestring

(exp) A string containing the name of the file that contains the image. Filestring can be a quoted DataWindow expression.

Button pictures can be BMP, GIF, or JPEG files. You can use a URL instead of a full path name, and if you set the HTMLGen.ResourceBase property to the URL address, you need to specify only a relative file name for this string.

If you include the name of the file containing the image in the executable for the application, the DataWindow server will always use that image; you cannot use Modify to change the image.

Usage


In the painter

Select the control and set the value in the Properties window, Appearance category.

Examples

Example 1

Example for a Picture control:

Example 2

[Visual Basic]
setting = dw1.Describe("bitmap_1.Filename")

dw1.Modify("bitmap_1.Filename='exclaim.bmp'")

Example 3

Example for a Button control:

[Visual Basic]
ls_data = dw1.Describe("b_name.FileName")

dw1.Modify("b_name.FileName = 'logo.jpg'")

See also

DefaultPicture