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