Method Image()


 

Syntax

:Image( cImage, [cAltText], [nBorder], [cAlign], [nWidth], [nHeight], [lBR], [lWrite])

 

 

Parameters

 

 

cImage

File name. The URL to the Image file. The image path must be accessible to the User's browser. The image file will be requested by the browser after the aCGI Application completes so the file should be a relative path with the Web Site structure or a complete URL.

 

cAltText

Text to display if the file is missing or when the User moves the mouse over the image. Default is the file name.

 

nBorder

Border size, in Pixels. Default is 0

 

cAlign

Image alignment on the page. possible values: bottom, middle, top, left or right

 

nWidth

Width of the image. Determines how wide to display image regardless of actual image size.

 

nHeight

Height of the image. Determines how high to display image regardless of actual image size.

 

lBR

Logical indicating whether to append a <BR> (Web newline) to Display elements

 

lWrite

Logical indicating whether to send results directly to the User's Browser

 

 

Return

If :lWrite, Number of characters written to Browser.

Otherwise, the results is the completed <IMG ... > Tag.

 

Description

Creates an <IMG ... > tag and configures it based on the parameters passed.

The image file needs to be accessible from the User's location. Meaning available in the Internet or Intranet, depending on the application. An absolute file drive and path will not work.

 

See Also:

:SendFile()

 



Contents