Método Shapes.PasteSpecial (PowerPoint)
Cola o conteúdo da Área de transferência usando um formato especial.
Sintaxe
expressão. PasteSpecial (DataType, DisplayAsIcon, IconFileName, IconIndex, IconLabel, Link)
expressão Uma variável que representa um objeto Formas.
Parâmetros
| Nome | Obrigatório/Opcional | Tipo de dados | Descrição |
|---|---|---|---|
| DataType | Opcional | PpPasteDataType | Um formato para o conteúdo da Área de transferência, quando for inserido no documento. O valor padrão varia, de acordo com esse conteúdo. Ocorrerá um erro se o tipo de dado especificado no argumento DataType não tiver suporte do conteúdo da Área de transferência. |
| DisplayAsIcon | Opcional | MsoTriState | MsoTrue para exibir o objeto incorporado (ou link) como um ícone. |
| IconFileName | Opcional | String | Se DisplayAsIcon for definido como msoTrue, esse argumento será o caminho e o nome do arquivo no qual o ícone a ser exibido está armazenado. Se DisplayAsIcon for definido como msoFalse, este argumento será ignorado. |
| IconIndex | Opcional | Long | Se DisplayAsIcon for definido como msoTrue, esse argumento será um número que corresponde ao ícone que você deseja usar no arquivo de programa especificado por IconFilename. Por exemplo, 0 (zero) corresponde ao primeiro ícone e 1 corresponde ao segundo ícone. Se esse argumento for omitido, o primeiro ícone (padrão) é usado. Se DisplayAsIcon for definido como msoFalse, este argumento é ignorado. Se IconIndex estiver fora do intervalo válido, o ícone padrão (índice 0) é usado. |
| IconLabel | Opcional | String | Se DisplayAsIcon for definido como msoTrue, esse argumento será o texto que aparece abaixo do ícone. Se esse rótulo for omitido, o Microsoft PowerPoint gerará o rótulo de um ícone com base no conteúdo da área de transferência. Se DisplayAsIcon for definido como msoFalse, este argumento é ignorado. |
| Link | Opcional | MsoTriState | Determina se será criado um vínculo para o arquivo de origem do conteúdo da Área de transferência. Ocorrerá um erro se o conteúdo da Área de Transferência não oferecer suporte a um link. |
Valor de retorno
ShapeRange
Comentários
Adiciona a forma à coleção de formas no formato especificado. Se o tipo de dados especificado for um tipo de dados de texto, uma nova caixa de texto é criada com o texto. Se a colagem tiver êxito, o método PasteSpecial retorna um objeto ShapeRange representando o intervalo de formas que foi colado.
O valor do parâmetro DataType pode ser uma dessas constantes PpPasteDataType :
- ppPasteBitmap
- ppPasteDefault
- ppPasteEnhancedMetafile
- ppPasteHTML
- ppPasteGIF
- ppPasteJPG
- ppPasteMetafilePicture
- ppPastePNG
- ppPasteShape
O valor do parâmetro DisplayAsIcon pode ser uma dessas constantes MsoTriState .
| Constante | Descrição |
|---|---|
| msoFalse | O padrão. Não exibe o objeto incorporado (ou link) como um ícone. |
| msoTrue | Exibe o objeto incorporado (ou link) como um ícone. |
Ocorrerá um erro se houver nenhum dado na área de transferência quando o método PasteSpecial for chamado.
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.
Confira também
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.