Método Shapes.Paste (PowerPoint)

Cola as formas, slides ou texto na área de transferência na coleção de formas especificada, na parte superior da ordem z. Cada objeto colado se torna um membro da coleção Shapes especificada. Se a área de transferência contiver slides inteiros, os slides serão colados como formas contendo as imagens dos slides. Se a área de transferência contiver um intervalo de texto, o texto será colado em uma forma de TextFrame recém-criado. Retorna um objeto ShapeRange que representa os objetos colados.

Sintaxe

expressão. Colar

expressão Uma variável que representa um objeto Formas.

Valor de retorno

ShapeRange

Comentários

Use a propriedade ViewType para definir o modo de exibição de uma janela antes de colar nela o conteúdo da área de transferência. A tabela a seguir mostra o que se pode colar em cada modo.

Neste modo	Você pode colar o seguinte da área de transferência
Modo de slides ou modo de anotações	Formas, texto ou slides inteiros. Se você colar um slide da área de transferência, uma imagem do slide será inserida no slide, no slide mestre ou na página de anotações como um objeto incorporado. Se uma forma estiver selecionada, o texto colado será acrescentado ao texto da forma; se o texto estiver selecionado, o texto colado substituirá a seleção; se algum outro elemento estiver selecionado, o texto colado será colocado em seu próprio quadro de texto. As formas coladas serão adicionadas à parte superior da ordem z e não substituirão formas selecionadas.
Modo de estrutura de tópicos	Texto ou slides inteiros. Você não pode colar formas no modo de exibição de estrutura de tópicos. Um slide colado será inserido antes do slide que contém o cursor.
Modo de classificação de slides	Slides inteiros. Você não pode colar formas ou texto no modo de classificação de slides. Um slide colado será inserido no cursor ou após o último slide selecionado na apresentação.

Se o conteúdo de origem não for totalmente baixado, esse método falhará e ocorrerá um erro. Para obter mais informações sobre os Documentos Parciais, consulte Trabalhar com Documentos Parciais.

Exemplo

Este exemplo copia a forma um do slide um da apresentação ativa na área de transferência e, em seguida, cola a forma no slide dois.

With ActivePresentation

    .Slides(1).Shapes(1).Copy

    .Slides(2).Shapes.Paste

End With

Este exemplo recorta o texto da forma um do slide um da apresentação ativa, coloca-o na área de transferência e, em seguida, cola o texto após a primeira palavra na forma dois do mesmo slide.

With ActivePresentation.Slides(1)

    .Shapes(1).TextFrame.TextRange.Cut

    .Shapes(2).TextFrame.TextRange.Words(1).InsertAfter.Paste

End With

Confira também

Objeto Shapes

Trabalhar com documentos parciais

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.