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