يشير ذلك المصطلح إلى كائن يمثّل إشارة مرجعية.
// 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