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.

Note that if you have a form in client server that uses the SET_VIEW_PROPERTY with the parameter X_POS_ON_CANVAS, it will not work when deploying to the web, and won't return an error.

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.

 

Fuentes:

DE la ayuda de forms oracle.