Um link de hipertexto.
Métodos
Método | Tipo de retorno | Breve descrição |
---|---|---|
getLinkType() | LinkType | Retorna o LinkType . |
getLinkedSlide() | Slide | Retorna o Slide vinculado para tipos de links que não são URL, se houver. |
getSlideId() | String | Retorna o ID da Slide ou null vinculada se LinkType não for LinkType.SLIDE_ID . |
getSlideIndex() | Integer | Retorna o índice baseado em zero da Slide ou null vinculada se LinkType não for LinkType.SLIDE_INDEX . |
getSlidePosition() | SlidePosition | Retorna o SlidePosition do Slide ou null vinculado se LinkType não for LinkType.SLIDE_POSITION . |
getUrl() | String | Retorna o URL para a página da Web externa ou null se LinkType não for LinkType.URL . |
Documentação detalhada
getLinkType()
Retorna o LinkType
.
var link = shape.getLink(); if (link != null) { Logger.log('Shape has a link of type: ' + link.getLinkType()); }
Retorno
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getLinkedSlide()
Retorna o Slide
vinculado para tipos de links que não são URL, se houver. Retorna null
se o slide não existir na apresentação ou se LinkType
for LinkType.URL
.
var link = shape.getLink(); if (link != null && link.getLinkType() != SlidesApp.LinkType.URL) { Logger.log('Shape has link to slide: ' + link.getLinkedSlide()); }
Retorno
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getSlideId()
Retorna o ID da Slide
ou null
vinculada se LinkType
não for LinkType.SLIDE_ID
.
Observe que o slide com o ID retornado pode não existir.
var link = shape.getLink(); if (link != null && link.getLinkType() == SlidesApp.LinkType.SLIDE_ID) { Logger.log('Shape has link to slide with ID: ' + link.getSlideId()); }
Retorno
String
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getSlideIndex()
Retorna o índice baseado em zero da Slide
ou null
vinculada se LinkType
não for LinkType.SLIDE_INDEX
.
Observe que o slide no índice retornado pode não existir.
var link = shape.getLink(); if (link != null && link.getLinkType() == SlidesApp.LinkType.SLIDE_INDEX) { Logger.log('Shape has link to slide with index: ' + link.getSlideIndex()); }
Retorno
Integer
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getSlidePosition()
Retorna o SlidePosition
do Slide
ou null
vinculado se LinkType
não for LinkType.SLIDE_POSITION
.
O slide com a posição relativa retornada pode não existir.
var link = shape.getLink(); if (link != null && link.getLinkType() == SlidesApp.LinkType.SLIDE_POSITION) { Logger.log('Shape has link to slide with relative position: ' + link.getSlidePosition()); }
Retorno
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getUrl()
Retorna o URL para a página da Web externa ou null
se LinkType
não for LinkType.URL
.
var link = shape.getLink(); if (link != null && link.getLinkType() == SlidesApp.LinkType.URL) { Logger.log('Shape has link to URL: ' + link.getUrl()); }
Retorno
String
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations