Returns property values for a specified tab page.
FUNCTION GET_TAB_PAGE_PROPERTY
(tab_page_id TAB_PAGE,
property NUMBER);
FUNCTION GET_TAB_PAGE_PROPERTY
(tab_page_name VARCHAR2,
property NUMBER);
Built-in Type unrestricted function
Returns VARCHAR2
Enter Query Mode yes
tab_page_id The unique ID Oracle Forms assigned to the tab page object when you created it. Use the FIND_TAB_PAGE Built-in to return the ID to a variable of datatype TAB_PAGE.
tab page_name The name you gave the tab page object when you created it. Note: if two tab pages in the same form module share the same name, you must provide the canvas and tab page (e.g., CVS_1.TAB_PG_1).
property The property the value of which you want to get for the given tab page. The possible properties are as follows:
BACKGROUND_COLOR The color of the object's background region.
CANVAS_NAME Returns the VARCHAR2 name of the canvas to which the tab page belongs.
ENABLED Returns the VARCHAR2 string TRUE if a tab page is enabled, FALSE if it is disabled (i.e., 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 Returns the VARCHAR2 string for the tab page label.
VISIBLE Returns the VARCHAR2 value TRUE if the tab page is visible, FALSE if it is not. 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 Returns the name of the visual attribute currently in force. If no named visual attribute is assigned to the tab page, returns CUSTOM for a custom visual attribute or DEFAULT for a default visual attribute.
/* Use FIND_TAB_PAGE and GET_TAB_PAGE_PROPERTY to check
** if a tab page is enabled:
*/
DECLARE
tp_id TAB_PAGE;
live VARCHAR2(32);
BEGIN
tp_id := FIND_TAB_PAGE('tab_page_1');
live := GET_TAB_PAGE_PROPERTY(tp_id, enabled);
END;