Class Link

קישור

קישור היפרטקסט.

Methods

שיטהסוג הערך שמוחזרתיאור קצר
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 לא LinkType.
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 לא LinkType.

שימו לב: יכול להיות שהשקף באינדקס שמוחזר לא קיים. 

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