Objeto SlideRange (PowerPoint)

  • Artigo

Uma coleção que representa uma anotação ou um intervalo de slides, o qual é composto por um conjunto de slides que pode conter apenas um ou todos os slides da apresentação.

Comentários

Você pode incluir os slides que desejar — escolhidos entre todos os slides da apresentação ou entre todos os slides da seleção — para construir um intervalo de slides. Por exemplo, você poderia construir uma coleção SlideRange que contém os primeiros três slides em uma apresentação, todos os slides selecionados na apresentação ou todos os slides de título da apresentação.

Assim como você pode trabalhar com vários slides ao mesmo tempo na interface do usuário selecionando-os e aplicando um comando, você pode trabalhar com vários slides ao mesmo tempo programaticamente construindo uma coleção SlideRange e aplicando propriedades ou métodos a ela. E, assim como alguns comandos na interface do usuário que funcionam em slides únicos não são válidos quando vários slides estão selecionados, algumas propriedades e métodos que trabalham em um objeto Slide ou em uma coleção SlideRange que contém apenas um slide irá falhar se forem aplicados a uma coleção SlideRange que contém mais de um slide. Em geral, se você não pode fazer algo manualmente quando mais de um slide está selecionado (como retornar as formas individuais em um dos slides), você não pode fazê-la programaticamente usando uma coleção SlideRange que contém mais de um slide.

Para as operações que funcionam na interface do usuário, se você tem um único slide ou vários slides selecionados (como copiar a seleção para a área de transferência ou definir o preenchimento de plano de fundo do slide), as propriedades e métodos associados funcionarão em uma coleção SlideRange que contém mais de um slide. Aqui estão algumas diretrizes gerais sobre como essas propriedades e métodos se comportam quando são aplicados a vários slides.

  • Aplicando um método a uma coleção SlideRange é equivalente à aplicação do método a todos os objetos Slide nesse intervalo como um grupo.

  • Definindo o valor de uma propriedade da coleção SlideRange é equivalente a definir o valor da propriedade em cada slide nesse intervalo individualmente (para uma propriedade que utiliza um tipo enumerado, definindo o valor para o valor "Misto" não tem efeito).

  • Uma propriedade da coleção SlideRange que retorna um tipo enumerado retorna o valor da propriedade para um slide individual da coleção se todos os slides da coleção tiverem o mesmo valor para essa propriedade. Se os slides da coleção não possuem o mesmo valor da propriedade, a propriedade retorna o valor "Misto".

  • Uma propriedade da coleção SlideRange, que retorna tipos de dados simples (como Long, Single ou String), retorna o valor da propriedade para um slide individual da coleção, se todos os slides da coleção apresentarem o mesmo valor àquela propriedade. Se os slides da coleção não tiverem todos o mesmo valor para a propriedade, a propriedade retornará - 2 ou gerará um erro. Por exemplo, usando a propriedade Name em um objeto SlideRange que contém vários slides irá gerar um erro, porque cada slide tem um valor diferente para sua propriedade Name.

  • Algumas propriedades de formatação de slides não são definidas por propriedades e métodos que se aplicam diretamente à coleção SlideRange, mas por propriedades e métodos que se aplicam a um objeto contido na coleção SlideRange, como o objeto ColorScheme. Se o objeto contido representar operações que podem ser executadas em vários objetos na interface do usuário, você poderá retornar o objeto de uma coleção SlideRange que contém mais de um slide e suas propriedades e métodos seguirão as regras anteriores. Por exemplo, você pode usar a propriedade ColorScheme para retornar o objeto ColorScheme que representa os esquemas de cores usados em todos os slides da coleção SlideRange especificada. Definindo propriedades para esse objeto ColorScheme também definir essas propriedades para os objetos ColorScheme em todos os slides individuais na coleção SlideRange.

Os exemplos a seguir descrevem como:

  • Retornar um conjunto de slides especificado por nome ou número de índice

  • Retornar todos ou alguns slides da apresentação

  • Retornar uma anotação

  • Aplicar propriedades e métodos a um intervalo de slides

Exemplo

Use Slides.Range (index), em que o índice é o nome ou o número de índice do slide ou uma matriz que contém nomes ou números de índice de slides, para retornar uma coleção SlideRange que representa um conjunto de slides em uma apresentação. Use a função Array para construir uma matriz de nomes ou números de índice. O exemplo a seguir define o preenchimento de plano de fundo para os slides um e três na apresentação ativa.

With ActivePresentation.Slides.Range(Array(1, 3))

    .FollowMasterBackground = False
    .Background.Fill.PresetGradient msoGradientHorizontal, _
         1, msoGradientLateSunset

End With

O exemplo a seguir define o preenchimento de plano de fundo para os slides chamados "Intro" e "Big Chart" na apresentação ativa. Observe que slides recebem automaticamente nomes do formulário Sliden (onde n é um inteiro) gerados quando eles são criados. Para atribuir um nome mais significativo a um slide, use a propriedade Name .

With ActivePresentation.Slides.Range(Array("Intro", "Big Chart"))

    .FollowMasterBackground = False
    .Background.Fill.PresetGradient msoGradientHorizontal, _
        1, msoGradientLateSunset

End With

Embora você possa usar o método Range para retornar qualquer número de slides, é mais simples usar o métodoItem se desejar retornar um único membro da coleção SlideRange. Por exemplo, Slides(1) é mais simples do que Slides.Range(1).

Use a propriedade SlideRange do objeto Selection para retornar todos os slides da seleção. O exemplo a seguir define o preenchimento de plano de fundo para todos os slides selecionados na janela um, considerando que haja pelo menos um slide selecionado.

With Windows(1).Selection.SlideRange

    .FollowMasterBackground = False
    .Background.Fill.PresetGradient msoGradientHorizontal, _
        1, msoGradientLateSunset

End With

Use Selection.SlideRange (index), em que o índice é o nome do slide ou o número do índice, para retornar um único slide da seleção. O exemplo a seguir define o preenchimento de plano de fundo para o slide dois na coleção de slides selecionados na janela um, considerando que haja pelo menos dois slides selecionados.

With Windows(1).Selection.SlideRange(2)

    .FollowMasterBackground = False
    .Background.Fill.PresetGradient msoGradientHorizontal, _
        1, msoGradientLateSunset

End With

Use a propriedade NotesPage para retornar uma coleção SlideRange que representa a página de anotações especificado. O exemplo a seguir insere texto no espaço reservado dois (a área de notas) na página de anotações do slide um da apresentação ativa.

ActivePresentation.Slides(1).NotesPage.Shapes _
    .Placeholders(2).TextFrame.TextRange.InsertAfter "Added Text"

Confira também

Referência de modelo de objeto do PowerPoint

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.