144 OWA_IMAGE

Using OWA_IMAGE

• Overview

• Types

• Variables

• Examples

Overview

Use this package when you have any image map whose destination links invoke the PL/SQL Gateway.

Types

This data type (point) contain the X and Y values of a coordinate, and so provides the coordinates of a user's click on an imagemap. It is defined as:

TYPE POINT IS TABLE OF VARCHAR2(32767) INDEX BY BINARY_INTEGER

Variables

This package variable (null_point) of TYPE POINT is used to default point parameters. Both the X and the Y fields of this variable are NULL.

Examples

CREATE OR REPLACE PROCEDURE process_image
    (my_img in OWA_IMAGE.POINT)
    AS
    x integer := OWA_IMAGE.GET_X(my_img);
    y integer := OWA_IMAGE.GET_Y(my_img);
BEGIN
    /* process the coordinate */
END

Summary of OWA_IMAGE Subprograms

GET_X Function

This function returns the X coordinate of the point where the user clicked on an image map.

Syntax

OWA_IMAGE.GET_X(
   p        IN        point)
 RETURN INTEGER;

Parameters

Return Values

The X coordinate as an integer.

GET_Y Function

This function returns the Y coordinate of the point where the user clicked on an image map.

Syntax

OWA_IMAGE.GET_Y(
   p        IN        point)
 RETURN INTEGER;

Parameters

Return Values

The Y coordinate as an integer.