SHOW_ALERT

الـ SHOW_ALERT هى دالة بتقوم بأظهار الـ Alert

الشرح موجود بهذه الصور - أضغط على الصورة حتى تراها فى حجمها الطبيعى :-

حمل ملف الـ fmb الذى يشرح الـ SHOW_ALERT من هذا الرابط :-

أضـــــــــــغـــــــــط هــــــــــــــــــــنا

and Good Luck for all of you

SHOW_ALERT

SET_ALERT_PROPERTY

الـ SET_ALERT_PROPERTY تتحكم فى مضمون رسالة الـ Alert و عنوانه.

الشرح موجود بهذه الصور - أضغط على الصورة حتى تراها فى حجمها الطبيعى :-




حمل ملف الـ fmb الذى يشرح الـ SET_ALERT_PROPERTY من هذا الرابط :-

أضــــــغـــــــط هــــــــنا

and Good Luck for all of you

SET_ALERT_PROPERTY

SET_ALERT_BUTTON_PROPERTY

لقد قمت بتحديث ملف الـ fmb حتى يكون أكثر سهولة فى الاستخدام ، و هذا شرح منى بالصور ، أتمنى ان ينال أعجبكم :-

Description

Changes the label on one of the buttons in an alert.

تغير اسم زر من أزرار الـ Alert

=======-------------===========---------------========

Syntax

PROCEDURE SET_ALERT_BUTTON_PROPERTY
(alert_id ALERT,
button NUMBER,
property VARCHAR2,
value VARCHAR2);

PROCEDURE SET_ALERT_BUTTON_PROPERTY
(alert_nameVARCHAR2,
button NUMBER,
property VARCHAR2,
value VARCHAR2);

Built-in Type unrestricted procedure

Enter Query Mode yes

بالنسبة للصيغة بيتم كتابة جراء الـ SET_ALERT_BUTTON_PROPERTY كالتالى :-

بنكتب SET_ALERT_BUTTON_PROPERTY ثم نفتح قوس ثم نكتب أسم الـ Alert أو الـ ID الخاص بالـ Alert ثم فاصلة ثم رقم الزر ( و هو له عبارة ثابته سنقولها فى الـ Parameters ) ثم فاصلة ثم العامل ( و هو ايضاً عبارة ثابته ) ثم فاصلة ثم القيمة ( و هى ايضاً عبارة ثابته ) .

و هو أجراء غير مقيد و يمكن تنفيذه فى الـ Enter Query Mode

=======-------------===========---------------========

Parameters

alert_id

Specifies the unique ID (data type ALERT) that Oracle Forms assigns to the alert when it is created. Use FIND_ALERT to return the ID to an appropriately typed variable.

alert_name

Specifies the VARCHAR2 name of the alert.

button

A constant that specifies the alert button you want to change, either ALERT_BUTTON1, ALERT_BUTTON2, or ALERT_BUTTON3.

property LABEL

Specifies the label text for the alert button.

value

Specifies the VARCHAR2 value to be applied to the property you specified.

كما ذكرنا فى الصيغة فأن أول عامل هو اسم الـ Alert أو الـ ID الخاص به ، و ثانى عامل هو الزر و هنا حنا بنحدد اى زر الذى سيتم تغيره و يجب أن نكتب عامل ثابت من هذه العوامل الثلاثة الثابته :-
ALERT_BUTTON1
ALERT_BUTTON2
ALERT_BUTTON3
اما العامل الثالت و هى الخاصية الموجوده بالزر التى سنحددها لكى نغيرها فهى عامل واحد و ثابت و هو الـ LABEL ، و بالنسبة للعامل الرابع فهو القيمة التى ستوضع على الزر و التى يجب أن تكون Varchar2

Usage Notes

If the label specified is NULL, the button's label reverts to the label specified at design time.

بيقولك فى النهاية ان اذا ام تكتب اى شىء فى العامل الرابع فسوف يتم أسترجاع القيمة التى تم وضعها فى وقت التصميم

قم بتحميل ملف الـ fmb الذى يشرح SET_ALERT_BUTTON_PROPERTY من هذا الرابط :-

أضـــــغـــــط هــــــنا

and Good Luck for all of you

SET_ALERT_BUTTON_PROPERTY

ID_NULL

Description

Returns a BOOLEAN value that indicates whether the object ID is available.

دالة الـ ID_NULL تقوم بأرجاع قيمة من نوع Boolean أى يا True يا False كدليل على وجود أو عدم وجود الـ ID الخاص بالكائن.

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=

Syntax

FUNCTION ID_NULL
(Alert ALERT);

FUNCTION ID_NULL
(Block BLOCK);

FUNCTION ID_NULL
(Canvas CANVAS);

FUNCTION ID_NULL
(Editor EDITOR);

FUNCTION ID_NULL
(FormModule FORMMODULE);

FUNCTION ID_NULL
(GroupColumn GROUPCOLUMN);

FUNCTION ID_NULL
(Item ITEM);

FUNCTION ID_NULL
(LOV LOV);

FUNCTION ID_NULL
(MenuItem MENUITEM);

FUNCTION ID_NULL
(ParamList PARAMLIST);

FUNCTION ID_NULL
(RecordGroup RECORDGROUP);

FUNCTION ID_NULL
(Relation RELATION);

FUNCTION ID_NULL
(Report_Object REPORT_OBJECT);

FUNCTION ID_NULL
(TabPage TABPAGE);

FUNCTION ID_NULL
(Timer TIMER);

FUNCTION ID_NULL
(Viewport VIEWPORT);

FUNCTION ID_NULL
(VisualAttribute VISUALATTRIBUTE);

FUNCTION ID_NULL
(Window WINDOW);

