الأربعاء، ١٨ مارس ٢٠٠٩

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 للتأكد من وجود هذا الكائن أو من عدم وجوده ، و من ثم فأذا لم يتواجد الكائن فقم بأنشاءه .
    Share/Save/Bookmark
    Newer Posts Older Posts Home Page