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

SET_TAB_PAGE_PROPERTY Built-in

Description

Sets the tab page properties of the specified tab canvas page.

Syntax

SET_TAB_PAGE_PROPERTY
(tab_page_id TAB_PAGE,
property
NUMBER,
value
NUMBER);

SET_TAB_PAGE_PROPERTY
(tab_page_name VARCHAR2,
property
NUMBER,
value
NUMBER);

SET_TAB_PAGE_PROPERTY
(tab_page_id TAB_PAGE,
property
NUMBER,
value
VARCHAR2);

SET_TAB_PAGE_PROPERTY
(tab_page_name VARCHAR2,
property
NUMBER,
value
VARCHAR2);

Built-in Type unrestricted procedure

Enter Query Mode yes

Parameters

tab_page_id 
 
The unique ID Oracle Forms assigns to the tab page when it creates it. Datatype is TAB_PAGE.
 
tab_page_name 
 
The name you gave the tab page when you defined it. Datatype is VARCHAR2.
 
property 
 
The property you want to set for the given tab page. Possible values are:

BACKGROUND_COLOR The color of the object's background region.

ENABLED Specify TRUE to enable the tab page, FALSE to disable it (i.e., make it greyed out and unavailable).

FILL_PATTERN The pattern to be used for the object's fill region. Patterns are rendered in the two colors specified by Background Color and Foreground Color.

FONT_NAME The font family, or typeface, that should be used for text in the object. The list of fonts available is system-dependent.

FONT_SIZE The size of the font, specified in points.

FONT_SPACING The width of the font, that is, the amount of space between characters (kerning).

FONT_STYLE The style of the font.

FONT_WEIGHT The weight of the font.

FOREGROUND_COLOR The color of the object's foreground region. For items, the Foreground Color attribute defines the color of text displayed in the item.

LABEL The character string for the tab page label.

VISIBLE Specify TRUE to make the tab page visible, FALSE to make it not visible. A tab page is reported visible if it is currently mapped to the screen, even if it is entirely hidden behind another tab page.

VISUAL_ATTRIBUTE Specifies the name of the visual attribute currently in force.

value 
 
You can pass the following constants or the appropriate character strings as arguments to the property values described above:

PROPERTY_TRUE (sets the property to the TRUE state)

PROPERTY_FALSE (sets the property to the FALSE state)

SET_TAB_PAGE_PROPERTY Example

/* Example: Use SET_TAB_PAGE_PROPERTY to set the
** ENABLED property to TRUE for a tab page (if it currently
** is set to FALSE:
*/

DECLARE
tb_pg_id TAB_PAGE;

BEGIN
tb_pg_id := FIND_TAB_PAGE('tab_page_1');
IF GET_TAB_PAGE_PROPERTY(tb_pg_id, enabled) = 'FALSE' THEN
SET_TAB_PAGE_PROPERTY(tb_pg_id, enabled, property_true);
END IF;
END;