تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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