URLSOURCE Property

The URLSOURCE property defines a URL for a web resource used for a ICON, IMAGELIST or PICT object being presented by a PL/B Web Server client. The property uses the following format:

URLSOURCE={value}

Note the following:

1. URLSOURCE may be used in CREATE, GETPROP, or SETPROP statements or ICON, PICT, IMAGELIST, or BUTTON objects

2. {value} is a literal or string variable defining the text to be shown.

3. The web resource can be a .gif, .jpg, or .png file specified by the URL.

4. The image specified by the URLSOURCE property is downloaded without change to the client browser.

5. The rendering of images is controlled by the client browser. Some images may not be displayed by all browser types. The PL/B runtime cannot force a client browser to display an image.

6. When the '!' character is used as the leading character in the URLSOURCE property string value, the Web application files are retrieved from the 'local application area' on the mobile device when using the 'plbwebcli' App. A leading '!' character for other client browsers is ignored.

7. The format of the URLSOURCE {value} string should be a valid URL format as described by 'RFC 1738 Uniform Resource Locator'. Otherwise, unexpected results can occur because of different client browser processing of a poorly formatted URL.

Example:

P      PICT

      CREATE P=5:10:5:15,"",URLSOURCE="images/sunbelt.png"

 

In this case, the PL/B Web Server uses the URLSOURCE to download the image resource. The 'sunbelt.png' is located in the 'c:\Sunbelt\plbwebsrv.97\http_root\images' directory on the system where the PL/B Web Server is executing.

 

The URLSOURCE can reference any valid URL or Web Address with the image to be accessed\downloaded as the resource. As an example the following Sunbelt Web URL can be used:

 

URLSOURCE="http://www.sunbelt-plb.com/images/logo8.gif"

 

 

See Also: Object Properties, Object IO Instructions, Object Definitions