Class 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	حدِّد قيمة عنصر القائمة هذا لعمود مرقَّم.
setValueByName(name, value)	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);

المعلمات

الاسم	النوع	الوصف
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);

المعلمات

الاسم	النوع	الوصف
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();

المعلمات

الاسم	النوع	الوصف
parent	Page	العنصر الرئيسي الجديد

الإرجاع

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

التفويض

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

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

---

setValueByIndex(index, value)

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

حدِّد قيمة عنصر القائمة هذا لعمود مرقَّم. بالنسبة إلى أعمدة عناوين 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>');

المعلمات

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

الإرجاع

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

التفويض

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

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

---

setValueByName(name, value)

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

حدِّد قيمة عنصر القائمة هذا لعمود مرقَّم. بالنسبة إلى أعمدة عناوين 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>');

المعلمات

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

الإرجاع

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

التفويض

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

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