بالنسبة للصيغة فبتكون بكتابة ID_NULL ثم فتح قوس ثم كتابة أسم الكائن ثم كتابة الـ Data type الخاصه به ثم غلق القوس .

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=

Built-in Type unrestricted function

Returns BOOLEAN

Enter Query Mode yes

هى دالة غير مقيدة و نوع الـ Data type العائدة هى Boolean و يمكن تنفيذها أثناء الـ Enter Query Mode

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=

Parameters

object_id You can call this function to test results of the following object ID types:

• Alert
• Block
• Canvas
• Editor
• FormModule
• GroupColumn
• Item
• LOV
• MenuItem
• ParamList
• RecordGroup
• Relation
• REPORT_OBJECT
• TabPage
• Timer
• Viewport
• VisualAttribute
• Window

كما أوضحنا فى الصيغة فأن العامل ( او ما يطلق عليه Parameter ) هو المتغير الذى سيوضع ما بين القوسيين الذى يجب ان يكون الـ Data type الخاصه به هى واحده من القائمة السابقة .

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=

Usage Notes

Use ID_NULL when you want to check for the existence of an object created dynamically at runtime. For example, if a specific record group already exists, you will receive an error message if you try to create that record group. To perform this check, follow this general process:

Use the appropriate FIND_ built-in to obtain the object ID.

Use ID_NULL to check whether an object with that ID already exists.

If the object does not exist, proceed to create it.

If you are going to test for an object’s existence at various times (that is, more than once during a run), then you need to reissue the appropriate FIND_ every time -- once preceding each use of ID_NULL.

ملاحظات الأستخدام

أستخدم الـ ID_NULL لما تبقى عاوز تتاكد من وجود كائن معين أثناء تشغيل الفورمه ، فمثلاً أذا حاولنا أنشاء record group - دون التأكد من وجوده من خلال الـ ID_NULL - و هو بالفعل تم أنشاءه مسبقاً ، فسوف يظهر رسالة خطاء.

و لكى تقوم بأستخدام الـ ID_NULL فأعمل التالى :-

أستخدم الـ FIND_ built-in الملائم للحصول على الـ ID للكائن المراد.

و هذه هى جميع الـ FIND_ built-ins :-

FIND_ALERT,FIND_BLOCK,FIND_CANVAS,FIND_COLUMN,FIND_EDITOR,FIND_FORM,FIND_GROUP,FIND_ITEM,FIND_LOV,FIND_MENU_ITEM,FIND_RELATION,FIND_REPORT_OBJECT,FIND_TAB_PAGE,FIND_TIMER,FIND_VIEW,FIND_WINDOW

ثم أستخدم الـ ID_NULL للتأكد من وجود هذا الكائن أو من عدم وجوده ، و من ثم فأذا لم يتواجد الكائن فقم بأنشاءه .

ID_NULL

FIND_ALERT

Description

Searches the list of valid alerts in Oracle Forms. When the given alert is located, the subprogram returns an alert ID. You must return the ID to an appropriately typed variable. Define the variable with a type of Alert.

بالنسبة للـ FIND_ALERT Built-in فهو يبحث عن قائمة الـ Alerts سارية المفعول و عندما يتم تحديد الـ Alert يقوم بأرجاع الـ ID الخاص بهذا الـ Alert ، و لكن يجب ان ترجع هذا الـ ID الى المتغير ذات الـ Data type الخاص بالـ Alert .

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=

Syntax

FUNCTION FIND_ALERT
(alert_name VARCHAR2);

Built-in Type : unrestricted function

Returns : Alert

Enter Query Mode : yes

و بالنسبة للصيغة فهى دالة و تقوم بأرجاع الـ Alert و الـ Data type لقيمتها العائدة هى VARCHAR2 ، كما أنها دالة غير مقيدة و يمكن أستخدامها فى الـ Query Mode

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=

Parameters

alert_name

Specifies the VARCHAR2 alert name.

و كما كان واضح فى الصيغة - السابق ذكرها - فأن الـمعامل الـ alert_name هو من أسمه يدل على أن ما سنقوم بأدخاله هو اسم الـ Alert و أيضاً يجب أن يكتب كأحرف لأنه VARCHAR2.

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=

FIND_ALERT Example

 /*

** Built-in: FIND_ALERT
** Example: Show a user-warning alert. If the user presses
** the OK button, then make REALLY sure they want
** to continue with another alert.
*/
DECLARE
al_id      ALERT;
al_button  NUMBER;
BEGIN
al_id := Find_alert('User_Warning');

IF Id_null(al_id) THEN
Message('User_Warning alert does not exist');

RAISE form_trigger_failure;
ELSE
/*
** Show the warning alert
*/
al_button := Show_alert(al_id);

/*
** If user pressed OK (button 1) then bring up another
** alert to confirm -- button mappings are specified
** in the alert design
*/
IF al_button = alert_button1 THEN
al_id := Find_alert('Are_You_Sure');

IF Id_null(al_id) THEN
Message('The alert named: Are you sure? does not exist');

RAISE form_trigger_failure;
ELSE
al_button := Show_alert(al_id);

IF al_button = alert_button2 THEN
 erase_all_employee_records;
END IF;
END IF;
END IF;
END IF;
END; 

و كما هو موضح بالمثال السابق فاننا نقوم بعمل عدد 2 Alert و نقوم بالحصول على الـ ID الخاص بهم من خلال الـ Find_Alert ..... و لقد قمت بأرفاق ملف fmb قد قمت بأنشاؤه على الـ Forms 10g .... حمله من هذا الرابط :-

أضـــغــط هـــــــنا

و أذا كان لديك أى أستفسار فأطرحه فى الـ Comment

و بالتوفيق للجميع

FIND_ALERT