Class Bookmark

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
إشارة مرجعية

تمثّل هذه السمة عنصرًا يمثّل إشارة مرجعية.

// Insert a bookmark at the cursor position and log its ID.
var doc = DocumentApp.getActiveDocument();
var cursor = doc.getCursor();
var bookmark = doc.addBookmark(cursor);
Logger.log(bookmark.getId());

الطُرق

الطريقةنوع الإرجاعوصف قصير
getId()Stringتحصل على رقم تعريف Bookmark.
getPosition()Positionللحصول على Position من Bookmark داخل Document.
remove()voidحذف Bookmark

المستندات التفصيلية

getId()

تحصل على رقم تعريف Bookmark. يجب أن يكون المعرّف فريدًا داخل المستند.

تذكرة ذهاب وعودة

String — رقم تعريف Bookmark' ، وهو رقم فريد ضمن المستند

التفويض

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

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getPosition()

للحصول على Position من Bookmark داخل Document. تظل Position دقيقة طالما لم يتم حذف Bookmark، حتى إذا غيّر النص البرمجي بنية المستند.

تذكرة ذهاب وعودة

Position — موضع Bookmark

التفويض

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

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

remove()

حذف Bookmark ولا يؤثّر استدعاء هذه الطريقة على Bookmark سبق حذفه.

التفويض

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

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents