تمت إزالة هذا العمود. تم إيقاف هذا الفئة نهائيًا ويجب عدم استخدامها في نصوص برمجية جديدة.
عنصر ListItem في المواقع - عنصر قائمة من صفحة قائمة المواقع الإلكترونية.
الطرق المتوقّفة نهائيًا
الطريقة | نوع القيمة التي يتم إرجاعها | وصف قصير |
---|---|---|
| void | يؤدي إلى حذف عنصر القائمة هذا. |
| Date | تعرض تاريخ نشر عنصر القائمة هذا لأول مرة. |
| Date | تعرض تاريخ آخر تعديل لهذا التعليق. |
|
| الحصول على الصفحة الرئيسية لعنصر القائمة هذا |
| String | احصل على قيمة ListItem هذا لعمود مرقّم. |
| String | احصل على قيمة ListItem هذا لعمود مسمّى. |
|
| تعيين الصفحة الرئيسية لعنصر القائمة هذا. |
|
| عيِّن قيمة ListItem هذا لعمود مرقم. |
|
| عيِّن قيمة ListItem هذا لعمود مرقم. |
الطرق المتوقّفة نهائيًا
deleteListItem()
deleteListItem()
تمت إزالة هذا العمود. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في نصوص برمجية جديدة.
يؤدي إلى حذف عنصر القائمة هذا.
// This code sample deletes all list items from a List page // Running this code sample against a Page that is a standard web page will // cause getListItems() to throw an exception var page = SitesApp.getSite('demositeappsscript').getChildByName('mylistpage'); var items = page.getListItems(); for(var i = 0; i < items.length; i++) { items[i].deleteListItem(); }
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://sites.google.com/feeds
getDatePublished()
getDatePublished()
تمت إزالة هذا العمود. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في نصوص برمجية جديدة.
تعرض تاريخ نشر عنصر القائمة هذا لأول مرة.
var page = SitesApp.getSite('example.com', 'mysite').getChildByName('mylistpage'); var items = page.getListItems(); var date = items[0].getDatePublished();
استرجاع الكرة
Date
: تاريخ النشر الأصلي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://sites.google.com/feeds
getLastUpdated()
getLastUpdated()
تمت إزالة هذا العمود. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في نصوص برمجية جديدة.
تعرض تاريخ آخر تعديل لهذا التعليق.
var page = SitesApp.getSite('example.com', 'mysite').getChildByName('mylistpage'); var items = page.getListItems(); var date = items[0].getLastUpdated();
استرجاع الكرة
Date
- تاريخ آخر تعديل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://sites.google.com/feeds
getParent()
getParent()
تمت إزالة هذا العمود. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في نصوص برمجية جديدة.
الحصول على الصفحة الرئيسية لعنصر القائمة هذا
var page = SitesApp.getSite('example.com', 'mysite').getChildByName('mylistpage'); var items = page.getListItems(); // parentPage will equal page var parentPage = items[0].getParent();
استرجاع الكرة
- الصفحة الرئيسيةPage
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://sites.google.com/feeds
getValueByIndex(index)
getValueByIndex(index)
تمت إزالة هذا العمود. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في نصوص برمجية جديدة.
احصل على قيمة ListItem هذا لعمود مرقّم.
var page = SitesApp.getSite("demositeappsscript").getChildByName("mylistpage"); var listItem = page.getListItems()[0]; // Remember that rows are 0 indexed. This returns the item in the first column // of the list. If an index that is greater than the number of columns is used, // the script will throw an "InvalidArgument: index" exception. var value = listItem.getValueByIndex(5);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
index | Integer | العمود للحصول على قيمة |
استرجاع الكرة
String
- قيمة ذلك العمود
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://sites.google.com/feeds
getValueByName(name)
getValueByName(name)
تمت إزالة هذا العمود. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في نصوص برمجية جديدة.
احصل على قيمة ListItem هذا لعمود مسمّى.
var page = SitesApp.getSite("demositeappsscript").getChildByName("mylistpage"); var listItem = page.getListItems()[0]; // Suppose we have a column named "Owner" - this will let us fetch the value // for the list item var value = listItem.getValueByName("Owner"); Logger.log(value);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
name | String | العمود للحصول على قيمة |
استرجاع الكرة
String
- قيمة ذلك العمود
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://sites.google.com/feeds
setParent(parent)
setParent(parent)
تمت إزالة هذا العمود. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في نصوص برمجية جديدة.
تعيين الصفحة الرئيسية لعنصر القائمة هذا.
var page = SitesApp.getSite('example.com', 'mysite').getChildByName('mylistpage'); var secondListPage = SitesApp.getSite('example.com', 'mysite') .getChildByName('secondlistpage'); var items = page.getListItems(); // Returns secondListPage var parentPage = items[0].setParent(secondListPage).getParent();
المَعلمات
الاسم | Type | الوصف |
---|---|---|
parent |
| العنصر الرئيسي الجديد |
استرجاع الكرة
: عنصر القائمة هذا للتسلسلListItem
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://sites.google.com/feeds
setValueByIndex(index, value)
setValueByIndex(index, value)
تمت إزالة هذا العمود. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في نصوص برمجية جديدة.
عيِّن قيمة ListItem هذا لعمود مرقم. بالنسبة إلى أعمدة عناوين URL، يجب أن تكون القيمة علامة ارتساء XHTML مع أحرف إلغاء لكيانات XML.
var page = SitesApp.getSite("example.com", "mysite").getChildByName("mylistpage"); var listItem = page.getListItems()[0]; listItem.setValueByIndex(1, 'This is the new value'); listItem.setValueByIndex(2, '<a href="http://www.example.com?a=1&b=2">Example</a>');
المَعلمات
الاسم | Type | الوصف |
---|---|---|
index | Integer | العمود لتعيين قيمة |
value | String | القيمة الجديدة |
استرجاع الكرة
: عنصر القائمة هذا للتسلسلListItem
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://sites.google.com/feeds
setValueByName(name, value)
setValueByName(name, value)
تمت إزالة هذا العمود. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في نصوص برمجية جديدة.
عيِّن قيمة ListItem هذا لعمود مرقم. بالنسبة إلى أعمدة عناوين URL، يجب أن تكون القيمة علامة ارتساء XHTML مع أحرف إلغاء لكيانات XML.
var page = SitesApp.getSite("demositeappsscript").getChildByName("mylistpage"); var listItem = page.getListItems()[0]; listItem.setValueByName('Owner', 'Eric'); listItem.setValueByName('Page', '<a href="http://www.example.com?a=1&b=2">Example</a>');
المَعلمات
الاسم | Type | الوصف |
---|---|---|
name | String | العمود لتعيين قيمة |
value | String | القيمة الجديدة |
استرجاع الكرة
: عنصر القائمة هذا للتسلسلListItem
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://sites.google.com/feeds