Try OpenEdge Now
skip to main content
WebClient Applications
Developing the Application : Using URLs in PROPATH for image file downloads : Using the LOAD-IMAGE( ) method
 

Using the LOAD-IMAGE( ) method

This is the syntax of the LOAD-IMAGE( ) method:

Syntax

LOAD-IMAGE ( filename
  [ ,
    x-offset ,
    y-offset ,
    width ,
    height
  ]
)
The LOAD-IMAGE( ) method applies to images and buttons. LOAD-IMAGE( ) reads the image contained in filename. LOAD-IMAGE( ) recognizes PROPATH entries consisting of URLs. If LOAD-IMAGE( ) finds an image in the directory specified by a URL, LOAD-IMAGE( ) downloads the image from the Web server and loads it into local memory directly, bypassing the end user's disk.
If the filename argument is fully qualified (whether URL or local pathname), LOAD-IMAGE( ) loads the image file directly, without searching directories or URLs in PROPATH.
If LOAD-IMAGE() cannot load the specified image file, it returns an error indicating the reason for the failure.
Note: You can also download images over the Web by using the LOAD-IMAGE-DOWN( ), LOAD-IMAGE-UP( ), LOAD-IMAGE-INSENSITIVE( ), and LOAD-ICON( ) methods. This feature is less useful, however, because these methods are generally called for transient graphical-interface events requiring an immediate response, which a Web download might not be able to satisfy.