P. 1
Form Builder Referencia

Form Builder Referencia

|Views: 1,916|Likes:
Published by Daniel Viana

More info:

Published by: Daniel Viana on Mar 31, 2013
Copyright:Attribution Non-commercial

Availability:

Read on Scribd mobile: iPhone, iPad and Android.
download as PDF, TXT or read online from Scribd
See more
See less

07/16/2013

pdf

text

original

Description

Returns information about a specified radio button.

Syntax

FUNCTION GET_RADIO_BUTTON_PROPERTY
(item_id ITEM,
button_name VARCHAR2,
property NUMBER);
FUNCTION GET_RADIO_BUTTON_PROPERTY(
item_name VARCHAR2,
button_name VARCHAR2,
property NUMBER);

Built-in Type unrestricted function

Returns VARCHAR2

Enter Query Mode yes

Parameters

item_id

Specifies the radio group item ID. Form Builder assigns the unique ID at
the time it creates the object. Use the FIND_ITEM built-in to return the
ID to an appropriately typed variable. The data type of the ID is ITEM.

item_name

Specifies the name of the radio group. The radio group is the owner or
parent of its subordinate radio buttons. The data type of the name is
VARCHAR2.

button_name

Specifies the name of the radio button whose property you want. The data
type of the name is VARCHAR2.

property

Specifies the property for which you want the current state. The possible
property constants you can indicate are as follows:

BACKGROUND_COLOR The color of the object’s background region.

ENABLED Returns the VARCHAR2 string TRUE if property is set to
Yes, and the VARCHAR2 string FALSE if property is set to No.

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.

213

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.

HEIGHT Returns the height of the radio button. The value is returned as
a VARCHAR2 and is expressed in the units as set for the form by the form
module Coordinate System property.

LABEL Returns the actual string label for that radio button.

PROMPT_BACKGROUND_COLOR The color of the object’s
background region.

PROMPT_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.

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

PROMPT_FONT_SIZE The size of the font, specified in points.

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

PROMPT_FONT_STYLE The style of the font.

PROMPT_FONT_WEIGHT The weight of the font.

PROMPT_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.

PROMPT_WHITE_ON_BLACK Specifies that the object is to appear
on a monochrome bitmap display device as white text on a black
background.

VISIBLE Returns the VARCHAR2 string TRUE if property is set to Yes,
returns and the VARCHAR2 string FALSE if property is set to No.

VISUAL_ATTRIBUTE Returns the name of the visual attribute currently
in force. If no named visual attribute is assigned to the radio button, returns
CUSTOM for a custom visual attribute or DEFAULT for a default visual
attribute.

WHITE_ON_BLACK Specifies that the object is to appear on a
monochrome bitmap display device as white text on a black background.

WIDTH Returns the width of the radio button, including the label part.
The value is returned as a VARCHAR2 and is expressed in the units as set
for the form by the form module Coordinate System property.

WINDOW_HANDLE Returns the a unique internal VARCHAR2
constant that is used to refer to objects. Returns the number 0 if the
platform is not Microsoft Windows.

X_POS Returns the x coordinate that reflects the current placement of the
button’s upper left corner relative to the upper left corner of the canvas.

214

The value is returned as a VARCHAR2 and is expressed in the units
defined by the form module Coordinate System property.

Y_POS Returns the y coordinate that reflects the current placement of the
button’s upper left corner relative to the upper left corner of the canvas.
The value is returned as a VARCHAR2 and is expressed in the units
defined by the form module Coordinate System property.

GET_RADIO_BUTTON_PROPERTY examples

/*
** Built-in: GET_RADIO_BUTTON_PROPERTY
** Example: Determine whether a given radio button is
** displayed and has a particular visual
** attribute.
*/
DECLARE
it_id Item;
disp VARCHAR2(5);
va_name VARCHAR2(40);

BEGIN

it_id := Find_Item(’My_Favorite_Radio_Grp’);
disp := Get_Radio_Button_Property( it_id, ’REJECTED’,

VISIBLE);

va_name := Get_Radio_Button_Property( it_id, ’REJECTED’,
VISUAL_ATTRIBUTE);

IF disp = ’TRUE’ AND va_name = ’BLACK_ON_PEACH’ THEN
Message(’You win a prize!’);

ELSE

Message(’Sorry, no luck today.’);

END IF;

END;

215

You're Reading a Free Preview

Download
scribd
/*********** DO NOT ALTER ANYTHING BELOW THIS LINE ! ************/ var s_code=s.t();if(s_code)document.write(s_code)//-->