A script-enabled browser is required for this page to function properly.

SET_VIEW_PROPERTY Built-in

Description

Sets a property for the indicated canvas. You can set only one property per call to the Built-in. In other words, you cannot split the argument in such a way that the x coordinate applies to X_POS and the y coordinate applies to the HEIGHT.

In the following example:

Set_View_Property('STACK',DISPLAY_POSITION,20,30);

Where 'STACK' is the name of the STACK canvas then DISPLAY POSITION sets to 20,30.

Syntax

SET_VIEW_PROPERTY
(view_id ViewPort,
property
NUMBER,
value
NUMBER);

SET_VIEW_PROPERTY
(view_id ViewPort,
property
NUMBER,
x
NUMBER,
y
NUMBER);

SET_VIEW_PROPERTY
(view_name VARCHAR2,
property
NUMBER,
value
NUMBER);

SET_VIEW_PROPERTY
(view_name ViewPort,
property
NUMBER,
x
NUMBER,
y
NUMBER);

Built-in Type unrestricted procedure

Enter Query Mode yes

Parameters

view_id 
 
The unique ID Oracle Forms assigned the view when you created the canvas/view. Use the FIND_VIEW Built-in to return the ID to an appropriately typed variable. Datatype is VIEWPORT.
 
view_name 
 
The name you gave the canvas object when you defined it. Datatype is VARCHAR2.
 
property 
 
Specifies one of the following properties:

DIRECTION The layout direction for bidirectional objects. Valid values are DIRECTION_DEFAULT, RIGHT_TO_LEFT, LEFT_TO_RIGHT.

DISPLAY_POSITION For a stacked view, the position of the view's upper-left corner relative to the window's content view, as an X, Y pair. Determines where the view is displayed in the window.

HEIGHT For a stacked canvas, the height of the view. To change the size of the canvas itself, use SET_CANVAS_PROPERTY.

POSITION_ON_CANVAS An X, Y pair indicating the location of the view's upper-left corner relative to its canvas.

VIEWPORT_X_POS For a stacked view, the X coordinate for the view's upper-left corner relative to the window's content view.

VIEWPORT_Y_POS For a stacked view, the Y coordinate for the view's upper-left corner relative to the window's content view.

VIEWPORT_X_POS_ON_CANVAS The X coordinate for the view's upper-left corner relative to its canvas.

VIEWPORT_Y_POS_ON_CANVAS The Y coordinate for the the view's upper-left corner relative to its canvas.

VIEWPORT HEIGHT, VIEWPORT WIDTH For a stacked canvas, the size of the view, as a width, height pair. To change the size of the canvas itself, use SET_CANVAS_PROPERTY.

VISIBLE Whether the view is to be displayed. Valid values are PROPERTY_TRUE and PROPERTY_FALSE.

WIDTH For a stacked canvas, the width of the view. To change the size of the canvas itself, use SET_CANVAS_PROPERTY.

value
 
 
Specify the value appropriate to the property you are setting:

PROPERTY_TRUE The property is to be set to the TRUE state.

PROPERTY_FALSE The property is to be set to the FALSE state.

x 
The NUMBER value of the X coordinate or the width, depending on the property you specified. Specify the argument in form coordinate system units.
 
y 
 
The NUMBER value of the Y coordinate or the height, depending on the property you specified. Specify the argument in form coordinate system units.

SET_CANVAS_PROPERTY Built-in

SET_WINDOW_PROPERTY Built-in