11.01.2013 Views

Oracle Forms Developer – Form Builder Reference, Volume 1

Oracle Forms Developer – Form Builder Reference, Volume 1

Oracle Forms Developer – Form Builder Reference, Volume 1

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

item_name The name you gave the item when you created it. Datatype is<br />

VARCHAR2.<br />

property The property you want to set for the given item. Possible properties are:<br />

Usage Notes<br />

BORDER_BEVEL Specifies the item border bevel for the specified item<br />

instance. Valid values are RAISED, LOWERED, PLAIN (unbeveled), or "<br />

". A value of " " causes the border bevel to be determined by the value<br />

specified at the item level at design-time or by SET_ITEM_PROPERTY at<br />

runtime.<br />

Note: You cannot set BORDER_BEVEL if the item’s Bevel property is set<br />

to None in <strong>Form</strong> <strong>Builder</strong>.<br />

INSERT_ALLOWED Applies only to records not retrieved from the<br />

database. When set to PROPERTY_TRUE at the item instance, item, and<br />

block levels, allows the end user to modify the item instance. Setting this<br />

property to PROPERTY_FALSE at the item instance, item, or block levels,<br />

prohibits the end user from modifying the item instance.<br />

NAVIGABLE When set to PROPERTY_TRUE at the item instance and<br />

item levels, allows the end user to be able to navigate to the item instance<br />

using default keyboard navigation. Setting this property to<br />

PROPERTY_FALSE at the item instance or item levels, disables default<br />

keyboard navigation to the item instance.<br />

REQUIRED Specify the constant PROPERTY_TRUE if you want to<br />

force the end user to enter a non-null value for the item instance. Setting<br />

this property to PROPERTY_FALSE at the item instance and item levels,<br />

indicates that the item instance is not required.<br />

UPDATE_ALLOWED Applies only to records retrieved from the<br />

database. When set to PROPERTY_TRUE at the item instance, item, and<br />

block levels, allows the end user to modify the item instance. When set to<br />

PROPERTY_FALSE at the instance, item, or block levels, prohibits the<br />

end user from modifying the item instance.<br />

VISUAL_ATTRIBUTE Specify a valid named visual attribute that exists<br />

in the current form or ’’. Specifying ’’ leaves visual attribute unspecified at<br />

the item instance level.<br />

When working with properties specified at multiple levels (item instance, item, and block), consider the<br />

following guidelines:<br />

• Required properties specified at multiple levels are ORed together<br />

• Other boolean properties specified at multiple levels are ANDed together<br />

The value derived from combining properties specified at the item instance, item, and block levels is<br />

called the effective value. Some of the effects of these two rules are as follows:<br />

• setting INSERT_ALLOWED to true has no effect at the item instance level unless it is set<br />

consistently at the block and item levels. For example, your user cannot type data into an item<br />

instance if INSERT_ALLOWED is true at the instance level, but not at the item or block levels.<br />

• setting NAVIGABLE to true has no effect at the item instance level unless it is set consistently at<br />

the item and item instance levels<br />

383

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!