Método View.PasteSpecial (PowerPoint)
Cola o conteúdo atual da área de transferência no modo representado pelo objeto View.
Sintaxe
expressão. PasteSpecial (DataType, DisplayAsIcon, IconFileName, IconIndex, IconLabel, Link)
Expressão Uma variável que representa um objeto View .
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. Os ícones aparecem na caixa de diálogo Alterar ícone, acessada a partir da guia Inserir (clique em objeto, selecione Exibir como ícone, clique em Alterar ícone ): 0 (zero) corresponde ao primeiro ícone, 1 corresponde ao segundo ícone. Se esse argumento for omitido, o primeiro ícone (padrão) é usado. Se DisplayAsIcon for definido como msoFalse, este argumento será 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 será 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. |
Comentários
Ocorrerá um erro se houver nenhum dado na área de transferência quando o método PasteSpecial for chamado.
Modos de exibição para o método PasteSpecial válidos são os mesmos para o método Paste. Se o tipo de dados não puder ser colado no modo de exibição (por exemplo, se você tentar colar uma imagem na Exibição de Classificação de Slide), ocorrerá um erro.
O parâmetro DataType pode ser uma destas constantes PpPasteDataType
ppPasteBitmap |
ppPasteDefault default |
ppPasteEnhancedMetafile |
ppPasteGIF |
ppPasteHTML |
ppPasteJPG |
ppPasteMetafilePicture |
ppPasteOLEObject |
ppPastePNG |
ppPasteRTF |
ppPasteShape |
ppPasteSVG |
ppPasteText |
O parâmetro DisplayAsIcon pode ser uma destas constantes MsoTriState.
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. |
O parâmetro Link pode ser uma dessas constantes MsoTriState .
msoFalse O padrão. Não criar um link para o arquivo de origem do conteúdo da área de transferência. |
msoTrue Cria um link para o arquivo de origem do conteúdo da área de transferência. |
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
O exemplo a seguir cola uma imagem em bitmap como um ícone em uma outra janela. Esse exemplo presume que há duas janelas abertas, e que uma imagem em bitmap está atualmente selecionada na primeira janela.
Sub PasteOLEObject()
Windows(1).Selection.Copy
Windows(2).View.PasteSpecial DataType:=ppPasteOLEObject, _
DisplayAsIcon:=msoTrue, IconLabel:="New Bitmap Image"
End Sub
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.