Class Link

الرابط

رابط نص تشعّبي

الطُرق

الطريقة	نوع القيمة التي يتم إرجاعها	وصف قصير
getLinkType()	LinkType	تعرض LinkType.
getLinkedSlide()	Slide|null	تعرض هذه السمة Slide المرتبط بأنواع الروابط غير عناوين URL، إذا كان متاحًا.
getSlideId()	String|null	تعرِض هذه السمة رقم تعريف Slide أو null المرتبطَين إذا لم تكن قيمة LinkType هي LinkType.SLIDE_ID.
getSlideIndex()	Integer|null	تعرِض هذه السمة الفهرس المستند إلى الصفر الخاص بـ Slide أو null المرتبطَين إذا لم يكن LinkType هو LinkType.SLIDE_INDEX.
getSlidePosition()	SlidePosition|null	تعرِض هذه الدالة SlidePosition Slide أو null المرتبطَين إذا لم يكن LinkType LinkType.SLIDE_POSITION.
getUrl()	String|null	تعرض هذه الدالة عنوان URL الخاص بصفحة الويب الخارجية أو null إذا لم يكن LinkType هو LinkType.URL.

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

getLinkType()

تعرض LinkType.

const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
const link = shape.getLink();
if (link != null) {
  Logger.log(`Shape has a link of type: ${link.getLinkType()}`);
}

الإرجاع

LinkType

التفويض

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

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

---

getLinkedSlide()

تعرض هذه السمة Slide المرتبط بأنواع الروابط غير عناوين URL، إذا كان متاحًا. تعرِض null إذا كانت الشريحة غير متوفّرة في العرض التقديمي، أو إذا كانت قيمة LinkType هي LinkType.URL.

const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
const link = shape.getLink();
if (link != null && link.getLinkType() !== SlidesApp.LinkType.URL) {
  Logger.log(`Shape has link to slide: ${link.getLinkedSlide()}`);
}

الإرجاع

Slide|null

التفويض

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

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

---

getSlideId()

تعرِض هذه السمة رقم تعريف Slide أو null المرتبطَين إذا لم تكن قيمة LinkType هي LinkType.SLIDE_ID.

يُرجى العِلم أنّه قد لا تكون الشريحة التي تم إرجاع رقم تعريفها متوفّرة.

const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
const link = shape.getLink();
if (link != null && link.getLinkType() === SlidesApp.LinkType.SLIDE_ID) {
  Logger.log(`Shape has link to slide with ID: ${link.getSlideId()}`);
}

الإرجاع

String|null

التفويض

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

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

---

getSlideIndex()

تعرِض هذه السمة الفهرس المستند إلى الصفر الخاص بـ Slide أو null المرتبطَين إذا لم يكن LinkType هو LinkType.SLIDE_INDEX.

يُرجى العِلم أنّ الشريحة في الفهرس الذي تم عرضه قد لا تكون متوفّرة.

const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
const link = shape.getLink();
if (link != null && link.getLinkType() === SlidesApp.LinkType.SLIDE_INDEX) {
  Logger.log(`Shape has link to slide with index: ${link.getSlideIndex()}`);
}

الإرجاع

Integer|null

التفويض

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

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

---

getSlidePosition()

تعرِض هذه الدالة SlidePosition Slide أو null المرتبطَين إذا لم يكن LinkType LinkType.SLIDE_POSITION.

يُرجى العِلم أنّ الشريحة التي تتضمّن الموضع النسبي الذي تم عرضه قد لا تكون متوفّرة.

const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
const link = shape.getLink();
if (link != null && link.getLinkType() === SlidesApp.LinkType.SLIDE_POSITION) {
  Logger.log(
      `Shape has link to slide with relative position: ${
          link.getSlidePosition()}`,
  );
}

الإرجاع

SlidePosition|null

التفويض

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

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

---

getUrl()

تعرض هذه الدالة عنوان URL الخاص بصفحة الويب الخارجية أو null إذا لم يكن LinkType هو LinkType.URL.

const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
const link = shape.getLink();
if (link != null && link.getLinkType() === SlidesApp.LinkType.URL) {
  Logger.log(`Shape has link to URL: ${link.getUrl()}`);
}

الإرجاع

String|null

التفويض

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

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