Oracle9iAS Portal Developer Kit

get_image_path function

Contained in package wwctx_api.

Call this function to return the path to an image file. If no image file name is provided, this function returns the path to the directory where the images are.

Notes:

  • An images directory, installed during Oracle Portal installation, resides on a file system accessible from Oracle Portal listener. Within Oracle Portal, this directory is referred to by a virtual path. The get_image_path function returns this path to the calling procedure.

  • If the location of an image is unknown, but a portlet should display that image, then a call similar to wwctx_api.get_image_path('hello.gif') returns the qualified path: /images/hello.gif.
  • Alternatively, calling wwctx_api.get_image_path without an argument would return the virtual path: /images/.

function get_image_path

(

p_filename in varchar2 default null

)

return varchar2;

Version: Oracle Portal 3.0.6.6.5 or later

Parameters:

p_filename

The name of the image file to which a path is required.

Datatype: in varchar2
Default: null

Returns:

This function returns the path to the specified image directory or file.

Exceptions:

This function raises no user-defined exceptions.

Example:

l_image varchar2(200);
l_image := wwctx_api.get_image_path
(

p_filename => 'DIVISION_LOGO'

);

Notes

  • A Listener receives client requests on a specified port and responds by returning content to the client browser.

Related topics

The PL/SQL API Reference is part of the Portal Developer Kit on Portal Studio