Class ListItem

ListItem

تمت إزالة هذا العمود. تم إيقاف هذا الفئة نهائيًا ويجب عدم استخدامها في نصوص برمجية جديدة.

عنصر ListItem في المواقع - عنصر قائمة من صفحة قائمة المواقع الإلكترونية.

الطرق المتوقّفة نهائيًا

الطريقة	نوع القيمة التي يتم إرجاعها	وصف قصير
deleteListItem()	void	يؤدي إلى حذف عنصر القائمة هذا.
getDatePublished()	Date	تعرض تاريخ نشر عنصر القائمة هذا لأول مرة.
getLastUpdated()	Date	تعرض تاريخ آخر تعديل لهذا التعليق.
getParent()	Page	الحصول على الصفحة الرئيسية لعنصر القائمة هذا
getValueByIndex(index)	String	احصل على قيمة ListItem هذا لعمود مرقّم.
getValueByName(name)	String	احصل على قيمة ListItem هذا لعمود مسمّى.
setParent(parent)	ListItem	تعيين الصفحة الرئيسية لعنصر القائمة هذا.
setValueByIndex(index, value)	ListItem	عيِّن قيمة ListItem هذا لعمود مرقم.
setValueByName(name, value)	ListItem	عيِّن قيمة ListItem هذا لعمود مرقم.

الطرق المتوقّفة نهائيًا

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()

تمت إزالة هذا العمود. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في نصوص برمجية جديدة.

تعرض تاريخ نشر عنصر القائمة هذا لأول مرة.

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()

تمت إزالة هذا العمود. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في نصوص برمجية جديدة.

تعرض تاريخ آخر تعديل لهذا التعليق.

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()

تمت إزالة هذا العمود. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في نصوص برمجية جديدة.

الحصول على الصفحة الرئيسية لعنصر القائمة هذا

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)

تمت إزالة هذا العمود. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في نصوص برمجية جديدة.

احصل على قيمة 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)

تمت إزالة هذا العمود. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في نصوص برمجية جديدة.

احصل على قيمة 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)

تمت إزالة هذا العمود. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في نصوص برمجية جديدة.

تعيين الصفحة الرئيسية لعنصر القائمة هذا.

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	Page	العنصر الرئيسي الجديد

استرجاع الكرة

ListItem: عنصر القائمة هذا للتسلسل

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:

• https://sites.google.com/feeds

---

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&amp;b=2">Example</a>');

المَعلمات

الاسم	Type	الوصف
index	Integer	العمود لتعيين قيمة
value	String	القيمة الجديدة

استرجاع الكرة

ListItem: عنصر القائمة هذا للتسلسل

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:

• https://sites.google.com/feeds

---

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&amp;b=2">Example</a>');

المَعلمات

الاسم	Type	الوصف
name	String	العمود لتعيين قيمة
value	String	القيمة الجديدة

استرجاع الكرة

ListItem: عنصر القائمة هذا للتسلسل

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:

• https://sites.google.com/feeds