Skip Headers
Oracle® Database PL/SQL Packages and Types Reference
11g Release 1 (11.1)

Part Number B28419-01
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Master Index
Master Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
View PDF

174 OWA_IMAGE

The OWA_IMAGE package provides an interface to access the coordinates where a user clicked on an image.

See Also:

For more information about implementation of this package:

The chapter contains the following topics:


Using OWA_IMAGE


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

Table 174-1 OWA_IMAGE Package Subprograms

Subprogram Description
GET_X Function
Gets the X value of a point type
GET_Y Function
Gets the Y value of a point type


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

Table 174-2 GET_X Procedure Parameters

Parameter Description
p The point where the user clicked.

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

Table 174-3 GET_Y Procedure Parameters

Parameter Description
p The point where the user clicked.

Return Values

The Y coordinate as an integer.