In Oracle Forms, SET_ITEM_PROPERTY built-in is used to set an Item property at runtime. For example, you want to make enable or disable a push button on a certain condition. Then you can use SET_ITEM_PROPERTY built-in to do that. Below I am giving some examples of SET_ITEM_PROPERTY in Oracle Forms.
SET_ITEM_PROPERTY Usage/Syntax
SET_ITEM_PROPERTY Built-in Examples
1. The following example disables a Text Item named ENAME in EMP block.
2. To disable a push button in Oracle Forms. Below example will disable the push button named SAVEBUTTON in CONTROL block.
3. To enable push button use the following statement.
4. Change the label of a push button.
5. Change the prompt text of an item in Oracle Forms.
6. Change the width of an item. Applies to push button and text items.
7. To do not allow to update a field.
8. Set the visual attribute for an item.
9. To set an item’s font bold.
10. Set a tooltip text for a push button.
В Oracle Forms для работы с элементами в режиме выполнения существуют три основные разновидности встроенных подпрограмм пакета STANDARTS :
- процедуры SET_ — служат для установки свойств объектов;
- функции GET _ — служат для получения свойств объектов;
- функции FIND _ — служат для поиска идентификаторов объектов .
Процедуры установки свойств объектов
Процедуры установки значений предназначены для установки свойств объекта во время выполнения программы. В Oracle Forms существуют следующие разновидности процедур установки:
- SET_BLOCK_PROPERTY ;
- SET_CANVAS_PROPERTY ;
- SET_FORM_PROPERTY ;
- SET_ITEM_PROPERTY ;
- SET_LOV_PROPERTY ;
- SET_MENU_ITEM_PROPERTY ;
- SET_PARAMETER_ATTR ;
- SET_RADIO_BUTTON_PROPERTY ;
- SET_RECORD_PROPERTY ;
- SET_RELATION_PROPERTY ;
- SET_VIEW_PROPERTY ;
- SET_WINDOW_PROPERTY .
Синтаксис процедуры SET _ имеет достаточно много вариаций, поэтому перечислим только основные.
Синтаксис процедуры SET _
Каждая процедура в зависимости от объекта, с которым она ассоциирована, может принимать в качестве значений константы и различные переменные подстановки. Например, рассмотрим функцию SET_ RECORD_PROPERTY .
— устанавливает свойства записи.
record_number — номер записи;
block_name — имя блока, содержащего целевую запись . Тип данных — VARCHAR2 ;
property — свойство, значение которого собираемся изменить, — это константа STATUS ;
value — используйте возможное значение :
- CHANGED_STATUS ;
- INSERT_STATUS ;
- NEW_STATUS ;
- QUERY_STATUS .
Область применения этой процедуры очень большая, поэтому вы будете часто использовать ее в своих программах. Ниже приведено несколько примеров, в которых рассмотрены возможные способы применения этой процедуры.
- "Замена группы записей для LOV " — в этом примере проверяется текущая группа ( group_name1 ), на которой основан LOV , и если данная группа записей пустая, то мы подменяем ее другой группой ( group_name2 ).
Пример 1. "Замена группы записей для LOV "
Пример 1. "Замена группы записей для BLOCK "
Пример 3. "Стиль перемещения"
Пример 4. "Сделать элемент недоступным"
Функции получения свойств объектов
Функции GET _ предназначены для получения значений свойств объекта во время выполнения программы. В Oracle Forms существуют следующие разновидности рассматриваемых функций:
- GET_BLOCK_PROPERTY .
- GET_CANVAS_PROPERTY .
- GET_FORM_PROPERTY .
- GET_ITEM_PROPERTY .
- GET_LOV_PROPERTY .
- GET_MENU_ITEM_PROPERTY .
- GET_MESSAGE .
- GET_PARAMETER_ATTR .
- GET_RADIO_BUTTON_PROPERTY .
- GET_RECORD_PROPERTY .
- GET_RELATION_PROPERTY .
- GET_VIEW_PROPERTY .
- GET_WINDOW_PROPERTY .
Синтаксис функции, как и в предыдущем случае, имеет достаточно много вариаций, поэтому перечислим основные.
Синтаксис процедуры GET _
Использование функций типа GET _ дает возможность узнать текущие значения элементов в ходе выполнения программы, позволяя вам контролировать состояние объекта. Ниже приведены различные примеры применения этой функции.
Вы можете использовать функцию Get_Record_Property вместо системной переменной — :system.record_status .
Вы можете получить значение сообщения, отображающегося в статусной строке формы, используя функцию GET_MESSAGE .
Поиск идентификаторов объектов
FIND _ — эта функция предназначена для поиска идентификатора объекта , который характеризует внутреннее значение объекта, использующееся в Forms как внутреннее средство управления объектами.
Идентификатор — это значение , связываемое с объектом при его создании. Также стоит отметить, что использование идентификаторов объектов повышает производительность приложения.
Возвращаемое значение функции FIND _ зависит от класса искомого элемента (объекта). Ниже приведена табл. 18.1, где показаны все возможные вариации этой функции в зависимости от класса объекта, с которым она используется.
| Объект | Функция | Возвращаемый тип |
|---|---|---|
| Alert | FIND ALERT | ALERT |
| Block | FIND BLOCK | BLOCK |
| Canvas | FIND CANVAS | CANVAS |
| Record Group Column | FIND_COLUMN GROUP | COLUMN |
| Editor | FIND EDITOR | EDITOR |
| Form | FIND FORM | FORM MODULE |
| Record Group | FIND GROUP | RECORDGROUP |
| Item | FIND ITEM | ITEM |
| List of Values | FIND LOV | LOV |
| Menu Item | FIND MENU ITEM | MENU ITEM |
| Pa rameter List | GET_PAR A METER _LIST | PA R AMLIST |
| Relation | FIND RELATION | RELATION |
| Timer | FIND TIMER | TIMER |
| View | FIND VIEW | VIEWPORT |
Используя функцию поиска FIND _ , вы можете присвоить полученный идентификатор переменной , который можете применять для управления объектом, не обращаясь к нему по имени. Ниже приведен пример, который демонстрирует использование этой функции.
" Поиск идентификатора окна"
В следующем примере показано, как с помощью функции FIND _ мы проверяем существование редактора; если таковой существует, то он будет отображен процедурой Show_Editor на экран.
" Поиск идентификатора редактора"
В этом примере перед отображением списка значений ( LOV ) на экран проверяется его существование.
You can easily set Item’s property of different items in form builder.
For restrict Insert/Update in item:
For set required property No in item:
For set Enabled/Disabled item:
For any color to Item:
Set_Item_Instance_Property( ‘TRANS_ID’, CURRENT_RECORD,VISUAL_ATTRIBUTE,’VISUAL_ATTRIBUTE_NAME’);